Documentation

Fall 2022

You are not logged in.

Please Log In for full access to the web site.
Note that this link will take you to an external site (https://shimmer.mit.edu) to authenticate, and then you will be redirected back to this page.
Quick Command Reference

These commands contain the arguments that work in most use cases - every once in a while you'll need to modify them slightly, but these are their most common forms:

  • Building a project:
    • With lab-bc: python3 lab-bc.py
    • Locally: vivado -mode batch -source build.tcl
  • Flashing the FPGA: openFPGALoader -b arty_a7_100t out.bit
  • Simulating a testbench:
    • iverilog -g2012 -o foo.out sim/foo_tb.sv src/foo.sv followed by vvp foo.out
    • Add all the files that iVerilog should be aware of to the command line args. For instance, if your testbench foo_tb makes an instance of foo and foo contains an instance of bar, then you'll need to add the files that contain foo and bar to the command line args.
  • Opening GTKWave:
    • Windows/Linux: gtkwave foo.vcd
    • macOS: open foo.vcd
    • Remember that you don't need to close your GTKWave window and reopen it after every simulation! It's way faster to reload the waveform inside your existing window.
Software Setup and Usage
External Hardware and IP Cores

Full disclosure, some of this is a little jank.

Verilog References