SAM commands used for ISO14443 layer 4 communication in X-Mode. More...

Collaboration diagram for ISO14443-4:

Functions
phStatus_t	phhalHw_SamAV3_Cmd_X_ISO14443_4_RATS_PPS (phhalHw_SamAV3_DataParams_t pDataParams, uint8_t bCidIn, uint8_t bDsiIn, uint8_t bDriIn, uint8_t pCidOut, uint8_t pDsiOut, uint8_t pDriOut, uint8_t *pAts)
	Perform a combined RATS and PPS to prepare a card for T=CL data exchange. More...

phStatus_t	phhalHw_SamAV3_Cmd_X_ISO14443_4_Init (phhalHw_SamAV3_DataParams_t *pDataParams, uint8_t bCid, uint8_t bDri, uint8_t bDsi, uint8_t bFwi, uint8_t bFsci)
	Perform a init of ISO-14443-4 layer (init T=CL protocol). More...

phStatus_t	phhalHw_SamAV3_Cmd_X_ISO14443_4_Exchange (phhalHw_SamAV3_DataParams_t pDataParams, uint16_t wOption, uint8_t pAppDataIn, uint8_t bLenAppData, uint8_t *ppAppDataOut, uint16_t pAppDataOutLen)
	Perform an exchange bytes according ISO14443-4 T=CL protocol. More...

phStatus_t	phhalHw_SamAV3_Cmd_X_ISO14443_4_PresenceCheck (phhalHw_SamAV3_DataParams_t *pDataParams)
	Check if an activated card is still in the field. More...

phStatus_t	phhalHw_SamAV3_Cmd_X_ISO14443_4_Deselect (phhalHw_SamAV3_DataParams_t *pDataParams, uint8_t bFreeCid)
	Perform a Deselect command. More...

phStatus_t	phhalHw_SamAV3_Cmd_X_ISO14443_4_FreeCid (phhalHw_SamAV3_DataParams_t pDataParams, uint8_t pCid, uint8_t bCidLen)
	Free one or more currently assigned CIDs. More...

Sam AV3 command code for Sam ISO1443-4 feature.
#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_RATS_PPS_INS 0xE0
	Sam AV3 Insturction code for Cmd.ISO14443-4_RATS_PPS command.

#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_INIT_INS 0x11
	Sam AV3 Insturction code for Cmd.ISO14443-4_Init command.

#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_EXCHANGE_INS 0xEC
	Sam AV3 Insturction code for Cmd.ISO14443-4_Exchange command.

#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_PRESENCE_CHECK_INS 0x4C
	Sam AV3 Insturction code for Cmd.ISO14443-4_Init command.

#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_DESELECT_INS 0xD4
	Sam AV3 Insturction code for Cmd.ISO14443-4_Deselect command.

#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_FREE_CID_INS 0xFC
	Sam AV3 Insturction code for Cmd.ISO14443-4_Init command.

Option for Cmd.ISO14443-4_Deselect command.
#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_DESELECT_DO_NOT_FREE_CID 0x00
	Option to not free CID is deselect fails.

#define	PHHAL_HW_SAMAV3_CMD_ISO14443_4_DESELECT_FORCE_FREE_CID 0x01
	Option to forcefully free CID in any case.

Detailed Description

SAM commands used for ISO14443 layer 4 communication in X-Mode.

Function Documentation

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_RATS_PPS()

phStatus_t phhalHw_SamAV3_Cmd_X_ISO14443_4_RATS_PPS	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint8_t	bCidIn,
		uint8_t	bDsiIn,
		uint8_t	bDriIn,
		uint8_t *	pCidOut,
		uint8_t *	pDsiOut,
		uint8_t *	pDriOut,
		uint8_t *	pAts
	)

Perform a combined RATS and PPS to prepare a card for T=CL data exchange.

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]	bCidIn	[In] CID to be sent.
[in]	bDsiIn	[In] DSI to be sent.
[in]	bDriIn	[In] DRI to be sent.
[out]	pCidOut	[Out] CID used (1 byte).
[out]	pDsiOut	[Out] DSI used (1 byte).
[out]	pDriOut	[Out] DRI used (1 byte).
[out]	pAts	[Out] Pointer to a buffer containing the received ATS. The length of the ATS can be found on the first position.

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_Init()

phStatus_t phhalHw_SamAV3_Cmd_X_ISO14443_4_Init	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint8_t	bCid,
		uint8_t	bDri,
		uint8_t	bDsi,
		uint8_t	bFwi,
		uint8_t	bFsci
	)

Perform a init of ISO-14443-4 layer (init T=CL protocol).

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]	bCid	[In] CID to apply.
[in]	bDri	[In] Bit rate PCD -> PICC. PHHAL_HW_RF_DATARATE_106 PHHAL_HW_RF_DATARATE_212 PHHAL_HW_RF_DATARATE_424 PHHAL_HW_RF_DATARATE_848
[in]	bDsi	[In] Bit rate PICC -> PCD. PHHAL_HW_RF_DATARATE_106 PHHAL_HW_RF_DATARATE_212 PHHAL_HW_RF_DATARATE_424 PHHAL_HW_RF_DATARATE_848
[in]	bFwi	[In] Frame waiting time indicator.
[in]	bFsci	[In] Frame size card indicator.

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_Exchange()

phStatus_t phhalHw_SamAV3_Cmd_X_ISO14443_4_Exchange	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint16_t	wOption,
		uint8_t *	pAppDataIn,
		uint8_t	bLenAppData,
		uint8_t **	ppAppDataOut,
		uint16_t *	pAppDataOutLen
	)

Perform an exchange bytes according ISO14443-4 T=CL protocol.

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] Bufferring Option. PH_EXCHANGE_DEFAULT : To send and receive complete data PH_EXCHANGE_TXCHAINING: To excahnge intermediate data
[in]	pAppDataIn	[In] Buffer containing application data to sent.
[in]	bLenAppData	[In] Length of application data to sent.
[out]	ppAppDataOut	[Out] Pointer to buffer containing the data returned by the PICC.
[out]	pAppDataOutLen	[Out] Amount of valid bytes in ppAppDataOut.

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_PresenceCheck()

phStatus_t phhalHw_SamAV3_Cmd_X_ISO14443_4_PresenceCheck ( phhalHw_SamAV3_DataParams_t * pDataParams )

Check if an activated card is still in the field.

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.

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_Deselect()

phStatus_t phhalHw_SamAV3_Cmd_X_ISO14443_4_Deselect	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint8_t	bFreeCid
	)

Perform a Deselect 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.
[in]	bFreeCid	[In] Bitmask for deselect option. PHHAL_HW_SAMAV3_CMD_ISO14443_4_DESELECT_DO_NOT_FREE_CID PHHAL_HW_SAMAV3_CMD_ISO14443_4_DESELECT_FORCE_FREE_CID

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_FreeCid()

phStatus_t phhalHw_SamAV3_Cmd_X_ISO14443_4_FreeCid	(	phhalHw_SamAV3_DataParams_t *	pDataParams,
		uint8_t *	pCid,
		uint8_t	bCidLen
	)

Free one or more currently assigned CIDs.

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]	pCid	[In] Buffer containing all CIDs to be freed.
[in]	bCidLen	[In] Length of the CID buffer (01h to 0Eh).

Functions

Sam AV3 command code for Sam ISO1443-4 feature.

Option for Cmd.ISO14443-4_Deselect command.

Detailed Description

Function Documentation

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_RATS_PPS()

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_Init()

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_Exchange()

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_PresenceCheck()

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_Deselect()

◆ phhalHw_SamAV3_Cmd_X_ISO14443_4_FreeCid()