Scripting

set_global_assignment


The following table displays information for the set_global_assignment Tcl command:

Tcl Package and Version

Belongs to ::quartus::project 1.0

Syntax

set_global_assignment [-h | -help] [-long_help] [-comment <comment>] [-disable] [-entity <entity_name>] -name <name> [-remove] [-section_id <section id>] [<value>]

Arguments

-h | -help

Short help

-long_help

Long help with examples and possible return values

-comment <comment>

Comment

-disable

Option to disable assignment

-entity <entity_name>

Entity to which to add assignment

-name <name>

Assignment name

-remove

Option to remove assignment

-section_id <section id>

Section id

<value>

Assignment value

Description

Sets or removes a global assignment.

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

1) export_assignments 
2) project_close (unless -dont_export_assignments is specified as an
argument to project_close)

You must save assignment changes before you run Quartus(R) II
command-line executables. Note, however, that the Tcl commands
execute_flow and execute_module (from the ::quartus::flow Tcl
package) call "export_assignments" before they run
command-line executables.

For entity-specific assignments, use the -entity option to force the
assignment to specified entity. If the -entity option is not
specified, the value for the FOCUS_ENTITY_NAME assignment is used. If
the FOCUS_ENTITY_NAME value is not found, the revision name is used.

If the Quartus II Settings File contains a USER_LIBRARIES assignment
and you call set_global_assignment to set a SEARCH_PATH or
USER_LIBRARIES assignment, the existing USER_LIBRARIES assignment
expands into one or more SEARCH_PATH assignments.

Note that values that begin with a dash ("-") should be enclosed in a
backslash followed by a quote. In the following example, -02 is
enclosed by \" at the beginning and the end.

set_global_assignment -name ARM_CPP_COMMAND_LINE \"-O2\"

Example Usage

## Specify Stratix as the family to use when compiling
set_global_assignment -name FAMILY Stratix

## If the family name has empty spaces, use quotes
set_global_assignment -name FAMILY "Stratix GX"

## or remove any empty space
set_global_assignment -name FAMILY StratixGX

Return Value

Code Name

Code

String Return

TCL_OK 0 INFO: Operation successful
TCL_OK 0 INFO: Ignored assignment: <string>. The assignment is no longer supported.
TCL_ERROR 1 ERROR: Assignment is not a global assignment: <string> -- it is an instance assignment. Specify a global assignment name or use the instance assignment commands.
TCL_ERROR 1 ERROR: Can't find file(s) associated with assignment. Specify a different assignment name.
TCL_ERROR 1 ERROR: Can't find section information for assignment. Specify a different assignment name.
TCL_ERROR 1 ERROR: Can't find active revision name. Make sure there is an open, active revision name.
TCL_ERROR 1 ERROR: Entity does not exist or uses illegal name characters: <string>. Specify a legal entity name.
TCL_ERROR 1 ERROR: File name <string> exceeds maximum of <string> characters. Specify a file name with fewer characters.
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: Value <string> for the -<string> option is illegal. Specify a legal value.
TCL_ERROR 1 ERROR: Option -<string> for <string> assignment is illegal. Specify a legal option or remove the option.
TCL_ERROR 1 ERROR: Options cannot be specified together: -<string>, -<string> and -<string>. Specify only one or two of the three options.
TCL_ERROR 1 ERROR: Value <string> for <string> assignment is illegal. Specify a legal value.
TCL_ERROR 1 ERROR: Missing destination for assignment. Specify the destination for the assignment.
TCL_ERROR 1 ERROR: Open project does not exist. Open an existing project or create a new project.
TCL_ERROR 1 ERROR: Found two options: -<string> and -<string>. Choose one of the options.
TCL_ERROR 1 ERROR: The -<string> option is not required but was specified with the value: <string>. Delete the option.
TCL_ERROR 1 ERROR: The -<string> option is required but was not specified. Specify the required option.
TCL_ERROR 1 ERROR: Illegal assignment: <string>. Specify a legal assignment name.
TCL_ERROR 1 ERROR: An unknown error has occured.
TCL_ERROR 1 ERROR: Assignment <string> cannot be removed -- it has multiple values. Specify one value to remove or use the <string> command to remove all values for the assignment.
TCL_ERROR 1 ERROR: Missing <<string>> for <string> assignment. Specify the required <string>.