1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2
3 ---
4 $id: http://devicetree.org/schemas/display/pan
5 $schema: http://devicetree.org/meta-schemas/co
6
7 title: Common Properties for Display Panels
8
9 maintainers:
10 - Thierry Reding <thierry.reding@gmail.com>
11 - Laurent Pinchart <laurent.pinchart+renesas@
12
13 description: |
14 This document defines device tree properties
15 display panels. It doesn't constitute a devi
16 itself but is meant to be referenced by devi
17
18 When referenced from panel device tree bindi
19 document are defined as follows. The panel d
20 responsible for defining whether each proper
21
22 properties:
23 # Descriptive Properties
24 width-mm:
25 description:
26 Specifies the width of the physical area
27 property is expressed in millimeters and
28
29 height-mm:
30 description:
31 Specifies the height of the physical are
32 property is expressed in millimeters and
33
34 label:
35 description: |
36 The label property specifies a symbolic
37 string suitable for use by humans. It ty
38 on the system (e.g. as an affixed label)
39 documentation (e.g. in the user's manual
40
41 If no such name exists, and unless the p
42 device tree bindings, it shall rather be
43 non-descriptive information. For instanc
44 contains a single panel shall not be lab
45 inscribed on the system or used in a des
46 documentation.
47
48 rotation:
49 description:
50 Display rotation in degrees counter cloc
51 $ref: /schemas/types.yaml#/definitions/uin
52 enum: [0, 90, 180, 270]
53
54 # Display Timings
55 panel-timing:
56 description:
57 Most display panels are restricted to a
58 require specific display timings. The pa
59 timings.
60 $ref: panel-timing.yaml#
61
62 display-timings:
63 description:
64 Some display panels support several reso
65 The display-timings bindings supports sp
66 optionally specifying which is the nativ
67 $ref: display-timings.yaml#
68
69 # Connectivity
70 port:
71 $ref: /schemas/graph.yaml#/properties/port
72
73 ddc-i2c-bus:
74 $ref: /schemas/types.yaml#/definitions/pha
75 description:
76 Some panels expose EDID information thro
77 bus such as DDC2 or E-DDC. For such pane
78 phandle to the system I2C controller con
79
80 no-hpd:
81 type: boolean
82 description:
83 This panel is supposed to communicate th
84 (hot plug detect) signal, but the signal
85 hardcode the max delay from the panel sp
86
87 hpd-gpios:
88 maxItems: 1
89 description:
90 If Hot Plug Detect (HPD) is connected to
91 than a dedicated HPD pin the pin can be
92
93 # Control I/Os
94
95 # Many display panels can be controlled thro
96 # and timing of those control signals are de
97 # device tree bindings to specify. The follo
98 # used for panels that implement compatible
99
100 enable-gpios:
101 maxItems: 1
102 description: |
103 Specifier for a GPIO connected to the pa
104 enable signal is active high and enables
105 property can also be used for panels imp
106 signal, which is a negated version of th
107 signals (or active high power down signa
108 the GPIO specifier polarity flag.
109
110 Note that the enable signal control pane
111 confused with a backlight enable signal.
112
113 reset-gpios:
114 maxItems: 1
115 description:
116 Specifier for a GPIO connected to the pa
117 The reset signal is active low and reset
118 while active. Active high reset signals
119 GPIO specifier polarity flag.
120
121 te-gpios:
122 maxItems: 1
123 description:
124 GPIO spec for the tearing effect synchro
125 The tearing effect signal is active high
126 supported by inverting the GPIO specifie
127
128 # Power
129 power-supply:
130 description:
131 Display panels require power to be suppl
132 more than one power supply with panel-sp
133 order and timings of the power supplies,
134 supply is sufficient, either because the
135 because all its power rails can be drive
136 the power-supply property specifies the
137 phandle to a regulator.
138
139 # Backlight
140
141 # Most display panels include a backlight. S
142 # controller exposed through a control bus s
143 # backlight control through GPIO, PWM or oth
144 # backlight controller.
145
146 backlight:
147 $ref: /schemas/types.yaml#/definitions/pha
148 description:
149 For panels whose backlight is controlled
150 controller, this property contains a pha
151 controller.
152
153 dependencies:
154 width-mm: [ height-mm ]
155 height-mm: [ width-mm ]
156
157 additionalProperties: true
158
159 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.