Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 12/13/2021
Public

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

Document Table of Contents

3.1.24.4. create_revision (::quartus::project)

The following table displays information for the create_revision Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax create_revision [-h | -help] [-long_help] [-based_on <revision_name> ] [-copy_results] [-new_rev_type <revision_type> ] [-root_partition_qdb_file <qdb_file> ] [-set_current] <revision_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-based_on <revision_name> Revision name on which new revision bases its settings
-copy_results Option to copy results from "based_on" revision
-new_rev_type <revision_type> The type of the newly created revision
-root_partition_qdb_file <qdb_file> The Partition Database (.qdb) file for the root partition
-set_current Option to set new revision as current revision
<revision_name> Revision name
Description

Creates the specified revision. If the revision is not included in the current project, a new revision is created in the project with default settings. If you specify the "-set_current" option, this command sets the newly created revision as the current revision. If you specify the "-based_on" option, the command creates a new revision in the project based on the settings of the based-on revision specified by the option.

Example Usage
## Create a new revision called "tmp"
create_revision tmp

## Create a new revision called "tmp"
## and set it as the current revision
create_revision tmp -set_current
## This method is the same as 
create_revision tmp
set_current_revision tmp

## Create a new revision called "speed_ch"
## with settings based on "chiptrip"
## and set it as the current revision
create_revision speed_ch -based_on chiptrip -set_current
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: Based-on revision is not included in the current project: <string>. Make sure the based-on revision nam