IRadio

Set response functions for radio requests & radio indications.

Requests status of the ICC card

Response function is IRadioResponse.getIccCardStatusResponse()

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

Response function is IRadioResponse.supplyIccPinForAppResponse()

Supplies ICC PUK and new PIN.

Response function is IRadioResponse.supplyIccPukForAppResponse()

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

Response function is IRadioResponse.supplyIccPin2ForAppResponse()

Supplies ICC PUK2 and new PIN2.

Response function is IRadioResponse.supplyIccPuk2ForAppResponse()

Supplies old ICC PIN and new PIN.

Response function is IRadioResponse.changeIccPinForAppResponse()

Supplies old ICC PIN2 and new PIN2.

Response function is IRadioResponse.changeIccPin2ForAppResponse()

Requests that network personalization be deactivated

Response function is IRadioResponse.supplyNetworkDepersonalizationResponse()

Requests current call list

Response function is IRadioResponse.getCurrentCallsResponse()

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

Response function is IRadioResponse.dialResponse()

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

Response function is IRadioResponse.getImsiForAppResponse()

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

Response function is IRadioResponse.hangupResponse()

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

Response function is IRadioResponse.hangupWaitingOrBackgroundResponse()

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

Response function is IRadioResponse.hangupForegroundResumeBackgroundResponse()

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

Call transitions must happen as shown below.

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

Response function is IRadioResponse.switchWaitingOrHoldingAndActiveResponse()

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

Response function is IRadioResponse.conferenceResponse()

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

Response function is IRadioResponse.rejectCallResponse()

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

Response function is IRadioResponse.getLastCallFailCauseResponse()

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

Response function is IRadioResponse.getSignalStrengthResponse()

Request current voice registration state

Response function is IRadioResponse.getVoiceRegistrationStateResponse()

Request current data registration state

Response function is IRadioResponse.getDataRegistrationStateResponse()

Request current operator ONS or EONS

Response function is IRadioResponse.getOperatorResponse()

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

Response function is IRadioResponse.setRadioPowerResponse()

Send a DTMF tone

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

Response function is IRadioResponse.sendDtmfResponse()

Send an SMS message

Response function is IRadioResponse.sendSmsResponse()

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

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

Response function is IRadioResponse.sendSMSExpectMoreResponse()

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

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

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

Response function is IRadioResponse.setupDataCallResponse()

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

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

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

Response function is IRadioResponse.iccIOForAppResponse()

Send a USSD message.

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

The network reply must be reported via unsolOnUssd

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

Response function is IRadioResponse.sendUssdResponse()

See also requestCancelUssd, unsolOnUssd

Cancel the current USSD session if one exists.

Response function is IRadioResponse.cancelPendingUssdResponse()

Gets current CLIR status

Response function is IRadioResponse.getClirResponse()

Set current CLIR status

Response function is IRadioResponse.setClirResponse()

Request call forward status.

Response function is IRadioResponse.getCallForwardStatusResponse()

Configure call forward rule

Response function is IRadioResponse.setCallForwardResponse()

Query current call waiting state

Response function is IRadioResponse.getCallWaitingResponse()

Configure current call waiting state

Response function is IRadioResponse.setCallWaitingResponse()

Acknowledge successful or failed receipt of SMS previously indicated via unsolResponseNewSms

Response function is IRadioResponse.acknowledgeLastIncomingGsmSmsResponse()

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

Response function is IRadioResponse.acceptCallResponse()

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

Response function is IRadioResponse.deactivateDataCallResponse()

Query the status of a facility lock state

Response function is IRadioResponse.getFacilityLockForAppResponse()

Enable/disable one facility lock

Response function is IRadioResponse.setFacilityLockForAppResponse()

Change call barring facility password

Response function is IRadioResponse.setBarringPasswordResponse()

Query current network selection mode

Response function is IRadioResponse.getNetworkSelectionModeResponse()

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

Response function is IRadioResponse.setNetworkSelectionModeAutomaticResponse()

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

Response function is IRadioResponse.setNetworkSelectionModeManualResponse()

Scans for available networks

Response function is IRadioResponse.getAvailableNetworksResponse()

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

Response function is IRadioResponse.startDtmfResponse()

Stop playing a currently playing DTMF tone.

Response function is IRadioResponse.stopDtmfResponse()

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

Response function is IRadioResponse.getBasebandVersionResponse()

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

Like AT+CHLD=2x

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

Response function is IRadioResponse.separateConnectionResponse()

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

Response function is IRadioResponse.setMuteResponse()

Queries the current state of the uplink mute setting

Response function is IRadioResponse.getMuteResponse()

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

Response function is IRadioResponse.getClipResponse()

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

Response function is IRadioResponse.getDataCallListResponse()

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

Response function is IRadioResponse.setSuppServiceNotificationsResponse()

Stores a SMS message to SIM memory.

Response function is IRadioResponse.writeSmsToSimResponse()

Deletes a SMS message from SIM memory.

Response function is IRadioResponse.deleteSmsOnSimResponse()

Assign a specified band for RF configuration.

Response function is IRadioResponse.setBandModeResponse()

Get the list of band modes supported by RF.

Response function is IRadioResponse.getAvailableBandModesResponse()

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

Response function is IRadioResponse.sendEnvelopeResponse()

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

Response function is IRadioResponse.sendTerminalResponseResponseToSim()

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

Response callback is IRadioResponse.handleStkCallSetupRequestFromSimResponse()

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

Response callback is IRadioResponse.explicitCallTransferResponse()

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

Response callback is IRadioResponse.setPreferredNetworkTypeResponse()

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

