uicc.hci.framework
Class HCIDevice

java.lang.Object
  uicc.hci.framework.HCIDevice

public final class HCIDevice
extends java.lang.Object

This class provides a factory to retrieve instances of HCIService subclasses.

Field Summary

static short	CARD_EMULATION_SERVICE_ID Identifies the service object for card emulation mode functionality
static short	CONNECTIVITY_SERVICE_ID Identifies the service object for connectivity functionality
static byte	FULL_POWER_MODE UICC is activated in full power mode
static byte	LOW_POWER_MODE UICC is activated in low power mode
static short	READER_SERVICE_ID Identifies the service object for reader mode functionality

Constructor Summary

private

HCIDevice() private constructor

Method Summary

static HCIService	getHCIService(short serviceID) This method is used to retrieve instances of HCIService subclasses.
static byte	getPowerMode() This method returns the current power mode of the UICC as defined in TS 102 622.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

READER_SERVICE_ID

public static final short READER_SERVICE_ID

Identifies the service object for reader mode functionality

See Also:

Constant Field Values

CARD_EMULATION_SERVICE_ID

public static final short CARD_EMULATION_SERVICE_ID

Identifies the service object for card emulation mode functionality

See Also:

Constant Field Values

CONNECTIVITY_SERVICE_ID

public static final short CONNECTIVITY_SERVICE_ID

Identifies the service object for connectivity functionality

See Also:

Constant Field Values

LOW_POWER_MODE

public static final byte LOW_POWER_MODE

UICC is activated in low power mode

See Also:

Constant Field Values

FULL_POWER_MODE

public static final byte FULL_POWER_MODE

UICC is activated in full power mode

See Also:

Constant Field Values

Constructor Detail

HCIDevice

private HCIDevice()

private constructor

Method Detail

getHCIService

public static HCIService getHCIService(short serviceID)
                                throws HCIException

This method is used to retrieve instances of HCIService subclasses.

Parameters:

serviceID - shall be one of the constants (*)_SERVICE_ID defined in this class.

Returns:

an instance implementing the indicated service or null if the service object is not available or the Applet is not yet registered to the JCRE. (editor's note: this needs to be improved, align with wording in TS 102 241.)

Throws:

HCIException - with reason (editor's note: TBD: has yet do be defined):

• HCI_ACCESS_NOT_GRANTED if access to the indicated service is not permitted for the Applet (editors's note: sha will check how referencing is done in TS 102 241, further: list under which circumstances this exception shall be thrown.)

getPowerMode

public static byte getPowerMode()

This method returns the current power mode of the UICC as defined in TS 102 622. Possible values are:

• LOW_POWER_MODE
• FULL_POWER_MODE

Returns:

the current power mode or -1 if the power mode can not be retrieved