Usage

Dependencies

• Python 3.7

• VUnit 5.0.0

• Supported VHDL simulator:

  • ghdl

  • nvc

  • Siemens Questa

  • Siemens Modelsim

  • Aldec Riviera-PRO

  • Aldec Active-HDL

Note the following simulators are not currently supported by VUnit:

• Cadence Xcelium

• Synopsys VCS

• AMD/Xilinx Vivado Simulator (xsim)

Installing VUnit

To install the correct version of VUnit, run:

pip3 install -r requirements.txt

Running the Tests

Since the compliance tests can fail on parsing the source data, the suggested way of running the tests using the system default simulator is to continue even if there is an error or failure:

./run.py -k

To specify a simulator, the VUNIT_SIMULATOR environment variable can be used:

VUNIT_SIMULATOR=nvc ./run.py -k

To run tests in parallel, the number of threads can be increased by using -p:

./run.py -k -p 30

Note that this may cause erroneous failures with commercial simulators if the number of threads exceeds the number of licenses.

Since this test suite is based on VUnit, please refer to the VUnit Documentation for all supported options and configurations.

Interpreting Test Results

Currently the tests are focused on parsing and compiler compliance, and it is not to be considered an exhaustive test of the feature. A passing test simply means that a minimal example was able to be parsed, analyzed, elaborated, and run through the simulator without an error.