net.rim.device.api.system
Interface RadioStatusListener

All Superinterfaces:

RadioListener

public interface RadioStatusListener

extends RadioListener

The listener interface for receiving radio status events.

Field Summary

static int	GMM_ATTACH_ACCEPT
static int	GMM_ATTACH_REJECT
static int	GMM_AUTH_CIPHER_REJECT
static int	GMM_AUTH_CIPHER_REQUEST
static int	GMM_GMM_INFORMATION
static int	GMM_IDENTITY_REQUEST
static int	GMM_MO_DETACH_ACCEPT
static int	GMM_MT_DETACH_REQUEST
static int	GMM_PTMSI_REALLOC_CMD
static int	GMM_RA_UPDATE_ACCEPT
static int	GMM_RA_UPDATE_REJECT
static int	MM_ABORT
static int	MM_AUTHENTICATION_REJECT
static int	MM_AUTHENTICATION_REQUEST
static int	MM_CM_SERVICE_ACCEPT
static int	MM_CM_SERVICE_REJECT
static int	MM_IDENTITY_REQUEST
static int	MM_LOCATION_UPDATE_ACCEPT
static int	MM_LOCATION_UPDATE_REJECT
static int	MM_MM_INFORMATION
static int	MM_MM_STATUS
static int	MM_TMSI_REALLOC_CMD
static int	PDP_CAUSE_AUTHENTICATION_FAILED
static int	PDP_CAUSE_INSUFFICIENT_RESOURCES
static int	PDP_CAUSE_LLC_FAILURE
static int	PDP_CAUSE_NETWORK_FAILURED
static int	PDP_CAUSE_NORMAL_DEACTIVATION
static int	PDP_CAUSE_NOT_SUPPORTED
static int	PDP_CAUSE_NSAPI_ALREADY_USED
static int	PDP_CAUSE_QOS_NOT_ACCEPTED
static int	PDP_CAUSE_REACTIVATION_REQUESTED
static int	PDP_CAUSE_REJECTED
static int	PDP_CAUSE_REJECTED_BY_GGSN
static int	PDP_CAUSE_SERVICE_NOT_SUBSCRIBED
static int	PDP_CAUSE_SERVICE_NOT_SUPPORTED
static int	PDP_CAUSE_SERVICE_OUT_OF_ORDER
static int	PDP_CAUSE_TFT_ALREADY_USED
static int	PDP_CAUSE_TFT_INVALID
static int	PDP_CAUSE_UNKNOWN
static int	PDP_CAUSE_UNKNOWN_APN
static int	PDP_CAUSE_UNKNOWN_PDP
static int	PDP_CAUSE_UNKNOWN_PDP_CONTEXT
static int	PDP_STATE_ACTIVE The PDP context has become active.
static int	PDP_STATE_INACTIVE The PDP context has become inactive.
static int	PDP_STATE_IP_ADDRESS_CHANGED The IP address for the PDP context has changed.
static int	PDP_STATE_REJECTED The PDP context request has been rejected by the network.
static int	SM_DEACTIVATE_PDP_ACCEPT
static int	SM_DEACTIVATE_PDP_REQUEST
static int	SM_PDP_ACTIVATE_ACCEPT
static int	SM_PDP_ACTIVATE_REJECT

Method Summary

void	baseStationChange() Invoked when the radio has changed base stations.
void	mobilityManagementEvent(int eventCode, int cause) Invoked when the radio performs some kind of mobility management.
void	networkScanComplete(boolean success) Invoked when a scan for available networks is completed.
void	networkServiceChange(int networkId, int service) Invoked when the available service(s) provided by the network change.
void	networkStarted(int networkId, int service) Invoked when the radio has been turned on or has just been switched to a new network.
void	networkStateChange(int state) Invoked when the network state has changed.
void	pdpStateChange(int apn, int state, int cause) Invoked when the PDP state has changed.
void	radioTurnedOff() Invoked when the radio has been turned off.
void	signalLevel(int level) Invoked when the receive signal level has changed.

Field Detail

