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 device 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 Deprecated. DataTAC is no longer supported.
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 Deprecated. Mobitex is no longer supported.
static int	BAND_UMTS_2100 Represents the 2100 MHz UMTS 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 Deprecated. DataTAC is no longer supported.
static int	NETWORK_GPRS GPRS network.
static int	NETWORK_IDEN iDEN network.
static int	NETWORK_MOBITEX Deprecated. Mobitex is no longer supported.
static int	NETWORK_NONE No radio network supported.
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_EDGE Device is in EDGE coverage.
static int	NETWORK_SERVICE_EMERGENCY_ONLY Network is providing emergency service only.
static int	NETWORK_SERVICE_EVDO Deprecated. NETWORK_SERVICE_EVDO is no longer supported. NETWORK_SERVICE_EVDO is replaced by NETWORK_SERVICE_EVDO_REV0.
static int	NETWORK_SERVICE_EVDO_ONLY Deprecated. NETWORK_SERVICE_EVDO_ONLY is no longer supported. NETWORK_SERVICE_EVDO_ONLY is replaced by NETWORK_SERVICE_EVDO_REV0_ONLY.
static int	NETWORK_SERVICE_EVDO_REV0 Device is in EV-DO coverage with 1X.
static int	NETWORK_SERVICE_EVDO_REV0_ONLY Device is in EV-DO coverage only, No 1X
static int	NETWORK_SERVICE_EVDO_REVA Device is in EV-DO coverage with 1X.
static int	NETWORK_SERVICE_EVDO_REVA_ONLY Device is in EV-DO coverage only, No 1X
static int	NETWORK_SERVICE_GAN Device is in GAN mode.
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_SDGC Network is providing SDGC service.
static int	NETWORK_SERVICE_SUPPRESS_ROAMING The roaming indicator should be suppressed.
static int	NETWORK_SERVICE_UMTS Device is in UMTS coverage.
static int	NETWORK_SERVICE_VOICE Network is providing voice service.
static int	NETWORK_UMTS UMTS network.
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 Deprecated. no longer used
static int	STATE_SERVICE_REQUIRED Deprecated. no longer used
static int	STATE_TURNING_OFF Deprecated. no longer used
static int	STATE_TURNING_ON Deprecated. no longer used
static int	SUPPORTED_WAFS The Wireless Access Families that are supported by the device.
static int	WAF_3GPP 3GPP Wireless Access Family.
static int	WAF_CDMA CDMA Wireless Access Family.
static int	WAF_IDEN iDEN Wireless Access Family.
static int	WAF_WLAN WLAN Wireless Access Family.

Method Summary
static boolean	areWAFsSupported(int WAFs) Determines if any of the provided Wireless Access Families are supported by the device.
static int	calculateNetworkId(int mcc, int mnc) Calculate the Cellular network ID value given the MCC and MNC in decimal value representation.
static String	getAccessPointName(int apnId) Gets the access point name from the given identifier.
static int	getAccessPointNumber(String name) Retrieves the access point number for the specified name.
static int	getAccessPointNumber(String data, int offset, int length) Retrieves the access point number for the specified name.
static int	getActiveWAFs() Retrieves the currently active Wireless Access Families.
static int	getCurrentNetworkIndex() Retrieves the index of the current Cellular network.
static String	getCurrentNetworkName() Retrieve the name of the carrier network on which the device is currently registered.
static int	getEnabledWAFs() Retrieves the currently enabled Wireless Access Families.
static byte[]	getIPAddress(int apnId) Retrieves the IP address for the specified access point name identifier.
static int	getMCC(int index) Retrieves Mobile Country Code for the given Cellular network.
static int	getMNC(int index) Retrieves Mobile Network Code for the specified Cellular network.
static String	getNetworkCountryCode(int index) Retrieves the country code (i.e. country initials) of the specified Cellular network.
static int	getNetworkId(int index) Retrieves the Id of the specified Cellular network.
static String	getNetworkName(int index) Retrieves the name of the specified Cellular network.
static int	getNetworkService() Retrieves currently available network services on the Cellular network.
static int	getNetworkService(int waf) Retrieves currently available network services.
static long	getNetworkTime(long deviceTime) Determine the current network time, as calculated using an offset from the current device time.
static int	getNetworkType() Retrieves the network that the device is capable of operating on.
static int	getNumberOfNetworks() Retrieves the number of available Cellular networks.
static long	getNumberOfPacketsReceived() Retrieves the number of IP bytes received by the radio.
static long	getNumberOfPacketsSent() Retrieves the number of IP bytes sent by the radio.
static int	getSignalLevel() Retrieves current signal strength of the Cellular network.
static int	getSignalLevel(int WAF) Retrieves current signal level for the specified Wireless Access Family.
static int	getState() Checks the radio state.
static int	getSupportedBands() Retrieves the Cellular network bands which are supported by the device.
static int	getSupportedWAFs() Retrieves the Wireless Access Families (WAFs) that are supported by the device.
static boolean	isDataServiceOperational() Indicates whether the radio can perform data services over Cellular network at this time.
static boolean	isDataServiceOperational(int wafs) Indicates whether the radio can perform data services at this time over any of the given WAFs such as WAF_3GPP et al.
static boolean	isDataServiceSuspended() Indicates whether data services are temporarily suspended at the present time.
static boolean	isPDPContextActive(int apnId) Indicates if the PDP context for the specified APN is active.

