These Functions implement the MIFARE DESFire EVx commands. More...

Collaboration diagram for MIFARE DESFire EVx:

Modules
	Component : Software

	Commands_MemoryConfiguration
	These Components implement the MIFARE DESFire EVx Memory and Configuration Management related commands.

	Commands_KeyManagement
	These Components implement the MIFARE DESFire EVx Key Management related commands.

	Commands_ApplicationManagement
	These Components implement the MIFARE DESFire EVx Application Management related commands.

	Commands_FileManagement
	These Components implement the MIFARE DESFire EVx File Management related commands.

	Commands_DataManagement
	These Components implement the MIFARE DESFire EVx Data Management related commands.

	Commands_TransactionManagement
	These Components implement the MIFARE DESFire EVx Transaction Management related commands.

	Commands_ISO7816
	These Components implement the MIFARE DESFire EVx ISO/IEC 7816-4 Basic commands.

	Commands_OriginalityCheck
	These Components implement the MIFARE DESFire EVx Originality Check functions.

	Commands_MIFARE_ClassicSupport
	These Components implement the MIFARE DESFire EVx MIFARE Classic Support functions.

	Commands_Miscellaneous
	These Components implement the MIFARE DESFire EVx Miscellaneous functions. These are not part of actual DESFire EVx data sheet rather its for internal purpose.

Other Options for various Functions
#define	PHAL_MFDFEVX_ORIGINALITY_KEY_FIRST 0x01U
	Originality key for AES.

#define	PHAL_MFDFEVX_ORIGINALITY_KEY_LAST 0x04U
	Originality key for AES

#define	PHAL_MFDFEVX_MAC_DATA_INCOMPLETE 0x01U
	Option for indicating more data to come in next call for MAC calculation.

#define	PHAL_MFDFEVX_COMMUNICATION_MAC_ON_RC 0x02U
	MAC is appended over response

#define	PHAL_MFDFEVX_COMMUNICATION_MAC_ON_CMD 0x03U
	MAC is appended over command.

#define	PHAL_MFDFEVX_AUTHENTICATE_RESET 0x08U
	authentication state shall be reset

#define	PHAL_MFDFEVX_KEYSETVALUES_PRESENT 0x01U
	Bit 0 of bKeySettings3 decides the presence of the key set values array.

#define	PHAL_MFDFEVX_KEYSETT3_PRESENT 0x10U
	Bit 4 of bKeySettings2 decides the presence of the keysetting3.

#define	PHAL_MFDFEVX_MFC_KILL_KEY 0x31U
	MFCKill key for AES.

Error Codes mapping to custom values.
#define	PHAL_MFDFEVX_NO_CHANGES (PH_ERR_CUSTOM_BEGIN + 0)
	MFDFEVx Response - No changes done to backup files.

#define	PHAL_MFDFEVX_ERR_OUT_OF_EEPROM_ERROR (PH_ERR_CUSTOM_BEGIN + 1)
	MFDFEVx Response - Insufficient NV-Memory.

#define	PHAL_MFDFEVX_ERR_NO_SUCH_KEY (PH_ERR_CUSTOM_BEGIN + 2)
	MFDFEVx Invalid key number specified.

#define	PHAL_MFDFEVX_ERR_PERMISSION_DENIED (PH_ERR_CUSTOM_BEGIN + 3)
	MFDFEVx Current configuration/status does not allow the requested command.

#define	PHAL_MFDFEVX_ERR_APPLICATION_NOT_FOUND (PH_ERR_CUSTOM_BEGIN + 4)
	MFDFEVx Requested AID not found on PICC.

#define	PHAL_MFDFEVX_ERR_BOUNDARY_ERROR (PH_ERR_CUSTOM_BEGIN + 5)
	MFDFEVx Attempt to read/write data from/to beyond the files/record's limits.

#define	PHAL_MFDFEVX_ERR_COMMAND_ABORTED (PH_ERR_CUSTOM_BEGIN + 6)
	MFDFEVx Previous cmd not fully completed. More...

#define	PHAL_MFDFEVX_ERR_COUNT (PH_ERR_CUSTOM_BEGIN + 7)
	MFDFEVx Num. More...

#define	PHAL_MFDFEVX_ERR_DUPLICATE (PH_ERR_CUSTOM_BEGIN + 8)
	MFDFEVx File/Application with same number already exists.

#define	PHAL_MFDFEVX_ERR_FILE_NOT_FOUND (PH_ERR_CUSTOM_BEGIN + 9)
	MFDFEVx Specified file number does not exist.

