xref: /freebsd/sys/contrib/device-tree/Bindings/display/bridge/lvds-codec.yaml (revision 924226fba12cc9a228c73b956e1b7fa24c60b055) 
1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/bridge/lvds-codec.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Transparent LVDS encoders and decoders
8
9maintainers:
10  - Laurent Pinchart <laurent.pinchart+renesas@ideasonboard.com>
11
12description: |
13  This binding supports transparent LVDS encoders and decoders that don't
14  require any configuration.
15
16  LVDS is a physical layer specification defined in ANSI/TIA/EIA-644-A. Multiple
17  incompatible data link layers have been used over time to transmit image data
18  to LVDS panels. This binding targets devices compatible with the following
19  specifications only.
20
21  [JEIDA] "Digital Interface Standards for Monitor", JEIDA-59-1999, February
22  1999 (Version 1.0), Japan Electronic Industry Development Association (JEIDA)
23  [LDI] "Open LVDS Display Interface", May 1999 (Version 0.95), National
24  Semiconductor
25  [VESA] "VESA Notebook Panel Standard", October 2007 (Version 1.0), Video
26  Electronics Standards Association (VESA)
27
28  Those devices have been marketed under the FPD-Link and FlatLink brand names
29  among others.
30
31properties:
32  compatible:
33    oneOf:
34      - items:
35          - enum:
36              - ti,ds90c185   # For the TI DS90C185 FPD-Link Serializer
37              - ti,ds90c187   # For the TI DS90C187 FPD-Link Serializer
38              - ti,sn75lvds83 # For the TI SN75LVDS83 FlatLink transmitter
39          - const: lvds-encoder # Generic LVDS encoder compatible fallback
40      - items:
41          - enum:
42              - ti,ds90cf384a # For the DS90CF384A FPD-Link LVDS Receiver
43          - const: lvds-decoder # Generic LVDS decoders compatible fallback
44      - enum:
45          - thine,thc63lvdm83d # For the THC63LVDM83D LVDS serializer
46
47  ports:
48    $ref: /schemas/graph.yaml#/properties/ports
49
50    properties:
51      port@0:
52        $ref: /schemas/graph.yaml#/properties/port
53        description: |
54          For LVDS encoders, port 0 is the parallel input
55          For LVDS decoders, port 0 is the LVDS input
56
57      port@1:
58        $ref: /schemas/graph.yaml#/properties/port
59        description: |
60          For LVDS encoders, port 1 is the LVDS output
61          For LVDS decoders, port 1 is the parallel output
62
63    required:
64      - port@0
65      - port@1
66
67  powerdown-gpios:
68    description:
69      The GPIO used to control the power down line of this device.
70    maxItems: 1
71
72  power-supply: true
73
74required:
75  - compatible
76  - ports
77
78additionalProperties: false
79
80
81examples:
82  - |
83    lvds-encoder {
84      compatible = "ti,ds90c185", "lvds-encoder";
85
86      ports {
87        #address-cells = <1>;
88        #size-cells = <0>;
89
90        port@0 {
91          reg = <0>;
92
93          lvds_enc_in: endpoint {
94            remote-endpoint = <&display_out_rgb>;
95          };
96        };
97
98        port@1 {
99          reg = <1>;
100
101          lvds_enc_out: endpoint {
102            remote-endpoint = <&lvds_panel_in>;
103          };
104        };
105      };
106    };
107
108  - |
109    lvds-decoder {
110      compatible = "ti,ds90cf384a", "lvds-decoder";
111
112      ports {
113        #address-cells = <1>;
114        #size-cells = <0>;
115
116        port@0 {
117          reg = <0>;
118
119          lvds_dec_in: endpoint {
120            remote-endpoint = <&display_out_lvds>;
121          };
122        };
123
124        port@1 {
125          reg = <1>;
126
127          lvds_dec_out: endpoint {
128            remote-endpoint = <&rgb_panel_in>;
129          };
130        };
131      };
132    };
133
134...
135