aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/HOWTO.testbench
diff options
context:
space:
mode:
authorbryan newbold <bnewbold@leaflabs.com>2013-11-12 18:16:19 -0500
committerbryan newbold <bnewbold@leaflabs.com>2013-11-12 18:16:19 -0500
commit0d34adceb3665ad6d96cb4f2e8bd0ad55d712195 (patch)
tree86cc1f3b3a1160f6b0d93f759dee7a99f0868e82 /contrib/HOWTO.testbench
parent75fc9c1613ffbeea2be843c3aa0e5fcd978ad60b (diff)
downloadbasic-hdl-template-0d34adceb3665ad6d96cb4f2e8bd0ad55d712195.tar.gz
basic-hdl-template-0d34adceb3665ad6d96cb4f2e8bd0ad55d712195.zip
Part 3 of refactoring template files into ./contrib
Docs!
Diffstat (limited to 'contrib/HOWTO.testbench')
-rw-r--r--contrib/HOWTO.testbench12
1 files changed, 12 insertions, 0 deletions
diff --git a/contrib/HOWTO.testbench b/contrib/HOWTO.testbench
new file mode 100644
index 0000000..3be00d6
--- /dev/null
+++ b/contrib/HOWTO.testbench
@@ -0,0 +1,12 @@
+
+"testbenches" are helpful wrappers which exersize a piece of code. they should
+live in ./tb/, end in "_tb.v" or "_tb.vhd", and have a signal file (ending in
+"_tb.wcfg") associated with the same name. update the 'tbfiles' list in
+Makefile. invoke the isim GUI with "make isim/name_tb" (for tb/name_tb.v). if
+you make a source code change and don't want to reload the whole GUI, you can
+do "make resim/name_tb" and then click the "Re-load" button.
+
+testbenches which can act as headless unit tests (reporting pass/fail by
+printing to stdout) should be added to the 'alltests' list in Makefile. run the
+test with 'make test/name_tb'; run all tests with 'make tests'.
+