net.rim.device.api.system
Interface RadioStatusListener

All Superinterfaces:

RadioListener

public interface RadioStatusListener

extends RadioListener

The listener interface for receiving radio status events.

Since:

JDE 3.6.0

Field Summary

static int	CAUSE_NOT_APPLICABLE Inapplicable cause value.
static int	GMM_ATTACH_ACCEPT Indicates a GMM attach acceptance.
static int	GMM_ATTACH_REJECT Indicates a GMM attach rejection.
static int	GMM_AUTH_CIPHER_REJECT Indicates a GMM authorization cipher rejection.
static int	GMM_AUTH_CIPHER_REQUEST Indicates a GMM authorization cipher request.
static int	GMM_GMM_INFORMATION Indicates a GMM information request.
static int	GMM_IDENTITY_REQUEST Indicates a GMM identity request.
static int	GMM_MO_DETACH_ACCEPT Indicates a GMM MO detach acceptance.
static int	GMM_MT_DETACH_REQUEST Indicates a GMM MT detach request.
static int	GMM_PTMSI_REALLOC_CMD Indicates a PTMSI reallocation command .
static int	GMM_RA_UPDATE_ACCEPT Indicates a GMM routing area update acceptance.
static int	GMM_RA_UPDATE_REJECT Indicates a GMM routing area update rejection.
static int	MM_ABORT Indicates an abort request.
static int	MM_AUTHENTICATION_REJECT Indicates an authenticcation rejection.
static int	MM_AUTHENTICATION_REQUEST Indicates an authentication request.
static int	MM_CM_SERVICE_ACCEPT Indictes a call management service acceptance.
static int	MM_CM_SERVICE_REJECT Indicates a call management service rejection.
static int	MM_IDENTITY_REQUEST Indicates an identity request.
static int	MM_LOCATION_UPDATE_ACCEPT Indicates location update acceptance.
static int	MM_LOCATION_UPDATE_REJECT Indicates location update rejection.
static int	MM_MM_INFORMATION Indicates a mobility management information request.
static int	MM_MM_STATUS Indicates a status request.
static int	MM_TMSI_REALLOC_CMD Indicates a TMSI reallocation command.
static int	PDP_CAUSE_AUTHENTICATION_FAILED Indicates that the requested service was rejected by the network because the user could not be authenticated.
static int	PDP_CAUSE_INSUFFICIENT_RESOURCES Indicates that a PDP context activation request or a PDP context modification request cannot be accepted due to insufficient resources.
static int	PDP_CAUSE_LLC_FAILURE Indicates that a PDP context is deactivated because of a LLC or SNDCP failure.
static int	PDP_CAUSE_NETWORK_FAILURED Indicates that the PDP context deactivation was caused by a network error.
static int	PDP_CAUSE_NORMAL_DEACTIVATION Indicates a regular PDP context deactivation.
static int	PDP_CAUSE_NOT_SUPPORTED Indicates that the PDP context activation initiated by the network is not supported by the MS.
static int	PDP_CAUSE_NSAPI_ALREADY_USED Indicates that the requested NSAPI in the PDP context activation is already used by another active PDP context.
static int	PDP_CAUSE_QOS_NOT_ACCEPTED Indicates that the new Quality of Service (QoS) cannot be accepted.
static int	PDP_CAUSE_REACTIVATION_REQUESTED Used by the network to request a PDP context reactivation after a GGSN restart.
static int	PDP_CAUSE_REJECTED Indicates that the requested service was rejected for unspecified reasons.
static int	PDP_CAUSE_REJECTED_BY_GGSN Indicates that the requested service was rejected by the GGSN.
static int	PDP_CAUSE_SERVICE_NOT_SUBSCRIBED Indicates that the requested service option is not currently subscribed.
static int	PDP_CAUSE_SERVICE_NOT_SUPPORTED Indicates that the requested service is not supported by the PLMN.
static int	PDP_CAUSE_SERVICE_OUT_OF_ORDER Indicates that the request was rejected because of a temporary outage of one or more functions required for operation.
static int	PDP_CAUSE_TFT_ALREADY_USED Indicates that the TFT was already used.
static int	PDP_CAUSE_TFT_INVALID Indicates that the TFT is invalid.
static int	PDP_CAUSE_UNKNOWN The cause of the failure was unknown.
static int	PDP_CAUSE_UNKNOWN_APN Indicates that the requested service was rejected by the network because the mandatory access point name (APN) was not included or could not be found.
static int	PDP_CAUSE_UNKNOWN_PDP Indicates that the requested service was rejected by the network because the PDP address or type could not be recognised.
static int	PDP_CAUSE_UNKNOWN_PDP_CONTEXT Indicates that the PDP context is unknown.
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 Indicates an SM deactivate PDP acceptance.
static int	SM_DEACTIVATE_PDP_REQUEST Indicates an SM deactivate PDP request.
static int	SM_PDP_ACTIVATE_ACCEPT Indicates an SM PDP activation acceptance.
static int	SM_PDP_ACTIVATE_REJECT Indicates an SM PDP activation rejection.

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

