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

  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