beautypg.com

Icc_status(), E 35) – Maxim Integrated 73S12xxF Software User Manual

Page 35

background image


UG_12xxF_016

73S12xxF Software User Guide

Rev. 1.50

35

IccATR_TimeoutEnabled: Input parameter
Specifies if the ATR timeout is enabled (TRUE) or disabled (FALSE).

IccATR_Timeout: Input parameter
Specifies the maximum delay in ETUs between the leading edge of the first character
and last character of the ATR response, if enabled.

IccTS_Timeout: Input parameter
Specifies the maximum delay in ETUs between the de-assertion of the RST signal
and the leading edge of the TS byte of the ATR.

pIccATR: Input parameter.
Pointer to the ICC_Rx_t structure.


Return Codes

ICC_OK

The SmartCard is present and active.

ICC_ACTIVATION_INCOMPLETE

The SmartCard is present, but its reset is still asserted.

ICC_ERR_OVERCURRENT or ICC_ERR_VCC_UNSTABLE

An attempt to activate the SmartCard caused an over current condition and it
has been deactivated.

ICC_ERR_REMOVED

The SmartCard is not present.

ICC_ERR_TIMEOUT

One of the maximum delays was exceeded forcing a timeout. Take appropriate
action.

ICC_ERR_BREAK

Data was always received with parity error, necessitating break signaling of the
Smart Card (T=0 protocol).

ICC_ERR_PARITY

A byte was received with an invalid parity.

ICC_RX_PENDING

Reception has started, but is not yet completed. This code is returned on either
a successful completion or a termination due to error.

ICC_RX_OVERRUN

An Rx overrun condition has occurred, resulting in the loss of at least one byte.

If the Smart Card was powered-down on entry, this function will perform a cold-reset.
If the Smart Card was powered-up on entry, this function will perform a warm-reset.
This function will return after reception of the TS byte or an error condition.


The ICC_t structure should be set up to expect the largest possible ATR response. Call

ICC_RxLen()

to

determine the current total number of bytes received. Call

ICC_RxDone()

to complete ATR reception.

(Refer to

ICC_Tx()

or

ICC_Rx()

for the ICC_t structure definition)


ICC_Status()

Purpose

Retrieve the presence and active status of all the Smart Cards.


Synopsis

void ICC_Status ( OUT int *pnIccPresent, OUT int *pnIccActive );


Parameters

pnIccPresent: Output parameter
Specifies which SmartCards are present, Bit[n] corresponding to ICC[n], Bit[1] being
mapped to the least significant bit.

PnIccActive: Output parameter
Specifies which SmartCards are active, Bit[n] corresponding to ICC[n].


Return Codes None.