xref: /linux/Documentation/devicetree/bindings/display/panel/sitronix,st7701.yaml (revision fc2d791a43d3880496d1c729b8bd74d2c19cb4e7) 
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
52required:
53  - compatible
54  - reg
55  - VCC-supply
56  - IOVCC-supply
57  - port
58  - reset-gpios
59
60allOf:
61  - $ref: panel-common.yaml#
62  - if:
63      properties:
64        compatible:
65          contains:
66            # SPI connected panels
67            enum:
68              - anbernic,rg28xx-panel
69    then:
70      $ref: /schemas/spi/spi-peripheral-props.yaml#
71
72  - if:
73      properties:
74        compatible:
75          not:
76            contains:
77              # DSI or SPI without D/CX pin
78              enum:
79                - anbernic,rg-arc-panel
80                - anbernic,rg28xx-panel
81                - densitron,dmt028vghmcmi-1a
82                - elida,kd50t048a
83                - techstar,ts8550b
84    then:
85      required:
86        - dc-gpios
87    else:
88      properties:
89        dc-gpios: false
90
91unevaluatedProperties: false
92
93examples:
94  - |
95    #include <dt-bindings/gpio/gpio.h>
96
97    dsi {
98        #address-cells = <1>;
99        #size-cells = <0>;
100
101        panel@0 {
102            compatible = "techstar,ts8550b", "sitronix,st7701";
103            reg = <0>;
104            VCC-supply = <&reg_dldo2>;
105            IOVCC-supply = <&reg_dldo2>;
106            reset-gpios = <&pio 3 24 GPIO_ACTIVE_HIGH>; /* LCD-RST: PD24 */
107            backlight = <&backlight>;
108
109            port {
110                mipi_in_panel: endpoint {
111                    remote-endpoint = <&mipi_out_panel>;
112                };
113            };
114        };
115    };
116  - |
117    #include <dt-bindings/gpio/gpio.h>
118
119    spi {
120        #address-cells = <1>;
121        #size-cells = <0>;
122
123        panel@0 {
124            compatible = "anbernic,rg28xx-panel", "sitronix,st7701";
125            reg = <0>;
126            spi-max-frequency = <3125000>;
127            VCC-supply = <&reg_lcd>;
128            IOVCC-supply = <&reg_lcd>;
129            reset-gpios = <&pio 8 14 GPIO_ACTIVE_HIGH>; /* LCD-RST: PI14 */
130            backlight = <&backlight>;
131
132            port {
133                panel_in_rgb: endpoint {
134                    remote-endpoint = <&tcon_lcd0_out_lcd>;
135                };
136            };
137        };
138    };
139