treewide: remove redundant IS_ERR() before error code check
[linux/fpc-iii.git] / Documentation / devicetree / bindings / net / renesas,ravb.txt
blob87dad2dd8ca0cd6c9439bd28e69e4e0327db65c0
1 * Renesas Electronics Ethernet AVB
3 This file provides information on what the device node for the Ethernet AVB
4 interface contains.
6 Required properties:
7 - compatible: Must contain one or more of the following:
8       - "renesas,etheravb-r8a7743" for the R8A7743 SoC.
9       - "renesas,etheravb-r8a7744" for the R8A7744 SoC.
10       - "renesas,etheravb-r8a7745" for the R8A7745 SoC.
11       - "renesas,etheravb-r8a77470" for the R8A77470 SoC.
12       - "renesas,etheravb-r8a7790" for the R8A7790 SoC.
13       - "renesas,etheravb-r8a7791" for the R8A7791 SoC.
14       - "renesas,etheravb-r8a7792" for the R8A7792 SoC.
15       - "renesas,etheravb-r8a7793" for the R8A7793 SoC.
16       - "renesas,etheravb-r8a7794" for the R8A7794 SoC.
17       - "renesas,etheravb-rcar-gen2" as a fallback for the above
18                 R-Car Gen2 and RZ/G1 devices.
20       - "renesas,etheravb-r8a774a1" for the R8A774A1 SoC.
21       - "renesas,etheravb-r8a774b1" for the R8A774B1 SoC.
22       - "renesas,etheravb-r8a774c0" for the R8A774C0 SoC.
23       - "renesas,etheravb-r8a7795" for the R8A7795 SoC.
24       - "renesas,etheravb-r8a7796" for the R8A77960 SoC.
25       - "renesas,etheravb-r8a77961" for the R8A77961 SoC.
26       - "renesas,etheravb-r8a77965" for the R8A77965 SoC.
27       - "renesas,etheravb-r8a77970" for the R8A77970 SoC.
28       - "renesas,etheravb-r8a77980" for the R8A77980 SoC.
29       - "renesas,etheravb-r8a77990" for the R8A77990 SoC.
30       - "renesas,etheravb-r8a77995" for the R8A77995 SoC.
31       - "renesas,etheravb-rcar-gen3" as a fallback for the above
32                 R-Car Gen3 and RZ/G2 devices.
34         When compatible with the generic version, nodes must list the
35         SoC-specific version corresponding to the platform first followed by
36         the generic version.
38 - reg: Offset and length of (1) the register block and (2) the stream buffer.
39        The region for the register block is mandatory.
40        The region for the stream buffer is optional, as it is only present on
41        R-Car Gen2 and RZ/G1 SoCs, and on R-Car H3 (R8A7795), M3-W (R8A77960),
42        M3-W+ (R8A77961), and M3-N (R8A77965).
43 - interrupts: A list of interrupt-specifiers, one for each entry in
44               interrupt-names.
45               If interrupt-names is not present, an interrupt specifier
46               for a single muxed interrupt.
47 - phy-mode: see ethernet.txt file in the same directory.
48 - phy-handle: see ethernet.txt file in the same directory.
49 - #address-cells: number of address cells for the MDIO bus, must be equal to 1.
50 - #size-cells: number of size cells on the MDIO bus, must be equal to 0.
51 - clocks: clock phandle and specifier pair.
52 - pinctrl-0: phandle, referring to a default pin configuration node.
54 Optional properties:
55 - interrupt-names: A list of interrupt names.
56                    For the R-Car Gen 3 SoCs this property is mandatory;
57                    it should include one entry per channel, named "ch%u",
58                    where %u is the channel number ranging from 0 to 24.
59                    For other SoCs this property is optional; if present
60                    it should contain "mux" for a single muxed interrupt.
61 - pinctrl-names: pin configuration state name ("default").
62 - renesas,no-ether-link: boolean, specify when a board does not provide a proper
63                          AVB_LINK signal.
64 - renesas,ether-link-active-low: boolean, specify when the AVB_LINK signal is
65                                  active-low instead of normal active-high.
67 Example:
69         ethernet@e6800000 {
70                 compatible = "renesas,etheravb-r8a7795", "renesas,etheravb-rcar-gen3";
71                 reg = <0 0xe6800000 0 0x800>, <0 0xe6a00000 0 0x10000>;
72                 interrupt-parent = <&gic>;
73                 interrupts = <GIC_SPI 39 IRQ_TYPE_LEVEL_HIGH>,
74                              <GIC_SPI 40 IRQ_TYPE_LEVEL_HIGH>,
75                              <GIC_SPI 41 IRQ_TYPE_LEVEL_HIGH>,
76                              <GIC_SPI 42 IRQ_TYPE_LEVEL_HIGH>,
77                              <GIC_SPI 43 IRQ_TYPE_LEVEL_HIGH>,
78                              <GIC_SPI 44 IRQ_TYPE_LEVEL_HIGH>,
79                              <GIC_SPI 45 IRQ_TYPE_LEVEL_HIGH>,
80                              <GIC_SPI 46 IRQ_TYPE_LEVEL_HIGH>,
81                              <GIC_SPI 47 IRQ_TYPE_LEVEL_HIGH>,
82                              <GIC_SPI 48 IRQ_TYPE_LEVEL_HIGH>,
83                              <GIC_SPI 49 IRQ_TYPE_LEVEL_HIGH>,
84                              <GIC_SPI 50 IRQ_TYPE_LEVEL_HIGH>,
85                              <GIC_SPI 51 IRQ_TYPE_LEVEL_HIGH>,
86                              <GIC_SPI 52 IRQ_TYPE_LEVEL_HIGH>,
87                              <GIC_SPI 53 IRQ_TYPE_LEVEL_HIGH>,
88                              <GIC_SPI 54 IRQ_TYPE_LEVEL_HIGH>,
89                              <GIC_SPI 55 IRQ_TYPE_LEVEL_HIGH>,
90                              <GIC_SPI 56 IRQ_TYPE_LEVEL_HIGH>,
91                              <GIC_SPI 57 IRQ_TYPE_LEVEL_HIGH>,
92                              <GIC_SPI 58 IRQ_TYPE_LEVEL_HIGH>,
93                              <GIC_SPI 59 IRQ_TYPE_LEVEL_HIGH>,
94                              <GIC_SPI 60 IRQ_TYPE_LEVEL_HIGH>,
95                              <GIC_SPI 61 IRQ_TYPE_LEVEL_HIGH>,
96                              <GIC_SPI 62 IRQ_TYPE_LEVEL_HIGH>,
97                              <GIC_SPI 63 IRQ_TYPE_LEVEL_HIGH>;
98                 interrupt-names = "ch0", "ch1", "ch2", "ch3",
99                                   "ch4", "ch5", "ch6", "ch7",
100                                   "ch8", "ch9", "ch10", "ch11",
101                                   "ch12", "ch13", "ch14", "ch15",
102                                   "ch16", "ch17", "ch18", "ch19",
103                                   "ch20", "ch21", "ch22", "ch23",
104                                   "ch24";
105                 clocks = <&cpg CPG_MOD 812>;
106                 power-domains = <&cpg>;
107                 phy-mode = "rgmii-id";
108                 phy-handle = <&phy0>;
110                 pinctrl-0 = <&ether_pins>;
111                 pinctrl-names = "default";
112                 renesas,no-ether-link;
113                 #address-cells = <1>;
114                 #size-cells = <0>;
116                 phy0: ethernet-phy@0 {
117                         rxc-skew-ps = <900>;
118                         rxdv-skew-ps = <0>;
119                         rxd0-skew-ps = <0>;
120                         rxd1-skew-ps = <0>;
121                         rxd2-skew-ps = <0>;
122                         rxd3-skew-ps = <0>;
123                         txc-skew-ps = <900>;
124                         txen-skew-ps = <0>;
125                         txd0-skew-ps = <0>;
126                         txd1-skew-ps = <0>;
127                         txd2-skew-ps = <0>;
128                         txd3-skew-ps = <0>;
129                         reg = <0>;
130                         interrupt-parent = <&gpio2>;
131                         interrupts = <11 IRQ_TYPE_LEVEL_LOW>;
132                 };
133         };