net.rim.device.api.system
Class GPRSInfo.GPRSCellInfo

java.lang.Object
  |
  +--net.rim.device.api.system.GPRSInfo.GPRSCellInfo
Enclosing class:
GPRSInfo

public static class GPRSInfo.GPRSCellInfo
extends Object

Encapsulates information for a General Packet Radio Service (GPRS) cell.

Since:
JDE 3.6.0

Method Summary
 int getARFCN()
          Retrieves the Absolute Radio Frequency Channel Number.
 int getBSIC()
          Retrieves the Base Station Identity Code.
 int getCellId()
          Retrieves the current cell ID.
 int getLAC()
          Retrieves the Location Area Code.
 int getMCC()
          Retrieves the Mobile Country Code.
 int getMNC()
          Retrieves the Mobile Network Code.
 int getRAC()
          Retrieves the Routing Area Code.
 int getRSSI()
          Retrieves the Radio Signal Strength Indicator.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

getARFCN

public int getARFCN()
Retrieves the Absolute Radio Frequency Channel Number.
Returns:
The cell's ARFCN.
Since:
JDE 3.6.0

getBSIC

public int getBSIC()
Retrieves the Base Station Identity Code.
On UMTS networks, retrieves the Radio Network Controller Identification, which is also known as the most significant 12 bits of the UC-ID. For more information, see GPRSCellInfo#getCellId.
Returns:
Cell's BSIC. On UMTS networks, this is the RNC-ID.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges.
Since:
JDE 3.6.0

getCellId

public int getCellId()
Retrieves the current cell ID.
The current length is 16 bits.
On UMTS networks, retrieves the least significant 16 bits of the UMTS Cellular Identification. The most significant 12 bits, that is, the RNC-ID, can be retrieved by calling getBSIC. For example, the UC is comprised of 0x0RRRCCCC, where R is the RNC-ID, and C is the Cell-ID.
Returns:
Cell's ID. On UMTS networks, this is the least significant 16-bits of the UC-ID.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges.
Since:
JDE 3.6.0

getLAC

public int getLAC()
Retrieves the Location Area Code. The current length is 16 bits.
Returns:
The cell's LAC.
Throws:
ControlledAccessException - if the calling process does not have the necessary privileges
Since:
JDE 3.6.0

getMCC

public int getMCC()
Retrieves the Mobile Country Code. The current length is 12 bits.
Returns:
The cell's MCC.
Since:
JDE 4.3.0

getMNC

public int getMNC()
Retrieves the Mobile Network Code. The current length is 12 bits.
Returns:
The cell's MNC.
Since:
JDE 4.3.0

getRAC

public int getRAC()
Retrieves the Routing Area Code. The current length is 8 bits.
Returns:
The cell's RAC.
Since:
JDE 3.6.0

getRSSI

public int getRSSI()
Retrieves the Radio Signal Strength Indicator.
Returns:
The cell's current RSSI.
Since:
JDE 4.3.0



Copyright 1999-2008 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.