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