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

Collaboration diagram for Commands_Miscellaneous:

Functions
phStatus_t	phalMfNtag42XDna_GetConfig (void pDataParams, uint16_t wConfig, uint16_t pValue)
	Perform a GetConfig command. More...

phStatus_t	phalMfNtag42XDna_SetConfig (void *pDataParams, uint16_t wConfig, uint16_t wValue)
	Perform a SetConfig command. More...

phStatus_t	phalMfNtag42XDna_ResetAuthentication (void *pDataParams)
	Reset the authentication. More...

phStatus_t	phalMfNtag42XDna_CalculateMACSDM (void pDataParams, uint8_t bSdmOption, uint16_t wSDMMacKeyNo, uint16_t wSDMMacKeyVer, uint16_t wRamKeyNo, uint16_t wRamKeyVer, uint8_t pUid, uint8_t bUidLen, uint8_t pSDMReadCtr, uint8_t pInData, uint16_t wInDataLen, uint8_t *pRespMac)
	Calculate MAC for SDM information. More...

phStatus_t	phalMfNtag42XDna_DecryptSDMENCFileData (void pDataParams, uint8_t bSdmOption, uint16_t wEncKeyNo, uint16_t wEncKeyVer, uint16_t wRamKeyNo, uint16_t wRamKeyVer, uint8_t pUid, uint8_t bUidLen, uint8_t pSDMReadCtr, uint8_t pEncdata, uint16_t wInDataLen, uint8_t *pPlainData)
	Decrypt the SDM File data information. More...

phStatus_t	phalMfNtag42XDna_DecryptSDMPICCData (void pDataParams, uint16_t wKeyNo, uint16_t wKeyVer, uint8_t pEncdata, uint16_t wEncDataLen, uint8_t *pPlainData)
	Decrypt SDM PICC Data. More...

The configuration to be used for SetConfig / GetConfig.
#define	PHAL_MFNTAG42XDNA_ADDITIONAL_INFO 0x00A1U
	Option for getconfig to get additional info of a generic error.

#define	PHAL_MFNTAG42XDNA_WRAPPED_MODE 0x00A2U
	Option to get / set current status of command wrapping in ISO 7816-4 APDUs.

#define	PHAL_MFNTAG42XDNA_SHORT_LENGTH_APDU 0x00A3U
	Option to get / set Short Length APDU wrapping in ISO 7816-4 APDUs.

#define	PHAL_MFNTAG42XDNA_SDM_KEY_TYPE 0x00A4U
	Distinguish between the LRP_AES or AES key. More...

Detailed Description

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

Macro Definition Documentation

◆ PHAL_MFNTAG42XDNA_SDM_KEY_TYPE

#define PHAL_MFNTAG42XDNA_SDM_KEY_TYPE 0x00A4U

Distinguish between the LRP_AES or AES key.

The values to be used for this configuration are AES128 : 0x00 LRP_AES128 : 0x01

Function Documentation

◆ phalMfNtag42XDna_GetConfig()

phStatus_t phalMfNtag42XDna_GetConfig	(	void *	pDataParams,
		uint16_t	wConfig,
		uint16_t *	pValue
	)

Perform a GetConfig command.

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]	wConfig	[In] Configuration to read. Will be one of the below values. PHAL_MFNTAG42XDNA_ADDITIONAL_INFO PHAL_MFNTAG42XDNA_SDM_KEY_TYPE Support for Software mode only including the above ones. PHAL_MFNTAG42XDNA_WRAPPED_MODE PHAL_MFNTAG42XDNA_SHORT_LENGTH_APDU
[out]	pValue	[Out] The value for the mentioned configuration.

◆ phalMfNtag42XDna_SetConfig()

phStatus_t phalMfNtag42XDna_SetConfig	(	void *	pDataParams,
		uint16_t	wConfig,
		uint16_t	wValue
	)

Perform a SetConfig command.

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]	wConfig	[In] Configuration to set. Will be one of the below values. PHAL_MFNTAG42XDNA_ADDITIONAL_INFO PHAL_MFNTAG42XDNA_SDM_KEY_TYPE Support for Software mode only including the above ones. PHAL_MFNTAG42XDNA_WRAPPED_MODE PHAL_MFNTAG42XDNA_SHORT_LENGTH_APDU
[in]	wValue	[In] The value for the mentioned configuration.

◆ phalMfNtag42XDna_ResetAuthentication()

phStatus_t phalMfNtag42XDna_ResetAuthentication ( void * pDataParams )

Reset the authentication.

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.

◆ phalMfNtag42XDna_CalculateMACSDM()

