bindings/usb/snps%2Cdwc3-common.yaml

1 # SPDX-License-Identifier: GPL-2.0
3 ---
4 $id: http://devicetree.org/schemas/usb/snps,dwc3-common.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
10   - Felipe Balbi <balbi@kernel.org>
14   vendor-specific implementation or as a standalone component.
17   - $ref: usb-drd.yaml#
18   - if:
24         - dr_mode
28       $ref: usb-xhci.yaml#
35   usb-phy:
38       - description: USB2/HS PHY
39       - description: USB3/SS PHY
45   phy-names:
49       - items:
50           enum: [ usb2-phy, usb3-phy ]
51       - items:
52           pattern: "^usb(2-([0-9]|1[0-4])|3-[0-3])$"
54   snps,usb2-lpm-disable:
60     description: Determines if platform is USB3 LPM capable
63   snps,usb2-gadget-lpm-disable:
68   snps,reserved-endpoints:
72     $ref: /schemas/types.yaml#/definitions/uint8-array
79   snps,dis-start-transfer-quirk:
81       When set, disable isoc START TRANSFER command failure SW work-around
82       for DWC_usb31 version 1.70a-ea06 and prior.
91   snps,has-lpm-erratum:
95   snps,lpm-nyet-threshold:
133     description: When set core will set Tx de-emphasis value
138       The value driven to the PHY is controlled by the LTSSM during USB3
142       - 0 # -6dB de-emphasis
143       - 1 # -3.5dB de-emphasis
144       - 2 # No de-emphasis
147     description: When set core will disable USB3 suspend phy
151     description: When set core will disable USB2 suspend phy
156       When set clears the enblslpm in GUSB2PHYCFG, disabling the suspend signal
160   snps,dis-u1-entry-quirk:
164   snps,dis-u2-entry-quirk:
173   snps,dis-u2-freeclk-exists-quirk:
176       PHY doesn't provide a free-running PHY clock.
179   snps,dis-del-phy-power-chg-quirk:
184   snps,dis-tx-ipgap-linecheck-quirk:
188   snps,parkmode-disable-ss-quirk:
193   snps,parkmode-disable-hs-quirk:
204   snps,dis-split-quirk:
207       avoid -EPROTO errors with usbhid on some devices (Hikey 970).
210   snps,gfladj-refclk-lpm-sel-quirk:
215   snps,resume-hs-terminations:
219       of resume. This option is to support certain legacy ULPI PHYs.
222   snps,ulpi-ext-vbus-drv:
230   snps,is-utmi-l1-suspend:
236   snps,hird-threshold:
242       High-Speed PHY interface selection between UTMI+ and ULPI when the
245     enum: [utmi, ulpi]
247   snps,quirk-frame-length-adjustment:
249       Value for GFLADJ_30MHZ field of GFLADJ register for post-silicon frame
250       length adjustment when the fladj_30mhz_sdbnd signal is invalid or
256   snps,ref-clock-period-ns:
262       This binding is deprecated. Instead, provide an appropriate reference clock.
267   snps,rx-thr-num-pkt:
274       flow-controlled endpoint. It is only used for SuperSpeed.
281   snps,rx-max-burst:
285       bus is slower than the USB, RX FIFO can overrun during a long burst.
289       In device mode, this field specifies the NUMP value that is sent in
297   snps,tx-thr-num-pkt:
302       This count is valid in both host and device modes. It is only used
310   snps,tx-max-burst:
312       Max USB TX burst size. When the system bus is slower than the USB,
316       OUT endpoints. This value is not used in device mode.
323   snps,rx-thr-num-pkt-prd:
326       snps,rx-max-burst-prd to a valid, non-zero value 1-16 (DWC_usb31
332   snps,rx-max-burst-prd:
335       snps,rx-thr-num-pkt-prd to a valid, non-zero value 1-16 (DWC_usb31
341   snps,tx-thr-num-pkt-prd:
344       snps,tx-max-burst-prd to a valid, non-zero value 1-16 (DWC_usb31
350   snps,tx-max-burst-prd:
353       snps,tx-thr-num-pkt-prd to a valid, non-zero value 1-16 (DWC_usb31
359   tx-fifo-resize:
361       on the number of IN endpoints used and if bursting is supported.  This
367   tx-fifo-max-num:
369       can account for when higher endpoint bursting is used. (bMaxBurst > 6) The
375   snps,incr-burst-type-adjustment:
382     $ref: /schemas/types.yaml#/definitions/uint32-array
389   num-hc-interrupters:
396       This port is used with the 'usb-role-switch' property  to connect the
403       controller using the OF graph bindings specified if the "usb-role-switch"
404       property is used.
415   wakeup-source:
421   - compatible
422   - reg