Methods inherited from class java.lang.Object

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

Field Detail

WAF_3GPP

public static final int WAF_3GPP

3GPP Wireless Access Family.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.1

WAF_CDMA

public static final int WAF_CDMA

CDMA Wireless Access Family.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.1

WAF_IDEN

public static final int WAF_IDEN

iDEN Wireless Access Family.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.1

WAF_WLAN

public static final int WAF_WLAN

WLAN Wireless Access Family.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.1

NETWORK_NONE

public static final int NETWORK_NONE

No radio network supported.

See Also:

Constant Field Values

Since:

BlackBerry API 4.1.0

NETWORK_MOBITEX

public static final int NETWORK_MOBITEX

Deprecated. Mobitex is no longer supported.

Mobitex network.

See Also:

Constant Field Values

NETWORK_DATATAC

public static final int NETWORK_DATATAC

Deprecated. DataTAC is no longer supported.

DataTAC network.

See Also:

Constant Field Values

NETWORK_GPRS

public static final int NETWORK_GPRS

GPRS network.

See Also:

Constant Field Values

NETWORK_CDMA

public static final int NETWORK_CDMA

CDMA network.

See Also:

Constant Field Values

NETWORK_IDEN

public static final int NETWORK_IDEN

iDEN network.

See Also:

Constant Field Values

NETWORK_802_11

public static final int NETWORK_802_11

802.11 network.

See Also:

Constant Field Values

Since:

BlackBerry API 4.0.2

NETWORK_UMTS

public static final int NETWORK_UMTS

UMTS network.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.0

STATE_OFF

public static final int STATE_OFF

Radio is off.

See Also:

Constant Field Values

STATE_ON

public static final int STATE_ON

Radio is on.

See Also:

Constant Field Values

STATE_LOWBATT

public static final int STATE_LOWBATT

Radio is on but cannot function because of low battery.

See Also:

Constant Field Values

STATE_SERVICE_REQUIRED

public static final int STATE_SERVICE_REQUIRED

Deprecated. no longer used

Radio is off and requires service.

See Also:

Constant Field Values

STATE_TURNING_OFF

public static final int STATE_TURNING_OFF

Deprecated. no longer used

Radio is in process of turning off.

See Also:

Constant Field Values

STATE_TURNING_ON

public static final int STATE_TURNING_ON

Deprecated. no longer used

Radio is in process of turning on.

See Also:

Constant Field Values

STATE_RELOAD_REQUIRED

public static final int STATE_RELOAD_REQUIRED

Deprecated. no longer used

Radio off and requires reloading.

See Also:

Constant Field Values

Since:

BlackBerry API 4.0.0

LEVEL_NO_COVERAGE

public static final int LEVEL_NO_COVERAGE

Radio has no coverage.