Response callback is IRadioResponse.getPreferredNetworkTypeResponse()

Request neighboring cell id in GSM network

Response callback is IRadioResponse.getNeighboringCidsResponse()

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

Response callback is IRadioResponse.setLocationUpdatesResponse()

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

Response callback is IRadioResponse.setCdmaSubscriptionSourceResponse()

Request to set the roaming preferences in CDMA

Response callback is IRadioResponse.setCdmaRoamingPreferenceResponse()

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

Response callback is IRadioResponse.getCdmaRoamingPreferenceResponse()

Request to set the TTY mode

Response callback is IRadioResponse.setTTYModeResponse()

Request the setting of TTY mode

Response callback is IRadioResponse.getTTYModeResponse()

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

Response callback is IRadioResponse.setPreferredVoicePrivacyResponse()

Request the setting of preferred voice privacy mode.

Response callback is IRadioResponse.getPreferredVoicePrivacyResponse()

Send FLASH command

Response callback is IRadioResponse.sendCDMAFeatureCodeResponse()

Send DTMF string

Response callback is IRadioResponse.sendBurstDtmfResponse()

Send a CDMA SMS message

Response callback is IRadioResponse.sendCdmaSmsResponse()

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

Response callback is IRadioResponse.acknowledgeLastIncomingCdmaSmsResponse()

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

Response callback is IRadioResponse.getGsmBroadcastConfigResponse()

Set GSM/WCDMA Cell Broadcast SMS config

Response callback is IRadioResponse.setGsmBroadcastConfigResponse()

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

Response callback is IRadioResponse.setGsmBroadcastActivationResponse()

Request the setting of CDMA Broadcast SMS config

Response callback is IRadioResponse.getCdmaBroadcastConfigResponse()

Set CDMA Broadcast SMS config

Response callback is IRadioResponse.setCdmaBroadcastConfigResponse()

Enable or disable the reception of CDMA Cell Broadcast SMS

Response callback is IRadioResponse.setCdmaBroadcastActivationResponse()

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

Response callback is IRadioResponse.getCDMASubscriptionResponse()

Stores a CDMA SMS message to RUIM memory.

Response callback is IRadioResponse.writeSmsToRuimResponse()

Deletes a CDMA SMS message from RUIM memory.

Response callback is IRadioResponse.deleteSmsOnRuimResponse()

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

Response callback is IRadioResponse.getDeviceIdentityResponse()

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

Response callback is IRadioResponse.exitEmergencyCallbackModeResponse()

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

Response callback is IRadioResponse.getSmscAddressResponse()

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

Response callback is IRadioResponse.setSmscAddressResponse()

Indicates whether there is storage available for new SMS messages.

Response callback is IRadioResponse.reportSmsMemoryStatusResponse()

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

Response callback is IRadioResponse.reportStkServiceIsRunningResponse()

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

Response callback is IRadioResponse.getCdmaSubscriptionSourceResponse()

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

Response callback is IRadioResponse.requestIsimAuthenticationResponse()

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

Response callback is IRadioResponse.acknowledgeIncomingGsmSmsWithPduResponse()

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

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

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

Response callback is IRadioResponse.sendEnvelopeWithStatusResponse()

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

Response callback is IRadioResponse.getVoiceRadioTechnologyResponse()

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

Response callback is IRadioResponse.getCellInfoListResponse()

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

Response callback is IRadioResponse.setCellInfoListRateResponse()

Set an apn to initial attach network

Response callback is IRadioResponse.setInitialAttachApnResponse()

Request current IMS registration state

Response callback is IRadioResponse.getImsRegistrationStateResponse()

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

Response callback is IRadioResponse.sendImsSmsResponse()

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

Response callback is IRadioResponse.iccTransmitApduBasicChannelResponse()

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

Response callback is IRadioResponse.iccOpenLogicalChannelResponse()

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

Response callback is IRadioResponse.iccCloseLogicalChannelResponse()

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

Response callback is IRadioResponse.iccTransmitApduLogicalChannelResponse()

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

Response callback is IRadioResponse.nvReadItemResponse()

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

Response callback is IRadioResponse.nvWriteItemResponse()

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

Response callback is IRadioResponse.nvWriteCdmaPrlResponse()

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

Response callback is IRadioResponse.nvResetConfigResponse()

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

Response callback is IRadioResponse.setUiccSubscriptionResponse()

Tells the modem whether data calls are allowed or not

Response callback is IRadioResponse.setDataAllowedResponse()

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

Response callback is IRadioResponse.getHardwareConfigResponse()

Returns the response of SIM Authentication through Radio challenge request.

Response callback is IRadioResponse.requestIccSimAuthenticationResponse()

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

Response callback is IRadioResponse.setDataProfileResponse()

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

Response callback is IRadioResponse.requestShutdownResponse()

Used to get phone radio capability.

Response callback is IRadioResponse.getRadioCapabilityResponse()

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

Response callback is IRadioResponse.setRadioCapabilityResponse()

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

Response callback is IRadioResponse.startLceServiceResponse()

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

Response callback is IRadioResponse.stopLceServiceResponse()

Pull LCE service for capacity information.

Response callback is IRadioResponse.pullLceDataResponse()

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

Response callback is IRadioResponse.getModemActivityInfoResponse()

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

Response callback is IRadioResponse.setAllowedCarriersResponse()

Get carrier restrictions.

Response callback is IRadioResponse.getAllowedCarriersResponse()

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

Response callback is IRadioResponse.sendDeviceStateResponse()

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

Response callback is IRadioResponse.setIndicationFilterResponse()

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

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

Response callback is IRadioResponse.setSimCardPowerResponse()

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().