Package: android.hardware.radio@1.0

IRadio

interface IRadio

This interface is used by telephony & telecom to talk to cellular radio.All the functions have minimum one parameter:serial:which corresponds to serial no.of request.Serial numbers must only be memorized for the duration of a method call.If clients provide colliding serials(including passing the same serial to different methods), multiple responses(one for each method call)must still be served.

Methods

setResponseFunctions

setResponseFunctions (IRadioResponse radioResponse, IRadioIndication radioIndication)

Set response functions for radio requests & radio indications.

Details
Parameters
radioResponse
Object containing response functions
radioIndication
Object containing radio indications

getIccCardStatus

oneway getIccCardStatus (int32_t serial)

Requests status of the ICC card

Response function is IRadioResponse.getIccCardStatusResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

supplyIccPinForApp

oneway supplyIccPinForApp (int32_t serial, string pin, string aid)

Supplies ICC PIN.Only called if CardStatus has AppState.PIN state

Response function is IRadioResponse.supplyIccPinForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
pin
PIN value
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

supplyIccPukForApp

oneway supplyIccPukForApp (int32_t serial, string puk, string pin, string aid)

Supplies ICC PUK and new PIN.

Response function is IRadioResponse.supplyIccPukForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
puk
PUK value
pin
New PIN value
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

supplyIccPin2ForApp

oneway supplyIccPin2ForApp (int32_t serial, string pin2, string aid)

Supplies ICC PIN2.Only called following operation where SIM_PIN2 was returned as a a failure from a previous operation.

Response function is IRadioResponse.supplyIccPin2ForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
pin2
PIN2 value
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

supplyIccPuk2ForApp

oneway supplyIccPuk2ForApp (int32_t serial, string puk2, string pin2, string aid)

Supplies ICC PUK2 and new PIN2.

Response function is IRadioResponse.supplyIccPuk2ForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
puk2
PUK2 value
pin2
New PIN2 value
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

changeIccPinForApp

oneway changeIccPinForApp (int32_t serial, string oldPin, string newPin, string aid)

Supplies old ICC PIN and new PIN.

Response function is IRadioResponse.changeIccPinForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
oldPin
Old pin value
newPin
New pin value
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

changeIccPin2ForApp

oneway changeIccPin2ForApp (int32_t serial, string oldPin2, string newPin2, string aid)

Supplies old ICC PIN2 and new PIN2.

Response function is IRadioResponse.changeIccPin2ForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
oldPin2
Old pin2 value
newPin2
New pin2 value
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

supplyNetworkDepersonalization

oneway supplyNetworkDepersonalization (int32_t serial, string netPin)

Requests that network personalization be deactivated

Response function is IRadioResponse.supplyNetworkDepersonalizationResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
netPin
Network depersonlization code

getCurrentCalls

oneway getCurrentCalls (int32_t serial)

Requests current call list

Response function is IRadioResponse.getCurrentCallsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

dial

oneway dial (int32_t serial, Dial dialInfo)

Initiate voice call.This method is never used for supplementary service codes

Response function is IRadioResponse.dialResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
dialInfo
Dial struct

getImsiForApp

oneway getImsiForApp (int32_t serial, string aid)

Get the SIM IMSI Only valid when radio state is "RADIO_STATE_ON"

Response function is IRadioResponse.getImsiForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.

hangup

oneway hangup (int32_t serial, int32_t gsmIndex)

Hang up a specific line(like AT+CHLD=1x)After this HANGUP request returns, Radio must show the connection is NOT active anymore in next requestGetCurrentCalls query.

Response function is IRadioResponse.hangupResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
gsmIndex
Connection index(value of 'x' in CHLD above )

hangupWaitingOrBackground

oneway hangupWaitingOrBackground (int32_t serial)

Hang up waiting or held(like AT+CHLD=0)After this HANGUP request returns, Radio must show the connection is NOT active anymore in next getCurrentCalls() query.

Response function is IRadioResponse.hangupWaitingOrBackgroundResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

hangupForegroundResumeBackground

oneway hangupForegroundResumeBackground (int32_t serial)

Hang up waiting or held(like AT+CHLD=1)After this HANGUP request returns, Radio must show the connection is NOT active anymore in next getCurrentCalls query.

Response function is IRadioResponse.hangupForegroundResumeBackgroundResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

switchWaitingOrHoldingAndActive

oneway switchWaitingOrHoldingAndActive (int32_t serial)

Switch waiting or holding call and active call(like AT+CHLD=2)State transitions must be as follows:

Call transitions must happen as shown below.

BEFORE AFTER Call 1 Call 2 Call 1 Call 2 ACTIVE HOLDING HOLDING ACTIVE ACTIVE WAITING HOLDING ACTIVE HOLDING WAITING HOLDING ACTIVE ACTIVE IDLE HOLDING IDLE IDLE IDLE IDLE IDLE

Response function is IRadioResponse.switchWaitingOrHoldingAndActiveResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

conference

oneway conference (int32_t serial)

Conference holding and active(like AT+CHLD=3)

Response function is IRadioResponse.conferenceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

rejectCall

oneway rejectCall (int32_t serial)

Send UDUB(user determined user busy)to ringing or waiting call answer)

Response function is IRadioResponse.rejectCallResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getLastCallFailCause

