Documentation/devicetree/bindings/display/sprd/sprd,display-subsystem.yaml

   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
   7 title: Unisoc DRM master device
   8
   9 maintainers:
  10   - Kevin Tang <kevin.tang@unisoc.com>
  11
  12 description: |
  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
  42 properties:
  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
  54 required:
  55   - compatible
  56   - ports
  57
  58 additionalProperties: false
  59
  60 examples:
  61   - |
  62     display-subsystem {
  63         compatible = "sprd,display-subsystem";
  64         ports = <&dpu_out>;
  65     };