EMV Commands

SAM command for EMV feature. More...

Collaboration diagram for EMV Commands:

Functions
phStatus_t	phhalHw_SamAV3_Cmd_EMVCo_RecoverStaticData (phhalHw_SamAV3_DataParams_t *pDataParams, uint16_t wOption, uint8_t *pSignedStaticAppData, uint8_t bSignedStaticAppDataLen, uint8_t **ppResponse, uint8_t *pRespLen)
	Performs EMV Offline Static Data Authentication. More...
phStatus_t	phhalHw_SamAV3_Cmd_EMVCo_RecoverDynamicData (phhalHw_SamAV3_DataParams_t *pDataParams, uint16_t wOption, uint8_t *pSignedDynamicAppData, uint8_t bSignedDynamicAppDataLen, uint8_t **ppResponse, uint8_t *pRespLen)
	Performs EMV Offline Dynamic Data Authentication. More...
phStatus_t	phhalHw_SamAV3_Cmd_EMVCo_EncipherPin (phhalHw_SamAV3_DataParams_t *pDataParams, uint8_t *pPinBlock, uint8_t *pIccNum, uint8_t **ppEncPin, uint8_t *pEncPinLen)
	Performs EMV Personal Identification Number Encipherment. More...

Sam AV3 command code for EMVCo feature.
#define	PHHAL_HW_SAMAV3_CMD_EMVCO_RECOVER_STATIC_DATA_INS   0x29U
	Sam AV3 Instruction code for Cmd.SAM_RecoverStaticData command.
#define	PHHAL_HW_SAMAV3_CMD_EMVCO_RECOVER_DYNAMIC_DATA_INS   0x2AU
	Sam AV3 Instruction code for Cmd.SAM_RecoverDynamicData command.
#define	PHHAL_HW_SAMAV3_CMD_EMVCO_RECOVER_ENCIPHER_PIN_INS   0x2BU
	Sam AV3 Instruction code for Cmd.SAM_EncipherPIN command.

Detailed Description

SAM command for EMV feature.

Function Documentation

phhalHw_SamAV3_Cmd_EMVCo_RecoverStaticData()

phStatus_t phhalHw_SamAV3_Cmd_EMVCo_RecoverStaticData	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint16_t	wOption,
		uint8_t *	pSignedStaticAppData,
		uint8_t	bSignedStaticAppDataLen,
		uint8_t **	ppResponse,
		uint8_t *	pRespLen
	)

Performs EMV Offline Static Data Authentication.

This command recovers the static application data for the Static Data Authentication.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_SUCCESS_CHAINING	successfull chaining.
Other	Depending on implementation and underlaying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	wOption	[In] Option for exchanging the data in chaining or in one frame. PH_EXCHANGE_DEFAULT : To exchange the non-chained or the final set of data. Here the LFI will be set to 0x00. PH_EXCHANGE_TXCHAINING: To exchange the chained data. Here the LFI will be set to 0xAF.
[in]	pSignedStaticAppData	[In] Signed Static Application Data.
[in]	bSignedStaticAppDataLen	[In] Signed Static Application Data length.
[out]	ppResponse	[Out] Buffer containing Hash Algorithm Indicator, Data Authentication Code and Hash Result.
[out]	pRespLen	[Out] Length of the output data

phhalHw_SamAV3_Cmd_EMVCo_RecoverDynamicData()

phStatus_t phhalHw_SamAV3_Cmd_EMVCo_RecoverDynamicData	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint16_t	wOption,
		uint8_t *	pSignedDynamicAppData,
		uint8_t	bSignedDynamicAppDataLen,
		uint8_t **	ppResponse,
		uint8_t *	pRespLen
	)

Performs EMV Offline Dynamic Data Authentication.

This command recovers the dynamic application data for the Dynamic Data Authentication or Combined Dynamic Data Authentication with Application Cryptogram Generation. The ICC Public Key or ICC PIN Encipherment Public Key must have been loaded previously with Cmd.PKI_LoadIccPk

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]	wOption	[In] Option for exchanging the data in chaining or in one frame. PH_EXCHANGE_DEFAULT : To exchange the non-chained or the final set of data. Here the LFI will be set to 0x00. PH_EXCHANGE_TXCHAINING: To exchange the chained data. Here the LFI will be set to 0xAF.
[in]	pSignedDynamicAppData	[In] Signed Dynamic Application Data.
[in]	bSignedDynamicAppDataLen	[In] Length of Signed Dynamic Application Data.
[out]	ppResponse	[Out] Buffer containing Hash Algorithm Indicator, ICC Dynamic Data Length, ICC Dynamic Data and Hash result.
[out]	pRespLen	[Out] Length of the output data.

phhalHw_SamAV3_Cmd_EMVCo_EncipherPin()

phStatus_t phhalHw_SamAV3_Cmd_EMVCo_EncipherPin	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint8_t *	pPinBlock,
		uint8_t *	pIccNum,
		uint8_t **	ppEncPin,
		uint8_t *	pEncPinLen
	)

Performs EMV Personal Identification Number Encipherment.

This command is used to encipher the PIN to support offline PIN verification by the ICC. The ICC Public Key or ICC PIN Encipherment Public Key must have been loaded previously with Cmd.PKI_LoadIccPk

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]	pPinBlock	[In] Pin Block Number.
[in]	pIccNum	[In] ICC Unpredictable Number.
[out]	ppEncPin	[Out] Enciphered PIN Data.
[out]	pEncPinLen	[Out] Length of the Enciphered PIN Data.