The simulator is your best friend in debugging your modules, but it doesn't seem like it at first. This tutorial is designed to teach you some basic TCL commands and how to use them in the simulator. As you continue to use the simulator you will find additional shortcuts and tools that will make your job much easier.

TCL is a high-level scripting language that is often used within other programs. Vivado gives you the option of using only TCL commands to interact with your designs - to the extent that you wouldn't even need the Vivado IDE! However, much of that is beyond the scope of this course. The purpose of this tutorial is to teach you specific TCL commands that will allow you to simulate your modules.

Your first task is to create a file that will contain your TCL commands. Every lab you make should have it's own folder of TCL files. Theoretically, every time you wanted to test a module you could type out a long list of TCL commands but that process is tedious and slow. Instead, a .tcl file will allow you to run a script and modify it without retyping everything.

To create your file, click on File→Text Editor→New File then name the file something and include .tcl at the end. Vivado should automatically open it for you in the GUI, but if not click File then Open File and search for it. IMPORTANT: make sure the .tcl file is inside your project directory (which should be on the J: drive).

Now we will discuss the three main commands you need for simulation.

While the restart command isn't necessary for simulation, it makes things much easier to read. When you first start the simulation, the simulator automatically runs for 1000ns. However, you haven't declared the values of your inputs yet, so you aren't going to get any useful information from the outputs. To get rid of that first 1000ns you can use the restart command to clear it before you start simulating. Alternatively, you could press this button which does the same thing:

The run command allows you to see how your program behaves over a period of time. This is extremely important when using things like clocks and counters, but it is still useful for combinational designs. Instead of watching the circuit change values on its own, we change the value of the inputs at certain times and see the resulting outputs. Then we can visually place everything together to get a sense of how our circuit behaves. Note that everything is ideal in the simulator - there are no gate delays or false outputs.

Here's an example of the run command:

run 15ms

The assumed units are ns, but you can use whatever units you need. Usually you'll never need to simulate something for more than a few ms.

The add_force command allows you to assign a value to an input wire in your module.

Here's the basic syntax of the add_force command:

add_force <signal name> <value>

add_force buttonPress 1

We state the name of the input, give it a value (usually 0 or 1), and then the simulator will update that signal and all the other signals that depend on it. For signals that do not change during the simulation this is all we need. However, if we wanted to change the value midway through the simulation we could do something like this:

add_force wireA 1
run 10ns
 
add_force wireA 0
run 10ns

We set wireA to a value, run the simulation, set it to a different value, and then run it again. This allows us to see the change in the outputs in the simulation window. In the following code, we do this with multiple signals. Note that wireC does not have an add_force in the second block. If that happens, wireC will retain its previous value. While this may seem like a convenient shortcut, the main benefit of writing out each add_force is that you can see what each wire is for each block of time. It makes it easy to modify your TCL file and determine what combinations might be giving you errors.

add_force wireA 1
add_force wireB 0
add_force wireC 0
add_force wireD 1
run 10ns
 
add_force wireA 0
add_force wireB 1
add_force wireD 1
run 10ns
 
add_force wireA 0
add_force wireB 0
add_force wireC 1
add_force wireD 1
run 10ns

Once you've created your file there is a way to run it using the TCL command line and the file directory but in the writer's opinion that takes more trouble than it's worth. A much more straightforward approach is to copy all of the commands from your TCL file and paste them directly into the TCL command line. Even easier than that, if your TCL file is open in Vivado you can right-click anywhere inside it and the last option will be to run it in the simulator.

That is all the information you need to start making your own TCL files. In lab 4, you will cover more features of TCL commands that will make it easier for you to fully simulate your modules.