Convert all comments into "doxygen-ready" comments.
Bug: 36453077
Test: make
Change-Id: Ic77394d4d2e1ccedba3a28230d870c5d6108bd40
diff --git a/radio/1.0/IRadio.hal b/radio/1.0/IRadio.hal
index 0b1bf40..2976290 100644
--- a/radio/1.0/IRadio.hal
+++ b/radio/1.0/IRadio.hal
@@ -19,7 +19,7 @@
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
@@ -27,7 +27,7 @@
* 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
@@ -36,7 +36,7 @@
setResponseFunctions(IRadioResponse radioResponse,
IRadioIndication radioIndication);
- /*
+ /**
* Requests status of the ICC card
*
* @param serial Serial number of request.
@@ -46,7 +46,7 @@
*/
oneway getIccCardStatus(int32_t serial);
- /*
+ /**
* Supplies ICC PIN. Only called if CardStatus has AppState.PIN state
*
* @param serial Serial number of request.
@@ -58,7 +58,7 @@
*/
oneway supplyIccPinForApp(int32_t serial, string pin, string aid);
- /*
+ /**
* Supplies ICC PUK and new PIN.
*
* @param serial Serial number of request.
@@ -71,7 +71,7 @@
*/
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.
*
@@ -84,7 +84,7 @@
*/
oneway supplyIccPin2ForApp(int32_t serial, string pin2, string aid);
- /*
+ /**
* Supplies ICC PUK2 and new PIN2.
*
* @param serial Serial number of request.
@@ -98,7 +98,7 @@
oneway supplyIccPuk2ForApp(int32_t serial, string puk2, string pin2,
string aid);
- /*
+ /**
* Supplies old ICC PIN and new PIN.
*
* @param serial Serial number of request.
@@ -112,7 +112,7 @@
oneway changeIccPinForApp(int32_t serial, string oldPin, string newPin,
string aid);
- /*
+ /**
* Supplies old ICC PIN2 and new PIN2.
*
* @param serial Serial number of request.
@@ -126,7 +126,7 @@
oneway changeIccPin2ForApp(int32_t serial, string oldPin2, string newPin2,
string aid);
- /*
+ /**
* Requests that network personalization be deactivated
*
* @param serial Serial number of request.
@@ -137,7 +137,7 @@
*/
oneway supplyNetworkDepersonalization(int32_t serial, string netPin);
- /*
+ /**
* Requests current call list
*
* @param serial Serial number of request.
@@ -147,7 +147,7 @@
*/
oneway getCurrentCalls(int32_t serial);
- /*
+ /**
* Initiate voice call.
* This method is never used for supplementary service codes
*
@@ -159,7 +159,7 @@
*/
oneway dial(int32_t serial, Dial dialInfo);
- /*
+ /**
* Get the SIM IMSI
* Only valid when radio state is "RADIO_STATE_ON"
*
@@ -171,7 +171,7 @@
*/
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.
@@ -184,7 +184,7 @@
*/
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.
@@ -196,7 +196,7 @@
*/
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.
@@ -208,7 +208,7 @@
*/
oneway hangupForegroundResumeBackground(int32_t serial);
- /*
+ /**
* Switch waiting or holding call and active call (like AT+CHLD=2)
* State transitions must be as follows:
*
@@ -229,7 +229,7 @@
*/
oneway switchWaitingOrHoldingAndActive(int32_t serial);
- /*
+ /**
* Conference holding and active (like AT+CHLD=3)
*
* @param serial Serial number of request.
@@ -239,7 +239,7 @@
*/
oneway conference(int32_t serial);
- /*
+ /**
* Send UDUB (user determined user busy) to ringing or
* waiting call answer)
*
@@ -250,7 +250,7 @@
*/
oneway rejectCall(int32_t serial);
- /*
+ /**
* Requests the failure cause code for the most recently terminated call.
*
* @param serial Serial number of request.
@@ -260,7 +260,7 @@
*/
oneway getLastCallFailCause(int32_t serial);
- /*
+ /**
* Requests current signal strength and associated information.
* Must succeed if radio is on.
*
@@ -270,7 +270,7 @@
*/
oneway getSignalStrength(int32_t serial);
- /*
+ /**
* Request current voice registration state
*
* @param serial Serial number of request.
@@ -279,7 +279,7 @@
*/
oneway getVoiceRegistrationState(int32_t serial);
- /*
+ /**
* Request current data registration state
*
* @param serial Serial number of request.
@@ -288,7 +288,7 @@
*/
oneway getDataRegistrationState(int32_t serial);
- /*
+ /**
* Request current operator ONS or EONS
*
* @param serial Serial number of request.
@@ -297,7 +297,7 @@
*/
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,
@@ -311,7 +311,7 @@
*/
oneway setRadioPower(int32_t serial, bool on);
- /*
+ /**
* Send a DTMF tone
*
* If the implementation is currently playing a tone requested via
@@ -325,7 +325,7 @@
*/
oneway sendDtmf(int32_t serial, string s);
- /*
+ /**
* Send an SMS message
*
* @param serial Serial number of request.
@@ -339,7 +339,7 @@
*/
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)
@@ -355,7 +355,7 @@
*/
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
@@ -391,7 +391,7 @@
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
@@ -411,7 +411,7 @@
*/
oneway iccIOForApp(int32_t serial, IccIo iccIo);
- /*
+ /**
* Send a USSD message.
*
* If a USSD session already exists, the message must be sent in the
@@ -434,7 +434,7 @@
*/
oneway sendUssd(int32_t serial, string ussd);
- /*
+ /**
* Cancel the current USSD session if one exists.
*
* @param serial Serial number of request.
@@ -443,7 +443,7 @@
*/
oneway cancelPendingUssd(int32_t serial);
- /*
+ /**
* Gets current CLIR status
*
* @param serial Serial number of request.
@@ -452,7 +452,7 @@
*/
oneway getClir(int32_t serial);
- /*
+ /**
* Set current CLIR status
*
* @param serial Serial number of request.
@@ -462,7 +462,7 @@
*/
oneway setClir(int32_t serial, int32_t status);
- /*
+ /**
* Request call forward status.
*
* @param serial Serial number of request.
@@ -473,7 +473,7 @@
oneway getCallForwardStatus(int32_t serial,
CallForwardInfo callInfo);
- /*
+ /**
* Configure call forward rule
*
* @param serial Serial number of request.
@@ -483,7 +483,7 @@
*/
oneway setCallForward(int32_t serial, CallForwardInfo callInfo);
- /*
+ /**
* Query current call waiting state
*
* @param serial Serial number of request.
@@ -493,7 +493,7 @@
*/
oneway getCallWaiting(int32_t serial, int32_t serviceClass);
- /*
+ /**
* Configure current call waiting state
*
* @param serial Serial number of request.
@@ -505,7 +505,7 @@
oneway setCallWaiting(int32_t serial, bool enable,
int32_t serviceClass);
- /*
+ /**
* Acknowledge successful or failed receipt of SMS previously indicated
* via unsolResponseNewSms
*
@@ -521,7 +521,7 @@
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
@@ -533,7 +533,7 @@
*/
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
@@ -551,7 +551,7 @@
oneway deactivateDataCall(int32_t serial, int32_t cid,
bool reasonRadioShutDown);
- /*
+ /**
* Query the status of a facility lock state
*
* @param serial Serial number of request.
@@ -567,7 +567,7 @@
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.
@@ -585,7 +585,7 @@
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.
@@ -598,7 +598,7 @@
oneway setBarringPassword(int32_t serial, string facility,
string oldPassword, string newPassword);
- /*
+ /**
* Query current network selection mode
*
* @param serial Serial number of request.
@@ -607,7 +607,7 @@
*/
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.
*
@@ -617,7 +617,7 @@
*/
oneway setNetworkSelectionModeAutomatic(int32_t serial);
- /*
+ /**
* Manually select a specified network.
* This request must not respond until the new operator is selected and registered.
*
@@ -628,7 +628,7 @@
*/
oneway setNetworkSelectionModeManual(int32_t serial, string operatorNumeric);
- /*
+ /**
* Scans for available networks
*
* @param serial Serial number of request.
@@ -637,7 +637,7 @@
*/
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,
@@ -650,7 +650,7 @@
*/
oneway startDtmf(int32_t serial, string s);
- /*
+ /**
* Stop playing a currently playing DTMF tone.
*
* @param serial Serial number of request.
@@ -659,7 +659,7 @@
*/
oneway stopDtmf(int32_t serial);
- /*
+ /**
* Return string value indicating baseband version, eg response from AT+CGMR
*
* @param serial Serial number of request.
@@ -668,7 +668,7 @@
*/
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
@@ -686,7 +686,7 @@
*/
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
@@ -698,7 +698,7 @@
*/
oneway setMute(int32_t serial, bool enable);
- /*
+ /**
* Queries the current state of the uplink mute setting
*
* @param serial Serial number of request.
@@ -707,7 +707,7 @@
*/
oneway getMute(int32_t serial);
- /*
+ /**
* Queries the status of the CLIP supplementary service
* (for MMI code "*#30#")
*
@@ -717,7 +717,7 @@
*/
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
@@ -729,7 +729,7 @@
*/
oneway getDataCallList(int32_t serial);
- /*
+ /**
* Enables/disables supplementary service related notifications from the network.
* Notifications are reported via unsolSuppSvcNotification().
*
@@ -740,7 +740,7 @@
*/
oneway setSuppServiceNotifications(int32_t serial, bool enable);
- /*
+ /**
* Stores a SMS message to SIM memory.
*
* @param serial Serial number of request.
@@ -750,7 +750,7 @@
*/
oneway writeSmsToSim(int32_t serial, SmsWriteArgs smsWriteArgs);
- /*
+ /**
* Deletes a SMS message from SIM memory.
*
* @param serial Serial number of request.
@@ -760,7 +760,7 @@
*/
oneway deleteSmsOnSim(int32_t serial, int32_t index);
- /*
+ /**
* Assign a specified band for RF configuration.
*
* @param serial Serial number of request.
@@ -770,7 +770,7 @@
*/
oneway setBandMode(int32_t serial, RadioBandMode mode);
- /*
+ /**
* Get the list of band modes supported by RF.
*
* @param serial Serial number of request.
@@ -779,7 +779,7 @@
*/
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
*
@@ -790,7 +790,7 @@
*/
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.
@@ -801,7 +801,7 @@
*/
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
@@ -815,7 +815,7 @@
oneway handleStkCallSetupRequestFromSim(int32_t serial,
bool accept);
- /*
+ /**
* Connects the two calls and disconnects the subscriber from both calls.
*
* @param serial Serial number of request.
@@ -824,7 +824,7 @@
*/
oneway explicitCallTransfer(int32_t serial);
- /*
+ /**
* Requests to set the preferred network type for searching and registering
* (CS/PS domain, RAT, and operation mode)
*
@@ -836,7 +836,7 @@
oneway setPreferredNetworkType(int32_t serial,
PreferredNetworkType nwType);
- /*
+ /**
* Query the preferred network type (CS/PS domain, RAT, and operation mode)
* for searching and registering
*
@@ -846,7 +846,7 @@
*/
oneway getPreferredNetworkType(int32_t serial);
- /*
+ /**
* Request neighboring cell id in GSM network
*
* @param serial Serial number of request.
@@ -855,7 +855,7 @@
*/
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).
@@ -869,7 +869,7 @@
*/
oneway setLocationUpdates(int32_t serial, bool enable);
- /*
+ /**
* Request to set the location where the CDMA subscription shall
* be retrieved
*
@@ -881,7 +881,7 @@
oneway setCdmaSubscriptionSource(int32_t serial,
CdmaSubscriptionSource cdmaSub);
- /*
+ /**
* Request to set the roaming preferences in CDMA
*
* @param serial Serial number of request.
@@ -892,7 +892,7 @@
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.
@@ -901,7 +901,7 @@
*/
oneway getCdmaRoamingPreference(int32_t serial);
- /*
+ /**
* Request to set the TTY mode
*
* @param serial Serial number of request.
@@ -911,7 +911,7 @@
*/
oneway setTTYMode(int32_t serial, TtyMode mode);
- /*
+ /**
* Request the setting of TTY mode
*
* @param serial Serial number of request.
@@ -920,7 +920,7 @@
*/
oneway getTTYMode(int32_t serial);
- /*
+ /**
* Request to set the preferred voice privacy mode used in voice scrambling.
*
* @param serial Serial number of request.
@@ -931,7 +931,7 @@
*/
oneway setPreferredVoicePrivacy(int32_t serial, bool enable);
- /*
+ /**
* Request the setting of preferred voice privacy mode.
*
* @param serial Serial number of request.
@@ -940,7 +940,7 @@
*/
oneway getPreferredVoicePrivacy(int32_t serial);
- /*
+ /**
* Send FLASH command
*
* @param serial Serial number of request.
@@ -950,7 +950,7 @@
*/
oneway sendCDMAFeatureCode(int32_t serial, string featureCode);
- /*
+ /**
* Send DTMF string
*
* @param serial Serial number of request.
@@ -962,7 +962,7 @@
*/
oneway sendBurstDtmf(int32_t serial, string dtmf, int32_t on, int32_t off);
- /*
+ /**
* Send a CDMA SMS message
*
* @param serial Serial number of request.
@@ -972,7 +972,7 @@
*/
oneway sendCdmaSms(int32_t serial, CdmaSmsMessage sms);
- /*
+ /**
* Acknowledge the success or failure in the receipt of SMS
* previously indicated via responseCdmaNewSms()
*
@@ -983,7 +983,7 @@
*/
oneway acknowledgeLastIncomingCdmaSms(int32_t serial, CdmaSmsAck smsAck);
- /*
+ /**
* Request the setting of GSM/WCDMA Cell Broadcast SMS config.
*
* @param serial Serial number of request.
@@ -992,7 +992,7 @@
*/
oneway getGsmBroadcastConfig(int32_t serial);
- /*
+ /**
* Set GSM/WCDMA Cell Broadcast SMS config
*
* @param serial Serial number of request.
@@ -1002,7 +1002,7 @@
*/
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.
@@ -1013,7 +1013,7 @@
*/
oneway setGsmBroadcastActivation(int32_t serial, bool activate);
- /*
+ /**
* Request the setting of CDMA Broadcast SMS config
*
* @param serial Serial number of request.
@@ -1022,7 +1022,7 @@
*/
oneway getCdmaBroadcastConfig(int32_t serial);
- /*
+ /**
* Set CDMA Broadcast SMS config
*
* @param serial Serial number of request.
@@ -1032,7 +1032,7 @@
*/
oneway setCdmaBroadcastConfig(int32_t serial, vec<CdmaBroadcastSmsConfigInfo> configInfo);
- /*
+ /**
* Enable or disable the reception of CDMA Cell Broadcast SMS
*
* @param serial Serial number of request.
@@ -1043,7 +1043,7 @@
*/
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
@@ -1055,7 +1055,7 @@
*/
oneway getCDMASubscription(int32_t serial);
- /*
+ /**
* Stores a CDMA SMS message to RUIM memory.
*
* @param serial Serial number of request.
@@ -1065,7 +1065,7 @@
*/
oneway writeSmsToRuim(int32_t serial, CdmaSmsWriteArgs cdmaSms);
- /*
+ /**
* Deletes a CDMA SMS message from RUIM memory.
*
* @param serial Serial number of request.
@@ -1075,7 +1075,7 @@
*/
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
@@ -1087,7 +1087,7 @@
*/
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.
@@ -1098,7 +1098,7 @@
*/
oneway exitEmergencyCallbackMode(int32_t serial);
- /*
+ /**
* Get the default Short Message Service Center address on the device.
*
* @param serial Serial number of request.
@@ -1107,7 +1107,7 @@
*/
oneway getSmscAddress(int32_t serial);
- /*
+ /**
* Set the default Short Message Service Center address on the device.
*
* @param serial Serial number of request.
@@ -1117,7 +1117,7 @@
*/
oneway setSmscAddress(int32_t serial, string smsc);
- /*
+ /**
* Indicates whether there is storage available for new SMS messages.
*
* @param serial Serial number of request.
@@ -1128,7 +1128,7 @@
*/
oneway reportSmsMemoryStatus(int32_t serial, bool available);
- /*
+ /**
* Indicates that the StkService is running and is
* ready to receive unsolicited stkXXXXX commands.
*
@@ -1138,7 +1138,7 @@
*/
oneway reportStkServiceIsRunning(int32_t serial);
- /*
+ /**
* Request to query the location where the CDMA subscription shall be retrieved.
*
* @param serial Serial number of request.
@@ -1147,7 +1147,7 @@
*/
oneway getCdmaSubscriptionSource(int32_t serial);
- /*
+ /**
* Request the ISIM application on the UICC to perform AKA
* challenge/response algorithm for IMS authentication
*
@@ -1158,7 +1158,7 @@
*/
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.
@@ -1172,7 +1172,7 @@
*/
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.
*
@@ -1191,7 +1191,7 @@
*/
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
*
@@ -1201,7 +1201,7 @@
*/
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.
@@ -1213,7 +1213,7 @@
*/
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
@@ -1226,7 +1226,7 @@
*/
oneway setCellInfoListRate(int32_t serial, int32_t rate);
- /*
+ /**
* Set an apn to initial attach network
*
* @param serial Serial number of request.
@@ -1243,7 +1243,7 @@
oneway setInitialAttachApn(int32_t serial, DataProfileInfo dataProfileInfo,
bool modemCognitive, bool isRoaming);
- /*
+ /**
* Request current IMS registration state
*
* @param serial Serial number of request.
@@ -1252,7 +1252,7 @@
*/
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.
@@ -1265,7 +1265,7 @@
*/
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
@@ -1279,7 +1279,7 @@
*/
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).
*
@@ -1290,7 +1290,7 @@
*/
oneway iccOpenLogicalChannel(int32_t serial, string aid);
- /*
+ /**
* Close a previously opened logical channel. This command reflects TS 27.007
* "close logical channel" operation (+CCHC).
*
@@ -1301,7 +1301,7 @@
*/
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
@@ -1314,7 +1314,7 @@
*/
oneway iccTransmitApduLogicalChannel(int32_t serial, SimApdu message);
- /*
+ /**
* Read one of the radio NV items.
* This is used for device configuration by some CDMA operators.
*
@@ -1325,7 +1325,7 @@
*/
oneway nvReadItem(int32_t serial, NvItem itemId);
- /*
+ /**
* Write one of the radio NV items.
* This is used for device configuration by some CDMA operators.
*
@@ -1336,7 +1336,7 @@
*/
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.
*
@@ -1347,7 +1347,7 @@
*/
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.
*
@@ -1358,7 +1358,7 @@
*/
oneway nvResetConfig(int32_t serial, ResetNvType resetType);
- /*
+ /**
* Selection/de-selection of a subscription from a SIM card
*
* @param serial Serial number of request.
@@ -1368,7 +1368,7 @@
*/
oneway setUiccSubscription(int32_t serial, SelectUiccSub uiccSub);
- /*
+ /**
* Tells the modem whether data calls are allowed or not
*
* @param serial Serial number of request.
@@ -1378,7 +1378,7 @@
*/
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.
@@ -1387,7 +1387,7 @@
*/
oneway getHardwareConfig(int32_t serial);
- /*
+ /**
* Returns the response of SIM Authentication through Radio challenge request.
*
* @param serial Serial number of request.
@@ -1401,7 +1401,7 @@
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
*
@@ -1416,7 +1416,7 @@
*/
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.
*
@@ -1426,7 +1426,7 @@
*/
oneway requestShutdown(int32_t serial);
- /*
+ /**
* Used to get phone radio capability.
*
* @param serial Serial number of request.
@@ -1435,7 +1435,7 @@
*/
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
@@ -1448,7 +1448,7 @@
*/
oneway setRadioCapability(int32_t serial, RadioCapability rc);
- /*
+ /**
* Start Link Capacity Estimate (LCE) service if supported by the radio.
*
* @param serial Serial number of request.
@@ -1459,7 +1459,7 @@
*/
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.
*
@@ -1469,7 +1469,7 @@
*/
oneway stopLceService(int32_t serial);
- /*
+ /**
* Pull LCE service for capacity information.
*
* @param serial Serial number of request.
@@ -1478,7 +1478,7 @@
*/
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
@@ -1490,7 +1490,7 @@
*/
oneway getModemActivityInfo(int32_t serial);
- /*
+ /**
* Set carrier restrictions. Expected modem behavior:
* If never receives this command
* - Must allow all carriers
@@ -1514,7 +1514,7 @@
*/
oneway setAllowedCarriers(int32_t serial, bool allAllowed, CarrierRestrictions carriers);
- /*
+ /**
* Get carrier restrictions.
*
* @param serial Serial number of request.
@@ -1523,7 +1523,7 @@
*/
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.
@@ -1536,7 +1536,7 @@
*/
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.
@@ -1549,7 +1549,7 @@
*/
oneway setIndicationFilter(int32_t serial, bitfield<IndicationFilter> indicationFilter);
- /*
+ /**
* Set SIM card power state.
* Request is equivalent to inserting or removing the card.
*
@@ -1563,7 +1563,7 @@
*/
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().