README.md

Sample testbench for a Tiny Tapeout project

This is a sample testbench for a Tiny Tapeout project. It uses cocotb to drive the DUT and check the outputs. See below to get started or for more information, check the website.

Setting up

1. Edit Makefile and modify PROJECT_SOURCES to point to your Verilog files.
2. Edit tb.v and replace tt_um_example with your module name.

How to run

To run the RTL simulation:

make -B

To run gatelevel simulation, first harden your project and copy ../runs/wokwi/results/final/verilog/gl/{your_module_name}.v to gate_level_netlist.v.

Then run:

make -B GATES=yes

If you wish to save the waveform in VCD format instead of FST format, edit tb.v to use $dumpfile("tb.vcd"); and then run:

make -B FST=

This will generate tb.vcd instead of tb.fst.

How to view the waveform file

Using GTKWave

gtkwave tb.fst tb.gtkw

Using Surfer

surfer tb.fst