#define	PHAL_MFDFEVX_ERR_PICC_CRYPTO (PH_ERR_CUSTOM_BEGIN + 10)
	MFDFEVx Crypto error returned by PICC.

#define	PHAL_MFDFEVX_ERR_PARAMETER_ERROR (PH_ERR_CUSTOM_BEGIN + 11)
	MFDFEVx Parameter value error returned by PICC.

#define	PHAL_MFDFEVX_ERR_DF_GEN_ERROR (PH_ERR_CUSTOM_BEGIN + 12)
	MFDFEVx DesFire Generic error. More...

#define	PHAL_MFDFEVX_ERR_DF_7816_GEN_ERROR (PH_ERR_CUSTOM_BEGIN + 13)
	MFDFEVx ISO 7816 Generic error. More...

#define	PHAL_MFDFEVX_ERR_CMD_INVALID (PH_ERR_CUSTOM_BEGIN + 14)
	MFDFEVx ISO 7816 Generic error. More...

#define	PHAL_MFDFEVX_ERR_NOT_SUPPORTED (PH_ERR_CUSTOM_BEGIN + 15)
	MFDFEVx Not Supported Error.

#define	PHAL_MFDFEVX_ERR_INTEGRITY_ERROR (PH_ERR_CUSTOM_BEGIN + 16)
	MFDFEVx integrity error.

#define	PHAL_MFDFEVX_ERR_MEMORY_ERROR (PH_ERR_CUSTOM_BEGIN + 17)
	MFDFEVx memory error.

#define	PHAL_MFDFEVX_ERR_OPERATION_OK_LIM (PH_ERR_CUSTOM_BEGIN + 27)
	MFDFEVx custom error code for Successful operation with limited functionality.

#define	PHAL_MFDFEVX_ERR_CMD_OVERFLOW (PH_ERR_CUSTOM_BEGIN + 28)
	MFDFEVx Too many commands in the session or transaction.

#define	PHAL_MFDFEVX_ERR_GEN_FAILURE (PH_ERR_CUSTOM_BEGIN + 29)
	MFDFEVx Failure in the operation of the PD.

#define	PHAL_MFDFEVX_ERR_BNR (PH_ERR_CUSTOM_BEGIN + 30)
	MFDFEVx Invalid Block number: not existing in the implementation or not valid to target with this command.

