beautypg.com

Maxim Integrated 73S12xxF Software User Manual

Page 74

background image

73S12xxF Software User Guide

UG_12xxF_016

74

Rev. 1.50

whereas the ISO 7816-3 standard allows an error recovery procedure. EMV
specifies that the IFD must initiate an IFSD negotiation before the first command
transmission in (T=1) protocol. When EMV mode is specified, bIccIFSDRequestT1
is set to TRUE and bIccDeactivatedOnTimeOutErrorT1 is set to TRUE.

bIccHighSpeed: Input parameter
Specifies if the reader has to switch to the high speed clock (7.384 MHz) if the smart
card allows it (according to parameter Fi in the ATR). If this parameter is FALSE, the
reader will always use the default clock, namely 3.692 MHz. If the value is TRUE,
the reader will switch to 7.384 MHz after the ATR, if the smart card allows this speed.

bIccClockStopEnable: Input parameter
If this flag is set to TRUE and the smart card allows clock stop/start, the clock will be
stopped when there is no transaction. That is to say that the clock is stopped after a
command is done and restarted before the next command will be executed.

ucIccPowerSelect: Input parameter
Specifies the voltage that is to be applied to the card. Possible values are:

ICC_POWER_AUTOMATIC 00, (automatic voltage selection according to ISO

7816-3 standard)

ICC_POWER_SET_5

01,

ICC_POWER_SET_3

02, Other values are RFU.

pucIccATR: Output parameter
The ATR value returned by the Smart Card.

pucIccATRLength: Output parameter
Length of the ATR returned by the Smart Card. This value should not exceed 32, as
the ATR cannot contain more than 32 bytes.

Send_WTE: Input parameter
Call this function whenever the card sends a Wait Time Extension request (in T=1,
whenever the card sends an S(WTX) block; for T=0, whenever the card sends NULL
(0x60) when it is waiting for data from the reader). This functionality is required by
the CCID Specification. This callback function will NOT be called if the smart card is
called for EMV mode because of the strict timing requirements of the EMV
Specification.

Return Codes

AR_ICC_OK

Successful operation. The Smart Card was activated and the ATR is supported
by the chip.

AR_ICC_ERR_BAD_PARAM

An invalid parameter (eIccId for example) was specified.

AR_ICC_ERR_CARD_MUTE

The Smart Card is mute.

AR_ICC_ERR_CARD_ABSENT

No Smart Card is inserted.

AR_ICC_ERR_CARD_DISCONNECTED

The Smart Card was deactivated.

AR_ICC_ERR_CARD_OVERLOAD

The Smart Card has generated an over current.

AR_ICC_ERR_CARD_UNSUPPORTED_ATR

The Smart Card ATR is not supported by the chip and is stored in pucIccAtr.
The Smart Card interface has not been de-activated (bIccATRAutoCheck option
is not selected).

AR_ICC_ERR_BAD_TCK

The ATR has a bad TCK byte.

AR_ICC_ERR_BAD_TS

The ATR has a bad TS byte.

AR_ICC_ERR_CARD_COMM_PB

The ATR has either a parity error, an Rx over-run or a VCC unstable error.