Merge branch 'drm-fixes-4.19' of git://people.freedesktop.org/~agd5f/linux into 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 - pinctrl-names: pin configuration state name ("default").
39 - renesas,no-ether-link: boolean, specify when a board does not provide a proper
40                          Ether LINK signal.
41 - renesas,ether-link-active-low: boolean, specify when the Ether LINK signal is
42                                  active-low instead of normal active-high.
43
44 Example (Lager board):
45
46         ethernet@ee700000 {
47                 compatible = "renesas,ether-r8a7790",
48                              "renesas,rcar-gen2-ether";
49                 reg = <0 0xee700000 0 0x400>;
50                 interrupt-parent = <&gic>;
51                 interrupts = <0 162 IRQ_TYPE_LEVEL_HIGH>;
52                 clocks = <&mstp8_clks R8A7790_CLK_ETHER>;
53                 phy-mode = "rmii";
54                 phy-handle = <&phy1>;
55                 pinctrl-0 = <&ether_pins>;
56                 pinctrl-names = "default";
57                 renesas,ether-link-active-low;
58                 #address-cells = <1>;
59                 #size-cells = <0>;
60
61                 phy1: ethernet-phy@1 {
62                         reg = <1>;
63                         interrupt-parent = <&irqc0>;
64                         interrupts = <0 IRQ_TYPE_LEVEL_LOW>;
65                         pinctrl-0 = <&phy1_pins>;
66                         pinctrl-names = "default";
67                 };
68         };