Write the Xilinx Shell Archive for the current design
Syntax
write_hw_platform [‑fixed] [‑force] [‑include_bit] [‑include_sim_content]
[‑minimal] [‑hw] [‑hw_emu] [‑quiet] [‑verbose] [<file>]
Returns
The name of the Shell file
Usage
Name | Description |
---|---|
[-fixed]
|
Write fixed Shell. |
[-force]
|
Overwrite existing Xilinx Shell Archive file |
[-include_bit]
|
Include bit file(s) in the Shell. |
[-include_sim_content]
|
Include simulaton files in the Shell. |
[-minimal]
|
Add only minimal files in the Shell. |
[-hw]
|
Write shell for use in hardware only. |
[-hw_emu]
|
Write shell for use in hardware emulation only. |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<file>]
|
Device Support Archive file Values: A filename with alphanumeric characters and .xsa extension. |
Description
Writes a Xilinx support archive (XSA) of the current design for use as a hardware platform.
All platforms are dynamically implemented during compilation, meaning that the accelerator logic coming is implemented along with some or all of the logic contained in the hardware platform design. The XSA represents the required portion of the hardware platform. The hardware platform design used to create a XSA consists of a Vivado IP integrator subsystem design with all the required board interface IP cores configured and connected to the device I/Os. The Vivado project must also include several required XSA and PFM properties needed to define the XSA.
This command reports the name of the XSA file written, or returns an error if it fails.
Arguments
-fixed
- (Optional) Overwrite a fixed shell XSA, which enables the platform for use in the software development flow, but not for use in acceleration.
-force
- (Optional) Overwrite the XSA file if it already exists.
-include_bit
- (Optional) Include the bitstream for the current design in the XSA. By default MCS files are created by write_hw_platform
, and the bitstreams are discarded. When this options is specified, bitstream files are preserved for use in debugging the platform.
-include_emulation
- (Optional) This option exports data needed to support hardware emulation at the same time that the XSA is created. This option requires special features of the hardware platform, and is not generally recommended.
-minimal
- (Optional) Add only those files in the XSA that are required to run the Vitis flow. Do not add anything extra. When this option is specified the write_hw_platform
command ignores other options that add content to the XSA, such as the -include_bit
and -include_emulation
options.
-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.
-verbose
- (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config
command.Examples
write_hw_platform -force C:/Data/zc702.xsa