uicc.hci.services.connectivity

Interface ConnectivityService

All Superinterfaces:

HCIService

public interface ConnectivityService
extends HCIService

The connectivity services defines:

• a mechanism that allows a UICC to start a proactive session as defined in TS 102 223,
• a mechanism to launch an application on the terminal host that is related to the Applet running in the UICC.

Method Summary

Modifier and Type	Method and Description
void	prepareAndSendConnectivityEvent() This non-blocking method builds the HCI event EVT_CONNECTIVITY which notifies the terminal host that it shall send a "HCI connectivity event" as defined in TS 102 223.
void	prepareAndSendTransactionEvent(byte[] parameters, short parametersOffset, short parametersLen) This non-blocking method builds the HCI event EVT_TRANSACTION which notifies the terminal host that it shall launch an application on the terminal which is associated to an Applet in the UICC host identified.
void	prepareAndSendTransactionEvent(byte[] aid, short aidOffset, short aidLen, byte[] parameters, short parametersOffset, short parametersLen) This non-blocking method builds the HCI event EVT_TRANSACTION which notifies the terminal host that it shall launch an application on the terminal which is associated to an Applet in the UICC host identified.

Methods inherited from interface uicc.hci.framework.HCIService

activateEvent, deactivateEvent, deregister, getEventNotificationStatus, register, requestCallbackNotification

Method Detail

prepareAndSendConnectivityEvent

void prepareAndSendConnectivityEvent()
                              throws HCIException

This non-blocking method builds the HCI event EVT_CONNECTIVITY which notifies the terminal host that it shall send a "HCI connectivity event" as defined in TS 102 223.

Throws:

HCIException - with the following reason code:

• HCI_CURRENTLY_DISABLED if the HCI interface was disabled
• HCI_RESOURCES_NOT_AVAILABLE if the contactless framework does not have enough resources to process the command
• HCI_CONDITIONS_NOT_SATISFIED if the conditions to call this method are not satisfied

prepareAndSendTransactionEvent

void prepareAndSendTransactionEvent(byte[] aid,
                                    short aidOffset,
                                    short aidLen,
                                    byte[] parameters,
                                    short parametersOffset,
                                    short parametersLen)
                             throws HCIException,
                                    java.lang.ArrayIndexOutOfBoundsException,
                                    java.lang.NullPointerException

This non-blocking method builds the HCI event EVT_TRANSACTION which notifies the terminal host that it shall launch an application on the terminal which is associated to an Applet in the UICC host identified.

Parameters:

aid - buffer with the AID of the Applet instance

aidOffset - offset in the buffer with the AID

aidLen - AID length

parameters - buffer with the parameters

parametersOffset - offset in the buffer with the parameters

parametersLen - length of the parameters

Throws:

HCIException - with the following reason code:

• HCI_CURRENTLY_DISABLED if the HCI interface was disabled
• HCI_RESOURCES_NOT_AVAILABLE if the contactless framework does not have enough resources to process the command
• HCI_CONDITIONS_NOT_SATISFIED if the conditions to call this method are not satisfied
• HCI_INVALID_LENGTH if the parameter length or the AID is not compliant to TS 102 622[4]

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

java.lang.NullPointerException - if parameters is null or aid is null

prepareAndSendTransactionEvent

void prepareAndSendTransactionEvent(byte[] parameters,
                                    short parametersOffset,
                                    short parametersLen)
                             throws HCIException,
                                    java.lang.ArrayIndexOutOfBoundsException,
                                    java.lang.NullPointerException

This non-blocking method builds the HCI event EVT_TRANSACTION which notifies the terminal host that it shall launch an application on the terminal which is associated to an Applet in the UICC host identified. The Contactless Framework shall add the AID of the calling Applet instance to the HCI event passed to the CLF.

Parameters:

parameters - buffer with the parameters

parametersOffset - offset in the buffer with the parameters

parametersLen - length of the parameters

Throws:

HCIException - with the following reason code:

• HCI_CURRENTLY_DISABLED if the HCI interface was disabled
• HCI_RESOURCES_NOT_AVAILABLE if the contactless framework does not have enough resources to process the command
• HCI_CONDITIONS_NOT_SATISFIED if the conditions to call this method are not satisfied
• HCI_INVALID_LENGTH if the parameter length or the AID is not compliant to TS 102 622[4]

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

java.lang.NullPointerException - if parameters is null