Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 9/26/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

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

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