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