GNU Linux-libre 4.14.266-gnu1
[releases.git] / Documentation / devicetree / bindings / phy / rcar-gen2-phy.txt
1 * Renesas R-Car generation 2 USB PHY
2
3 This file provides information on what the device node for the R-Car generation
4 2 USB PHY contains.
5
6 Required properties:
7 - compatible: "renesas,usb-phy-r8a7790" if the device is a part of R8A7790 SoC.
8               "renesas,usb-phy-r8a7791" if the device is a part of R8A7791 SoC.
9               "renesas,usb-phy-r8a7794" if the device is a part of R8A7794 SoC.
10               "renesas,rcar-gen2-usb-phy" for a generic R-Car Gen2 compatible device.
11
12               When compatible with the generic version, nodes must list the
13               SoC-specific version corresponding to the platform first
14               followed by the generic version.
15
16 - reg: offset and length of the register block.
17 - #address-cells: number of address cells for the USB channel subnodes, must
18                   be <1>.
19 - #size-cells: number of size cells for the USB channel subnodes, must be <0>.
20 - clocks: clock phandle and specifier pair.
21 - clock-names: string, clock input name, must be "usbhs".
22
23 The USB PHY device tree node should have the subnodes corresponding to the USB
24 channels. These subnodes must contain the following properties:
25 - reg: the USB controller selector; see the table below for the values.
26 - #phy-cells: see phy-bindings.txt in the same directory, must be <1>.
27
28 The phandle's argument in the PHY specifier is the USB controller selector for
29 the USB channel; see the selector meanings below:
30
31 +-----------+---------------+---------------+
32 |\ Selector |               |               |
33 + --------- +       0       |       1       |
34 | Channel  \|               |               |
35 +-----------+---------------+---------------+
36 | 0         | PCI EHCI/OHCI | HS-USB        |
37 | 2         | PCI EHCI/OHCI | xHCI          |
38 +-----------+---------------+---------------+
39
40 Example (Lager board):
41
42         usb-phy@e6590100 {
43                 compatible = "renesas,usb-phy-r8a7790", "renesas,rcar-gen2-usb-phy";
44                 reg = <0 0xe6590100 0 0x100>;
45                 #address-cells = <1>;
46                 #size-cells = <0>;
47                 clocks = <&mstp7_clks R8A7790_CLK_HSUSB>;
48                 clock-names = "usbhs";
49
50                 usb-channel@0 {
51                         reg = <0>;
52                         #phy-cells = <1>;
53                 };
54                 usb-channel@2 {
55                         reg = <2>;
56                         #phy-cells = <1>;
57                 };
58         };