xref: /freebsd/sys/contrib/device-tree/Bindings/display/sprd/sprd,display-subsystem.yaml (revision d5b0e70f7e04d971691517ce1304d86a1e367e2e)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/sprd/sprd,display-subsystem.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: Unisoc DRM master device
8
9maintainers:
10  - Kevin Tang <kevin.tang@unisoc.com>
11
12description: |
13  The Unisoc DRM master device is a virtual device needed to list all
14  DPU devices or other display interface nodes that comprise the
15  graphics subsystem.
16
17  Unisoc's display pipeline have several components as below description,
18  multi display controllers and corresponding physical interfaces.
19  For different display scenarios, dpu0 and dpu1 maybe binding to different
20  encoder.
21
22  E.g:
23  dpu0 and dpu1 both binding to DSI for dual mipi-dsi display;
24  dpu0 binding to DSI for primary display, and dpu1 binding to DP for external display;
25
26          +-----------------------------------------+
27          |                                         |
28          |                            +---------+  |
29  +----+  |   +----+    +---------+    |DPHY/CPHY|  |   +------+
30  |    +----->+dpu0+--->+MIPI|DSI +--->+Combo    +----->+Panel0|
31  |AXI |  |   +----+    +---------+    +---------+  |   +------+
32  |    |  |                  ^                      |
33  |    |  |                  |                      |
34  |    |  |      +-----------+                      |
35  |    |  |      |                                  |
36  |APB |  |   +--+-+    +-----------+    +---+      |   +------+
37  |    +----->+dpu1+--->+DisplayPort+--->+PHY+--------->+Panel1|
38  |    |  |   +----+    +-----------+    +---+      |   +------+
39  +----+  |                                         |
40          +-----------------------------------------+
41
42properties:
43  compatible:
44    const: sprd,display-subsystem
45
46  ports:
47    $ref: /schemas/types.yaml#/definitions/phandle-array
48    items:
49      maxItems: 1
50    description:
51      Should contain a list of phandles pointing to display interface port
52      of DPU devices.
53
54required:
55  - compatible
56  - ports
57
58additionalProperties: false
59
60examples:
61  - |
62    display-subsystem {
63        compatible = "sprd,display-subsystem";
64        ports = <&dpu_out>;
65    };
66