[PATCH v2 2/5] usb: DT binding documentation for qoriq usb 2.0 controller
From: robh@kernel.org (Rob Herring)
Date: 2016-07-16 00:29:01
Also in:
linux-devicetree, lkml
On Sat, Jul 09, 2016 at 10:00:53AM +0530, Rajesh Bhagat wrote:
quoted hunk
Describes the qoriq usb 2.0 controller driver binding, currently used for LS1021A and LS1012A platform. Signed-off-by: Rajesh Bhagat <redacted> --- Changes in v2: - Adds DT binding documentation for qoriq usb 2.0 controller - Changed the compatible string to fsl,ci-qoriq-usb2 .../devicetree/bindings/usb/ci-hdrc-qoriq.txt | 34 ++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txtdiff --git a/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt new file mode 100644 index 0000000..8ad7306 --- /dev/null +++ b/Documentation/devicetree/bindings/usb/ci-hdrc-qoriq.txt@@ -0,0 +1,34 @@ +* Freescale QorIQ SoC USB 2.0 Controllers + +Required properties: +- compatible: Should be "fsl,ci-qoriq-usb2" + Wherever applicable, the IP version of the USB controller should + also be mentioned (for eg. fsl,ci-qoriq-usb2-vX.Y). + where, X.Y is IP version of USB controller.
Please document known IP versions.
+- reg: Should contain registers location and length +- interrupts: Should contain controller interrupt +- phy-names: from the *Generic PHY* bindings +- phys: from the *Generic PHY* bindings +- clocks: clock provider specifier +- clock-names: shall be "usb2-clock"
clock-names is kind of pointless for a single clock and '-clock' is redundant.
+Refer to clk/clock-bindings.txt for generic clock consumer properties
+
+Recommended properties:
+- dr_mode: One of "host" or "peripheral".
+- phy_type: the type of the phy connected to the core. Should be one
+ of "utmi", "utmi_wide", "ulpi", "serial" or "hsic". Without this
+ property the PORTSC register won't be touched
+
+Examples:
+usb at 8600000 {
+ compatible = "fsl,ci-qoriq-usb2",
+ "fsl,ci-qoriq-usb2-v2.5";Order should be most specific to least specific.
+ reg = <0x0 0x8600000 0x0 0x1000>; + interrupts = <0 139 0x4>; + phy-names = "usb2-phy"; + phys = <&usbphy0>; + clock-names = "usb2-clock"; + clocks = <&clockgen 4 3>; + dr_mode = "host"; + phy_type = "ulpi"; +}; -- 2.6.2.198.g614a2ac