Merge tag 'drm-intel-next-2019-03-20' of git://anongit.freedesktop.org/drm/drm-intel...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / phy / phy-rockchip-inno-usb2.txt
1 ROCKCHIP USB2.0 PHY WITH INNO IP BLOCK
2
3 Required properties (phy (parent) node):
4  - compatible : should be one of the listed compatibles:
5         * "rockchip,rk3228-usb2phy"
6         * "rockchip,rk3328-usb2phy"
7         * "rockchip,rk3366-usb2phy"
8         * "rockchip,rk3399-usb2phy"
9         * "rockchip,rv1108-usb2phy"
10  - reg : the address offset of grf for usb-phy configuration.
11  - #clock-cells : should be 0.
12  - clock-output-names : specify the 480m output clock name.
13
14 Optional properties:
15  - clocks : phandle + phy specifier pair, for the input clock of phy.
16  - clock-names : input clock name of phy, must be "phyclk".
17  - assigned-clocks : phandle of usb 480m clock.
18  - assigned-clock-parents : parent of usb 480m clock, select between
19                  usb-phy output 480m and xin24m.
20                  Refer to clk/clock-bindings.txt for generic clock
21                  consumer properties.
22  - rockchip,usbgrf : phandle to the syscon managing the "usb general
23                  register files". When set driver will request its
24                  phandle as one companion-grf for some special SoCs
25                  (e.g RV1108).
26  - extcon : phandle to the extcon device providing the cable state for
27                  the otg phy.
28
29 Required nodes : a sub-node is required for each port the phy provides.
30                  The sub-node name is used to identify host or otg port,
31                  and shall be the following entries:
32         * "otg-port" : the name of otg port.
33         * "host-port" : the name of host port.
34
35 Required properties (port (child) node):
36  - #phy-cells : must be 0. See ./phy-bindings.txt for details.
37  - interrupts : specify an interrupt for each entry in interrupt-names.
38  - interrupt-names : a list which should be one of the following cases:
39         Regular case:
40         * "otg-id" : for the otg id interrupt.
41         * "otg-bvalid" : for the otg vbus interrupt.
42         * "linestate" : for the host/otg linestate interrupt.
43         Some SoCs use one interrupt with the above muxed together, so for these
44         * "otg-mux" : otg-port interrupt, which mux otg-id/otg-bvalid/linestate
45                 to one.
46
47 Optional properties:
48  - phy-supply : phandle to a regulator that provides power to VBUS.
49                 See ./phy-bindings.txt for details.
50
51 Example:
52
53 grf: syscon@ff770000 {
54         compatible = "rockchip,rk3366-grf", "syscon", "simple-mfd";
55         #address-cells = <1>;
56         #size-cells = <1>;
57
58 ...
59
60         u2phy: usb2-phy@700 {
61                 compatible = "rockchip,rk3366-usb2phy";
62                 reg = <0x700 0x2c>;
63                 #clock-cells = <0>;
64                 clock-output-names = "sclk_otgphy0_480m";
65
66                 u2phy_otg: otg-port {
67                         #phy-cells = <0>;
68                         interrupts = <GIC_SPI 93 IRQ_TYPE_LEVEL_HIGH>,
69                                      <GIC_SPI 94 IRQ_TYPE_LEVEL_HIGH>,
70                                      <GIC_SPI 95 IRQ_TYPE_LEVEL_HIGH>;
71                         interrupt-names = "otg-id", "otg-bvalid", "linestate";
72                 };
73
74                 u2phy_host: host-port {
75                         #phy-cells = <0>;
76                         interrupts = <GIC_SPI 96 IRQ_TYPE_LEVEL_HIGH>;
77                         interrupt-names = "linestate";
78                 };
79         };
80 };