set_logiclock (::quartus::incremental_compilation)

The following table displays information for the set_logiclock Tcl command:

Tcl Package and Version

Belongs to ::quartus::incremental_compilation 1.1

Syntax set_logiclock [-h | -help] [-long_help] [-auto_size <true|false>] [-enabled <true|false>] [-floating <true|false>] [-height <height in labs>] [-origin <chip location>] [-parent <parent region name>] [-reconfigurable <true|false>] -region <region name> [-reserved <true|false>] [-width <width in labs>]
Arguments -h | -help Short help
  -long_help Long help with examples and possible return values
-auto_size <true|false> Option to set auto-size property
-enabled <true|false> Option to set enabled property
-floating <true|false> Option to set floating property
-height <height in labs> Region height
-origin <chip location> Region origin
-parent <parent region name> Parent region
-reconfigurable <true|false> Option to set reconfigurable property
-region <region name> Region name
-reserved <true|false> Option to set reserved property
-width <width in labs> Region width
Description
Creates or changes attributes of LogicLock(TM) regions.

If the region specified by the "-region" option does 
not exist, the Quartus Prime software creates it with the 
specified properties.

Otherwise, the Quartus Prime software changes the properties 
of the region specified by the "-region" option to the 
values specified by the options. Any properties not included 
as options remain unchanged.
Example Usage
package require ::quartus::incremental_compilation

project_open my_design

## Create a region with default attributes
set_logiclock -region region_one

## Change the size of the region
set_logiclock -region region_one -height 2 -width 3 

project_close
Return Value Code Name Code String Return
  TCL_OK 0 INFO: Operation successful
  TCL_ERROR 1 ERROR: Illegal origin string. Enter a legal origin string.
  TCL_ERROR 1 ERROR: LogicLock not initialized. Initialize the LogicLock data structures using the initialize_logiclock command. The LogicLock datastructures can go out of date after changing projects, revisions, or devices; if so, use a subsequent initialize_logiclock command.
  TCL_ERROR 1 ERROR: Project has no active revision. Make sure there is an open, active revision.
  TCL_ERROR 1 ERROR: No project is currently open. Open an existing project or create a new project.
  TCL_ERROR 1 ERROR: Parent region does not exist. Enter a legal parent region string.
  TCL_ERROR 1 ERROR: Can't move region -- origin must be a LAB or ESB location. Move the region's origin to a LAB or ESB location.
  TCL_ERROR 1 ERROR: Can't change origin of region -- target device is set to Auto. Specify a specific target device.
  TCL_ERROR 1 ERROR: Can't move region -- device resources at this location do not match resources required by region's back-annotated nodes. Move the region to a location where device resources match the resources required by the region's back-annotated nodes.
  TCL_ERROR 1 ERROR: Can't create LL_EXCLUDE assignment on top-level design entity. Remove the LL_EXCLUDE assignment on the top-level entity.
  TCL_ERROR 1 ERROR: Can't lock an auto-size region -- child regions of an auto-size region must have floating locations. Specify a fixed size for the region before locking its location.
  TCL_ERROR 1 ERROR: Can't change assignment -- Quartus Prime Settings File is read-only. Remove the read-only attribute of the .qsf.
  TCL_ERROR 1 ERROR: Region exceeds bounds of target device. Specify a smaller size for the region or move the region to a location where the region is inside the bounds of the target device.
  TCL_ERROR 1 ERROR: Illegal size for region -- region cannot extend onto pins. Specify a smaller size for the region.
  TCL_ERROR 1 ERROR: Command failed. This region is not moveable because it has back-annotated routing. Delete the back-annotated contents, including the routing using logiclock_back_annotate -remove_assignments -routing -region <region_name>
  TCL_ERROR 1 ERROR: Region exceeds bounds of parent region. Resize or move child region so that it is completely contained by parent region.
  TCL_ERROR 1 ERROR: Can't rename region -- region of this name already exists. Specify a new name for the region.
  TCL_ERROR 1 ERROR: Can't rename region to an empty string. Specify a name for the region.
  TCL_ERROR 1 ERROR: Illegal size for region -- regions for current device cannot extend onto pins. Specify a smaller size for the region that does not cause the region to extend onto pins.
  TCL_ERROR 1 ERROR: Can't resize region -- target device is set to Auto. Specify a specific target device.
  TCL_ERROR 1 ERROR: Illegal size for region -- too large for current device. Specify a smaller size for the region that does not exceed the bounds of the device.
  TCL_ERROR 1 ERROR: Illegal size for region -- too big for parent region. Specify a smaller size for the region or make the parent region bigger before resizing the child region.
  TCL_ERROR 1 ERROR: Illegal size for region -- too small for back-annotated nodes. Specify a bigger size for the region.
  TCL_ERROR 1 ERROR: Illegal size for region -- too small to contain child regions. Make the parent region bigger so that it can contain the child regions, or make the child regions smaller before resizing the parent, or move the child regions so they do not extend outside the new parent boundaries.