net.rim.device.api.system
Class RadioInfo

java.lang.Object
  |
  +--net.rim.device.api.system.RadioInfo

public final class RadioInfo

extends Object

Provides access to information about the status of the radio.

Field Summary

static int	BAND_CDMA_1900
static int	BAND_CDMA_800
static int	BAND_DATATAC_800
static int	BAND_GSM_1800
static int	BAND_GSM_1900
static int	BAND_GSM_900
static int	BAND_IDEN_800
static int	BAND_MOBITEX_900
static int	LEVEL_NO_COVERAGE Radio has no coverage.
static int	NETWORK_CDMA CDMA network.
static int	NETWORK_DATATAC DataTAC network.
static int	NETWORK_GPRS GPRS network.
static int	NETWORK_IDEN IDEN network.
static int	NETWORK_MOBITEX Mobitex network.
static int	NETWORK_SERVICE_DATA Network is providing data service.
static int	NETWORK_SERVICE_DIRECT_CONNECT Network is providing direct connect service.
static int	NETWORK_SERVICE_E911_CALLBACK_MODE Device is in E911 callback mode.
static int	NETWORK_SERVICE_EMERGENCY_ONLY Network is providing emergency service only.
static int	NETWORK_SERVICE_IN_CITY_ZONE Device is in the 'city' zone.
static int	NETWORK_SERVICE_IN_HOME_ZONE Device is in the 'home' zone.
static int	NETWORK_SERVICE_ROAMING Device is roaming.
static int	NETWORK_SERVICE_ROAMING_OFF_CAMPUS Device is roaming onto another network campus.
static int	NETWORK_SERVICE_VOICE Network is providing voice service.
static int	STATE_LOWBATT Radio is on but cannot function because of low battery.
static int	STATE_OFF Radio is off.
static int	STATE_ON Radio is on.
static int	STATE_SERVICE_REQUIRED Radio is off and requires service.
static int	STATE_TURNING_OFF Radio is in process of turning off.
static int	STATE_TURNING_ON Radio is in process of turning on.

Method Summary

static int	getNetworkService() Retrieves currently available network services.
static int	getNetworkType() Retrieves the network type.
static int	getSignalLevel() Retrieves current signal strength.
static int	getState() Checks the radio state.
static int	getSupportedBands()

Methods inherited from class java.lang.Object

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

Field Detail

NETWORK_MOBITEX

public static final int NETWORK_MOBITEX

Mobitex network.

NETWORK_DATATAC

public static final int NETWORK_DATATAC

DataTAC network.

NETWORK_GPRS

public static final int NETWORK_GPRS

GPRS network.

NETWORK_CDMA

public static final int NETWORK_CDMA

CDMA network.

NETWORK_IDEN

public static final int NETWORK_IDEN

IDEN network.

STATE_OFF

public static final int STATE_OFF

Radio is off.

STATE_ON

public static final int STATE_ON

Radio is on.

STATE_LOWBATT

public static final int STATE_LOWBATT

Radio is on but cannot function because of low battery.

STATE_SERVICE_REQUIRED

public static final int STATE_SERVICE_REQUIRED

Radio is off and requires service.

STATE_TURNING_OFF

public static final int STATE_TURNING_OFF

Radio is in process of turning off.

STATE_TURNING_ON

public static final int STATE_TURNING_ON

Radio is in process of turning on.

LEVEL_NO_COVERAGE

public static final int LEVEL_NO_COVERAGE

Radio has no coverage.

NETWORK_SERVICE_EMERGENCY_ONLY

public static final int NETWORK_SERVICE_EMERGENCY_ONLY

Network is providing emergency service only.

NETWORK_SERVICE_VOICE

public static final int NETWORK_SERVICE_VOICE

Network is providing voice service.

NETWORK_SERVICE_DATA

public static final int NETWORK_SERVICE_DATA

Network is providing data service.

NETWORK_SERVICE_DIRECT_CONNECT

public static final int NETWORK_SERVICE_DIRECT_CONNECT

Network is providing direct connect service.

NETWORK_SERVICE_ROAMING

public static final int NETWORK_SERVICE_ROAMING

Device is roaming.

NETWORK_SERVICE_ROAMING_OFF_CAMPUS

public static final int NETWORK_SERVICE_ROAMING_OFF_CAMPUS

Device is roaming onto another network campus.

NETWORK_SERVICE_IN_HOME_ZONE

public static final int NETWORK_SERVICE_IN_HOME_ZONE

Device is in the 'home' zone.

NETWORK_SERVICE_IN_CITY_ZONE

public static final int NETWORK_SERVICE_IN_CITY_ZONE

Device is in the 'city' zone.

NETWORK_SERVICE_E911_CALLBACK_MODE

public static final int NETWORK_SERVICE_E911_CALLBACK_MODE

Device is in E911 callback mode.

BAND_MOBITEX_900

public static final int BAND_MOBITEX_900

BAND_DATATAC_800

public static final int BAND_DATATAC_800

BAND_GSM_900

public static final int BAND_GSM_900

BAND_GSM_1800

public static final int BAND_GSM_1800

BAND_GSM_1900

public static final int BAND_GSM_1900

BAND_CDMA_800

public static final int BAND_CDMA_800

BAND_CDMA_1900

public static final int BAND_CDMA_1900

BAND_IDEN_800

public static final int BAND_IDEN_800

Method Detail

getNetworkType

public static int getNetworkType()

Retrieves the network type.

Returns:

Network type; one of NETWORK_MOBITEX, NETWORK_DATATAC, NETWORK_GPRS, NETWORK_CDMA, NETWORK_IDEN.

getState

public static int getState()

Checks the radio state.

Returns:

One of the following radio states:

• STATE_ON if the radio is on.
• STATE_OFF if the radio is off or being turned off.
• STATE_LOWBATT if the radio is on but the battery is too low to allow its use.
• STATE_SERVICE_REQUIRED if the radio requires service.
• STATE_TURNING_OFF if the radio is in the process of being turned off.
• STATE_TURNING_ON if the radio is in the process of being turned on.

getSignalLevel

public static int getSignalLevel()

Retrieves current signal strength.

Returns:

Signal level in dBm (typically between -121 dBm and -40 dBm) or LEVEL_NO_COVERAGE if the radio is out of coverage.

getNetworkService

public static int getNetworkService()

Retrieves currently available network services.

Returns:

Combination of the NETWORK_SERVICE_* flags.

getSupportedBands

public static int getSupportedBands()

Returns:

The network band supported by the device.