See Also:

Constant Field Values

NETWORK_SERVICE_EMERGENCY_ONLY

public static final int NETWORK_SERVICE_EMERGENCY_ONLY

Network is providing emergency service only.

See Also:

Constant Field Values

NETWORK_SERVICE_VOICE

public static final int NETWORK_SERVICE_VOICE

Network is providing voice service.

See Also:

Constant Field Values

NETWORK_SERVICE_DATA

public static final int NETWORK_SERVICE_DATA

Network is providing data service.

See Also:

Constant Field Values

NETWORK_SERVICE_DIRECT_CONNECT

public static final int NETWORK_SERVICE_DIRECT_CONNECT

Network is providing direct connect service.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

NETWORK_SERVICE_ROAMING

public static final int NETWORK_SERVICE_ROAMING

Device is roaming.

See Also:

Constant Field Values

NETWORK_SERVICE_SUPPRESS_ROAMING

public static final int NETWORK_SERVICE_SUPPRESS_ROAMING

The roaming indicator should be suppressed.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

NETWORK_SERVICE_ROAMING_OFF_CAMPUS

public static final int NETWORK_SERVICE_ROAMING_OFF_CAMPUS

Device is roaming onto another network campus.

See Also:

Constant Field Values

NETWORK_SERVICE_IN_HOME_ZONE

public static final int NETWORK_SERVICE_IN_HOME_ZONE

Device is in the 'home' zone.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

NETWORK_SERVICE_IN_CITY_ZONE

public static final int NETWORK_SERVICE_IN_CITY_ZONE

Device is in the 'city' zone.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

NETWORK_SERVICE_E911_CALLBACK_MODE

public static final int NETWORK_SERVICE_E911_CALLBACK_MODE

Device is in E911 callback mode.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

NETWORK_SERVICE_EVDO

public static final int NETWORK_SERVICE_EVDO

Deprecated. NETWORK_SERVICE_EVDO is no longer supported. NETWORK_SERVICE_EVDO is replaced by NETWORK_SERVICE_EVDO_REV0.

Device is in EV-DO coverage with 1X.

See Also:

Constant Field Values

Since:

BlackBerry API 4.0.2

NETWORK_SERVICE_EVDO_REV0

public static final int NETWORK_SERVICE_EVDO_REV0

Device is in EV-DO coverage with 1X.

See Also:

Constant Field Values

Since:

BlackBerry API 5.0.0

NETWORK_SERVICE_EVDO_REVA

public static final int NETWORK_SERVICE_EVDO_REVA

Device is in EV-DO coverage with 1X.

See Also:

Constant Field Values

Since:

BlackBerry API 5.0.0

NETWORK_SERVICE_EVDO_ONLY

public static final int NETWORK_SERVICE_EVDO_ONLY

Deprecated. NETWORK_SERVICE_EVDO_ONLY is no longer supported. NETWORK_SERVICE_EVDO_ONLY is replaced by NETWORK_SERVICE_EVDO_REV0_ONLY.

Device is in EV-DO coverage only, No 1X

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.0

NETWORK_SERVICE_EVDO_REV0_ONLY

public static final int NETWORK_SERVICE_EVDO_REV0_ONLY

Device is in EV-DO coverage only, No 1X

See Also:

Constant Field Values

Since:

BlackBerry API 5.0.0

NETWORK_SERVICE_EVDO_REVA_ONLY

public static final int NETWORK_SERVICE_EVDO_REVA_ONLY

Device is in EV-DO coverage only, No 1X

See Also:

Constant Field Values

Since:

BlackBerry API 5.0.0

NETWORK_SERVICE_EDGE

public static final int NETWORK_SERVICE_EDGE

Device is in EDGE coverage.

See Also:

Constant Field Values

Since:

BlackBerry API 4.1.0

NETWORK_SERVICE_MODEM_MODE_ENABLED

public static final int NETWORK_SERVICE_MODEM_MODE_ENABLED

Device is in modem (only) mode.

See Also:

Constant Field Values

Since:

BlackBerry API 4.0.2

NETWORK_SERVICE_UMTS

