...
Table of Contents
| Table of Contents |
|---|
Introduction
This page gives an overview of the llfifo driver which is available as part of the Xilinx Vivado and SDK distribution.
The LogiCORE™ IP AXI4-Stream FIFO core allows memory mapped access to an AXI4-Stream interface.
The core can be used to interface to AXI Streaming IPs, Similar to the LogiCORE IP AXI Ethernet core,
Without having to use a full DMA solution. The principal operation of this core allows the write or read
Of data packets to or from a device without any concern over the AXI4-Stream interface signaling.
You can easily manage the AXI4-Stream interfaces as they are transparent.
How to enable
...
Driver Sources
The source code for the driver is included with the Vitis Unified Software Platform installation, as well as being available in the Xilinx Github repository.
Driver Name | Path in Vitis | Path in Github |
|---|---|---|
| llfifo | <Vitis Install Directory>/data/embedded/XilinxProcessorIPLib/drivers/llfifo | https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/llfifo |
| Info |
|---|
Note: To view the sources for a particular release, use the rel-version tag in github. For example, for the 2020.1 release, the proper version of the code is: https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/llfifo |
...
The driver source code is organized into different folders.
...
The table below shows the llfifo driver source organization.
...
| Directory |
|---|
...
| Description |
|---|
...
doc |
...
Provides the API and data structure details |
...
data |
...
Driver .tcl and |
...
.mdd file |
...
...
examples | Example applications that show how to use the driver |
...
features | |
| src | Driver source files |
Features Supported
Controller Features
- 32-bit AXI4-Lite slave interface
- Configurable data interface type (AXI4 or AXI4-Lite)
- Configurable data width of 32, 64, 128, 256 or 512 bits (AXI4 Data Interface only). For AXI4-Lite, the FIFO data width is 32 bits and for AXI4, it is identical to AXI4 data width.
- Configurable FIFO depth of 512 to 128k locations.
- Independently configurable internal TX and RX data FIFOs
- Full duplex operation
- Supports AXI Ethernet basic mode
- Provides interrupts for error and status conditions
- TX and RX cut-through mode
Standalone Driver Supported Features
...
Driver Implementation
For a full list of features supported by this IP, please refer TRM
Features
- Supports Configurable data interface types (AXI4 or AXI4-lite).
- Supports Configurable data widths
- Supports Configurable FIFO depth feature
- Supports TX and RX cut-through mode feature
- Supports Independent configuration of the Tx and Rx data FIFO's.
- Supports Full duplex operation.
...
Test cases
...
Known Issues and Limitations
- None
Example Applications
Refer to the driver examples directory for various example applications that exercise the different features of the driver. Each application is linked in the table below. The following sections describe the usage and expected output of the various applications. These example applications can be imported into the Vitis IDE from the Board Support Package settings tab.
Links to Examples
Examples Path:
https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/llfifo/examples
| Test Name | Example Source | Description |
|---|---|---|
| llfifo Polled mode example | This example is the polling example for the FIFO it assumes that at the h/w level FIFO is connected in Loopback. In these we write a known amount of data to the FIFO and Receive the data and compare with the data transmitted. | |
| llfifo Interrupt mode example |
...
| This example is the interrupt example for the FIFO it assumes that at the H/w level FIFO is connected in loopback. In these, we write a known amount of data to the FIFO and wait for interrupts and after Completely receiving the data compares it with the data transmitted. |
...
Example Application Usage
Trafgen Polled mode example
This example is the polling example for the FIFO it assumes that at the h/w level FIFO is connected in
Loopback. In these we write a known amount of data to the FIFO and Receive the data and compare with the data transmitted.
Known issues and Limitations
- All IP features are supported by the driver.
Change Log
- Consolidate debug header files.
- Support parallel make execution.
- Fix gcc warnings.
257c0d9e3742 BSP: Consolidate and add the drivers xdebug.h data to common xdebug.h
4dc85994d6fb Makefile: Remove realpath command
0504cc943db9 llfifo: Update Makefile for parallel make execution
a112290fda8a llfifo: Add type casting to fix gcc warnings
990f2cae1223 drivers: Fix makefiles issue for windows
- None
- None
- Fix poll and interrupt examples receive bug
- None
- None
- None
- None
...
- Fixed doxygen issues in the driver
- Updated comments in the usage section in the driver header file.
...
Expected Output
| Code Block |
|---|