Intel® Agilex™ Configuration User Guide

ID 683673
Date 5/30/2022

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 42.  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, ensures 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.

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.


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.


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.

For RSU: Configure the device with RSU image.

80 QSPI_HW_ERROR Check the QSPI interface signal integrity and to 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.

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.