public static final int NETWORK_SERVICE_UMTS

Device is in UMTS coverage.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.0

NETWORK_SERVICE_GAN

public static final int NETWORK_SERVICE_GAN

Device is in GAN mode.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.1

NETWORK_SERVICE_SDGC

public static final int NETWORK_SERVICE_SDGC

Network is providing SDGC service.

See Also:

Constant Field Values

Since:

BlackBerry API 5.0.0

BAND_MOBITEX_900

public static final int BAND_MOBITEX_900

Deprecated. Mobitex is no longer supported.

Represents the 900 MHz Mobitex band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_DATATAC_800

public static final int BAND_DATATAC_800

Deprecated. DataTAC is no longer supported.

Represents the 800 MHz Datatac band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_GSM_900

public static final int BAND_GSM_900

Represents the 900 MHz GSM band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_GSM_1800

public static final int BAND_GSM_1800

Represents the 1800 MHz GSM band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_GSM_1900

public static final int BAND_GSM_1900

Represents the 1900 MHz GSM band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_CDMA_800

public static final int BAND_CDMA_800

Represents the 800 MHz CDMA band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_CDMA_1900

public static final int BAND_CDMA_1900

Represents the 1900 MHz CDMA band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_IDEN_800

public static final int BAND_IDEN_800

Represents the 800 MHz iDEN band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.6.0

BAND_GSM_850

public static final int BAND_GSM_850

Represents the 850 MHz GSM band.

See Also:

Constant Field Values

Since:

BlackBerry API 3.7.0

BAND_UMTS_2100

public static final int BAND_UMTS_2100

Represents the 2100 MHz UMTS band.

See Also:

Constant Field Values

Since:

BlackBerry API 4.2.1

SUPPORTED_WAFS

public static final int SUPPORTED_WAFS

The Wireless Access Families that are supported by the device.

Since:

BlackBerry API 6.0.0

Method Detail

getSupportedWAFs

public static int getSupportedWAFs()

Retrieves the Wireless Access Families (WAFs) that are supported by the device.

Returns:

A bitfield of WAF_* flags indicating the Wireless Access Families supported by the device.

Since:

BlackBerry API 4.2.1

areWAFsSupported

public static boolean areWAFsSupported(int WAFs)

Determines if any of the provided Wireless Access Families are supported by the device.

Parameters:

WAFs - A bitfield of WAF_* flags indicating the Wireless Access Families to check for support.

Returns:

True if any of the provided Wireless Access Families are supported; otherwise false.

Since:

BlackBerry API 4.2.1

getActiveWAFs

public static int getActiveWAFs()

Retrieves the currently active Wireless Access Families. If the activated Wireless Access Families were recently changed, it is possible that this function will not return the most up-to-date value.

Returns:

A bitfield of WAF_* flags indicating the currently active Wireless Access Families.

Since:

BlackBerry API 4.2.1

getEnabledWAFs

public static int getEnabledWAFs()

Retrieves the currently enabled Wireless Access Families.

Enabled WAFs are those permitted to be active on multiple WAF devices where not all WAFs are active at the same time.

E.g. Global mode enables CDMA and GSM but only one of these WAFs may be active depending on availability of network.

Returns:

A bitfield of WAF_* flags indicating the currently enabled Wireless Access Families.

Since:

BlackBerry API 4.3.0

getNetworkType

public static int getNetworkType()

Retrieves the network that the device is capable of operating on.

This method can be useful if the device only supports one network. If the device supports multiple Wireless Access Families, use the Wireless Access Families methods instead. For example, use getActiveWAFs() to determine the network that is currently being used and use getSupportedWAFs() to determine the Wireless Access Families supported by the device.

Returns:

Network type;

• RadioInfo.NETWORK_CDMA if the device is capable of CDMA
• RadioInfo.NETWORK_IDEN if the device is capable of iDEN
• RadioInfo.NETWORK_UMTS if the device is none of the above and supports 3G
• RadioInfo.NETWORK_GPRS if the device is none of the above and supports 2G
• RadioInfo.NETWORK_802_11 if the device is none of the above and supports WLAN

