Package: android.hardware.radio@1.0

IRadioIndication

interface IRadioIndication

Interface declaring unsolicited radio indications.

Methods

radioStateChanged

oneway radioStateChanged (RadioIndicationType type, RadioState radioState)

Indicates when radio state changes.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
radioState
Current radio state

callStateChanged

oneway callStateChanged (RadioIndicationType type)

Indicates when call state has changed.Callee must invoke IRadio.getCurrentCalls() Must be invoked on, for example, "RING", "BUSY", "NO CARRIER", and also call state transitions(DIALING->ALERTING ALERTING->ACTIVE)

Redundent or extraneous invocations are tolerated

Details
RPC mode
oneway
Parameters
type
Type of radio indication

networkStateChanged

oneway networkStateChanged (RadioIndicationType type)

Indicates when voice or data network state changed Callee must invoke IRadio.getVoiceRegistrationState(), IRadio.getDataRegistrationState(), and IRadio.getOperator()

Details
RPC mode
oneway
Parameters
type
Type of radio indication

newSms

oneway newSms (RadioIndicationType type, vec<uint8_t> pdu)

Indicates when new SMS is received.Callee must subsequently confirm the receipt of the SMS with a acknowledgeLastIncomingGsmSms()

Server must not send newSms() nor newSmsStatusReport() messages until a acknowledgeLastIncomingGsmSms() has been received

Details
RPC mode
oneway
Parameters
type
Type of radio indication
pdu
PDU of SMS-DELIVER represented as byte array.The PDU starts with the SMSC address per TS 27.005(+CMT:)

newSmsStatusReport

oneway newSmsStatusReport (RadioIndicationType type, vec<uint8_t> pdu)

Indicates when new SMS Status Report is received.Callee must subsequently confirm the receipt of the SMS with a acknowledgeLastIncomingGsmSms()

Server must not send newSms() nor newSmsStatusReport() messages until a acknowledgeLastIncomingGsmSms() has been received

Details
RPC mode
oneway
Parameters
type
Type of radio indication
pdu
PDU of SMS-STATUS-REPORT represented as byte array.The PDU starts with the SMSC address per TS 27.005(+CMT:)

newSmsOnSim

oneway newSmsOnSim (RadioIndicationType type, int32_t recordNumber)

Indicates when new SMS has been stored on SIM card

Details
RPC mode
oneway
Parameters
type
Type of radio indication
recordNumber
Record number on the sim

onUssd

oneway onUssd (RadioIndicationType type, UssdModeType modeType, string msg)

Indicates when a new USSD message is received.The USSD session is assumed to persist if the type code is REQUEST, otherwise the current session(if any)is assumed to have terminated.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
modeType
USSD type code
msg
Message string in UTF-8, if applicable

nitzTimeReceived

oneway nitzTimeReceived (RadioIndicationType type, string nitzTime, uint64_t receivedTime)

Indicates when radio has received a NITZ time message.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
nitzTime
NITZ time string in the form "yy/mm/dd, hh:mm:ss(+/-)tz, dt"
receivedTime
milliseconds since boot that the NITZ time was received

currentSignalStrength

oneway currentSignalStrength (RadioIndicationType type, SignalStrength signalStrength)

Indicates current signal strength of the radio.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
signalStrength
SignalStrength information as defined in types.hal

dataCallListChanged

oneway dataCallListChanged (RadioIndicationType type, vec<SetupDataCallResult> dcList)

Indicates data call contexts have changed.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
dcList
array of SetupDataCallResult identical to that returned by IRadio.getDataCallList().It is the complete list of current data contexts including new contexts that have been activated.A data call is only removed from this list when the framework sends a IRadio.deactivateDataCall() or the radio is powered off/on

suppSvcNotify

oneway suppSvcNotify (RadioIndicationType type, SuppSvcNotification suppSvc)

Reports supplementary service related notification from the network.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
suppSvc
SuppSvcNotification as defined in types.hal

stkSessionEnd

oneway stkSessionEnd (RadioIndicationType type)

Indicates when STK session is terminated by SIM.

Details
RPC mode
oneway
Parameters
type
Type of radio indication

stkProactiveCommand

oneway stkProactiveCommand (RadioIndicationType type, string cmd)

Indicates when SIM issue a STK proactive command to applications

Details
RPC mode
oneway
Parameters
type
Type of radio indication
cmd
SAT/USAT proactive represented as byte array starting with command tag.Refer ETSI TS 102.223 section 9.4 for command types

stkEventNotify

oneway stkEventNotify (RadioIndicationType type, string cmd)

Indicates when SIM notifies applcations some event happens.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
cmd
SAT/USAT commands or responses sent by ME to SIM or commands handled by ME, represented as byte array starting with first byte of response data for command tag.Refer ETSI TS 102.223 section 9.4 for command types

stkCallSetup

