The actual error codes received from SAM. These codes are for reference purpose only. All the interfaces will return codes mentioned in Mapped Codes and not these codes. More...

Collaboration diagram for ErrorCode_SAM:

Macros
#define	PHHAL_HW_SAM_RET_CODE_HW_EEPROM 0x6400U
	SAM Status - EEPROM busy, access collision, memory range cannot be mapped, execution error. More...

#define	PHHAL_HW_SAM_RET_CODE_HW_RC5XX 0x6401U
	SAM Status - Reader IC interface error. More...

#define	PHHAL_HW_SAM_RET_CODE_KEY_CREATE_FAILED 0x6501U
	SAM Status - Key creation failure. More...

#define	PHHAL_HW_SAM_RET_CODE_KEY_REF_NO_INVALID 0x6502U
	SAM Status - Key reference number invalid. More...

#define	PHHAL_HW_SAM_RET_CODE_KEY_KUC_NO_INVALID 0x6503U
	SAM Status - Key usage counter number invalid. More...

#define	PHHAL_HW_SAM_RET_CODE_HW_EE_HIGH_VOLTAGE 0x6581U
	SAM Status - EEPROM high voltage failure; SAM permanently disabled. More...

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_LENGTH_LC 0x6700U
	SAM Status - Wrong length of the APDU or wrong LC byte. More...

#define	PHHAL_HW_SAM_RET_CODE_INCOMPLETE_CHAINING 0x6883U
	SAM Status - Final chained command expected; running command aborted, new command ignored Equivalent mapped error code will be PHHAL_HW_SAM_ERR_INCOMPLETE_CHAINING.

#define	PHHAL_HW_SAM_RET_CODE_COMMAND_CHAINING_NOT_SUPPORTED 0x6884U
	SAM Status - [If MFP command] Command-chaining not supported Equivalent mapped error code will be PHHAL_HW_SAM_ERR_COMMAND_CHAINING_NOT_SUPPORTED.

#define	PHHAL_HW_SAM_RET_CODE_UNMATCHING_PCD_PD 0x6982U
	SAM Status - [If AuthenticateFirst] Un-matching PCD/PD capabilities Equivalent mapped error code will be PHHAL_HW_SAM_ERR_UNMATCHING_PCD_PD.

#define	PHHAL_HW_SAM_RET_CODE_KEY_INTEGRITY_ERROR 0x6984U
	SAM Status - One of the following. More...

#define	PHHAL_HW_SAM_RET_CODE_COND_USE_NOT_SATISFIED 0x6985U
	SAM Status - Conditions of use not satisfied. More...

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_COMMAND_NOT_ALLOWED 0x6986U
	SAM Status - Command not allowed. More...

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_PARAMS_FOR_INS 0x6A80U
	SAM Status - Unexpected RFU bit(s) value(s) in data field parameter. More...

#define	PHHAL_HW_SAM_RET_CODE_KEY_VERSION_INVALID 0x6A82U
	SAM Status - No valid key version found Equivalent mapped error code will be PHHAL_HW_SAM_ERR_KEY_VERSION_INVALID.

#define	PHHAL_HW_SAM_RET_CODE_UNKNOWN_PUBLIC_KEY_INDEX 0x6A83U
	SAM Status - Unknown Public Key Index when trying to update Equivalent mapped error code will be PHHAL_HW_SAM_ERR_UNKNOWN_PUBLIC_KEY_INDEX.

#define	PHHAL_HW_SAM_RET_CODE_HOST_PROTECTION_ERROR 0x6A84U
	SAM Status - SAM Host protection error Equivalent mapped error code will be PHHAL_HW_SAM_ERR_HOST_PROTECTION.

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_P1P2 0x6A86U
	SAM Status - Incorrect value for parameter P1 and/or P2 Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_WRONG_P1P2.

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_LE 0x6C00U
	SAM Status - Incorrect LE value Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_WRONG_LE.

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_UNKNOWN_INS 0x6D00U
	SAM Status - Instruction code not supported or invalid or not available in the current state of the SAM Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_UNKNOWN_INS.

#define	PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_CLASS 0x6E00U
	SAM Status - Class not supported Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_UNKNOWN_CLASS.

#define	PHHAL_HW_SAM_RET_CODE_NO_PRECISE_DIAGNOSIS 0x6F00U
	SAM Status - No precise diagnosis (physical address invalid, EEPROM error, no correct key loaded for cryptographic operation, improper length for cryptographic operation, internal limit exceeded.) Equivalent mapped error code will be PHHAL_HW_SAM_ERR_NO_PRECISE_DIAGNOSIS.

