bindings/usb/snps%2Cdwc3.yaml

1 # SPDX-License-Identifier: GPL-2.0
3 ---
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Felipe Balbi <balbi@kernel.org>
14   be presented as a standalone DT node with an optional vendor-specific
18   - $ref: usb-drd.yaml#
19   - if:
25         - dr_mode
29       $ref: usb-xhci.yaml#
35         - const: snps,dwc3
36         - const: synopsys,dwc3
49   interrupt-names:
53       - const: dwc_usb3
54       - items:
65   clock-names:
68         - enum: [bus_early, ref, suspend]
69         - true
71   dma-coherent: true
80   usb-phy:
83       - description: USB2/HS PHY
84       - description: USB3/SS PHY
90   phy-names:
95         - usb2-phy
96         - usb3-phy
98   power-domains:
100       The DWC3 has 2 power-domains. The power management unit (PMU) and
105       - description: Core
106       - description: Power management unit
111   snps,usb2-lpm-disable:
112     description: Indicate if we don't want to enable USB2 HW LPM for host
117     description: Determines if platform is USB3 LPM capable
120   snps,usb2-gadget-lpm-disable:
121     description: Indicate if we don't want to enable USB2 HW LPM for gadget
125   snps,dis-start-transfer-quirk:
127       When set, disable isoc START TRANSFER command failure SW work-around
128       for DWC_usb31 version 1.70a-ea06 and prior.
137   snps,has-lpm-erratum:
138     description: True when DWC3 was configured with LPM Erratum enabled
141   snps,lpm-nyet-threshold:
142     description: LPM NYET threshold
179     description: When set core will set Tx de-emphasis value
188       - 0 # -6dB de-emphasis
189       - 1 # -3.5dB de-emphasis
190       - 2 # No de-emphasis
206   snps,dis-u1-entry-quirk:
210   snps,dis-u2-entry-quirk:
219   snps,dis-u2-freeclk-exists-quirk:
222       PHY doesn't provide a free-running PHY clock.
225   snps,dis-del-phy-power-chg-quirk:
230   snps,dis-tx-ipgap-linecheck-quirk:
234   snps,parkmode-disable-ss-quirk:
239   snps,parkmode-disable-hs-quirk:
250   snps,dis-split-quirk:
253       avoid -EPROTO errors with usbhid on some devices (Hikey 970).
256   snps,gfladj-refclk-lpm-sel-quirk:
261   snps,resume-hs-terminations:
268   snps,ulpi-ext-vbus-drv:
276   snps,is-utmi-l1-suspend:
282   snps,hird-threshold:
288       High-Speed PHY interface selection between UTMI+ and ULPI when the
289       DWC_USB3_HSPHY_INTERFACE has value 3.
293   snps,quirk-frame-length-adjustment:
295       Value for GFLADJ_30MHZ field of GFLADJ register for post-silicon frame
302   snps,ref-clock-period-ns:
313   snps,rx-thr-num-pkt-prd:
316       snps,rx-max-burst-prd to a valid, non-zero value 1-16 (DWC_usb31
322   snps,rx-max-burst-prd:
325       snps,rx-thr-num-pkt-prd to a valid, non-zero value 1-16 (DWC_usb31
331   snps,tx-thr-num-pkt-prd:
334       snps,tx-max-burst-prd to a valid, non-zero value 1-16 (DWC_usb31
340   snps,tx-max-burst-prd:
343       snps,tx-thr-num-pkt-prd to a valid, non-zero value 1-16 (DWC_usb31
349   tx-fifo-resize:
357   tx-fifo-max-num:
365   snps,incr-burst-type-adjustment:
372     $ref: /schemas/types.yaml#/definitions/uint32-array
382       This port is used with the 'usb-role-switch' property  to connect the
389       controller using the OF graph bindings specified if the "usb-role-switch"
401   wakeup-source:
409   - compatible
410   - reg
411   - interrupts
414   - |
419       usb-phy = <&usb2_phy>, <&usb3_phy>;
420       snps,incr-burst-type-adjustment = <1>, <4>, <8>, <16>;
422   - |
428       clock-names = "bus_early", "ref", "suspend";
430       phy-names = "usb2-phy", "usb3-phy";