CAUSE_NOT_APPLICABLE

public static final int CAUSE_NOT_APPLICABLE

Inapplicable cause value.

Since:

JDE 4.0.0

GMM_ATTACH_ACCEPT

public static final int GMM_ATTACH_ACCEPT

Indicates a GMM attach acceptance. Note that a cause value may be associated with this event code (see mobilityManagementEvent(int, int)), but the value may be CAUSE_NOT_APPLICABLE.

Since:

JDE 3.6.0

GMM_ATTACH_REJECT

public static final int GMM_ATTACH_REJECT

Indicates a GMM attach rejection. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

GMM_AUTH_CIPHER_REJECT

public static final int GMM_AUTH_CIPHER_REJECT

Indicates a GMM authorization cipher rejection.

Since:

JDE 3.6.0

GMM_AUTH_CIPHER_REQUEST

public static final int GMM_AUTH_CIPHER_REQUEST

Indicates a GMM authorization cipher request.

Since:

JDE 3.6.0

GMM_GMM_INFORMATION

public static final int GMM_GMM_INFORMATION

Indicates a GMM information request.

Since:

JDE 3.6.0

GMM_IDENTITY_REQUEST

public static final int GMM_IDENTITY_REQUEST

Indicates a GMM identity request.

Since:

JDE 3.6.0

GMM_MO_DETACH_ACCEPT

public static final int GMM_MO_DETACH_ACCEPT

Indicates a GMM MO detach acceptance.

Since:

JDE 3.6.0

GMM_MT_DETACH_REQUEST

public static final int GMM_MT_DETACH_REQUEST

Indicates a GMM MT detach request. Note that a cause value may be associated with this event code (see mobilityManagementEvent(int, int)), but the value may be CAUSE_NOT_APPLICABLE.

Since:

JDE 3.6.0

GMM_PTMSI_REALLOC_CMD

public static final int GMM_PTMSI_REALLOC_CMD

Indicates a PTMSI reallocation command .

Since:

JDE 3.6.0

GMM_RA_UPDATE_ACCEPT

public static final int GMM_RA_UPDATE_ACCEPT

Indicates a GMM routing area update acceptance. Note that a cause value may be associated with this event code (see mobilityManagementEvent(int, int)), but the value may be CAUSE_NOT_APPLICABLE.

Since:

JDE 3.6.0

GMM_RA_UPDATE_REJECT

public static final int GMM_RA_UPDATE_REJECT

Indicates a GMM routing area update rejection. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

MM_ABORT

public static final int MM_ABORT

Indicates an abort request. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

MM_AUTHENTICATION_REJECT

public static final int MM_AUTHENTICATION_REJECT

Indicates an authenticcation rejection.

Since:

JDE 3.6.0

MM_AUTHENTICATION_REQUEST

public static final int MM_AUTHENTICATION_REQUEST

Indicates an authentication request.

Since:

JDE 3.6.0

MM_CM_SERVICE_ACCEPT

public static final int MM_CM_SERVICE_ACCEPT

Indictes a call management service acceptance.

Since:

JDE 3.6.0

MM_CM_SERVICE_REJECT

public static final int MM_CM_SERVICE_REJECT

Indicates a call management service rejection. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

MM_IDENTITY_REQUEST

public static final int MM_IDENTITY_REQUEST

Indicates an identity request.

Since:

JDE 3.6.0

MM_LOCATION_UPDATE_ACCEPT

public static final int MM_LOCATION_UPDATE_ACCEPT

Indicates location update acceptance.

Since:

JDE 3.6.0

MM_LOCATION_UPDATE_REJECT

