77 lines
3.3 KiB
Plaintext
77 lines
3.3 KiB
Plaintext
|
XILINX AXI ETHERNET Device Tree Bindings
|
||
|
|
--------------------------------------------------------
|
||
|
|
|
||
|
|
Also called AXI 1G/2.5G Ethernet Subsystem, the xilinx axi ethernet IP core
|
||
|
|
provides connectivity to an external ethernet PHY supporting different
|
||
|
|
interfaces: MII, GMII, RGMII, SGMII, 1000BaseX. It also includes two
|
||
|
|
segments of memory for buffering TX and RX, as well as the capability of
|
||
|
|
offloading TX/RX checksum calculation off the processor.
|
||
|
|
|
||
|
|
Management configuration is done through the AXI interface, while payload is
|
||
|
|
sent and received through means of an AXI DMA controller. This driver
|
||
|
|
includes the DMA driver code, so this driver is incompatible with AXI DMA
|
||
|
|
driver.
|
||
|
|
|
||
|
|
For more details about mdio please refer phy.txt file in the same directory.
|
||
|
|
|
||
|
|
Required properties:
|
||
|
|
- compatible : Must be one of "xlnx,axi-ethernet-1.00.a",
|
||
|
|
"xlnx,axi-ethernet-1.01.a", "xlnx,axi-ethernet-2.01.a"
|
||
|
|
- reg : Address and length of the IO space, as well as the address
|
||
|
|
and length of the AXI DMA controller IO space, unless
|
||
|
|
axistream-connected is specified, in which case the reg
|
||
|
|
attribute of the node referenced by it is used.
|
||
|
|
- interrupts : Should be a list of 2 or 3 interrupts: TX DMA, RX DMA,
|
||
|
|
and optionally Ethernet core. If axistream-connected is
|
||
|
|
specified, the TX/RX DMA interrupts should be on that node
|
||
|
|
instead, and only the Ethernet core interrupt is optionally
|
||
|
|
specified here.
|
||
|
|
- phy-handle : Should point to the external phy device.
|
||
|
|
See ethernet.txt file in the same directory.
|
||
|
|
- xlnx,rxmem : Set to allocated memory buffer for Rx/Tx in the hardware
|
||
|
|
|
||
|
|
Optional properties:
|
||
|
|
- phy-mode : See ethernet.txt
|
||
|
|
- xlnx,phy-type : Deprecated, do not use, but still accepted in preference
|
||
|
|
to phy-mode.
|
||
|
|
- xlnx,txcsum : 0 or empty for disabling TX checksum offload,
|
||
|
|
1 to enable partial TX checksum offload,
|
||
|
|
2 to enable full TX checksum offload
|
||
|
|
- xlnx,rxcsum : Same values as xlnx,txcsum but for RX checksum offload
|
||
|
|
- clocks : AXI bus clock for the device. Refer to common clock bindings.
|
||
|
|
Used to calculate MDIO clock divisor. If not specified, it is
|
||
|
|
auto-detected from the CPU clock (but only on platforms where
|
||
|
|
this is possible). New device trees should specify this - the
|
||
|
|
auto detection is only for backward compatibility.
|
||
|
|
- axistream-connected: Reference to another node which contains the resources
|
||
|
|
for the AXI DMA controller used by this device.
|
||
|
|
If this is specified, the DMA-related resources from that
|
||
|
|
device (DMA registers and DMA TX/RX interrupts) rather
|
||
|
|
than this one will be used.
|
||
|
|
- mdio : Child node for MDIO bus. Must be defined if PHY access is
|
||
|
|
required through the core's MDIO interface (i.e. always,
|
||
|
|
unless the PHY is accessed through a different bus).
|
||
|
|
|
||
|
|
Example:
|
||
|
|
axi_ethernet_eth: ethernet@40c00000 {
|
||
|
|
compatible = "xlnx,axi-ethernet-1.00.a";
|
||
|
|
device_type = "network";
|
||
|
|
interrupt-parent = <µblaze_0_axi_intc>;
|
||
|
|
interrupts = <2 0 1>;
|
||
|
|
clocks = <&axi_clk>;
|
||
|
|
phy-mode = "mii";
|
||
|
|
reg = <0x40c00000 0x40000 0x50c00000 0x40000>;
|
||
|
|
xlnx,rxcsum = <0x2>;
|
||
|
|
xlnx,rxmem = <0x800>;
|
||
|
|
xlnx,txcsum = <0x2>;
|
||
|
|
phy-handle = <&phy0>;
|
||
|
|
axi_ethernetlite_0_mdio: mdio {
|
||
|
|
#address-cells = <1>;
|
||
|
|
#size-cells = <0>;
|
||
|
|
phy0: phy@0 {
|
||
|
|
device_type = "ethernet-phy";
|
||
|
|
reg = <1>;
|
||
|
|
};
|
||
|
|
};
|
||
|
|
};
|