refresh_hw_softmc - 2022.1 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2022.1 English

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


refresh_hw_softmc [‑regexp] [‑properties <args>] [‑quiet] [‑verbose]


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 Soft MC objects




Refreshes the in-memory contents of all of the properties, or specified properties, for the specified Versal Soft Memory Controller (SoftMC) objects with values read from the current hardware device. The refresh command takes the values from the SoftMC object implemented on the hardware device, and populates them into the appropriate properties of the hw_softmc 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 as arguments, but do not exist in the object, those properties will not be refreshed. This command updates the properties on the hw_softmc object, but otherwise returns nothing if successful. The command returns an error if it fails.


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

-properties <arg> - (Optional) Refresh the specified property or properties of the hw_softmc 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.
Note: 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 Soft MC objects (hw_softmc) to run.


The following example refreshes all of the properties on the fourth SoftMC object found in the Vivado hardware manager with the properties from the current hw_device:
refresh_hw_softmc [lindex [get_hw_softmcs] 3]