validate_hw_platform - 2023.2 English

Vivado Design Suite Tcl Command Reference Guide (UG835)

Document ID
Release Date
2023.2 English

Validate the specified harware platform


validate_hw_platform [‑verbose] [‑quiet] [<file>]


The name of the shell file.


Name Description
[-verbose] Dump verbose information
[-quiet] Ignore command errors
[<file>] Xilinx Shell Archive file Values: Path to shell file.


Vitis, Platform


Validate a Xilinx™ support archive (XSA) file to ensure it has the required content for the platform.

This command returns information related to the validation of the XSA, or returns an error if it fails.


-verbose - (Optional) Provide detailed information related to the XSA and the validation process.

-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.

<file> - (Optional) Specify the path and file name of the XSA file.

Note: If the path is not specified as part of the file name, the tool will search for the specified file in the current working directory and then in the directory from which the tool was launched.


The following example validates the specified XSA, returning verbose information related to the platform contents:

validate_hw_platform C:/Data/zc706.xsa -verbose