bindings/usb/usb-device.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
3 ---
4 $id: http://devicetree.org/schemas/usb/usb-device.yaml#
5 $schema: http://devicetree.org/meta-schemas/core.yaml#
7 title: Generic USB Device
10   - Greg Kroah-Hartman <gregkh@linuxfoundation.org>
13   Usually, we only use device tree for hard wired USB device.
15   http://www.devicetree.org/open-firmware/bindings/usb/usb-1_0.ps
17   Four types of device-tree nodes are defined: "host-controller nodes"
18   representing USB host controllers, "device nodes" representing USB devices,
19   "interface nodes" representing USB interfaces and "combined nodes"
20   representing simple USB devices.
26   A "hub node" is a combined node or an interface node that represents a USB
31     pattern: "^usb[0-9a-f]{1,4},[0-9a-f]{1,4}$"
41     description: the number of the USB hub port or the USB host-controller
42       port to which this device is attached. The range is 1-255.
43     maxItems: 1
45   "#address-cells":
46     description: should be 1 for hub nodes with device nodes,
48     enum: [1, 2]
50   "#size-cells":
54   "^interface@[0-9a-f]{1,2}(,[0-9a-f]{1,2})$":
56     description: USB interface nodes.
58       representation of an interface-node unit address for configuration 1.
62         pattern: "^usbif[0-9a-f]{1,4},[0-9a-f]{1,4}.config[0-9a-f]{1,2}.[0-9a-f]{1,2}$"
76         maxItems: 1
79   - reg
84   # hub connected to port 1
87   #    interface 0 of configuration 1
89   - |
90     usb@11270000 {
93         #address-cells = <1>;
94         #size-cells = <0>;
96         hub@1 {
98             reg = <1>;
110             #address-cells = <2>;
111             #size-cells = <0>;
115                 reg = <0 1>;