xref: /linux/Documentation/devicetree/bindings/display/panel/sitronix,st7701.yaml (revision 917b10d90990fd2138b5dbc2d22cfa428c070ade) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/panel/sitronix,st7701.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Sitronix ST7701 based LCD panels
8
9maintainers:
10  - Jagan Teki <jagan@amarulasolutions.com>
11
12description: |
13  ST7701 designed for small and medium sizes of TFT LCD display, is
14  capable of supporting up to 480RGBX864 in resolution. It provides
15  several system interfaces like MIPI/RGB/SPI.
16
17  Techstar TS8550B is 480x854, 2-lane MIPI DSI LCD panel which has
18  inbuilt ST7701 chip.
19
20  Densitron DMT028VGHMCMI-1A is 480x640, 2-lane MIPI DSI LCD panel
21  which has built-in ST7701 chip.
22
23properties:
24  compatible:
25    items:
26      - enum:
27          - anbernic,rg-arc-panel
28          - anbernic,rg28xx-panel
29          - densitron,dmt028vghmcmi-1a
30          - elida,kd50t048a
31          - techstar,ts8550b
32          - winstar,wf40eswaa6mnn0
33      - const: sitronix,st7701
34
35  reg:
36    description: DSI / SPI channel used by that screen
37    maxItems: 1
38
39  VCC-supply:
40    description: analog regulator for MIPI circuit
41
42  IOVCC-supply:
43    description: I/O system regulator
44
45  dc-gpios:
46    maxItems: 1
47    description:
48      Controller data/command selection (D/CX) in 4-line SPI mode.
49      If not set, the controller is in 3-line SPI mode.
50      Disallowed for DSI.
51
52  port: true
53  reset-gpios: true
54  rotation: true
55
56  backlight: true
57
58required:
59  - compatible
60  - reg
61  - VCC-supply
62  - IOVCC-supply
63  - port
64  - reset-gpios
65
66allOf:
67  - $ref: panel-common.yaml#
68  - if:
69      properties:
70        compatible:
71          contains:
72            # SPI connected panels
73            enum:
74              - anbernic,rg28xx-panel
75    then:
76      $ref: /schemas/spi/spi-peripheral-props.yaml#
77
78  - if:
79      properties:
80        compatible:
81          not:
82            contains:
83              # DSI or SPI without D/CX pin
84              enum:
85                - anbernic,rg-arc-panel
86                - anbernic,rg28xx-panel
87                - densitron,dmt028vghmcmi-1a
88                - elida,kd50t048a
89                - techstar,ts8550b
90    then:
91      required:
92        - dc-gpios
93    else:
94      properties:
95        dc-gpios: false
96
97unevaluatedProperties: false
98
99examples:
100  - |
101    #include <dt-bindings/gpio/gpio.h>
102
103    dsi {
104        #address-cells = <1>;
105        #size-cells = <0>;
106
107        panel@0 {
108            compatible = "techstar,ts8550b", "sitronix,st7701";
109            reg = <0>;
110            VCC-supply = <&reg_dldo2>;
111            IOVCC-supply = <&reg_dldo2>;
112            reset-gpios = <&pio 3 24 GPIO_ACTIVE_HIGH>; /* LCD-RST: PD24 */
113            backlight = <&backlight>;
114
115            port {
116                mipi_in_panel: endpoint {
117                    remote-endpoint = <&mipi_out_panel>;
118                };
119            };
120        };
121    };
122  - |
123    #include <dt-bindings/gpio/gpio.h>
124
125    spi {
126        #address-cells = <1>;
127        #size-cells = <0>;
128
129        panel@0 {
130            compatible = "anbernic,rg28xx-panel", "sitronix,st7701";
131            reg = <0>;
132            spi-max-frequency = <3125000>;
133            VCC-supply = <&reg_lcd>;
134            IOVCC-supply = <&reg_lcd>;
135            reset-gpios = <&pio 8 14 GPIO_ACTIVE_HIGH>; /* LCD-RST: PI14 */
136            backlight = <&backlight>;
137
138            port {
139                panel_in_rgb: endpoint {
140                    remote-endpoint = <&tcon_lcd0_out_lcd>;
141                };
142            };
143        };
144    };
145