com.gsma.services.utils

Class Handset

java.lang.Object

com.gsma.services.utils.Handset

public class Handset
extends Object

This class handles the handset configuration and properties.

Since:

TS.26 V6.0

Field Summary

Fields

Modifier and Type	Field and Description
static int	BATTERY_LOW_MODE Device property [Battery Levels].
static int	BATTERY_OPERATIONAL_MODE Device property [Battery levels].
static int	BATTERY_POWER_OFF_MODE Device property [Battery levels].
static int	FELICA Device property [NFC Technologies].
static int	HCI_SWP Device property [Contactless Frontend].
static int	MIFARE_CLASSIC Device property [NFC Technologies].
static int	MIFARE_DESFIRE Device property [NFC Technologies].
static int	MULTIPLE_ACTIVE_CEE Device property [Contactless Frontend].
static int	NFC_FORUM_TYPE3 Device property [NFC Technologies].
static int	OMAPI Device property [Framework components].

Constructor Summary

Constructors

Constructor and Description
Handset()

Method Summary

Methods

Modifier and Type	Method and Description
void	enableMultiEvt_transactionReception() Asks the system to inform "transaction events" to any authorized/registered components via BroadcastReceiver. Change SHALL not imply a power cycle and SHALL be valid until next handset reboot. Applications SHALL register to com.gsma.services.nfc.TRANSACTION_EVENT for receiving related events.
List<String>	getAvailableSecureElements(int batteryLevel) Return the list of Secure Elements which can be used by the NFC Controller when handset is operating in a following battery level: BATTERY_LOW_MODE BATTERY_POWER_OFF_MODE BATTERY_OPERATIONAL_MODE
boolean	getProperty(int feature) Return handset status for the following features: HCI_SWP, MULTIPLE_ACTIVE_CEE FELICA, MIFARE_CLASSIC, MIFARE_DESFIRE, NFC_FORUM_TYPE3 OMAPI BATTERY_LOW_MODE, BATTERY_POWER_OFF_MODE
int	getVersion() Return the version of device requirements supported.

Methods inherited from class java.lang.Object

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

Field Detail

HCI_SWP

public static final int HCI_SWP

Device property [Contactless Frontend].

See Also:

Constant Field Values

MULTIPLE_ACTIVE_CEE

public static final int MULTIPLE_ACTIVE_CEE

Device property [Contactless Frontend].

See Also:

Constant Field Values

FELICA

public static final int FELICA

Device property [NFC Technologies].

See Also:

Constant Field Values

MIFARE_CLASSIC

public static final int MIFARE_CLASSIC

Device property [NFC Technologies].

See Also:

Constant Field Values

MIFARE_DESFIRE

public static final int MIFARE_DESFIRE

Device property [NFC Technologies].

See Also:

Constant Field Values

NFC_FORUM_TYPE3

public static final int NFC_FORUM_TYPE3

Device property [NFC Technologies].

See Also:

Constant Field Values

OMAPI

public static final int OMAPI

Device property [Framework components].

See Also:

Constant Field Values

BATTERY_LOW_MODE

public static final int BATTERY_LOW_MODE

Device property [Battery Levels].

See Also:

Constant Field Values

BATTERY_POWER_OFF_MODE

public static final int BATTERY_POWER_OFF_MODE

Device property [Battery levels].

See Also:

Constant Field Values

BATTERY_OPERATIONAL_MODE

public static final int BATTERY_OPERATIONAL_MODE

Device property [Battery levels].

Since:

TS.26 V8.0

See Also:

Constant Field Values

Constructor Detail

Handset

public Handset()

Method Detail

getVersion

public int getVersion()

Return the version of device requirements supported.

Returns:

version of the GSMA NFC Requirements

Since:

TS.26 V6.0 (REQ_132)

getProperty

public boolean getProperty(int feature)

Return handset status for the following features:

• HCI_SWP, MULTIPLE_ACTIVE_CEE
• FELICA, MIFARE_CLASSIC, MIFARE_DESFIRE, NFC_FORUM_TYPE3
• OMAPI
• BATTERY_LOW_MODE, BATTERY_POWER_OFF_MODE

Parameters:

feature - Requested feature

Returns:

true if the feature is supported; false otherwise

Throws:

IllegalArgumentException - Method is invoked with null or an illegal argument.

Since:

TS.26 V6.0 (REQ_132)

getAvailableSecureElements

public List<String> getAvailableSecureElements(int batteryLevel)

Return the list of Secure Elements which can be used by the NFC Controller
when handset is operating in a following battery level:

• BATTERY_LOW_MODE
• BATTERY_POWER_OFF_MODE
• BATTERY_OPERATIONAL_MODE

Parameters:

batteryLevel - Battery level the handset is operating

Returns:

The list of Secure Elements names, or Collections.emptyList() if none of them are supported

Since:

TS.26 V8.0 (REQ_059/REQ_060)

See Also:

SIM Alliance Open Mobile APIs for Secure Element name guidelines

enableMultiEvt_transactionReception

public void enableMultiEvt_transactionReception()

Asks the system to inform "transaction events" to any authorized/registered components via BroadcastReceiver.
Change SHALL not imply a power cycle and SHALL be valid until next handset reboot.

Applications SHALL register to com.gsma.services.nfc.TRANSACTION_EVENT for receiving related events.

Throws:

SecurityException - Only applications signed with a trusted certificate may call this API.

Since:

TS.26 V6.0 (REQ_099)