#define	PHHAL_HW_SAM_RET_CODE_OK 0x9000U
	SAM Status - Correct execution. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_1BIT 0x9001U
	SAM Status - Correct execution, 1 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_2BIT 0x9002U
	SAM Status - Correct execution, 2 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_3BIT 0x9003U
	SAM Status - Correct execution, 3 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_4BIT 0x9004U
	SAM Status - Correct execution, 4 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_5BIT 0x9005U
	SAM Status - Correct execution, 5 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_6BIT 0x9006U
	SAM Status - Correct execution, 6 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_7BIT 0x9007U
	SAM Status - Correct execution, 7 bit received during ISO14443-3_TransparentExchange command exchange. More...

#define	PHHAL_HW_SAM_RET_CODE_CRYPTO_FAILURE 0x901EU
	SAM Status - MAC verification failed. More...

#define	PHHAL_HW_SAM_RET_CODE_OK_CHAINING_ACTIVE_DUOX 0x90ADU
	SAM Status - Correct execution - Correct Execution with Cert.A - more data remaining Equivalent mapped error code will be PHHAL_HW_SAM_ERR_OK_CHAINING_ACTIVE_DUOX.

#define	PHHAL_HW_SAM_RET_CODE_OK_CHAINING_ACTIVE_EXT 0x90AEU
	SAM Status - Correct execution - Correct execution - more data expected (SAM-Host secure messaging to be applied on each command exchange) Equivalent mapped error code will be PHHAL_HW_SAM_ERR_OK_CHAINING_ACTIVE_EXT.

#define	PHHAL_HW_SAM_RET_CODE_OK_CHAINING_ACTIVE 0x90AFU
	SAM Status - Correct execution - more data expected Equivalent mapped error code will be PHHAL_HW_SAM_ERR_OK_CHAINING_ACTIVE.

#define	PHHAL_HW_SAM_RET_CODE_MIFARE_PLUS_INCORRECT_DATA 0x90BEU
	SAM Status - MIFARE PICC sent incorrect amount of data (for example wrong length of MAC) Equivalent mapped error code will be PHHAL_HW_SAM_ERR_MIFARE_PLUS_INCORRECT_DATA.

#define	PHHAL_HW_SAM_RET_CODE_MIFARE_PLUS_ERROR 0x90BFU
	SAM Status - Correct SAM execution but MFP response is an error return code Equivalent mapped error code will be PHHAL_HW_SAM_ERR_MIFARE_PLUS_GEN.

#define	PHHAL_HW_SAM_RET_CODE_ISO_UID_INCOMPLETE 0x90C0U
	SAM Status - Correct execution - UID not complete (selection sequence has to be continued) Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO_UID_INCOMPLETE.

#define	PHHAL_HW_SAM_RET_CODE_DESFIRE_ERROR 0x90DFU
	SAM Status - Correct execution, DESFire returned error or incorrect length Equivalent mapped error code will be PHHAL_HW_SAM_ERR_DESFIRE_GEN.

#define	PHHAL_HW_SAM_RET_CODE_COMM_IO_TIMEOUT 0x90E0U
	SAM Status - No response from card (no card in field) Equivalent mapped error code will be PH_ERR_IO_TIMEOUT.

#define	PHHAL_HW_SAM_RET_CODE_COMM_ISO14443_PROTOCOL_EEROR 0x90E1U
	SAM Status - ISO 14443 protocol error Equivalent mapped error code will be PH_ERR_PROTOCOL_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_PARITY_ERROR 0x90E2U
	SAM Status - Parity Error Equivalent mapped error code will be PH_ERR_INTEGRITY_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_BUFFER_OVERFLOW 0x90E3U
	SAM Status - Buffer Overflow error Equivalent mapped error code will be PH_ERR_BUFFER_OVERFLOW.

#define	PHHAL_HW_SAM_RET_CODE_COMM_CRC_FAILURE 0x90E4U
	SAM Status - (N)ACK expected, CRC mismatch Equivalent mapped error code will be PH_ERR_INTEGRITY_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_RF_FAILURE 0x90E5U
	SAM Status - RF Field in-active Equivalent mapped error code will be PH_ERR_RF_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_TEMP_FAILURE 0x90E6U
	SAM Status - Temperature error Equivalent mapped error code will be PH_ERR_TEMPERATURE_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_FIFO_WRITE 0x90E7U
	SAM Status - FIFO write error Equivalent mapped error code will be PH_ERR_READ_WRITE_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_COLLISION 0x90E8U
	SAM Status - Collision error Equivalent mapped error code will be PH_ERR_COLLISION_ERROR.

