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:
56       mode.
63   snps,usb2-gadget-lpm-disable:
65       mode.
68   snps,reserved-endpoints:
70       Reserve endpoints for other needs, e.g, for tracing control and output.
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
139       Compliance mode.
142       - 0 # -6dB de-emphasis
143       - 1 # -3.5dB de-emphasis
144       - 2 # No de-emphasis
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:
190       When set, all SuperSpeed bus instances in park mode are disabled.
193   snps,parkmode-disable-hs-quirk:
195       When set, all HighSpeed bus instances in park mode are disabled.
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:
222   snps,ulpi-ext-vbus-drv:
230   snps,is-utmi-l1-suspend:
232       True when DWC3 asserts output signal utmi_l1_suspend_n, false when
236   snps,hird-threshold:
242       High-Speed PHY interface selection between UTMI+ and ULPI when the
247   snps,quirk-frame-length-adjustment:
249       Value for GFLADJ_30MHZ field of GFLADJ register for post-silicon frame
256   snps,ref-clock-period-ns:
267   snps,rx-thr-num-pkt:
269       USB RX packet threshold count. In host mode, this field specifies
272       In device mode, this field specifies the space that must be
274       flow-controlled endpoint. It is only used for SuperSpeed.
281   snps,rx-max-burst:
283       Max USB RX burst size. In host mode, this field specifies the
288       Isochronous, and Interrupt IN endpoints in the host mode.
289       In device mode, this field specifies the NUMP value that is sent in
297   snps,tx-thr-num-pkt:
299       USB TX packet threshold count. This field specifies the number of
310   snps,tx-max-burst:
312       Max USB TX burst size. When the system bus is slower than the USB,
313       TX FIFO can underrun during a long burst. Program a smaller value
314       to this field to limit the TX burst size that the core can execute.
315       In Host mode, it only applies to SS Bulk, Isochronous, and Interrupt
316       OUT endpoints. This value is not used in device mode.
323   snps,rx-thr-num-pkt-prd:
325       Periodic ESS RX packet threshold count (host mode only). Set this and
326       snps,rx-max-burst-prd to a valid, non-zero value 1-16 (DWC_usb31
332   snps,rx-max-burst-prd:
334       Max periodic ESS RX burst size (host mode only). Set this and
335       snps,rx-thr-num-pkt-prd to a valid, non-zero value 1-16 (DWC_usb31
341   snps,tx-thr-num-pkt-prd:
343       Periodic ESS TX packet threshold count (host mode only). Set this and
344       snps,tx-max-burst-prd to a valid, non-zero value 1-16 (DWC_usb31
345       programming guide section 1.2.3) to enable periodic ESS TX threshold.
350   snps,tx-max-burst-prd:
352       Max periodic ESS TX burst size (host mode only). Set this and
353       snps,tx-thr-num-pkt-prd to a valid, non-zero value 1-16 (DWC_usb31
354       programming guide section 1.2.3) to enable periodic ESS TX threshold.
359   tx-fifo-resize:
360     description: Determines if the TX fifos can be dynamically resized depending
367   tx-fifo-max-num:
375   snps,incr-burst-type-adjustment:
378       burst type enable and INCRx type. A single value means INCRX burst mode
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"
415   wakeup-source:
421   - compatible
422   - reg