oneway getLastCallFailCause (int32_t serial)

Requests the failure cause code for the most recently terminated call.

Response function is IRadioResponse.getLastCallFailCauseResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getSignalStrength

oneway getSignalStrength (int32_t serial)

Requests current signal strength and associated information.Must succeed if radio is on.

Response function is IRadioResponse.getSignalStrengthResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getVoiceRegistrationState

oneway getVoiceRegistrationState (int32_t serial)

Request current voice registration state

Response function is IRadioResponse.getVoiceRegistrationStateResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getDataRegistrationState

oneway getDataRegistrationState (int32_t serial)

Request current data registration state

Response function is IRadioResponse.getDataRegistrationStateResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getOperator

oneway getOperator (int32_t serial)

Request current operator ONS or EONS

Response function is IRadioResponse.getOperatorResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setRadioPower

oneway setRadioPower (int32_t serial, bool on)

Toggle radio on and off(for "airplane" mode)If the radio is turned off/on the radio modem subsystem is expected return to an initialized state.For instance, any voice and data calls must be terminated and all associated lists emptied.

Response function is IRadioResponse.setRadioPowerResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
on
To turn on radio ->on = true, to turn off radio ->on = false.

sendDtmf

oneway sendDtmf (int32_t serial, string s)

Send a DTMF tone

If the implementation is currently playing a tone requested via startDtmf(), that tone must be cancelled and the new tone must be played instead

Response function is IRadioResponse.sendDtmfResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
s
string with single char having one of 12 values:0-9, *, #

sendSms

oneway sendSms (int32_t serial, GsmSmsMessage message)

Send an SMS message

Response function is IRadioResponse.sendSmsResponse()

Based on the return error, caller decides to resend if sending sms fails.RadioError:SMS_SEND_FAIL_RETRY means retry(i.e.error cause is 332)and RadioError:GENERIC_FAILURE means no retry(i.e.error cause is 500 )

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
message
GsmSmsMessage as defined in types.hal

sendSMSExpectMore

oneway sendSMSExpectMore (int32_t serial, GsmSmsMessage message)

Send an SMS message.Identical to sendSms, except that more messages are expected to be sent soon.If possible, keep SMS relay protocol link open(eg TS 27.005 AT+CMMS command)

Response function is IRadioResponse.sendSMSExpectMoreResponse()

Based on the return error, caller decides to resend if sending sms fails.RadioError:SMS_SEND_FAIL_RETRY means retry(i.e.error cause is 332)and RadioError:GENERIC_FAILURE means no retry(i.e.error cause is 500 )

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
message
GsmSmsMessage as defined in types.hal

setupDataCall

oneway setupDataCall (int32_t serial, RadioTechnology radioTechnology, DataProfileInfo dataProfileInfo, bool modemCognitive, bool roamingAllowed, bool isRoaming)

Setup a packet data connection.If DataCallResponse.status return DataCallFailCause:NONE it is added to the list of data calls and a unsolDataCallListChanged() is sent.The call remains in the list until deactivateDataCall() is issued or the radio is powered off/on.This list is returned by getDataCallList() and dataCallListChanged().

The Radio is expected to:- Create one data call context.- Create and configure a dedicated interface for the context - The interface must be point to point.- The interface is configured with one or more addresses and is capable of sending and receiving packets.The prefix length of the addresses must be /32 for IPv4 and /128 for IPv6.- Must NOT change the linux routing table.- Support up to getDataRegistrationState response[5]number of simultaneous data call contexts.

Response function is IRadioResponse.setupDataCallResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
radioTechnology
Radio technology to use.
dataProfileInfo
data profile info.
modemCognitive
Indicating this profile was sent to the modem through setDataProfile earlier.
roamingAllowed
Indicating data roaming is allowed or not by the user.
isRoaming
Indicating the device is roaming or not.The 'protocol' parameter in the old RIL API must be filled accordingly based on the roaming condition.Note this is for backward compatibility with the old radio modem.The modem must not use this param for any other reason.

iccIOForApp

oneway iccIOForApp (int32_t serial, IccIo iccIo)

Request ICC I/O operation.This is similar to the TS 27.007 "restricted SIM" operation where it assumes all of the EF selection must be done by the callee

Arguments and responses that are unused for certain values of "command" must be ignored or set to empty string

Please note that IccIo has a "PIN2" field which may be empty string, or may specify a PIN2 for operations that require a PIN2(eg updating FDN records)

Response function is IRadioResponse.iccIOForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
iccIo
IccIo

sendUssd

oneway sendUssd (int32_t serial, string ussd)

Send a USSD message.

If a USSD session already exists, the message must be sent in the context of that session.Otherwise, a new session must be created.

The network reply must be reported via unsolOnUssd

Only one USSD session must exist at a time, and the session is assumed to exist until:a)The android system invokes cancelUssd() b)The implementation sends a unsolOnUssd() with a type code of "0"(USSD-Notify/no further action)or "2"(session terminated)

Response function is IRadioResponse.sendUssdResponse()

See also requestCancelUssd, unsolOnUssd

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
ussd
string containing the USSD request in UTF-8 format

cancelPendingUssd

oneway cancelPendingUssd (int32_t serial)

Cancel the current USSD session if one exists.

