PLM Error Codes - 2020.2 English

Versal ACAP System Software Developers Guide (UG1304)

Document ID
UG1304
Release Date
2020-11-24
Version
2020.2 English

The following table lists the PLMI, PLM, XilLoader, and XilSecure major error codes.

Table 1. PLM Error Codes
Value Description
0x0 XPLM_SUCCESS: Success
0x1 XPLM_FAILURE: Used internally for small functions
0x2 XPLMI_TASK_INPROGRESS: Used internally to indicate task is in progress
0x100 XPLMI_ERR_DMA_LOOKUP: Error when DMA driver lookup fails
0x101 XPLMI_ERR_DMA_CFG: Error when DMA driver configuration fails
0x102 XPLMI_ERR_DMA_SELFTEST: Error when DMA Self test fails.

Error occurs when DMA is in reset, and PLM tries to initialize it.

0x103 XPLMI_ERR_IOMOD_INIT: Error when IOModule driver look up fails
0x104 XPLMI_ERR_IOMOD_START: Error when IOModule driver startup fails
0x105 XPLMI_ERR_IOMOD_CONNECT: Error when IOModule driver connection fails
0x106 XPLMI_ERR_MODULE_MAX: Error when PLMI module is not registered

Can occur when invalid CDO CMD is processed by XilPLMI

0x107 XPLMI_ERR_CMD_APIID: Error when valid module and unregistered CMD ID is processed by XilPLMI
0x108 XPLMI_ERR_CMD_HANDLER_NULL: Error when no command handler is registered by module for CDO CMD
0x109 XPLMI_ERR_CMD_HANDLER: Error returned by the CDO CMD handler

For error returned by the CMD, check the PLM minor code.

0x10A XPLMI_ERR_RESUME_HANDLER: Error returned by the CDO CMD resume handler

For error returned by the CMD, check the PLM minor code.

0x10B XPLMI_ERR_CDO_HDR_ID: Error when valid CDO header ID is not present in CDO header

Can happen when different partition type is processed as CDO

0x10C XPLMI_ERR_CDO_CHECKSUM:: Error when CDO header checksum is wrong

Can happen when CDO header is corrupted

0x10D XPLMI_ERR_UART_DEV_PM_REQ: Error when XilPM request device for UART fails

PM error code is present in PLM minor code.

0x10E XPLMI_ERR_UART_LOOKUP: Error when UART driver lookup fails
0x10F XPLMI_ERR_UART_CFG: Error when UART driver configuration fails
0x110 XPLMI_ERR_SSI_MASTER_SYNC: Error when SSI technology slave sync fails with master
0x111 XPLMI_ERR_SSIT_SLAVE_SYNC: Error when SSI technology master times out waiting for slaves sync point
0x112 XPLMI_ERR_INVALID_LOG_LEVEL: Error when invalid log level is received in Logging command
0x113 XPLMI_ERR_INVALID_LOG_BUF_ADDR: Error when invalid log buffer address is received in Logging command
0x114 XPLMI_ERR_INVALID_LOG_BUF_LEN: Error when invalid log buffer length is received in Logging command
0x115 XPLMI_ERR_IPI_CMD: Error when command execution through IPI is not supported
0x116 XPLMI_ERR_REGISTER_IOMOD_HANDLER: Error when registering IOModule Handler
0x117 XPLMI_ERR_WDT_PERIODICITY: Invalid Periodicity parameter for SetWDT command
0x118 XPLMI_ERR_WDT_NODE_ID: Invalid Node ID parameter for SetWDT command
0x119 XPLMI_ERR_WDT_LPD_NOT_INITIALIZED: LPD MIO is used for WDT but LPD is not initialized
0x200 XPLM_ERR_TASK_CREATE: Error when task create fails

This can happen when maximum tasks are created.

