xref: /freebsd/sys/contrib/device-tree/Bindings/display/panel/lvds.yaml (revision 5956d97f4b3204318ceb6aa9c77bd0bc6ea87a41)
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/panel/lvds.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: LVDS Display Panel
8
9maintainers:
10  - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
11  - Thierry Reding <thierry.reding@gmail.com>
12
13description: |+
14  LVDS is a physical layer specification defined in ANSI/TIA/EIA-644-A. Multiple
15  incompatible data link layers have been used over time to transmit image data
16  to LVDS panels. This bindings supports display panels compatible with the
17  following specifications.
18
19  [JEIDA] "Digital Interface Standards for Monitor", JEIDA-59-1999, February
20  1999 (Version 1.0), Japan Electronic Industry Development Association (JEIDA)
21  [LDI] "Open LVDS Display Interface", May 1999 (Version 0.95), National
22  Semiconductor
23  [VESA] "VESA Notebook Panel Standard", October 2007 (Version 1.0), Video
24  Electronics Standards Association (VESA)
25
26  Device compatible with those specifications have been marketed under the
27  FPD-Link and FlatLink brands.
28
29allOf:
30  - $ref: panel-common.yaml#
31
32properties:
33  compatible:
34    contains:
35      const: panel-lvds
36    description:
37      Shall contain "panel-lvds" in addition to a mandatory panel-specific
38      compatible string defined in individual panel bindings. The "panel-lvds"
39      value shall never be used on its own.
40
41  data-mapping:
42    enum:
43      - jeida-18
44      - jeida-24
45      - vesa-24
46    description: |
47      The color signals mapping order.
48
49      LVDS data mappings are defined as follows.
50
51      - "jeida-18" - 18-bit data mapping compatible with the [JEIDA], [LDI] and
52        [VESA] specifications. Data are transferred as follows on 3 LVDS lanes.
53
54      Slot          0       1       2       3       4       5       6
55                ________________                         _________________
56      Clock                     \_______________________/
57                  ______  ______  ______  ______  ______  ______  ______
58      DATA0     ><__G0__><__R5__><__R4__><__R3__><__R2__><__R1__><__R0__><
59      DATA1     ><__B1__><__B0__><__G5__><__G4__><__G3__><__G2__><__G1__><
60      DATA2     ><_CTL2_><_CTL1_><_CTL0_><__B5__><__B4__><__B3__><__B2__><
61
62      - "jeida-24" - 24-bit data mapping compatible with the [DSIM] and [LDI]
63        specifications. Data are transferred as follows on 4 LVDS lanes.
64
65      Slot          0       1       2       3       4       5       6
66                ________________                         _________________
67      Clock                     \_______________________/
68                  ______  ______  ______  ______  ______  ______  ______
69      DATA0     ><__G2__><__R7__><__R6__><__R5__><__R4__><__R3__><__R2__><
70      DATA1     ><__B3__><__B2__><__G7__><__G6__><__G5__><__G4__><__G3__><
71      DATA2     ><_CTL2_><_CTL1_><_CTL0_><__B7__><__B6__><__B5__><__B4__><
72      DATA3     ><_CTL3_><__B1__><__B0__><__G1__><__G0__><__R1__><__R0__><
73
74      - "vesa-24" - 24-bit data mapping compatible with the [VESA] specification.
75        Data are transferred as follows on 4 LVDS lanes.
76
77      Slot          0       1       2       3       4       5       6
78                ________________                         _________________
79      Clock                     \_______________________/
80                  ______  ______  ______  ______  ______  ______  ______
81      DATA0     ><__G0__><__R5__><__R4__><__R3__><__R2__><__R1__><__R0__><
82      DATA1     ><__B1__><__B0__><__G5__><__G4__><__G3__><__G2__><__G1__><
83      DATA2     ><_CTL2_><_CTL1_><_CTL0_><__B5__><__B4__><__B3__><__B2__><
84      DATA3     ><_CTL3_><__B7__><__B6__><__G7__><__G6__><__R7__><__R6__><
85
86      Control signals are mapped as follows.
87
88      CTL0: HSync
89      CTL1: VSync
90      CTL2: Data Enable
91      CTL3: 0
92
93  data-mirror:
94    type: boolean
95    description:
96      If set, reverse the bit order described in the data mappings below on all
97      data lanes, transmitting bits for slots 6 to 0 instead of 0 to 6.
98
99  port: true
100  ports: true
101
102required:
103  - compatible
104  - data-mapping
105  - width-mm
106  - height-mm
107  - panel-timing
108
109oneOf:
110  - required:
111      - port
112  - required:
113      - ports
114
115additionalProperties: true
116
117...
118