refresh_hw_target - 2023.2 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2023.2 English

Refresh a hardware target


refresh_hw_target [‑force_poll] [‑quiet] [‑verbose] [<hw_target>]


Name Description
[-force_poll] Force poll of all targets
[-quiet] Ignore command errors
[-verbose] Suspend message limits during command execution
[<hw_target>] hardware target




Refresh the connection to the specified hardware target on the current hardware server, and reload the hw_target object in the Hardware Manager of the AMD Vivado™ Design Suite. If no hw_target object is specified, the current_hw_target will be refreshed.

The hardware target is a system board containing a JTAG chain of one or more devices that you can program with a bitstream file, or use to debug your design. Connections between hardware targets on the system board and the Vivado Design Suite are managed by the AMD hardware server application, and the connect_hw_server command. Refer to Vivado Design Suite User Guide: Programming and Debugging (UG908) for a list of supported JTAG download cables and devices.

Each hardware target can have one or more AMD devices to program, or to use for debugging purposes. The current device is specified or returned by the current_hw_device command. After specifying the current hardware target, you can open the connection through the hardware target, to the AMD FPGA using the open_hw_target command.

refresh_hw_target scans the devices on the hardware target and creates, deletes, or updates the hw_device objects available through the target. Available devices are returned using the get_hw_devices command.

This command returns a transcript of the refresh process, or returns an error if it fails.


-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_target> - (Optional) Specify the hw_target object to refresh the connection to. The hw_target must be specified as an object as returned by the get_hw_targets or current_hw_target commands. If no target is specified, the Vivado tool will refresh the connection to the current_hw_target.


The following example refreshes the current hardware target: