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.28.31. open_side_revision (::quartus::project)

The following table displays information for the open_side_revision Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax open_side_revision [-h | -help] [-long_help] <revision_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
<revision_name> Revision name
Description
Loads the specified revision name into memory, without making it
	    the current revision.  Required step before assignments can
be modified on the side with the use of the -revision option in
get/set/remove assignments.

Changes are not saved until close_side_revision is called.  

The specified revision cannot be the current revision, and once
opened, cannot be made the current revision until it is closed.
Example Usage
## Create and open "new_rev" as a side revision. Apply an assignment and close the revision.

create_revision new_rev -based_on my_rev -copy_results
open_side_revision new_rev
set_global_assignment -name OPTIMIZATION_TECHNIQUE "Area" -revision new_rev
close_side_revision new_rev
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_OK 0 WARNING: Revision is already the current revision: <string>. No action is required.
TCL_ERROR 1 ERROR: You must open a project before you can use this command.
TCL_ERROR 1 ERROR: Revision file does not exist: <string>.qsf. Use delete_revision to delete the revision from the current project. Then use create_revision to create the revision and its .qsf before setting <string> as the current revision.
TCL_ERROR 1 ERROR: Revision is not included in the current project: <string> . Use the create_revision command to create the revision.
TCL_ERROR 1 ERROR: An unknown error has occured.