AVED Deployment Archive¶

The AVED deployment archive contains a prebuilt and verified AVED design, which includes the xbtest IP along with all the host SW needed to run the xbtest application.

This allows AMD Alveo™ card users to download the Alveo Versal™ example design onto their card and run the xbtest verification/qualification tests.

AVED Deployment Archive Contents¶

The AVED development archive is ZIP file whose name references the AVED design and a release number.

<VBNV>_<application name>_<release>.zip

e.g. amd_v80_gen5x8_24.1_xbtest_stress_20241002.zip

Once unzipped, the contents are placed into a folder, which has the same name format as the name of the ZIP.

amd_v80_gen5x8_24.1_xbtest_stress_20241002

├── aved_install.sh
├── component_version.json
├── design.pdi
├── flash_setup
│   ├── fpt_setup_amd_v80_gen5x8_24.1_20241002.pdi
│   ├── v80_initialization.pdi
│   └── versal_change_boot_mode.tcl
├── static.xsa
├── sw_packages
│   ├── ami_2.3.0-0.0bab29e5.20240926_amd64_20.04.deb
│   ├── ami_2.3.0-0.0bab29e5.20240926_amd64_22.04.deb
│   ├── ami-2.3.0-0.0bab29e5.20240926.x86_64_8.x.rpm
│   ├── xbtest_7.0-5009311_amd64_20.04.deb
│   ├── xbtest_7.0-5009311_amd64_22.04.deb
│   └── xbtest-7.0-5009311.x86_64_8.x.rpm
├── version.json
└── xbtest
    ├── metadata
    │   ├── user_metadata.json
    │   ├── xbtest_metadata.json
    │   └── xbtest_pfm_def.json
    └── test
        ├── gtm_prbs.json
        ├── gtyp_prbs.json
        ├── memory.json
        ├── mmio.json
        ├── power.json
        ├── stress.json
        └── verify.json

AVED Install script¶

aved_install.sh is a bash script used to install the AVED deployment package onto the Host. See the Installing the Deployment package onto the Host Server section for more details.

Design PDI¶

design.pdi is a PDI (programmable device image) of AVED plus the xbtest IP. This can be downloaded to the Versal device via JTAG, or written to one of the partitions (defined in the FPT) in the OSPI flash, in order to boot from flash.

Flash Setup directory¶

The flash setup directory contains files which can be used to recover the OSPI Flash if its contents have become corrupted. A corrupted OSPI can prevent a Versal device from booting and these files provide a method of restoring the flash to a known good point. See AVED - Device Programming and AVED Updating FPT Image in Flash for more details.

AMI/AMC expect a FPT to be present in the OSPI to organize how different images are stored in flash. The FPT setup PDI is a flash image which contains the FPT along with the AVED xbtest design in the first PDI partition defined in the FPT. When recovering/setting up the flash with HW Manager, this image should be selected as the configuration PDI.
HW manager requires an initialization PDI to be downloaded to the Versal device first before transferring the desired PDI to Flash. A prebuilt initialization PDI for the specific Alveo board being targeted is included in the flash_setup directory (i.e., v80_initialization.pdi).
versal_change_boot_mode.tcl is a script which can be run on XSDB which will change the boot mode of the Versal device to JTAG. This is needed when there isn’t a valid image on the OSPI flash, and by changing the JTAG Mode, HW Manager can then be used to write a valid image to flash.

Static XSA¶

static.xsa is a XSA (Xilinx support archive) that is built from the AVED source code and the xbtest IP. Its primary use is as an input to Vitis™ when building FW applications. While not required to run the xbtest application, this xsa could be useful for developers who want to rebuild the AMC FW.

SW Packages directory¶

The SW packages directory contains RPM and DEB packages for installation of AMI and xbtest applications onto the Host server. These packages are installed while running the AVED_install.sh script.

Component version JSON¶

component_version.json is a JSON file containing version information related to the AVED AMI software, AMC firmware, and SMBus IP driver in the deployment archive.

Version JSON¶

version.json is a JSON file containing version information related to the AVED xbtest design in the deployment archive.

Xbtest directory¶

The JSON files in the xbtest directory contain metadata which is consumed by the xbtest software application running on the Host.

Page Revision: v. 34