Axi traffic generator

Owned by Confluence Wiki Admin (Unlicensed)
Last updated: Nov 19, 2024 by Datta, Shubhrajyoti

0This page gives an overview of axi traffic generator driver which is available as part of the Xilinx Vivado and SDK distribution.

Table of Contents

Introduction

This page gives an overview of axi traffic generator driver which is available as part of the Xilinx Vivado and SDK distribution.
The Xilinx® LogiCORE™ IP AXI traffic generator core is a soft Xilinx IP core for
Use with the Xilinx Vivado® Design Suite.

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

trafgen

<Vitis Install Directory>/data/embedded/XilinxProcessorIPLib/drivers/trafgen

https://github.com/Xilinx/embeddedsw/tree/master/XilinxProcessorIPLib/drivers/trafgen

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/trafgen


The driver source code is organized into different folders.  The table below shows the trafgen driver source organization. 

DirectoryDescription

doc

Provides the API and data structure details

data

Driver .tcl , .mdd and .yaml files

examples

Example applications that show how to use the driver features

src

Driver source files, make and cmakelists file

Note: AMD Xilinx embeddedsw build flow has been changed from 2023.2 release to adapt to the new system device tree based flow. For further information, refer to the wiki link Porting embeddedsw components to system device tree (SDT) based flow.The .yaml(in data folder) and CMakeLists.txt(in src folder) files are needed for the System Device Tree based flow. The Driver .tcl and .mdd files are for the older build flow which will be deprecated in future.

Driver Implementation

For a full list of features supported by this IP, please refer TRM

Features

  1. Flexible data width capability (32/64-bit) on output AXI4-memory map Slave, (32/64/
    128/256/512-bit) on output AXI4-memory map Master interface
  2. Flexible data width capability from 8-bit to 1,024-bit in multiples of eight output
  3. AXI4-stream Master/Slave interface
  4. Interrupt support for indicating completion for traffic generation.
  5. Error interrupt pin indicating error occurred during core operation. Error registers can
    be read to understand the error occurred.

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/trafgen/examples

Test Name

Example Source

Description
Trafgen Polled mode example

xtrafgen_polling_example.c


This example programs known data to master RAM and command to command ram and param ram. The data will
be taken from master RAM and programmed to the slave.
Trafgen Interrupt mode example

xtrafgen_interrupt_example.c


This example programs known data to master RAM and command to command ram and param ram. The data will
be taken from master RAM and programmed to the slave in interrupt mode.
Trafgen Streaming example

xtrafgen_master_streaming_example.c


This examples does basic read and write test from the flash device in Non-blocking Polled mode.
Trafgen static examplextrafgen_static_mode_example.cThis example demonstrates how to use the Static mode in the Axi Traffic core continuously generates fixed address and fixed INCR type read and write transfers based on the burst length configured.

Example Application Usage

Trafgen Polled mode example

This example programs known data to master RAM and command to command ram and param ram. The data will
be taken from master RAM and programmed to the slave.

Expected Output


Entering main
--- Exiting main() ---
Successfully ran Traffic Generator Polling Example

Trafgen I Interrupt mode example

Expected Output


Successfully ran Traffic Generator Interrupt Example

Example Design Architecture

NA

Performance

NA

Change Log

2024.2

https://github.com/Xilinx/embeddedsw/blob/xilinx_v2024.2/doc/ChangeLog#L1663

2024.1

https://github.com/Xilinx/embeddedsw/blob/xilinx_v2024.1/doc/ChangeLog#L911

2023.2

embeddedsw/doc/ChangeLog at xilinx_v2023.2 · Xilinx/embeddedsw · GitHub


2023.1

None

2022.2

None

2022.1

None

2021.1

https://github.com/Xilinx/embeddedsw/blob/xilinx_v2021.1/doc/ChangeLog#L2214

2020.2

None


2020.1

None

2019.2

None


Related Links

© Copyright 2019 - 2022 Xilinx Inc. Privacy Policy