refresh_hw_ddrmc - 2024.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
UG835
Release Date
2024-05-30
Version
2024.1 English

Refresh the status of the current hardware object. Inputs need to be any DDRMC object. At least one object is required. If properties are specified, but do not exist in the object, those properties will not be refreshed.

Syntax

refresh_hw_ddrmc [‑regexp] [‑properties <args>] [‑quiet] [‑verbose]
    <hw_objects>

Usage

Name Description
[-regexp] Properties list contains full regular expressions
[-properties] List of properties to refresh Default: All properties in object
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
<hw_objects> hardware DDRMC objects

Categories

Hardware

Description

Refreshes the in-memory contents of all of the properties, or specified properties, of the specified Versal DDR Memory Controller (DDRMC) objects with values read from the current hardware device.

The refresh command takes the values from the DDRMC object implemented on the hardware device, and populates them into the appropriate properties of the hw_ddrmc object in the Vivado™ hardware manager. If only certain properties are specified, then those properties are updated from the hw device.

At least one object is required. If properties are specified that do not exist in the object, that property will not be refreshed.

This command updates the properties on the hw_ddrmc object, but otherwise returns nothing if successful. The command returns an error if it fails.

Arguments

-regexp - (Optional) The list of properties to refresh is defined using regular expression.

-properties <args> - (Optional) Refresh the specified property or properties of the hw_ddrmc object. As a default behavior, if no properties are specified, all properties of the specified object or objects will be refreshed from the current values on the hardware device.

Tip: If a non-existent property is specified, that property is ignored.
-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> - (Required) Specifies the specific DDRMC objects (hw_ddrmc) to run.

Examples

The following example refreshes all of the properties of the DDRMC objects in the Vivado hardware manager with the properties from the current hw_device:

refresh_hw_ddrmc -properties {PHY_RANKS} [lindex [get_hw_ddrmcs] 3]