Documentation/devicetree/bindings/net/xilinx_axienet.txt

   1 XILINX AXI ETHERNET Device Tree Bindings
   2 --------------------------------------------------------
   3
   4 Also called  AXI 1G/2.5G Ethernet Subsystem, the xilinx axi ethernet IP core
   5 provides connectivity to an external ethernet PHY supporting different
   6 interfaces: MII, GMII, RGMII, SGMII, 1000BaseX. It also includes two
   7 segments of memory for buffering TX and RX, as well as the capability of
   8 offloading TX/RX checksum calculation off the processor.
   9
  10 Management configuration is done through the AXI interface, while payload is
  11 sent and received through means of an AXI DMA controller. This driver
  12 includes the DMA driver code, so this driver is incompatible with AXI DMA
  13 driver.
  14
  15 For more details about mdio please refer phy.txt file in the same directory.
  16
  17 Required 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
  33 Optional 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
  71 Example:
  72         axi_ethernet_eth: ethernet@40c00000 {
  73                 compatible = "xlnx,axi-ethernet-1.00.a";
  74                 device_type = "network";
  75                 interrupt-parent = <&microblaze_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         };