xref: /freebsd/sys/contrib/device-tree/Bindings/net/macb.txt (revision 29332c0dcee1e80c9fb871e06c3160bd5deb1b44)
1* Cadence MACB/GEM Ethernet controller
2
3Required 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
32The MAC address will be determined using the optional properties
33defined in ethernet.txt.
34
35Optional 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
41Examples:
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	};
56