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

java.lang.Object
  extended by 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:
BlackBerry API 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

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:
BlackBerry API 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:
BlackBerry API 3.6.0

getMCC

public int getMCC()
Retrieves the Mobile Country Code. The current length is 12 bits.

Returns:
The cell's MCC.
Since:
BlackBerry API 4.3.0

getMNC

public int getMNC()
Retrieves the Mobile Network Code. The current length is 12 bits.

Returns:
The cell's MNC.
Since:
BlackBerry API 4.3.0

getRAC

public int getRAC()
Retrieves the Routing Area Code. The current length is 8 bits.

Returns:
The cell's RAC.
Since:
BlackBerry API 3.6.0

getARFCN

public int getARFCN()
Retrieves the Absolute Radio Frequency Channel Number.

Returns:
The cell's ARFCN.
Since:
BlackBerry API 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:
BlackBerry API 3.6.0

getRSSI

public int getRSSI()
Retrieves the Radio Signal Strength Indicator.

Returns:
The cell's current RSSI.
Since:
BlackBerry API 4.3.0





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.