ej.ecom.mobile

Class MobileManager

java.lang.Object

ej.ecom.mobile.MobileManager

public class MobileManager
extends Object

This class provides APIs to manage modem features.

Method Summary

Modifier and Type	Method and Description
void	changePinCode(String pinCode) Changes an existing PIN code to a new PIN code.
void	disablePinLock(String pinCode) Disables the PIN code locking of the SIM card.
void	enablePinLock(String pinCode) Enables the PIN code locking of the SIM card.
String	getImei() Gets the IMEI (International Mobile Equipment Identity).
static MobileManager	getManager() Gets the unique MobileManager instance.
String	getMsisdn() Gets the current MSISDN (Mobile Station ISDN Number).
int	getRssi() Gets the RSSI (Received Signal Strength Indication) of the modem.
String	getSpn() Gets the SPN (Service Provider Name) of the mobile network.
boolean	isPinLockEnabled() Checks whether the PIN lock is enabled or not.
void	setPinCode(String pinCode) Sets the PIN code to be used for unlocking the SIM card.

Methods inherited from class java.lang.Object

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

Method Detail

changePinCode

public void changePinCode(String pinCode)
                   throws IOException

Changes an existing PIN code to a new PIN code. Note: This function is intended to be used at run-time, after the modem is started, and with a SIM card already locked, for which the PIN code is already provided (via setPinCode(String) or enablePinLock(String)).

Parameters:

pinCode - the new PIN code.

Throws:

IOException - if the PIN code could not be changed.

disablePinLock

public void disablePinLock(String pinCode)
                    throws IOException

Disables the PIN code locking of the SIM card. Note: This function is intended to be used at run-time, after the modem is started, and with a SIM card that is currently locked, for which the PIN code is already provided (via setPinCode(String) or enablePinLock(String)).

Parameters:

pinCode - the SIM PIN.

Throws:

IOException - if the "lock SIM card" facility can not be disabled (wrong PIN, facility already disabled, other errors).

enablePinLock

public void enablePinLock(String pinCode)
                   throws IOException

Enables the PIN code locking of the SIM card. Note: This function is intended to be used at run-time, after the modem is started, and with a SIM card that is not currently locked with a PIN code.

Parameters:

pinCode - the PIN code.

Throws:

IOException - if the "lock SIM card" facility can not be enabled (wrong PIN, facility already enabled, other errors).

getImei

public String getImei()
               throws IOException

Gets the IMEI (International Mobile Equipment Identity).

Returns:

the IMEI.

Throws:

IOException - if the IMEI could not be retrieved.

getManager

public static MobileManager getManager()

Gets the unique MobileManager instance.

Returns:

the Mobile manager object instance.

getMsisdn

public String getMsisdn()
                 throws IOException

Gets the current MSISDN (Mobile Station ISDN Number).

Returns:

the MSISDN.

Throws:

IOException - if the MSISDN could not be retrieved.

getRssi

public int getRssi()
            throws IOException

Gets the RSSI (Received Signal Strength Indication) of the modem.

Returns:

the RSSI in dBm unit.

Throws:

IOException - if the RSSI could not be retrieved.

getSpn

public String getSpn()
              throws IOException

Gets the SPN (Service Provider Name) of the mobile network.

Returns:

the SPN.

Throws:

IOException - if the SPN could not be retrieved.

isPinLockEnabled

public boolean isPinLockEnabled()
                         throws IOException

Checks whether the PIN lock is enabled or not.

Returns:

true if the PIN lock is enabled, false otherwise.

Throws:

IOException - if the lock status could not be retrieved.

setPinCode

public void setPinCode(String pinCode)
                throws IOException

Sets the PIN code to be used for unlocking the SIM card. Note: This function is intended to be used before starting the modem, to provide the PIN code of an already locked SIM card, so the modem can finish the boot sequence successfully.

Parameters:

pinCode - the PIN code.

Throws:

IOException - if the PIN could not be set.