dt-binding: usb: add bindings for some common properties
[platform/kernel/u-boot.git] / doc / device-tree-bindings / usb / generic.txt
1 Generic USB Properties
2
3 Optional properties:
4  - maximum-speed: tells USB controllers we want to work up to a certain
5                         speed. Valid arguments are "super-speed-plus",
6                         "super-speed", "high-speed", "full-speed" and
7                         "low-speed". In case this isn't passed via DT, USB
8                         controllers should default to their maximum HW
9                         capability.
10  - dr_mode: tells Dual-Role USB controllers that we want to work on a
11                         particular mode. Valid arguments are "host",
12                         "peripheral" and "otg". In case this attribute isn't
13                         passed via DT, USB DRD controllers should default to
14                         OTG.
15  - phy_type: tells USB controllers that we want to configure the core to support
16                         a UTMI+ PHY with an 8- or 16-bit interface if UTMI+ is
17                         selected. Valid arguments are "utmi" and "utmi_wide".
18                         In case this isn't passed via DT, USB controllers should
19                         default to HW capability.
20
21 This is an attribute to a USB controller such as:
22
23 dwc3@4a030000 {
24         compatible = "synopsys,dwc3";
25         reg = <0x4a030000 0xcfff>;
26         interrupts = <0 92 4>
27         usb-phy = <&usb2_phy>, <&usb3,phy>;
28         maximum-speed = "super-speed";
29         dr_mode = "otg";
30         phy_type = "utmi_wide";
31 };