xref: /linux/Documentation/devicetree/bindings/display/sitronix,st7571.yaml (revision 6f17ab9a63e670bd62a287f95e3982f99eafd77e) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/sitronix,st7571.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Sitronix ST7571 Display Controller
8
9maintainers:
10  - Marcus Folkesson <marcus.folkesson@gmail.com>
11
12description:
13  Sitronix ST7571 is a driver and controller for 4-level gray
14  scale and monochrome dot matrix LCD panels.
15
16allOf:
17  - $ref: panel/panel-common.yaml#
18
19properties:
20  compatible:
21    const: sitronix,st7571
22
23  reg:
24    maxItems: 1
25
26  sitronix,grayscale:
27    type: boolean
28    description:
29      Display supports 4-level grayscale.
30
31  sitronix,inverted:
32    type: boolean
33    description:
34      Display pixels are inverted, i.e. 0 is white and 1 is black.
35
36  reset-gpios: true
37  width-mm: true
38  height-mm: true
39  panel-timing: true
40
41required:
42  - compatible
43  - reg
44  - reset-gpios
45  - width-mm
46  - height-mm
47  - panel-timing
48
49additionalProperties: false
50
51examples:
52  - |
53    #include <dt-bindings/gpio/gpio.h>
54
55    i2c {
56      #address-cells = <1>;
57      #size-cells = <0>;
58
59      display@3f {
60        compatible = "sitronix,st7571";
61        reg = <0x3f>;
62        reset-gpios = <&gpio0 3 GPIO_ACTIVE_LOW>;
63        width-mm = <37>;
64        height-mm = <27>;
65
66        panel-timing {
67          hactive = <128>;
68          vactive = <96>;
69          hback-porch = <0>;
70          vback-porch = <0>;
71          clock-frequency = <0>;
72          hfront-porch = <0>;
73          hsync-len = <0>;
74          vfront-porch = <0>;
75          vsync-len = <0>;
76        };
77      };
78    };
79