Response function is IRadioResponse.cancelPendingUssdResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getClir

oneway getClir (int32_t serial)

Gets current CLIR status

Response function is IRadioResponse.getClirResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setClir

oneway setClir (int32_t serial, int32_t status)

Set current CLIR status

Response function is IRadioResponse.setClirResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
status
"n" parameter from TS 27.007 7.7

getCallForwardStatus

oneway getCallForwardStatus (int32_t serial, CallForwardInfo callInfo)

Request call forward status.

Response function is IRadioResponse.getCallForwardStatusResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
callInfo
CallForwardInfo

setCallForward

oneway setCallForward (int32_t serial, CallForwardInfo callInfo)

Configure call forward rule

Response function is IRadioResponse.setCallForwardResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
callInfo
CallForwardInfo

getCallWaiting

oneway getCallWaiting (int32_t serial, int32_t serviceClass)

Query current call waiting state

Response function is IRadioResponse.getCallWaitingResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
serviceClass
Service class is the TS 27.007 service class to query

setCallWaiting

oneway setCallWaiting (int32_t serial, bool enable, int32_t serviceClass)

Configure current call waiting state

Response function is IRadioResponse.setCallWaitingResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
enable
is false for "disabled" and true for "enabled"
serviceClass
is the TS 27.007 service class bit vector of services to modify

acknowledgeLastIncomingGsmSms

oneway acknowledgeLastIncomingGsmSms (int32_t serial, bool success, SmsAcknowledgeFailCause cause)

Acknowledge successful or failed receipt of SMS previously indicated via unsolResponseNewSms

