project_new (::quartus::project)

Tcl Package and Version

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.

Tcl Package and Version	Belongs to ::quartus::project 6.0
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.