Commands_TransactionManagement

These Components implement the MIFARE Identity Transaction Management related commands. More...

Collaboration diagram for Commands_TransactionManagement:

Functions
phStatus_t	phalMfIdentity_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	phalMfIdentity_AbortTransaction (void *pDataParams)
	Invalidates all previous write access' on Backup Data files, value files and record files within one application. More...
phStatus_t	phalMfIdentity_CommitReaderID (void *pDataParams, uint8_t *pTMRI, uint8_t *pEncTMRI)
	Secures the transaction by commiting the application to ReaderID specified. More...

Options for CommitTransaction command.
#define	PHAL_MFIDENTITY_COMMIT_TXN_NO_TMC_TMV_RETURNED   0x00
	Option byte is not exchanged to the PICC.
#define	PHAL_MFIDENTITY_COMMIT_TXN_TMC_TMV_RETURNED   0x01
	Option byte exchanged to PICC and represent return of TMC and TMV.
#define	PHAL_MFIDENTITY_COMMIT_TXN_INCLUDE_OPTION   0x80
	Option byte exchanged to PICC. More...

Detailed Description

These Components implement the MIFARE Identity Transaction Management related commands.

Macro Definition Documentation

PHAL_MFIDENTITY_COMMIT_TXN_INCLUDE_OPTION

#define PHAL_MFIDENTITY_COMMIT_TXN_INCLUDE_OPTION   0x80

Option byte exchanged to PICC.

This is to support the exchange of Option byte to PICC.

Function Documentation

phalMfIdentity_CommitTransaction()

phStatus_t phalMfIdentity_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_MFIDENTITY_COMMIT_TXN_NO_TMC_TMV_RETURNED PHAL_MFIDENTITY_COMMIT_TXN_TMC_TMV_RETURNED Can be ored with one of the above values. PHAL_MFIDENTITY_COMMIT_TXN_INCLUDE_OPTION
[out]	pTMC	[Out] The increased value as stored in FileType.TransactionMAC. If Standard AES: 4 byte Transaction MAC counter value. If LRP : 2 byte of Actual TMC followed by 2 bytes of Session TMC
[out]	pTMV	[Out] 8 bytes Transaction MAC value.

phalMfIdentity_AbortTransaction()

phStatus_t phalMfIdentity_AbortTransaction

(

void *

pDataParams

)

Invalidates 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.

phalMfIdentity_CommitReaderID()

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

Secures the transaction by commiting 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.