xref: /freebsd/sys/contrib/device-tree/Bindings/display/amlogic,meson-vpu.yaml (revision a03411e84728e9b267056fd31c7d1d9d1dc1b01e) 
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2# Copyright 2019 BayLibre, SAS
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/display/amlogic,meson-vpu.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: Amlogic Meson Display Controller
9
10maintainers:
11  - Neil Armstrong <neil.armstrong@linaro.org>
12
13description: |
14  The Amlogic Meson Display controller is composed of several components
15  that are going to be documented below
16
17  DMC|---------------VPU (Video Processing Unit)----------------|------HHI------|
18     | vd1   _______     _____________    _________________     |               |
19  D  |-------|      |----|            |   |                |    |   HDMI PLL    |
20  D  | vd2   | VIU  |    | Video Post |   | Video Encoders |<---|-----VCLK      |
21  R  |-------|      |----| Processing |   |                |    |               |
22     | osd2  |      |    |            |---| Enci ----------|----|-----VDAC------|
23  R  |-------| CSC  |----| Scalers    |   | Encp ----------|----|----HDMI-TX----|
24  A  | osd1  |      |    | Blenders   |   | Encl ----------|----|---------------|
25  M  |-------|______|----|____________|   |________________|    |               |
26  ___|__________________________________________________________|_______________|
27
28
29  VIU: Video Input Unit
30  ---------------------
31
32  The Video Input Unit is in charge of the pixel scanout from the DDR memory.
33  It fetches the frames addresses, stride and parameters from the "Canvas" memory.
34  This part is also in charge of the CSC (Colorspace Conversion).
35  It can handle 2 OSD Planes and 2 Video Planes.
36
37  VPP: Video Post Processing
38  --------------------------
39
40  The Video Post Processing is in charge of the scaling and blending of the
41  various planes into a single pixel stream.
42  There is a special "pre-blending" used by the video planes with a dedicated
43  scaler and a "post-blending" to merge with the OSD Planes.
44  The OSD planes also have a dedicated scaler for one of the OSD.
45
46  VENC: Video Encoders
47  --------------------
48
49  The VENC is composed of the multiple pixel encoders
50   - ENCI : Interlace Video encoder for CVBS and Interlace HDMI
51   - ENCP : Progressive Video Encoder for HDMI
52   - ENCL : LCD LVDS Encoder
53  The VENC Unit gets a Pixel Clocks (VCLK) from a dedicated HDMI PLL and clock
54  tree and provides the scanout clock to the VPP and VIU.
55  The ENCI is connected to a single VDAC for Composite Output.
56  The ENCI and ENCP are connected to an on-chip HDMI Transceiver.
57
58properties:
59  compatible:
60    oneOf:
61      - items:
62          - enum:
63              - amlogic,meson-gxbb-vpu # GXBB (S905)
64              - amlogic,meson-gxl-vpu # GXL (S905X, S905D)
65              - amlogic,meson-gxm-vpu # GXM (S912)
66          - const: amlogic,meson-gx-vpu
67      - enum:
68          - amlogic,meson-g12a-vpu # G12A (S905X2, S905Y2, S905D2)
69
70  reg:
71    maxItems: 2
72
73  reg-names:
74    items:
75      - const: vpu
76      - const: hhi
77
78  interrupts:
79    maxItems: 1
80
81  amlogic,canvas:
82    description: should point to a canvas provider node
83    $ref: /schemas/types.yaml#/definitions/phandle
84
85  power-domains:
86    maxItems: 1
87    description: phandle to the associated power domain
88
89  port@0:
90    $ref: /schemas/graph.yaml#/properties/port
91    description:
92      A port node pointing to the CVBS VDAC port node.
93
94  port@1:
95    $ref: /schemas/graph.yaml#/properties/port
96    description:
97      A port node pointing to the HDMI-TX port node.
98
99  "#address-cells":
100    const: 1
101
102  "#size-cells":
103    const: 0
104
105required:
106  - compatible
107  - reg
108  - interrupts
109  - port@0
110  - port@1
111  - "#address-cells"
112  - "#size-cells"
113  - amlogic,canvas
114
115additionalProperties: false
116
117examples:
118  - |
119    vpu: vpu@d0100000 {
120        compatible = "amlogic,meson-gxbb-vpu", "amlogic,meson-gx-vpu";
121        reg = <0xd0100000 0x100000>, <0xc883c000 0x1000>;
122        reg-names = "vpu", "hhi";
123        interrupts = <3>;
124        #address-cells = <1>;
125        #size-cells = <0>;
126        amlogic,canvas = <&canvas>;
127
128        /* CVBS VDAC output port */
129        port@0 {
130            reg = <0>;
131
132            cvbs_vdac_out: endpoint {
133                remote-endpoint = <&tv_connector_in>;
134            };
135        };
136
137        /* HDMI TX output port */
138        port@1 {
139            reg = <1>;
140
141            hdmi_tx_out: endpoint {
142                remote-endpoint = <&hdmi_tx_in>;
143            };
144        };
145    };
146