uicc.hci.services.readermode
Interface ReaderMessage

All Superinterfaces:

HCIMessage

public interface ReaderMessage
extends HCIMessage

The ReaderMessage offers specialized methods for generate Contactless Reader commands or events.

Field Summary

static byte	MULTIPLE_TARGET_STATUS when there are several targets in the field irrespective of the RF technology
static byte	PARAM_ID_TYPE_A_READER_APPLICATION_DATA The historical bytes as defined in ISO/IEC 14443-3 for type A
static byte	PARAM_ID_TYPE_A_READER_ATQA Pre-formatted ATQA as defined in ISO/IEC 14443-3 for type A (see TS 102 622 for coding of the value)
static byte	PARAM_ID_TYPE_A_READER_DATARATE_MAX Maximum data rate supported
static byte	PARAM_ID_TYPE_A_READER_FWI SFGT Frame waiting time and start-up frame guard time as defined in ISO/IEC 14443-4 for type A
static byte	PARAM_ID_TYPE_A_READER_SAK Pre-formatted SAK as defined in ISO/IEC 14443-3 for type A
static byte	PARAM_ID_TYPE_A_READER_UID UID as defined in ISO/IEC 14443-3 for type A
static byte	PARAM_ID_TYPE_B_READER_AFI Application family identifier as defined in ISO/IEC 14443-3 for type B used by the reader to poll the target
static byte	PARAM_ID_TYPE_B_READER_APPLICATION_DATA Application data as defined in ISO/IEC 14443-3 for ATQB
static byte	PARAM_ID_TYPE_B_READER_HIGHER_LAYER_DATA Higher layer data as defined in ISO/IEC 14443-3 for ATTRIB command
static byte	PARAM_ID_TYPE_B_READER_HIGHER_LAYER_RESPONSE Higher layer response as defined in ISO/IEC 14443-3 for answer to ATTRIB command
static byte	PARAM_ID_TYPE_B_READER_PUPI PUPI as defined in ISO/IEC 14443-3 for type B
static byte	RESP_ANY_E_TIMEOUT An Applet level time-out occurred.
static byte	RESP_WR_RF_ERROR The target has returned an RF error.
static byte	SINGLE_TARGET_STATUS when there is a single target in the reader field and the activation of the target is completed
static byte	TIMEOUT_1_S
static byte	TIMEOUT_1200_MICS
static byte	TIMEOUT_154_MS
static byte	TIMEOUT_19_MS
static byte	TIMEOUT_2_S
static byte	TIMEOUT_2400_MICS
static byte	TIMEOUT_300_MICS Time out values does it make sense to have these values here defined how does the Applet developer know how to use them ???
static byte	TIMEOUT_309_MS
static byte	TIMEOUT_38_MS
static byte	TIMEOUT_4_S
static byte	TIMEOUT_4800_MICS
static byte	TIMEOUT_600_MICS
static byte	TIMEOUT_618_MS
static byte	TIMEOUT_77_MS
static byte	TIMEOUT_9600_MICS

Fields inherited from interface uicc.hci.framework.HCIMessage

INS_ANY_CLOSE_PIPE, INS_ANY_GET_PARAMETER, INS_ANY_OPEN_PIPE, INS_ANY_SET_PARAMETER, RESP_ADM_E_NO_PIPES_AVAILABLE, RESP_ANY_E_CMD_NOT_SUPPORTED, RESP_ANY_E_CMD_PAR_UNKNOWN, RESP_ANY_E_INHIBITED, RESP_ANY_E_NOK, RESP_ANY_E_NOT_CONNECTED, RESP_ANY_E_PIPE_ACCESS_DENIED, RESP_ANY_E_PIPE_NOT_OPENED, RESP_ANY_E_REG_ACCESS_DENIED, RESP_ANY_E_REG_PAR_UNKNOWN, RESP_ANY_OK, TYPE_COMMAND, TYPE_EVENT, TYPE_RESPONSE

Method Summary

