Merge tag 'v4.17-rc2' into next-general
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / net / macb.txt
1 * Cadence MACB/GEM Ethernet controller
2
3 Required properties:
4 - compatible: Should be "cdns,[<chip>-]{macb|gem}"
5   Use "cdns,at91rm9200-emac" Atmel at91rm9200 SoC.
6   Use "cdns,at91sam9260-macb" for Atmel at91sam9 SoCs or the 10/100Mbit IP
7   available on sama5d3 SoCs.
8   Use "cdns,np4-macb" for NP4 SoC devices.
9   Use "cdns,at32ap7000-macb" for other 10/100 usage or use the generic form: "cdns,macb".
10   Use "cdns,pc302-gem" for Picochip picoXcell pc302 and later devices based on
11   the Cadence GEM, or the generic form: "cdns,gem".
12   Use "atmel,sama5d2-gem" for the GEM IP (10/100) available on Atmel sama5d2 SoCs.
13   Use "atmel,sama5d3-gem" for the Gigabit IP available on Atmel sama5d3 SoCs.
14   Use "atmel,sama5d4-gem" for the GEM IP (10/100) available on Atmel sama5d4 SoCs.
15   Use "cdns,zynq-gem" Xilinx Zynq-7xxx SoC.
16   Use "cdns,zynqmp-gem" for Zynq Ultrascale+ MPSoC.
17   Or the generic form: "cdns,emac".
18 - reg: Address and length of the register set for the device
19 - interrupts: Should contain macb interrupt
20 - phy-mode: See ethernet.txt file in the same directory.
21 - clock-names: Tuple listing input clock names.
22         Required elements: 'pclk', 'hclk'
23         Optional elements: 'tx_clk'
24         Optional elements: 'rx_clk' applies to cdns,zynqmp-gem
25         Optional elements: 'tsu_clk'
26 - clocks: Phandles to input clocks.
27
28 Optional properties for PHY child node:
29 - reset-gpios : Should specify the gpio for phy reset
30 - magic-packet : If present, indicates that the hardware supports waking
31   up via magic packet.
32 - phy-handle : see ethernet.txt file in the same directory
33
34 Examples:
35
36         macb0: ethernet@fffc4000 {
37                 compatible = "cdns,at32ap7000-macb";
38                 reg = <0xfffc4000 0x4000>;
39                 interrupts = <21>;
40                 phy-mode = "rmii";
41                 local-mac-address = [3a 0e 03 04 05 06];
42                 clock-names = "pclk", "hclk", "tx_clk";
43                 clocks = <&clkc 30>, <&clkc 30>, <&clkc 13>;
44                 ethernet-phy@1 {
45                         reg = <0x1>;
46                         reset-gpios = <&pioE 6 1>;
47                 };
48         };