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


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