net.rim.device.api.system
Interface RadioStatusListener

All Superinterfaces:
RadioListener

public interface RadioStatusListener
extends RadioListener

The listener interface for receiving radio status events.

Since:
BlackBerry API 3.6.0

Field Summary
static int CAUSE_NOT_APPLICABLE
          Deprecated. No longer supported
static int GMM_ATTACH_ACCEPT
          Deprecated. No longer supported
static int GMM_ATTACH_REJECT
          Deprecated. No longer supported
static int GMM_AUTH_CIPHER_REJECT
          Deprecated. No longer supported
static int GMM_AUTH_CIPHER_REQUEST
          Deprecated. No longer supported
static int GMM_GMM_INFORMATION
          Deprecated. No longer supported
static int GMM_IDENTITY_REQUEST
          Deprecated. No longer supported
static int GMM_MO_DETACH_ACCEPT
          Deprecated. No longer supported
static int GMM_MT_DETACH_REQUEST
          Deprecated. No longer supported
static int GMM_PTMSI_REALLOC_CMD
          Deprecated. No longer supported
static int GMM_RA_UPDATE_ACCEPT
          Deprecated. No longer supported
static int GMM_RA_UPDATE_REJECT
          Deprecated. No longer supported
static int MM_ABORT
          Deprecated. No longer supported
static int MM_AUTHENTICATION_REJECT
          Deprecated. No longer supported
static int MM_AUTHENTICATION_REQUEST
          Deprecated. No longer supported
static int MM_CM_SERVICE_ACCEPT
          Deprecated. No longer supported
static int MM_CM_SERVICE_REJECT
          Deprecated. No longer supported
static int MM_IDENTITY_REQUEST
          Deprecated. No longer supported
static int MM_LOCATION_UPDATE_ACCEPT
          Deprecated. No longer supported
static int MM_LOCATION_UPDATE_REJECT
          Deprecated. No longer supported
static int MM_MM_INFORMATION
          Deprecated. No longer supported
static int MM_MM_STATUS
          Deprecated. No longer supported
static int MM_TMSI_REALLOC_CMD
          Deprecated. No longer supported
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
          Deprecated. No longer supported
static int SM_DEACTIVATE_PDP_REQUEST
          Deprecated. No longer supported
static int SM_PDP_ACTIVATE_ACCEPT
          Deprecated. No longer supported
static int SM_PDP_ACTIVATE_REJECT
          Deprecated. No longer supported
 
Method Summary
 void baseStationChange()
          Invoked when the radio has changed base stations.
 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

static final int PDP_STATE_ACTIVE
The PDP context has become active.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_STATE_INACTIVE

static final int PDP_STATE_INACTIVE
The PDP context has become inactive.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_STATE_REJECTED

static final int PDP_STATE_REJECTED
The PDP context request has been rejected by the network.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_STATE_IP_ADDRESS_CHANGED

static final int PDP_STATE_IP_ADDRESS_CHANGED
The IP address for the PDP context has changed.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_UNKNOWN

static final int PDP_CAUSE_UNKNOWN
The cause of the failure was unknown.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_LLC_FAILURE

static final int PDP_CAUSE_LLC_FAILURE
Indicates that a PDP context is deactivated because of a LLC or SNDCP failure.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_INSUFFICIENT_RESOURCES

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.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_UNKNOWN_APN

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.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_UNKNOWN_PDP

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.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_AUTHENTICATION_FAILED

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

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_REJECTED_BY_GGSN

static final int PDP_CAUSE_REJECTED_BY_GGSN
Indicates that the requested service was rejected by the GGSN.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_REJECTED

static final int PDP_CAUSE_REJECTED
Indicates that the requested service was rejected for unspecified reasons.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_SERVICE_NOT_SUPPORTED

static final int PDP_CAUSE_SERVICE_NOT_SUPPORTED
Indicates that the requested service is not supported by the PLMN.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_SERVICE_NOT_SUBSCRIBED

static final int PDP_CAUSE_SERVICE_NOT_SUBSCRIBED
Indicates that the requested service option is not currently subscribed.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_SERVICE_OUT_OF_ORDER

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.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_NSAPI_ALREADY_USED

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.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_NORMAL_DEACTIVATION

static final int PDP_CAUSE_NORMAL_DEACTIVATION
Indicates a regular PDP context deactivation.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_QOS_NOT_ACCEPTED

static final int PDP_CAUSE_QOS_NOT_ACCEPTED
Indicates that the new Quality of Service (QoS) cannot be accepted.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_NETWORK_FAILURED

static final int PDP_CAUSE_NETWORK_FAILURED
Indicates that the PDP context deactivation was caused by a network error.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_REACTIVATION_REQUESTED

static final int PDP_CAUSE_REACTIVATION_REQUESTED
Used by the network to request a PDP context reactivation after a GGSN restart.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_NOT_SUPPORTED

static final int PDP_CAUSE_NOT_SUPPORTED
Indicates that the PDP context activation initiated by the network is not supported by the MS.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_TFT_ALREADY_USED

static final int PDP_CAUSE_TFT_ALREADY_USED
Indicates that the TFT was already used.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_TFT_INVALID

static final int PDP_CAUSE_TFT_INVALID
Indicates that the TFT is invalid.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

PDP_CAUSE_UNKNOWN_PDP_CONTEXT

static final int PDP_CAUSE_UNKNOWN_PDP_CONTEXT
Indicates that the PDP context is unknown.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_LOCATION_UPDATE_ACCEPT

static final int MM_LOCATION_UPDATE_ACCEPT
Deprecated. No longer supported
Indicates location update acceptance.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_LOCATION_UPDATE_REJECT

