display/panel/panel-mipi-dbi-spi.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/display/panel/panel-mipi-dbi-spi.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: MIPI DBI SPI Panel
10   - Noralf Trønnes <noralf@tronnes.org>
23   - Power:
24     - Vdd: Power supply for display module
25       Called power-supply in this binding.
26     - Vddi: Logic level supply for interface signals
27       Called io-supply in this binding.
28   - Interface:
29     - CSx: Chip select
30     - SCL: Serial clock
31     - Dout: Serial out
32     - Din: Serial in
33     - SDA: Bidrectional in/out
34     - D/CX: Data/command selection, high=data, low=command
35       Called dc-gpios in this binding.
36     - RESX: Reset when low
37       Called reset-gpios in this binding.
41     - Option 1: 9-bit mode and D/CX as the 9th bit
45     - Option 2: 16-bit mode and D/CX as a 9th bit
49     - Option 3: 8-bit mode and D/CX as a separate interface line
59   The panel resolution is specified using the panel-timing node properties
60   hactive (width) and vactive (height). The other mandatory panel-timing
61   properties should be set to zero except clock-frequency which can be
64   If the panel is wired to the controller at an offset specify this using
65   hback-porch (x-offset) and vback-porch (y-offset).
68   - $ref: panel-common.yaml#
69   - $ref: /schemas/spi/spi-peripheral-props.yaml#
74       - enum:
75           - saef,sftc154b
76           - sainsmart18
77           - shineworld,lh133k
78       - const: panel-mipi-dbi-spi
83   write-only:
89   dc-gpios:
92       Controller data/command selection (D/CX) in 4-line SPI mode.
93       If not set, the controller is in 3-line SPI mode.
95   io-supply:
98       No need to set if this is the same as power-supply.
100   spi-3wire: true
105         * `x2r1g1b1r1g1b1` - RGB111, 2 pixels per byte
106         * `x2b1g1r1b1g1r1` - BGR111, 2 pixels per byte
107         * `x1r1g1b1x1r1g1b1` - RGB111, 2 pixels per byte
108         * `x1b1g1r1x1b1g1r1` - BGR111, 2 pixels per byte
109         * `r5g6b5` - RGB565, 2 bytes
110         * `b5g6r5` - BGR565, 2 bytes
111         * `r6x2g6x2b6x2` - RGB666, 3 bytes
112         * `b6x2g6x2r6x2` - BGR666, 3 bytes
114       - x2r1g1b1r1g1b1
115       - x2b1g1r1b1g1r1
116       - x1r1g1b1x1r1g1b1
117       - x1b1g1r1x1b1g1r1
118       - r5g6b5
119       - b5g6r5
120       - r6x2g6x2b6x2
121       - b6x2g6x2r6x2
125   - compatible
126   - reg
127   - width-mm
128   - height-mm
129   - panel-timing
134   - |
135     #include <dt-bindings/gpio/gpio.h>
138         #address-cells = <1>;
139         #size-cells = <0>;
142             compatible = "sainsmart18", "panel-mipi-dbi-spi";
144             spi-max-frequency = <40000000>;
146             dc-gpios = <&gpio 24 GPIO_ACTIVE_HIGH>;
147             reset-gpios = <&gpio 25 GPIO_ACTIVE_HIGH>;
148             write-only;
154             width-mm = <35>;
155             height-mm = <28>;
157             panel-timing {
160                 hback-porch = <0>;
161                 vback-porch = <0>;
162                 clock-frequency = <0>;
163                 hfront-porch = <0>;
164                 hsync-len = <0>;
165                 vfront-porch = <0>;
166                 vsync-len = <0>;