Altera Quartus II Scripting - Manual (Page 323)

Chapter 3: Tcl Packages & Commands 3–193
project
© July 2013 Altera Corporation Quartus II Scripting Reference Manual
get_all_assignments
Usage
get_all_assignments [-entity <entity_name>] [-from <source>] -name <name> [-section_id
<section id>] [-tag <data>] [-to <destination>] -type
<global|instance|parameter|default>
Options
-entity <entity_name>: Entity name
-from <source>: Source name (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 name (string pattern is matched using Tcl string
matching)
-type <global|instance|parameter|default>: Option to specify the type of assignments to
return
Description
Returns a collection of all matching global, instance, parameter, or default assignment ids. To iterate
through each assignment id in this collection, use the Tcl command "foreach_in_collection".
To view details for the assignment that is associated with the assignment id, use the Tcl command
"get_assignment_info".
The "get_all_assignments" command is easier to use than the deprecated commands listed in Table 3–1 .
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:
get_all_assignments -type instance -name LOCATION -to a[0]
# To match all indices of bus "a", type:
get_all_assignments -type instance -name LOCATION -to a[*]
Table 3–1. -type Option
Value for -type Option Deprecated Tcl Command Description
default get_all_quartus_defaults Returns only default assignments
global get_all_global_assignments Returns only global assignments
instance get_all_instance_assignments Returns only instance assignments
parameter get_all_parameters Returns only parameter assignments