xref: /freebsd/sys/contrib/device-tree/Bindings/display/bridge/ps8640.yaml (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/bridge/ps8640.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MIPI DSI to eDP Video Format Converter Device Tree Bindings
8
9maintainers:
10  - Nicolas Boichat <drinkcat@chromium.org>
11  - Enric Balletbo i Serra <enric.balletbo@collabora.com>
12
13description: |
14  The PS8640 is a low power MIPI-to-eDP video format converter supporting
15  mobile devices with embedded panel resolutions up to 2048 x 1536. The
16  device accepts a single channel of MIPI DSI v1.1, with up to four lanes
17  plus clock, at a transmission rate up to 1.5Gbit/sec per lane. The
18  device outputs eDP v1.4, one or two lanes, at a link rate of up to
19  3.24Gbit/sec per lane.
20
21properties:
22  compatible:
23    const: parade,ps8640
24
25  reg:
26    maxItems: 1
27    description: Base I2C address of the device.
28
29  powerdown-gpios:
30    maxItems: 1
31    description: GPIO connected to active low powerdown.
32
33  reset-gpios:
34    maxItems: 1
35    description: GPIO connected to active low reset.
36
37  vdd12-supply:
38    maxItems: 1
39    description: Regulator for 1.2V digital core power.
40
41  vdd33-supply:
42    maxItems: 1
43    description: Regulator for 3.3V digital core power.
44
45  ports:
46    type: object
47    description:
48      A node containing DSI input & output port nodes with endpoint
49      definitions as documented in
50      Documentation/devicetree/bindings/media/video-interfaces.txt
51      Documentation/devicetree/bindings/graph.txt
52    properties:
53      '#address-cells':
54        const: 1
55
56      '#size-cells':
57        const: 0
58
59      port@0:
60        type: object
61        description: |
62          Video port for DSI input
63
64      port@1:
65        type: object
66        description: |
67          Video port for eDP output (panel or connector).
68
69    required:
70      - port@0
71
72    additionalProperties: false
73
74required:
75  - compatible
76  - reg
77  - powerdown-gpios
78  - reset-gpios
79  - vdd12-supply
80  - vdd33-supply
81  - ports
82
83additionalProperties: false
84
85examples:
86  - |
87    #include <dt-bindings/gpio/gpio.h>
88    i2c0 {
89        #address-cells = <1>;
90        #size-cells = <0>;
91
92        ps8640: edp-bridge@18 {
93            compatible = "parade,ps8640";
94            reg = <0x18>;
95            powerdown-gpios = <&pio 116 GPIO_ACTIVE_LOW>;
96            reset-gpios = <&pio 115 GPIO_ACTIVE_LOW>;
97            vdd12-supply = <&ps8640_fixed_1v2>;
98            vdd33-supply = <&mt6397_vgp2_reg>;
99
100            ports {
101                #address-cells = <1>;
102                #size-cells = <0>;
103
104                port@0 {
105                    reg = <0>;
106                    ps8640_in: endpoint {
107                        remote-endpoint = <&dsi0_out>;
108                    };
109                };
110
111                port@1 {
112                    reg = <1>;
113                    ps8640_out: endpoint {
114                        remote-endpoint = <&panel_in>;
115                   };
116                };
117            };
118        };
119    };
120
121