TlpIccPowerOn

PURPOSE

Wait for an ICC and power it on.

PROTOTYPE

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

PARAMETERS

timeOut	IN		maximum insertion card wait time
controlerType		OUT	controler type
iccType		OUT	card type
atr		OUT	the card ATR string
atrLength	IN	OUT	the atr length

DESCRIPTION

Wait for a card for at most timeOut seconds (0-255), then power the card. An ICC cold reset is ensured by a prior power off.

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

TlpIccWarmReset,
TlpIccPowerOff.