PDP_STATE_ACTIVE

public static final int PDP_STATE_ACTIVE

The PDP context has become active.

PDP_STATE_INACTIVE

public static final int PDP_STATE_INACTIVE

The PDP context has become inactive.

PDP_STATE_REJECTED

public static final int PDP_STATE_REJECTED

The PDP context request has been rejected by the network.

PDP_STATE_IP_ADDRESS_CHANGED

public static final int PDP_STATE_IP_ADDRESS_CHANGED

The IP address for the PDP context has changed.

PDP_CAUSE_UNKNOWN

public static final int PDP_CAUSE_UNKNOWN

PDP_CAUSE_LLC_FAILURE

public static final int PDP_CAUSE_LLC_FAILURE

PDP_CAUSE_INSUFFICIENT_RESOURCES

public static final int PDP_CAUSE_INSUFFICIENT_RESOURCES

PDP_CAUSE_UNKNOWN_APN

public static final int PDP_CAUSE_UNKNOWN_APN

PDP_CAUSE_UNKNOWN_PDP

public static final int PDP_CAUSE_UNKNOWN_PDP

PDP_CAUSE_AUTHENTICATION_FAILED

public static final int PDP_CAUSE_AUTHENTICATION_FAILED

PDP_CAUSE_REJECTED_BY_GGSN

public static final int PDP_CAUSE_REJECTED_BY_GGSN

PDP_CAUSE_REJECTED

public static final int PDP_CAUSE_REJECTED

PDP_CAUSE_SERVICE_NOT_SUPPORTED

public static final int PDP_CAUSE_SERVICE_NOT_SUPPORTED

PDP_CAUSE_SERVICE_NOT_SUBSCRIBED

public static final int PDP_CAUSE_SERVICE_NOT_SUBSCRIBED

PDP_CAUSE_SERVICE_OUT_OF_ORDER

public static final int PDP_CAUSE_SERVICE_OUT_OF_ORDER

PDP_CAUSE_NSAPI_ALREADY_USED

public static final int PDP_CAUSE_NSAPI_ALREADY_USED

PDP_CAUSE_NORMAL_DEACTIVATION

public static final int PDP_CAUSE_NORMAL_DEACTIVATION

PDP_CAUSE_QOS_NOT_ACCEPTED

public static final int PDP_CAUSE_QOS_NOT_ACCEPTED

PDP_CAUSE_NETWORK_FAILURED

public static final int PDP_CAUSE_NETWORK_FAILURED

PDP_CAUSE_REACTIVATION_REQUESTED

public static final int PDP_CAUSE_REACTIVATION_REQUESTED

PDP_CAUSE_NOT_SUPPORTED

public static final int PDP_CAUSE_NOT_SUPPORTED

PDP_CAUSE_TFT_ALREADY_USED

public static final int PDP_CAUSE_TFT_ALREADY_USED

PDP_CAUSE_TFT_INVALID

public static final int PDP_CAUSE_TFT_INVALID

PDP_CAUSE_UNKNOWN_PDP_CONTEXT

public static final int PDP_CAUSE_UNKNOWN_PDP_CONTEXT

MM_LOCATION_UPDATE_ACCEPT

public static final int MM_LOCATION_UPDATE_ACCEPT

MM_LOCATION_UPDATE_REJECT

public static final int MM_LOCATION_UPDATE_REJECT

MM_AUTHENTICATION_REQUEST

public static final int MM_AUTHENTICATION_REQUEST

MM_AUTHENTICATION_REJECT

public static final int MM_AUTHENTICATION_REJECT

MM_IDENTITY_REQUEST

public static final int MM_IDENTITY_REQUEST

MM_TMSI_REALLOC_CMD

public static final int MM_TMSI_REALLOC_CMD

MM_CM_SERVICE_ACCEPT

public static final int MM_CM_SERVICE_ACCEPT

MM_CM_SERVICE_REJECT

public static final int MM_CM_SERVICE_REJECT

MM_MM_STATUS

public static final int MM_MM_STATUS

