org.joshvm.j2me.cellular

Class CellularDeviceInfo

java.lang.Object

org.joshvm.j2me.cellular.CellularDeviceInfo

public class CellularDeviceInfo
extends Object

CellularDeviceInfo is the main class to get celluar network related information of the device, including APN, IMEI, IMSI, ICCID, simcard and cell station information, etc.

Field Summary

Fields

Modifier and Type	Field and Description
static int	SIMCARD_STATUS_INSERTED
static int	SIMCARD_STATUS_REMOVED
static int	SIMCARD_STATUS_UNKNOWN

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CellularDeviceInfo(int id)

Method Summary

Methods

Modifier and Type	Method and Description
CellInfo	getCellInfo() Get current celluar station information
AccessPoint	getCurrentAPNSetting() Get current APN setting
String	getICCID()
String	getIMEI()
String	getIMSI()
NetworkInfo	getNetworkInfo() Get current celluar network information
int	getNetworkSignalLevel() Get cellular networking signal level
int	getSIMCardStatus() Get sim card status
static CellularDeviceInfo[]	listCellularDevices() List all installed cellular devices in the system.
void	resetDefaultAPNSetting() Reset dfault APN for current cellular device
void	setAPN(AccessPoint apn) Set APN for current cellular device

Methods inherited from class java.lang.Object

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

Field Detail

SIMCARD_STATUS_UNKNOWN

public static final int SIMCARD_STATUS_UNKNOWN

See Also:

Constant Field Values

SIMCARD_STATUS_INSERTED

public static final int SIMCARD_STATUS_INSERTED

See Also:

Constant Field Values

SIMCARD_STATUS_REMOVED

public static final int SIMCARD_STATUS_REMOVED

See Also:

Constant Field Values

Constructor Detail

CellularDeviceInfo

protected CellularDeviceInfo(int id)
                      throws IOException

Throws:

IOException

Method Detail

setAPN

public void setAPN(AccessPoint apn)
            throws IOException

Set APN for current cellular device

Parameters:

apn - the APN to be set for next time attaching to celluar network

Throws:

IOException

See Also:

AccessPoint

resetDefaultAPNSetting

public void resetDefaultAPNSetting()
                            throws IOException

Reset dfault APN for current cellular device

Throws:

IOException

See Also:

AccessPoint

getCurrentAPNSetting

public AccessPoint getCurrentAPNSetting()
                                 throws IOException

Get current APN setting

Returns:

The current APN setting

Throws:

IOException

See Also:

AccessPoint

getIMSI

public String getIMSI()
               throws IOException

Throws:

IOException

getIMEI

public String getIMEI()
               throws IOException

Throws:

IOException

getICCID

public String getICCID()
                throws IOException

Throws:

IOException

getNetworkSignalLevel

public int getNetworkSignalLevel()
                          throws IOException

Get cellular networking signal level

Returns:

0-31, signal strength; 99, not known or not detectable

Throws:

IOException

getNetworkInfo

public NetworkInfo getNetworkInfo()
                           throws IOException

Get current celluar network information

Returns:

Current network information, including MNC and MCC, Networking Type, etc.

Throws:

IOException

See Also:

NetworkInfo

getCellInfo

public CellInfo getCellInfo()
                     throws IOException

Get current celluar station information

Returns:

Current celluar station information

Throws:

IOException

See Also:

CellInfo

getSIMCardStatus

public int getSIMCardStatus()
                     throws IOException

Get sim card status

Returns:

CellularDeviceInfo.SIMCARD_STATUS_UNKNOWN Unknow status

CellularDeviceInfo.SIMCARD_STATUS_INSERTED Simcard exists

CellularDeviceInfo.SIMCARD_STATUS_REMOVED Simcard is not inserted

Throws:

IOException

listCellularDevices

public static CellularDeviceInfo[] listCellularDevices()

List all installed cellular devices in the system. For example, if the device has 2 modules installed, this API will returns an array which contains 2 elements.

Returns:

All the installed cellular devices