ISO/IEC14443-4A

These Components implement the additional ISO/IEC 14443-4 activation steps needed for ISO14443 Type-A cards. More...

Collaboration diagram for ISO/IEC14443-4A:

Modules
	Component : Software
	Component : Rd710
	Component : PCSC
	Component : SamAV2_X
	Component : SamAV3_X

Functions
phStatus_t	phpalI14443p4a_Rats (void *pDataParams, uint8_t bFsdi, uint8_t bCid, uint8_t *pAts)
	Perform a ISO14443-4A "Request Answer to Select" command. More...
phStatus_t	phpalI14443p4a_Pps (void *pDataParams, uint8_t bDri, uint8_t bDsi)
	Perform a ISO14443-4A "Protocol and Parameter Selection" command. More...
phStatus_t	phpalI14443p4a_ActivateCard (void *pDataParams, uint8_t bFsdi, uint8_t bCid, uint8_t bDri, uint8_t bDsi, uint8_t *pAts)
	Perform ISO14443-4A Rats and Pps commands. More...
phStatus_t	phpalI14443p4a_GetProtocolParams (void *pDataParams, uint8_t *pCidEnabled, uint8_t *pCid, uint8_t *pNadSupported, uint8_t *pFwi, uint8_t *pFsdi, uint8_t *pFsci)
	Retrieve the ISO14443-4A protocol parameters. More...

DRI/DSI Values
#define	PHPAL_I14443P4A_DATARATE_106   0x00U
	DRI/DSI value for 106 kBit/s
#define	PHPAL_I14443P4A_DATARATE_212   0x01U
	DRI/DSI value for 212 kBit/s
#define	PHPAL_I14443P4A_DATARATE_424   0x02U
	DRI/DSI value for 424 kBit/s
#define	PHPAL_I14443P4A_DATARATE_848   0x03U
	DRI/DSI value for 848 kBit/s

Detailed Description

These Components implement the additional ISO/IEC 14443-4 activation steps needed for ISO14443 Type-A cards.

Function Documentation

phpalI14443p4a_Rats()

phStatus_t phpalI14443p4a_Rats	(	void *	pDataParams,
		uint8_t	bFsdi,
		uint8_t	bCid,
		uint8_t *	pAts
	)

Perform a ISO14443-4A "Request Answer to Select" command.

[FSDI to FSD conversion]
----------------------------------------------------------------------------------------
FSDI         | 00 | 01 | 02 | 03 | 04 | 05 | 06 | 07  | 08  | 09  | 0A   | 0B   | 0C   |
----------------------------------------------------------------------------------------
FSD (bytes)  | 16 | 24 | 32 | 40 | 48 | 64 | 96 | 128 | 256 | 512 | 1024 | 2018 | 4096 |
----------------------------------------------------------------------------------------

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_PROTOCOL_ERROR	Invalid response received.
Other	Depending on implementation and underlaying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bFsdi	[In] Frame Size Integer; 0-8 (0xC for SW implementation to support 4k frames)
[in]	bCid	[In] Card Identifier; 0-14
[out]	pAts	[Out] Answer to Select; uint8_t[255]

phpalI14443p4a_Pps()

phStatus_t phpalI14443p4a_Pps	(	void *	pDataParams,
		uint8_t	bDri,
		uint8_t	bDsi
	)

Perform a ISO14443-4A "Protocol and Parameter Selection" command.

The following values for bDri and bDsi are possible:

• PHPAL_I14443P4A_DATARATE_106
• PHPAL_I14443P4A_DATARATE_212
• PHPAL_I14443P4A_DATARATE_424
• PHPAL_I14443P4A_DATARATE_848

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_PROTOCOL_ERROR	Invalid response received.
Other	Depending on implementation and underlaying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bDri	[In] Divisor Receive (PCD to PICC) Integer; 0-3
[in]	bDsi	[In] Divisor Send (PICC to PCD) Integer; 0-3

phpalI14443p4a_ActivateCard()

phStatus_t phpalI14443p4a_ActivateCard	(	void *	pDataParams,
		uint8_t	bFsdi,
		uint8_t	bCid,
		uint8_t	bDri,
		uint8_t	bDsi,
		uint8_t *	pAts
	)

Perform ISO14443-4A Rats and Pps commands.

Returns

Status code

Return values

PH_ERR_SUCCESS	Operation successful.
PH_ERR_PROTOCOL_ERROR	Invalid response received.
PH_ERR_FRAMING_ERROR	Bcc invalid.
Other	Depending on implementation and underlaying component.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[in]	bFsdi	[In] Frame Size Integer; 0-8 (0xC for SW implementation to support 4k frames)
[in]	bCid	[In] Card Identifier; 0-14
[in]	bDri	[In] Divisor Receive (PCD to PICC) Integer; 0-3
[in]	bDsi	[In] Divisor Send (PICC to PCD) Integer; 0-3
[out]	pAts	[Out] Answer to Select; uint8_t[255]

phpalI14443p4a_GetProtocolParams()

phStatus_t phpalI14443p4a_GetProtocolParams	(	void *	pDataParams,
		uint8_t *	pCidEnabled,
		uint8_t *	pCid,
		uint8_t *	pNadSupported,
		uint8_t *	pFwi,
		uint8_t *	pFsdi,
		uint8_t *	pFsci
	)

Retrieve the ISO14443-4A protocol parameters.

Returns

Status code

Return values

PH_ERR_SUCCESS

Operation successful.

Parameters

[in]	pDataParams	[In] Pointer to this layer's parameter structure.
[out]	pCidEnabled	[Out] Unequal '0' if Card Identifier is enabled.
[out]	pCid	[Out] Card Identifier.
[out]	pNadSupported	[Out] Node Address Support; Unequal '0' if supported.
[out]	pFwi	[Out] Frame Waiting Integer.
[out]	pFsdi	[Out] PCD Frame Size Integer; 0-8 (0xC for SW implementation to support 4k frames).
[out]	pFsci	[Out] PICC Frame Size Integer; 0-8 (0xC for SW implementation to support 4k frames).