oneway stkCallSetup (RadioIndicationType type, int64_t timeout)

Indicates when SIM wants application to setup a voice call.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
timeout
Timeout value in millisec for setting up voice call

simSmsStorageFull

oneway simSmsStorageFull (RadioIndicationType type)

Indicates that SMS storage on the SIM is full.Sent when the network attempts to deliver a new SMS message.Messages cannot be saved on the SIM until space is freed.In particular, incoming Class 2 messages must not be stored

Details
RPC mode
oneway
Parameters
type
Type of radio indication

simRefresh

oneway simRefresh (RadioIndicationType type, SimRefreshResult refreshResult)

Indicates that file(s)on the SIM have been updated, or the SIM has been reinitialized.Note:If the SIM state changes as a result of the SIM refresh(eg, SIM_READY ->SIM_LOCKED_OR_ABSENT), simStatusChanged() must be sent.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
refreshResult
Result of sim refresh

callRing

oneway callRing (RadioIndicationType type, bool isGsm, CdmaSignalInfoRecord record)

Ring indication for an incoming call(eg, RING or CRING event). There must be at least one callRing() at the beginning of a call and sending multiple is optional.If the system property ro.telephony.call_ring.multiple is false then the upper layers must generate the multiple events internally.Otherwise the vendor code must generate multiple callRing() if ro.telephony.call_ring.multiple is true or if it is absent.

The rate of these events is controlled by ro.telephony.call_ring.delay and has a default value of 3000(3 seconds)if absent.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
isGsm
true for GSM & false for CDMA
record
Cdma Signal Information

simStatusChanged

oneway simStatusChanged (RadioIndicationType type)

Indicates that SIM state changes.Callee must invoke getIccCardStatus()

Details
RPC mode
oneway
Parameters
type
Type of radio indication

cdmaNewSms

oneway cdmaNewSms (RadioIndicationType type, CdmaSmsMessage msg)

Indicates when new CDMA SMS is received Callee must subsequently confirm the receipt of the SMS with acknowledgeLastIncomingCdmaSms() Server must not send cdmaNewSms() messages until acknowledgeLastIncomingCdmaSms() has been received

Details
RPC mode
oneway
Parameters
type
Type of radio indication
msg
Cdma Sms Message

newBroadcastSms

oneway newBroadcastSms (RadioIndicationType type, vec<uint8_t> data)

Indicates when new Broadcast SMS is received

Details
RPC mode
oneway
Parameters
type
Type of radio indication
data
If received from GSM network, "data" is byte array of 88 bytes which indicates each page of a CBS Message sent to the MS by the BTS as coded in 3GPP 23.041 Section 9.4.1.2.If received from UMTS network, "data" is byte array of 90 up to 1252 bytes which contain between 1 and 15 CBS Message pages sent as one packet to the MS by the BTS as coded in 3GPP 23.041 Section 9.4.2.2

cdmaRuimSmsStorageFull

oneway cdmaRuimSmsStorageFull (RadioIndicationType type)

Indicates that SMS storage on the RUIM is full.Messages cannot be saved on the RUIM until space is freed.

Details
RPC mode
oneway
Parameters
type
Type of radio indication

restrictedStateChanged

oneway restrictedStateChanged (RadioIndicationType type, PhoneRestrictedState state)

Indicates a restricted state change(eg, for Domain Specific Access Control). Radio must send this msg after radio off/on cycle no matter it is changed or not.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
state
Bitmask of restricted state as defined by PhoneRestrictedState

enterEmergencyCallbackMode

oneway enterEmergencyCallbackMode (RadioIndicationType type)

Indicates that the radio system selection module has autonomously entered emergency callback mode.

Details
RPC mode
oneway
Parameters
type
Type of radio indication

cdmaCallWaiting

oneway cdmaCallWaiting (RadioIndicationType type, CdmaCallWaiting callWaitingRecord)

Indicates when CDMA radio receives a call waiting indication.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
callWaitingRecord
Cdma CallWaiting information

cdmaOtaProvisionStatus

oneway cdmaOtaProvisionStatus (RadioIndicationType type, CdmaOtaProvisionStatus status)

Indicates when CDMA radio receives an update of the progress of an OTASP/OTAPA call.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
status
Cdma OTA provision status

cdmaInfoRec

oneway cdmaInfoRec (RadioIndicationType type, CdmaInformationRecords records)

Indicates when CDMA radio receives one or more info recs.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
records
New Cdma Information

indicateRingbackTone

oneway indicateRingbackTone (RadioIndicationType type, bool start)

Indicates that nework doesn't have in-band information, need to play out-band tone.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
start
true = start play ringback tone, false = stop playing ringback tone

resendIncallMute

oneway resendIncallMute (RadioIndicationType type)

Indicates that framework/application must reset the uplink mute state.

Details
RPC mode
oneway
Parameters
type
Type of radio indication

cdmaSubscriptionSourceChanged

