tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
1# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2%YAML 1.2
3---
4$id: "http://devicetree.org/schemas/usb/nvidia,tegra-xudc.yaml#"
5$schema: "http://devicetree.org/meta-schemas/core.yaml#"
6
7title: Device tree binding for NVIDIA Tegra XUSB device mode controller (XUDC)
8
9description:
10 The Tegra XUDC controller supports both USB 2.0 HighSpeed/FullSpeed and
11 USB 3.0 SuperSpeed protocols.
12
13maintainers:
14 - Nagarjuna Kristam <nkristam@nvidia.com>
15 - JC Kuo <jckuo@nvidia.com>
16 - Thierry Reding <treding@nvidia.com>
17
18properties:
19 compatible:
20 items:
21 - enum:
22 - nvidia,tegra210-xudc # For Tegra210
23 - nvidia,tegra186-xudc # For Tegra186
24 - nvidia,tegra194-xudc # For Tegra194
25
26 reg:
27 minItems: 2
28 maxItems: 3
29 items:
30 - description: XUSB device controller registers
31 - description: XUSB device PCI Config registers
32 - description: XUSB device registers.
33
34 reg-names:
35 minItems: 2
36 maxItems: 3
37 items:
38 - const: base
39 - const: fpci
40 - const: ipfs
41
42 interrupts:
43 maxItems: 1
44 description: Must contain the XUSB device interrupt.
45
46 clocks:
47 minItems: 4
48 maxItems: 5
49 items:
50 - description: Clock to enable core XUSB dev clock.
51 - description: Clock to enable XUSB super speed clock.
52 - description: Clock to enable XUSB super speed dev clock.
53 - description: Clock to enable XUSB high speed dev clock.
54 - description: Clock to enable XUSB full speed dev clock.
55
56 clock-names:
57 minItems: 4
58 maxItems: 5
59 items:
60 - const: dev
61 - const: ss
62 - const: ss_src
63 - const: fs_src
64 - const: hs_src
65
66 power-domains:
67 items:
68 - description: XUSBB(device) power-domain
69 - description: XUSBA(superspeed) power-domain
70
71 power-domain-names:
72 items:
73 - const: dev
74 - const: ss
75
76 nvidia,xusb-padctl:
77 $ref: /schemas/types.yaml#/definitions/phandle-array
78 description:
79 phandle to the XUSB pad controller that is used to configure the USB pads
80 used by the XUDC controller.
81
82 phys:
83 minItems: 1
84 description:
85 Must contain an entry for each entry in phy-names.
86 See ../phy/phy-bindings.txt for details.
87
88 phy-names:
89 minItems: 1
90 items:
91 - const: usb2-0
92 - const: usb2-1
93 - const: usb2-2
94 - const: usb2-3
95 - const: usb3-0
96 - const: usb3-1
97 - const: usb3-2
98 - const: usb3-3
99
100 avddio-usb-supply:
101 description: PCIe/USB3 analog logic power supply. Must supply 1.05 V.
102
103 hvdd-usb-supply:
104 description: USB controller power supply. Must supply 3.3 V.
105
106required:
107 - compatible
108 - reg
109 - reg-names
110 - interrupts
111 - clocks
112 - clock-names
113 - power-domains
114 - power-domain-names
115 - nvidia,xusb-padctl
116 - phys
117 - phy-names
118
119allOf:
120 - if:
121 properties:
122 compatible:
123 contains:
124 enum:
125 - nvidia,tegra210-xudc
126 then:
127 properties:
128 reg:
129 minItems: 3
130 reg-names:
131 minItems: 3
132 clocks:
133 minItems: 5
134 clock-names:
135 minItems: 5
136 required:
137 - avddio-usb-supply
138 - hvdd-usb-supply
139
140 - if:
141 properties:
142 compatible:
143 contains:
144 enum:
145 - nvidia,tegra186-xudc
146 - nvidia,tegra194-xudc
147 then:
148 properties:
149 reg:
150 maxItems: 2
151 reg-names:
152 maxItems: 2
153 clocks:
154 maxItems: 4
155 clock-names:
156 maxItems: 4
157
158additionalProperties: false
159
160examples:
161 - |
162 #include <dt-bindings/clock/tegra210-car.h>
163 #include <dt-bindings/gpio/tegra-gpio.h>
164 #include <dt-bindings/interrupt-controller/arm-gic.h>
165
166 usb@700d0000 {
167 compatible = "nvidia,tegra210-xudc";
168 reg = <0x700d0000 0x8000>,
169 <0x700d8000 0x1000>,
170 <0x700d9000 0x1000>;
171 reg-names = "base", "fpci", "ipfs";
172
173 interrupts = <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>;
174
175 clocks = <&tegra_car TEGRA210_CLK_XUSB_DEV>,
176 <&tegra_car TEGRA210_CLK_XUSB_SS>,
177 <&tegra_car TEGRA210_CLK_XUSB_SSP_SRC>,
178 <&tegra_car TEGRA210_CLK_XUSB_FS_SRC>,
179 <&tegra_car TEGRA210_CLK_XUSB_HS_SRC>;
180 clock-names = "dev", "ss", "ss_src", "fs_src", "hs_src";
181
182 power-domains = <&pd_xusbdev>, <&pd_xusbss>;
183 power-domain-names = "dev", "ss";
184
185 nvidia,xusb-padctl = <&padctl>;
186
187 phys = <µ_b>;
188 phy-names = "usb2-0";
189
190 avddio-usb-supply = <&vdd_pex_1v05>;
191 hvdd-usb-supply = <&vdd_3v3_sys>;
192 };