Commands_TransactionManagement

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

Collaboration diagram for Commands_TransactionManagement:

Functions
phStatus_t	phalMfdfEVx_CommitTransaction (void *pDataParams, uint8_t bOption, uint8_t *pTMC, uint8_t *pTMV)
	Validates all previous write access' on Backup Data files, value files and record files within one application. More...
phStatus_t	phalMfdfEVx_AbortTransaction (void *pDataParams)
	Aborts all previous write accesses on FileType.BackupData, FileType.Value, File-Type.LinearRecord and FileType.CyclicRecord files within the selected application(s). More...
phStatus_t	phalMfdfEVx_CommitReaderID (void *pDataParams, uint8_t *pTMRI, uint8_t *pEncTMRI)
	Secures the transaction by committing the application to ReaderID specified. More...

Options for CommitTransaction command.
#define	PHAL_MFDFEVX_COMMIT_TXN_OPTION_NOT_EXCHANGED   0x00
	Option byte is not exchanged to the PICC.
#define	PHAL_MFDFEVX_COMMIT_TXN_NO_TMC_TMV_RETURNED   0x80
	Option byte exchanged to PICC and represent no return of TMC and TMV.
#define	PHAL_MFDFEVX_COMMIT_TXN_TMC_TMV_RETURNED   0x81
	Option byte exchanged to PICC and represent return of TMC and TMV.

Detailed Description

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

Function Documentation

phalMfdfEVx_CommitTransaction()

phStatus_t phalMfdfEVx_CommitTransaction	(	void *	pDataParams,
		uint8_t	bOption,
		uint8_t *	pTMC,
		uint8_t *	pTMV
	)

Validates all previous write access' on Backup Data files, value files and record files within one application.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bOption	[In] One of the below options. PHAL_MFDFEVX_COMMIT_TXN_OPTION_NOT_EXCHANGED PHAL_MFDFEVX_COMMIT_TXN_NO_TMC_TMV_RETURNED PHAL_MFDFEVX_COMMIT_TXN_TMC_TMV_RETURNED
[out]	pTMC	[Out] The increased value as stored in FileType.TransactionMAC. 4 byte Transaction MAC counter value.
[out]	pTMV	[Out] 8 bytes Transaction MAC value.

phalMfdfEVx_AbortTransaction()

phStatus_t phalMfdfEVx_AbortTransaction

(

void *

pDataParams

)

Aborts all previous write accesses on FileType.BackupData, FileType.Value, File-Type.LinearRecord and FileType.CyclicRecord files within the selected application(s).

If applicable, the Transaction MAC calculation is aborted.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]

pDataParams

[In] Pointer to this layer's parameter structure.

phalMfdfEVx_CommitReaderID()

phStatus_t phalMfdfEVx_CommitReaderID	(	void *	pDataParams,
		uint8_t *	pTMRI,
		uint8_t *	pEncTMRI
	)

Secures the transaction by committing the application to ReaderID specified.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
Other	Depending on implementation and underlying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	pTMRI	[In] 16 bytes of Transaction MAC reader ID.
[out]	pEncTMRI	[Out] 16 bytes of Encrypted Transaction MAC ReaderID of the latest successful transaction.