TlpIccWarmReset

PURPOSE

Warm reset of the ICC.

PROTOTYPE

Trap: TlpErr TlpIccWarmReset (UInt16 refNum, UInt8 *controlerType, UInt8 *iccType, UInt8 *atr, UInt16 *atrLength)

PARAMETERS

controlerType		OUT	controler type
iccType		OUT	card type
atr		OUT	the card ATR string
atrLength	IN	OUT	the atr length

DESCRIPTION

Warm reset the ICC, which must have been powered on.

atr receive the ATR string sent by the ICC upon reset, up to atrLength bytes. atrLength is then set to the exact number of bytes written to atr.

Note that the ATR string includes the trailing status bytes (usually 0x90 and 0x00) returned by the card.

RETURN CODES

tlpSuccess

Successfull operation.

tlpErrUnknownReaderCommand

Unknow reader command (not a valid command code).

tlpErrResetMute

No ATR received (the card does not respond).

tlpErrResetParityError

ATR with parity error (after several attemps to retransmit).

tlpErrResetIncorectTck

ATR with incorect TCK (FIXME: what is a TCK? Time Clock?).

tlpErrIccRemoved

ICC removed (the card was withdrawn while carrying out the command).

tlpErrIccAbsent

ICC not present in the terminal.

tlpErrPalmOS

Error from the Palm host (such as a serial or memory error). Call TlpGetLastErr to get the last Palm error code.

tlpErrConversation

Conversation error between the host and the terminal.

SEE ALSO

TlpIccPowerOn.