Macro Properties Example - Macro Properties Example - 2026.1 English - UG903

Vivado Design Suite User Guide: Using Constraints (UG903)

Document ID
UG903
Release Date
2026-07-01
Version
2026.1 English
% report_property [get_macros m1]

Property	     Type	Read-only	Visible	Value
ABSOLUTE_GRID	bool	  true	     true      0
CLASS	        string    true	     true      macro
NAME	         string    true	     true      m1
RLOCS	        string*   true	     true      u2/sr0 X0Y0 u2/sr1 X0Y1

The following are descriptions of the properties.

ABSOLUTE_GRID

Boolean property that indicates whether the RLOCs use the default grid system or the Absolute Grid system. The default is false. If you run update_macro with -absolute_grid, the property is true. The Absolute Grid aligns coordinates with site RPM_X and RPM_Y properties to allow creating macros from cells placed at different site types.

CLASS

Identifies the object as a macro.

NAME

The macro object name is either the name used with create_macro or the macro name prefixed by the cell hierarchy when using read_xdc -cell.

RLOCS

The RLOCS property is a string containing the list of macro cells and their RLOC values in the same format used by the update_macro command.

Macro cells also have the following additional properties:

RLOC
The relative location (RLOC) property value of the cell.
MACRO_NAME
The name of the macro to which the cell belongs.

The following example shows how to retrieve macro properties:

% get_property RLOC [get_cells {u2/sr0 u2/sr1}] X0Y0 X0Y1

% get_property MACRO_NAME [get_cells {u2/sr0 u2/sr1}] 
m1 m1

In this example, X0Y0 X0Y1 is the output of the get_property RLOC command, and m1 m1 is the output of the get_property MACRO_NAME command.