xref: /freebsd/sys/contrib/device-tree/Bindings/display/tegra/nvidia,tegra20-dc.yaml (revision 7ef62cebc2f965b0f640263e179276928885e33d)
1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/display/tegra/nvidia,tegra20-dc.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: NVIDIA Tegra Display Controller
8
9maintainers:
10  - Thierry Reding <thierry.reding@gmail.com>
11  - Jon Hunter <jonathanh@nvidia.com>
12
13properties:
14  $nodename:
15    pattern: "^dc@[0-9a-f]+$"
16
17  compatible:
18    oneOf:
19      - enum:
20          - nvidia,tegra20-dc
21          - nvidia,tegra30-dc
22          - nvidia,tegra114-dc
23          - nvidia,tegra124-dc
24          - nvidia,tegra210-dc
25
26      - items:
27          - const: nvidia,tegra124-dc
28          - const: nvidia,tegra132-dc
29
30  reg:
31    maxItems: 1
32
33  interrupts:
34    maxItems: 1
35
36  clocks:
37    minItems: 1
38    items:
39      - description: display controller pixel clock
40      - description: parent clock # optional
41
42  clock-names:
43    minItems: 1
44    items:
45      - const: dc
46      - const: parent # optional
47
48  resets:
49    items:
50      - description: module reset
51
52  reset-names:
53    items:
54      - const: dc
55
56  interconnect-names: true
57  interconnects: true
58
59  iommus:
60    maxItems: 1
61
62  operating-points-v2:
63    $ref: "/schemas/types.yaml#/definitions/phandle"
64
65  power-domains:
66    items:
67      - description: phandle to the core power domain
68
69  memory-region: true
70
71  nvidia,head:
72    $ref: /schemas/types.yaml#/definitions/uint32
73    description: The number of the display controller head. This is used to setup the various
74      types of output to receive video data from the given head.
75
76  nvidia,outputs:
77    $ref: /schemas/types.yaml#/definitions/phandle-array
78    description: A list of phandles of outputs that this display controller can drive.
79
80  rgb:
81    type: object
82
83allOf:
84  - if:
85      properties:
86        compatible:
87          contains:
88            enum:
89              - nvidia,tegra20-dc
90              - nvidia,tegra30-dc
91              - nvidia,tegra114-dc
92    then:
93      properties:
94        interconnects:
95          items:
96            - description: window A memory client
97            - description: window B memory client
98            - description: window B memory client (vertical filter)
99            - description: window C memory client
100            - description: cursor memory client
101
102        interconnect-names:
103          items:
104            - const: wina
105            - const: winb
106            - const: winb-vfilter
107            - const: winc
108            - const: cursor
109
110        rgb:
111          description: Each display controller node has a child node, named "rgb", that represents
112            the RGB output associated with the controller.
113          type: object
114          properties:
115            nvidia,ddc-i2c-bus:
116              $ref: /schemas/types.yaml#/definitions/phandle
117              description: phandle of an I2C controller used for DDC EDID probing
118
119            nvidia,hpd-gpio:
120              description: specifies a GPIO used for hotplug detection
121              maxItems: 1
122
123            nvidia,edid:
124              $ref: /schemas/types.yaml#/definitions/uint8-array
125              description: supplies a binary EDID blob
126
127            nvidia,panel:
128              $ref: /schemas/types.yaml#/definitions/phandle
129              description: phandle of a display panel
130
131  - if:
132      properties:
133        compatible:
134          contains:
135            enum:
136              - nvidia,tegra124-dc
137    then:
138      properties:
139        interconnects:
140          minItems: 4
141          items:
142            - description: window A memory client
143            - description: window B memory client
144            - description: window C memory client
145            - description: cursor memory client
146            - description: window D memory client
147            - description: window T memory client
148
149        interconnect-names:
150          minItems: 4
151          items:
152            - const: wina
153            - const: winb
154            - const: winc
155            - const: cursor
156            - const: wind
157            - const: wint
158
159additionalProperties: false
160
161required:
162  - compatible
163  - reg
164  - interrupts
165  - clocks
166  - clock-names
167  - resets
168  - reset-names
169
170examples:
171  - |
172    #include <dt-bindings/clock/tegra20-car.h>
173    #include <dt-bindings/interrupt-controller/arm-gic.h>
174
175    dc@54200000 {
176        compatible = "nvidia,tegra20-dc";
177        reg = <0x54200000 0x00040000>;
178        interrupts = <GIC_SPI 73 IRQ_TYPE_LEVEL_HIGH>;
179        clocks = <&tegra_car TEGRA20_CLK_DISP1>;
180        clock-names = "dc";
181        resets = <&tegra_car 27>;
182        reset-names = "dc";
183    };
184