phStatus_t phalMfNtag42XDna_CalculateMACSDM	(	void *	pDataParams,
		uint8_t	bSdmOption,
		uint16_t	wSDMMacKeyNo,
		uint16_t	wSDMMacKeyVer,
		uint16_t	wRamKeyNo,
		uint16_t	wRamKeyVer,
		uint8_t *	pUid,
		uint8_t	bUidLen,
		uint8_t *	pSDMReadCtr,
		uint8_t *	pInData,
		uint16_t	wInDataLen,
		uint8_t *	pRespMac
	)

Calculate MAC for SDM information.

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]	bSdmOption	[In] SDM Option to indicate which parameters to be considered. Can be ORed. PHAL_MFNTAG42XDNA_VCUID_PRESENT PHAL_MFNTAG42XDNA_RDCTR_PRESENT
[in]	wSDMMacKeyNo	[In] Key number in Software or SAM keystore.
[in]	wSDMMacKeyVer	[In] Key version in Software or SAM keystore.
[in]	wRamKeyNo	[In] Key number of Destination Key where the computed session TMAC key will be stored. To be used for SAM AV3 only.
[in]	wRamKeyVer	[In] Key version of Destination Key where the computed session TMAC key will be stored. To be used for SAM AV3 only.
[in]	pUid	[In] UID of the card.
[in]	bUidLen	[In] Length of bytes available in UID buffer.
[in]	pSDMReadCtr	[In] SDM Read Counter Input.
[in]	pInData	[In] Data read out of PICC from SDMMacInputoffset for ReadLength bytes
[in]	wInDataLen	[In] Length of bytes available in InData buffer.
[out]	pRespMac	[Out] The computed MAC information.

◆ phalMfNtag42XDna_DecryptSDMENCFileData()

phStatus_t phalMfNtag42XDna_DecryptSDMENCFileData	(	void *	pDataParams,
		uint8_t	bSdmOption,
		uint16_t	wEncKeyNo,
		uint16_t	wEncKeyVer,
		uint16_t	wRamKeyNo,
		uint16_t	wRamKeyVer,
		uint8_t *	pUid,
		uint8_t	bUidLen,
		uint8_t *	pSDMReadCtr,
		uint8_t *	pEncdata,
		uint16_t	wInDataLen,
		uint8_t *	pPlainData
	)

Decrypt the SDM File data information.

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]	bSdmOption	[In] SDM Option to indicate which parameters to be considered. Can be ORed. PHAL_MFNTAG42XDNA_VCUID_PRESENT PHAL_MFNTAG42XDNA_RDCTR_PRESENT
[in]	wEncKeyNo	[In] Key number in keystore of Software or SAM.
[in]	wEncKeyVer	[In] Key version in keystore of Software or SAM.
[in]	wRamKeyNo	[In] Key number of Destination Key where the computed session TMAC key will be stored. To be used for SAM AV3 only.
[in]	wRamKeyVer	[In] Key version of Destination Key where the computed session TMAC key will be stored. To be used for SAM AV3 only.
[in]	pUid	[In] UID of the card.
[in]	bUidLen	[In] Length of bytes available in UID buffer.
[in]	pSDMReadCtr	[In] SDM Read Counter Input.
[in]	pEncdata	[In] Input Enciphered data. Caller has to pass only the Enciphered data which is between SDMEncOffset for SDMEncLength bytes.
[in]	wInDataLen	[In] Length of bytes available in Encdata buffer
[out]	pPlainData	[Out] The decrypted SDM ENC file data.

◆ phalMfNtag42XDna_DecryptSDMPICCData()

phStatus_t phalMfNtag42XDna_DecryptSDMPICCData	(	void *	pDataParams,
		uint16_t	wKeyNo,
		uint16_t	wKeyVer,
		uint8_t *	pEncdata,
		uint16_t	wEncDataLen,
		uint8_t *	pPlainData
	)

Decrypt SDM PICC Data.

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]	wKeyNo	[In] Software or SAM keystore.
[in]	wKeyVer	[In] Software or SAM keystore.
[in]	pEncdata	[In] The Encrypted PICC data.
[in]	wEncDataLen	[In] Length of bytes available in EncData buffer.
[out]	pPlainData	[Out] The decrypted SDM PICC data.

Functions

The configuration to be used for SetConfig / GetConfig.

Detailed Description

Macro Definition Documentation

◆ PHAL_MFNTAG42XDNA_SDM_KEY_TYPE

Function Documentation

◆ phalMfNtag42XDna_GetConfig()

◆ phalMfNtag42XDna_SetConfig()

◆ phalMfNtag42XDna_ResetAuthentication()

◆ phalMfNtag42XDna_CalculateMACSDM()

◆ phalMfNtag42XDna_DecryptSDMENCFileData()

◆ phalMfNtag42XDna_DecryptSDMPICCData()