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
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.