tbengy v2

tbengy Python Tool for SV/UVM Testbench Generation and RTL Synthesis. The tool uses newly available capability of Vivado tool by Xilinx (WebPack Version) to compile and run SV/UVM Testbench and syntheize RTL for Digilent FPGA Boards

Used in Industry

Backbone Systems

Demo (Demo will be updated soon)

Requirements

Python 3.x
Xilinx Vivado 202x.x
GNU Make

Setup Instructions

1. Python 3.x.x

Download Python3 from https://www.python.org/downloads/
Install Python3 in your system
Check Python version in Terminal/Console/Command-Prompt/Powershell

Command

python --version

python3 --version

Output (Should be 3.x.x)

Python 3.8.1

2. Xilinx Vivado 20xx.x

Download Vivado from https://www.xilinx.com/support/download.html
Install Vivado WebPack in your system
Set Xilinx Vivado bin folder path to User/System Environment Variables

Setting Variable in Linux

export PATH="$PATH:/home/<path_to_xilinx_installation>/Xilinx/Vivado/2020.1/bin"

Note: Put the above line with your path in ~/.bashrc, so the tool can load everytime you open terminal

Test that tool opens from Terminal and path is properly set

Once you set the path in ~/.bashrc, open new terminal and execute command below

vivado

If your path and setup is correct, Vivado GUI will open
You can close it as we will be working from terminal for the tbengy

Setting Variable in Windows

Open Command-Prompt as administrator

setx path "%path%;<path_to>Xilinx\Vivado\2020.1\bin"

Example: setx path "%path%;C:\Xilinx\Vivado\2020.1\bin"

You can also set the path from System Properties. Search online for this method.

Check your Vivado installation from Command-prompt/Powershell

Once you set the path in Windows, open new command-prompt/Powershell and execute command below

vivado

If your path and setup is correct, Vivado GUI will open
You can close it as we will be working from command-prompt/Powershell for the tbengy

3. GNU Make

Most Linux come with GNU Make so no need to do this step if you are running using Linux
For Windows, download GNU Make and install it from http://gnuwin32.sourceforge.net/packages/make.htm
After installation in Windows, we need to add the bin path of Make in system path variable as we did for Vivado

setx path "%path%;<path_to>Program Files (x86)\GnuWin32\bin\"

Example: setx path "%path%;C:\Program Files (x86)\GnuWin32\bin"

After adding the path, open new command-prompt/Powershell window and run

make

If you see make getting executed, you are good to go

Using tbengy

Run the command below if you are using Git to clone the repository anywhere you wish

git clone https://github.com/prasadp4009/tbengy.git

Download from link - https://github.com/prasadp4009/tbengy/archive/master.zip
Unzip the master.zip if downloaded and then go to tbengy directory
Open new Terminal/Console/Command-Prompt/Powershell in that directory
Run the command below to generate UVM TB

python tbengy.py

python3 tbengy.py

tbengy help can be accessed with:

python tbengy.py -h

python3 tbengy.py -h

You should get the following output

usage: tbengy.py [-h] [-v] (-l | -m <module_name>) [-t <tb_type>] [-b <board_type>] [-f <fpga>] [-d <dir_path>]
optional arguments:
  -h, --help            show this help message and exit
  -v, --version         Show tbengy version and exit
  -l, --listboards      Show the list of available boards and exit
  -m <module_name>, --modulename <module_name>
                        Module name for which TB to be generated. Ex. -m my_design
  -t <tb_type>, --tbtype <tb_type>
                        Testbench type to be generated. Ex. -t uvm or -t sv
  -b <board_type>, --boardtype <board_type>
                        Board Files to be added. Ex. -b zybo, -b nexys4_ddr, -b zybo-z7 etc.
  -f <fpga>, --fpga <fpga>
                        FPGA used in board. Ex. -f xc7z010clg400-1, -f xc7a100tcsg324-1, -f xc7z010clg400-1 etc. for Zybo, Nexys 4 DDR and Zybo-Z7-10 respectively
  -d <dir_path>, --dirpath <dir_path>
                        Directory under which TB should be generated. Ex. -d ./myProjects/TB. Default is present working dir.

Enter you module name with '-m <module_name>', the tool will generate a complete UVM testbench (default tb_type is UVM)

python tbengy.py -m my_design

python3 tbengy.py -m my_design

You can enter desired directory where you want to generate TB by passing '-d <directory_path>'

python tbengy.py -m my_design -d ./myProjects/

python3 tbengy.py -m my_design -d ./myProjects/

Go to your generated module folder
You can read the generated README.md to understand directory structure
To run the testbench, go to scripts directory and run command below

For SV TB generation

For generating SV TB you need to add an additional flag '-t sv' along with primary generation command as shown below

python tbengy.py -m my_design -d ./myProjects/ -t sv

python3 tbengy.py -m my_design -d ./myProjects/ -t sv

For SV TB with Synthesis on Digilent Boards generation

For generating SV TB with Synthesis on Digilent Boards, you need to add flag '-t sv -b <board_name> -f ' along with primary generation command as shown below
You should be able to find FPGA part name from Board Reference Manual or Vendor website
The default RTL contains Blink LED program, which is basically a simple clock divider with output of 1Hz to LED
The command also pics up correct board files and link them in script. Modified board files are already available in ./digilent-xdc directory
These files are modified with additional information regarding clock frequencies and mapped to ports in design RTL by default
To check the list of boards run the below command

python tbengy.py -l

python3 tbengy.py -l

Example for Zybo Board

python tbengy.py -m zyboBlink -d ..\myProj\ -b zybo -f xc7z010clg400-1 -t sv

python3 tbengy.py -m zyboBlink -d ..\myProj\ -b zybo -f xc7z010clg400-1 -t sv

Example for Nexys 4 DDR

python tbengy.py -m nddr4Blink -d ..\myProj\ -b nexys4-ddr -f xc7a100tcsg324-1 -t sv

python3 tbengy.py -m nddr4Blink -d ..\myProj\ -b nexys4-ddr -f xc7a100tcsg324-1 -t sv

For batch mode

make run_all

For generating wave and debugging in Vivado Simulator

make run_all_gui

For generating bit stream with synthesis and implementing it on board

make synth

Note: You can have multiple boards connected to system. Do make sure the boards are connected and turned on.

Contact me on prasadp4009@gmail.com for any questions.

Hope the tool helps. Thanks!

prasadp4009/tbengy