.en
.ps 11
.vs 13
.hy 0
.nr sf .25i
.ps +2
.vs +2
.ce 1000
.ft B
Creating and Running Circuits with the TMU Ports Package
.sp
.ps -2
.vs -2
.ft I
Dave Galloway
.sp
Edward S. Rogers Sr. Department of Electrical and Computer Engineering
University of Toronto
.sp
April 2013
.ce 0
.ft R
.ds TL ''- % -''
.su
Communicating with your Circuit
.pp
The TMU ports package can be used to communicate with your circuit.
See \fIThe TMU Ports Package\fP
document for details.
If you want to use the ports package,
create a port description file,
giving it the same
name as the top level netlist, but with a .ports extension.
You must also instantiate a component in your netlist called
\f(CWusb_portmux\fP, passing it the signals that you want to connect to the
ports package.
.pp
Run the \f(CWtmu\fP command like this:
.sp
.ce
.ft CW
tmu toplevelname
.ft P
.pp
This will run the Altera CAD software,
creating a new directory called \f(CWusb_portmux\fP
containing the Verilog source for the usb_portmux wrapper component.
It will also copy your ports file to a file called \f(CWfpga0.ports\fP.
.su
Compiling your Circuit
.pp
Add this line to your .qsf file, so that Altera's Quartus software
can find the source for the usb_portmux component:
.pp
.ce
.ft CW
set_global_assignment -name SEARCH_PATH usb_portmux
.ft P
.pp
Compile your circuit using Quartus.
.su
Using the demonstration board
.pp
In order to use the demonstration board,
the \f(CWtmumon\fP daemon must be running on the machine
named \f(CWskynet.eecg\fP.
This daemon is normally started when the machine is booted, and will continue
running.
If the daemon stops for some reason, you can re-start it by signing on to
that machine and typing:
.pp
.ce
.ft CW
tmumon &
.ft P
.pp
The \f(CWtm\fP command can then be used to communicate with the tmumon daemon.
See \fIThe tmumon Program\fP document for details.
.pp
You can check the status of the demonstration board remotely by running the
\f(CWtmstatus\fP program.
It will use X-windows to create an popup window on your screen
that shows the current status of the board.
.pp
The \f(CWtmget\fP command will attempt to reserve the board for a specified
number of minutes (default 10).
If it succeeds, your name will be shown on everyone's tmstatus display.
When you are finished, run the \f(CWtmrelease\fP command so that others
may use the board.
.pp
Once you have ensured that no one else is using the board, you can download
your circuit to the board using Quartus.
To communicate with the circuit, run your program that uses the ports library
in the directory that contains the \f(CWfpga0.ports\fP file.