oneway cdmaSubscriptionSourceChanged (RadioIndicationType type, CdmaSubscriptionSource cdmaSource)

Indicates when CDMA subscription source changed.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
cdmaSource
New Cdma SubscriptionSource

cdmaPrlChanged

oneway cdmaPrlChanged (RadioIndicationType type, int32_t version)

Indicates when PRL(preferred roaming list)changes.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
version
PRL version after PRL changes

exitEmergencyCallbackMode

oneway exitEmergencyCallbackMode (RadioIndicationType type)

Indicates when Emergency Callback Mode Ends.Indicates that the radio system selection module has proactively exited emergency callback mode.

Details
RPC mode
oneway
Parameters
type
Type of radio indication

rilConnected

oneway rilConnected (RadioIndicationType type)

Indicates the ril connects and returns the version

Details
RPC mode
oneway
Parameters
type
Type of radio indication

voiceRadioTechChanged

oneway voiceRadioTechChanged (RadioIndicationType type, RadioTechnology rat)

Indicates that voice technology has changed.Responds with new rat.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
rat
Current new voice rat

cellInfoList

oneway cellInfoList (RadioIndicationType type, vec<CellInfo> records)

Same information as returned by getCellInfoList().

Details
RPC mode
oneway
Parameters
type
Type of radio indication
records
Current cell information known to radio

imsNetworkStateChanged

oneway imsNetworkStateChanged (RadioIndicationType type)

Indicates when IMS registration state has changed.To get IMS registration state and IMS SMS format, callee needs to invoke getImsRegistrationState()

Details
RPC mode
oneway
Parameters
type
Type of radio indication

subscriptionStatusChanged

oneway subscriptionStatusChanged (RadioIndicationType type, bool activate)

Indicated when there is a change in subscription status.This event must be sent in the following scenarios - subscription readiness at modem, which was selected by telephony layer - when subscription is deactivated by modem due to UICC card removal - when network invalidates the subscription i.e.attach reject due to authentication reject

Details
RPC mode
oneway
Parameters
type
Type of radio indication
activate
false for subscription deactivated, true for subscription activated

srvccStateNotify

oneway srvccStateNotify (RadioIndicationType type, SrvccState state)

Indicates when Single Radio Voice Call Continuity(SRVCC)progress state has changed

Details
RPC mode
oneway
Parameters
type
Type of radio indication
state
New Srvcc State

hardwareConfigChanged

oneway hardwareConfigChanged (RadioIndicationType type, vec<HardwareConfig> configs)

Indicates when the hardware configuration associated with the RILd changes.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
configs
Array of hardware configs

radioCapabilityIndication

oneway radioCapabilityIndication (RadioIndicationType type, RadioCapability rc)

Sent when setRadioCapability() completes.Returns the phone radio capability exactly as getRadioCapability() and must be the same set as sent by setRadioCapability().

Details
RPC mode
oneway
Parameters
type
Type of radio indication
rc
Current radio capability

onSupplementaryServiceIndication

oneway onSupplementaryServiceIndication (RadioIndicationType type, StkCcUnsolSsResult ss)

Indicates when Supplementary service(SS)response is received when DIAL/USSD/SS is changed to SS by call control.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
ss

stkCallControlAlphaNotify

oneway stkCallControlAlphaNotify (RadioIndicationType type, string alpha)

Indicates when there is an ALPHA from UICC during Call Control.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
alpha
ALPHA string from UICC in UTF-8 format

lceData

oneway lceData (RadioIndicationType type, LceDataInfo lce)

Indicates when there is an incoming Link Capacity Estimate(LCE)info report.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
lce
LceData information

pcoData

oneway pcoData (RadioIndicationType type, PcoDataInfo pco)

Indicates when there is new Carrier PCO data received for a data call.Ideally only new data must be forwarded, though this is not required.Multiple boxes of carrier PCO data for a given call must result in a series of pcoData() calls.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
pco
New PcoData

modemReset

oneway modemReset (RadioIndicationType type, string reason)

Indicates when there is a modem reset.

When modem restarts, one of the following radio state transitions must happen 1)RadioState:ON->RadioState:UNAVAILABLE->RadioState:ON or 2)RadioState:OFF->RadioState:UNAVAILABLE->RadioState:OFF This message must be sent either just before the Radio State changes to RadioState:UNAVAILABLE or just after but must never be sent after the Radio State changes from RadioState:UNAVAILABLE to RadioState:ON/RadioState:OFF again.It must NOT be sent after the Radio state changes to RadioState:ON/RadioState:OFF after the modem restart as that may be interpreted as a second modem reset by the framework.

Details
RPC mode
oneway
Parameters
type
Type of radio indication
reason
the reason for the reset.It may be a crash signature if the restart was due to a crash or some string such as "user-initiated restart" or "AT command initiated restart" that explains the cause of the modem restart