net.rim.device.api.system
Class GPRSInfo

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

public final class GPRSInfo
extends Object

Contains General Packet Radio Service (GPRS) radio information.

Since:
JDE 3.6.0

Inner Class Summary
static class GPRSInfo.GPRSCellInfo
          Encapsulates information for a General Packet Radio Service (GPRS) cell.
 
Field Summary
static int GPRS_STATE_IDLE
          Represents the GPRS "idle" radio state.
static int GPRS_STATE_READY
          Represents the GPRS "ready" radio state.
static int GPRS_STATE_STANDBY
          Represents the GPRS "standby" radio state.
 
Method Summary
static GPRSInfo.GPRSCellInfo getCellInfo()
          Retrieves information on the current cell.
static int getGPRSState()
          Retrieves the current GPRS state.
static byte[] getIMEI()
          Retrieves the International Mobile Equipment Identity (IMEI) of the device.
static String getRegistrationAddress()
          Deprecated. This method always returns null.
static String getZoneName()
          Retrieves the zone name.
static String imeiToString(byte[] imei)
          Converts the International Mobile Equipment Identity (IMEI) value to a string.
static String imeiToString(byte[] imei, boolean addPeriods)
          Converts the International Mobile Equipment Identity (IMEI) value to a string.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

GPRS_STATE_IDLE

public static final int GPRS_STATE_IDLE
Represents the GPRS "idle" radio state.

In this state, the radio is detached from the network.

Since:
JDE 3.6.0

GPRS_STATE_STANDBY

public static final int GPRS_STATE_STANDBY
Represents the GPRS "standby" radio state.

In this state, the network must page the radio to prepare it to receive a downlink packet.

Since:
JDE 3.6.0

GPRS_STATE_READY

public static final int GPRS_STATE_READY
Represents the GPRS "ready" radio state.

In this state, the radio is attached to the network, and can send and receive packets.

Since:
JDE 3.6.0
Method Detail

getIMEI

public static byte[] getIMEI()
Retrieves the International Mobile Equipment Identity (IMEI) of the device.
Returns:
The IMEI of the device in BCD format.
Since:
JDE 3.6.0

imeiToString

public static String imeiToString(byte[] imei)
Converts the International Mobile Equipment Identity (IMEI) value to a string.
Parameters:
imei - IMEI value.
Returns:
Provided IMEI value in string form.
Since:
JDE 4.0.2

imeiToString

public static String imeiToString(byte[] imei,
                                  boolean addPeriods)
Converts the International Mobile Equipment Identity (IMEI) value to a string.
Parameters:
imei - IMEI value.
addPeriods - If true, the id will be delimited by periods.
Returns:
Provided IMEI value in string form.
Since:
JDE 4.0.2

getGPRSState

public static int getGPRSState()
Retrieves the current GPRS state.
Returns:
One of these values: GPRS_STATE_IDLE, GPRS_STATE_STANDBY, or GPRS_STATE_READY.
Since:
JDE 3.6.0

getRegistrationAddress

public static String getRegistrationAddress()
Deprecated. This method always returns null.

Retrieves the registration address.
Returns:
Null.
Since:
JDE 3.6.0

getZoneName

public static String getZoneName()
Retrieves the zone name.
Returns:
Time zone name in string form.
Since:
JDE 3.6.0

getCellInfo

public static GPRSInfo.GPRSCellInfo getCellInfo()
Retrieves information on the current cell.
Returns:
GPRS cell info structure for the current cell.
Since:
JDE 3.6.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.