xref: /freebsd/sys/contrib/device-tree/Bindings/net/macb.txt (revision b197d4b893974c9eb4d7b38704c6d5c486235d6f)
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
33Optional properties:
34- mdio: node containing PHY children. If this node is not present, then PHYs
35        will be direct children.
36
37The MAC address will be determined using the optional properties
38defined in ethernet.txt.
39
40Optional properties for PHY child node:
41- reset-gpios : Should specify the gpio for phy reset
42- magic-packet : If present, indicates that the hardware supports waking
43  up via magic packet.
44- phy-handle : see ethernet.txt file in the same directory
45
46Examples:
47
48	macb0: ethernet@fffc4000 {
49		compatible = "cdns,at32ap7000-macb";
50		reg = <0xfffc4000 0x4000>;
51		interrupts = <21>;
52		phy-mode = "rmii";
53		local-mac-address = [3a 0e 03 04 05 06];
54		clock-names = "pclk", "hclk", "tx_clk";
55		clocks = <&clkc 30>, <&clkc 30>, <&clkc 13>;
56		ethernet-phy@1 {
57			reg = <0x1>;
58			reset-gpios = <&pioE 6 1>;
59		};
60	};
61