report_hw_ddrmc - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2024.1 English

Formatted report on Versal integrated and soft Memory Controllers' (DDRMCs) memory configurations, calibration status, stages, and window margins data.


report_hw_ddrmc [‑file <arg>] [‑append] [‑return_string] [‑quiet]
    [‑verbose] <hw_objects>


Name Description
[-file] File name (including full path) to output the report results to
[-append] Set this option to append the report results to a file
[-return_string] Set this option to have report results returned as a string
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<hw_objects> Hardware DDRMC objects


Report, Hardware


Report formatted information on memory IP hardware configuration, calibration, and margin. Does not include the graphical margin scan plots that are available within the AMD Vivado™ logic analyzer, or Vivado Lab Edition.

In the Vivado tools, Versal memory controllers implemented into a design are associated with hw_ddrmc objects. These hw_ddrmc objects let you verify the calibration, read, and write window margins in your memory interface design. You can use the hardware manager GUI to check the calibration status, verify the read margin for both rising and falling edges of the clock, and write margin for both simple and complex patterns. You can also use an ILA and VIO core to verify the data integrity for the read and write operations.

This command returns the reported data, or returns an error if it fails.


-file <arg> - (Optional) Write the report into the specified file.

Note: If the path is not specified as part of the file name, the file will be written into the current working directory, or the directory from which the tool was launched.

-append - (Optional) Append the output of the command to the specified file rather than overwriting it.

Note: The -append option can only be used with the -file option.

-return_string - (Optional) Directs the output to a Tcl string rather than to the standard output. The Tcl string can be captured by a variable definition and parsed or otherwise processed.

Note: This argument cannot be used with the -file option.
-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
Note: Any errors encountered on the command-line, while launching the command, will be returned. Only errors occurring inside the command will be trapped.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
Note: Message limits can be defined with the set_msg_config command.

<hw_objects> - (Optional) Inputs can only be an hw_ddrmc objects, as returned by the get_hw_ddrmcs command.


The following example generates the report on the hw_ddrmc objects and outputs them to the text file specified:

report_hw_ddrmc -file C:/Data/ddrmc_report.txt [get_hw_ddrmcs]