move_pblock - 2025.2 English - UG835

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2025-11-20
Version
2025.2 English

Description

Moves the specified Pblock only if the Pblock is created using the create_pblock command.

A Pblock consists of a group of cells that can be assigned to one or more independent or overlapping rectangles. Using the various arguments, you can move the rects of a Pblock from one location to another.

Arguments

-from - Specifies the source Pblock region range.

-to - Specifies the destination Pblock region range.

Note: Use -from and -to options together as a pair, and ensure to specify a site or range of sites to relocate from one location to another. Multiple -from and -to pairs combinations are allowed in a single command.
-locs - (Optional) Specifies configuration of the placed logic in the Pblock once it is is moved. Valid values are:
  • keep_all - Retains locations of all placed cells as per the current placement. This is the default setting when -locs option is not specified. Logic that is placed outside of the new Pblock location is no longer assigned to the Pblock.
  • keep_only_fixed - Specifies that only user-placed logic (fixed) is preserved and unplace any unfixed placed logic.
  • keep_none - Unplace all logic.
  • move - Specifies that the locations of all placed cells in the Pblock move relative to the coordinates of the new Pblock location.
  • move_unfixed - Specifies that only the unfixed placed elements is moved. Does not move the logic placed by the user (fixed).
  • trim - Specifies that logic that falls outside of the new Pblock location becomes unplaced. Any placed logic that still falls inside of the Pblock boundary does not change.
  • trim_unfixed - Trim only the unfixed placed logic.

pblock- (Required) Specifies the Pblock to move.

Examples

The following example moves the specified Pblock from one clock region range to a different clock region range and unplaces the cells that are no longer placed within the new boundaries.

-to CLOCKREGION_S0X2Y4:CLOCKREGION_S0X3Y6 -locs trim