MM_ABORT

public static final int MM_ABORT

MM_MM_INFORMATION

public static final int MM_MM_INFORMATION

GMM_ATTACH_ACCEPT

public static final int GMM_ATTACH_ACCEPT

GMM_ATTACH_REJECT

public static final int GMM_ATTACH_REJECT

GMM_MO_DETACH_ACCEPT

public static final int GMM_MO_DETACH_ACCEPT

GMM_RA_UPDATE_ACCEPT

public static final int GMM_RA_UPDATE_ACCEPT

GMM_MT_DETACH_REQUEST

public static final int GMM_MT_DETACH_REQUEST

GMM_RA_UPDATE_REJECT

public static final int GMM_RA_UPDATE_REJECT

GMM_PTMSI_REALLOC_CMD

public static final int GMM_PTMSI_REALLOC_CMD

GMM_AUTH_CIPHER_REQUEST

public static final int GMM_AUTH_CIPHER_REQUEST

GMM_AUTH_CIPHER_REJECT

public static final int GMM_AUTH_CIPHER_REJECT

GMM_IDENTITY_REQUEST

public static final int GMM_IDENTITY_REQUEST

GMM_GMM_INFORMATION

public static final int GMM_GMM_INFORMATION

SM_PDP_ACTIVATE_ACCEPT

public static final int SM_PDP_ACTIVATE_ACCEPT

SM_PDP_ACTIVATE_REJECT

public static final int SM_PDP_ACTIVATE_REJECT

SM_DEACTIVATE_PDP_REQUEST

public static final int SM_DEACTIVATE_PDP_REQUEST

SM_DEACTIVATE_PDP_ACCEPT

public static final int SM_DEACTIVATE_PDP_ACCEPT

Method Detail

signalLevel

public void signalLevel(int level)

Invoked when the receive signal level has changed.

Parameters:

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

Since:

JDE 3.6

networkStarted

public void networkStarted(int networkId,
                           int service)

Invoked when the radio has been turned on or has just been switched to a new network.

Parameters:

networkId - Network ID.

service - Available service provided by this network: a combination of the NETWORK_SERVICE_ flags in RadioInfo.

Since:

JDE 3.6

baseStationChange

public void baseStationChange()

Invoked when the radio has changed base stations.

radioTurnedOff

public void radioTurnedOff()

Invoked when the radio has been turned off.

pdpStateChange

public void pdpStateChange(int apn,
                           int state,
                           int cause)

Invoked when the PDP state has changed.

Parameters:

apn - Access point number for the PDP context.

state - New PDP context state (one of PDP_STATE_ACTIVE, PDP_STATE_INACTIVE, PDP_STATE_REJECTED.

cause - One of the PDP cause values (for example, PDP_CAUSE_UNKNOWN and other similar members).

Since:

JDE 3.6

networkStateChange

public void networkStateChange(int state)

Invoked when the network state has changed.

Parameters:

state - New network state (one of GPRSInfo.GPRS_STATE_IDLE, GPRSInfo.GPRS_STATE_STANDBY, GPRSInfo.GPRS_STATE_READY.

Since:

JDE 3.6

networkScanComplete

public void networkScanComplete(boolean success)

Invoked when a scan for available networks is completed.

Parameters:

success - Indicates if the scan completed successfully or not.

Since:

JDE 3.6

mobilityManagementEvent

public void mobilityManagementEvent(int eventCode,
                                    int cause)

Invoked when the radio performs some kind of mobility management.

Note that the eventCode and cause is network type dependent.

Parameters:

eventCode - The type of mobility management event

cause - The cause of the event if one is applicable

Since:

JDE 3.6

networkServiceChange

public void networkServiceChange(int networkId,
                                 int service)

Invoked when the available service(s) provided by the network change.

For example, this function is called when the device moves from a region of voice only coverage to a region of voice and data coverage.

Parameters:

networkId - Network ID.

service - Available service provided by this network: a combination of the NETWORK_SERVICE_ flags in RadioInfo.

Since:

JDE 3.6