Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit f877918c authored by Johan Hovold's avatar Johan Hovold Committed by Rob Herring
Browse files

dt-bindings: usb: document hub and host-controller properties 



Hub nodes and host-controller nodes with child nodes must specify values
for #address-cells (1) and #size-cells (0).

Also make the definition of the related reg property a bit more
stringent, and add comments to the example source.

Signed-off-by: default avatarJohan Hovold <johan@kernel.org>
Signed-off-by: default avatarRob Herring <robh@kernel.org>
parent bfebcf54

Documentation/devicetree/bindings/usb/usb-device.txt

+16 −4
Original line number Diff line number Diff line
@@ -4,22 +4,34 @@ Usually, we only use device tree for hard wired USB device. 
The reference binding doc is from:

http://www.devicetree.org/open-firmware/bindings/usb/usb-1_0.ps





Required properties:

- compatible: "usbVID,PID", where VID is the vendor id and PID the product id.

  The textual representation of VID and PID shall be in lower case hexadecimal

  with leading zeroes suppressed. The other compatible strings from the above

  standard binding could also be used, but a device adhering to this binding

  may leave out all except for "usbVID,PID".

- reg: the port number which this device is connecting to, the range

  is 1-255.

- reg: the number of the USB hub port or the USB host-controller port to which

  this device is attached. The range is 1-255.





Required properties for hub nodes with device nodes:

- #address-cells: shall be 1

- #size-cells: shall be 0





Required properties for host-controller nodes with device nodes:

- #address-cells: shall be 1

- #size-cells: shall be 0





Example:



&usb1 {

&usb1 {	/* host controller */

	#address-cells = <1>;

	#size-cells = <0>;



	hub@1 {

	hub@1 {	/* hub connected to port 1 */

		compatible = "usb5e3,608";

		reg = <1>;

	};