public static final int MM_LOCATION_UPDATE_REJECT

Indicates location update rejection. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

MM_MM_INFORMATION

public static final int MM_MM_INFORMATION

Indicates a mobility management information request.

Since:

JDE 3.6.0

MM_MM_STATUS

public static final int MM_MM_STATUS

Indicates a status request.

Since:

JDE 3.6.0

MM_TMSI_REALLOC_CMD

public static final int MM_TMSI_REALLOC_CMD

Indicates a TMSI reallocation command.

Since:

JDE 3.6.0

PDP_CAUSE_AUTHENTICATION_FAILED

public static final int PDP_CAUSE_AUTHENTICATION_FAILED

Indicates that the requested service was rejected by the network because the user could not be authenticated.

Since:

JDE 3.6.0

PDP_CAUSE_INSUFFICIENT_RESOURCES

public static final int PDP_CAUSE_INSUFFICIENT_RESOURCES

Indicates that a PDP context activation request or a PDP context modification request cannot be accepted due to insufficient resources.

Since:

JDE 3.6.0

PDP_CAUSE_LLC_FAILURE

public static final int PDP_CAUSE_LLC_FAILURE

Indicates that a PDP context is deactivated because of a LLC or SNDCP failure.

Since:

JDE 3.6.0

PDP_CAUSE_NETWORK_FAILURED

public static final int PDP_CAUSE_NETWORK_FAILURED

Indicates that the PDP context deactivation was caused by a network error.

Since:

JDE 3.6.0

PDP_CAUSE_NORMAL_DEACTIVATION

public static final int PDP_CAUSE_NORMAL_DEACTIVATION

Indicates a regular PDP context deactivation.

Since:

JDE 3.6.0

PDP_CAUSE_NOT_SUPPORTED

public static final int PDP_CAUSE_NOT_SUPPORTED

Indicates that the PDP context activation initiated by the network is not supported by the MS.

Since:

JDE 3.6.0

PDP_CAUSE_NSAPI_ALREADY_USED

public static final int PDP_CAUSE_NSAPI_ALREADY_USED

Indicates that the requested NSAPI in the PDP context activation is already used by another active PDP context.

Since:

JDE 3.6.0

PDP_CAUSE_QOS_NOT_ACCEPTED

public static final int PDP_CAUSE_QOS_NOT_ACCEPTED

Indicates that the new Quality of Service (QoS) cannot be accepted.

Since:

JDE 3.6.0

PDP_CAUSE_REACTIVATION_REQUESTED

public static final int PDP_CAUSE_REACTIVATION_REQUESTED

Used by the network to request a PDP context reactivation after a GGSN restart.

Since:

JDE 3.6.0

PDP_CAUSE_REJECTED

public static final int PDP_CAUSE_REJECTED

Indicates that the requested service was rejected for unspecified reasons.

Since:

JDE 3.6.0

PDP_CAUSE_REJECTED_BY_GGSN

public static final int PDP_CAUSE_REJECTED_BY_GGSN

Indicates that the requested service was rejected by the GGSN.

Since:

JDE 3.6.0

PDP_CAUSE_SERVICE_NOT_SUBSCRIBED

public static final int PDP_CAUSE_SERVICE_NOT_SUBSCRIBED

Indicates that the requested service option is not currently subscribed.

Since:

JDE 3.6.0

PDP_CAUSE_SERVICE_NOT_SUPPORTED

public static final int PDP_CAUSE_SERVICE_NOT_SUPPORTED

Indicates that the requested service is not supported by the PLMN.

Since:

JDE 3.6.0

PDP_CAUSE_SERVICE_OUT_OF_ORDER

public static final int PDP_CAUSE_SERVICE_OUT_OF_ORDER

Indicates that the request was rejected because of a temporary outage of one or more functions required for operation.

Since:

JDE 3.6.0

PDP_CAUSE_TFT_ALREADY_USED

public static final int PDP_CAUSE_TFT_ALREADY_USED

Indicates that the TFT was already used.

Since:

JDE 3.6.0

PDP_CAUSE_TFT_INVALID

public static final int PDP_CAUSE_TFT_INVALID

Indicates that the TFT is invalid.

Since:

JDE 3.6.0

PDP_CAUSE_UNKNOWN

public static final int PDP_CAUSE_UNKNOWN

