run_multiple_end (::quartus::stp)

The following table displays information for the run_multiple_end Tcl command:

Tcl Package and Version

Belongs to ::quartus::stp 1.0

Syntax run_multiple_end [-h | -help] [-long_help]
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
Description
Defines the end of a set of "run" commands. This command 
is used when multiple instances of data acquisition are 
started simultaneously. Add "run_multiple_start" before 
the set of "run" commands that specify data acquisition. 
Add this command 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 ended successfully
TCL_ERROR 1 ERROR: Data acquisition stopped unexpectedly. Make sure device is stable and run again.
TCL_ERROR 1 ERROR: Run multiple instances has not been started. Use run_multiple_start before using run_multiple_end.
TCL_ERROR 1 ERROR: Session has not been opened. Make sure a session is open before attempting to close it.