brp_Iso14L4_SetupAPDU()

brp_errcode brp_Iso14L4_SetupAPDU	(	brp_protocol	protocol,
		bool	EnDefault,
		unsigned	ToggleAB,
		bool	EnNAD,
		bool	EnCID,
		unsigned	CID,
		unsigned	NAD,
		brp_Iso14L4_SetupAPDU_FSCI	FSCI,
		brp_Iso14L4_SetupAPDU_FWI	FWI,
		brp_DivisorInteger	DSI,
		brp_DivisorInteger	DRI
	)

Setup communication parameters and select a certain PICC for APDU exchange.

The chosen settings will be applied to all subsequent calls of the brp_Iso14L4_ExchangeAPDU() and brp_Iso14L4_Deselect() commands.

The FrameParam and Bitrate parameters have to be chosen according to the PICC's capabilities.

In some cases, the CID of the label to select has to be passed as a parameter. This is the case if the label supports the feature of being assigned a CID, and if a CID value has been previously assigned to the PICC using the brp_Iso14a_RequestATS() command (for ISO 14443 Type A labels) or by the or the brp_Iso14b_Attrib() command (for ISO 14443 Type B labels). Otherwise, the CID functionality should be disabled, by clearing the EnCID flag.

PICCs which do not support a CID (for which the returned CID value from the brp_Iso14a_RequestATS() command, or from the brp_Iso14b_Request() command, is 0x00) will only respond to the brp_Iso14L4_ExchangeAPDU() and brp_Iso14L4_Deselect() commands if the CID functionality is disabled.

A PICC, which supports a CID, will

1. respond to the brp_Iso14L4_ExchangeAPDU() and brp_Iso14L4_Deselect() commands only if the CID functionality is enabled and if the specified CID value matches the PICC's own CID value.
2. ignore the brp_Iso14L4_ExchangeAPDU() and brp_Iso14L4_Deselect() commands if a different CID value is specified.
3. also respond to brp_Iso14L4_ExchangeAPDU() and brp_Iso14L4_Deselect() commands with a disabled CID functionality, if its own CID value is 0.

The NAD parameter may be used to select a certain logical application (node) on the target PICC, if these are supported by this PICC.

Parameters

[in]	protocol	used to execute the command
[in]	EnDefault	If this flag is set, the default settings for FrameParam and Bitrate will be applied instead of the given parameter values.
[in]	ToggleAB	If this flag is set, communication with the PICC will be performed according to the ISO 14443 Type B standard. Otherwise, communication will be performed according to the ISO 14443 Type A standard.
[in]	EnNAD	Enables the NAD functionality.
[in]	EnCID	Enables the CID functionality.
[in]	CID	Specifies a CID value, which shall be used for all subsequent calls of the brp_Iso14L4_ExchangeAPDU() and brp_Iso14L4_Deselect() commands. If EnCID is not set, this parameter will be ignored and the CID functionality will be disabled.
[in]	NAD	Specifies a NAD value, which shall be used for all subsequent calls of the brp_Iso14L4_ExchangeAPDU() command. If EnNAD is not set, this parameter will be ignored and the NAD functionality will be disabled.
[in]	FSCI	Frame Size proximity Card Integer (FSCI). This value is mapped to the Frame Size proximity Card (FSC) value, which indicates the maximum frame size accepted by the PICC. The possible FSC values (mapped to the FSCI index) are listed below.
[in]	FWI	Frame Waiting time Integer (FWI). This value is necessary for calculation of the Frame Waiting Time (FWT) value, representing the maximum time needed by the PICC between receiving a frame and sending the corresponding answer. FWT is calculated by: FWT = (256 * 16 / 13.56 MHz) * 2 ^ FWI The FWT values given here (mapped to the FWI index) are approximate.
[in]	DSI	Divisor Send/Receive Integer (DSI/DRI) This parameter is mapped to the Divisor Send/Receive (DS/DI) value, which determines bit rate for sending data from PICC to PCD. The possible DS/DR values (mapped to the DSI/DRI index) are listed below.
[in]	DRI	Divisor Send/Receive Integer (DSI/DRI) This parameter is mapped to the Divisor Send/Receive (DS/DI) value, which determines bit rate for sending data from PICC to PCD. The possible DS/DR values (mapped to the DSI/DRI index) are listed below.