The cause of the failure was unknown.

Since:

JDE 3.6.0

PDP_CAUSE_UNKNOWN_APN

public static final int PDP_CAUSE_UNKNOWN_APN

Indicates that the requested service was rejected by the network because the mandatory access point name (APN) was not included or could not be found.

Since:

JDE 3.6.0

PDP_CAUSE_UNKNOWN_PDP

public static final int PDP_CAUSE_UNKNOWN_PDP

Indicates that the requested service was rejected by the network because the PDP address or type could not be recognised.

Since:

JDE 3.6.0

PDP_CAUSE_UNKNOWN_PDP_CONTEXT

public static final int PDP_CAUSE_UNKNOWN_PDP_CONTEXT

Indicates that the PDP context is unknown.

Since:

JDE 3.6.0

PDP_STATE_ACTIVE

public static final int PDP_STATE_ACTIVE

The PDP context has become active.

Since:

JDE 3.6.0

PDP_STATE_INACTIVE

public static final int PDP_STATE_INACTIVE

The PDP context has become inactive.

Since:

JDE 3.6.0

PDP_STATE_IP_ADDRESS_CHANGED

public static final int PDP_STATE_IP_ADDRESS_CHANGED

The IP address for the PDP context has changed.

Since:

JDE 3.6.0

PDP_STATE_REJECTED

public static final int PDP_STATE_REJECTED

The PDP context request has been rejected by the network.

Since:

JDE 3.6.0

SM_DEACTIVATE_PDP_ACCEPT

public static final int SM_DEACTIVATE_PDP_ACCEPT

Indicates an SM deactivate PDP acceptance.

Since:

JDE 3.6.0

SM_DEACTIVATE_PDP_REQUEST

public static final int SM_DEACTIVATE_PDP_REQUEST

Indicates an SM deactivate PDP request. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

SM_PDP_ACTIVATE_ACCEPT

public static final int SM_PDP_ACTIVATE_ACCEPT

Indicates an SM PDP activation acceptance.

Since:

JDE 3.6.0

SM_PDP_ACTIVATE_REJECT

public static final int SM_PDP_ACTIVATE_REJECT

Indicates an SM PDP activation rejection. Note that a cause value will be associated with this event code (see mobilityManagementEvent(int, int)).

Since:

JDE 3.6.0

Method Detail

baseStationChange

public void baseStationChange()

Invoked when the radio has changed base stations.

Since:

JDE 3.6.0

mobilityManagementEvent

public void mobilityManagementEvent(int eventCode,
                                    int cause)

Invoked when the radio performs some kind of mobility management.

Note that the event code and cause is network type dependent.

Cause Codes
Only certain event codes will provide an associated cause code:

MM_LOCATION_UPDATE_REJECT, MM_CM_SERVICE_REJECT, MM_ABORT	See 3GPP 24.008 v3.6.0 R99 specification, section 10.5.3.6 for causes values related to these codes.
GMM_ATTACH_ACCEPT *, GMM_ATTACH_REJECT, GMM_MT_DETACH_REQUEST *, GMM_RA_UPDATE_ACCEPT *, GMM_RA_UPDATE_REJECT	See 3GPP 24.008 v3.6.0 R99 specification, section 10.5.5.14 for cause values related to these codes where applicable. Those events marked with an asterisk may not have a cause, in which case the returned cause value would be CAUSE_NOT_APPLICABLE.
SM_PDP_ACTIVATE_REJECT, SM_DEACTIVATE_PDP_REQUEST	See 3GPP 24.008 v3.6.0 R99 specification, section 10.5.6.6 for cause values related to these codes. SM_PDP_ACTIVATE_REJECT can also have a cause value of 102; this is an internal error indicating that the request has timed out because the network provided no response.

All other event codes should have a cause code of 0x7000 (CAUSE_NOT_APPLICABLE).

Parameters:

eventCode - The type of mobility management event.

cause - The cause of the event if one is applicable.

Since:

JDE 3.6.0

networkScanComplete

public void networkScanComplete(boolean success)

Invoked when a scan for available networks is completed.

Parameters:

success - True if the scan completed successfully; otherwise, false.

Since:

JDE 3.6.0

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.0

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.0

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.0

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.0

radioTurnedOff

public void radioTurnedOff()

Invoked when the radio has been turned off.

Since:

JDE 3.6.0

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.0