Memory Debug: Tcl Usage - 1.0 English

Versal Adaptive SoC Programmable Network on Chip and Integrated Memory Controller 1.0 LogiCORE IP Product Guide (PG313)

Document ID
PG313
Release Date
2023-11-01
Version
1.0 English

The following Tcl commands are available from the Vivado Tcl Console when connected to the hardware in Hardware Manager.

get_hw_ddrmcs
This command returns a list of all the integrated memory controllers. Use this command with ‘lindex’ to select an item in the list.
refresh_hw_device
This command refreshes the whole device and all debug cores if no target is provided.
report_property
This command displays all the properties for a given target.

For example, to report all of the properties for the second enabled DDRMC:

report_property [lindex [ get_hw_ddrmcs] 1 ]
Note: The memory controller numbering in Hardware Manager starts from 1, but the Tcl lindex command starts from 0. If there are two enabled DDRMCs, their index numbers will be 0 and 1, regardless of their physical location on the adaptive SoC device.

An additional method to display the DDRMC details is to use the DISPLAY_NAME property with the report_property command. The example below shows how to index a DDRMC based on the name seen in the hardware manager. It also includes the option to dump the DDRMC properties directly to a text file. The DDRMC DISPLAY_NAME is shown under the Adaptive SoC device enumerated on the debug chain.

report_property -file [unique_filename].txt [get_hw_ddrmcs -filter {DISPLAY_NAME == DDRMC_x}]
report_hw_ddrmc
This command provides a formatted text output summarizing data that is provided in the GUI.

Following is an example of the output.

Figure 1. report_hw_ddrmc