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:

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.
boolean	getIsUtran() Retrieves the Radio Signal Strength Indicator.
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

getIsUtran

public boolean getIsUtran()

Retrieves the Radio Signal Strength Indicator.

Returns:

True if the current cell is 3G.

Since:

BlackBerry API 7.0.0