0x201 XPLM_ERR_PM_MOD: Error initializing the PM Module
0x202 XPLM_ERR_LPD_MOD: Error initializing the LPD modules
0x203 XPLM_ERR_EXCEPTION: Exception has occurred during PLM initialization

EAR and ESR are printed on the UART console if enabled.

0x204 XPLM_ERR_NPLL_LOCK: Unable to lock NOC PLL for master SLR devices
0x205 XPLM_ERR_STL_MOD: Error initializing the STL module
0x300 XLOADER_UNSUPPORTED_BOOT_MODE: Error for unsupported boot mode

This error occurs if invalid boot mode is selected or boot mode peripheral is not selected in the CIPS wizard.

0x302 XLOADER_ERR_IMGHDR_TBL: Multiple conditions can cause this error:
  • If image header table has the wrong checksum
  • If PLM is unable to read the image header table
0x303 XLOADER_ERR_IMGHDR: Error if image header checksum fails
0x304 XLOADER_ERR_PRTNHDR: Error if partition header checksum fails
0x305 XLOADER_ERR_WAKEUP_A72_0: Error waking up the A72-0 during handoff

Check the PLM minor code for the PM error code.

0x306 XLOADER_ERR_WAKEUP_A72_1: Error waking up the A72-1 during handoff

Check the PLM minor code for the PM error code.

0x307 XLOADER_ERR_WAKEUP_R5_0: Error waking up the R5-0 during handoff

Check the PLM minor code for the PM error code.

0x308 XLOADER_ERR_WAKEUP_R5_1: Error waking up the R5-1 during handoff.

Check the PLM minor code for PM error code.

0x309 XLOADER_ERR_WAKEUP_R5_L: Error waking up the R5-L during handoff

Check the PLM minor code for the PM error code.

0x30A XLOADER_ERR_WAKEUP_PSM: Error waking up the PSM during handoff

Check the PLM minor code for the PM error code.

0x30B XLOADER_ERR_PL_NOT_PWRUP: Error powering up the PL
0x30C XLOADER_ERR_UNSUPPORTED_OSPI: Error due to unsupported OSPI flash
0x30D XLOADER_ERR_UNSUPPORTED_OSPI_SIZE: Error due to unsupported OSPI flash size
0x30E XLOADER_ERR_OSPI_INIT: Error when OSPI driver lookup fails

This error occurs when OSPI is not selected in CIPS.

0x30F XLOADER_ERR_OSPI_CFG: Error when OSPI driver CFG fails
0x310 XLOADER_ERR_OSPI_SEL_FLASH: Error when OSPI driver is unable to select flash

Check minor code for the OSPI driver error code.

0x311 XLOADER_ERR_OSPI_READID: Error when OSPI ReadID fails
0x312 XLOADER_ERR_OSPI_READ: Error when OSPI driver read fails

Check minor code for the OSPI driver error code.

0x313 XLOADER_ERR_OSPI_4BMODE: Error when OSPI is unable to enter/exit 4B mode
0x314 XLOADER_ERR_QSPI_READ_ID: Error when QSPI read fails
0x315 XLOADER_ERR_UNSUPPORTED_QSPI: Error when QSPI flash is not supported
0x316 XLOADER_ERR_QSPI_INIT: Error when QSPI driver look up or confguration fails
0x317 XLOADER_ERR_QSPI_MANUAL_START: Error when QSPI driver manual start fails
0x318 XLOADER_ERR_QSPI_PRESCALER_CLK: Error when QSPI driver Prescalar setting fails
0x319 XLOADER_ERR_QSPI_CONNECTION: Error when invalid QSPI connection listed other than single, dual, or stacked
0x31A XLOADER_ERR_QSPI_READ: Error when QSPI driver read fails
0x31B XLOADER_ERR_QSPI_LENGTH: Error when QSPI read length is greater than flash size
0x31C XLOADER_ERR_SD_INIT: Error when SD mount fails
0x31D XLOADER_ERR_SD_F_OPEN: Error when SD file open fails