getState

public static int getState()

Checks the radio state.

Note: This checks the cellular WAFs except when WLAN is the primary WAF.

Returns:

One of the following radio states:

• RadioInfo.STATE_ON if the radio is on.
• RadioInfo.STATE_OFF if the radio is off or being turned off.
• RadioInfo.STATE_LOWBATT if the radio is on but the battery is too low to allow its use.

See Also:

RadioInfo.getActiveWAFs(), DeviceInfo.getBatteryStatus()

getSignalLevel

public static int getSignalLevel()

Retrieves current signal strength of the Cellular network.

Returns:

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

getSignalLevel

public static int getSignalLevel(int WAF)

Retrieves current signal level for the specified Wireless Access Family. If WAF is not one of the WAF_* constants, then RadioInfo.WAF_3GPP is assumed.

Parameters:

WAF - The Wireless Access Family whose signal level is to be retrieved. Must be one of the WAF_* constants, otherwise WAF_3GPP is assumed.

Returns:

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

Since:

BlackBerry API 4.2.1

getNetworkService

public static int getNetworkService()

Retrieves currently available network services on the Cellular network.

Returns:

Combination of the NETWORK_SERVICE_* flags.

getNetworkService

public static int getNetworkService(int waf)

Retrieves currently available network services.

Parameters:

the - active RadioInfo.WAF_*(s) that you would like to query.

Returns:

Combination of the NETWORK_SERVICE_* flags.

Since:

BlackBerry API 4.5.0

getSupportedBands

public static int getSupportedBands()

Retrieves the Cellular network bands which are supported by the device.

Returns:

The network band supported by the device.

Since:

BlackBerry API 3.6.0

getNumberOfPacketsSent

public static long getNumberOfPacketsSent()

Retrieves the number of IP bytes sent by the radio.

Returns:

Number of bytes sent by the radio, or -1 if this feature is not supported.

Since:

BlackBerry API 4.0.0

getNumberOfPacketsReceived

public static long getNumberOfPacketsReceived()

Retrieves the number of IP bytes received by the radio.

Returns:

Number of bytes received by the radio, or -1 if this feature is not supported.

Since:

BlackBerry API 4.0.0

getNumberOfNetworks

public static int getNumberOfNetworks()

Retrieves the number of available Cellular networks.

Returns:

The number of available networks.

Since:

BlackBerry API 4.2.0

getCurrentNetworkIndex

public static int getCurrentNetworkIndex()

Retrieves the index of the current Cellular network.

Returns:

The current network index, from 0 to RadioInfo.getNumberOfNetworks() - 1.

Since:

BlackBerry API 4.1.0

getNetworkId

public static int getNetworkId(int index)

Retrieves the Id of the specified Cellular network.

Parameters:

index - The network index, from 0 to getNumberOfNetworks() - 1.

Returns:

The network Id.

Throws:

IllegalArgumentException - if index is less than zero or is greater than the number of existing networks: (RadioInfo.getNumberOfNetworks() - 1).

Since:

BlackBerry API 4.1.0

getNetworkName

public static String getNetworkName(int index)

Retrieves the name of the specified Cellular network.

Parameters:

index - The network index, from 0 to getNumberOfNetworks() - 1.

Returns:

The network name.

Throws:

IllegalArgumentException - if the index is not within a valid range based on getNumberOfNetworks()

Since:

BlackBerry API 4.2.1

getNetworkCountryCode

public static String getNetworkCountryCode(int index)

Retrieves the country code (i.e. country initials) of the specified Cellular network.

Parameters:

index - The network index, from 0 to getNumberOfNetworks() - 1.

Returns:

The three-letter network country code listed in the GSM SE.13 table, or null if unknown.

Throws:

IllegalArgumentException - if the index parameter is out of bounds.

Since:

BlackBerry API 4.2.1

calculateNetworkId

public static int calculateNetworkId(int mcc,
                                     int mnc)

Calculate the Cellular network ID value given the MCC and MNC in decimal value representation.

If the provided values are out of range, such as negative numbers or greater than 0xFFF, then the returned value is undefined.

