Altera Quartus II Scripting - Manual (Page 359)

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 ] [-from ] -name
[-section_id
Options
-entity : Entity to which assignment belongs
-from : Source of the assignment (string pattern is matched using Tcl string
matching)
-name : Assignment name (string pattern is matched using Tcl string matching)
-section_id
-tag : Option to tag data to this assignment
-to : 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:
[] or [*]
The portion is a string of alphanumeric characters. The portion is an integer
greater than or equal to zero or it can be the character "*" used for string matching. Notice that the 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