A Short Intro to ModelSim Verilog Simulator (Last edited in 2015)

This is a beginner's tutorial to get you off the ground from scratch.

Environment Setup

This assumes you are running bash on an ECE Linux machine. (You can determine which shell you are using by typing echo $SHELL into your Unix command prompt. If you are not running bash, you can type bash into the command prompt to start a bash shell. If you are running a different shell, I assume you know enough to adapt the instructions to your favorite shell.)

Type this command

export PATH=/afs/ece/support/mgc/share/image/usr/local/mgc/modelsim/modeltech/bin:$PATH

(PATH tells your shell where to find the executables for ModelSim.)

Next type

export LM_LICENSE_FILE=/afs/ece/support/mgc/share/image/usr/local/mgc/license.dat:$LM_LICENSE_FILE

LM_LICENSE_FILE tells ModelSim where to find its license file.

(The above should work regardless of how your environment is initially set up. If you are familiar with the Unix shell environment, you can figure out how to properly add the above to your .bashrc so you don't have to type them each time.)

If you messed up on the first command, which vsim will report there is no vsim in your path. If you messsed up on the second command, vsim will not run in the steps below.

Creating a library directory

ModelSim requires a “library directory” to store information about your project. In your working directory (where the simulation project .v files are), type

vlib work

This creates a directory called work needed by Modelsim. If you delete this directory, you will need to create it again before running any compilations.

Compiling Verilog files

Next from the working directory, type

vlog «list of verilog files»

This might look like

vlog fsm.v testbench.v

Or, if all of the .v files are pertinent, just type

vlog *.v

This compiles your .v files for simulation. If there were no errors, the compilation should list the modules compiled and point out the top level modules (ones not included by any other modules). If the compilation failed with ERR messages, you will need to revise your .v files to address the complaints and recompile. It is a good practice to also look for WARN messages and resolve those as well.

Running ModelSim

To run ModelSim, from the working directory, type:

vsim «top-level module name»

For example,

vsim testbench

if testbench is the top level module in your design. In an X-ready environment, this should bring up the simulator main window. You can start the simulation by typing in the simulator command window:

run -all

The simulation will run until it encounters a $stop or $finish command in your .v files. If you are using only $display and $print for debugging, this is all the ModelSim you need know. In fact, if this is all you do, you can just type

vsim -c -do “run -all” top

at the Unix command prompt to run vsim in text mode (without X).

Debugging in ModelSim

Most likely, you'll run into bugs and need to muck around with the waveform viewer and debugger. ModelSim has a great GUI with which to debug the design. Most of this you will have to discover for yourself. Here's a quick tutorial.

  • To bring up an object window: View→Debug Windows→Object
  • To bring up a waveform window: View→Debug Windows→Waves.
    You can add signals to the waveform window by dragging and dropping things from the object window into the waveform window (left panel).
  • To run the simulation (from the Simulate→Run pull-down menu):
    • Run - All: Run until the next breakpoint or until a $finish or $stop, or forever.
    • Run - Continue: Continue running after a breakpoint.
    • Run - 100ns: Run for 100ns of simulation time.
  • If you find a bug, you can edit, recompile and restart the simulation, without quitting the ModelSim executable. Just type the same compilation command into the bash shell and then type restart the simulation inside ModelSim. You do not need to restart ModelSim after recompiling.
  • Virtually all click-able things can be accessed with keyboard commands. For power users with too much time on their hands, ModelSim can be scripted using TCL.

This tutorial should have set you up for the most minimum of functionalities to run a basic Verilog simulation project. Reading documentations will help you access the more powerful debugging and simulation features. You can google online for more thorough, more advanced tutorials. You can also try googling a specific question phrase; it is amazing how much expert help is just out there.