Gitiles
Code Review Sign In
git01.mediatek.com / filogic / uboot / 166a047e272472c6b60ce4c0746fa995993451c8 / . / dts / upstream / Bindings / usb / mediatek,mtu3.yaml
blob: a59d91243ac836a94c0f990f487fab747ff4708b [file] [log] [blame]
Tom Rini53633a82024-02-29 12:33:36 -0500[diff] [blame]1# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
2# Copyright (c) 2020 MediaTek
3%YAML 1.2
4---
5$id: http://devicetree.org/schemas/usb/mediatek,mtu3.yaml#
6$schema: http://devicetree.org/meta-schemas/core.yaml#
7
8title: MediaTek USB3 DRD Controller
9
10maintainers:
11 - Chunfeng Yun <chunfeng.yun@mediatek.com>
12
13allOf:
14 - $ref: usb-drd.yaml
15
16description: |
17 The DRD controller has a glue layer IPPC (IP Port Control), and its host is
18 based on xHCI.
19
20properties:
21 compatible:
22 items:
23 - enum:
24 - mediatek,mt2712-mtu3
25 - mediatek,mt8173-mtu3
26 - mediatek,mt8183-mtu3
27 - mediatek,mt8186-mtu3
28 - mediatek,mt8188-mtu3
29 - mediatek,mt8192-mtu3
30 - mediatek,mt8195-mtu3
31 - mediatek,mt8365-mtu3
32 - const: mediatek,mtu3
33
34 reg:
35 items:
36 - description: the registers of device MAC
37 - description: the registers of IP Port Control
38
39 reg-names:
40 items:
41 - const: mac
42 - const: ippc
43
44 interrupts:
45 description:
46 use "interrupts-extended" when the interrupts are connected to the
47 separate interrupt controllers
48 minItems: 1
49 items:
50 - description: SSUSB device controller interrupt
51 - description: optional, wakeup interrupt used to support runtime PM
52
53 interrupt-names:
54 items:
55 - const: device
56 - const: wakeup
57
58 power-domains:
59 description: A phandle to USB power domain node to control USB's MTCMOS
60 maxItems: 1
61
62 clocks:
63 minItems: 1
64 items:
65 - description: Controller clock used by normal mode
66 - description: Reference clock used by low power mode etc
67 - description: Mcu bus clock for register access
68 - description: DMA bus clock for data transfer
69 - description: DRD controller clock
70 - description: Frame count clock
71
72 clock-names:
73 minItems: 1
74 items:
75 - const: sys_ck # required, others are optional
76 - const: ref_ck
77 - const: mcu_ck
78 - const: dma_ck
79 - const: xhci_ck
80 - const: frmcnt_ck
81
82 phys:
83 description:
84 List of all the USB PHYs used, it's better to keep the sequence
85 as the hardware layout.
86 minItems: 1
87 items:
88 - description: USB2/HS PHY # required, others are optional
89 - description: USB3/SS(P) PHY
90 - description: USB2/HS PHY # the following for backward compatible
91 - description: USB3/SS(P) PHY
92 - description: USB2/HS PHY
93 - description: USB3/SS(P) PHY
94 - description: USB2/HS PHY
95 - description: USB3/SS(P) PHY
96 - description: USB2/HS PHY
97
98 vusb33-supply:
99 description: Regulator of USB AVDD3.3v
100
101 vbus-supply:
102 deprecated: true
103 description: |
104 Regulator of USB VBUS5v, needed when supports dual-role mode.
105 Particularly, if use an output GPIO to control a VBUS regulator, should
106 model it as a regulator. See bindings/regulator/fixed-regulator.yaml
107 It's considered valid for compatibility reasons, not allowed for
108 new bindings, and put into a usb-connector node.
109
110 dr_mode:
111 enum: [host, peripheral, otg]
112 default: otg
113
114 maximum-speed:
115 enum: [super-speed-plus, super-speed, high-speed, full-speed]
116
117 resets:
118 maxItems: 1
119
120 "#address-cells":
121 enum: [1, 2]
122
123 "#size-cells":
124 enum: [1, 2]
125
126 ranges: true
127
128 extcon:
129 deprecated: true
130 description: |
131 Phandle to the extcon device detecting the IDDIG state, needed
132 when supports dual-role mode.
133 It's considered valid for compatibility reasons, not allowed for
134 new bindings, and use "usb-role-switch" property instead.
135
136 usb-role-switch:
137 $ref: /schemas/types.yaml#/definitions/flag
138 description: Support role switch.
139 type: boolean
140
141 role-switch-default-mode:
142 enum: [host, peripheral]
143 default: host
144
145 connector:
146 $ref: /schemas/connector/usb-connector.yaml#
147 description:
148 Connector for dual role switch, especially for "gpio-usb-b-connector"
149 type: object
150
151 port:
152 description:
153 Any connector to the data bus of this controller should be modelled
154 using the OF graph bindings specified, if the "usb-role-switch"
155 property is used. See graph.txt
156 $ref: /schemas/graph.yaml#/properties/port
157
158 enable-manual-drd:
159 $ref: /schemas/types.yaml#/definitions/flag
160 description:
161 supports manual dual-role switch via debugfs; usually used when
162 receptacle is TYPE-A and also wants to support dual-role mode.
163 type: boolean
164
165 wakeup-source:
166 description: enable USB remote wakeup, see power/wakeup-source.txt
167 type: boolean
168
169 mediatek,syscon-wakeup:
170 $ref: /schemas/types.yaml#/definitions/phandle-array
171 maxItems: 1
172 description:
173 A phandle to syscon used to access the register of the USB wakeup glue
174 layer between xHCI and SPM, the field should always be 3 cells long.
175 items:
176 items:
177 - description:
178 The first cell represents a phandle to syscon
179 - description:
180 The second cell represents the register base address of the glue
181 layer in syscon
182 - description: |
183 The third cell represents the hardware version of the glue layer,
184 1 - used by mt8173 etc, revision 1 without following IPM rule;
185 2 - used by mt2712 etc, revision 2 with following IPM rule;
186 101 - used by mt8183, specific 1.01;
187 102 - used by mt8192, specific 1.02;
188 enum: [1, 2, 101, 102]
189
190 mediatek,u3p-dis-msk:
191 $ref: /schemas/types.yaml#/definitions/uint32
192 description: The mask to disable u3ports, bit0 for u3port0,
193 bit1 for u3port1, ... etc
194
195 mediatek,u2p-dis-msk:
196 $ref: /schemas/types.yaml#/definitions/uint32
197 description: The mask to disable u2ports, bit0 for u2port0,
198 bit1 for u2port1, ... etc; but can't disable u2port0 if dual role mode
199 is enabled, so will be skipped in this case.
200
201# Required child node when support dual-role
202patternProperties:
203 "^usb@[0-9a-f]+$":
204 type: object
205 $ref: /schemas/usb/mediatek,mtk-xhci.yaml#
206 description:
207 The xhci should be added as subnode to mtu3 as shown in the following
208 example if the host mode is enabled.
209
210dependencies:
211 connector: [ usb-role-switch ]
212 port: [ usb-role-switch ]
213 role-switch-default-mode: [ usb-role-switch ]
214 wakeup-source: [ 'mediatek,syscon-wakeup' ]
215
216required:
217 - compatible
218 - reg
219 - reg-names
220 - interrupts
221 - clocks
222 - clock-names
223
224additionalProperties: false
225
226examples:
227 # Dual role switch by extcon
228 - |
229 #include <dt-bindings/clock/mt8173-clk.h>
230 #include <dt-bindings/interrupt-controller/arm-gic.h>
231 #include <dt-bindings/interrupt-controller/irq.h>
232 #include <dt-bindings/phy/phy.h>
233 #include <dt-bindings/power/mt8173-power.h>
234
235 usb@11271000 {
236 compatible = "mediatek,mt8173-mtu3", "mediatek,mtu3";
237 reg = <0x11271000 0x3000>, <0x11280700 0x0100>;
238 reg-names = "mac", "ippc";
239 interrupts = <GIC_SPI 64 IRQ_TYPE_LEVEL_LOW>;
240 phys = <&phy_port0 PHY_TYPE_USB3>, <&phy_port1 PHY_TYPE_USB2>;
241 power-domains = <&scpsys MT8173_POWER_DOMAIN_USB>;
242 clocks = <&topckgen CLK_TOP_USB30_SEL>;
243 clock-names = "sys_ck";
244 vusb33-supply = <&mt6397_vusb_reg>;
245 vbus-supply = <&usb_p0_vbus>;
246 extcon = <&extcon_usb>;
247 dr_mode = "otg";
248 wakeup-source;
249 mediatek,syscon-wakeup = <&pericfg 0x400 1>;
250 #address-cells = <1>;
251 #size-cells = <1>;
252 ranges;
253
254 xhci: usb@11270000 {
255 compatible = "mediatek,mt8173-xhci", "mediatek,mtk-xhci";
256 reg = <0x11270000 0x1000>;
257 reg-names = "mac";
258 interrupts = <GIC_SPI 115 IRQ_TYPE_LEVEL_LOW>;
259 power-domains = <&scpsys MT8173_POWER_DOMAIN_USB>;
260 clocks = <&topckgen CLK_TOP_USB30_SEL>, <&clk26m>;
261 clock-names = "sys_ck", "ref_ck";
262 vusb33-supply = <&mt6397_vusb_reg>;
263 };
264 };
265
266 # Dual role switch by gpio-usb-b-connector
267 - |
268 #include <dt-bindings/gpio/gpio.h>
269 #include <dt-bindings/power/mt2712-power.h>
270
271 usb@112c1000 {
272 compatible = "mediatek,mt2712-mtu3", "mediatek,mtu3";
273 reg = <0x112c1000 0x3000>, <0x112d0700 0x0100>;
274 reg-names = "mac", "ippc";
275 interrupts = <GIC_SPI 248 IRQ_TYPE_LEVEL_LOW>;
276 phys = <&u2port2 PHY_TYPE_USB2>;
277 power-domains = <&scpsys MT2712_POWER_DOMAIN_USB2>;
278 clocks = <&topckgen CLK_TOP_USB30_SEL>;
279 clock-names = "sys_ck";
280 dr_mode = "otg";
281 usb-role-switch;
282 #address-cells = <1>;
283 #size-cells = <1>;
284 ranges;
285
286 host0: usb@11270000 {
287 compatible = "mediatek,mt2712-xhci", "mediatek,mtk-xhci";
288 reg = <0x11270000 0x1000>;
289 reg-names = "mac";
290 interrupts = <GIC_SPI 123 IRQ_TYPE_LEVEL_LOW>;
291 power-domains = <&scpsys MT2712_POWER_DOMAIN_USB>;
292 clocks = <&topckgen CLK_TOP_USB30_SEL>, <&clk26m>;
293 clock-names = "sys_ck", "ref_ck";
294 };
295
296 connector {
297 compatible = "gpio-usb-b-connector", "usb-b-connector";
298 type = "micro";
299 id-gpios = <&pio 12 GPIO_ACTIVE_HIGH>;
300 vbus-supply = <&usb_p0_vbus>;
301 };
302 };
303
304 # Dual role switch with type-c
305 - |
306 usb@11201000 {
307 compatible = "mediatek,mt8183-mtu3", "mediatek,mtu3";
308 reg = <0x11201000 0x2e00>, <0x11203e00 0x0100>;
309 reg-names = "mac", "ippc";
310 interrupts = <GIC_SPI 72 IRQ_TYPE_LEVEL_LOW>;
311 phys = <&u2port0 PHY_TYPE_USB2>;
312 clocks = <&clk26m>;
313 clock-names = "sys_ck";
314 mediatek,syscon-wakeup = <&pericfg 0x400 1>;
315 wakeup-source;
316 dr_mode = "otg";
317 usb-role-switch;
318 role-switch-default-mode = "host";
319 #address-cells = <1>;
320 #size-cells = <1>;
321 ranges;
322
323 host: usb@11200000 {
324 compatible = "mediatek,mt8183-xhci", "mediatek,mtk-xhci";
325 reg = <0x11200000 0x1000>;
326 reg-names = "mac";
327 interrupts = <GIC_SPI 73 IRQ_TYPE_LEVEL_LOW>;
328 clocks = <&clk26m>;
329 clock-names = "sys_ck";
330 };
331
332 port {
333 usb_role_sw: endpoint {
334 remote-endpoint = <&hs_ep>;
335 };
336 };
337 };
338
339...