RLOCS is a read-only property that is assigned to an XDC macro object that is created by the create_macro Tcl command in the Vivado Design Suite. The RLOCS property is assigned to the macro when it is updated with the update_macro comand. Refer to the Vivado Design Suite Tcl Command Reference Guide (UG835) [Ref 13] for more information on these commands.
Like relatively placed macros (RPMs), XDC macros enable relative placement of groups of cells. Macros are similar to RPMs in many ways, yet also have significant differences:
•RPMs are defined in the RTL source files by a combination of the RLOC property and the H_SET, HU_SET, or U_SET property.
•RPMs cannot be edited in the post-synthesis design.
•Macros are created from leaf cells that are grouped together with relative placement, after synthesis, and can be edited.
•RPMs cannot be automatically converted to macros.
•RPMs are not design objects, and the XDC macro commands cannot be used on RPMs.
The RLOCS property reflects the relative placement values specified by the update_macro command, as represented by the rlocs argument:
"cell0 rloc0 cell1 rloc1 … cellN rlocN"
You can use update_macro command to change the RLOCS property assigned to an XDC macro object.
The RLOCS property is converted to an RLOC property on each of the individual cells that are part of the XDC macro. The RLOC property then functions in the same way it does for an RPM, by defining the relative placement of cells in the macro.
Architecture Support
All architectures.
Applicable Objects
•Cells (get_cells)
Values
•Cell1 RLOC1 Cell2 RLOC2 Cell3 RLOC3...: The name of a cell in the macro paired with the relative location of the cell in the macro, defined for each cell in the macro.
Syntax
Verilog and VHDL Syntax
Not applicable
XDC Syntax
The RLOCS property is indirectly defined when an XDC macro is created and populated with cells and relative locations:
XDC Example
create_macro macro1
update_macro macro1 {u1/sr3 X0Y0 u1/sr4 X1Y0 u1/sr5 X0Y1}
report_property -all [get_macros macro1]
Property Type Read-only Visible Value
ABSOLUTE_GRID bool true true 0
CLASS string true true macro
NAME string true true macro1
RLOCS string* true true u1/sr3 X0Y0 u1/sr4 X1Y0 u1/sr5
Affected Steps
•Logical to Physical Mapping
•Synthesis
•Place Design
See Also