static final int MM_LOCATION_UPDATE_REJECT
Deprecated. No longer supported
Indicates location update rejection. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_AUTHENTICATION_REQUEST

static final int MM_AUTHENTICATION_REQUEST
Deprecated. No longer supported
Indicates an authentication request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_AUTHENTICATION_REJECT

static final int MM_AUTHENTICATION_REJECT
Deprecated. No longer supported
Indicates an authenticcation rejection.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_IDENTITY_REQUEST

static final int MM_IDENTITY_REQUEST
Deprecated. No longer supported
Indicates an identity request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_TMSI_REALLOC_CMD

static final int MM_TMSI_REALLOC_CMD
Deprecated. No longer supported
Indicates a TMSI reallocation command.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_CM_SERVICE_ACCEPT

static final int MM_CM_SERVICE_ACCEPT
Deprecated. No longer supported
Indictes a call management service acceptance.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_CM_SERVICE_REJECT

static final int MM_CM_SERVICE_REJECT
Deprecated. No longer supported
Indicates a call management service rejection. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_MM_STATUS

static final int MM_MM_STATUS
Deprecated. No longer supported
Indicates a status request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_ABORT

static final int MM_ABORT
Deprecated. No longer supported
Indicates an abort request. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

MM_MM_INFORMATION

static final int MM_MM_INFORMATION
Deprecated. No longer supported
Indicates a mobility management information request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_ATTACH_ACCEPT

static final int GMM_ATTACH_ACCEPT
Deprecated. No longer supported
Indicates a GMM attach acceptance. Note that a cause value may be associated with this event code RadioStatusListener.CAUSE_NOT_APPLICABLE.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_ATTACH_REJECT

static final int GMM_ATTACH_REJECT
Deprecated. No longer supported
Indicates a GMM attach rejection. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_MO_DETACH_ACCEPT

static final int GMM_MO_DETACH_ACCEPT
Deprecated. No longer supported
Indicates a GMM MO detach acceptance.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_RA_UPDATE_ACCEPT

static final int GMM_RA_UPDATE_ACCEPT
Deprecated. No longer supported
Indicates a GMM routing area update acceptance. Note that a cause value may be associated with this event code RadioStatusListener.CAUSE_NOT_APPLICABLE.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_MT_DETACH_REQUEST

static final int GMM_MT_DETACH_REQUEST
Deprecated. No longer supported
Indicates a GMM MT detach request. Note that a cause value may be associated with this event code RadioStatusListener.CAUSE_NOT_APPLICABLE.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_RA_UPDATE_REJECT

static final int GMM_RA_UPDATE_REJECT
Deprecated. No longer supported
Indicates a GMM routing area update rejection. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_PTMSI_REALLOC_CMD

static final int GMM_PTMSI_REALLOC_CMD
Deprecated. No longer supported
Indicates a PTMSI reallocation command .

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_AUTH_CIPHER_REQUEST

static final int GMM_AUTH_CIPHER_REQUEST
Deprecated. No longer supported
Indicates a GMM authorization cipher request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_AUTH_CIPHER_REJECT

static final int GMM_AUTH_CIPHER_REJECT
Deprecated. No longer supported
Indicates a GMM authorization cipher rejection.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_IDENTITY_REQUEST

static final int GMM_IDENTITY_REQUEST
Deprecated. No longer supported
Indicates a GMM identity request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

GMM_GMM_INFORMATION

static final int GMM_GMM_INFORMATION
Deprecated. No longer supported
Indicates a GMM information request.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

SM_PDP_ACTIVATE_ACCEPT

static final int SM_PDP_ACTIVATE_ACCEPT
Deprecated. No longer supported
Indicates an SM PDP activation acceptance.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

SM_PDP_ACTIVATE_REJECT

static final int SM_PDP_ACTIVATE_REJECT
Deprecated. No longer supported
Indicates an SM PDP activation rejection. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

SM_DEACTIVATE_PDP_REQUEST

static final int SM_DEACTIVATE_PDP_REQUEST
Deprecated. No longer supported
Indicates an SM deactivate PDP request. Note that a cause value will be associated with this event code

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

SM_DEACTIVATE_PDP_ACCEPT

static final int SM_DEACTIVATE_PDP_ACCEPT
Deprecated. No longer supported
Indicates an SM deactivate PDP acceptance.

See Also:
Constant Field Values
Since:
BlackBerry API 3.6.0

CAUSE_NOT_APPLICABLE

static final int CAUSE_NOT_APPLICABLE
Deprecated. No longer supported
Inapplicable cause value.

See Also:
Constant Field Values
Since:
BlackBerry API 4.0.0


Method Detail

signalLevel

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

networkStarted

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

baseStationChange

void baseStationChange()
Invoked when the radio has changed base stations.

Since:
BlackBerry API 3.6.0

radioTurnedOff

void radioTurnedOff()
Invoked when the radio has been turned off.

Since:
BlackBerry API 3.6.0

pdpStateChange

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 RadioStatusListener.PDP_STATE_ACTIVE, RadioStatusListener.PDP_STATE_INACTIVE, RadioStatusListener.PDP_STATE_REJECTED.
cause - One of the PDP cause values (for example, RadioStatusListener.PDP_CAUSE_UNKNOWN and other similar members).
Since:
BlackBerry API 3.6.0

networkStateChange

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

networkScanComplete

void networkScanComplete(boolean success)
Invoked when a scan for available networks is completed.

Parameters:
success - True if the scan completed successfully; otherwise, false.
Since:
BlackBerry API 3.6.0

networkServiceChange

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





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal