Upgrade ImageStore - 2021.2 English

Versal ACAP System Software Developers Guide (UG1304)

Document ID
UG1304
Release Date
2021-10-27
Version
2021.2 English

Add ImageStore

The ImageStore can be upgraded during run-time with any partial PDI address present in the DDR memory controller. The PLM maintains a list of PDIs (PDI addresses). You can add or remove any PDI address 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 ImageStore PDI Command Structure
Structure
Reserved[31:24]=0 Length[23:16]=2 XilLoader=7 CMD_ADD_IMG_STORE_PDI=9
High PDI Address
Low PDI Address

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 ImageStore PDI Response Structure
Structure
Status

Remove ImageStore

Table 3. Remove ImageStore PDI Command Structure
Structure
Reserved[31:24]=0 Length[23:16]=2 XilLoader=7 CMD_ADD_IMG_STORE_PDI=10
High PDI Address
Low PDI Address

This command removes a PDI address 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 ImageStore PDI Response Structure
Structure
Status