This can happen when file is not present or read from SD fails. File system error code is present in the PLM minor code.

0x31E XLOADER_ERR_SD_F_LSEEK: Error when f_seek fails while reading from SD card
0x31F XLOADER_ERR_SD_F_READ: Error while reading from SD card
0x320 XLOADER_ERR_IMG_ID_NOT_FOUND: Error when Image ID is not found in subsystem while reloading image
0x321 XLOADER_ERR_TCM_ADDR_OUTOF_RANGE: Error while loading to TCM and if address is out of range
0x322 XLOADER_ERR_CFRAME_LOOKUP: Error when CFRAME driver look up fails
0x323 XLOADER_ERR_CFRAME_CFG: Error when CFRAME driver CFG fails
0x324 XLOADER_ERR_UNSUPPORTED_SEC_BOOT_MODE: Error due to unsupported secondary boot mode
0x325 XLOADER_ERR_SECURE_METAHDR: Error when meta header secure validations fail
0X326 XLOADER_ERR_GEN_IDCODE: Error caused due to mismatch in IDCODEs
0x327 XLOADER_ERR_USB_LOOKUP: Error when USB lookup fails
0x328 XLOADER_ERR_USB_CFG: Error when USB configuration initialize fails
0x329 XLOADER_ERR_USB_START: Error when USB fails to start
0x32A XLOADER_ERR_DFU_DWNLD: Error when PDI fails to download
0x32B XLOADER_ERR_DEFERRED_CDO_PROCESS: Error occurred while processing CDO but error is deferred till whole CDO processing is completed
0x32C XLOADER_ERR_SD_LOOKUP: Error when SD look up fails
0x32D XLOADER_ERR_SD_CFG: Error when SD configuration fails
0x32E XLOADER_ERR_SD_CARD_INIT: Error when SD card init fails
0x32F XLOADER_ERR_MMC_PART_CONFIG: Error when MMC switch to user area in raw boot mode fails
0x330 XLOADER_ERR_SEM_STOP_SCAN: Error while stopping the XilSEM Scan
0x331 XLOADER_ERR_SEM_CFR_INIT: Error while starting the XilSEM Scan
0x332 XLOADER_ERR_DELAY_ATTRB: Error when both delay handoff and copy to image
0x333 XLOADER_ERR_NUM_HANDOFF_CPUS: Error when number of CPUs exceed maximum count
0x334 XLOADER_ERR_OSPI_CONN_MODE: Error when OSPI mode is not supported
0x335 XLOADER_ERR_OSPI_SEL_FLASH_CS1: Error when OSPI driver is unable to select flash CS1. Check minor code for OSPI driver error code.
0x336 XLOADER_ERR_OSPI_SDR_NON_PHY: Error when OSPI driver is unable to set the controller to SDR NON PHY mode
0x337 XLOADER_ERR_OSPI_COPY_OVERFLOW: Error when source address in OSPI copy exceeds flash size
0x338 XLOADER_ERR_SD_F_CLOSE: Error on closure of file in SD filesystem modes
0x339 XLOADER_ERR_SD_UMOUNT: Error on unmounting filesystem
0x33A XLOADER_ERR_DMA_XFER: DMA Transfer failed
0x33B XLOADER_ERR_DMA_XFER_SD_RAW: DMA Transfer failed in SD Raw
0x33C XLOADER_ERR_CONFIG_SUBSYSTEM: Error while configuring subsystem
0x33D XLOADER_ERR_COPY_TO_MEM: Error on copying image to DDR with the copy to memory attribute enabled
0x33E XLOADER_ERR_DELAY_LOAD: When the image has delay load attribute set and the boot source is SMAP, SBI, PCIE or JTAG, the image is copied to PMC RAM to free it from the SBI buffers. Errors occurred during such copies to PMC RAM is denoted using this error code
0x33F XLOADER_ERR_ADD_TASK_SCHEDULER: Error while adding task to the scheduler
0x340 XLOADER_ERR_SD_MAX_BOOT_FILES_LIMIT: Error code returned when search for bootable file crosses max limit
0x341 XLOADER_ERR_UNSUPPORTED_QSPI_FLASH_SIZE: Error when QSPI flash Size is not supported
0x342 XLOADER_ERR_PM_DEV_PSM_PROC: Failed in XPM Request Device for PM_DEV_PSM_PROC
0x343 XLOADER_ERR_PM_DEV_IOCTL_RPU0_SPLIT: Failed in XPM Device Ioctl for RPU0_0 in SPLIT mode
0x344 XLOADER_ERR_PM_DEV_IOCTL_RPU1_SPLIT: Failed in XPM Device Ioctl forRPU0_1 in SPLIT mode
0x345 XLOADER_ERR_PM_DEV_IOCTL_RPU0_LOCKSTEP: Failed to XPM Device Ioctl for RPU0_0 in LOCKSTEP mode
0x346 XLOADER_ERR_PM_DEV_IOCTL_RPU1_LOCKSTEP: Failed to XPM Device Ioctl for RPU0_1 in LOCKSTEP mode
0x347 XLOADER_ERR_PM_DEV_TCM_0_A: Failed to XPM Request Device for PM_DEV_TCM_0_A
0x348 XLOADER_ERR_PM_DEV_TCM_0_B: Failed to XPM Request Device for PM_DEV_TCM_0_B
0x349 XLOADER_ERR_PM_DEV_TCM_1_A: Failed to XPM Request Device for PM_DEV_TCM_1_A
0x34A XLOADER_ERR_PM_DEV_TCM_1_B: Failed to XPM Request Device for PM_DEV_TCM_1_B
0x34B XLOADER_ERR_PM_DEV_DDR_0: Failed to XPM Request Device for PM_DEV_DDR_0
0x34C XLOADER_ERR_PM_DEV_QSPI: Failed to XPM Request Device for PM_DEV_QSPI
0x34D XLOADER_ERR_PM_DEV_SDIO_0: Failed to XPM Request Device for PM_DEV_SDIO_0
0x34E XLOADER_ERR_PM_DEV_SDIO_1: Failed to XPM Request Device for PM_DEV_SDIo_1
0x34F XLOADER_ERR_PM_DEV_USB_0: Failed to XPM Request Device for PM_DEV_USB_0
0x350 XLOADER_ERR_PM_DEV_OSPI: Failed to XPM Request Device for PM_DEV_OSPI
0x600 XLOADER_ERR_INIT_GET_DMA: Failed to get DMA instance at time of initialization
0x601 XLOADER_ERR_INIT_INVALID_CHECKSUM_TYPE: Only SHA3 checksum is supported
0x602 XLOADER_ERR_INIT_CHECKSUM_COPY_FAIL: Failed when copying checksum from flash device
0x603 XLOADER_ERR_INIT_AC_COPY_FAIL: Failed when copying AC from flash device
0x604 XLOADER_ERR_INIT_CHECKSUM_INVLD_WITH_AUTHDEC: Failed as checksum was enabled with authentication and encryption enabled
0x605 XLOADER_ERR_DMA_TRANSFER: DMA Transfer failed while copying
0x606 XLOADER_ERR_IHT_AUTH_DISABLED: Authentication is not enabled for Image Header table
0x607 XLOADER_ERR_IHT_GET_DMA: Failed to get DMA instance for IHT authentication
0x608 XLOADER_ERR_IHT_COPY_FAIL: Failed when copying IHT AC from flash device
0x609 XLOADER_ERR_IHT_HASH_CALC_FAIL: Failed to calculate hash for IHT authentication
0x60A XLOADER_ERR_IHT_AUTH_FAIL: Failed to authenticate IHT
0x60B XLOADER_ERR_HDR_COPY_FAIL: Failed when copying IH/PH from flash device
0x60C XLOADER_ERR_HDR_AES_OP_FAIL: Failed due to AES init or Decrypt init or key selection failure
0x60D XLOADER_ERR_HDR_DEC_FAIL: Failed to decrypt image header/partition
0x60E XLOADER_ERR_HDR_AUTH_FAIL: Failed to authenticate image header/partition
0x60F XLOADER_ERR_HDR_NOT_SECURE: Neither authentication nor encryption is enabled for image header/partition
0x610 XLOADER_ERR_HDR_GET_DMA: Failed to get DMA instance for image header/partition authentication/decryption
0x611 XLOADER_ERR_HDR_HASH_CALC_FAIL: Failed to calculate hash for image header/partition authentication
0x612 XLOADER_ERR_HDR_NOT_ENCRYPTED: Image header/partition header is not encrypted
0x613 XLOADER_ERR_HDR_AUTH_DISABLED: Authentication disabled for image header/partition header
0x614 XLOADER_ERR_SEC_IH_READ_VERIFY_FAIL: Failed to read image header and verify checksum
0x615 XLOADER_ERR_SEC_PH_READ_VERIFY_FAIL: Failed to read partition header and verify checksum
0x616 XLOADER_ERR_PRTN_HASH_CALC_FAIL: Hash calculation failed for partition authentication
0x617 XLOADER_ERR_PRTN_AUTH_FAIL: Partition authentication failed
0x618 XLOADER_ERR_PRTN_HASH_COMPARE_FAIL: Partition hash comparison failed
0x619 XLOADER_ERR_PRTN_DECRYPT_FAIL: Partition decryption failed
0x61A XLOADER_ERR_AHWROT_EFUSE_AUTH_COMPULSORY: PPK Programmed but eFUSE authentication is disabled
0x61B XLOADER_ERR_AHWROT_BH_AUTH_NOT_ALLOWED: PPK Programmed and BH authentication is enabled
0x61C XLOADER_ERR_AUTH_EN_PPK_HASH_ZERO: PPK not programmed and authentication is enabled
0x61D XLOADER_ERR_SHWROT_ENC_COMPULSORY: Encryption is disabled
0x61E XLOADER_ERR_KAT_FAILED: Known answer tests (KAT) failed
0x61F XLOADER_ERR_DATA_COPY_FAIL: Data copy to internal memory failed
0x620 XLOADER_ERR_METAHDR_LEN_OVERFLOW: Failed when total size is greater than Metahdr length
0x621 XLOADER_ERR_AUTH_JTAG_EFUSE_AUTH_COMPULSORY: Jtag Authentication failed when PPK not programmed
0x622 XLOADER_ERR_AUTH_JTAG_DISABLED: Jtag Authentication disable efuse bit is set
0x623 XLOADER_ERR_AUTH_JTAG_PPK_VERIFY_FAIL: Jtag Authentication failed when verification of PPK
0x624 XLOADER_ERR_AUTH_JTAG_SIGN_VERIFY_FAIL: Jtag Authentication failed when verification of signature failed
0x625 XLOADER_ERR_AUTH_JTAG_EXCEED_ATTEMPTS: Jtag Authentication failed more than once
0x626 XLOADER_ERR_AUTH_JTAG_GET_DMA: Failed to get DMA instance for JTAG authentication
0x627 XLOADER_ERR_AUTH_JTAG_HASH_CALCULATION_FAIL: Hash calculation failed before signature verification
0x628 XLOADER_ERR_AUTH_JTAG_DMA_XFR: Failed to get Auth Jtag data with DMA transfer
0x2XYZ
  • 0x2 indicates failure in CDO command
  • X indicates command module.
    • 1 - PLM
    • 2 -PM
    • 3 - XilSEM
    • 7 - Loader
    • 8 - Error
  • YZ indicate handler ID of the CDO command.