1XILINX AXI ETHERNET Device Tree Bindings 2-------------------------------------------------------- 3 4Also called AXI 1G/2.5G Ethernet Subsystem, the xilinx axi ethernet IP core 5provides connectivity to an external ethernet PHY supporting different 6interfaces: MII, GMII, RGMII, SGMII, 1000BaseX. It also includes two 7segments of memory for buffering TX and RX, as well as the capability of 8offloading TX/RX checksum calculation off the processor. 9 10Management configuration is done through the AXI interface, while payload is 11sent and received through means of an AXI DMA controller. This driver 12includes the DMA driver code, so this driver is incompatible with AXI DMA 13driver. 14 15For more details about mdio please refer phy.txt file in the same directory. 16 17Required properties: 18- compatible : Must be one of "xlnx,axi-ethernet-1.00.a", 19 "xlnx,axi-ethernet-1.01.a", "xlnx,axi-ethernet-2.01.a" 20- reg : Address and length of the IO space, as well as the address 21 and length of the AXI DMA controller IO space, unless 22 axistream-connected is specified, in which case the reg 23 attribute of the node referenced by it is used. 24- interrupts : Should be a list of 2 or 3 interrupts: TX DMA, RX DMA, 25 and optionally Ethernet core. If axistream-connected is 26 specified, the TX/RX DMA interrupts should be on that node 27 instead, and only the Ethernet core interrupt is optionally 28 specified here. 29- phy-handle : Should point to the external phy device. 30 See ethernet.txt file in the same directory. 31- xlnx,rxmem : Set to allocated memory buffer for Rx/Tx in the hardware 32 33Optional properties: 34- phy-mode : See ethernet.txt 35- xlnx,phy-type : Deprecated, do not use, but still accepted in preference 36 to phy-mode. 37- xlnx,txcsum : 0 or empty for disabling TX checksum offload, 38 1 to enable partial TX checksum offload, 39 2 to enable full TX checksum offload 40- xlnx,rxcsum : Same values as xlnx,txcsum but for RX checksum offload 41- xlnx,switch-x-sgmii : Boolean to indicate the Ethernet core is configured to 42 support both 1000BaseX and SGMII modes. If set, the phy-mode 43 should be set to match the mode selected on core reset (i.e. 44 by the basex_or_sgmii core input line). 45- clock-names: Tuple listing input clock names. Possible clocks: 46 s_axi_lite_clk: Clock for AXI register slave interface 47 axis_clk: AXI4-Stream clock for TXD RXD TXC and RXS interfaces 48 ref_clk: Ethernet reference clock, used by signal delay 49 primitives and transceivers 50 mgt_clk: MGT reference clock (used by optional internal 51 PCS/PMA PHY) 52 53 Note that if s_axi_lite_clk is not specified by name, the 54 first clock of any name is used for this. If that is also not 55 specified, the clock rate is auto-detected from the CPU clock 56 (but only on platforms where this is possible). New device 57 trees should specify all applicable clocks by name - the 58 fallbacks to an unnamed clock or to CPU clock are only for 59 backward compatibility. 60- clocks: Phandles to input clocks matching clock-names. Refer to common 61 clock bindings. 62- axistream-connected: Reference to another node which contains the resources 63 for the AXI DMA controller used by this device. 64 If this is specified, the DMA-related resources from that 65 device (DMA registers and DMA TX/RX interrupts) rather 66 than this one will be used. 67 - mdio : Child node for MDIO bus. Must be defined if PHY access is 68 required through the core's MDIO interface (i.e. always, 69 unless the PHY is accessed through a different bus). 70 71Example: 72 axi_ethernet_eth: ethernet@40c00000 { 73 compatible = "xlnx,axi-ethernet-1.00.a"; 74 device_type = "network"; 75 interrupt-parent = <µblaze_0_axi_intc>; 76 interrupts = <2 0 1>; 77 clock-names = "s_axi_lite_clk", "axis_clk", "ref_clk", "mgt_clk"; 78 clocks = <&axi_clk>, <&axi_clk>, <&pl_enet_ref_clk>, <&mgt_clk>; 79 phy-mode = "mii"; 80 reg = <0x40c00000 0x40000 0x50c00000 0x40000>; 81 xlnx,rxcsum = <0x2>; 82 xlnx,rxmem = <0x800>; 83 xlnx,txcsum = <0x2>; 84 phy-handle = <&phy0>; 85 axi_ethernetlite_0_mdio: mdio { 86 #address-cells = <1>; 87 #size-cells = <0>; 88 phy0: phy@0 { 89 device_type = "ethernet-phy"; 90 reg = <1>; 91 }; 92 }; 93 }; 94