Upgrade ImageStore - 2023.1 English

Versal Adaptive SoC System Software Developers Guide (UG1304)

Document ID
UG1304
Release Date
2023-05-16
Version
2023.1 English

Add Image Store

The Image Store can be upgraded during runtime with any partial PDI address present in the DDR memory controller. The PLM maintains a list of PDI IDs . You can add or remove any PDI using the corresponding PDI ID in the DDR memory controller to or from the list through IPI commands.

While restarting an image, the PLM checks if there are any entries in the list. If there are any entries, it goes to the latest PDI in the list and tries to restart an image from that PDI. If a failure occurs, fallback happens to the next possible image in the list, and if no more entries are left in the PDI list, the PLM tries to restore the image from the DDR memory locations mentioned in the BootPDI as CopyToMem addresses.

The following are the ImageStore PDI commands:

Table 1. Add Image Store PDI Command Structure
Structure
Reserved[31:25]=0 Security Flag[24] Length[23:16]=4 XilLoader=7 CMD_ADD_IMG_STORE_PDI=9
PDI ID
High PDI address
Low PDI address
PDI Size (In words)

This command adds PDI address to the list of Image Store PDIs that are maintained by the PLM. During restore or reload of a image, the PLM first checks this dynamically added list of PDIs to get the required image. In case of any failure, it falls back to the next possible PDI. If a valid entry is not present, it uses Boot PDI, which is the first entry in the list.

The response structure is as follows:

Table 2. Add Image Store PDI Response Structure
Structure
Status

Remove Image Store

Table 3. Remove Image Store PDI Command Structure
Structure
Reserved[31:25]=0 Security Flag[24] Length[23:16]=1 XilLoader=7 CMD_ADD_IMG_STORE_PDI=10
PDI ID
High PDI address
Low PDI Address

This command removes a PDI from the list of Image Store PDIs that are maintained by the PLM. During restoring or reloading an image, the PLM first checks this dynamically added list of PDIs to get the required image. In case of any failure, it falls back to the next possible PDI. If a valid entry is not present, it uses Boot PDI, which is the first entry in the list.

The response structure is as follows:

Table 4. Remove Image Store PDI Response Structure
Structure
Status