Altera Quartus II Scripting - Manual (Page 367)

Chapter 3: Tcl Packages & Commands 3–237
project
© July 2013 Altera Corporation Quartus II Scripting Reference Manual
set_instance_assignment
Usage
set_instance_assignment [-comment <comment>] [-disable] [-entity <entity_name>] [-fall]
[-from <source>] -name <name> [-remove] [-rise] [-section_id <section id>] [-tag
<data>] [-to <destination>] <value>
Options
-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 II Settings File
(.qsf) unless you explicitly call one of the following two Tcl commands:
■ export_assignments
■ 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®II 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
## 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