bindings/auxdisplay/hit%2Chd44780.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Hitachi HD44780 Character LCD Controller
10   - Geert Uytterhoeven <geert@linux-m68k.org>
13   The Hitachi HD44780 Character LCD Controller is commonly used on character
15   interface, which can be used in either 4-bit or 8-bit mode. By using a
24   data-gpios:
26       GPIO pins connected to the data signal lines DB0-DB7 (8-bit mode) or
27       DB4-DB7 (4-bit mode) of the LCD Controller's bus interface.
29       - maxItems: 4
30       - maxItems: 8
32   enable-gpios:
34       GPIO pin connected to the "E" (Enable) signal line of the LCD
35       Controller's bus interface.
38   rs-gpios:
40       GPIO pin connected to the "RS" (Register Select) signal line of the LCD
41       Controller's bus interface.
44   rw-gpios:
46       GPIO pin connected to the "RW" (Read/Write) signal line of the LCD
47       Controller's bus interface.
50   backlight-gpios:
51     description: GPIO pin used for enabling the LCD's backlight.
54   display-height-chars:
60   display-width-chars:
66   internal-buffer-width:
69       display-width-chars for displays with more than 2 lines).
75   - compatible
76   - data-gpios
77   - enable-gpios
78   - rs-gpios
79   - display-height-chars
80   - display-width-chars
85   - |
86     #include <dt-bindings/gpio/gpio.h>
87     display-controller {
90         data-gpios = <&hc595 0 GPIO_ACTIVE_HIGH>,
94         enable-gpios = <&hc595 4 GPIO_ACTIVE_HIGH>;
95         rs-gpios = <&hc595 5 GPIO_ACTIVE_HIGH>;
97         display-height-chars = <2>;
98         display-width-chars = <16>;
101   - |
102     #include <dt-bindings/gpio/gpio.h>
104         #address-cells = <1>;
105         #size-cells = <0>;
107         pcf8574: gpio-expander@27 {
110             gpio-controller;
111             #gpio-cells = <2>;
115     display-controller {
117         display-height-chars = <2>;
118         display-width-chars = <16>;
119         data-gpios = <&pcf8574 4 GPIO_ACTIVE_HIGH>,
123         enable-gpios = <&pcf8574 2 GPIO_ACTIVE_HIGH>;
124         rs-gpios = <&pcf8574 0 GPIO_ACTIVE_HIGH>;
125         rw-gpios = <&pcf8574 1 GPIO_ACTIVE_HIGH>;
126         backlight-gpios = <&pcf8574 3 GPIO_ACTIVE_HIGH>;