#define	PHHAL_HW_SAM_RET_CODE_COMM_INTERNAL_BUF_OVERFLOW 0x90E9U
	SAM Status - Internal transaction buffer overflow (more than 256 bytes received from the card) Equivalent mapped error code will be PH_ERR_BUFFER_OVERFLOW.

#define	PHHAL_HW_SAM_RET_CODE_UID_BCC_INCORRECT 0x90EAU
	SAM Status - UID check byte (BCC) incorrect Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO_UID_BCC_INCORRECT.

#define	PHHAL_HW_SAM_RET_CODE_ISO_WRONG_BNR 0x90EBU
	SAM Status - Incorrect block number Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO_WRONG_BNR.

#define	PHHAL_HW_SAM_RET_CODE_ISO_INVALID_FORMAT 0x90ECU
	SAM Status - One of the following. More...

#define	PHHAL_HW_SAM_RET_CODE_ISO_INVALID_PARAMETER 0x90EDU
	SAM Status - One of the following. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_ERROR 0x90EFU
	SAM Status - Correct execution but PICC response is an error return code. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_NAK0 0x90F0U
	SAM Status - NACK received from PICC. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_NAK1 0x90F1U
	SAM Status - NACK received from PICC. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_NAK4 0x90F4U
	SAM Status - NACK received from PICC. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_NAK5 0x90F5U
	SAM Status - NACK received from PICC. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_NAK6 0x90F6U
	SAM Status - NACK received from PICC. More...

#define	PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_NAK7 0x90F7U
	SAM Status - NACK received from PICC. More...

Detailed Description

The actual error codes received from SAM. These codes are for reference purpose only. All the interfaces will return codes mentioned in Mapped Codes and not these codes.

Macro Definition Documentation

◆ PHHAL_HW_SAM_RET_CODE_HW_EEPROM

#define PHHAL_HW_SAM_RET_CODE_HW_EEPROM 0x6400U

SAM Status - EEPROM busy, access collision, memory range cannot be mapped, execution error.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_HW_EEPROM.

◆ PHHAL_HW_SAM_RET_CODE_HW_RC5XX

#define PHHAL_HW_SAM_RET_CODE_HW_RC5XX 0x6401U

SAM Status - Reader IC interface error.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_HW_RC5XX.

◆ PHHAL_HW_SAM_RET_CODE_KEY_CREATE_FAILED

#define PHHAL_HW_SAM_RET_CODE_KEY_CREATE_FAILED 0x6501U

SAM Status - Key creation failure.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_KEY_CREATE_FAILED.

◆ PHHAL_HW_SAM_RET_CODE_KEY_REF_NO_INVALID

#define PHHAL_HW_SAM_RET_CODE_KEY_REF_NO_INVALID 0x6502U

SAM Status - Key reference number invalid.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_KEY_REF_NO_INVALID.

◆ PHHAL_HW_SAM_RET_CODE_KEY_KUC_NO_INVALID

#define PHHAL_HW_SAM_RET_CODE_KEY_KUC_NO_INVALID 0x6503U

SAM Status - Key usage counter number invalid.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_KEY_KUC_NO_INVALID.

◆ PHHAL_HW_SAM_RET_CODE_HW_EE_HIGH_VOLTAGE

#define PHHAL_HW_SAM_RET_CODE_HW_EE_HIGH_VOLTAGE 0x6581U

SAM Status - EEPROM high voltage failure; SAM permanently disabled.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_HW_EE_HIGH_VOLTAGE.

◆ PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_LENGTH_LC

#define PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_LENGTH_LC 0x6700U

SAM Status - Wrong length of the APDU or wrong LC byte.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_WRONG_LENGTH_LC.

◆ PHHAL_HW_SAM_RET_CODE_KEY_INTEGRITY_ERROR

#define PHHAL_HW_SAM_RET_CODE_KEY_INTEGRITY_ERROR 0x6984U

SAM Status - One of the following.

CRC mismatch; wrong key handling buffer size
HostRespData received from programmable logic is not multiple of 16 bytes, while chaining applying HostMode.Full is ongoing Equivalent mapped error code will be PHHAL_HW_SAM_ERR_KEY_INTEGRITY_ERROR.

