Commands_Special

These Components implement the MIFARE Plus additional feature commands. More...

Collaboration diagram for Commands_Special:

Functions
phStatus_t	phalMfp_ResetAuth (void *pDataParams)
	Performs a Reset Auth command. More...
phStatus_t	phalMfp_ResetSecMsgState (void *pDataParams)
	Reset the libraries internal secure messaging state. More...
phStatus_t	phalMfp_ChangeKey (void *pDataParams, uint8_t bChangeKeyMaced, uint16_t wBlockNr, uint16_t wKeyNumber, uint16_t wKeyVersion, uint8_t bLenDivInput, uint8_t *pDivInput)
	Performs a Key Change of a MIFARE Plus key. More...
phStatus_t	phalMfp_ProximityCheck (void *pDataParams, uint8_t bGenerateRndC, uint8_t *pRndC, uint8_t bPps1, uint8_t bNumSteps, uint8_t *pUsedRndC)
	Performs the whole Proximity Check command chain. More...

Options to indicate the generation of random C.
#define	PHAL_MFP_RNDC_GENERATION_INCLUDED   0x00U
	Option to indicate the randon number should be generated by the user and exchanged.
#define	PHAL_MFP_RNDC_GENERATION_EXCLUDED   0x01U
	Option to indicate the randon number should not be generated by the user and exchanged.

Detailed Description

These Components implement the MIFARE Plus additional feature commands.

Function Documentation

phalMfp_ResetAuth()

phStatus_t phalMfp_ResetAuth

(

void *

pDataParams

)

Performs a Reset Auth command.

Returns

Status code

Return values

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

Parameters

[in]

pDataParams

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

phalMfp_ResetSecMsgState()

phStatus_t phalMfp_ResetSecMsgState

(

void *

pDataParams

)

Reset the libraries internal secure messaging state.

This function must be called before interacting with the PICC to set the libraries internal card-state back to default.
E.g. when an error occurred or after a reset of the field.

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.

phalMfp_ChangeKey()

phStatus_t phalMfp_ChangeKey	(	void *	pDataParams,
		uint8_t	bChangeKeyMaced,
		uint16_t	wBlockNr,
		uint16_t	wKeyNumber,
		uint16_t	wKeyVersion,
		uint8_t	bLenDivInput,
		uint8_t *	pDivInput
	)

Performs a Key Change of a MIFARE Plus key.

Same as phalMfp_Write, but diversification input can be provided.

Returns

Status code

Return values

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

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bChangeKeyMaced	[In] Indicate whether the response should be maced. Based on this flag the command code will be updated. PHAL_MFP_MAC_ON_RESPONSE_OFF PHAL_MFP_MAC_ON_RESPONSE_ON
[in]	wBlockNr	[In] PICC block number to which the key should be changed.
[in]	wKeyNumber	[In] Key number to be used from software or hardware keystore.
[in]	wKeyVersion	[In] Key version to be used from software or hardware keystore.
[in]	bLenDivInput	[In] Length of diversification input used to diversify the key. If 0, no diversification is performed.
[in]	pDivInput	[In] Diversification Input used to diversify the key.

phalMfp_ProximityCheck()

phStatus_t phalMfp_ProximityCheck	(	void *	pDataParams,
		uint8_t	bGenerateRndC,
		uint8_t *	pRndC,
		uint8_t	bPps1,
		uint8_t	bNumSteps,
		uint8_t *	pUsedRndC
	)

Performs the whole Proximity Check command chain.

This command is supported in Authenticated state only.

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]	bGenerateRndC	[In] Indicate the generation of RndC. PHAL_MFP_RNDC_GENERATION_INCLUDED PHAL_MFP_RNDC_GENERATION_EXCLUDED
[in]	pRndC	[In] Provided RndC (7 bytes), ignored if bGenerateRndC == 1.
[in]	bPps1	[In] Communication Speed byte (PPS1).
[in]	bNumSteps	[In] Number of ProximityCheck cycles; RFU, must be 1.
[out]	pUsedRndC	[Out] Used RndC (7 bytes), can be NULL.