Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 12/13/2021

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

Document Table of Contents project_open (::quartus::project)

The following table displays information for the project_open Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax project_open [-h | -help] [-long_help] [-current_revision] [-force] [-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
-force Option to open the project and overwrite the compilation database if the database version is incompatible.
-revision <revision_name> Revision name
<project_name> Project name

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 specified as the revision name. The project_open command gives an error when the compilation database version is not compatible with the current version of Quartus Prime software. You may specify the "-force" option to avoid the error and overwrite the database.

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