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.36. project_new (::quartus::project)

The following table displays information for the project_new Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax project_new [-h | -help] [-long_help] [-family <family> ] [-overwrite] [-part <part> ] [-revision <revision_name> ] <project_name>
Arguments -h | -help Short help
-long_help Long help with examples and possible return values
-family <family> Family name
-overwrite Option to overwrite existing project and revision
-part <part> Part name
-revision <revision_name> Revision name
<project_name> Project name
Description
Creates and opens a new project with the specified project name.

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

Assignments created or modified by using this Tcl command are 
not saved to the Quartus Prime Settings File (.qsf) unless you
explicitly call one of the following two Tcl commands:

1) export_assignments
2) project_close (unless "-dont_export_assignments" is specified)

These two Tcl commands reside in the ::quartus::project Tcl 
package. You must save assignment changes before you run 
Quartus Prime command-line executables. Note, however, that 
the Tcl commands "execute_flow" and "execute_module" (part 
of the ::quartus::flow Tcl package) automatically call 
"export_assignments" before they run command-line executables.
Example Usage
## Create project "chiptrip" and revision "chiptrip"
project_new chiptrip

## Create project "chiptrip" and revision "auto_max"
project_new -revision auto_max chiptrip

## Create project "chiptrip" and revision "chiptrip"
## Overwrite any Quartus Prime Settings File (.qsf) if it exists
project_new chiptrip -overwrite

## Create project "chiptrip" and revision "chiptrip"
## Set the FAMILY assignment to Stratix
project_new chiptrip -family Stratix
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: The -<string> option must also be used when you use the -<string> option. Specify both options.
TCL_ERROR 1 ERROR: Can't create project: <string>. Specify a legal project name.
TCL_ERROR 1 ERROR: Can't create revision: <string>. Specify a legal revision name using the -<string> option.
TCL_ERROR 1 ERROR: Can't create revision: <string>. Specify a legal revision name.
TCL_ERROR 1 ERROR: Can't create settings files for project: <string>. Make sure the .psf, .csf, and .ssf files are writeable.
TCL_ERROR 1 ERROR: Can't open project: <string>
TCL_ERROR 1 ERROR: Can't remove Quartus Prime Settings File: <string>. Make sure the file is writeable.
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: Found two options: -<string> and -<string>. Choose one of the options.
TCL_ERROR 1 ERROR: Project already exists: <string>. Specify a different project name or use the -overwrite option.