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:
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:
129       RX.Detect.
133     description: When set core will set Tx de-emphasis value
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:
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:
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
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
270       the space that must be available in the RX FIFO before the core can
271       start the corresponding USB RX transaction (burst).
273       available in the RX FIFO before the core can send ERDY for a
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
284       Maximum Bulk IN burst the DWC_usb3 core can perform. When the system
285       bus is slower than the USB, RX FIFO can overrun during a long burst.
286       You can program a smaller value to this field to limit the RX burst
297   snps,tx-thr-num-pkt:
301       transmission for the corresponding USB transaction (burst).
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.
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
327       programming guide section 1.2.4) to enable periodic ESS RX threshold.
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
336       programming guide section 1.2.4) to enable periodic ESS RX threshold.
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:
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
359   tx-fifo-resize:
367   tx-fifo-max-num:
368     description: Specifies the max number of packets the txfifo resizing logic
375   snps,incr-burst-type-adjustment:
377       Value for INCR burst type of GSBUSCFG0 register, undefined length INCR
378       burst type enable and INCRx type. A single value means INCRX burst mode
379       enabled. If more than one value specified, undefined length INCR burst
380       type will be enabled with burst lengths utilized up to the maximum
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