drivers/auxdisplay/charlcd.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /*
   3  * Character LCD driver for Linux
   4  *
   5  * Copyright (C) 2000-2008, Willy Tarreau <w@1wt.eu>
   6  * Copyright (C) 2016-2017 Glider bvba
   7  */
   8
   9 #ifndef _CHARLCD_H
  10 #define _CHARLCD_H
  11
  12 #define LCD_FLAG_B              0x0004  /* Blink on */
  13 #define LCD_FLAG_C              0x0008  /* Cursor on */
  14 #define LCD_FLAG_D              0x0010  /* Display on */
  15 #define LCD_FLAG_F              0x0020  /* Large font mode */
  16 #define LCD_FLAG_N              0x0040  /* 2-rows mode */
  17 #define LCD_FLAG_L              0x0080  /* Backlight enabled */
  18
  19 enum charlcd_onoff {
  20         CHARLCD_OFF = 0,
  21         CHARLCD_ON,
  22 };
  23
  24 enum charlcd_shift_dir {
  25         CHARLCD_SHIFT_LEFT,
  26         CHARLCD_SHIFT_RIGHT,
  27 };
  28
  29 enum charlcd_fontsize {
  30         CHARLCD_FONTSIZE_SMALL,
  31         CHARLCD_FONTSIZE_LARGE,
  32 };
  33
  34 enum charlcd_lines {
  35         CHARLCD_LINES_1,
  36         CHARLCD_LINES_2,
  37 };
  38
  39 struct charlcd_ops;
  40
  41 struct charlcd {
  42         const struct charlcd_ops *ops;
  43         const unsigned char *char_conv; /* Optional */
  44
  45         int height;
  46         int width;
  47
  48         /* Contains the LCD X and Y offset */
  49         struct {
  50                 unsigned long x;
  51                 unsigned long y;
  52         } addr;
  53
  54         void *drvdata;
  55 };
  56
  57 /**
  58  * struct charlcd_ops - Functions used by charlcd. Drivers have to implement
  59  * these.
  60  * @backlight: Turn backlight on or off. Optional.
  61  * @print: Print one character to the display at current cursor position.
  62  * The buffered cursor position is advanced by charlcd. The cursor should not
  63  * wrap to the next line at the end of a line.
  64  * @gotoxy: Set cursor to x, y. The x and y values to set the cursor to are
  65  * previously set in addr.x and addr.y by charlcd.
  66  * @home: Set cursor to 0, 0. The values in addr.x and addr.y are set to 0, 0 by
  67  * charlcd prior to calling this function.
  68  * @clear_display: Clear the whole display and set the cursor to 0, 0. The
  69  * values in addr.x and addr.y are set to 0, 0 by charlcd after to calling this
  70  * function.
  71  * @init_display: Initialize the display.
  72  * @shift_cursor: Shift cursor left or right one position.
  73  * @shift_display: Shift whole display content left or right.
  74  * @display: Turn display on or off.
  75  * @cursor: Turn cursor on or off.
  76  * @blink: Turn cursor blink on or off.
  77  * @lines: One or two lines.
  78  * @redefine_char: Redefine the actual pixel matrix of character.
  79  */
  80 struct charlcd_ops {
  81         void (*backlight)(struct charlcd *lcd, enum charlcd_onoff on);
  82         int (*print)(struct charlcd *lcd, int c);
  83         int (*gotoxy)(struct charlcd *lcd, unsigned int x, unsigned int y);
  84         int (*home)(struct charlcd *lcd);
  85         int (*clear_display)(struct charlcd *lcd);
  86         int (*init_display)(struct charlcd *lcd);
  87         int (*shift_cursor)(struct charlcd *lcd, enum charlcd_shift_dir dir);
  88         int (*shift_display)(struct charlcd *lcd, enum charlcd_shift_dir dir);
  89         int (*display)(struct charlcd *lcd, enum charlcd_onoff on);
  90         int (*cursor)(struct charlcd *lcd, enum charlcd_onoff on);
  91         int (*blink)(struct charlcd *lcd, enum charlcd_onoff on);
  92         int (*fontsize)(struct charlcd *lcd, enum charlcd_fontsize size);
  93         int (*lines)(struct charlcd *lcd, enum charlcd_lines lines);
  94         int (*redefine_char)(struct charlcd *lcd, char *esc);
  95 };
  96
  97 void charlcd_backlight(struct charlcd *lcd, enum charlcd_onoff on);
  98 struct charlcd *charlcd_alloc(void);
  99 void charlcd_free(struct charlcd *lcd);
 100
 101 int charlcd_register(struct charlcd *lcd);
 102 int charlcd_unregister(struct charlcd *lcd);
 103
 104 void charlcd_poke(struct charlcd *lcd);
 105
 106 #endif /* CHARLCD_H */