xref: /freebsd/sys/contrib/device-tree/Bindings/display/bridge/fsl,imx8qxp-pixel-link.yaml (revision 59c8e88e72633afbc47a4ace0d2170d00d51f7dc)
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/fsl,imx8qxp-pixel-link.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Freescale i.MX8qm/qxp Display Pixel Link
8
9maintainers:
10  - Liu Ying <victor.liu@nxp.com>
11
12description: |
13  The Freescale i.MX8qm/qxp Display Pixel Link(DPL) forms a standard
14  asynchronous linkage between pixel sources(display controller or
15  camera module) and pixel consumers(imaging or displays).
16  It consists of two distinct functions, a pixel transfer function and a
17  control interface.  Multiple pixel channels can exist per one control channel.
18  This binding documentation is only for pixel links whose pixel sources are
19  display controllers.
20
21  The i.MX8qm/qxp Display Pixel Link is accessed via System Controller Unit(SCU)
22  firmware.
23
24properties:
25  compatible:
26    enum:
27      - fsl,imx8qm-dc-pixel-link
28      - fsl,imx8qxp-dc-pixel-link
29
30  fsl,dc-id:
31    $ref: /schemas/types.yaml#/definitions/uint8
32    description: |
33      u8 value representing the display controller index that the pixel link
34      connects to.
35
36  fsl,dc-stream-id:
37    $ref: /schemas/types.yaml#/definitions/uint8
38    description: |
39      u8 value representing the display controller stream index that the pixel
40      link connects to.
41    enum: [0, 1]
42
43  ports:
44    $ref: /schemas/graph.yaml#/properties/ports
45
46    properties:
47      port@0:
48        $ref: /schemas/graph.yaml#/properties/port
49        description: The pixel link input port node from upstream video source.
50
51    patternProperties:
52      "^port@[1-4]$":
53        $ref: /schemas/graph.yaml#/properties/port
54        description: The pixel link output port node to downstream bridge.
55
56    required:
57      - port@0
58      - port@1
59      - port@2
60      - port@3
61      - port@4
62
63allOf:
64  - if:
65      properties:
66        compatible:
67          contains:
68            const: fsl,imx8qxp-dc-pixel-link
69    then:
70      properties:
71        fsl,dc-id:
72          const: 0
73
74  - if:
75      properties:
76        compatible:
77          contains:
78            const: fsl,imx8qm-dc-pixel-link
79    then:
80      properties:
81        fsl,dc-id:
82          enum: [0, 1]
83
84required:
85  - compatible
86  - fsl,dc-id
87  - fsl,dc-stream-id
88  - ports
89
90additionalProperties: false
91
92examples:
93  - |
94    dc0-pixel-link0 {
95        compatible = "fsl,imx8qxp-dc-pixel-link";
96        fsl,dc-id = /bits/ 8 <0>;
97        fsl,dc-stream-id = /bits/ 8 <0>;
98
99        ports {
100            #address-cells = <1>;
101            #size-cells = <0>;
102
103            /* from dc0 pixel combiner channel0 */
104            port@0 {
105                reg = <0>;
106
107                dc0_pixel_link0_dc0_pixel_combiner_ch0: endpoint {
108                    remote-endpoint = <&dc0_pixel_combiner_ch0_dc0_pixel_link0>;
109                };
110            };
111
112            /* to PXL2DPIs in MIPI/LVDS combo subsystems */
113            port@1 {
114                #address-cells = <1>;
115                #size-cells = <0>;
116                reg = <1>;
117
118                dc0_pixel_link0_mipi_lvds_0_pxl2dpi: endpoint@0 {
119                    reg = <0>;
120                    remote-endpoint = <&mipi_lvds_0_pxl2dpi_dc0_pixel_link0>;
121                };
122
123                dc0_pixel_link0_mipi_lvds_1_pxl2dpi: endpoint@1 {
124                    reg = <1>;
125                    remote-endpoint = <&mipi_lvds_1_pxl2dpi_dc0_pixel_link0>;
126                };
127            };
128
129            /* unused */
130            port@2 {
131                reg = <2>;
132            };
133
134            /* unused */
135            port@3 {
136                reg = <3>;
137            };
138
139            /* to imaging subsystem */
140            port@4 {
141                reg = <4>;
142            };
143        };
144    };
145