Util AXIS FIFO

Overview

The purpose of this testbench is to validate the FIFO functionality of the library/util_axis_fifo IP core.

The entire HDL documentation can be found here.

Block design

The block design is based on the test harness with the Util AXIS FIFO IP and other auxiliary modules. For the util_axis_fifo IP testing, the auxiliary modules are a master and a slave AXI4 Stream VIP. The AXIS VIP is used to generate data for the DUT IP. The util_axis_fifo IP stores the data and then sends it to the slave AXIS VIP for verification.

Block diagram

Util_AXIS_FIFO/Testbench block diagram

Configuration parameters and modes

The following parameters of this project that can be configured:

  • ASYNC_CLK: defines the input and output clock relationship Options: 0 for Synchronous or 1 for Asynchronous

  • TKEEP_EN: enable tkeep signals

  • TLAST_EN: enable tlast signal

  • DATA_WIDTH: data width Options: Power of 2, min 8, max 1024

  • ADDRESS_WIDTH: address width Options: 0 to 4

  • INPUT_CLK: input clock period in ns Options: 1 to 9

  • OUTPUT_CLK: output clock period in ns Options: 1 to 9

Configuration files

The following configuration files are available:

Parameter

cfg_rand

ASYNC_CLK

random

TKEEP_EN

random

TLAST_EN

random

DATA_WIDTH

random

ADDRESS_WIDTH

random

INPUT_CLK

random

OUTPUT_CLK

random

Tests

The following test program file is available:

Test program

Usage

test_program

Tests the FIFO module.

Available configurations & tests combinations

The test program is compatible with the above-mentioned configuration.

Test stimulus

The test program is responsible for verifying the FIFO in different configurations.

Environment Bringup

The steps of the environment bringup are:

  • Create the environment

  • Start the environment

  • Start the clocks

  • Assert the resets

FIFO testing

  • Configure and start the sequencers

  • Configure and start the watchdog

  • Sends some randomized data and verify all

  • Wait for scoreboard to complete checking

Stop the environment

  • Stop the watchdog

  • Stop the clocks

Building the test bench

The testbench is built upon ADI’s generic HDL reference design framework. ADI does not distribute compiled files of these projects so they must be built from the sources available here and here, with the specified hierarchy described Set up the Testbenches repository. To get the source you must clone the HDL repository, and then build the project as follows:

Linux/Cygwin/WSL

Example 1

Building and simulating the testbench using only the command line.

user@analog:~$
cd testbenches/ip/util_axis_fifo
user@analog:~/testbenches/ip/util_axis_fifo$
make

Example 2

Building and simulating the testbench using the Vivado GUI. This command will launch Vivado, will run the simulation and display the waveforms.

user@analog:~$
cd testbenches/ip/util_axis_fifo
user@analog:~/testbenches/ip/util_axis_fifo$
make MODE=gui

Example 3

Build a particular combination of test and configuration, using the Vivado GUI. This command will launch Vivado, will run the simulation and display the waveforms.

user@analog:~$
cd testbenches/ip/util_axis_fifo
user@analog:~/testbenches/ip/util_axis_fifo$
make MODE=gui CFG=cfg_rand TST=test_program

The built project can be found in the runs folder, where each configuration specific build has its own folder named after the configuration file’s name. Example: if the following command was run for a single configuration in the clean folder (no runs folder available):

make CFG=cfg_rand

Then the subfolder under runs name will be:

cfg_rand

Resources

More information

Support

Analog Devices, Inc. will provide limited online support for anyone using the reference design with ADI components via the EngineerZone FPGA reference designs forum.

It should be noted, that the older the tools’ versions and release branches are, the lower the chances to receive support from ADI engineers.