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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
Parameters |
serial
|
Serial number of request.
|
|
getClir
oneway getClir (int32_t serial)
Gets current CLIR status
Response function is IRadioResponse.getClirResponse()
Details |
RPC mode |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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 |
|
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().