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.29.33. project_open (::quartus::project_ui)

The following table displays information for the project_open Tcl command:

Tcl Package and Version

Belongs to ::quartus::project_ui

Syntax project_open [-h | -help] [-long_help] [-current_revision] [-error_on_incompatible_database] [-revision <revision_name> ] <project_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-current_revision Option to open the current revision automatically
-error_on_incompatible_database Option not to open the project and issue and error if the database version is incompatible
-revision <revision_name> Revision name
<project_name> Project name
Description
Opens an existing project. To create a new project, use the 
"project_new" command.

If the "-revision" option is not specified, the project name
is used to open the revision.

By default, opening the project overwrites the database
created in a different version of the Quartus Prime software.
However, if the "-error_on_incompatible_database" option is
specified, instead of opening the project, an error is issued 
when the database version differs from the current version of the 
Quartus Prime software.
Example Usage
## Open project "chiptrip" and revision "chiptrip"
project_open chiptrip

## Open project "chiptrip" and revision "auto_max"
project_open -revision auto_max chiptrip

## Get the current revision before opening
## the project with the current revision
set project_name chiptrip
set current_revision [get_current_revision $project_name]
project_open -revision $current_revision $project_name
puts [get_global_assignment -name FAMILY]
project_close
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_OK 0 WARNING: Project is already open: <string>
TCL_ERROR 1 ERROR: Can't open project: <string>. First close the currently open project: <string>.
TCL_ERROR 1 ERROR: Can't open project: <string>
TCL_ERROR 1 ERROR: Can't set revision: <string>. Make sure there is an open, active revision name.
TCL_ERROR 1 ERROR: Can't run Tcl command while a process is in progress: <string>. To run the command, stop the compilation or simulation; or wait for the compilation or simulation to complete.
TCL_ERROR 1 ERROR: Cannot open project: <string>. The project is not compatible with the installed version of the Quartus Prime software. Opening the project will overwrite the old project database. If you wish to overwrite the old project database, make sure to specify the -<string> option.
TCL_ERROR 1 ERROR: Can't open revision: <string> (project: <string>). The revision is not compatible with the installed version of the Quartus Prime software. Opening the revision will overwrite the old revision database. If you wish to overwrite the old revision database, make sure to specify the -<string> option.
TCL_ERROR 1 ERROR: Found two options: -<string> and -<string>. Choose one of the options.
TCL_ERROR 1 ERROR: Revision does not exist: <string>. Specify a legal revision name using the -<string> option.
TCL_ERROR 1 ERROR: Project does not exist or has illegal name characters: <string>. Specify a legal project name.