Skip to content

Commit 8cd4937

Browse files
Liu Yinglumag
authored andcommitted
dt-bindings: display: Document dual-link LVDS display common properties
Dual-link LVDS displays receive odd pixels and even pixels separately from dual LVDS links. One link receives odd pixels and the other receives even pixels. Some of those displays may also use only one LVDS link to receive all pixels, being odd and even agnostic. Document common properties for those displays by extending LVDS display common properties defined in lvds.yaml. Suggested-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org> Signed-off-by: Liu Ying <victor.liu@nxp.com> Reviewed-by: Rob Herring (Arm) <robh@kernel.org> Link: https://patchwork.freedesktop.org/patch/msgid/20241104032806.611890-9-victor.liu@nxp.com Signed-off-by: Dmitry Baryshkov <dmitry.baryshkov@linaro.org>
1 parent e316074 commit 8cd4937

File tree

3 files changed

+65
-32
lines changed

3 files changed

+65
-32
lines changed
Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2+
%YAML 1.2
3+
---
4+
$id: http://devicetree.org/schemas/display/lvds-dual-ports.yaml#
5+
$schema: http://devicetree.org/meta-schemas/core.yaml#
6+
7+
title: Dual-link LVDS Display Common Properties
8+
9+
maintainers:
10+
- Liu Ying <victor.liu@nxp.com>
11+
12+
description: |
13+
Common properties for LVDS displays with dual LVDS links. Extend LVDS display
14+
common properties defined in lvds.yaml.
15+
16+
Dual-link LVDS displays receive odd pixels and even pixels separately from
17+
the dual LVDS links. One link receives odd pixels and the other receives
18+
even pixels. Some of those displays may also use only one LVDS link to
19+
receive all pixels, being odd and even agnostic.
20+
21+
allOf:
22+
- $ref: lvds.yaml#
23+
24+
properties:
25+
ports:
26+
$ref: /schemas/graph.yaml#/properties/ports
27+
28+
patternProperties:
29+
'^port@[01]$':
30+
$ref: /schemas/graph.yaml#/$defs/port-base
31+
unevaluatedProperties: false
32+
description: |
33+
port@0 represents the first LVDS input link.
34+
port@1 represents the second LVDS input link.
35+
36+
properties:
37+
dual-lvds-odd-pixels:
38+
type: boolean
39+
description: LVDS input link for odd pixels
40+
41+
dual-lvds-even-pixels:
42+
type: boolean
43+
description: LVDS input link for even pixels
44+
45+
oneOf:
46+
- required: [dual-lvds-odd-pixels]
47+
- required: [dual-lvds-even-pixels]
48+
- properties:
49+
dual-lvds-odd-pixels: false
50+
dual-lvds-even-pixels: false
51+
52+
anyOf:
53+
- required:
54+
- port@0
55+
- required:
56+
- port@1
57+
58+
required:
59+
- ports
60+
61+
additionalProperties: true
62+
63+
...

Documentation/devicetree/bindings/display/panel/advantech,idk-2121wr.yaml

Lines changed: 1 addition & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ description: |
2020
dual-lvds-odd-pixels or dual-lvds-even-pixels).
2121
2222
allOf:
23+
- $ref: /schemas/display/lvds-dual-ports.yaml#
2324
- $ref: panel-common.yaml#
2425

2526
properties:
@@ -44,22 +45,10 @@ properties:
4445

4546
properties:
4647
port@0:
47-
$ref: /schemas/graph.yaml#/$defs/port-base
48-
unevaluatedProperties: false
49-
description: The sink for odd pixels.
50-
properties:
51-
dual-lvds-odd-pixels: true
52-
5348
required:
5449
- dual-lvds-odd-pixels
5550

5651
port@1:
57-
$ref: /schemas/graph.yaml#/$defs/port-base
58-
unevaluatedProperties: false
59-
description: The sink for even pixels.
60-
properties:
61-
dual-lvds-even-pixels: true
62-
6352
required:
6453
- dual-lvds-even-pixels
6554

@@ -75,7 +64,6 @@ required:
7564
- height-mm
7665
- data-mapping
7766
- panel-timing
78-
- ports
7967

8068
examples:
8169
- |+

Documentation/devicetree/bindings/display/panel/panel-simple-lvds-dual-ports.yaml

Lines changed: 1 addition & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ description: |
2222
If the panel is more advanced a dedicated binding file is required.
2323
2424
allOf:
25+
- $ref: /schemas/display/lvds-dual-ports.yaml#
2526
- $ref: panel-common.yaml#
2627

2728
properties:
@@ -55,28 +56,10 @@ properties:
5556

5657
properties:
5758
port@0:
58-
$ref: /schemas/graph.yaml#/$defs/port-base
59-
unevaluatedProperties: false
60-
description: The first sink port.
61-
62-
properties:
63-
dual-lvds-odd-pixels:
64-
type: boolean
65-
description: The first sink port for odd pixels.
66-
6759
required:
6860
- dual-lvds-odd-pixels
6961

7062
port@1:
71-
$ref: /schemas/graph.yaml#/$defs/port-base
72-
unevaluatedProperties: false
73-
description: The second sink port.
74-
75-
properties:
76-
dual-lvds-even-pixels:
77-
type: boolean
78-
description: The second sink port for even pixels.
79-
8063
required:
8164
- dual-lvds-even-pixels
8265

@@ -88,7 +71,6 @@ unevaluatedProperties: false
8871

8972
required:
9073
- compatible
91-
- ports
9274
- power-supply
9375

9476
examples:

0 commit comments

Comments
 (0)