AXI Ethernet Standalone Driver

Table of Contents

Introduction

This page gives an overview of axi ethernet driver which is available as part of the Xilinx Vivado and SDK distribution. The Xilinx® AXI Ethernet Subsystem implements a tri-mode (10/100/1000 Mb/s) Ethernet MAC or a 10/100 Mb/s Ethernet MAC. This core supports the use of MII, GMII, SGMII, RGMII, and 1000BASE-X interfaces to connect a media access control (MAC) to a Physical-side interface (PHY) chip. It also provides an on-chip PHY for 1G/2.5G SGMII and 1000/2500 BASE-X modes. The MDIO interface is used to access PHY Management registers. This subsystem optionally enables TCP/UDP full checksum Offload, VLAN stripping, tagging, translation and extended filtering for multicast frames features.

How to enable

Source Path for the driver
https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/axiethernet

Driver source code is organized into different folders. Below diagram shows the axiethernet driver source organization
axiethernet
|
- doc - Provides the API and data structure details
- data - Driver tcl and MDD file.
|
- examples - Reference application to show how to use the driver APIs and calling sequence
|
- src- Driver source files

Features Supported

Controller Features

Standalone Driver Supported Features

The AXI Ethernet Standalone driver supports the below things.

Features not supported


Interop

- PHY device Marvell 88E1116 has been tested on KC705 evaluation board
- PHY device TI DP83867 SGMII have been tested on VCU118 board.

Test cases

Axi Ethernet DMA Example
Axi Ethernet basic AXI DMA loopback example can be tested by selecting xaxiethernet_example_intr_sgdma.c, xaxiethernet_example_util.c and xaxiethernet_example.h from the driver.
Refer to https://github.com/Xilinx/embeddedsw/blob/master/XilinxProcessorIPLib/drivers/axiethernet/examples/readme.txt for more information.

Axi Ethernet FIFO Example
Axi Ethernet basic AXI FIFO loopback example can be tested by selecting xaxiethernet_example_intr_fifo.c, xaxiethernet_example_util.c and xaxiethernet_example.h from the driver.
Refer to https://github.com/Xilinx/embeddedsw/blob/master/XilinxProcessorIPLib/drivers/axiethernet/examples/readme.txt for more information.

Known Issues/Limitations

Changelog

2020.2

257c0d9e3742 BSP: Consolidate and add the drivers xdebug.h data to common xdebug.h
4dc85994d6fb Makefile: Remove realpath command
ad4739446424 axiethernet: Modify makefile to support parallel make execution
14a8bb9f1bc8 axiethernet: Add support for versal silicon
300a9c894a55 axiethernet: Fix bsp generation error in a custom design

2020.1

500b39a axiethernet: Clean up old versions for axiethernet driver
5191a3a axiethernet: In debug mode fix return value of XAxiEthernet_ReadReg
14eefd8 axiethernet: In driver tcl use "::hsi::utils::get_connected_intf" API
acf82d5 axiethernet: Removed the assert condition for speed.

2019.2

2019.1

Commit ID's

db36090 axiethernet: Use an identifiable suffix for global variables

2018.3

c676978 Fix error 'committing RxBD to HW' in SG dma interrupt example
3e6fd05 Fix interrupt ID generation for ZynqMP designs
fc025e0 Improve error message for non-supported HW designs
6b2c516 examples: Fix gcc [-Wint-conversion] warning
9711443 Include missing initializers for 'XAxiEthernet_Config' fields
2d15ad1 Fix cppcheck warnings

2018.2
2018.1
4ea9f9d axiethernet: Fix compilation issues in multicast/extvlan example
5fa4d74 Set num of multicast table entries parameter based on hw design
abe45ad axiethernet: Use table entries count from config structure
ee523e1 axiethernet: Used UINTPTR type for DMA BaseAddress
1866fc8 Axiethernet: Implementing poll timeout API in the axiethernet driver
2017.4:
2017.3
Commit ID's
60104ac : axiethernet: Add support for mcdma
2ad67e6 : axiethernet: Add axiethernet mcdma examples
14c3ca9 : axiethernet: Fix issues with the chipscope designs
2e47d70 : axiethernet: Fix pmufw compilation errors
2017.2
Commit ID
ef2ffba: Increase timeout values
2017.1
Commit ID
a523a1d : Add Support for TI PHY in the peripheral test

Related Links