Passcode Services (For PolarFire SoC FPGA Only)

The following table lists all the Passcode system services with their command values, description, and return status code.

Table 1. Passcode System Services
System Service Name SERVICECMD in Hexadecimal Description Return Status Code
Generate OTP Service 7A Sets up the device to receive a one-time passcode.
  • 0: Success
  • 1: SECERR

    (Blocked by Device security.)

  • 2: PROTOCOLERR

    (If an invalid key mode is specified or generation of the nonce fails, the returned nonce is 0. The operation is aborted and generates the tamper event PASSCODE_FAIL.)

Match OTP Service 7B This service is the second part of the one-time passcode protocol.
  • 0: Success
  • 1: PROTOCOLERR

    (If service fails, all unlocked passcodes are re-locked and generates tamper event PASSCODE_FAIL.)

  • 2: MISMATCHERR

    (If service fails, all unlocked passcodes are re-locked and generates tamper event PASSCODE_FAIL.)

Unlock Debug Passcode Service 7C Attempts to match the user debug pass code using the key loaded into the mailbox.
  • 0: Success
  • 1: SECERR

    (Blocked by Device security. Occurs when the lock is active or the permanent lock is set.)

  • 2: PASSCODE_ERR

    (If service fails, all unlocked passcodes are re-locked and generates tamper event PASSCODE_FAIL.)

One Way Passcode Service 7D

Provides a mechanism for overriding the software debug lock SWL_DEBUG without requiring any interaction with an external intelligence.

  • 0: Success
  • 1: OWPERR

    (If service fails, all the unlocked passcodes are re-locked and generates tamper event PASSCODE_FAIL.)