#define	PHAL_MFDFEVX_ERR_FORMAT (PH_ERR_CUSTOM_BEGIN + 31)
	MFDFEVx Format of the command is not correct (e.g. More...

ISO7816-4 Error Codes mapping to custom values.
#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_MEMORY_FAILURE (PH_ERR_CUSTOM_BEGIN + 18)
	ISO7816 custom response code for memory failure.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_WRONG_LENGTH (PH_ERR_CUSTOM_BEGIN + 19)
	ISO7816 custom response code for wrong length, no further indication.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_SECURITY_STAT_NOT_SATISFIED (PH_ERR_CUSTOM_BEGIN + 20)
	ISO7816 custom response code for security status not satisfied.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_CONDITIONS_NOT_SATISFIED (PH_ERR_CUSTOM_BEGIN + 21)
	ISO7816 custom response code for conditions of use not satisfied.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_FILE_APPLICATION_NOT_FOUND (PH_ERR_CUSTOM_BEGIN + 22)
	ISO7816 custom response code for file or application not found.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_INCORRECT_PARAM_P1_P2 (PH_ERR_CUSTOM_BEGIN + 23)
	ISO7816 custom response code for incorrect parameters P1-P2.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_LC_INCONSISTENT (PH_ERR_CUSTOM_BEGIN + 24)
	ISO7816 custom response code for LC inconsistent with parameter P1-P2.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_WRONG_LE (PH_ERR_CUSTOM_BEGIN + 25)
	ISO7816 custom response code for wrong LE field.

#define	PHAL_MFDFEVX_ISO7816_CUSTOM_ERR_INS_CODE_NOT_SUPPORTED (PH_ERR_CUSTOM_BEGIN + 26)
	ISO7816 custom response code for instruction code not supported or invalid.

Authentication Modes
#define	PHAL_MFDFEVX_NOT_AUTHENTICATED 0xFFU
	No authentication.

#define	PHAL_MFDFEVX_AUTHENTICATE 0x0AU
	D40 Authentication; 0x0A.

#define	PHAL_MFDFEVX_AUTHENTICATEISO 0x1AU
	ISO Authentication; 0x1A.

#define	PHAL_MFDFEVX_AUTHENTICATEAES 0xAAU
	AES Authentication; 0xAA.

#define	PHAL_MFDFEVX_AUTHENTICATEEV2 0x71U
	EV2 Authentication; 0x71.

#define	PHAL_MFDFEVX_AUTH_FIRST 0x01U
	Option to perform EVx First Authentication.

#define	PHAL_MFDFEVX_AUTH_NONFIRST 0x00U
	Option to perform EVx NonFirst Authentication.

Option to be used for InitializeKeySet and CreateTransactionMACFile command.
#define	PHAL_MFDFEVX_KEY_TYPE_2K3DES 0x00U
	Option for 2 Key Triple Des key type.

#define	PHAL_MFDFEVX_KEY_TYPE_3K3DES 0x01U
	Option for 3 Key Triple Des key type.

#define	PHAL_MFDFEVX_KEY_TYPE_AES128 0x02U
	Option for AES 128 key type.

Option for most of the commands.
#define	PHAL_MFDFEVX_SAI 0x80U
	Option for Secondary application indicator (SAI).

Options for application / file creation commands command.
#define	PHAL_MFDFEVX_ISO_FILE_INFO_NOT_AVAILABLE 0x00U
	Option to indicate no ISO File ID or ISODFName are present.

#define	PHAL_MFDFEVX_ISO_FILE_ID_AVAILABLE 0x01U
	Option to indicate the presence of ISO FileID.

#define	PHAL_MFDFEVX_ISO_DF_NAME_AVAILABLE 0x02U
	Option to indicate the presence of ISO DFName.

#define	PHAL_MFDFEVX_ISO_FILE_ID_DF_NAME_AVAILABLE 0x03U
	Option to indicate the presence of both ISO FileID and ISO DFName.

The communication mode to be used.
#define	PHAL_MFDFEVX_COMMUNICATION_PLAIN 0x00U
	Plain mode of communication.

#define	PHAL_MFDFEVX_COMMUNICATION_PLAIN_1 0x20U
	Plain mode of communication.

#define	PHAL_MFDFEVX_COMMUNICATION_MACD 0x10U
	MAC mode of communication.

#define	PHAL_MFDFEVX_COMMUNICATION_ENC 0x30U
	Enciphered mode of communication.

Detailed Description

These Functions implement the MIFARE DESFire EVx commands.

Macro Definition Documentation

◆ PHAL_MFDFEVX_ERR_COMMAND_ABORTED

#define PHAL_MFDFEVX_ERR_COMMAND_ABORTED (PH_ERR_CUSTOM_BEGIN + 6)

MFDFEVx Previous cmd not fully completed.

Not all frames were requested or provided by the PCD.

◆ PHAL_MFDFEVX_ERR_COUNT

#define PHAL_MFDFEVX_ERR_COUNT (PH_ERR_CUSTOM_BEGIN + 7)

MFDFEVx Num.

of applns limited to 28. No additional applications possible.

◆ PHAL_MFDFEVX_ERR_DF_GEN_ERROR

#define PHAL_MFDFEVX_ERR_DF_GEN_ERROR (PH_ERR_CUSTOM_BEGIN + 12)

MFDFEVx DesFire Generic error.

Check additional Info.

◆ PHAL_MFDFEVX_ERR_DF_7816_GEN_ERROR

#define PHAL_MFDFEVX_ERR_DF_7816_GEN_ERROR (PH_ERR_CUSTOM_BEGIN + 13)

MFDFEVx ISO 7816 Generic error.

Check Additional Info.

◆ PHAL_MFDFEVX_ERR_CMD_INVALID

#define PHAL_MFDFEVX_ERR_CMD_INVALID (PH_ERR_CUSTOM_BEGIN + 14)

MFDFEVx ISO 7816 Generic error.

Check Additional Info.

◆ PHAL_MFDFEVX_ERR_FORMAT

#define PHAL_MFDFEVX_ERR_FORMAT (PH_ERR_CUSTOM_BEGIN + 31)

MFDFEVx Format of the command is not correct (e.g.

too many or too few bytes).

Modules

Other Options for various Functions

Error Codes mapping to custom values.

ISO7816-4 Error Codes mapping to custom values.

Authentication Modes

Option to be used for InitializeKeySet and CreateTransactionMACFile command.

Option for most of the commands.

Options for application / file creation commands command.

The communication mode to be used.