You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1596 lines
58 KiB
1596 lines
58 KiB
/*
|
|
* Copyright (C) 2016 The Android Open Source Project
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
package android.hardware.radio@1.0;
|
|
|
|
import IRadioResponse;
|
|
import IRadioIndication;
|
|
|
|
/**
|
|
* 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.
|
|
*/
|
|
interface IRadio {
|
|
/**
|
|
* Set response functions for radio requests & radio indications.
|
|
*
|
|
* @param radioResponse Object containing response functions
|
|
* @param radioIndication Object containing radio indications
|
|
*/
|
|
setResponseFunctions(IRadioResponse radioResponse,
|
|
IRadioIndication radioIndication);
|
|
|
|
/**
|
|
* Requests status of the ICC card
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getIccCardStatusResponse()
|
|
*
|
|
*/
|
|
oneway getIccCardStatus(int32_t serial);
|
|
|
|
/**
|
|
* Supplies ICC PIN. Only called if CardStatus has AppState.PIN state
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param pin PIN value
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.supplyIccPinForAppResponse()
|
|
*
|
|
*/
|
|
oneway supplyIccPinForApp(int32_t serial, string pin, string aid);
|
|
|
|
/**
|
|
* Supplies ICC PUK and new PIN.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param puk PUK value
|
|
* @param pin New PIN value
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.supplyIccPukForAppResponse()
|
|
*
|
|
*/
|
|
oneway supplyIccPukForApp(int32_t serial, string puk, string pin, string aid);
|
|
|
|
/**
|
|
* Supplies ICC PIN2. Only called following operation where SIM_PIN2 was
|
|
* returned as a a failure from a previous operation.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param pin2 PIN2 value
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.supplyIccPin2ForAppResponse()
|
|
*
|
|
*/
|
|
oneway supplyIccPin2ForApp(int32_t serial, string pin2, string aid);
|
|
|
|
/**
|
|
* Supplies ICC PUK2 and new PIN2.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param puk2 PUK2 value
|
|
* @param pin2 New PIN2 value
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.supplyIccPuk2ForAppResponse()
|
|
*
|
|
*/
|
|
oneway supplyIccPuk2ForApp(int32_t serial, string puk2, string pin2,
|
|
string aid);
|
|
|
|
/**
|
|
* Supplies old ICC PIN and new PIN.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param oldPin Old pin value
|
|
* @param newPin New pin value
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.changeIccPinForAppResponse()
|
|
*
|
|
*/
|
|
oneway changeIccPinForApp(int32_t serial, string oldPin, string newPin,
|
|
string aid);
|
|
|
|
/**
|
|
* Supplies old ICC PIN2 and new PIN2.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param oldPin2 Old pin2 value
|
|
* @param newPin2 New pin2 value
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.changeIccPin2ForAppResponse()
|
|
*
|
|
*/
|
|
oneway changeIccPin2ForApp(int32_t serial, string oldPin2, string newPin2,
|
|
string aid);
|
|
|
|
/**
|
|
* Requests that network personalization be deactivated
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param netPin Network depersonlization code
|
|
*
|
|
* Response function is IRadioResponse.supplyNetworkDepersonalizationResponse()
|
|
*
|
|
*/
|
|
oneway supplyNetworkDepersonalization(int32_t serial, string netPin);
|
|
|
|
/**
|
|
* Requests current call list
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getCurrentCallsResponse()
|
|
*
|
|
*/
|
|
oneway getCurrentCalls(int32_t serial);
|
|
|
|
/**
|
|
* Initiate voice call.
|
|
* This method is never used for supplementary service codes
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param dialInfo Dial struct
|
|
*
|
|
* Response function is IRadioResponse.dialResponse()
|
|
*
|
|
*/
|
|
oneway dial(int32_t serial, Dial dialInfo);
|
|
|
|
/**
|
|
* Get the SIM IMSI
|
|
* Only valid when radio state is "RADIO_STATE_ON"
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value.
|
|
*
|
|
* Response function is IRadioResponse.getImsiForAppResponse()
|
|
*
|
|
*/
|
|
oneway getImsiForApp(int32_t serial, string aid);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param gsmIndex Connection index (value of 'x' in CHLD above)
|
|
*
|
|
* Response function is IRadioResponse.hangupResponse()
|
|
*
|
|
*/
|
|
oneway hangup(int32_t serial, int32_t gsmIndex);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.hangupWaitingOrBackgroundResponse()
|
|
*
|
|
*/
|
|
oneway hangupWaitingOrBackground(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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.hangupForegroundResumeBackgroundResponse()
|
|
*
|
|
*/
|
|
oneway hangupForegroundResumeBackground(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
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.switchWaitingOrHoldingAndActiveResponse()
|
|
*
|
|
*/
|
|
oneway switchWaitingOrHoldingAndActive(int32_t serial);
|
|
|
|
/**
|
|
* Conference holding and active (like AT+CHLD=3)
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.conferenceResponse()
|
|
*
|
|
*/
|
|
oneway conference(int32_t serial);
|
|
|
|
/**
|
|
* Send UDUB (user determined user busy) to ringing or
|
|
* waiting call answer)
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.rejectCallResponse()
|
|
*
|
|
*/
|
|
oneway rejectCall(int32_t serial);
|
|
|
|
/**
|
|
* Requests the failure cause code for the most recently terminated call.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getLastCallFailCauseResponse()
|
|
*
|
|
*/
|
|
oneway getLastCallFailCause(int32_t serial);
|
|
|
|
/**
|
|
* Requests current signal strength and associated information.
|
|
* Must succeed if radio is on.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getSignalStrengthResponse()
|
|
*/
|
|
oneway getSignalStrength(int32_t serial);
|
|
|
|
/**
|
|
* Request current voice registration state
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getVoiceRegistrationStateResponse()
|
|
*/
|
|
oneway getVoiceRegistrationState(int32_t serial);
|
|
|
|
/**
|
|
* Request current data registration state
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getDataRegistrationStateResponse()
|
|
*/
|
|
oneway getDataRegistrationState(int32_t serial);
|
|
|
|
/**
|
|
* Request current operator ONS or EONS
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getOperatorResponse()
|
|
*/
|
|
oneway getOperator(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param on To turn on radio -> on = true, to turn off radio -> on = false.
|
|
*
|
|
* Response function is IRadioResponse.setRadioPowerResponse()
|
|
*/
|
|
oneway setRadioPower(int32_t serial, bool on);
|
|
|
|
/**
|
|
* 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
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param s string with single char having one of 12 values: 0-9, *, #
|
|
*
|
|
* Response function is IRadioResponse.sendDtmfResponse()
|
|
*/
|
|
oneway sendDtmf(int32_t serial, string s);
|
|
|
|
/**
|
|
* Send an SMS message
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param message GsmSmsMessage as defined in types.hal
|
|
*
|
|
* 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)
|
|
*/
|
|
oneway sendSms(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)
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param message GsmSmsMessage as defined in types.hal
|
|
*
|
|
* 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)
|
|
*/
|
|
oneway sendSMSExpectMore(int32_t serial, GsmSmsMessage message);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param radioTechnology Radio technology to use.
|
|
* @param dataProfileInfo data profile info.
|
|
* @param modemCognitive Indicating this profile was sent to the modem through setDataProfile
|
|
* earlier.
|
|
* @param roamingAllowed Indicating data roaming is allowed or not by the user.
|
|
* @param 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.
|
|
*
|
|
* Response function is IRadioResponse.setupDataCallResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.2::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.2 or higher, use @1.2::IRadio.setupDataCall_1_2() instead.
|
|
*/
|
|
oneway setupDataCall(int32_t serial, RadioTechnology radioTechnology,
|
|
DataProfileInfo dataProfileInfo, bool modemCognitive, bool roamingAllowed,
|
|
bool isRoaming);
|
|
|
|
/**
|
|
* 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
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param iccIo IccIo
|
|
*
|
|
* 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()
|
|
*/
|
|
oneway iccIOForApp(int32_t serial, IccIo iccIo);
|
|
|
|
/**
|
|
* 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)
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param ussd string containing the USSD request in UTF-8 format
|
|
*
|
|
* Response function is IRadioResponse.sendUssdResponse()
|
|
*
|
|
* See also requestCancelUssd, unsolOnUssd
|
|
*/
|
|
oneway sendUssd(int32_t serial, string ussd);
|
|
|
|
/**
|
|
* Cancel the current USSD session if one exists.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.cancelPendingUssdResponse()
|
|
*/
|
|
oneway cancelPendingUssd(int32_t serial);
|
|
|
|
/**
|
|
* Gets current CLIR status
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getClirResponse()
|
|
*/
|
|
oneway getClir(int32_t serial);
|
|
|
|
/**
|
|
* Set current CLIR status
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param status "n" parameter from TS 27.007 7.7
|
|
*
|
|
* Response function is IRadioResponse.setClirResponse()
|
|
*/
|
|
oneway setClir(int32_t serial, int32_t status);
|
|
|
|
/**
|
|
* Request call forward status.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param callInfo CallForwardInfo
|
|
*
|
|
* Response function is IRadioResponse.getCallForwardStatusResponse()
|
|
*/
|
|
oneway getCallForwardStatus(int32_t serial,
|
|
CallForwardInfo callInfo);
|
|
|
|
/**
|
|
* Configure call forward rule
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param callInfo CallForwardInfo
|
|
*
|
|
* Response function is IRadioResponse.setCallForwardResponse()
|
|
*/
|
|
oneway setCallForward(int32_t serial, CallForwardInfo callInfo);
|
|
|
|
/**
|
|
* Query current call waiting state
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param serviceClass Service class is the TS 27.007 service class to query
|
|
*
|
|
* Response function is IRadioResponse.getCallWaitingResponse()
|
|
*/
|
|
oneway getCallWaiting(int32_t serial, int32_t serviceClass);
|
|
|
|
/**
|
|
* Configure current call waiting state
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param enable is false for "disabled" and true for "enabled"
|
|
* @param serviceClass is the TS 27.007 service class bit vector of services to modify
|
|
*
|
|
* Response function is IRadioResponse.setCallWaitingResponse()
|
|
*/
|
|
oneway setCallWaiting(int32_t serial, bool enable,
|
|
int32_t serviceClass);
|
|
|
|
/**
|
|
* Acknowledge successful or failed receipt of SMS previously indicated
|
|
* via unsolResponseNewSms
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param 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)
|
|
* @param cause: if success is false, this contains the failure cause as defined
|
|
* in TS 23.040, 9.2.3.22.
|
|
*
|
|
* Response function is IRadioResponse.acknowledgeLastIncomingGsmSmsResponse()
|
|
*/
|
|
oneway acknowledgeLastIncomingGsmSms(int32_t serial, bool success,
|
|
SmsAcknowledgeFailCause cause);
|
|
|
|
/**
|
|
* Answer incoming call
|
|
* Must not be called for WAITING calls.
|
|
* switchWaitingOrHoldingAndActive() must be used in this case
|
|
* instead
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.acceptCallResponse()
|
|
*/
|
|
oneway acceptCall(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param cid Indicates CID
|
|
* @param reasonRadioShutDown Indicates Disconnect Reason
|
|
* false => No specific reason specified
|
|
* true => Radio shutdown requested
|
|
*
|
|
* Response function is IRadioResponse.deactivateDataCallResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.2::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.2 or higher, use @1.2::IRadio.deactivateDataCall_1_2() instead.
|
|
*/
|
|
oneway deactivateDataCall(int32_t serial, int32_t cid,
|
|
bool reasonRadioShutDown);
|
|
|
|
/**
|
|
* Query the status of a facility lock state
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param facility is the facility string code from TS 27.007 7.4
|
|
* (eg "AO" for BAOC, "SC" for SIM lock)
|
|
* @param password is the password, or "" if not required
|
|
* @param serviceClass is the TS 27.007 service class bit vector of services to query
|
|
* @param 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.
|
|
*
|
|
* Response function is IRadioResponse.getFacilityLockForAppResponse()
|
|
*/
|
|
oneway getFacilityLockForApp(int32_t serial, string facility,
|
|
string password, int32_t serviceClass, string appId);
|
|
|
|
/**
|
|
* Enable/disable one facility lock
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param facility is the facility string code from TS 27.007 7.4 (eg "AO" for BAOC)
|
|
* @param lockState false for "unlock" and true for "lock"
|
|
* @param password is the password
|
|
* @param serviceClass is string representation of decimal TS 27.007
|
|
* service class bit vector. Eg, the string
|
|
* "1" means "set this facility for voice services"
|
|
* @param 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.
|
|
*
|
|
* Response function is IRadioResponse.setFacilityLockForAppResponse()
|
|
*/
|
|
oneway setFacilityLockForApp(int32_t serial, string facility, bool lockState,
|
|
string password, int32_t serviceClass, string appId);
|
|
|
|
/**
|
|
* Change call barring facility password
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param facility facility string code from TS 27.007 7.4 (eg "AO" for BAOC)
|
|
* @param oldPassword old password
|
|
* @param newPassword new password
|
|
*
|
|
* Response function is IRadioResponse.setBarringPasswordResponse()
|
|
*/
|
|
oneway setBarringPassword(int32_t serial, string facility,
|
|
string oldPassword, string newPassword);
|
|
|
|
/**
|
|
* Query current network selection mode
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getNetworkSelectionModeResponse()
|
|
*/
|
|
oneway getNetworkSelectionMode(int32_t serial);
|
|
|
|
/**
|
|
* Specify that the network must be selected automatically.
|
|
* This request must not respond until the new operator is selected and registered.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.setNetworkSelectionModeAutomaticResponse()
|
|
*/
|
|
oneway setNetworkSelectionModeAutomatic(int32_t serial);
|
|
|
|
/**
|
|
* Manually select a specified network.
|
|
* This request must not respond until the new operator is selected and registered.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param operatorNumeric string specifying MCCMNC of network to select (eg "310170")
|
|
*
|
|
* Response function is IRadioResponse.setNetworkSelectionModeManualResponse()
|
|
*/
|
|
oneway setNetworkSelectionModeManual(int32_t serial, string operatorNumeric);
|
|
|
|
/**
|
|
* Scans for available networks
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getAvailableNetworksResponse()
|
|
*/
|
|
oneway getAvailableNetworks(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param s string having a single character with one of 12 values: 0-9,*,#
|
|
*
|
|
* Response function is IRadioResponse.startDtmfResponse()
|
|
*/
|
|
oneway startDtmf(int32_t serial, string s);
|
|
|
|
/**
|
|
* Stop playing a currently playing DTMF tone.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.stopDtmfResponse()
|
|
*/
|
|
oneway stopDtmf(int32_t serial);
|
|
|
|
/**
|
|
* Return string value indicating baseband version, eg response from AT+CGMR
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getBasebandVersionResponse()
|
|
*/
|
|
oneway getBasebandVersion(int32_t serial);
|
|
|
|
/**
|
|
* 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"
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param gsmIndex contains Connection index (value of 'x' in CHLD above)
|
|
*
|
|
* Response function is IRadioResponse.separateConnectionResponse()
|
|
*/
|
|
oneway separateConnection(int32_t serial, int32_t gsmIndex);
|
|
|
|
/**
|
|
* 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
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param enable true for "enable mute" and false for "disable mute"
|
|
*
|
|
* Response function is IRadioResponse.setMuteResponse()
|
|
*/
|
|
oneway setMute(int32_t serial, bool enable);
|
|
|
|
/**
|
|
* Queries the current state of the uplink mute setting
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getMuteResponse()
|
|
*/
|
|
oneway getMute(int32_t serial);
|
|
|
|
/**
|
|
* Queries the status of the CLIP supplementary service
|
|
* (for MMI code "*#30#")
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getClipResponse()
|
|
*/
|
|
oneway getClip(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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getDataCallListResponse()
|
|
*/
|
|
oneway getDataCallList(int32_t serial);
|
|
|
|
/**
|
|
* Enables/disables supplementary service related notifications from the network.
|
|
* Notifications are reported via unsolSuppSvcNotification().
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param enable true = notifications enabled, false = notifications disabled.
|
|
*
|
|
* Response function is IRadioResponse.setSuppServiceNotificationsResponse()
|
|
*/
|
|
oneway setSuppServiceNotifications(int32_t serial, bool enable);
|
|
|
|
/**
|
|
* Stores a SMS message to SIM memory.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param smsWriteArgs SmsWriteArgs defined in types.hal
|
|
*
|
|
* Response function is IRadioResponse.writeSmsToSimResponse()
|
|
*/
|
|
oneway writeSmsToSim(int32_t serial, SmsWriteArgs smsWriteArgs);
|
|
|
|
/**
|
|
* Deletes a SMS message from SIM memory.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param index Record index of the message to delete.
|
|
*
|
|
* Response function is IRadioResponse.deleteSmsOnSimResponse()
|
|
*/
|
|
oneway deleteSmsOnSim(int32_t serial, int32_t index);
|
|
|
|
/**
|
|
* Assign a specified band for RF configuration.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param mode RadioBandMode defined in types.hal
|
|
*
|
|
* Response function is IRadioResponse.setBandModeResponse()
|
|
*/
|
|
oneway setBandMode(int32_t serial, RadioBandMode mode);
|
|
|
|
/**
|
|
* Get the list of band modes supported by RF.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response function is IRadioResponse.getAvailableBandModesResponse()
|
|
*/
|
|
oneway getAvailableBandModes(int32_t serial);
|
|
|
|
/**
|
|
* 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
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param command SAT/USAT command in hexadecimal format string starting with command tag
|
|
*
|
|
* Response function is IRadioResponse.sendEnvelopeResponse()
|
|
*/
|
|
oneway sendEnvelope(int32_t serial, string command);
|
|
|
|
/**
|
|
* Requests to send a terminal response to SIM for a received proactive command
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param commandResponse SAT/USAT response in hexadecimal format string starting with
|
|
* first byte of response data
|
|
*
|
|
* Response function is IRadioResponse.sendTerminalResponseResponseToSim()
|
|
*/
|
|
oneway sendTerminalResponseToSim(int32_t serial, string commandResponse);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param accept true = accept the call setup, false = reject the call setup
|
|
*
|
|
* Response callback is IRadioResponse.handleStkCallSetupRequestFromSimResponse()
|
|
*/
|
|
oneway handleStkCallSetupRequestFromSim(int32_t serial,
|
|
bool accept);
|
|
|
|
/**
|
|
* Connects the two calls and disconnects the subscriber from both calls.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.explicitCallTransferResponse()
|
|
*/
|
|
oneway explicitCallTransfer(int32_t serial);
|
|
|
|
/**
|
|
* Requests to set the preferred network type for searching and registering
|
|
* (CS/PS domain, RAT, and operation mode)
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param nwType PreferredNetworkType defined in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.setPreferredNetworkTypeResponse()
|
|
*/
|
|
oneway setPreferredNetworkType(int32_t serial,
|
|
PreferredNetworkType nwType);
|
|
|
|
/**
|
|
* Query the preferred network type (CS/PS domain, RAT, and operation mode)
|
|
* for searching and registering
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getPreferredNetworkTypeResponse()
|
|
*/
|
|
oneway getPreferredNetworkType(int32_t serial);
|
|
|
|
/**
|
|
* Request neighboring cell id in GSM network
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getNeighboringCidsResponse()
|
|
*/
|
|
oneway getNeighboringCids(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param enable true = updates enabled (+CREG=2), false = updates disabled (+CREG=1)
|
|
*
|
|
* Response callback is IRadioResponse.setLocationUpdatesResponse()
|
|
*/
|
|
oneway setLocationUpdates(int32_t serial, bool enable);
|
|
|
|
/**
|
|
* Request to set the location where the CDMA subscription shall
|
|
* be retrieved
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param cdmaSub CdmaSubscriptionSource
|
|
*
|
|
* Response callback is IRadioResponse.setCdmaSubscriptionSourceResponse()
|
|
*/
|
|
oneway setCdmaSubscriptionSource(int32_t serial,
|
|
CdmaSubscriptionSource cdmaSub);
|
|
|
|
/**
|
|
* Request to set the roaming preferences in CDMA
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param type CdmaRoamingType defined in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.setCdmaRoamingPreferenceResponse()
|
|
*/
|
|
oneway setCdmaRoamingPreference(int32_t serial,
|
|
CdmaRoamingType type);
|
|
|
|
/**
|
|
* Request the actual setting of the roaming preferences in CDMA in the modem
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getCdmaRoamingPreferenceResponse()
|
|
*/
|
|
oneway getCdmaRoamingPreference(int32_t serial);
|
|
|
|
/**
|
|
* Request to set the TTY mode
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param mode TtyMode
|
|
*
|
|
* Response callback is IRadioResponse.setTTYModeResponse()
|
|
*/
|
|
oneway setTTYMode(int32_t serial, TtyMode mode);
|
|
|
|
/**
|
|
* Request the setting of TTY mode
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getTTYModeResponse()
|
|
*/
|
|
oneway getTTYMode(int32_t serial);
|
|
|
|
/**
|
|
* Request to set the preferred voice privacy mode used in voice scrambling.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param enable false for Standard Privacy Mode (Public Long Code Mask)
|
|
* true for Enhanced Privacy Mode (Private Long Code Mask)
|
|
*
|
|
* Response callback is IRadioResponse.setPreferredVoicePrivacyResponse()
|
|
*/
|
|
oneway setPreferredVoicePrivacy(int32_t serial, bool enable);
|
|
|
|
/**
|
|
* Request the setting of preferred voice privacy mode.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getPreferredVoicePrivacyResponse()
|
|
*/
|
|
oneway getPreferredVoicePrivacy(int32_t serial);
|
|
|
|
/**
|
|
* Send FLASH command
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param featureCode String associated with Flash command
|
|
*
|
|
* Response callback is IRadioResponse.sendCDMAFeatureCodeResponse()
|
|
*/
|
|
oneway sendCDMAFeatureCode(int32_t serial, string featureCode);
|
|
|
|
/**
|
|
* Send DTMF string
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param dtmf DTMF string
|
|
* @param on DTMF ON length in milliseconds, or 0 to use default
|
|
* @param off is the DTMF OFF length in milliseconds, or 0 to use default
|
|
*
|
|
* Response callback is IRadioResponse.sendBurstDtmfResponse()
|
|
*/
|
|
oneway sendBurstDtmf(int32_t serial, string dtmf, int32_t on, int32_t off);
|
|
|
|
/**
|
|
* Send a CDMA SMS message
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param sms Cdma Sms to be sent described by CdmaSmsMessage in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.sendCdmaSmsResponse()
|
|
*/
|
|
oneway sendCdmaSms(int32_t serial, CdmaSmsMessage sms);
|
|
|
|
/**
|
|
* Acknowledge the success or failure in the receipt of SMS
|
|
* previously indicated via responseCdmaNewSms()
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param smsAck Cdma Sms ack to be sent described by CdmaSmsAck in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.acknowledgeLastIncomingCdmaSmsResponse()
|
|
*/
|
|
oneway acknowledgeLastIncomingCdmaSms(int32_t serial, CdmaSmsAck smsAck);
|
|
|
|
/**
|
|
* Request the setting of GSM/WCDMA Cell Broadcast SMS config.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getGsmBroadcastConfigResponse()
|
|
*/
|
|
oneway getGsmBroadcastConfig(int32_t serial);
|
|
|
|
/**
|
|
* Set GSM/WCDMA Cell Broadcast SMS config
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param configInfo Setting of GSM/WCDMA Cell broadcast config
|
|
*
|
|
* Response callback is IRadioResponse.setGsmBroadcastConfigResponse()
|
|
*/
|
|
oneway setGsmBroadcastConfig(int32_t serial, vec<GsmBroadcastSmsConfigInfo> configInfo);
|
|
|
|
/**
|
|
* Enable or disable the reception of GSM/WCDMA Cell Broadcast SMS
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param activate indicates to activate or turn off the reception of GSM/WCDMA
|
|
* Cell Broadcast SMS. true = activate, false = turn off
|
|
*
|
|
* Response callback is IRadioResponse.setGsmBroadcastActivationResponse()
|
|
*/
|
|
oneway setGsmBroadcastActivation(int32_t serial, bool activate);
|
|
|
|
/**
|
|
* Request the setting of CDMA Broadcast SMS config
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getCdmaBroadcastConfigResponse()
|
|
*/
|
|
oneway getCdmaBroadcastConfig(int32_t serial);
|
|
|
|
/**
|
|
* Set CDMA Broadcast SMS config
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param configInfo CDMA Broadcast SMS config to be set.
|
|
*
|
|
* Response callback is IRadioResponse.setCdmaBroadcastConfigResponse()
|
|
*/
|
|
oneway setCdmaBroadcastConfig(int32_t serial, vec<CdmaBroadcastSmsConfigInfo> configInfo);
|
|
|
|
/**
|
|
* Enable or disable the reception of CDMA Cell Broadcast SMS
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param activate indicates to activate or turn off the reception of CDMA
|
|
* Cell Broadcast SMS. true = activate, false = turn off
|
|
*
|
|
* Response callback is IRadioResponse.setCdmaBroadcastActivationResponse()
|
|
*/
|
|
oneway setCdmaBroadcastActivation(int32_t serial, bool activate);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getCDMASubscriptionResponse()
|
|
*/
|
|
oneway getCDMASubscription(int32_t serial);
|
|
|
|
/**
|
|
* Stores a CDMA SMS message to RUIM memory.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param cdmaSms CDMA message as defined by CdmaSmsWriteArgs in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.writeSmsToRuimResponse()
|
|
*/
|
|
oneway writeSmsToRuim(int32_t serial, CdmaSmsWriteArgs cdmaSms);
|
|
|
|
/**
|
|
* Deletes a CDMA SMS message from RUIM memory.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param index record index of the message to delete
|
|
*
|
|
* Response callback is IRadioResponse.deleteSmsOnRuimResponse()
|
|
*/
|
|
oneway deleteSmsOnRuim(int32_t serial, int32_t index);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getDeviceIdentityResponse()
|
|
*/
|
|
oneway getDeviceIdentity(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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.exitEmergencyCallbackModeResponse()
|
|
*/
|
|
oneway exitEmergencyCallbackMode(int32_t serial);
|
|
|
|
/**
|
|
* Get the default Short Message Service Center address on the device.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getSmscAddressResponse()
|
|
*/
|
|
oneway getSmscAddress(int32_t serial);
|
|
|
|
/**
|
|
* Set the default Short Message Service Center address on the device.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param smsc Short Message Service Center address to set
|
|
*
|
|
* Response callback is IRadioResponse.setSmscAddressResponse()
|
|
*/
|
|
oneway setSmscAddress(int32_t serial, string smsc);
|
|
|
|
/**
|
|
* Indicates whether there is storage available for new SMS messages.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param available true if memory is available for storing new messages,
|
|
* false if memory capacity is exceeded
|
|
*
|
|
* Response callback is IRadioResponse.reportSmsMemoryStatusResponse()
|
|
*/
|
|
oneway reportSmsMemoryStatus(int32_t serial, bool available);
|
|
|
|
/**
|
|
* Indicates that the StkService is running and is
|
|
* ready to receive unsolicited stkXXXXX commands.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.reportStkServiceIsRunningResponse()
|
|
*/
|
|
oneway reportStkServiceIsRunning(int32_t serial);
|
|
|
|
/**
|
|
* Request to query the location where the CDMA subscription shall be retrieved.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getCdmaSubscriptionSourceResponse()
|
|
*/
|
|
oneway getCdmaSubscriptionSource(int32_t serial);
|
|
|
|
/**
|
|
* Request the ISIM application on the UICC to perform AKA
|
|
* challenge/response algorithm for IMS authentication
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param challenge challenge string in Base64 format
|
|
*
|
|
* Response callback is IRadioResponse.requestIsimAuthenticationResponse()
|
|
*/
|
|
oneway requestIsimAuthentication(int32_t serial, string challenge);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param success true on successful receipt (send RP-ACK)
|
|
* false on failed receipt (send RP-ERROR)
|
|
* @param ackPdu acknowledgement TPDU in hexadecimal format
|
|
*
|
|
* Response callback is IRadioResponse.acknowledgeIncomingGsmSmsWithPduResponse()
|
|
*/
|
|
oneway acknowledgeIncomingGsmSmsWithPdu(int32_t serial, bool success, string ackPdu);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param contents SAT/USAT command in hexadecimal format starting with command tag
|
|
*
|
|
* Response callback is IRadioResponse.sendEnvelopeWithStatusResponse()
|
|
*/
|
|
oneway sendEnvelopeWithStatus(int32_t serial, string contents);
|
|
|
|
/**
|
|
* Query the radio technology type (3GPP/3GPP2) used for voice. Query is valid only
|
|
* when radio state is not RADIO_STATE_UNAVAILABLE
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getVoiceRadioTechnologyResponse()
|
|
*/
|
|
oneway getVoiceRadioTechnology(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().
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getCellInfoListResponse()
|
|
*/
|
|
oneway getCellInfoList(int32_t serial);
|
|
|
|
/**
|
|
* 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().
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param rate minimum time in milliseconds to indicate time between unsolicited cellInfoList()
|
|
*
|
|
* Response callback is IRadioResponse.setCellInfoListRateResponse()
|
|
*/
|
|
oneway setCellInfoListRate(int32_t serial, int32_t rate);
|
|
|
|
/**
|
|
* Set an apn to initial attach network
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param dataProfileInfo data profile containing APN settings
|
|
* @param modemCognitive indicating the data profile was sent to the modem through
|
|
* setDataProfile earlier.
|
|
* @param 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.
|
|
*
|
|
* Response callback is IRadioResponse.setInitialAttachApnResponse()
|
|
*/
|
|
oneway setInitialAttachApn(int32_t serial, DataProfileInfo dataProfileInfo,
|
|
bool modemCognitive, bool isRoaming);
|
|
|
|
/**
|
|
* Request current IMS registration state
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getImsRegistrationStateResponse()
|
|
*/
|
|
oneway getImsRegistrationState(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param message ImsSmsMessage as defined in types.hal to be sent
|
|
*
|
|
* Response callback is IRadioResponse.sendImsSmsResponse()
|
|
*/
|
|
oneway sendImsSms(int32_t serial, ImsSmsMessage 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param message SimApdu as defined in types.hal to be sent
|
|
*
|
|
* Response callback is IRadioResponse.iccTransmitApduBasicChannelResponse()
|
|
*/
|
|
oneway iccTransmitApduBasicChannel(int32_t serial, SimApdu message);
|
|
|
|
/**
|
|
* Open a new logical channel and select the given application. This command
|
|
* reflects TS 27.007 "open logical channel" operation (+CCHO).
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param aid AID value, See ETSI 102.221 and 101.220.
|
|
* @param p2 P2 value, described in ISO 7816-4. Ignore if equal to P2Constant:NO_P2
|
|
*
|
|
* Response callback is IRadioResponse.iccOpenLogicalChannelResponse()
|
|
*/
|
|
oneway iccOpenLogicalChannel(int32_t serial, string aid, int32_t p2);
|
|
|
|
/**
|
|
* Close a previously opened logical channel. This command reflects TS 27.007
|
|
* "close logical channel" operation (+CCHC).
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param channelId session id of the logical channel (+CCHC).
|
|
*
|
|
* Response callback is IRadioResponse.iccCloseLogicalChannelResponse()
|
|
*/
|
|
oneway iccCloseLogicalChannel(int32_t serial, int32_t channelId);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param message SimApdu as defined in types.hal to be sent
|
|
*
|
|
* Response callback is IRadioResponse.iccTransmitApduLogicalChannelResponse()
|
|
*/
|
|
oneway iccTransmitApduLogicalChannel(int32_t serial, SimApdu message);
|
|
|
|
/**
|
|
* Read one of the radio NV items.
|
|
* This is used for device configuration by some CDMA operators.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param itemId NvItem is radio NV item as defined in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.nvReadItemResponse()
|
|
*/
|
|
oneway nvReadItem(int32_t serial, NvItem itemId);
|
|
|
|
/**
|
|
* Write one of the radio NV items.
|
|
* This is used for device configuration by some CDMA operators.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param item NvWriteItem as defined in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.nvWriteItemResponse()
|
|
*/
|
|
oneway nvWriteItem(int32_t serial, NvWriteItem item);
|
|
|
|
/**
|
|
* Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
|
|
* This is used for device configuration by some CDMA operators.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param prl PRL as a byte array
|
|
*
|
|
* Response callback is IRadioResponse.nvWriteCdmaPrlResponse()
|
|
*/
|
|
oneway nvWriteCdmaPrl(int32_t serial, vec<uint8_t> prl);
|
|
|
|
/**
|
|
* Reset the radio NV configuration to the factory state.
|
|
* This is used for device configuration by some CDMA operators.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param resetType ResetNvType as defined in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.nvResetConfigResponse()
|
|
*/
|
|
oneway nvResetConfig(int32_t serial, ResetNvType resetType);
|
|
|
|
/**
|
|
* Selection/de-selection of a subscription from a SIM card
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param uiccSub SelectUiccSub as defined in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.setUiccSubscriptionResponse()
|
|
*/
|
|
oneway setUiccSubscription(int32_t serial, SelectUiccSub uiccSub);
|
|
|
|
/**
|
|
* Tells the modem whether data calls are allowed or not
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param allow true to allow data calls, false to disallow data calls
|
|
*
|
|
* Response callback is IRadioResponse.setDataAllowedResponse()
|
|
*/
|
|
oneway setDataAllowed(int32_t serial, bool allow);
|
|
|
|
/**
|
|
* Request all of the current hardware (modem and sim) associated with Radio.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getHardwareConfigResponse()
|
|
*/
|
|
oneway getHardwareConfig(int32_t serial);
|
|
|
|
/**
|
|
* Returns the response of SIM Authentication through Radio challenge request.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param authContext P2 value of authentication command, see P2 parameter in
|
|
* 3GPP TS 31.102 7.1.2
|
|
* @param authData the challenge string in Base64 format, see 3GPP TS 31.102 7.1.2
|
|
* @param aid AID value, See ETSI 102.221 8.1 and 101.220 4, empty string if no value
|
|
*
|
|
* Response callback is IRadioResponse.requestIccSimAuthenticationResponse()
|
|
*/
|
|
oneway requestIccSimAuthentication(int32_t serial, int32_t authContext, string authData,
|
|
string aid);
|
|
|
|
/**
|
|
* Set data profile in modem.
|
|
* Modem must erase existed profiles from framework, and apply new profiles
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param profiles Array of DataProfiles to set.
|
|
* @param 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.
|
|
*
|
|
* Response callback is IRadioResponse.setDataProfileResponse()
|
|
*/
|
|
oneway setDataProfile(int32_t serial, vec<DataProfileInfo> profiles, bool isRoaming);
|
|
|
|
/**
|
|
* Device is shutting down. All further commands are ignored
|
|
* and RADIO_NOT_AVAILABLE must be returned.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.requestShutdownResponse()
|
|
*/
|
|
oneway requestShutdown(int32_t serial);
|
|
|
|
/**
|
|
* Used to get phone radio capability.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getRadioCapabilityResponse()
|
|
*/
|
|
oneway getRadioCapability(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param rc RadioCapability structure to be set
|
|
*
|
|
* Response callback is IRadioResponse.setRadioCapabilityResponse()
|
|
*/
|
|
oneway setRadioCapability(int32_t serial, RadioCapability rc);
|
|
|
|
/**
|
|
* Start Link Capacity Estimate (LCE) service if supported by the radio.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param reportInterval desired reporting interval (ms).
|
|
* @param pullMode LCE service mode. true: PULL; false: PUSH.
|
|
*
|
|
* Response callback is IRadioResponse.startLceServiceResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.2::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.2 or higher which use the always-on LCE that relies on indications.
|
|
*/
|
|
oneway startLceService(int32_t serial, int32_t reportInterval, bool pullMode);
|
|
|
|
/**
|
|
* Stop Link Capacity Estimate (LCE) service, the STOP operation must be
|
|
* idempotent for the radio modem.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.stopLceServiceResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.2::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.2 or higher which use the always-on LCE that relies on indications.
|
|
*/
|
|
oneway stopLceService(int32_t serial);
|
|
|
|
/**
|
|
* Pull LCE service for capacity information.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.pullLceDataResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.2::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.2 or higher which use the always-on LCE that relies on indications.
|
|
*/
|
|
oneway pullLceData(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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getModemActivityInfoResponse()
|
|
*/
|
|
oneway getModemActivityInfo(int32_t serial);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param allAllowed true only when all carriers are allowed. Ignore "carriers" struct.
|
|
* If false, consider "carriers" struct
|
|
* @param carriers CarrierRestrictions consisting allowed and excluded carriers as defined
|
|
* in types.hal
|
|
*
|
|
* Response callback is IRadioResponse.setAllowedCarriersResponse()
|
|
*/
|
|
oneway setAllowedCarriers(int32_t serial, bool allAllowed, CarrierRestrictions carriers);
|
|
|
|
/**
|
|
* Get carrier restrictions.
|
|
*
|
|
* @param serial Serial number of request.
|
|
*
|
|
* Response callback is IRadioResponse.getAllowedCarriersResponse()
|
|
*/
|
|
oneway getAllowedCarriers(int32_t serial);
|
|
|
|
/**
|
|
* Send the updated device state.
|
|
* This is providing the device state information for the modem to perform power saving
|
|
* strategies.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param deviceStateType The updated device state type.
|
|
* @param state The updated state. See the definition of state at DeviceStateType.
|
|
*
|
|
* Response callback is IRadioResponse.sendDeviceStateResponse()
|
|
*/
|
|
oneway sendDeviceState(int32_t serial, DeviceStateType deviceStateType, bool state);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request.
|
|
* @param indicationFilter 32-bit bitmap of IndicationFilter. Bits set to 1 indicate the
|
|
* indications are enabled. See IndicationFilter for the definition of each bit.
|
|
*
|
|
* Response callback is IRadioResponse.setIndicationFilterResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.2::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.2 or higher, use @1.2::IRadio.setIndicationFilter_1_2() instead.
|
|
*/
|
|
oneway setIndicationFilter(int32_t serial, bitfield<IndicationFilter> indicationFilter);
|
|
|
|
/**
|
|
* 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.
|
|
*
|
|
* @param serial Serial number of request
|
|
* @param powerUp True if powering up the sim card
|
|
*
|
|
* Response callback is IRadioResponse.setSimCardPowerResponse() which may return
|
|
* RadioError:REQUEST_NOT_SUPPORTED if @1.1::IRadio or higher is supported.
|
|
*
|
|
* DEPRECATED in @1.1 or higher, use @1.1::IRadio.setSimCardPower_1_1() instead.
|
|
*/
|
|
oneway setSimCardPower(int32_t serial, bool powerUp);
|
|
|
|
/**
|
|
* 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().
|
|
*
|
|
*/
|
|
oneway responseAcknowledgement();
|
|
};
|