1# SPDX-License-Identifier: GPL-2.0-only
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/bridge/ti,tfp410.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: TFP410 DPI to DVI encoder
8
9maintainers:
10  - Tomi Valkeinen <tomi.valkeinen@ti.com>
11  - Jyri Sarha <jsarha@ti.com>
12
13properties:
14  compatible:
15    const: ti,tfp410
16
17  reg:
18    description: I2C address of the device.
19    maxItems: 1
20
21  powerdown-gpios:
22    maxItems: 1
23
24  ti,deskew:
25    description:
26      Data de-skew in 350ps increments, from -4 to +3, as configured
27      through th DK[3:1] pins. This property shall be present only if the TFP410
28      is not connected through I2C.
29    maxItems: 1
30    $ref: /schemas/types.yaml#/definitions/uint32
31
32  ports:
33    description:
34      A node containing input and output port nodes with endpoint
35      definitions as documented in
36      Documentation/devicetree/bindings/media/video-interfaces.txt
37    type: object
38
39    properties:
40      port@0:
41        description: DPI input port.
42        type: object
43
44        properties:
45          reg:
46            const: 0
47
48          endpoint:
49            type: object
50
51            properties:
52              pclk-sample:
53                description:
54                  Endpoint sampling edge.
55                enum:
56                  - 0  # Falling edge
57                  - 1  # Rising edge
58                default: 0
59
60              bus-width:
61                description:
62                  Endpoint bus width.
63                enum:
64                  - 12  # 12 data lines connected and dual-edge mode
65                  - 24  # 24 data lines connected and single-edge mode
66                default: 24
67
68      port@1:
69        description: DVI output port.
70        type: object
71
72        properties:
73          reg:
74            const: 1
75
76          endpoint:
77            type: object
78
79    required:
80      - port@0
81      - port@1
82
83required:
84  - compatible
85  - ports
86
87if:
88  required:
89    - reg
90then:
91  properties:
92    ti,deskew: false
93else:
94  required:
95    - ti,deskew
96
97additionalProperties: false
98
99examples:
100  - |
101    #include <dt-bindings/gpio/gpio.h>
102
103    tfp410: encoder {
104        compatible = "ti,tfp410";
105        powerdown-gpios = <&twl_gpio 2 GPIO_ACTIVE_LOW>;
106        ti,deskew = <3>;
107
108        ports {
109            #address-cells = <1>;
110            #size-cells = <0>;
111
112            port@0 {
113                reg = <0>;
114                tfp410_in: endpoint {
115                    pclk-sample = <1>;
116                    bus-width = <24>;
117                    remote-endpoint = <&dpi_out>;
118                };
119            };
120
121            port@1 {
122                reg = <1>;
123                tfp410_out: endpoint {
124                    remote-endpoint = <&dvi_connector_in>;
125                };
126            };
127        };
128    };
129
130...
131