Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 10/04/2021

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

Document Table of Contents 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

Syntax run_multiple_start [-h | -help] [-long_help]
Arguments -h | -help Short help
  -long_help Long help with examples and possible return values

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