FROMLIST: Documentation: bindings: add DT documentation for Rockchip
authorFrank Wang <frank.wang@rock-chips.com>
Fri, 24 Jun 2016 02:55:49 +0000 (10:55 +0800)
committerGerrit Code Review <gerrit@rock-chips.com>
Wed, 29 Jun 2016 03:20:39 +0000 (11:20 +0800)
USB2PHY

Signed-off-by: Frank Wang <frank.wang@rock-chips.com>
Acked-by: Rob Herring <robh@kernel.org>
Reviewed-by: Heiko Stuebner <heiko@sntech.de>
(merge from https://patchwork.kernel.org/patch/9190285/)

Change-Id: I7199a4e84f13e58e98d5c0d21ce01837e961c3e8
Signed-off-by: Frank Wang <frank.wang@rock-chips.com>
Documentation/devicetree/bindings/phy/phy-rockchip-inno-usb2.txt

index 4e537b258f658161989f5c827ae151318343808e..3c29c77a7018da4e52b87920965d41013dbd9ef2 100644 (file)
@@ -1,21 +1,34 @@
 ROCKCHIP USB2.0 PHY WITH INNO IP BLOCK
 
 Required properties (phy (parent) node):
- - compatible: should contain:
+ - compatible : should be one of the listed compatibles:
        * "rockchip,rk3366-usb2phy"
- - #clock-cells: should be 0.
- - clock-names: specify the 480m output clk name.
+       * "rockchip,rk3399-usb2phy"
+ - reg : the address offset of grf for usb-phy configuration.
+ - #clock-cells : should be 0.
+ - clock-output-names : specify the 480m output clock name.
 
 Optional properties:
- - vbus_host-gpio: pull gpio high/low to control the host vbus power.
+ - clocks : phandle + phy specifier pair, for the input clock of phy.
+ - clock-names : input clock name of phy, must be "phyclk".
 
-Required nodes: a sub-node is required for each port the phy provides.
-               The sub-node name is used to identify host or otg port.
+Required nodes : a sub-node is required for each port the phy provides.
+                The sub-node name is used to identify host or otg port,
+                and shall be the following entries:
+       * "otg-port" : the name of otg port.
+       * "host-port" : the name of host port.
 
 Required properties (port (child) node):
- - #phy-cells: must be 0. See ./phy-bindings.txt for details.
- - interrupts: irq number for host/otg port.
- - interrupt-names: interrupt name, in line with irq number.
+ - #phy-cells : must be 0. See ./phy-bindings.txt for details.
+ - interrupts : specify an interrupt for each entry in interrupt-names.
+ - interrupt-names : a list which shall be the following entries:
+       * "otg-id" : for the otg id interrupt.
+       * "otg-bvalid" : for the otg vbus interrupt.
+       * "linestate" : for the host/otg linestate interrupt.
+
+Optional properties:
+ - phy-supply : phandle to a regulator that provides power to VBUS.
+               See ./phy-bindings.txt for details.
 
 Example:
 
@@ -26,15 +39,18 @@ grf: syscon@ff770000 {
 
 ...
 
-       u2phy: usb2-phy {
+       u2phy: usb2-phy@700 {
                compatible = "rockchip,rk3366-usb2phy";
+               reg = <0x700 0x2c>;
                #clock-cells = <0>;
                clock-output-names = "sclk_otgphy0_480m";
 
                u2phy_otg: otg-port {
                        #phy-cells = <0>;
-                       interrupts = <GIC_SPI 95 IRQ_TYPE_LEVEL_HIGH>;
-                       interrupt-names = "linestate";
+                       interrupts = <GIC_SPI 93 IRQ_TYPE_LEVEL_HIGH>,
+                                    <GIC_SPI 94 IRQ_TYPE_LEVEL_HIGH>,
+                                    <GIC_SPI 95 IRQ_TYPE_LEVEL_HIGH>;
+                       interrupt-names = "otg-id", "otg-bvalid", "linestate";
                        status = "okay";
                };