Examples

VHDL

AXI DMA

Demonstrates the AXI read and write slave verification components as well as the AXI-lite master verification component. An AXI DMA is verified which uses an AXI master port to read and write data from external memory. The AXI DMA also has a control register interface via AXI-lite.

Run

Demonstrates the VUnit run library.

VHDL UART

A more realistic test bench of an UART to show VUnit VHDL usage on a typical module.

VHDL User Guide

The most minimal VUnit VHDL project covering the basics of the User Guide.

JSON-for-VHDL

Demonstrates the JSON-for-VHDL library which can be used to parse JSON content. The content can be read from a file, or passed as a stringified generic. This is an alternative to composite generics, that supports any depth in the content structure.

Array and AXI4 Stream Verification Components

Shows how to use integer_array_t, axi_stream_master_t and axi_stream_slave_t. A CSV file is read, the content is sent in a row-major order to an AXI Stream buffer (FIFO) and it is received back to be saved in a different file. Further information can be found in the verification component library user guide, in subsection Stream and in vhdl/verification_components/test/tb_axi_stream.vhd.

Generating tests

Demonstrates generating multiple test runs of the same test bench with different generic values. Also demonstrates use of output_path generic to create test bench output files in location specified by VUnit python runner.

Logging

Demonstrates VUnit’s support for logging.

Communication library

Demonstrates the com message passing package which can be used to communicate arbitrary objects between processes. Further reading can be found in the com user guide.

Vivado IP

Demonstrates compiling and performing behavioral simulation of Vivado IPs with VUnit.

Check

Demonstrates the VUnit check library.

Array

Demonstrates the integer_array_t data type, which can be used to handle dynamically sized 1D, 2D and 3D data as well as storing and loading it from csv and raw files.

SystemVerilog

SystemVerilog UART

A more realistic test bench of an UART to show VUnit SystemVerilog usage on a typical module.

SystemVerilog User Guide

The most minimal VUnit SystemVerilog project covering the basics of the User Guide.