run_multiple_start (::quartus::stp)

The following table displays information for the run_multiple_start Tcl command:

Tcl Package and Version

Belongs to ::quartus::stp 1.0

Syntax run_multiple_start [-h | -help] [-long_help]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
Description
Defines the start of a set of "run" commands. This command 
is used when multiple instances of data acquisition are 
started simultaneously. Add this command before the set of 
"run" commands that specify data acquisition. Add 
"run_multiple_end" after the set of commands. 

If "run_multiple_end" is not included, the "run" commands 
do not execute.
Example Usage
#opens signaltap session
open_session -name stp1.stp

#start acquisition of instance auto_signaltap_0 and auto_signaltap_1 at the same time
#calling run_multiple_end will start all instances run after run_multiple_start call

#start acquistion using the configuration last saved; timeout after 5 seconds if no trigger occurs
#NOTE: Use this to replicate how SignalTap GUI works.
#      Only one acquisition is saved into the .stp file upon close_session next.
run_multiple_start
run -instance auto_signaltap_0 -timeout 5
run -instance auto_signaltap_1 -timeout 5
if { [catch {run_multiple_end} err_msg} {
	# Timeout event is thrown as TCL exception
	puts "ERROR: $err_msg"
}

#start acquistion using a specific configuration saved in the data log tree; timeout after 5 seconds if no trigger occurs
#signal_set_1 and trigger_1 must exist in the data log tree as saved in the .stp file. 
#log_1 will be created to hold the acquired data. if -data_log is not specified, a log name is generated automatically.
#NOTE: Use this to save multiple acquisition data logs by executing this command in a loop.
run_multiple_start
run -instance auto_signaltap_0 -signal_set signal_set_1 -trigger trigger_1 -data_log log_1 -timeout 5
run -instance auto_signaltap_1 -signal_set signal_set_1 -trigger trigger_1 -data_log log_1 -timeout 5
if { [catch {run_multiple_end} err_msg} {
	# Timeout event is thrown as TCL exception
	puts "ERROR: $err_msg"
}

#close signaltap session
close_session
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_OK 0 INFO: Multiple instances of data acquisition started
TCL_ERROR 1 ERROR: Run multiple instances has not ended. Use run_multiple_end to complete an active call to run_multiple_start before using run_multiple_start again.
TCL_ERROR 1 ERROR: Session has not been opened. Make sure a session is open before attempting to close it.