Merge tag 'drm-misc-next-fixes-2018-06-15' of git://anongit.freedesktop.org/drm/drm...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / sh_eth.txt
1 * Renesas Electronics SH EtherMAC
2
3 This file provides information on what the device node for the SH EtherMAC
4 interface contains.
5
6 Required properties:
7 - compatible: Must contain one or more of the following:
8               "renesas,gether-r8a7740" if the device is a part of R8A7740 SoC.
9               "renesas,ether-r8a7743"  if the device is a part of R8A7743 SoC.
10               "renesas,ether-r8a7745"  if the device is a part of R8A7745 SoC.
11               "renesas,ether-r8a7778"  if the device is a part of R8A7778 SoC.
12               "renesas,ether-r8a7779"  if the device is a part of R8A7779 SoC.
13               "renesas,ether-r8a7790"  if the device is a part of R8A7790 SoC.
14               "renesas,ether-r8a7791"  if the device is a part of R8A7791 SoC.
15               "renesas,ether-r8a7793"  if the device is a part of R8A7793 SoC.
16               "renesas,ether-r8a7794"  if the device is a part of R8A7794 SoC.
17               "renesas,gether-r8a77980" if the device is a part of R8A77980 SoC.
18               "renesas,ether-r7s72100" if the device is a part of R7S72100 SoC.
19               "renesas,rcar-gen1-ether" for a generic R-Car Gen1 device.
20               "renesas,rcar-gen2-ether" for a generic R-Car Gen2 or RZ/G1
21                                         device.
22
23               When compatible with the generic version, nodes must list
24               the SoC-specific version corresponding to the platform
25               first followed by the generic version.
26
27 - reg: offset and length of (1) the E-DMAC/feLic register block (required),
28        (2) the TSU register block (optional).
29 - interrupts: interrupt specifier for the sole interrupt.
30 - phy-mode: see ethernet.txt file in the same directory.
31 - phy-handle: see ethernet.txt file in the same directory.
32 - #address-cells: number of address cells for the MDIO bus, must be equal to 1.
33 - #size-cells: number of size cells on the MDIO bus, must be equal to 0.
34 - clocks: clock phandle and specifier pair.
35 - pinctrl-0: phandle, referring to a default pin configuration node.
36
37 Optional properties:
38 - interrupt-parent: the phandle for the interrupt controller that services
39                     interrupts for this device.
40 - pinctrl-names: pin configuration state name ("default").
41 - renesas,no-ether-link: boolean, specify when a board does not provide a proper
42                          Ether LINK signal.
43 - renesas,ether-link-active-low: boolean, specify when the Ether LINK signal is
44                                  active-low instead of normal active-high.
45
46 Example (Lager board):
47
48         ethernet@ee700000 {
49                 compatible = "renesas,ether-r8a7790",
50                              "renesas,rcar-gen2-ether";
51                 reg = <0 0xee700000 0 0x400>;
52                 interrupt-parent = <&gic>;
53                 interrupts = <0 162 IRQ_TYPE_LEVEL_HIGH>;
54                 clocks = <&mstp8_clks R8A7790_CLK_ETHER>;
55                 phy-mode = "rmii";
56                 phy-handle = <&phy1>;
57                 pinctrl-0 = <&ether_pins>;
58                 pinctrl-names = "default";
59                 renesas,ether-link-active-low;
60                 #address-cells = <1>;
61                 #size-cells = <0>;
62
63                 phy1: ethernet-phy@1 {
64                         reg = <1>;
65                         interrupt-parent = <&irqc0>;
66                         interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
67                         pinctrl-0 = <&phy1_pins>;
68                         pinctrl-names = "default";
69                 };
70         };