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