project_new (::quartus::project)
The following table displays information for the project_new Tcl command:
Tcl Package and Version |
Belongs to ::quartus::project 1.0 |
|||
Syntax | project_new [-h | -help] [-long_help] [-cmp <revision_name> ] [-device <device> ] [-family <family> ] [-no_cmp] [-overwrite] [-sim <revision_name> ] <project_name> | |||
Arguments | -h | -help | Short help | ||
-long_help | Long help with examples and possible return values | |||
-cmp <revision_name> | Revision name to open. Defaults to project name. | |||
-device <device> | Device name | |||
-family <family> | Family name | |||
-no_cmp | Option to indicate that revision is not opened automatically | |||
-overwrite | Option to overwrite existing project and revision | |||
-sim <revision_name> | Revision name to open | |||
<project_name> | Project name | |||
Description |
Creates and opens a new project with the specified project name. If the "-cmp" and "-sim" options are both specified and have different names, the "-sim" option is ignored. 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 existing assignment files if they exist 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_OK | 0 | WARNING: Specified values of options -<string> and -<string> differ. Ignored value of -<string> option. No action is required. | ||
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 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 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. |