Intel® Quartus® Prime Pro Edition User Guide: Scripting

ID 683432
Date 10/04/2021

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents
Give Feedback set_location_assignment (::quartus::project)

The following table displays information for the set_location_assignment Tcl command:

Tcl Package and Version

Belongs to ::quartus::project

Syntax set_location_assignment [-h | -help] [-long_help] [-comment <comment> ] [-disable] [-fall] [-remove] [-rise] [-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
-fall Option applies to falling edge
-remove Option to remove assignment
-rise Option applies to rising edge
-tag <data> Option to tag data to this assignment
-to <destination> Destination of assignment
<value> Assignment value

Sets or removes a location assignment. Valid location assignments, and settings for those assignments for your design are determined by the target device, package type, and pin count. To explore possible assignments and settings for your design and device, in the Quartus Prime Assignment Editor, specify Location for Assignment Name, and then click Browse in the Value column. In the Location dialog box, explore assignable device resources in the Element list, and then use the lists that appear (based on the element selected) to determine locations of resources that can be specified as the value for the 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.

Example Usage
set_location_assignment -to dst LOC
Return Value Code Name Code String Return
TCL_OK 0 INFO: Operation successful
TCL_ERROR 1 ERROR: Can't find active revision name. Make sure there is an open, active revision name.
TCL_ERROR 1 ERROR: The assignment <string> is from Design Template and can't be changed/removed.