platform_hardware_interfaces/radio/1.0/IRadio.hal

/*
 * 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 two parameters:
 * slotId: which corresponds to sim slot id.
 * 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param radioResponse Object containing response functions
     * @param radioIndication Object containing radio indications
     */
    setResponseFunctions(int32_t slotId, IRadioResponse radioResponse,
            IRadioIndication radioIndication);

    /*
     * Requests status of the ICC card
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getIccCardStatusResponse()
     *
     */
    oneway getIccCardStatus(int32_t slotId, int32_t serial);

    /*
     * Supplies ICC PIN. Only called if CardStatus has AppState.PIN state
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string pin, string aid);

    /*
     * Supplies ICC PUK and new PIN.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string pin2, string aid);

    /*
     * Supplies ICC PUK2 and new PIN2.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string puk2, string pin2,
            string aid);

    /*
     * Supplies old ICC PIN and new PIN.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string oldPin, string newPin,
            string aid);

    /*
     * Supplies old ICC PIN2 and new PIN2.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string oldPin2, string newPin2,
            string aid);

    /*
     * Requests that network personalization be deactivated
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param netPin Network depersonlization code
     *
     * Response function is IRadioResponse.supplyNetworkDepersonalizationResponse()
     *
     */
    oneway supplyNetworkDepersonalization(int32_t slotId, int32_t serial, string netPin);

    /*
     * Requests current call list
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getCurrentCallsResponse()
     *
     */
    oneway getCurrentCalls(int32_t slotId, int32_t serial);

    /*
     * Initiate voice call.
     * This method is never used for supplementary service codes
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param dialInfo Dial struct
     *
     * Response function is IRadioResponse.dialResponse()
     *
     */
    oneway dial(int32_t slotId, int32_t serial, Dial dialInfo);

    /*
     * Get the SIM IMSI
     * Only valid when radio state is "RADIO_STATE_ON"
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.hangupWaitingOrBackgroundResponse()
     *
     */
    oneway hangupWaitingOrBackground(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.hangupForegroundResumeBackgroundResponse()
     *
     */
    oneway hangupForegroundResumeBackground(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.switchWaitingOrHoldingAndActiveResponse()
     *
     */
    oneway switchWaitingOrHoldingAndActive(int32_t slotId, int32_t serial);

    /*
     * Conference holding and active (like AT+CHLD=3)
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.conferenceResponse()
     *
     */
    oneway conference(int32_t slotId, int32_t serial);

    /*
     * Send UDUB (user determined user busy) to ringing or
     * waiting call answer)
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.rejectCallResponse()
     *
     */
    oneway rejectCall(int32_t slotId, int32_t serial);

    /*
     * Requests the failure cause code for the most recently terminated call.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getLastCallFailCauseResponse()
     *
     */
    oneway getLastCallFailCause(int32_t slotId, int32_t serial);

    /*
     * Requests current signal strength and associated information.
     * Must succeed if radio is on.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getSignalStrengthResponse()
     */
    oneway getSignalStrength(int32_t slotId, int32_t serial);

    /*
     * Request current voice registration state
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getVoiceRegistrationStateResponse()
     */
    oneway getVoiceRegistrationState(int32_t slotId, int32_t serial);

    /*
     * Request current data registration state
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getDataRegistrationStateResponse()
     */
    oneway getDataRegistrationState(int32_t slotId, int32_t serial);

    /*
     * Request current operator ONS or EONS
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getOperatorResponse()
     */
    oneway getOperator(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string s);

    /*
     * Send an SMS message
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param smscPDU is SMSC address in GSM BCD format prefixed by a length byte
     *        (as expected by TS 27.005) or empty string for default SMSC
     * @param pdu is SMS in PDU format as an ASCII hex string less the SMSC address
     *        TP-Layer-Length is be "strlen(pdu)/2"
     *
     * 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 slotId, int32_t serial, string smscPDU, string pdu);

    /*
     * 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param smscPDU is SMSC address in GSM BCD format prefixed by a length byte
     *        (as expected by TS 27.005) or empty string for default SMSC
     * @param pdu is SMS in PDU format as an ASCII hex string less the SMSC address
     *        TP-Layer-Length is be "strlen(pdu)/2"
     *
     * 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 slotId, int32_t serial, string smscPDU, string pdu);

    /*
     * 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 RIL 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param radioTechnology Radio technology to use: 0-CDMA, 1-GSM/UMTS, 2...
     *        for values above 2 this is RadioTechnology + 2.
     * @param profile is a RadioDataProfile (support is optional)
     * @param apn is the APN to connect to if radio technology is GSM/UMTS. This APN must
     *        override the one in the profile. empty string indicates no APN overrride.
     * @param user is the username for APN, or empty string
     * @param password is the password for APN, or empty string
     * @param authType is the PAP / CHAP auth type. Values:
     *        0 => PAP and CHAP is never performed.
     *        1 => PAP may be performed; CHAP is never performed.
     *        2 => CHAP may be performed; PAP is never performed.
     *        3 => PAP / CHAP may be performed - baseband dependent.
     * @param protocol is the connection type to request must be one of the
     *        PDP_type values in TS 27.007 section 10.1.1.
     *        For example, "IP", "IPV6", "IPV4V6", or "PPP".
     *
     * Response function is IRadioResponse.setupDataCallResponse()
     */
    oneway setupDataCall(int32_t slotId, int32_t serial, int32_t radioTechnology,
            int32_t profile, string apn, string user, string password, int32_t authType,
            string protocol);

    /*
     * 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string ussd);

    /*
     * Cancel the current USSD session if one exists.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.cancelPendingUssdResponse()
     */
    oneway cancelPendingUssd(int32_t slotId, int32_t serial);

    /*
     * Gets current CLIR status
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getClirResponse()
     */
    oneway getClir(int32_t slotId, int32_t serial);

    /*
     * Set current CLIR status
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, int32_t status);

    /*
     * Request call forward status.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param callInfo CallForwardInfo
     *
     * Response function is IRadioResponse.getCallForwardStatusResponse()
     */
    oneway getCallForwardStatus(int32_t slotId, int32_t serial,
            CallForwardInfo callInfo);

    /*
     * Configure call forward rule
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param callInfo CallForwardInfo
     *
     * Response function is IRadioResponse.setCallForwardResponse()
     */
    oneway setCallForward(int32_t slotId, int32_t serial, CallForwardInfo callInfo);

    /*
     * Query current call waiting state
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, int32_t serviceClass);

    /*
     * Configure current call waiting state
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, bool enable,
            int32_t serviceClass);

    /*
     * Acknowledge successful or failed receipt of SMS previously indicated
     * via unsolResponseNewSms
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.acceptCallResponse()
     */
    oneway acceptCall(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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()
     */
    oneway deactivateDataCall(int32_t slotId, int32_t serial, int32_t cid,
            bool reasonRadioShutDown);

    /*
     * Query the status of a facility lock state
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string facility,
            string password, int32_t serviceClass, string appId);

    /*
     * Enable/disable one facility lock
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string facility, bool lockState,
            string password, int32_t serviceClass, string appId);

    /*
     * Change call barring facility password
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string facility,
            string oldPassword, string newPassword);

    /*
     * Query current network selection mode
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getNetworkSelectionModeResponse()
     */
    oneway getNetworkSelectionMode(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.setNetworkSelectionModeAutomaticResponse()
     */
    oneway setNetworkSelectionModeAutomatic(int32_t slotId, int32_t serial);

    /*
     * Manually select a specified network.
     * This request must not respond until the new operator is selected and registered.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string operatorNumeric);

    /*
     * Scans for available networks
     * This request must not respond until the new operator is selected and registered.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getAvailableNetworksResponse()
     */
    oneway getAvailableNetworks(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string s);

    /*
     * Stop playing a currently playing DTMF tone.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.stopDtmfResponse()
     */
    oneway stopDtmf(int32_t slotId, int32_t serial);

    /*
     * Return string value indicating baseband version, eg response from AT+CGMR
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getBasebandVersionResponse()
     */
    oneway getBasebandVersion(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, bool enable);

    /*
     * Queries the current state of the uplink mute setting
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getMuteResponse()
     */
    oneway getMute(int32_t slotId, int32_t serial);

    /*
     * Queries the status of the CLIP supplementary service
     * (for MMI code "*#30#")
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getClipResponse()
     */
    oneway getClip(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getDataCallListResponse()
     */
    oneway getDataCallList(int32_t slotId, int32_t serial);

    /*
     * This request is reserved for OEM-specific uses. It passes raw byte arrays back and forth.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param data data passed as raw bytes to oem
     *
     * Response function is IRadioResponse.sendOemRilRequestRawResponse()
     */
    oneway sendOemRilRequestRaw(int32_t slotId, int32_t serial, vec<uint8_t> data);

    /*
     * This request is reserved for OEM-specific uses. It passes strings back and forth.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param data data passed as strings to oem
     *
     * Response function is IRadioResponse.sendOemRilRequestStringsResponse()
     */
    oneway sendOemRilRequestStrings(int32_t slotId, int32_t serial, vec<string> data);

    /*
     * Indicates the current state of the screen. When the screen is off, the
     * Radio must notify the baseband to suppress certain notifications (eg,
     * signal strength and changes in LAC/CID or BID/SID/NID/latitude/longitude)
     * in an effort to conserve power. These notifications must resume when the
     * screen is on.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param enable true = screen on, false = screen off.
     *
     * Response function is IRadioResponse.sendScreenStateResponse()
     */
    oneway sendScreenState(int32_t slotId, int32_t serial, bool enable);

    /*
     * Enables/disables supplementary service related notifications from the network.
     * Notifications are reported via unsolSuppSvcNotification().
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param enable true = notifications enabled, false = notifications disabled.
     *
     * Response function is IRadioResponse.setSuppServiceNotificationsResponse()
     */
    oneway setSuppServiceNotifications(int32_t slotId, int32_t serial, bool enable);

    /*
     * Stores a SMS message to SIM memory.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param smsWriteArgs SmsWriteArgs defined in types.hal
     *
     * Response function is IRadioResponse.writeSmsToSimResponse()
     */
    oneway writeSmsToSim(int32_t slotId, int32_t serial, SmsWriteArgs smsWriteArgs);

    /*
     * Deletes a SMS message from SIM memory.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param index Record index of the message to delete.
     *
     * Response function is IRadioResponse.deleteSmsOnSimResponse()
     */
    oneway deleteSmsOnSim(int32_t slotId, int32_t serial, int32_t index);

    /*
     * Assign a specified band for RF configuration.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     * @param mode RadioBandMode defined in types.hal
     *
     * Response function is IRadioResponse.setBandModeResponse()
     */
    oneway setBandMode(int32_t slotId, int32_t serial, RadioBandMode mode);

    /*
     * Get the list of band modes supported by RF.
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @param serial Serial number of request.
     *
     * Response function is IRadioResponse.getAvailableBandModesResponse()
     */
    oneway getAvailableBandModes(int32_t slotId, 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 slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string command);

    /*
     * Requests to send a terminal response to SIM for a received proactive command
     *
     * @param slotId SIM slot id for which the function is called; needed for multi-sim
     * @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 slotId, int32_t serial, string commandResponse);
};