set_instance_assignment (::quartus::project)

Tcl Package and Version

Syntax

set_instance_assignment [-h | -help] [-long_help] [-comment <comment> ] [-disable] [-entity <entity_name> ] [-fall] [-from <source> ] -name <name> [-remove] [-rise] [-section_id <section id> ] [-tag <data> ] [-to <destination> ] [ <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

-fall

Option applies to falling edge

-from <source>

Source of assignment

-name <name>

Assignment name

-remove

Option to remove assignment

-rise

Option applies to rising edge

-section_id <section id>

Section id

-tag <data>

Option to tag data to this assignment

-to <destination>

Destination of assignment

<value>

Assignment value

Description

Sets or removes an instance assignment.

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.

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.

Example Usage

## Specify a TSU_REQUIREMENT of 2ns from mypin to any register
set_instance_assignment -from "mypin" -to * -name TSU_REQUIREMENT 2ns

## Remove the TSU_REQUIREMENT from mypin to all registers
set_instance_assignment -from "mypin" -to * -name TSU_REQUIREMENT -remove

## Specify the entity to which the assignment is added, 
## use the -entity option
## This is needed if the top-level entity name is other than
## that of the project name
## The following command generates a top_level entity
set_instance_assignment -from "mypin" -to * -entity top_level -name TSU_REQUIREMENT 2ns

Return Value

Code Name

Code

String Return

TCL_OK

0

INFO: Operation successful

TCL_OK

0

WARNING: Ignored assignment: <string>. The assignment is no longer supported.

TCL_ERROR

1

ERROR: Assignment is not an instance assignment: <string> -- it is a global assignment. Specify an instance assignment name or use the global 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: The assignment <string> is from Design Template and can't be changed/removed.

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: 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: You must open a project before you can use this command.

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 name: <string>. Specify a legal assignment name. To view the list of legal assignment names, run get_all_assignment_names.

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

Tcl Package and Version	Belongs to ::quartus::project 6.0
Syntax	`set_instance_assignment [-h \| -help] [-long_help]` `[-comment` <comment> `]` `[-disable]` `[-entity` <entity_name> `]` `[-fall]` `[-from` <source> `]` `-name` <name> `[-remove]` `[-rise]` `[-section_id` <section id> `]` `[-tag` <data> `]` `[-to` <destination> `]` `[` <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
	`-fall`		Option applies to falling edge
	`-from` <source>		Source of assignment
	`-name` <name>		Assignment name
	`-remove`		Option to remove assignment
	`-rise`		Option applies to rising edge
	`-section_id` <section id>		Section id
	`-tag` <data>		Option to tag data to this assignment
	`-to` <destination>		Destination of assignment
	<value>		Assignment value
Description	Sets or removes an instance assignment. 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. 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.
Example Usage	## Specify a TSU_REQUIREMENT of 2ns from mypin to any register set_instance_assignment -from "mypin" -to * -name TSU_REQUIREMENT 2ns ## Remove the TSU_REQUIREMENT from mypin to all registers set_instance_assignment -from "mypin" -to * -name TSU_REQUIREMENT -remove ## Specify the entity to which the assignment is added, ## use the -entity option ## This is needed if the top-level entity name is other than ## that of the project name ## The following command generates a top_level entity set_instance_assignment -from "mypin" -to * -entity top_level -name TSU_REQUIREMENT 2ns
Return Value	Code Name	Code	String Return
	TCL_OK	0	INFO: Operation successful
	TCL_OK	0	WARNING: Ignored assignment: <string>. The assignment is no longer supported.
	TCL_ERROR	1	ERROR: Assignment is not an instance assignment: <string> -- it is a global assignment. Specify an instance assignment name or use the global 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: The assignment <string> is from Design Template and can't be changed/removed.
	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: 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: You must open a project before you can use this command.
	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 name: <string>. Specify a legal assignment name. To view the list of legal assignment names, run get_all_assignment_names.
	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>.