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
          Represents the 1900 MHz CDMA band.
static int BAND_CDMA_800
          Represents the 800 MHz CDMA band.
static int BAND_DATATAC_800
          Represents the 800 MHz Datatac band.
static int BAND_GSM_1800
          Represents the 1800 MHz GSM band.
static int BAND_GSM_1900
          Represents the 1900 MHz GSM band.
static int BAND_GSM_850
          Represents the 850 MHz GSM band.
static int BAND_GSM_900
          Represents the 900 MHz GSM band.
static int BAND_IDEN_800
          Represents the 800 MHz iDEN band.
static int BAND_MOBITEX_900
          Represents the 900 MHz Mobitex band.
static int LEVEL_NO_COVERAGE
          Radio has no coverage.
static int NETWORK_802_11
          802.11 network.
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_EVDO
          Device is in EV-DO coverage.
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_MODEM_MODE_ENABLED
          Device is in modem (only) mode.
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_SUPPRESS_ROAMING
          The roaming indicator should be suppressed.
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_RELOAD_REQUIRED
          Radio off and requires reloading.
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 long getNumberOfPacketsReceived()
          Retrieves the number of IP packets received by the radio.
static long getNumberOfPacketsSent()
          Retrieves the number of IP packets sent by the radio.
static int getSignalLevel()
          Retrieves current signal strength.
static int getState()
          Checks the radio state.
static int getSupportedBands()
          Retrieves the network bands which are supported by the device.
 
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.

NETWORK_802_11

public static final int NETWORK_802_11
802.11 network.
Since:
JDE 4.0.2

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.

STATE_RELOAD_REQUIRED

public static final int STATE_RELOAD_REQUIRED
Radio off and requires reloading.
Since:
JDE 4.0.0

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.
Since:
JDE 3.6.0

NETWORK_SERVICE_ROAMING

public static final int NETWORK_SERVICE_ROAMING
Device is roaming.

NETWORK_SERVICE_SUPPRESS_ROAMING

public static final int NETWORK_SERVICE_SUPPRESS_ROAMING
The roaming indicator should be suppressed.
Since:
JDE 3.7.0

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.
Since:
JDE 3.6.0

NETWORK_SERVICE_IN_CITY_ZONE

public static final int NETWORK_SERVICE_IN_CITY_ZONE
Device is in the 'city' zone.
Since:
JDE 3.6.0

NETWORK_SERVICE_E911_CALLBACK_MODE

public static final int NETWORK_SERVICE_E911_CALLBACK_MODE
Device is in E911 callback mode.
Since:
JDE 3.6.0

NETWORK_SERVICE_EVDO

public static final int NETWORK_SERVICE_EVDO
Device is in EV-DO coverage.
Since:
JDE 4.0.2

NETWORK_SERVICE_MODEM_MODE_ENABLED

public static final int NETWORK_SERVICE_MODEM_MODE_ENABLED
Device is in modem (only) mode.
Since:
JDE 4.0.2

BAND_MOBITEX_900

public static final int BAND_MOBITEX_900
Represents the 900 MHz Mobitex band.
Since:
JDE 3.6.0

BAND_DATATAC_800

public static final int BAND_DATATAC_800
Represents the 800 MHz Datatac band.
Since:
JDE 3.6.0

BAND_GSM_900

public static final int BAND_GSM_900
Represents the 900 MHz GSM band.
Since:
JDE 3.6.0

BAND_GSM_1800

public static final int BAND_GSM_1800
Represents the 1800 MHz GSM band.
Since:
JDE 3.6.0

BAND_GSM_1900

public static final int BAND_GSM_1900
Represents the 1900 MHz GSM band.
Since:
JDE 3.6.0

BAND_CDMA_800

public static final int BAND_CDMA_800
Represents the 800 MHz CDMA band.
Since:
JDE 3.6.0

BAND_CDMA_1900

public static final int BAND_CDMA_1900
Represents the 1900 MHz CDMA band.
Since:
JDE 3.6.0

BAND_IDEN_800

public static final int BAND_IDEN_800
Represents the 800 MHz iDEN band.
Since:
JDE 3.6.0

BAND_GSM_850

public static final int BAND_GSM_850
Represents the 850 MHz GSM band.
Since:
JDE 3.7.0
Method Detail

getNetworkType

public static int getNetworkType()
Retrieves the network type.
Returns:
Network type; one of NETWORK_MOBITEX, NETWORK_GPRS, NETWORK_CDMA, NETWORK_IDEN.

getState

public static int getState()
Checks the radio state.
Returns:
One of the following radio states:

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()
Retrieves the network bands which are supported by the device.
Returns:
The network band supported by the device.
Since:
JDE 3.6.0

getNumberOfPacketsSent

public static long getNumberOfPacketsSent()
Retrieves the number of IP packets sent by the radio.
Returns:
Number of packets sent by the radio, or -1 if this feature is not supported.
Since:
JDE 4.0.0

getNumberOfPacketsReceived

public static long getNumberOfPacketsReceived()
Retrieves the number of IP packets received by the radio.
Returns:
Number of packets received by the radio, or -1 if this feature is not supported.
Since:
JDE 4.0.0


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.