Remove_all_instance_assignments, Usage, Options – Altera Quartus II Scripting User Manual
Page 359: Description, Remove_all_instance_assignments –229
Chapter 3: Tcl Packages & Commands
3–229
project
© July 2013
Altera Corporation
Quartus II Scripting Reference Manual
remove_all_instance_assignments
Usage
remove_all_instance_assignments [-entity <entity_name>] [-from <source>] -name <name>
[-section_id <section id>] [-tag <data>] [-to <destination>]
Options
-entity <entity_name>: Entity to which assignment belongs
-from <source>: Source of the assignment (string pattern is matched using Tcl string
matching)
-name <name>: Assignment name (string pattern is matched using Tcl string matching)
-section_id <section id>: Section id
-tag <data>: Option to tag data to this assignment
-to <destination>: Destination of the assignment (string pattern is matched using Tcl
string matching)
Description
Removes all matching instance assignment values.
The "-name" option is not case sensitive. The "-to" and "-from" options are case sensitive.
These options can take string patterns containing special characters from the set "*?\[]" as values. The
values are matched using Tcl string matching. Note that bus names are automatically detected and do not
need to be escaped. Bus names have the following format:
<bus name>[<bus index>] or <bus name>[*]
The <bus name> portion is a string of alphanumeric characters. The <bus index> portion is an integer
greater than or equal to zero or it can be the character "*" used for string matching. Notice that the <bus
index> is enclosed by the square brackets "[" and "]". For example, "a[0]" and "a[*]" are supported bus
names and can be used as follows:
# To match index 0 of bus "a", type:
remove_all_instance_assignments -name LOCATION -to a[0]
# To match all indices of bus "a", type:
remove_all_instance_assignments -name LOCATION -to a[*]
All other uses of square brackets must be escaped if you do not intend to use them as string patterns. For
example, to match indices 0, 1, and 2 of the bus "a", type:
remove_all_instance_assignments -name LOCATION -to "a[escape_brackets
\[]\[0-2\][escape_brackets \]]"
For more information about escaping square brackets, type "escape_brackets -h".
This Tcl command reads the instance assignments found in the Quartus II Settings File (.qsf) and removes
this data based on the values specified by the "-name", "-from", and "-to" options.
Certain sections in the .qsf can appear more than once. For example, because there may be more than one
clock used in a project, there may be more than one CLOCK section each containing its own set of clock
assignments. To uniquely identify sections of this type, a <Section Id> is used. <Section Id> can be one of
three types. It can be the same as the revision name, or it can be some unique name. The following is a list
of sections requiring a <Section Id> and the associated <Section Id> description: