Package: android.hardware.radio@1.1

IRadio

interface IRadio extends @1.0::IRadio

This interface is used by telephony and 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.setResponseFunctions must work with@1.1::IRadioResponse and@1.1::IRadioIndication.

Methods

setCarrierInfoForImsiEncryption

oneway setCarrierInfoForImsiEncryption (int32_t serial, ImsiEncryptionInfo imsiEncryptionInfo)

Provide Carrier specific information to the modem that must be used to encrypt the IMSI and IMPI.Sent by the framework during boot, carrier switch and everytime the framework receives a new certificate.

Response callback is IRadioResponse.setCarrierInfoForImsiEncryptionResponse()

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

setSimCardPower_1_1

oneway setSimCardPower_1_1 (int32_t serial, CardPowerState powerUp)

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

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

Response callback is IRadioResponse.setSimCardPowerResponse_1_1()

Details
RPC mode
oneway
Parameters
serial
Serial number of request
powerUp
POWER_DOWN if powering down the SIM card, POWER_UP if powering up the SIM card, POWER_UP_PASS_THROUGH if powering up the SIM card in pass through mode.When SIM card is in POWER_UP_PASS_THROUGH, the modem does not send any command to it(for example SELECT of MF, or TERMINAL CAPABILITY), and the SIM card is controlled completely by Telephony sending APDUs directly.The SIM card state must be RIL_CARDSTATE_PRESENT and the number of card apps will be 0.No new error code is generated.Emergency calls are supported in the same way as if the SIM card is absent.POWER_UP_PASS_THROUGH mode is valid only for the specific card session where it is activated, and normal behavior occurs at the next SIM initialization, unless POWER_UP_PASS_THROUGH mode is requested again.The device is required to power down the SIM card before it can switch the mode between POWER_UP and POWER_UP_PASS_THROUGH.At device power up, the SIM interface is powered up automatically.Each subsequent request to this method is processed only after the completion of the previous one.

startNetworkScan

oneway startNetworkScan (int32_t serial, NetworkScanRequest request)

Starts a network scan

Response function is IRadioResponse.startNetworkScanResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
request
Defines the radio networks/bands/channels which need to be scanned.

stopNetworkScan

oneway stopNetworkScan (int32_t serial)

Stops ongoing network scan

Response function is IRadioResponse.stopNetworkScanResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.

startKeepalive

oneway startKeepalive (int32_t serial, KeepaliveRequest keepalive)

Start a Keepalive session(for IPsec)

Response function is IRadioResponse.startKeepaliveResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
keepalive
A request structure containing all necessary info to describe a keepalive

stopKeepalive

oneway stopKeepalive (int32_t serial, int32_t sessionHandle)

Stop an ongoing Keepalive session(for IPsec)

Response function is IRadioResponse.stopKeepaliveResponse()

Details
RPC mode
oneway
Parameters
serial
Serial number of request.
sessionHandle
The handle that was provided by IRadioResponse.startKeepaliveResponse