Response function is IRadioResponse.acknowledgeLastIncomingGsmSmsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
success
is true on successful receipt(basically, AT+CNMA=1 from TS 27.005 is 0 on failed receipt(basically, AT+CNMA=2 from TS 27.005 )
cause
: if success is false, this contains the failure cause as defined in TS 23.040, 9.2.3.22.

acceptCall

oneway acceptCall (int32_t serial)

Answer incoming call Must not be called for WAITING calls.switchWaitingOrHoldingAndActive() must be used in this case instead

Response function is IRadioResponse.acceptCallResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

deactivateDataCall

oneway deactivateDataCall (int32_t serial, int32_t cid, bool reasonRadioShutDown)

Deactivate packet data connection and remove from the data call list if RadioError:NONE is returned.Any other return values must also try to remove the call from the list.An unsolDataCallListChanged must be issued because of an deactivateDataCall.

Response function is IRadioResponse.deactivateDataCallResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
cid
Indicates CID
reasonRadioShutDown
Indicates Disconnect Reason false =>No specific reason specified true =>Radio shutdown requested

getFacilityLockForApp

oneway getFacilityLockForApp (int32_t serial, string facility, string password, int32_t serviceClass, string appId)

Query the status of a facility lock state

Response function is IRadioResponse.getFacilityLockForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
facility
is the facility string code from TS 27.007 7.4(eg "AO" for BAOC, "SC" for SIM lock )
password
is the password, or "" if not required
serviceClass
is the TS 27.007 service class bit vector of services to query
appId
is AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.This is only applicable in the case of Fixed Dialing Numbers(FDN)requests.

setFacilityLockForApp

oneway setFacilityLockForApp (int32_t serial, string facility, bool lockState, string password, int32_t serviceClass, string appId)

Enable/disable one facility lock

Response function is IRadioResponse.setFacilityLockForAppResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
facility
is the facility string code from TS 27.007 7.4(eg "AO" for BAOC )
lockState
false for "unlock" and true for "lock"
password
is the password
serviceClass
is string representation of decimal TS 27.007 service class bit vector.Eg, the string "1" means "set this facility for voice services"
appId
is AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.This is only applicable in the case of Fixed Dialing Numbers(FDN)requests.

setBarringPassword

oneway setBarringPassword (int32_t serial, string facility, string oldPassword, string newPassword)

Change call barring facility password

Response function is IRadioResponse.setBarringPasswordResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
facility
facility string code from TS 27.007 7.4(eg "AO" for BAOC )
oldPassword
old password
newPassword
new password

getNetworkSelectionMode

oneway getNetworkSelectionMode (int32_t serial)

Query current network selection mode

Response function is IRadioResponse.getNetworkSelectionModeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setNetworkSelectionModeAutomatic

oneway setNetworkSelectionModeAutomatic (int32_t serial)

Specify that the network must be selected automatically.This request must not respond until the new operator is selected and registered.

Response function is IRadioResponse.setNetworkSelectionModeAutomaticResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setNetworkSelectionModeManual

oneway setNetworkSelectionModeManual (int32_t serial, string operatorNumeric)

Manually select a specified network.This request must not respond until the new operator is selected and registered.

Response function is IRadioResponse.setNetworkSelectionModeManualResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
operatorNumeric
string specifying MCCMNC of network to select(eg "310170" )

getAvailableNetworks

oneway getAvailableNetworks (int32_t serial)

Scans for available networks

Response function is IRadioResponse.getAvailableNetworksResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

startDtmf

oneway startDtmf (int32_t serial, string s)

Start playing a DTMF tone.Continue playing DTMF tone until stopDtmf is received.If a startDtmf() is received while a tone is currently playing, it must cancel the previous tone and play the new one.

Response function is IRadioResponse.startDtmfResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
s
string having a single character with one of 12 values:0-9, *, #

stopDtmf

oneway stopDtmf (int32_t serial)

Stop playing a currently playing DTMF tone.

Response function is IRadioResponse.stopDtmfResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getBasebandVersion

oneway getBasebandVersion (int32_t serial)

Return string value indicating baseband version, eg response from AT+CGMR

Response function is IRadioResponse.getBasebandVersionResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

separateConnection

oneway separateConnection (int32_t serial, int32_t gsmIndex)

Separate a party from a multiparty call placing the multiparty call(less the specified party)on hold and leaving the specified party as the only other member of the current(active)call

Like AT+CHLD=2x

See TS 22.084 1.3.8.2(iii)TS 22.030 6.5.5 "Entering "2X followed by send" TS 27.007 "AT+CHLD=2x"

Response function is IRadioResponse.separateConnectionResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
gsmIndex
contains Connection index(value of 'x' in CHLD above )

setMute

oneway setMute (int32_t serial, bool enable)

Turn on or off uplink(microphone)mute.Must only be sent while voice call is active.Must always be reset to "disable mute" when a new voice call is initiated

Response function is IRadioResponse.setMuteResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
enable
true for "enable mute" and false for "disable mute"

getMute

oneway getMute (int32_t serial)

Queries the current state of the uplink mute setting

Response function is IRadioResponse.getMuteResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getClip

oneway getClip (int32_t serial)

Queries the status of the CLIP supplementary service(for MMI code "*#30#")

Response function is IRadioResponse.getClipResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getDataCallList

oneway getDataCallList (int32_t serial)

Returns the data call list.An entry is added when a setupDataCall() is issued and removed on a deactivateDataCall().The list is emptied when setRadioPower() off/on is issued.

Response function is IRadioResponse.getDataCallListResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setSuppServiceNotifications

oneway setSuppServiceNotifications (int32_t serial, bool enable)

Enables/disables supplementary service related notifications from the network.Notifications are reported via unsolSuppSvcNotification().

Response function is IRadioResponse.setSuppServiceNotificationsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
enable
true = notifications enabled, false = notifications disabled.

writeSmsToSim

oneway writeSmsToSim (int32_t serial, SmsWriteArgs smsWriteArgs)

Stores a SMS message to SIM memory.

Response function is IRadioResponse.writeSmsToSimResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
smsWriteArgs
SmsWriteArgs defined in types.hal

deleteSmsOnSim

oneway deleteSmsOnSim (int32_t serial, int32_t index)

Deletes a SMS message from SIM memory.

Response function is IRadioResponse.deleteSmsOnSimResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
index
Record index of the message to delete.

setBandMode

oneway setBandMode (int32_t serial, RadioBandMode mode)

Assign a specified band for RF configuration.

Response function is IRadioResponse.setBandModeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
mode
RadioBandMode defined in types.hal

getAvailableBandModes

oneway getAvailableBandModes (int32_t serial)

Get the list of band modes supported by RF.

Response function is IRadioResponse.getAvailableBandModesResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

sendEnvelope

oneway sendEnvelope (int32_t serial, string command)

Requests to send a SAT/USAT envelope command to SIM.The SAT/USAT envelope command refers to 3GPP TS 11.14 and 3GPP TS 31.111

Response function is IRadioResponse.sendEnvelopeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
command
SAT/USAT command in hexadecimal format string starting with command tag

sendTerminalResponseToSim

oneway sendTerminalResponseToSim (int32_t serial, string commandResponse)

Requests to send a terminal response to SIM for a received proactive command

Response function is IRadioResponse.sendTerminalResponseResponseToSim()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
commandResponse
SAT/USAT response in hexadecimal format string starting with first byte of response data

handleStkCallSetupRequestFromSim

oneway handleStkCallSetupRequestFromSim (int32_t serial, bool accept)

When STK application gets stkCallSetup(), the call actually has been initialized by mobile device already .(We could see the call has been in the 'call list')So, STK application needs to accept/reject the call according to user operations.

Response callback is IRadioResponse.handleStkCallSetupRequestFromSimResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
accept
true = accept the call setup, false = reject the call setup

explicitCallTransfer

oneway explicitCallTransfer (int32_t serial)

Connects the two calls and disconnects the subscriber from both calls.

Response callback is IRadioResponse.explicitCallTransferResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setPreferredNetworkType

oneway setPreferredNetworkType (int32_t serial, PreferredNetworkType nwType)

Requests to set the preferred network type for searching and registering(CS/PS domain, RAT, and operation mode)

Response callback is IRadioResponse.setPreferredNetworkTypeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
nwType
PreferredNetworkType defined in types.hal

getPreferredNetworkType

oneway getPreferredNetworkType (int32_t serial)

Query the preferred network type(CS/PS domain, RAT, and operation mode)for searching and registering

Response callback is IRadioResponse.getPreferredNetworkTypeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getNeighboringCids

oneway getNeighboringCids (int32_t serial)

Request neighboring cell id in GSM network

Response callback is IRadioResponse.getNeighboringCidsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setLocationUpdates

oneway setLocationUpdates (int32_t serial, bool enable)

Enables/disables network state change notifications due to changes in LAC and/or CID(for GSM)or BID/SID/NID/latitude/longitude(for CDMA). Basically +CREG=2 vs.+CREG=1(TS 27.007). Note:The Radio implementation must default to "updates enabled" when the screen is on and "updates disabled" when the screen is off.

Response callback is IRadioResponse.setLocationUpdatesResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
enable
true = updates enabled(+CREG=2), false = updates disabled(+CREG=1 )

setCdmaSubscriptionSource

oneway setCdmaSubscriptionSource (int32_t serial, CdmaSubscriptionSource cdmaSub)

Request to set the location where the CDMA subscription shall be retrieved

Response callback is IRadioResponse.setCdmaSubscriptionSourceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
cdmaSub
CdmaSubscriptionSource

setCdmaRoamingPreference

oneway setCdmaRoamingPreference (int32_t serial, CdmaRoamingType type)

Request to set the roaming preferences in CDMA

Response callback is IRadioResponse.setCdmaRoamingPreferenceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
type
CdmaRoamingType defined in types.hal

getCdmaRoamingPreference

oneway getCdmaRoamingPreference (int32_t serial)

Request the actual setting of the roaming preferences in CDMA in the modem

Response callback is IRadioResponse.getCdmaRoamingPreferenceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setTTYMode

oneway setTTYMode (int32_t serial, TtyMode mode)

Request to set the TTY mode

Response callback is IRadioResponse.setTTYModeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
mode
TtyMode

getTTYMode

oneway getTTYMode (int32_t serial)

Request the setting of TTY mode

Response callback is IRadioResponse.getTTYModeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setPreferredVoicePrivacy

oneway setPreferredVoicePrivacy (int32_t serial, bool enable)

Request to set the preferred voice privacy mode used in voice scrambling.

Response callback is IRadioResponse.setPreferredVoicePrivacyResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
enable
false for Standard Privacy Mode(Public Long Code Mask)true for Enhanced Privacy Mode(Private Long Code Mask )

getPreferredVoicePrivacy

oneway getPreferredVoicePrivacy (int32_t serial)

Request the setting of preferred voice privacy mode.

Response callback is IRadioResponse.getPreferredVoicePrivacyResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

sendCDMAFeatureCode

oneway sendCDMAFeatureCode (int32_t serial, string featureCode)

Send FLASH command

Response callback is IRadioResponse.sendCDMAFeatureCodeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
featureCode
String associated with Flash command

sendBurstDtmf

oneway sendBurstDtmf (int32_t serial, string dtmf, int32_t on, int32_t off)

Send DTMF string

Response callback is IRadioResponse.sendBurstDtmfResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
dtmf
DTMF string
on
DTMF ON length in milliseconds, or 0 to use default
off
is the DTMF OFF length in milliseconds, or 0 to use default

sendCdmaSms

oneway sendCdmaSms (int32_t serial, CdmaSmsMessage sms)

Send a CDMA SMS message

Response callback is IRadioResponse.sendCdmaSmsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
sms
Cdma Sms to be sent described by CdmaSmsMessage in types.hal

acknowledgeLastIncomingCdmaSms

oneway acknowledgeLastIncomingCdmaSms (int32_t serial, CdmaSmsAck smsAck)

Acknowledge the success or failure in the receipt of SMS previously indicated via responseCdmaNewSms()

Response callback is IRadioResponse.acknowledgeLastIncomingCdmaSmsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
smsAck
Cdma Sms ack to be sent described by CdmaSmsAck in types.hal

getGsmBroadcastConfig

oneway getGsmBroadcastConfig (int32_t serial)

Request the setting of GSM/WCDMA Cell Broadcast SMS config.

Response callback is IRadioResponse.getGsmBroadcastConfigResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setGsmBroadcastConfig

oneway setGsmBroadcastConfig (int32_t serial, vec<GsmBroadcastSmsConfigInfo> configInfo)

Set GSM/WCDMA Cell Broadcast SMS config

Response callback is IRadioResponse.setGsmBroadcastConfigResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
configInfo
Setting of GSM/WCDMA Cell broadcast config

setGsmBroadcastActivation

oneway setGsmBroadcastActivation (int32_t serial, bool activate)

Enable or disable the reception of GSM/WCDMA Cell Broadcast SMS

Response callback is IRadioResponse.setGsmBroadcastActivationResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
activate
indicates to activate or turn off the reception of GSM/WCDMA Cell Broadcast SMS.true = activate, false = turn off

getCdmaBroadcastConfig

oneway getCdmaBroadcastConfig (int32_t serial)

Request the setting of CDMA Broadcast SMS config

Response callback is IRadioResponse.getCdmaBroadcastConfigResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setCdmaBroadcastConfig

oneway setCdmaBroadcastConfig (int32_t serial, vec<CdmaBroadcastSmsConfigInfo> configInfo)

Set CDMA Broadcast SMS config

Response callback is IRadioResponse.setCdmaBroadcastConfigResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
configInfo
CDMA Broadcast SMS config to be set.

setCdmaBroadcastActivation

oneway setCdmaBroadcastActivation (int32_t serial, bool activate)

Enable or disable the reception of CDMA Cell Broadcast SMS

Response callback is IRadioResponse.setCdmaBroadcastActivationResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
activate
indicates to activate or turn off the reception of CDMA Cell Broadcast SMS.true = activate, false = turn off

getCDMASubscription

oneway getCDMASubscription (int32_t serial)

Request the device MDN / H_SID / H_NID.The request is only allowed when CDMA subscription is available.When CDMA subscription is changed, application layer must re-issue the request to update the subscription information.

Response callback is IRadioResponse.getCDMASubscriptionResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

writeSmsToRuim

oneway writeSmsToRuim (int32_t serial, CdmaSmsWriteArgs cdmaSms)

Stores a CDMA SMS message to RUIM memory.

Response callback is IRadioResponse.writeSmsToRuimResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
cdmaSms
CDMA message as defined by CdmaSmsWriteArgs in types.hal

deleteSmsOnRuim

oneway deleteSmsOnRuim (int32_t serial, int32_t index)

Deletes a CDMA SMS message from RUIM memory.

Response callback is IRadioResponse.deleteSmsOnRuimResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
index
record index of the message to delete

getDeviceIdentity

oneway getDeviceIdentity (int32_t serial)

Request the device ESN / MEID / IMEI / IMEISV.The request is always allowed and contains GSM and CDMA device identity.When CDMA subscription is changed the ESN/MEID changes.The application layer must re-issue the request to update the device identity in this case.

Response callback is IRadioResponse.getDeviceIdentityResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

exitEmergencyCallbackMode

oneway exitEmergencyCallbackMode (int32_t serial)

Request the radio's system selection module to exit emergency callback mode.Radio must not respond with SUCCESS until the modem has completely exited from Emergency Callback Mode.

Response callback is IRadioResponse.exitEmergencyCallbackModeResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getSmscAddress

oneway getSmscAddress (int32_t serial)

Get the default Short Message Service Center address on the device.

Response callback is IRadioResponse.getSmscAddressResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setSmscAddress

oneway setSmscAddress (int32_t serial, string smsc)

Set the default Short Message Service Center address on the device.

Response callback is IRadioResponse.setSmscAddressResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
smsc
Short Message Service Center address to set

reportSmsMemoryStatus

oneway reportSmsMemoryStatus (int32_t serial, bool available)

Indicates whether there is storage available for new SMS messages.

Response callback is IRadioResponse.reportSmsMemoryStatusResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
available
true if memory is available for storing new messages, false if memory capacity is exceeded

reportStkServiceIsRunning

oneway reportStkServiceIsRunning (int32_t serial)

Indicates that the StkService is running and is ready to receive unsolicited stkXXXXX commands.

Response callback is IRadioResponse.reportStkServiceIsRunningResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getCdmaSubscriptionSource

oneway getCdmaSubscriptionSource (int32_t serial)

Request to query the location where the CDMA subscription shall be retrieved.

Response callback is IRadioResponse.getCdmaSubscriptionSourceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

requestIsimAuthentication

oneway requestIsimAuthentication (int32_t serial, string challenge)

Request the ISIM application on the UICC to perform AKA challenge/response algorithm for IMS authentication

Response callback is IRadioResponse.requestIsimAuthenticationResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
challenge
challenge string in Base64 format

acknowledgeIncomingGsmSmsWithPdu

oneway acknowledgeIncomingGsmSmsWithPdu (int32_t serial, bool success, string ackPdu)

Acknowledge successful or failed receipt of SMS previously indicated via unsol responseNewSms(), including acknowledgement TPDU to send as the RP-User-Data element of the RP-ACK or RP-ERROR PDU.

Response callback is IRadioResponse.acknowledgeIncomingGsmSmsWithPduResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
success
true on successful receipt(send RP-ACK)false on failed receipt(send RP-ERROR )
ackPdu
acknowledgement TPDU in hexadecimal format

sendEnvelopeWithStatus

oneway sendEnvelopeWithStatus (int32_t serial, string contents)

Requests to send a SAT/USAT envelope command to SIM.The SAT/USAT envelope command refers to 3GPP TS 11.14 and 3GPP TS 31.111.

This request has one difference from sendEnvelope():the SW1 and SW2 status bytes from the UICC response are returned along with the response data, using the same structure as iccIOForApp().

The implementation must perform normal processing of a '91XX' response in SW1/SW2 to retrieve the pending proactive command and send it as an unsolicited response, as sendEnvelope() does.

Response callback is IRadioResponse.sendEnvelopeWithStatusResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
contents
SAT/USAT command in hexadecimal format starting with command tag

getVoiceRadioTechnology

oneway getVoiceRadioTechnology (int32_t serial)

Query the radio technology type(3GPP/3GPP2)used for voice.Query is valid only when radio state is not RADIO_STATE_UNAVAILABLE

Response callback is IRadioResponse.getVoiceRadioTechnologyResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getCellInfoList

oneway getCellInfoList (int32_t serial)

Request all of the current cell information known to the radio.The radio must return list of all current cells, including the neighboring cells.If for a particular cell information isn't known then the appropriate unknown value will be returned.This does not cause or change the rate of unsolicited cellInfoList().

Response callback is IRadioResponse.getCellInfoListResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setCellInfoListRate

oneway setCellInfoListRate (int32_t serial, int32_t rate)

Sets the minimum time between when unsolicited cellInfoList() must be invoked.A value of 0, means invoke cellInfoList() when any of the reported information changes.Setting the value to INT_MAX(0x7fffffff)means never issue a unsolicited cellInfoList().

Response callback is IRadioResponse.setCellInfoListRateResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
rate
minimum time in milliseconds to indicate time between unsolicited cellInfoList()

setInitialAttachApn

oneway setInitialAttachApn (int32_t serial, DataProfileInfo dataProfileInfo, bool modemCognitive, bool isRoaming)

Set an apn to initial attach network

Response callback is IRadioResponse.setInitialAttachApnResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
dataProfileInfo
data profile containing APN settings
modemCognitive
indicating the data profile was sent to the modem through setDataProfile earlier.
isRoaming
Indicating the device is roaming or not.The 'protocol' parameter in the old RIL_InitialAttachApn must be filled accordingly based on the roaming condition.Note this is for backward compatibility with the old radio modem.The modem must not use this param for any other reason.

getImsRegistrationState

oneway getImsRegistrationState (int32_t serial)

Request current IMS registration state

Response callback is IRadioResponse.getImsRegistrationStateResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

sendImsSms

oneway sendImsSms (int32_t serial, ImsSmsMessage message)

Send a SMS message over IMS.Based on the return error, caller decides to resend if sending sms fails.SMS_SEND_FAIL_RETRY means retry, and other errors means no retry.In case of retry, data is encoded based on Voice Technology available.

Response callback is IRadioResponse.sendImsSmsResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
message
ImsSmsMessage as defined in types.hal to be sent

iccTransmitApduBasicChannel

oneway iccTransmitApduBasicChannel (int32_t serial, SimApdu message)

Request APDU exchange on the basic channel.This command reflects TS 27.007 "generic SIM access" operation(+CSIM). The modem must ensure proper function of GSM/CDMA, and filter commands appropriately.It must filter channel management and SELECT by DF name commands."sessionid" field must be ignored.

Response callback is IRadioResponse.iccTransmitApduBasicChannelResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
message
SimApdu as defined in types.hal to be sent

iccOpenLogicalChannel

oneway iccOpenLogicalChannel (int32_t serial, string aid, int32_t p2)

Open a new logical channel and select the given application.This command reflects TS 27.007 "open logical channel" operation(+CCHO).

Response callback is IRadioResponse.iccOpenLogicalChannelResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
aid
AID value, See ETSI 102.221 and 101.220.
p2
P2 value, described in ISO 7816-4.Ignore if equal to P2Constant:NO_P2

iccCloseLogicalChannel

oneway iccCloseLogicalChannel (int32_t serial, int32_t channelId)

Close a previously opened logical channel.This command reflects TS 27.007 "close logical channel" operation(+CCHC).

Response callback is IRadioResponse.iccCloseLogicalChannelResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
channelId
session id of the logical channel(+CCHC).

iccTransmitApduLogicalChannel

oneway iccTransmitApduLogicalChannel (int32_t serial, SimApdu message)

Exchange APDUs with a UICC over a previously opened logical channel.This command reflects TS 27.007 "generic logical channel access" operation(+CGLA). The modem must filter channel management and SELECT by DF name commands.

Response callback is IRadioResponse.iccTransmitApduLogicalChannelResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
message
SimApdu as defined in types.hal to be sent

nvReadItem

oneway nvReadItem (int32_t serial, NvItem itemId)

Read one of the radio NV items.This is used for device configuration by some CDMA operators.

Response callback is IRadioResponse.nvReadItemResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
itemId
NvItem is radio NV item as defined in types.hal

nvWriteItem

oneway nvWriteItem (int32_t serial, NvWriteItem item)

Write one of the radio NV items.This is used for device configuration by some CDMA operators.

Response callback is IRadioResponse.nvWriteItemResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
item
NvWriteItem as defined in types.hal

nvWriteCdmaPrl

oneway nvWriteCdmaPrl (int32_t serial, vec<uint8_t> prl)

Update the CDMA Preferred Roaming List(PRL)in the radio NV storage.This is used for device configuration by some CDMA operators.

Response callback is IRadioResponse.nvWriteCdmaPrlResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
prl
PRL as a byte array

nvResetConfig

oneway nvResetConfig (int32_t serial, ResetNvType resetType)

Reset the radio NV configuration to the factory state.This is used for device configuration by some CDMA operators.

Response callback is IRadioResponse.nvResetConfigResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
resetType
ResetNvType as defined in types.hal

setUiccSubscription

oneway setUiccSubscription (int32_t serial, SelectUiccSub uiccSub)

Selection/de-selection of a subscription from a SIM card

Response callback is IRadioResponse.setUiccSubscriptionResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
uiccSub
SelectUiccSub as defined in types.hal

setDataAllowed

oneway setDataAllowed (int32_t serial, bool allow)

Tells the modem whether data calls are allowed or not

Response callback is IRadioResponse.setDataAllowedResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
allow
true to allow data calls, false to disallow data calls

getHardwareConfig

oneway getHardwareConfig (int32_t serial)

Request all of the current hardware(modem and sim)associated with Radio.

Response callback is IRadioResponse.getHardwareConfigResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

requestIccSimAuthentication

oneway requestIccSimAuthentication (int32_t serial, int32_t authContext, string authData, string aid)

Returns the response of SIM Authentication through Radio challenge request.

Response callback is IRadioResponse.requestIccSimAuthenticationResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
authContext
P2 value of authentication command, see P2 parameter in 3GPP TS 31.102 7.1.2
authData
the challenge string in Base64 format, see 3GPP TS 31.102 7.1.2
aid
AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value

setDataProfile

oneway setDataProfile (int32_t serial, vec<DataProfileInfo> profiles, bool isRoaming)

Set data profile in modem.Modem must erase existed profiles from framework, and apply new profiles

Response callback is IRadioResponse.setDataProfileResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
profiles
Array of DataProfiles to set.
isRoaming
Indicating the device is roaming or not.The 'protocol' parameter in the old RIL API RIL_DataProfileInfo must be filled accordingly based on the roaming condition.Note this is for backward compatibility with the old radio modem.The modem must not use this param for any other reason.

requestShutdown

oneway requestShutdown (int32_t serial)

Device is shutting down.All further commands are ignored and RADIO_NOT_AVAILABLE must be returned.

Response callback is IRadioResponse.requestShutdownResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getRadioCapability

oneway getRadioCapability (int32_t serial)

Used to get phone radio capability.

Response callback is IRadioResponse.getRadioCapabilityResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setRadioCapability

oneway setRadioCapability (int32_t serial, RadioCapability rc)

Used to set the phones radio capability.Be VERY careful using this request as it may cause some vendor modems to reset.Because of the possible modem reset any radio commands after this one may not be processed.

Response callback is IRadioResponse.setRadioCapabilityResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
rc
RadioCapability structure to be set

startLceService

oneway startLceService (int32_t serial, int32_t reportInterval, bool pullMode)

Start Link Capacity Estimate(LCE)service if supported by the radio.

Response callback is IRadioResponse.startLceServiceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
reportInterval
desired reporting interval(ms).
pullMode
LCE service mode.true:PULL;false:PUSH.

stopLceService

oneway stopLceService (int32_t serial)

Stop Link Capacity Estimate(LCE)service, the STOP operation must be idempotent for the radio modem.

Response callback is IRadioResponse.stopLceServiceResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

pullLceData

oneway pullLceData (int32_t serial)

Pull LCE service for capacity information.

Response callback is IRadioResponse.pullLceDataResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

getModemActivityInfo

oneway getModemActivityInfo (int32_t serial)

Get modem activity information for power consumption estimation.Request clear-on-read statistics information that is used for estimating the per-millisecond power consumption of the cellular modem.

Response callback is IRadioResponse.getModemActivityInfoResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

setAllowedCarriers

oneway setAllowedCarriers (int32_t serial, bool allAllowed, CarrierRestrictions carriers)

Set carrier restrictions.Expected modem behavior:If never receives this command - Must allow all carriers Receives this command with allAllowed true - Must allow all carriers.If a previously allowed SIM is present, modem must not reload the SIM.If a previously disallowed SIM is present, reload the SIM and notify Android.Receives this command with a list of carriers & allAllowed = false - Only allow specified carriers, persist across power cycles and FDR.If a present SIM is in the allowed list, modem must not reload the SIM.If a present SIM is *not* in the allowed list, modem must detach from the registered network and only keep emergency service, and notify Android SIM refresh reset with new SIM state being CardState:RESTRICTED.Emergency service must be enabled.

Response callback is IRadioResponse.setAllowedCarriersResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
allAllowed
true only when all carriers are allowed.Ignore "carriers" struct.If false, consider "carriers" struct
carriers
CarrierRestrictions consisting allowed and excluded carriers as defined in types.hal

getAllowedCarriers

oneway getAllowedCarriers (int32_t serial)

Get carrier restrictions.

Response callback is IRadioResponse.getAllowedCarriersResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

sendDeviceState

oneway sendDeviceState (int32_t serial, DeviceStateType deviceStateType, bool state)

Send the updated device state.This is providing the device state information for the modem to perform power saving strategies.

Response callback is IRadioResponse.sendDeviceStateResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
deviceStateType
The updated device state type.
state
The updated state.See the definition of state at DeviceStateType.

setIndicationFilter

oneway setIndicationFilter (int32_t serial, bitfield<IndicationFilter> indicationFilter)

Set the indication filter.This is used to prevent unnecessary application processor wake up for power saving purposes by suppressing the indications in certain scenarios.

Response callback is IRadioResponse.setIndicationFilterResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
indicationFilter
32-bit bitmap of IndicationFilter.Bits set to 1 indicate the indications are enabled.See IndicationFilter for the definition of each bit.

setSimCardPower

oneway setSimCardPower (int32_t serial, bool powerUp)

Set SIM card power state.Request is equivalent to inserting or removing the card.

The radio modem must generate IRadioIndication.simStatusChanged() as if the SIM had been inserted or removed.

Response callback is IRadioResponse.setSimCardPowerResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request
powerUp
True if powering up the sim card

responseAcknowledgement

oneway responseAcknowledgement ()

When response type received from a radio indication or radio response is RadioIndicationType:UNSOLICITED_ACK_EXP or RadioResponseType:SOLICITED_ACK_EXP respectively, acknowledge the receipt of those messages by sending responseAcknowledgement().

Details
RPC mode
oneway