◆ PHHAL_HW_SAM_RET_CODE_COND_USE_NOT_SATISFIED

#define PHHAL_HW_SAM_RET_CODE_COND_USE_NOT_SATISFIED 0x6985U

SAM Status - Conditions of use not satisfied.

Multiple meaning for this status, refer the command for actual information. Equivalent mapped error code will be PHHAL_HW_SAM_ERR_COND_USE_NOT_SATISFIED.

◆ PHHAL_HW_SAM_RET_CODE_ISO7816_COMMAND_NOT_ALLOWED

#define PHHAL_HW_SAM_RET_CODE_ISO7816_COMMAND_NOT_ALLOWED 0x6986U

SAM Status - Command not allowed.

Multiple meaning for this status, refer the command for actual information. Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_COMMAND_NOT_ALLOWED.

◆ PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_PARAMS_FOR_INS

#define PHHAL_HW_SAM_RET_CODE_ISO7816_WRONG_PARAMS_FOR_INS 0x6A80U

SAM Status - Unexpected RFU bit(s) value(s) in data field parameter.

Multiple meaning for this status, refer the command for actual information. Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO7816_WRONG_PARAMS_FOR_INS.

◆ PHHAL_HW_SAM_RET_CODE_OK

#define PHHAL_HW_SAM_RET_CODE_OK 0x9000U

SAM Status - Correct execution.

Multiple meaning for this status, refer the command for actual information. Equivalent mapped error code will be PH_ERR_SUCCESS.

◆ PHHAL_HW_SAM_RET_CODE_OK_1BIT

#define PHHAL_HW_SAM_RET_CODE_OK_1BIT 0x9001U

SAM Status - Correct execution, 1 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_OK_2BIT

#define PHHAL_HW_SAM_RET_CODE_OK_2BIT 0x9002U

SAM Status - Correct execution, 2 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_OK_3BIT

#define PHHAL_HW_SAM_RET_CODE_OK_3BIT 0x9003U

SAM Status - Correct execution, 3 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_OK_4BIT

#define PHHAL_HW_SAM_RET_CODE_OK_4BIT 0x9004U

SAM Status - Correct execution, 4 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_OK_5BIT

#define PHHAL_HW_SAM_RET_CODE_OK_5BIT 0x9005U

SAM Status - Correct execution, 5 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_OK_6BIT

#define PHHAL_HW_SAM_RET_CODE_OK_6BIT 0x9006U

SAM Status - Correct execution, 6 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_OK_7BIT

#define PHHAL_HW_SAM_RET_CODE_OK_7BIT 0x9007U

SAM Status - Correct execution, 7 bit received during ISO14443-3_TransparentExchange command exchange.

Equivalent mapped error code will be PH_ERR_SUCCESS_INCOMPLETE_BYTE.

◆ PHHAL_HW_SAM_RET_CODE_CRYPTO_FAILURE

#define PHHAL_HW_SAM_RET_CODE_CRYPTO_FAILURE 0x901EU

SAM Status - MAC verification failed.

Multiple meaning for this status, refer the command for actual information. Equivalent mapped error code will be PHHAL_HW_SAM_ERR_CRYPTO.

◆ PHHAL_HW_SAM_RET_CODE_ISO_INVALID_FORMAT

#define PHHAL_HW_SAM_RET_CODE_ISO_INVALID_FORMAT 0x90ECU

SAM Status - One of the following.

ATS length byte does not match actual length of received ATS or PPS response invalid (incorrect length or PPSS byte)
Block length or PCB invalid
Incorrect (no R-block or I-block) answer received Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO_INVALID_FORMAT.

◆ PHHAL_HW_SAM_RET_CODE_ISO_INVALID_PARAMETER

#define PHHAL_HW_SAM_RET_CODE_ISO_INVALID_PARAMETER 0x90EDU

SAM Status - One of the following.

User buffer length below ISO14443-4 minimum
Invalid UID bit count (too many bits received)
CID, NAD either not expected, missing or incorrect Equivalent mapped error code will be PHHAL_HW_SAM_ERR_ISO_INVALID_PARAMETER.

◆ PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_ERROR

#define PHHAL_HW_SAM_RET_CODE_PROT_MIFARE_ERROR 0x90EFU

SAM Status - Correct execution but PICC response is an error return code.

Equivalent mapped error code will be PHHAL_HW_SAM_ERR_MIFARE_GEN.