1 # SPDX-License-Identifier: GPL-2.0 1 # SPDX-License-Identifier: GPL-2.0
2 %YAML 1.2 2 %YAML 1.2
3 --- 3 ---
4 $id: http://devicetree.org/schemas/display/bri 4 $id: http://devicetree.org/schemas/display/bridge/lvds-codec.yaml#
5 $schema: http://devicetree.org/meta-schemas/co 5 $schema: http://devicetree.org/meta-schemas/core.yaml#
6 6
7 title: Transparent LVDS encoders and decoders 7 title: Transparent LVDS encoders and decoders
8 8
9 maintainers: 9 maintainers:
10 - Laurent Pinchart <laurent.pinchart+renesas@ 10 - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
11 11
12 description: | 12 description: |
13 This binding supports transparent LVDS encod 13 This binding supports transparent LVDS encoders and decoders that don't
14 require any configuration. 14 require any configuration.
15 15
16 LVDS is a physical layer specification defin 16 LVDS is a physical layer specification defined in ANSI/TIA/EIA-644-A. Multiple
17 incompatible data link layers have been used 17 incompatible data link layers have been used over time to transmit image data
18 to LVDS panels. This binding targets devices 18 to LVDS panels. This binding targets devices compatible with the following
19 specifications only. 19 specifications only.
20 20
21 [JEIDA] "Digital Interface Standards for Mon 21 [JEIDA] "Digital Interface Standards for Monitor", JEIDA-59-1999, February
22 1999 (Version 1.0), Japan Electronic Industr 22 1999 (Version 1.0), Japan Electronic Industry Development Association (JEIDA)
23 [LDI] "Open LVDS Display Interface", May 199 23 [LDI] "Open LVDS Display Interface", May 1999 (Version 0.95), National
24 Semiconductor 24 Semiconductor
25 [VESA] "VESA Notebook Panel Standard", Octob 25 [VESA] "VESA Notebook Panel Standard", October 2007 (Version 1.0), Video
26 Electronics Standards Association (VESA) 26 Electronics Standards Association (VESA)
27 27
28 Those devices have been marketed under the F 28 Those devices have been marketed under the FPD-Link and FlatLink brand names
29 among others. 29 among others.
30 30
31 properties: 31 properties:
32 compatible: 32 compatible:
33 oneOf: 33 oneOf:
34 - items: 34 - items:
35 - enum: 35 - enum:
36 - ti,ds90c185 # For the TI DS9 36 - ti,ds90c185 # For the TI DS90C185 FPD-Link Serializer
37 - ti,ds90c187 # For the TI DS9 37 - ti,ds90c187 # For the TI DS90C187 FPD-Link Serializer
38 - ti,sn75lvds83 # For the TI SN7 38 - ti,sn75lvds83 # For the TI SN75LVDS83 FlatLink transmitter
39 - const: lvds-encoder # Generic LVDS 39 - const: lvds-encoder # Generic LVDS encoder compatible fallback
40 - items: 40 - items:
41 - enum: 41 - enum:
42 - ti,ds90cf364a # For the DS90CF 42 - ti,ds90cf364a # For the DS90CF364A FPD-Link LVDS Receiver
43 - ti,ds90cf384a # For the DS90CF 43 - ti,ds90cf384a # For the DS90CF384A FPD-Link LVDS Receiver
44 - ti,sn65lvds94 # For the SN65DS <<
45 - const: lvds-decoder # Generic LVDS 44 - const: lvds-decoder # Generic LVDS decoders compatible fallback
46 - enum: 45 - enum:
47 - thine,thc63lvdm83d # For the THC63 46 - thine,thc63lvdm83d # For the THC63LVDM83D LVDS serializer
48 47
49 ports: 48 ports:
50 $ref: /schemas/graph.yaml#/properties/port 49 $ref: /schemas/graph.yaml#/properties/ports
51 50
52 properties: 51 properties:
53 port@0: 52 port@0:
54 $ref: /schemas/graph.yaml#/$defs/port- 53 $ref: /schemas/graph.yaml#/$defs/port-base
55 unevaluatedProperties: false 54 unevaluatedProperties: false
56 description: | 55 description: |
57 For LVDS encoders, port 0 is the par 56 For LVDS encoders, port 0 is the parallel input
58 For LVDS decoders, port 0 is the LVD 57 For LVDS decoders, port 0 is the LVDS input
59 58
60 properties: 59 properties:
61 endpoint: 60 endpoint:
62 $ref: /schemas/media/video-interfa 61 $ref: /schemas/media/video-interfaces.yaml#
63 unevaluatedProperties: false 62 unevaluatedProperties: false
64 63
65 properties: 64 properties:
66 data-mapping: 65 data-mapping:
67 enum: 66 enum:
68 - jeida-18 67 - jeida-18
69 - jeida-24 68 - jeida-24
70 - vesa-24 69 - vesa-24
71 description: | 70 description: |
72 The color signals mapping or 71 The color signals mapping order. See details in
73 Documentation/devicetree/bin 72 Documentation/devicetree/bindings/display/lvds.yaml
74 73
75 port@1: 74 port@1:
76 $ref: /schemas/graph.yaml#/properties/ 75 $ref: /schemas/graph.yaml#/properties/port
77 description: | 76 description: |
78 For LVDS encoders, port 1 is the LVD 77 For LVDS encoders, port 1 is the LVDS output
79 For LVDS decoders, port 1 is the par 78 For LVDS decoders, port 1 is the parallel output
80 79
81 required: 80 required:
82 - port@0 81 - port@0
83 - port@1 82 - port@1
84 83
85 pclk-sample: 84 pclk-sample:
86 description: 85 description:
87 Data sampling on rising or falling edge. 86 Data sampling on rising or falling edge.
88 enum: 87 enum:
89 - 0 # Falling edge 88 - 0 # Falling edge
90 - 1 # Rising edge 89 - 1 # Rising edge
91 default: 0 90 default: 0
92 91
93 powerdown-gpios: 92 powerdown-gpios:
94 description: 93 description:
95 The GPIO used to control the power down 94 The GPIO used to control the power down line of this device.
96 maxItems: 1 95 maxItems: 1
97 96
98 power-supply: true 97 power-supply: true
99 98
100 allOf: 99 allOf:
101 - if: 100 - if:
102 not: 101 not:
103 properties: 102 properties:
104 compatible: 103 compatible:
105 contains: 104 contains:
106 const: lvds-decoder 105 const: lvds-decoder
107 then: 106 then:
108 properties: 107 properties:
109 ports: 108 ports:
110 properties: 109 properties:
111 port@0: 110 port@0:
112 properties: 111 properties:
113 endpoint: 112 endpoint:
114 properties: 113 properties:
115 data-mapping: false 114 data-mapping: false
116 115
117 - if: 116 - if:
118 not: 117 not:
119 properties: 118 properties:
120 compatible: 119 compatible:
121 contains: 120 contains:
122 const: lvds-encoder 121 const: lvds-encoder
123 then: 122 then:
124 properties: 123 properties:
125 pclk-sample: false 124 pclk-sample: false
126 125
127 required: 126 required:
128 - compatible 127 - compatible
129 - ports 128 - ports
130 129
131 additionalProperties: false 130 additionalProperties: false
132 131
133 132
134 examples: 133 examples:
135 - | 134 - |
136 lvds-encoder { 135 lvds-encoder {
137 compatible = "ti,ds90c185", "lvds-encode 136 compatible = "ti,ds90c185", "lvds-encoder";
138 137
139 ports { 138 ports {
140 #address-cells = <1>; 139 #address-cells = <1>;
141 #size-cells = <0>; 140 #size-cells = <0>;
142 141
143 port@0 { 142 port@0 {
144 reg = <0>; 143 reg = <0>;
145 144
146 lvds_enc_in: endpoint { 145 lvds_enc_in: endpoint {
147 remote-endpoint = <&display_out_rg 146 remote-endpoint = <&display_out_rgb>;
148 }; 147 };
149 }; 148 };
150 149
151 port@1 { 150 port@1 {
152 reg = <1>; 151 reg = <1>;
153 152
154 lvds_enc_out: endpoint { 153 lvds_enc_out: endpoint {
155 remote-endpoint = <&lvds_panel_in> 154 remote-endpoint = <&lvds_panel_in>;
156 }; 155 };
157 }; 156 };
158 }; 157 };
159 }; 158 };
160 159
161 - | 160 - |
162 lvds-decoder { 161 lvds-decoder {
163 compatible = "ti,ds90cf384a", "lvds-deco 162 compatible = "ti,ds90cf384a", "lvds-decoder";
164 163
165 ports { 164 ports {
166 #address-cells = <1>; 165 #address-cells = <1>;
167 #size-cells = <0>; 166 #size-cells = <0>;
168 167
169 port@0 { 168 port@0 {
170 reg = <0>; 169 reg = <0>;
171 170
172 lvds_dec_in: endpoint { 171 lvds_dec_in: endpoint {
173 remote-endpoint = <&display_out_lv 172 remote-endpoint = <&display_out_lvds>;
174 }; 173 };
175 }; 174 };
176 175
177 port@1 { 176 port@1 {
178 reg = <1>; 177 reg = <1>;
179 178
180 lvds_dec_out: endpoint { 179 lvds_dec_out: endpoint {
181 remote-endpoint = <&rgb_panel_in>; 180 remote-endpoint = <&rgb_panel_in>;
182 }; 181 };
183 }; 182 };
184 }; 183 };
185 }; 184 };
186 185
187 ... 186 ...
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.