void	prepareAndSendGetParameterCommand(byte paramID) This method builds the HCI command ANY_GET_PARAMETER for the indicated information and sends it to the Contactless Reader Gate of the CLF.
void	prepareAndSendWriteXchgDataCommand(byte timeout, byte[] data, short offset, short len) This method builds the HCI command WR_XCHG_DATA with the data passed in the parameter data and sends it to the Contactless Reader Gate of the CLF.
void	restartReaderModeProcedure() This method sends first the HCI event EVT_END_OPERATION and then the HCI event EVT_READER_REQUESTED.

Methods inherited from interface uicc.hci.framework.HCIMessage

getInstruction, getReceiveBuffer, getReceiveLength, getReceiveOffset, getType, isComplete, isHeading

Field Detail

RESP_ANY_E_TIMEOUT

static final byte RESP_ANY_E_TIMEOUT

An Applet level time-out occurred. it's the ANY_ Parameter not defined in HCIMessage ???

See Also:

Constant Field Values

RESP_WR_RF_ERROR

static final byte RESP_WR_RF_ERROR

The target has returned an RF error.

See Also:

Constant Field Values

SINGLE_TARGET_STATUS

static final byte SINGLE_TARGET_STATUS

when there is a single target in the reader field and the activation of the target is completed

See Also:

Constant Field Values

MULTIPLE_TARGET_STATUS

static final byte MULTIPLE_TARGET_STATUS

when there are several targets in the field irrespective of the RF technology

See Also:

Constant Field Values

PARAM_ID_TYPE_A_READER_UID

static final byte PARAM_ID_TYPE_A_READER_UID

UID as defined in ISO/IEC 14443-3 for type A

See Also:

Constant Field Values

PARAM_ID_TYPE_A_READER_ATQA

static final byte PARAM_ID_TYPE_A_READER_ATQA

Pre-formatted ATQA as defined in ISO/IEC 14443-3 for type A (see TS 102 622 for coding of the value)

See Also:

Constant Field Values

PARAM_ID_TYPE_A_READER_APPLICATION_DATA

static final byte PARAM_ID_TYPE_A_READER_APPLICATION_DATA

The historical bytes as defined in ISO/IEC 14443-3 for type A

See Also:

Constant Field Values

PARAM_ID_TYPE_A_READER_SAK

static final byte PARAM_ID_TYPE_A_READER_SAK

Pre-formatted SAK as defined in ISO/IEC 14443-3 for type A

See Also:

Constant Field Values

PARAM_ID_TYPE_A_READER_FWI

static final byte PARAM_ID_TYPE_A_READER_FWI

SFGT Frame waiting time and start-up frame guard time as defined in ISO/IEC 14443-4 for type A

See Also:

Constant Field Values

PARAM_ID_TYPE_A_READER_DATARATE_MAX

static final byte PARAM_ID_TYPE_A_READER_DATARATE_MAX

Maximum data rate supported

See Also:

Constant Field Values

PARAM_ID_TYPE_B_READER_PUPI

static final byte PARAM_ID_TYPE_B_READER_PUPI

PUPI as defined in ISO/IEC 14443-3 for type B

See Also:

Constant Field Values

PARAM_ID_TYPE_B_READER_APPLICATION_DATA

static final byte PARAM_ID_TYPE_B_READER_APPLICATION_DATA

Application data as defined in ISO/IEC 14443-3 for ATQB

See Also:

Constant Field Values

PARAM_ID_TYPE_B_READER_AFI

static final byte PARAM_ID_TYPE_B_READER_AFI

Application family identifier as defined in ISO/IEC 14443-3 for type B used by the reader to poll the target

See Also:

Constant Field Values

PARAM_ID_TYPE_B_READER_HIGHER_LAYER_RESPONSE

static final byte PARAM_ID_TYPE_B_READER_HIGHER_LAYER_RESPONSE

Higher layer response as defined in ISO/IEC 14443-3 for answer to ATTRIB command

See Also:

Constant Field Values

PARAM_ID_TYPE_B_READER_HIGHER_LAYER_DATA

static final byte PARAM_ID_TYPE_B_READER_HIGHER_LAYER_DATA

Higher layer data as defined in ISO/IEC 14443-3 for ATTRIB command

See Also:

Constant Field Values

TIMEOUT_300_MICS

static final byte TIMEOUT_300_MICS

