Merge tag 'driver-core-5.5-rc1' of git://git.kernel.org/pub/scm/linux/kernel/git...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / phy / rcar-gen3-phy-usb2.txt
1 * Renesas R-Car generation 3 USB 2.0 PHY
2
3 This file provides information on what the device node for the R-Car generation
4 3, RZ/G1C, RZ/G2 and RZ/A2 USB 2.0 PHY contain.
5
6 Required properties:
7 - compatible: "renesas,usb2-phy-r7s9210" if the device is a part of an R7S9210
8               SoC.
9               "renesas,usb2-phy-r8a77470" if the device is a part of an R8A77470
10               SoC.
11               "renesas,usb2-phy-r8a774a1" if the device is a part of an R8A774A1
12               SoC.
13               "renesas,usb2-phy-r8a774b1" if the device is a part of an R8A774B1
14               SoC.
15               "renesas,usb2-phy-r8a774c0" if the device is a part of an R8A774C0
16               SoC.
17               "renesas,usb2-phy-r8a7795" if the device is a part of an R8A7795
18               SoC.
19               "renesas,usb2-phy-r8a7796" if the device is a part of an R8A7796
20               SoC.
21               "renesas,usb2-phy-r8a77965" if the device is a part of an
22               R8A77965 SoC.
23               "renesas,usb2-phy-r8a77990" if the device is a part of an
24               R8A77990 SoC.
25               "renesas,usb2-phy-r8a77995" if the device is a part of an
26               R8A77995 SoC.
27               "renesas,rcar-gen3-usb2-phy" for a generic R-Car Gen3, RZ/G2 or
28               RZ/A2 compatible device.
29
30               When compatible with the generic version, nodes must list the
31               SoC-specific version corresponding to the platform first
32               followed by the generic version.
33
34 - reg: offset and length of the partial USB 2.0 Host register block.
35 - clocks: clock phandle and specifier pair(s).
36 - #phy-cells: see phy-bindings.txt in the same directory, must be <1> (and
37               using <0> is deprecated).
38
39 The phandle's argument in the PHY specifier is the INT_STATUS bit of controller:
40 - 1 = USBH_INTA (OHCI)
41 - 2 = USBH_INTB (EHCI)
42 - 3 = UCOM_INT (OTG and BC)
43
44 Optional properties:
45 To use a USB channel where USB 2.0 Host and HSUSB (USB 2.0 Peripheral) are
46 combined, the device tree node should set interrupt properties to use the
47 channel as USB OTG:
48 - interrupts: interrupt specifier for the PHY.
49 - vbus-supply: Phandle to a regulator that provides power to the VBUS. This
50                regulator will be managed during the PHY power on/off sequence.
51 - renesas,no-otg-pins: boolean, specify when a board does not provide proper
52                        otg pins.
53 - dr_mode: string, indicates the working mode for the PHY. Can be "host",
54            "peripheral", or "otg". Should be set if otg controller is not used.
55
56
57 Example (R-Car H3):
58
59         usb-phy@ee080200 {
60                 compatible = "renesas,usb2-phy-r8a7795", "renesas,rcar-gen3-usb2-phy";
61                 reg = <0 0xee080200 0 0x700>;
62                 interrupts = <GIC_SPI 108 IRQ_TYPE_LEVEL_HIGH>;
63                 clocks = <&cpg CPG_MOD 703>;
64         };
65
66         usb-phy@ee0a0200 {
67                 compatible = "renesas,usb2-phy-r8a7795", "renesas,rcar-gen3-usb2-phy";
68                 reg = <0 0xee0a0200 0 0x700>;
69                 clocks = <&cpg CPG_MOD 702>;
70         };