Merge branch 'work.misc' of git://git.kernel.org/pub/scm/linux/kernel/git/viro/vfs
[linux-2.6-microblaze.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.
7   Use "cdns,sam9x60-macb" for Microchip sam9x60 SoC.
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 "atmel,sama5d2-gem" for the GEM IP (10/100) available on Atmel sama5d2 SoCs.
11   Use "atmel,sama5d3-macb" for the 10/100Mbit IP available on Atmel sama5d3 SoCs.
12   Use "atmel,sama5d3-gem" for the Gigabit IP available on Atmel sama5d3 SoCs.
13   Use "atmel,sama5d4-gem" for the GEM IP (10/100) available on Atmel sama5d4 SoCs.
14   Use "cdns,zynq-gem" Xilinx Zynq-7xxx SoC.
15   Use "cdns,zynqmp-gem" for Zynq Ultrascale+ MPSoC.
16   Use "sifive,fu540-c000-gem" for SiFive FU540-C000 SoC.
17   Use "microchip,sama7g5-emac" for Microchip SAMA7G5 ethernet interface.
18   Use "microchip,sama7g5-gem" for Microchip SAMA7G5 gigabit ethernet interface.
19   Or the generic form: "cdns,emac".
20 - reg: Address and length of the register set for the device
21         For "sifive,fu540-c000-gem", second range is required to specify the
22         address and length of the registers for GEMGXL Management block.
23 - interrupts: Should contain macb interrupt
24 - phy-mode: See ethernet.txt file in the same directory.
25 - clock-names: Tuple listing input clock names.
26         Required elements: 'pclk', 'hclk'
27         Optional elements: 'tx_clk'
28         Optional elements: 'rx_clk' applies to cdns,zynqmp-gem
29         Optional elements: 'tsu_clk'
30 - clocks: Phandles to input clocks.
31
32 The MAC address will be determined using the optional properties
33 defined in ethernet.txt.
34
35 Optional properties for PHY child node:
36 - reset-gpios : Should specify the gpio for phy reset
37 - magic-packet : If present, indicates that the hardware supports waking
38   up via magic packet.
39 - phy-handle : see ethernet.txt file in the same directory
40
41 Examples:
42
43         macb0: ethernet@fffc4000 {
44                 compatible = "cdns,at32ap7000-macb";
45                 reg = <0xfffc4000 0x4000>;
46                 interrupts = <21>;
47                 phy-mode = "rmii";
48                 local-mac-address = [3a 0e 03 04 05 06];
49                 clock-names = "pclk", "hclk", "tx_clk";
50                 clocks = <&clkc 30>, <&clkc 30>, <&clkc 13>;
51                 ethernet-phy@1 {
52                         reg = <0x1>;
53                         reset-gpios = <&pioE 6 1>;
54                 };
55         };