xref: /linux/Documentation/devicetree/bindings/display/msm/dp-controller.yaml (revision 34dc1baba215b826e454b8d19e4f24adbeb7d00d) 
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/msm/dp-controller.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: MSM Display Port Controller
8
9maintainers:
10  - Kuogee Hsieh <quic_khsieh@quicinc.com>
11
12description: |
13  Device tree bindings for DisplayPort host controller for MSM targets
14  that are compatible with VESA DisplayPort interface specification.
15
16properties:
17  compatible:
18    oneOf:
19      - enum:
20          - qcom,sc7180-dp
21          - qcom,sc7280-dp
22          - qcom,sc7280-edp
23          - qcom,sc8180x-dp
24          - qcom,sc8180x-edp
25          - qcom,sc8280xp-dp
26          - qcom,sc8280xp-edp
27          - qcom,sdm845-dp
28          - qcom,sm8350-dp
29      - items:
30          - enum:
31              - qcom,sm8250-dp
32              - qcom,sm8450-dp
33              - qcom,sm8550-dp
34          - const: qcom,sm8350-dp
35
36  reg:
37    minItems: 4
38    items:
39      - description: ahb register block
40      - description: aux register block
41      - description: link register block
42      - description: p0 register block
43      - description: p1 register block
44
45  interrupts:
46    maxItems: 1
47
48  clocks:
49    items:
50      - description: AHB clock to enable register access
51      - description: Display Port AUX clock
52      - description: Display Port Link clock
53      - description: Link interface clock between DP and PHY
54      - description: Display Port Pixel clock
55
56  clock-names:
57    items:
58      - const: core_iface
59      - const: core_aux
60      - const: ctrl_link
61      - const: ctrl_link_iface
62      - const: stream_pixel
63
64  assigned-clocks:
65    items:
66      - description: link clock source
67      - description: pixel clock source
68
69  assigned-clock-parents:
70    items:
71      - description: phy 0 parent
72      - description: phy 1 parent
73
74  phys:
75    maxItems: 1
76
77  phy-names:
78    items:
79      - const: dp
80
81  operating-points-v2: true
82
83  opp-table:
84    type: object
85
86  power-domains:
87    maxItems: 1
88
89  aux-bus:
90    $ref: /schemas/display/dp-aux-bus.yaml#
91
92  data-lanes:
93    $ref: /schemas/types.yaml#/definitions/uint32-array
94    deprecated: true
95    minItems: 1
96    maxItems: 4
97    items:
98      maximum: 3
99
100  "#sound-dai-cells":
101    const: 0
102
103  vdda-0p9-supply:
104    deprecated: true
105  vdda-1p2-supply:
106    deprecated: true
107
108  ports:
109    $ref: /schemas/graph.yaml#/properties/ports
110    properties:
111      port@0:
112        $ref: /schemas/graph.yaml#/properties/port
113        description: Input endpoint of the controller
114
115      port@1:
116        $ref: /schemas/graph.yaml#/$defs/port-base
117        description: Output endpoint of the controller
118        properties:
119          endpoint:
120            $ref: /schemas/media/video-interfaces.yaml#
121            unevaluatedProperties: false
122            properties:
123              data-lanes:
124                minItems: 1
125                maxItems: 4
126                items:
127                  enum: [ 0, 1, 2, 3 ]
128
129              link-frequencies:
130                minItems: 1
131                maxItems: 4
132                items:
133                  enum: [ 1620000000, 2700000000, 5400000000, 8100000000 ]
134
135    required:
136      - port@0
137      - port@1
138
139required:
140  - compatible
141  - reg
142  - interrupts
143  - clocks
144  - clock-names
145  - phys
146  - phy-names
147  - power-domains
148  - ports
149
150allOf:
151  # AUX BUS does not exist on DP controllers
152  # Audio output also is present only on DP output
153  # p1 regions is present on DP, but not on eDP
154  - if:
155      properties:
156        compatible:
157          contains:
158            enum:
159              - qcom,sc7280-edp
160              - qcom,sc8180x-edp
161              - qcom,sc8280xp-edp
162    then:
163      properties:
164        "#sound-dai-cells": false
165    else:
166      properties:
167        aux-bus: false
168        reg:
169          minItems: 5
170      required:
171        - "#sound-dai-cells"
172
173additionalProperties: false
174
175examples:
176  - |
177    #include <dt-bindings/interrupt-controller/arm-gic.h>
178    #include <dt-bindings/clock/qcom,dispcc-sc7180.h>
179    #include <dt-bindings/power/qcom-rpmpd.h>
180
181    displayport-controller@ae90000 {
182        compatible = "qcom,sc7180-dp";
183        reg = <0xae90000 0x200>,
184              <0xae90200 0x200>,
185              <0xae90400 0xc00>,
186              <0xae91000 0x400>,
187              <0xae91400 0x400>;
188        interrupt-parent = <&mdss>;
189        interrupts = <12>;
190        clocks = <&dispcc DISP_CC_MDSS_AHB_CLK>,
191                 <&dispcc DISP_CC_MDSS_DP_AUX_CLK>,
192                 <&dispcc DISP_CC_MDSS_DP_LINK_CLK>,
193                 <&dispcc DISP_CC_MDSS_DP_LINK_INTF_CLK>,
194                 <&dispcc DISP_CC_MDSS_DP_PIXEL_CLK>;
195        clock-names = "core_iface", "core_aux",
196                      "ctrl_link",
197                      "ctrl_link_iface", "stream_pixel";
198
199        assigned-clocks = <&dispcc DISP_CC_MDSS_DP_LINK_CLK_SRC>,
200                          <&dispcc DISP_CC_MDSS_DP_PIXEL_CLK_SRC>;
201
202        assigned-clock-parents = <&dp_phy 0>, <&dp_phy 1>;
203
204        phys = <&dp_phy>;
205        phy-names = "dp";
206
207        #sound-dai-cells = <0>;
208
209        power-domains = <&rpmhpd SC7180_CX>;
210
211        ports {
212            #address-cells = <1>;
213            #size-cells = <0>;
214
215            port@0 {
216                reg = <0>;
217                endpoint {
218                    remote-endpoint = <&dpu_intf0_out>;
219                };
220            };
221
222            port@1 {
223                reg = <1>;
224                endpoint {
225                    remote-endpoint = <&typec>;
226                    data-lanes = <0 1>;
227                    link-frequencies = /bits/ 64 <1620000000 2700000000 5400000000 8100000000>;
228                };
229            };
230        };
231    };
232...
233