For example, after the code below executes the variable hexNetworkId will have value 0x02600310.

    int mcc = 310
    int mnc = 260
    int hexNetworkId = RadioInfo.calculateNetworkId(mcc, mnc);
 

Parameters:

mcc - Decimal value of MCC

mnc - Decimal value of MNC

Returns:

Network Id representation of MCC and MNC (i.e. 0x0MNC0MCC).

Since:

BlackBerry API 4.2.1

getMNC

public static int getMNC(int index)

Retrieves Mobile Network Code for the specified Cellular network.

Parameters:

index - The network index, from 0 to RadioInfo.getNumberOfNetworks() - 1.

Returns:

MNC for this network.

Throws:

IllegalArgumentException - if the index is out of bounds

Since:

BlackBerry API 4.2.0

getMCC

public static int getMCC(int index)

Retrieves Mobile Country Code for the given Cellular network.

Parameters:

index - The network index, from 0 to RadioInfo.getNumberOfNetworks() - 1.

Returns:

MCC for this network.

Throws:

IllegalArgumentException - if the index is out of bounds

Since:

BlackBerry API 4.2.0

isPDPContextActive

public static boolean isPDPContextActive(int apnId)

Indicates if the PDP context for the specified APN is active.

Parameters:

apnId - The access point name identifier.

Returns:

true if the PDP context for the specified APN is active.

Since:

BlackBerry API 4.1.0

getAccessPointName

public static String getAccessPointName(int apnId)
                                 throws RadioException

Gets the access point name from the given identifier.

Parameters:

apnId - The access point name identifier.

Returns:

The access point name.

Throws:

RadioException - If a radio error occurs or if the provided value for apnId is invalid.

Since:

BlackBerry API 4.1.0

getAccessPointNumber

public static int getAccessPointNumber(String name)
                                throws RadioException

Retrieves the access point number for the specified name.

Parameters:

name - The access point name.

Returns:

The access point name identifier.

Throws:

RadioException - If a radio error occurs.

Since:

BlackBerry API 4.1.0

getAccessPointNumber

public static int getAccessPointNumber(String data,
                                       int offset,
                                       int length)
                                throws RadioException

Retrieves the access point number for the specified name.

Parameters:

data - The String containing the access point name.

offset - The start offset of the access point name.

length - The length of the access point name.

Returns:

The access point name identifier.

Throws:

RadioException - If a radio error occurs or if invalid parameters passed.

Since:

BlackBerry API 4.1.0

getIPAddress

public static byte[] getIPAddress(int apnId)

Retrieves the IP address for the specified access point name identifier.

Parameters:

apnId - The access point name identifier.

Returns:

The IP address in network byte order (the highest order byte of the address is in address[0]).

Since:

BlackBerry API 4.1.0

getNetworkTime

public static long getNetworkTime(long deviceTime)

Determine the current network time, as calculated using an offset from the current device time. The quality of this information is network dependent.

Parameters:

deviceTime - current time in milliseconds

Returns:

A time in milliseconds corresponding to the network reported time normalized to the local time zone.

Since:

BlackBerry API 4.1.0

isDataServiceOperational

public static boolean isDataServiceOperational()

Indicates whether the radio can perform data services over Cellular network at this time.

Returns:

true if data service requests can be performed.

Since:

BlackBerry API 4.2.0

isDataServiceOperational

public static boolean isDataServiceOperational(int wafs)

Indicates whether the radio can perform data services at this time over any of the given WAFs such as WAF_3GPP et al.

Returns:

true if data service requests can be performed.

Since:

BlackBerry API 6.0.0

isDataServiceSuspended

public static boolean isDataServiceSuspended()

Indicates whether data services are temporarily suspended at the present time. Data services are suspended on class B networks when the phone is active.

Returns:

true if data services are suspended

Since:

BlackBerry API 4.2.0

getCurrentNetworkName

public static String getCurrentNetworkName()

Retrieve the name of the carrier network on which the device is currently registered.

Returns:

The name of the carrier network, or null if the device is not registered on any network

Since:

BlackBerry API 4.2.0