Time out values does it make sense to have these values here defined how does the Applet developer know how to use them ???

See Also:

Constant Field Values

TIMEOUT_600_MICS

static final byte TIMEOUT_600_MICS

See Also:

Constant Field Values

TIMEOUT_1200_MICS

static final byte TIMEOUT_1200_MICS

See Also:

Constant Field Values

TIMEOUT_2400_MICS

static final byte TIMEOUT_2400_MICS

See Also:

Constant Field Values

TIMEOUT_4800_MICS

static final byte TIMEOUT_4800_MICS

See Also:

Constant Field Values

TIMEOUT_9600_MICS

static final byte TIMEOUT_9600_MICS

See Also:

Constant Field Values

TIMEOUT_19_MS

static final byte TIMEOUT_19_MS

See Also:

Constant Field Values

TIMEOUT_38_MS

static final byte TIMEOUT_38_MS

See Also:

Constant Field Values

TIMEOUT_77_MS

static final byte TIMEOUT_77_MS

See Also:

Constant Field Values

TIMEOUT_154_MS

static final byte TIMEOUT_154_MS

See Also:

Constant Field Values

TIMEOUT_309_MS

static final byte TIMEOUT_309_MS

See Also:

Constant Field Values

TIMEOUT_618_MS

static final byte TIMEOUT_618_MS

See Also:

Constant Field Values

TIMEOUT_1_S

static final byte TIMEOUT_1_S

See Also:

Constant Field Values

TIMEOUT_2_S

static final byte TIMEOUT_2_S

See Also:

Constant Field Values

TIMEOUT_4_S

static final byte TIMEOUT_4_S

See Also:

Constant Field Values

Method Detail

prepareAndSendGetParameterCommand

void prepareAndSendGetParameterCommand(byte paramID)
                                       throws HCIException,
                                              javacard.framework.SystemException

This method builds the HCI command ANY_GET_PARAMETER for the indicated information and sends it to the Contactless Reader Gate of the CLF. The prepareGetParameterCommand method should only be called when the CLF has successfully discovered a card in the field, i.e. after reception of the HCI event EVT_TARGET_DISCOVERED.

Parameters:

paramID, - shall be one of the PARAM_* values defined in this interface

Throws:

HCIException - (editor's note: add exceptions)

javacard.framework.SystemException - with the following reason code:

• ILLEGAL_VALUE
  • if the paramID does not match with the predefined values

prepareAndSendWriteXchgDataCommand

void prepareAndSendWriteXchgDataCommand(byte timeout,
                                        byte[] data,
                                        short offset,
                                        short len)
                                        throws HCIException,
                                               java.lang.NullPointerException,
                                               java.lang.ArrayIndexOutOfBoundsException,
                                               javacard.framework.SystemException

This method builds the HCI command WR_XCHG_DATA with the data passed in the parameter data and sends it to the Contactless Reader Gate of the CLF. The response data from the CLF will be transferred to the UICC with the event ReaderListener.EVENT_WRITE_EXCHANGE_DATA_RESPONSE.

Parameters:

timeout - -1 if no timeout, or one of the TIMEOUT_* values defined in this interface

data - bytearray holding the data to send to the CLF

offset - into the bytearray indicating the start of the data to send to the CLF

len - overall length of data that will be send to the CLF

Throws:

HCIException - (editor's note: add exceptions)

java.lang.NullPointerException - if data is null

java.lang.ArrayIndexOutOfBoundsException - if operation would cause access of data outside array bounds.

javacard.framework.SystemException - with the following reason code:

• ILLEGAL_VALUE
  • if the timeout value does not match with the predefined values

restartReaderModeProcedure

void restartReaderModeProcedure()
                                throws HCIException

This method sends first the HCI event EVT_END_OPERATION and then the HCI event EVT_READER_REQUESTED. This method is intended to recover from the following error states:

reception of RESP_ANY_E_TIMEOUT

reception of RESP_WR_RF_ERROR

reception of EVT_TARGET_DISCOVERED with a MULTIPLE_TARGET_STATUS

Throws:

HCIException - (editor's note: which exceptions? new reason code 'not activated' or excisting exception: ACCESS_NOT_GRANTED)