sitronix,st7701.yaml

  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    };