User guide

25–6 Chapter 25: Trace System MegaCore Function
Operating the Trace System from System Console
Video and Image Processing Suite January 2013 Altera Corporation
User Guide
Table 25–3 lists the function for each trace bar icon.
TCL Shell Commands
You can control the Trace System components from the TCL scripting interface using
trace service. Table 25–4 lists the commands and their functions.
Table 25–3. Functions for Trace Control Bar Icons
Icon Function
Settings Displays the configuration dialogue again.
Start
Tells the trace system to start acquiring data. Data is displayed in
the table view as soon as possible after it is acquired.
Stop Stops acquiring data.
Pause
Stops the display from updating data, but does not affect data
acquisition. If you want to examine some data for a length of
time, it good to pause so that your data is not aged out of the
underlying database.
Save
Saves the raw captured data as a trace database file. You can
reload this file using the Open file icon in the configuration
dialogue.
Filter Control
Lets you filter the captured items to be displayed, but it does not
affect acquisition. The filter accepts standard regular expression
syntax—you can use filters such as blue/white to select either
color.
Filter
Opens the filter settings dialogue, that allows you to select the
parts of the captured data you want to display.
Export
Exports a text file containing the current contents of the trace
table view. Filters affect the contents of this file.
Table 25–4. Trace System Commands (Part 1 of 2)
Command Arguments Function
get_service_paths trace
Returns the System Console names for all
the Trace System components which are
currently visible.
claim_service
trace
<service_path>
<library_name>
Opens a connection to the specified trace
service so it can be used. Returns a new
path to the opened service.
close_service
trace
<open_service>
Closes the service so that its resources
can be reused.
trace_get_monitors <open_service>
Returns a list of monitor IDs—one for
each monitor that is available on this trace
system.
trace_get_monitor_info
<open_service>
<monitor_id>
Returns a serialized array containing
information about the specified monitor.
You can use the array set command to
convert this into a TCL array.