Device Configuration User Guide: Agilex™ 5 FPGAs and SoCs

ID 813773
Date 4/01/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

5.3.3. Error Code Recovery

The table below describes possible steps to recover from an error code. Error recovery depends on specific use case.
Table 46.  Error Code Recovery for Known Error Codes
Value Error Code Response Error Code Recovery
4 INVALID_COMMAND_PARAMETERS Resend the command header or header with arguments with corrected parameters.

For example, ensure that the length field setting in header is sent with the correct value.

6 COMMAND_INVALID_ON_SOURCE Resend the command from valid source such as JTAG, HPS, or core fabric.
8 CLIENT_ID_NO_MATCH Wait for the client who opened the access to quad SPI to complete its access and then closes the exclusive access to quad SPI.
9 INVALID_ADDRESS

Possible error recovery steps:

For QSPI operation:
  • Send command with a valid chip select.
  • Send command with a valid QSPI flash address.

For RSU: Send command with a valid start address of the factory image or application.

B TIMEOUT

Possible recovery steps:

For QSPI operation: Check signal integrity of QSPI interfaces and attempt command again.

For HPS restart operation: Retry to send the command again.

C HW_NOT_READY

Possible recovery steps:

For QSPI operation:
  • Reconfigure the device via source.
  • Ensure that IP used to build your design allows access to the QSPI flash.
  • Check for QSPI_SET_CS commands after every QSPI_OPEN request.

For RSU: Configure the device with RSU image.

80 QSPI_HW_ERROR Check the QSPI interface signal integrity and ensure the QSPI device is not damaged.
81 QSPI_ALREADY_OPEN Client already opened QSPI. Continue with the next operation.
82 EFUSE_SYSTEM_FAILURE Attempt reconfiguration or power cycle. If error persists after reconfiguration or power cycle, the device may be damaged and unrecoverable.
100 NOT_CONFIGURED Send a bitstream that configures the HPS.
1FF ALT_SDM_MBOX_RESP_DEVICE_ BUSY

Possible error recovery steps:

For QSPI operation: Wait for ongoing configuration or other client to complete operation.

For RSU: Reconfigure device to recover from internal error.

For HPS restart operation: Wait for reconfiguration via HPS or HPS Cold Reset to complete.