2 * Copyright (C) 2006 The Android Open Source Project
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
18 #define ANDROID_RIL_H 1
22 #include <telephony/ril_cdma_sms.h>
23 #include <telephony/ril_nv_items.h>
24 #include <telephony/ril_msim.h>
26 #ifndef FEATURE_UNIT_TEST
28 #endif /* !FEATURE_UNIT_TEST */
35 #if defined(ANDROID_SIM_COUNT_2)
37 #elif defined(ANDROID_SIM_COUNT_3)
39 #elif defined(ANDROID_SIM_COUNT_4)
45 #ifndef ANDROID_MULTI_SIM
52 * Value of RIL_VERSION should not be changed in future. Here onwards,
53 * when a new change is supposed to be introduced which could involve new
54 * schemes added like Wakelocks, data structures added/updated, etc, we would
55 * just document RIL version associated with that change below. When OEM updates its
56 * RIL with those changes, they would return that new RIL version during RIL_REGISTER.
57 * We should make use of the returned version by vendor to identify appropriate scheme
58 * or data structure version to use.
60 * Documentation of RIL version and associated changes
61 * RIL_VERSION = 12 : This version corresponds to updated data structures namely
62 * RIL_Data_Call_Response_v11, RIL_SIM_IO_v6, RIL_CardStatus_v6,
63 * RIL_SimRefreshResponse_v7, RIL_CDMA_CallWaiting_v6,
64 * RIL_LTE_SignalStrength_v8, RIL_SignalStrength_v10, RIL_CellIdentityGsm_v12
65 * RIL_CellIdentityWcdma_v12, RIL_CellIdentityLte_v12,RIL_CellInfoGsm_v12,
66 * RIL_CellInfoWcdma_v12, RIL_CellInfoLte_v12, RIL_CellInfo_v12.
68 * RIL_VERSION = 13 : This version includes new wakelock semantics and as the first
69 * strongly versioned version it enforces structure use.
71 * RIL_VERSION = 14 : New data structures are added, namely RIL_CarrierMatchType,
72 * RIL_Carrier, RIL_CarrierRestrictions and RIL_PCO_Data.
73 * New commands added: RIL_REQUEST_SET_CARRIER_RESTRICTIONS,
74 * RIL_REQUEST_SET_CARRIER_RESTRICTIONS and RIL_UNSOL_PCO_DATA.
76 * RIL_VERSION = 15 : New commands added:
77 * RIL_UNSOL_MODEM_RESTART,
78 * RIL_REQUEST_SEND_DEVICE_STATE,
79 * RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER,
80 * RIL_REQUEST_SET_SIM_CARD_POWER,
81 * RIL_REQUEST_SET_CARRIER_INFO_IMSI_ENCRYPTION,
82 * RIL_UNSOL_CARRIER_INFO_IMSI_ENCRYPTION
83 * The new parameters for RIL_REQUEST_SETUP_DATA_CALL,
84 * Updated data structures: RIL_DataProfileInfo_v15, RIL_InitialAttachApn_v15
85 * New data structure RIL_DataRegistrationStateResponse,
86 * RIL_VoiceRegistrationStateResponse same is
87 * used in RIL_REQUEST_DATA_REGISTRATION_STATE and
88 * RIL_REQUEST_VOICE_REGISTRATION_STATE respectively.
89 * New data structure RIL_OpenChannelParams.
90 * RIL_REQUEST_START_NETWORK_SCAN
91 * RIL_REQUEST_STOP_NETWORK_SCAN
92 * RIL_UNSOL_NETWORK_SCAN_RESULT
94 #define RIL_VERSION 12
95 #define LAST_IMPRECISE_RIL_VERSION 12 // Better self-documented name
96 #define RIL_VERSION_MIN 6 /* Minimum RIL_VERSION supported */
98 #define CDMA_ALPHA_INFO_BUFFER_LENGTH 64
99 #define CDMA_NUMBER_INFO_BUFFER_LENGTH 81
102 #define MAX_SERVICE_NAME_LENGTH 6
103 #define MAX_CLIENT_ID_LENGTH 2
104 #define MAX_DEBUG_SOCKET_NAME_LENGTH 12
105 #define MAX_QEMU_PIPE_NAME_LENGTH 11
106 #define MAX_UUID_LENGTH 64
108 #define MAX_CHANNELS 32
109 #define MAX_RADIO_ACCESS_NETWORKS 8
112 typedef void * RIL_Token;
131 RIL_E_RADIO_NOT_AVAILABLE = 1, /* If radio did not start or is resetting */
132 RIL_E_GENERIC_FAILURE = 2,
133 RIL_E_PASSWORD_INCORRECT = 3, /* for PIN/PIN2 methods only! */
134 RIL_E_SIM_PIN2 = 4, /* Operation requires SIM PIN2 to be entered */
135 RIL_E_SIM_PUK2 = 5, /* Operation requires SIM PIN2 to be entered */
136 RIL_E_REQUEST_NOT_SUPPORTED = 6,
138 RIL_E_OP_NOT_ALLOWED_DURING_VOICE_CALL = 8, /* data ops are not allowed during voice
139 call on a Class C GPRS device */
140 RIL_E_OP_NOT_ALLOWED_BEFORE_REG_TO_NW = 9, /* data ops are not allowed before device
141 registers in network */
142 RIL_E_SMS_SEND_FAIL_RETRY = 10, /* fail to send sms and need retry */
143 RIL_E_SIM_ABSENT = 11, /* fail to set the location where CDMA subscription
144 shall be retrieved because of SIM or RUIM
146 RIL_E_SUBSCRIPTION_NOT_AVAILABLE = 12, /* fail to find CDMA subscription from specified
148 RIL_E_MODE_NOT_SUPPORTED = 13, /* HW does not support preferred network type */
149 RIL_E_FDN_CHECK_FAILURE = 14, /* command failed because recipient is not on FDN list */
150 RIL_E_ILLEGAL_SIM_OR_ME = 15, /* network selection failed due to
152 RIL_E_MISSING_RESOURCE = 16, /* no logical channel available */
153 RIL_E_NO_SUCH_ELEMENT = 17, /* application not found on SIM */
154 RIL_E_DIAL_MODIFIED_TO_USSD = 18, /* DIAL request modified to USSD */
155 RIL_E_DIAL_MODIFIED_TO_SS = 19, /* DIAL request modified to SS */
156 RIL_E_DIAL_MODIFIED_TO_DIAL = 20, /* DIAL request modified to DIAL with different
158 RIL_E_USSD_MODIFIED_TO_DIAL = 21, /* USSD request modified to DIAL */
159 RIL_E_USSD_MODIFIED_TO_SS = 22, /* USSD request modified to SS */
160 RIL_E_USSD_MODIFIED_TO_USSD = 23, /* USSD request modified to different USSD
162 RIL_E_SS_MODIFIED_TO_DIAL = 24, /* SS request modified to DIAL */
163 RIL_E_SS_MODIFIED_TO_USSD = 25, /* SS request modified to USSD */
164 RIL_E_SUBSCRIPTION_NOT_SUPPORTED = 26, /* Subscription not supported by RIL */
165 RIL_E_SS_MODIFIED_TO_SS = 27, /* SS request modified to different SS request */
166 RIL_E_LCE_NOT_SUPPORTED = 36, /* LCE service not supported(36 in RILConstants.java) */
167 RIL_E_NO_MEMORY = 37, /* Not sufficient memory to process the request */
168 RIL_E_INTERNAL_ERR = 38, /* Modem hit unexpected error scenario while handling
170 RIL_E_SYSTEM_ERR = 39, /* Hit platform or system error */
171 RIL_E_MODEM_ERR = 40, /* Vendor RIL got unexpected or incorrect response
172 from modem for this request */
173 RIL_E_INVALID_STATE = 41, /* Unexpected request for the current state */
174 RIL_E_NO_RESOURCES = 42, /* Not sufficient resource to process the request */
175 RIL_E_SIM_ERR = 43, /* Received error from SIM card */
176 RIL_E_INVALID_ARGUMENTS = 44, /* Received invalid arguments in request */
177 RIL_E_INVALID_SIM_STATE = 45, /* Can not process the request in current SIM state */
178 RIL_E_INVALID_MODEM_STATE = 46, /* Can not process the request in current Modem state */
179 RIL_E_INVALID_CALL_ID = 47, /* Received invalid call id in request */
180 RIL_E_NO_SMS_TO_ACK = 48, /* ACK received when there is no SMS to ack */
181 RIL_E_NETWORK_ERR = 49, /* Received error from network */
182 RIL_E_REQUEST_RATE_LIMITED = 50, /* Operation denied due to overly-frequent requests */
183 RIL_E_SIM_BUSY = 51, /* SIM is busy */
184 RIL_E_SIM_FULL = 52, /* The target EF is full */
185 RIL_E_NETWORK_REJECT = 53, /* Request is rejected by network */
186 RIL_E_OPERATION_NOT_ALLOWED = 54, /* Not allowed the request now */
187 RIL_E_EMPTY_RECORD = 55, /* The request record is empty */
188 RIL_E_INVALID_SMS_FORMAT = 56, /* Invalid sms format */
189 RIL_E_ENCODING_ERR = 57, /* Message not encoded properly */
190 RIL_E_INVALID_SMSC_ADDRESS = 58, /* SMSC address specified is invalid */
191 RIL_E_NO_SUCH_ENTRY = 59, /* No such entry present to perform the request */
192 RIL_E_NETWORK_NOT_READY = 60, /* Network is not ready to perform the request */
193 RIL_E_NOT_PROVISIONED = 61, /* Device doesnot have this value provisioned */
194 RIL_E_NO_SUBSCRIPTION = 62, /* Device doesnot have subscription */
195 RIL_E_NO_NETWORK_FOUND = 63, /* Network cannot be found */
196 RIL_E_DEVICE_IN_USE = 64, /* Operation cannot be performed because the device
197 is currently in use */
198 RIL_E_ABORTED = 65, /* Operation aborted */
199 RIL_E_INVALID_RESPONSE = 66, /* Invalid response sent by vendor code */
200 // OEM specific error codes. To be used by OEM when they don't want to reveal
201 // specific error codes which would be replaced by Generic failure.
202 RIL_E_OEM_ERROR_1 = 501,
203 RIL_E_OEM_ERROR_2 = 502,
204 RIL_E_OEM_ERROR_3 = 503,
205 RIL_E_OEM_ERROR_4 = 504,
206 RIL_E_OEM_ERROR_5 = 505,
207 RIL_E_OEM_ERROR_6 = 506,
208 RIL_E_OEM_ERROR_7 = 507,
209 RIL_E_OEM_ERROR_8 = 508,
210 RIL_E_OEM_ERROR_9 = 509,
211 RIL_E_OEM_ERROR_10 = 510,
212 RIL_E_OEM_ERROR_11 = 511,
213 RIL_E_OEM_ERROR_12 = 512,
214 RIL_E_OEM_ERROR_13 = 513,
215 RIL_E_OEM_ERROR_14 = 514,
216 RIL_E_OEM_ERROR_15 = 515,
217 RIL_E_OEM_ERROR_16 = 516,
218 RIL_E_OEM_ERROR_17 = 517,
219 RIL_E_OEM_ERROR_18 = 518,
220 RIL_E_OEM_ERROR_19 = 519,
221 RIL_E_OEM_ERROR_20 = 520,
222 RIL_E_OEM_ERROR_21 = 521,
223 RIL_E_OEM_ERROR_22 = 522,
224 RIL_E_OEM_ERROR_23 = 523,
225 RIL_E_OEM_ERROR_24 = 524,
226 RIL_E_OEM_ERROR_25 = 525
231 RIL_CALL_HOLDING = 1,
232 RIL_CALL_DIALING = 2, /* MO call only */
233 RIL_CALL_ALERTING = 3, /* MO call only */
234 RIL_CALL_INCOMING = 4, /* MT call only */
235 RIL_CALL_WAITING = 5 /* MT call only */
239 RADIO_STATE_OFF = 0, /* Radio explictly powered off (eg CFUN=0) */
240 RADIO_STATE_UNAVAILABLE = 1, /* Radio unavailable (eg, resetting or not booted) */
241 RADIO_STATE_ON = 10 /* Radio is on */
245 RADIO_TECH_UNKNOWN = 0,
249 RADIO_TECH_IS95A = 4,
250 RADIO_TECH_IS95B = 5,
251 RADIO_TECH_1xRTT = 6,
252 RADIO_TECH_EVDO_0 = 7,
253 RADIO_TECH_EVDO_A = 8,
254 RADIO_TECH_HSDPA = 9,
255 RADIO_TECH_HSUPA = 10,
256 RADIO_TECH_HSPA = 11,
257 RADIO_TECH_EVDO_B = 12,
258 RADIO_TECH_EHRPD = 13,
260 RADIO_TECH_HSPAP = 15, // HSPA+
261 RADIO_TECH_GSM = 16, // Only supports voice
262 RADIO_TECH_TD_SCDMA = 17,
263 RADIO_TECH_IWLAN = 18,
264 RADIO_TECH_LTE_CA = 19
265 } RIL_RadioTechnology;
268 RAF_UNKNOWN = (1 << RADIO_TECH_UNKNOWN),
269 RAF_GPRS = (1 << RADIO_TECH_GPRS),
270 RAF_EDGE = (1 << RADIO_TECH_EDGE),
271 RAF_UMTS = (1 << RADIO_TECH_UMTS),
272 RAF_IS95A = (1 << RADIO_TECH_IS95A),
273 RAF_IS95B = (1 << RADIO_TECH_IS95B),
274 RAF_1xRTT = (1 << RADIO_TECH_1xRTT),
275 RAF_EVDO_0 = (1 << RADIO_TECH_EVDO_0),
276 RAF_EVDO_A = (1 << RADIO_TECH_EVDO_A),
277 RAF_HSDPA = (1 << RADIO_TECH_HSDPA),
278 RAF_HSUPA = (1 << RADIO_TECH_HSUPA),
279 RAF_HSPA = (1 << RADIO_TECH_HSPA),
280 RAF_EVDO_B = (1 << RADIO_TECH_EVDO_B),
281 RAF_EHRPD = (1 << RADIO_TECH_EHRPD),
282 RAF_LTE = (1 << RADIO_TECH_LTE),
283 RAF_HSPAP = (1 << RADIO_TECH_HSPAP),
284 RAF_GSM = (1 << RADIO_TECH_GSM),
285 RAF_TD_SCDMA = (1 << RADIO_TECH_TD_SCDMA),
286 RAF_LTE_CA = (1 << RADIO_TECH_LTE_CA)
287 } RIL_RadioAccessFamily;
290 BAND_MODE_UNSPECIFIED = 0, //"unspecified" (selected by baseband automatically)
291 BAND_MODE_EURO = 1, //"EURO band" (GSM-900 / DCS-1800 / WCDMA-IMT-2000)
292 BAND_MODE_USA = 2, //"US band" (GSM-850 / PCS-1900 / WCDMA-850 / WCDMA-PCS-1900)
293 BAND_MODE_JPN = 3, //"JPN band" (WCDMA-800 / WCDMA-IMT-2000)
294 BAND_MODE_AUS = 4, //"AUS band" (GSM-900 / DCS-1800 / WCDMA-850 / WCDMA-IMT-2000)
295 BAND_MODE_AUS_2 = 5, //"AUS band 2" (GSM-900 / DCS-1800 / WCDMA-850)
296 BAND_MODE_CELL_800 = 6, //"Cellular" (800-MHz Band)
297 BAND_MODE_PCS = 7, //"PCS" (1900-MHz Band)
298 BAND_MODE_JTACS = 8, //"Band Class 3" (JTACS Band)
299 BAND_MODE_KOREA_PCS = 9, //"Band Class 4" (Korean PCS Band)
300 BAND_MODE_5_450M = 10, //"Band Class 5" (450-MHz Band)
301 BAND_MODE_IMT2000 = 11, //"Band Class 6" (2-GMHz IMT2000 Band)
302 BAND_MODE_7_700M_2 = 12, //"Band Class 7" (Upper 700-MHz Band)
303 BAND_MODE_8_1800M = 13, //"Band Class 8" (1800-MHz Band)
304 BAND_MODE_9_900M = 14, //"Band Class 9" (900-MHz Band)
305 BAND_MODE_10_800M_2 = 15, //"Band Class 10" (Secondary 800-MHz Band)
306 BAND_MODE_EURO_PAMR_400M = 16, //"Band Class 11" (400-MHz European PAMR Band)
307 BAND_MODE_AWS = 17, //"Band Class 15" (AWS Band)
308 BAND_MODE_USA_2500M = 18 //"Band Class 16" (US 2.5-GHz Band)
312 RC_PHASE_CONFIGURED = 0, // LM is configured is initial value and value after FINISH completes
313 RC_PHASE_START = 1, // START is sent before Apply and indicates that an APPLY will be
314 // forthcoming with these same parameters
315 RC_PHASE_APPLY = 2, // APPLY is sent after all LM's receive START and returned
316 // RIL_RadioCapability.status = 0, if any START's fail no
317 // APPLY will be sent
318 RC_PHASE_UNSOL_RSP = 3, // UNSOL_RSP is sent with RIL_UNSOL_RADIO_CAPABILITY
319 RC_PHASE_FINISH = 4 // FINISH is sent after all commands have completed. If an error
320 // occurs in any previous command the RIL_RadioAccessesFamily and
321 // logicalModemUuid fields will be the prior configuration thus
322 // restoring the configuration to the previous value. An error
323 // returned by this command will generally be ignored or may
324 // cause that logical modem to be removed from service.
325 } RadioCapabilityPhase;
328 RC_STATUS_NONE = 0, // This parameter has no meaning with RC_PHASE_START,
330 RC_STATUS_SUCCESS = 1, // Tell modem the action transaction of set radio
331 // capability was success with RC_PHASE_FINISH
332 RC_STATUS_FAIL = 2, // Tell modem the action transaction of set radio
333 // capability is fail with RC_PHASE_FINISH.
334 } RadioCapabilityStatus;
336 #define RIL_RADIO_CAPABILITY_VERSION 1
338 int version; // Version of structure, RIL_RADIO_CAPABILITY_VERSION
339 int session; // Unique session value defined by framework returned in all "responses/unsol"
340 int phase; // CONFIGURED, START, APPLY, FINISH
341 int rat; // RIL_RadioAccessFamily for the radio
342 char logicalModemUuid[MAX_UUID_LENGTH]; // A UUID typically "com.xxxx.lmX where X is the logical modem.
343 int status; // Return status and an input parameter for RC_PHASE_FINISH
344 } RIL_RadioCapability;
346 // Do we want to split Data from Voice and the use
347 // RIL_RadioTechnology for get/setPreferredVoice/Data ?
349 PREF_NET_TYPE_GSM_WCDMA = 0, /* GSM/WCDMA (WCDMA preferred) */
350 PREF_NET_TYPE_GSM_ONLY = 1, /* GSM only */
351 PREF_NET_TYPE_WCDMA = 2, /* WCDMA */
352 PREF_NET_TYPE_GSM_WCDMA_AUTO = 3, /* GSM/WCDMA (auto mode, according to PRL) */
353 PREF_NET_TYPE_CDMA_EVDO_AUTO = 4, /* CDMA and EvDo (auto mode, according to PRL) */
354 PREF_NET_TYPE_CDMA_ONLY = 5, /* CDMA only */
355 PREF_NET_TYPE_EVDO_ONLY = 6, /* EvDo only */
356 PREF_NET_TYPE_GSM_WCDMA_CDMA_EVDO_AUTO = 7, /* GSM/WCDMA, CDMA, and EvDo (auto mode, according to PRL) */
357 PREF_NET_TYPE_LTE_CDMA_EVDO = 8, /* LTE, CDMA and EvDo */
358 PREF_NET_TYPE_LTE_GSM_WCDMA = 9, /* LTE, GSM/WCDMA */
359 PREF_NET_TYPE_LTE_CMDA_EVDO_GSM_WCDMA = 10, /* LTE, CDMA, EvDo, GSM/WCDMA */
360 PREF_NET_TYPE_LTE_ONLY = 11, /* LTE only */
361 PREF_NET_TYPE_LTE_WCDMA = 12, /* LTE/WCDMA */
362 PREF_NET_TYPE_TD_SCDMA_ONLY = 13, /* TD-SCDMA only */
363 PREF_NET_TYPE_TD_SCDMA_WCDMA = 14, /* TD-SCDMA and WCDMA */
364 PREF_NET_TYPE_TD_SCDMA_LTE = 15, /* TD-SCDMA and LTE */
365 PREF_NET_TYPE_TD_SCDMA_GSM = 16, /* TD-SCDMA and GSM */
366 PREF_NET_TYPE_TD_SCDMA_GSM_LTE = 17, /* TD-SCDMA,GSM and LTE */
367 PREF_NET_TYPE_TD_SCDMA_GSM_WCDMA = 18, /* TD-SCDMA, GSM/WCDMA */
368 PREF_NET_TYPE_TD_SCDMA_WCDMA_LTE = 19, /* TD-SCDMA, WCDMA and LTE */
369 PREF_NET_TYPE_TD_SCDMA_GSM_WCDMA_LTE = 20, /* TD-SCDMA, GSM/WCDMA and LTE */
370 PREF_NET_TYPE_TD_SCDMA_GSM_WCDMA_CDMA_EVDO_AUTO = 21, /* TD-SCDMA, GSM/WCDMA, CDMA and EvDo */
371 PREF_NET_TYPE_TD_SCDMA_LTE_CDMA_EVDO_GSM_WCDMA = 22 /* TD-SCDMA, LTE, CDMA, EvDo GSM/WCDMA */
372 } RIL_PreferredNetworkType;
374 /* Source for cdma subscription */
376 CDMA_SUBSCRIPTION_SOURCE_RUIM_SIM = 0,
377 CDMA_SUBSCRIPTION_SOURCE_NV = 1
378 } RIL_CdmaSubscriptionSource;
380 /* User-to-User signaling Info activation types derived from 3GPP 23.087 v8.0 */
382 RIL_UUS_TYPE1_IMPLICIT = 0,
383 RIL_UUS_TYPE1_REQUIRED = 1,
384 RIL_UUS_TYPE1_NOT_REQUIRED = 2,
385 RIL_UUS_TYPE2_REQUIRED = 3,
386 RIL_UUS_TYPE2_NOT_REQUIRED = 4,
387 RIL_UUS_TYPE3_REQUIRED = 5,
388 RIL_UUS_TYPE3_NOT_REQUIRED = 6
391 /* User-to-User Signaling Information data coding schemes. Possible values for
392 * Octet 3 (Protocol Discriminator field) in the UUIE. The values have been
393 * specified in section 10.5.4.25 of 3GPP TS 24.008 */
395 RIL_UUS_DCS_USP = 0, /* User specified protocol */
396 RIL_UUS_DCS_OSIHLP = 1, /* OSI higher layer protocol */
397 RIL_UUS_DCS_X244 = 2, /* X.244 */
398 RIL_UUS_DCS_RMCF = 3, /* Reserved for system mangement
399 convergence function */
400 RIL_UUS_DCS_IA5c = 4 /* IA5 characters */
403 /* User-to-User Signaling Information defined in 3GPP 23.087 v8.0
404 * This data is passed in RIL_ExtensionRecord and rec contains this
405 * structure when type is RIL_UUS_INFO_EXT_REC */
407 RIL_UUS_Type uusType; /* UUS Type */
408 RIL_UUS_DCS uusDcs; /* UUS Data Coding Scheme */
409 int uusLength; /* Length of UUS Data */
410 char * uusData; /* UUS Data */
413 /* CDMA Signal Information Record as defined in C.S0005 section 3.7.5.5 */
415 char isPresent; /* non-zero if signal information record is present */
416 char signalType; /* as defined 3.7.5.5-1 */
417 char alertPitch; /* as defined 3.7.5.5-2 */
418 char signal; /* as defined 3.7.5.5-3, 3.7.5.5-4 or 3.7.5.5-5 */
419 } RIL_CDMA_SignalInfoRecord;
423 int index; /* Connection Index for use with, eg, AT+CHLD */
424 int toa; /* type of address, eg 145 = intl */
425 char isMpty; /* nonzero if is mpty call */
426 char isMT; /* nonzero if call is mobile terminated */
427 char als; /* ALS line indicator if available
429 char isVoice; /* nonzero if this is is a voice call */
430 char isVoicePrivacy; /* nonzero if CDMA voice privacy mode is active */
431 char * number; /* Remote party number */
432 int numberPresentation; /* 0=Allowed, 1=Restricted, 2=Not Specified/Unknown 3=Payphone */
433 char * name; /* Remote party name */
434 int namePresentation; /* 0=Allowed, 1=Restricted, 2=Not Specified/Unknown 3=Payphone */
435 RIL_UUS_Info * uusInfo; /* NULL or Pointer to User-User Signaling Information */
438 /* Deprecated, use RIL_Data_Call_Response_v6 */
440 int cid; /* Context ID, uniquely identifies this call */
441 int active; /* 0=inactive, 1=active/physical link down, 2=active/physical link up */
442 char * type; /* One of the PDP_type values in TS 27.007 section 10.1.1.
443 For example, "IP", "IPV6", "IPV4V6", or "PPP". */
444 char * apn; /* ignored */
445 char * address; /* An address, e.g., "192.0.1.3" or "2001:db8::1". */
446 } RIL_Data_Call_Response_v4;
449 * Returned by RIL_REQUEST_SETUP_DATA_CALL, RIL_REQUEST_DATA_CALL_LIST
450 * and RIL_UNSOL_DATA_CALL_LIST_CHANGED, on error status != 0.
453 int status; /* A RIL_DataCallFailCause, 0 which is PDP_FAIL_NONE if no error */
454 int suggestedRetryTime; /* If status != 0, this fields indicates the suggested retry
455 back-off timer value RIL wants to override the one
456 pre-configured in FW.
457 The unit is miliseconds.
458 The value < 0 means no value is suggested.
459 The value 0 means retry should be done ASAP.
460 The value of INT_MAX(0x7fffffff) means no retry. */
461 int cid; /* Context ID, uniquely identifies this call */
462 int active; /* 0=inactive, 1=active/physical link down, 2=active/physical link up */
463 char * type; /* One of the PDP_type values in TS 27.007 section 10.1.1.
464 For example, "IP", "IPV6", "IPV4V6", or "PPP". If status is
465 PDP_FAIL_ONLY_SINGLE_BEARER_ALLOWED this is the type supported
466 such as "IP" or "IPV6" */
467 char * ifname; /* The network interface name */
468 char * addresses; /* A space-delimited list of addresses with optional "/" prefix length,
469 e.g., "192.0.1.3" or "192.0.1.11/16 2001:db8::1/64".
470 May not be empty, typically 1 IPv4 or 1 IPv6 or
471 one of each. If the prefix length is absent the addresses
472 are assumed to be point to point with IPv4 having a prefix
473 length of 32 and IPv6 128. */
474 char * dnses; /* A space-delimited list of DNS server addresses,
475 e.g., "192.0.1.3" or "192.0.1.11 2001:db8::1".
477 char * gateways; /* A space-delimited list of default gateway addresses,
478 e.g., "192.0.1.3" or "192.0.1.11 2001:db8::1".
479 May be empty in which case the addresses represent point
480 to point connections. */
481 } RIL_Data_Call_Response_v6;
484 int status; /* A RIL_DataCallFailCause, 0 which is PDP_FAIL_NONE if no error */
485 int suggestedRetryTime; /* If status != 0, this fields indicates the suggested retry
486 back-off timer value RIL wants to override the one
487 pre-configured in FW.
488 The unit is miliseconds.
489 The value < 0 means no value is suggested.
490 The value 0 means retry should be done ASAP.
491 The value of INT_MAX(0x7fffffff) means no retry. */
492 int cid; /* Context ID, uniquely identifies this call */
493 int active; /* 0=inactive, 1=active/physical link down, 2=active/physical link up */
494 char * type; /* One of the PDP_type values in TS 27.007 section 10.1.1.
495 For example, "IP", "IPV6", "IPV4V6", or "PPP". If status is
496 PDP_FAIL_ONLY_SINGLE_BEARER_ALLOWED this is the type supported
497 such as "IP" or "IPV6" */
498 char * ifname; /* The network interface name */
499 char * addresses; /* A space-delimited list of addresses with optional "/" prefix length,
500 e.g., "192.0.1.3" or "192.0.1.11/16 2001:db8::1/64".
501 May not be empty, typically 1 IPv4 or 1 IPv6 or
502 one of each. If the prefix length is absent the addresses
503 are assumed to be point to point with IPv4 having a prefix
504 length of 32 and IPv6 128. */
505 char * dnses; /* A space-delimited list of DNS server addresses,
506 e.g., "192.0.1.3" or "192.0.1.11 2001:db8::1".
508 char * gateways; /* A space-delimited list of default gateway addresses,
509 e.g., "192.0.1.3" or "192.0.1.11 2001:db8::1".
510 May be empty in which case the addresses represent point
511 to point connections. */
512 char * pcscf; /* the Proxy Call State Control Function address
513 via PCO(Protocol Configuration Option) for IMS client. */
514 } RIL_Data_Call_Response_v9;
517 int status; /* A RIL_DataCallFailCause, 0 which is PDP_FAIL_NONE if no error */
518 int suggestedRetryTime; /* If status != 0, this fields indicates the suggested retry
519 back-off timer value RIL wants to override the one
520 pre-configured in FW.
521 The unit is miliseconds.
522 The value < 0 means no value is suggested.
523 The value 0 means retry should be done ASAP.
524 The value of INT_MAX(0x7fffffff) means no retry. */
525 int cid; /* Context ID, uniquely identifies this call */
526 int active; /* 0=inactive, 1=active/physical link down, 2=active/physical link up */
527 char * type; /* One of the PDP_type values in TS 27.007 section 10.1.1.
528 For example, "IP", "IPV6", "IPV4V6", or "PPP". If status is
529 PDP_FAIL_ONLY_SINGLE_BEARER_ALLOWED this is the type supported
530 such as "IP" or "IPV6" */
531 char * ifname; /* The network interface name */
532 char * addresses; /* A space-delimited list of addresses with optional "/" prefix length,
533 e.g., "192.0.1.3" or "192.0.1.11/16 2001:db8::1/64".
534 May not be empty, typically 1 IPv4 or 1 IPv6 or
535 one of each. If the prefix length is absent the addresses
536 are assumed to be point to point with IPv4 having a prefix
537 length of 32 and IPv6 128. */
538 char * dnses; /* A space-delimited list of DNS server addresses,
539 e.g., "192.0.1.3" or "192.0.1.11 2001:db8::1".
541 char * gateways; /* A space-delimited list of default gateway addresses,
542 e.g., "192.0.1.3" or "192.0.1.11 2001:db8::1".
543 May be empty in which case the addresses represent point
544 to point connections. */
545 char * pcscf; /* the Proxy Call State Control Function address
546 via PCO(Protocol Configuration Option) for IMS client. */
547 int mtu; /* MTU received from network
548 Value <= 0 means network has either not sent a value or
549 sent an invalid value */
550 } RIL_Data_Call_Response_v11;
553 RADIO_TECH_3GPP = 1, /* 3GPP Technologies - GSM, WCDMA */
554 RADIO_TECH_3GPP2 = 2 /* 3GPP2 Technologies - CDMA */
555 } RIL_RadioTechnologyFamily;
558 RIL_RadioTechnologyFamily tech;
559 unsigned char retry; /* 0 == not retry, nonzero == retry */
560 int messageRef; /* Valid field if retry is set to nonzero.
561 Contains messageRef from RIL_SMS_Response
562 corresponding to failed MO SMS.
566 /* Valid field if tech is RADIO_TECH_3GPP2. See RIL_REQUEST_CDMA_SEND_SMS */
567 RIL_CDMA_SMS_Message* cdmaMessage;
569 /* Valid field if tech is RADIO_TECH_3GPP. See RIL_REQUEST_SEND_SMS */
570 char** gsmMessage; /* This is an array of pointers where pointers
571 are contiguous but elements pointed by those pointers
575 } RIL_IMS_SMS_Message;
578 int messageRef; /* TP-Message-Reference for GSM,
579 and BearerData MessageId for CDMA
580 (See 3GPP2 C.S0015-B, v2.0, table 4.5-1). */
581 char *ackPDU; /* or NULL if n/a */
582 int errorCode; /* See 3GPP 27.005, 3.2.5 for GSM/UMTS,
583 3GPP2 N.S0005 (IS-41C) Table 171 for CDMA,
584 -1 if unknown or not applicable*/
587 /** Used by RIL_REQUEST_WRITE_SMS_TO_SIM */
589 int status; /* Status of message. See TS 27.005 3.1, "<stat>": */
590 /* 0 = "REC UNREAD" */
592 /* 2 = "STO UNSENT" */
594 char * pdu; /* PDU of message to write, as an ASCII hex string less the SMSC address,
595 the TP-layer length is "strlen(pdu)/2". */
596 char * smsc; /* SMSC address in GSM BCD format prefixed by a length byte
597 (as expected by TS 27.005) or NULL for default SMSC */
600 /** Used by RIL_REQUEST_DIAL */
604 /* (same as 'n' paremeter in TS 27.007 7.7 "+CLIR"
605 * clir == 0 on "use subscription default value"
606 * clir == 1 on "CLIR invocation" (restrict CLI presentation)
607 * clir == 2 on "CLIR suppression" (allow CLI presentation)
609 RIL_UUS_Info * uusInfo; /* NULL or Pointer to User-User Signaling Information */
613 int command; /* one of the commands listed for TS 27.007 +CRSM*/
614 int fileid; /* EF id */
615 char *path; /* "pathid" from TS 27.007 +CRSM command.
616 Path is in hex asciii format eg "7f205f70"
617 Path must always be provided.
622 char *data; /* May be NULL*/
623 char *pin2; /* May be NULL*/
627 int command; /* one of the commands listed for TS 27.007 +CRSM*/
628 int fileid; /* EF id */
629 char *path; /* "pathid" from TS 27.007 +CRSM command.
630 Path is in hex asciii format eg "7f205f70"
631 Path must always be provided.
636 char *data; /* May be NULL*/
637 char *pin2; /* May be NULL*/
638 char *aidPtr; /* AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value. */
641 /* Used by RIL_REQUEST_SIM_TRANSMIT_APDU_CHANNEL and
642 * RIL_REQUEST_SIM_TRANSMIT_APDU_BASIC. */
644 int sessionid; /* "sessionid" from TS 27.007 +CGLA command. Should be
645 ignored for +CSIM command. */
647 /* Following fields are used to derive the APDU ("command" and "length"
648 values in TS 27.007 +CSIM and +CGLA commands). */
653 int p3; /* A negative P3 implies a 4 byte APDU. */
654 char *data; /* May be NULL. In hex string format. */
660 char *simResponse; /* In hex string format ([a-fA-F0-9]*), except for SIM_AUTHENTICATION
661 response for which it is in Base64 format, see 3GPP TS 31.102 7.1.2 */
662 } RIL_SIM_IO_Response;
664 /* See also com.android.internal.telephony.gsm.CallForwardInfo */
668 * For RIL_REQUEST_QUERY_CALL_FORWARD_STATUS
669 * status 1 = active, 0 = not active
671 * For RIL_REQUEST_SET_CALL_FORWARD:
680 int reason; /* from TS 27.007 7.11 "reason" */
681 int serviceClass;/* From 27.007 +CCFC/+CLCK "class"
682 See table for Android mapping from
684 0 means user doesn't input class */
685 int toa; /* "type" from TS 27.007 7.11 */
686 char * number; /* "number" from TS 27.007 7.11. May be NULL */
687 int timeSeconds; /* for CF no reply only */
688 }RIL_CallForwardInfo;
691 char * cid; /* Combination of LAC and Cell Id in 32 bits in GSM.
692 * Upper 16 bits is LAC and lower 16 bits
693 * is CID (as described in TS 27.005)
694 * Primary Scrambling Code (as described in TS 25.331)
696 * Valid values are hexadecimal 0x0000 - 0xffffffff.
698 int rssi; /* Received RSSI in GSM,
699 * Level index of CPICH Received Signal Code Power in UMTS
701 } RIL_NeighboringCell;
704 char lce_status; /* LCE service status:
705 * -1 = not supported;
709 unsigned int actual_interval_ms; /* actual LCE reporting interval,
710 * meaningful only if LCEStatus = 1.
715 unsigned int last_hop_capacity_kbps; /* last-hop cellular capacity: kilobits/second. */
716 unsigned char confidence_level; /* capacity estimate confidence: 0-100 */
717 unsigned char lce_suspended; /* LCE report going to be suspended? (e.g., radio
718 * moves to inactive state or network type change)
725 RIL_MATCH_ALL = 0, /* Apply to all carriers with the same mcc/mnc */
726 RIL_MATCH_SPN = 1, /* Use SPN and mcc/mnc to identify the carrier */
727 RIL_MATCH_IMSI_PREFIX = 2, /* Use IMSI prefix and mcc/mnc to identify the carrier */
728 RIL_MATCH_GID1 = 3, /* Use GID1 and mcc/mnc to identify the carrier */
729 RIL_MATCH_GID2 = 4, /* Use GID2 and mcc/mnc to identify the carrier */
730 } RIL_CarrierMatchType;
735 RIL_CarrierMatchType match_type; /* Specify match type for the carrier.
736 * If it’s RIL_MATCH_ALL, match_data is null;
737 * otherwise, match_data is the value for the match type.
739 const char * match_data;
743 int32_t len_allowed_carriers; /* length of array allowed_carriers */
744 int32_t len_excluded_carriers; /* length of array excluded_carriers */
745 RIL_Carrier * allowed_carriers; /* whitelist for allowed carriers */
746 RIL_Carrier * excluded_carriers; /* blacklist for explicitly excluded carriers
747 * which match allowed_carriers. Eg. allowed_carriers match
748 * mcc/mnc, excluded_carriers has same mcc/mnc and gid1
749 * is ABCD. It means except the carrier whose gid1 is ABCD,
750 * all carriers with the same mcc/mnc are allowed.
752 } RIL_CarrierRestrictions;
755 char * mcc; /* MCC of the Carrier. */
756 char * mnc ; /* MNC of the Carrier. */
757 uint8_t * carrierKey; /* Public Key from the Carrier used to encrypt the
760 int32_t carrierKeyLength; /* Length of the Public Key. */
761 char * keyIdentifier; /* The keyIdentifier Attribute value pair that helps
762 * a server locate the private key to decrypt the
763 * permanent identity.
765 int64_t expirationTime; /* Date-Time (in UTC) when the key will expire. */
767 } RIL_CarrierInfoForImsiEncryption;
769 /* See RIL_REQUEST_LAST_CALL_FAIL_CAUSE */
771 CALL_FAIL_UNOBTAINABLE_NUMBER = 1,
772 CALL_FAIL_NO_ROUTE_TO_DESTINATION = 3,
773 CALL_FAIL_CHANNEL_UNACCEPTABLE = 6,
774 CALL_FAIL_OPERATOR_DETERMINED_BARRING = 8,
775 CALL_FAIL_NORMAL = 16,
777 CALL_FAIL_NO_USER_RESPONDING = 18,
778 CALL_FAIL_NO_ANSWER_FROM_USER = 19,
779 CALL_FAIL_CALL_REJECTED = 21,
780 CALL_FAIL_NUMBER_CHANGED = 22,
781 CALL_FAIL_PREEMPTION = 25,
782 CALL_FAIL_DESTINATION_OUT_OF_ORDER = 27,
783 CALL_FAIL_INVALID_NUMBER_FORMAT = 28,
784 CALL_FAIL_FACILITY_REJECTED = 29,
785 CALL_FAIL_RESP_TO_STATUS_ENQUIRY = 30,
786 CALL_FAIL_NORMAL_UNSPECIFIED = 31,
787 CALL_FAIL_CONGESTION = 34,
788 CALL_FAIL_NETWORK_OUT_OF_ORDER = 38,
789 CALL_FAIL_TEMPORARY_FAILURE = 41,
790 CALL_FAIL_SWITCHING_EQUIPMENT_CONGESTION = 42,
791 CALL_FAIL_ACCESS_INFORMATION_DISCARDED = 43,
792 CALL_FAIL_REQUESTED_CIRCUIT_OR_CHANNEL_NOT_AVAILABLE = 44,
793 CALL_FAIL_RESOURCES_UNAVAILABLE_OR_UNSPECIFIED = 47,
794 CALL_FAIL_QOS_UNAVAILABLE = 49,
795 CALL_FAIL_REQUESTED_FACILITY_NOT_SUBSCRIBED = 50,
796 CALL_FAIL_INCOMING_CALLS_BARRED_WITHIN_CUG = 55,
797 CALL_FAIL_BEARER_CAPABILITY_NOT_AUTHORIZED = 57,
798 CALL_FAIL_BEARER_CAPABILITY_UNAVAILABLE = 58,
799 CALL_FAIL_SERVICE_OPTION_NOT_AVAILABLE = 63,
800 CALL_FAIL_BEARER_SERVICE_NOT_IMPLEMENTED = 65,
801 CALL_FAIL_ACM_LIMIT_EXCEEDED = 68,
802 CALL_FAIL_REQUESTED_FACILITY_NOT_IMPLEMENTED = 69,
803 CALL_FAIL_ONLY_DIGITAL_INFORMATION_BEARER_AVAILABLE = 70,
804 CALL_FAIL_SERVICE_OR_OPTION_NOT_IMPLEMENTED = 79,
805 CALL_FAIL_INVALID_TRANSACTION_IDENTIFIER = 81,
806 CALL_FAIL_USER_NOT_MEMBER_OF_CUG = 87,
807 CALL_FAIL_INCOMPATIBLE_DESTINATION = 88,
808 CALL_FAIL_INVALID_TRANSIT_NW_SELECTION = 91,
809 CALL_FAIL_SEMANTICALLY_INCORRECT_MESSAGE = 95,
810 CALL_FAIL_INVALID_MANDATORY_INFORMATION = 96,
811 CALL_FAIL_MESSAGE_TYPE_NON_IMPLEMENTED = 97,
812 CALL_FAIL_MESSAGE_TYPE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE = 98,
813 CALL_FAIL_INFORMATION_ELEMENT_NON_EXISTENT = 99,
814 CALL_FAIL_CONDITIONAL_IE_ERROR = 100,
815 CALL_FAIL_MESSAGE_NOT_COMPATIBLE_WITH_PROTOCOL_STATE = 101,
816 CALL_FAIL_RECOVERY_ON_TIMER_EXPIRED = 102,
817 CALL_FAIL_PROTOCOL_ERROR_UNSPECIFIED = 111,
818 CALL_FAIL_INTERWORKING_UNSPECIFIED = 127,
819 CALL_FAIL_CALL_BARRED = 240,
820 CALL_FAIL_FDN_BLOCKED = 241,
821 CALL_FAIL_IMSI_UNKNOWN_IN_VLR = 242,
822 CALL_FAIL_IMEI_NOT_ACCEPTED = 243,
823 CALL_FAIL_DIAL_MODIFIED_TO_USSD = 244, /* STK Call Control */
824 CALL_FAIL_DIAL_MODIFIED_TO_SS = 245,
825 CALL_FAIL_DIAL_MODIFIED_TO_DIAL = 246,
826 CALL_FAIL_RADIO_OFF = 247, /* Radio is OFF */
827 CALL_FAIL_OUT_OF_SERVICE = 248, /* No cellular coverage */
828 CALL_FAIL_NO_VALID_SIM = 249, /* No valid SIM is present */
829 CALL_FAIL_RADIO_INTERNAL_ERROR = 250, /* Internal error at Modem */
830 CALL_FAIL_NETWORK_RESP_TIMEOUT = 251, /* No response from network */
831 CALL_FAIL_NETWORK_REJECT = 252, /* Explicit network reject */
832 CALL_FAIL_RADIO_ACCESS_FAILURE = 253, /* RRC connection failure. Eg.RACH */
833 CALL_FAIL_RADIO_LINK_FAILURE = 254, /* Radio Link Failure */
834 CALL_FAIL_RADIO_LINK_LOST = 255, /* Radio link lost due to poor coverage */
835 CALL_FAIL_RADIO_UPLINK_FAILURE = 256, /* Radio uplink failure */
836 CALL_FAIL_RADIO_SETUP_FAILURE = 257, /* RRC connection setup failure */
837 CALL_FAIL_RADIO_RELEASE_NORMAL = 258, /* RRC connection release, normal */
838 CALL_FAIL_RADIO_RELEASE_ABNORMAL = 259, /* RRC connection release, abnormal */
839 CALL_FAIL_ACCESS_CLASS_BLOCKED = 260, /* Access class barring */
840 CALL_FAIL_NETWORK_DETACH = 261, /* Explicit network detach */
841 CALL_FAIL_CDMA_LOCKED_UNTIL_POWER_CYCLE = 1000,
842 CALL_FAIL_CDMA_DROP = 1001,
843 CALL_FAIL_CDMA_INTERCEPT = 1002,
844 CALL_FAIL_CDMA_REORDER = 1003,
845 CALL_FAIL_CDMA_SO_REJECT = 1004,
846 CALL_FAIL_CDMA_RETRY_ORDER = 1005,
847 CALL_FAIL_CDMA_ACCESS_FAILURE = 1006,
848 CALL_FAIL_CDMA_PREEMPTED = 1007,
849 CALL_FAIL_CDMA_NOT_EMERGENCY = 1008, /* For non-emergency number dialed
850 during emergency callback mode */
851 CALL_FAIL_CDMA_ACCESS_BLOCKED = 1009, /* CDMA network access probes blocked */
853 /* OEM specific error codes. Used to distinguish error from
854 * CALL_FAIL_ERROR_UNSPECIFIED and help assist debugging */
855 CALL_FAIL_OEM_CAUSE_1 = 0xf001,
856 CALL_FAIL_OEM_CAUSE_2 = 0xf002,
857 CALL_FAIL_OEM_CAUSE_3 = 0xf003,
858 CALL_FAIL_OEM_CAUSE_4 = 0xf004,
859 CALL_FAIL_OEM_CAUSE_5 = 0xf005,
860 CALL_FAIL_OEM_CAUSE_6 = 0xf006,
861 CALL_FAIL_OEM_CAUSE_7 = 0xf007,
862 CALL_FAIL_OEM_CAUSE_8 = 0xf008,
863 CALL_FAIL_OEM_CAUSE_9 = 0xf009,
864 CALL_FAIL_OEM_CAUSE_10 = 0xf00a,
865 CALL_FAIL_OEM_CAUSE_11 = 0xf00b,
866 CALL_FAIL_OEM_CAUSE_12 = 0xf00c,
867 CALL_FAIL_OEM_CAUSE_13 = 0xf00d,
868 CALL_FAIL_OEM_CAUSE_14 = 0xf00e,
869 CALL_FAIL_OEM_CAUSE_15 = 0xf00f,
871 CALL_FAIL_ERROR_UNSPECIFIED = 0xffff /* This error will be deprecated soon,
872 vendor code should make sure to map error
873 code to specific error */
874 } RIL_LastCallFailCause;
877 RIL_LastCallFailCause cause_code;
879 } RIL_LastCallFailCauseInfo;
881 /* See RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE */
883 PDP_FAIL_NONE = 0, /* No error, connection ok */
885 /* an integer cause code defined in TS 24.008
886 section 6.1.3.1.3 or TS 24.301 Release 8+ Annex B.
887 If the implementation does not have access to the exact cause codes,
888 then it should return one of the following values,
889 as the UI layer needs to distinguish these
890 cases for error notification and potential retries. */
891 PDP_FAIL_OPERATOR_BARRED = 0x08, /* no retry */
892 PDP_FAIL_NAS_SIGNALLING = 0x0E,
893 PDP_FAIL_LLC_SNDCP = 0x19,
894 PDP_FAIL_INSUFFICIENT_RESOURCES = 0x1A,
895 PDP_FAIL_MISSING_UKNOWN_APN = 0x1B, /* no retry */
896 PDP_FAIL_UNKNOWN_PDP_ADDRESS_TYPE = 0x1C, /* no retry */
897 PDP_FAIL_USER_AUTHENTICATION = 0x1D, /* no retry */
898 PDP_FAIL_ACTIVATION_REJECT_GGSN = 0x1E, /* no retry */
899 PDP_FAIL_ACTIVATION_REJECT_UNSPECIFIED = 0x1F,
900 PDP_FAIL_SERVICE_OPTION_NOT_SUPPORTED = 0x20, /* no retry */
901 PDP_FAIL_SERVICE_OPTION_NOT_SUBSCRIBED = 0x21, /* no retry */
902 PDP_FAIL_SERVICE_OPTION_OUT_OF_ORDER = 0x22,
903 PDP_FAIL_NSAPI_IN_USE = 0x23, /* no retry */
904 PDP_FAIL_REGULAR_DEACTIVATION = 0x24, /* possibly restart radio,
905 based on framework config */
906 PDP_FAIL_QOS_NOT_ACCEPTED = 0x25,
907 PDP_FAIL_NETWORK_FAILURE = 0x26,
908 PDP_FAIL_UMTS_REACTIVATION_REQ = 0x27,
909 PDP_FAIL_FEATURE_NOT_SUPP = 0x28,
910 PDP_FAIL_TFT_SEMANTIC_ERROR = 0x29,
911 PDP_FAIL_TFT_SYTAX_ERROR = 0x2A,
912 PDP_FAIL_UNKNOWN_PDP_CONTEXT = 0x2B,
913 PDP_FAIL_FILTER_SEMANTIC_ERROR = 0x2C,
914 PDP_FAIL_FILTER_SYTAX_ERROR = 0x2D,
915 PDP_FAIL_PDP_WITHOUT_ACTIVE_TFT = 0x2E,
916 PDP_FAIL_ONLY_IPV4_ALLOWED = 0x32, /* no retry */
917 PDP_FAIL_ONLY_IPV6_ALLOWED = 0x33, /* no retry */
918 PDP_FAIL_ONLY_SINGLE_BEARER_ALLOWED = 0x34,
919 PDP_FAIL_ESM_INFO_NOT_RECEIVED = 0x35,
920 PDP_FAIL_PDN_CONN_DOES_NOT_EXIST = 0x36,
921 PDP_FAIL_MULTI_CONN_TO_SAME_PDN_NOT_ALLOWED = 0x37,
922 PDP_FAIL_MAX_ACTIVE_PDP_CONTEXT_REACHED = 0x41,
923 PDP_FAIL_UNSUPPORTED_APN_IN_CURRENT_PLMN = 0x42,
924 PDP_FAIL_INVALID_TRANSACTION_ID = 0x51,
925 PDP_FAIL_MESSAGE_INCORRECT_SEMANTIC = 0x5F,
926 PDP_FAIL_INVALID_MANDATORY_INFO = 0x60,
927 PDP_FAIL_MESSAGE_TYPE_UNSUPPORTED = 0x61,
928 PDP_FAIL_MSG_TYPE_NONCOMPATIBLE_STATE = 0x62,
929 PDP_FAIL_UNKNOWN_INFO_ELEMENT = 0x63,
930 PDP_FAIL_CONDITIONAL_IE_ERROR = 0x64,
931 PDP_FAIL_MSG_AND_PROTOCOL_STATE_UNCOMPATIBLE = 0x65,
932 PDP_FAIL_PROTOCOL_ERRORS = 0x6F, /* no retry */
933 PDP_FAIL_APN_TYPE_CONFLICT = 0x70,
934 PDP_FAIL_INVALID_PCSCF_ADDR = 0x71,
935 PDP_FAIL_INTERNAL_CALL_PREEMPT_BY_HIGH_PRIO_APN = 0x72,
936 PDP_FAIL_EMM_ACCESS_BARRED = 0x73,
937 PDP_FAIL_EMERGENCY_IFACE_ONLY = 0x74,
938 PDP_FAIL_IFACE_MISMATCH = 0x75,
939 PDP_FAIL_COMPANION_IFACE_IN_USE = 0x76,
940 PDP_FAIL_IP_ADDRESS_MISMATCH = 0x77,
941 PDP_FAIL_IFACE_AND_POL_FAMILY_MISMATCH = 0x78,
942 PDP_FAIL_EMM_ACCESS_BARRED_INFINITE_RETRY = 0x79,
943 PDP_FAIL_AUTH_FAILURE_ON_EMERGENCY_CALL = 0x7A,
945 // OEM specific error codes. To be used by OEMs when they don't want to
946 // reveal error code which would be replaced by PDP_FAIL_ERROR_UNSPECIFIED
947 PDP_FAIL_OEM_DCFAILCAUSE_1 = 0x1001,
948 PDP_FAIL_OEM_DCFAILCAUSE_2 = 0x1002,
949 PDP_FAIL_OEM_DCFAILCAUSE_3 = 0x1003,
950 PDP_FAIL_OEM_DCFAILCAUSE_4 = 0x1004,
951 PDP_FAIL_OEM_DCFAILCAUSE_5 = 0x1005,
952 PDP_FAIL_OEM_DCFAILCAUSE_6 = 0x1006,
953 PDP_FAIL_OEM_DCFAILCAUSE_7 = 0x1007,
954 PDP_FAIL_OEM_DCFAILCAUSE_8 = 0x1008,
955 PDP_FAIL_OEM_DCFAILCAUSE_9 = 0x1009,
956 PDP_FAIL_OEM_DCFAILCAUSE_10 = 0x100A,
957 PDP_FAIL_OEM_DCFAILCAUSE_11 = 0x100B,
958 PDP_FAIL_OEM_DCFAILCAUSE_12 = 0x100C,
959 PDP_FAIL_OEM_DCFAILCAUSE_13 = 0x100D,
960 PDP_FAIL_OEM_DCFAILCAUSE_14 = 0x100E,
961 PDP_FAIL_OEM_DCFAILCAUSE_15 = 0x100F,
963 /* Not mentioned in the specification */
964 PDP_FAIL_VOICE_REGISTRATION_FAIL = -1,
965 PDP_FAIL_DATA_REGISTRATION_FAIL = -2,
967 /* reasons for data call drop - network/modem disconnect */
968 PDP_FAIL_SIGNAL_LOST = -3,
969 PDP_FAIL_PREF_RADIO_TECH_CHANGED = -4,/* preferred technology has changed, should retry
970 with parameters appropriate for new technology */
971 PDP_FAIL_RADIO_POWER_OFF = -5, /* data call was disconnected because radio was resetting,
972 powered off - no retry */
973 PDP_FAIL_TETHERED_CALL_ACTIVE = -6, /* data call was disconnected by modem because tethered
974 mode was up on same APN/data profile - no retry until
975 tethered call is off */
977 PDP_FAIL_ERROR_UNSPECIFIED = 0xffff, /* retry silently. Will be deprecated soon as
978 new error codes are added making this unnecessary */
979 } RIL_DataCallFailCause;
981 /* See RIL_REQUEST_SETUP_DATA_CALL */
983 RIL_DATA_PROFILE_DEFAULT = 0,
984 RIL_DATA_PROFILE_TETHERED = 1,
985 RIL_DATA_PROFILE_IMS = 2,
986 RIL_DATA_PROFILE_FOTA = 3,
987 RIL_DATA_PROFILE_CBS = 4,
988 RIL_DATA_PROFILE_OEM_BASE = 1000, /* Start of OEM-specific profiles */
989 RIL_DATA_PROFILE_INVALID = 0xFFFFFFFF
992 /* Used by RIL_UNSOL_SUPP_SVC_NOTIFICATION */
994 int notificationType; /*
995 * 0 = MO intermediate result code
996 * 1 = MT unsolicited result code
998 int code; /* See 27.007 7.17
1001 int index; /* CUG index. See 27.007 7.17. */
1002 int type; /* "type" from 27.007 7.17 (MT only). */
1003 char * number; /* "number" from 27.007 7.17
1004 (MT only, may be NULL). */
1005 } RIL_SuppSvcNotification;
1007 #define RIL_CARD_MAX_APPS 8
1010 RIL_CARDSTATE_ABSENT = 0,
1011 RIL_CARDSTATE_PRESENT = 1,
1012 RIL_CARDSTATE_ERROR = 2,
1013 RIL_CARDSTATE_RESTRICTED = 3 /* card is present but not usable due to carrier restrictions.*/
1017 RIL_PERSOSUBSTATE_UNKNOWN = 0, /* initial state */
1018 RIL_PERSOSUBSTATE_IN_PROGRESS = 1, /* in between each lock transition */
1019 RIL_PERSOSUBSTATE_READY = 2, /* when either SIM or RUIM Perso is finished
1020 since each app can only have 1 active perso
1022 RIL_PERSOSUBSTATE_SIM_NETWORK = 3,
1023 RIL_PERSOSUBSTATE_SIM_NETWORK_SUBSET = 4,
1024 RIL_PERSOSUBSTATE_SIM_CORPORATE = 5,
1025 RIL_PERSOSUBSTATE_SIM_SERVICE_PROVIDER = 6,
1026 RIL_PERSOSUBSTATE_SIM_SIM = 7,
1027 RIL_PERSOSUBSTATE_SIM_NETWORK_PUK = 8, /* The corresponding perso lock is blocked */
1028 RIL_PERSOSUBSTATE_SIM_NETWORK_SUBSET_PUK = 9,
1029 RIL_PERSOSUBSTATE_SIM_CORPORATE_PUK = 10,
1030 RIL_PERSOSUBSTATE_SIM_SERVICE_PROVIDER_PUK = 11,
1031 RIL_PERSOSUBSTATE_SIM_SIM_PUK = 12,
1032 RIL_PERSOSUBSTATE_RUIM_NETWORK1 = 13,
1033 RIL_PERSOSUBSTATE_RUIM_NETWORK2 = 14,
1034 RIL_PERSOSUBSTATE_RUIM_HRPD = 15,
1035 RIL_PERSOSUBSTATE_RUIM_CORPORATE = 16,
1036 RIL_PERSOSUBSTATE_RUIM_SERVICE_PROVIDER = 17,
1037 RIL_PERSOSUBSTATE_RUIM_RUIM = 18,
1038 RIL_PERSOSUBSTATE_RUIM_NETWORK1_PUK = 19, /* The corresponding perso lock is blocked */
1039 RIL_PERSOSUBSTATE_RUIM_NETWORK2_PUK = 20,
1040 RIL_PERSOSUBSTATE_RUIM_HRPD_PUK = 21,
1041 RIL_PERSOSUBSTATE_RUIM_CORPORATE_PUK = 22,
1042 RIL_PERSOSUBSTATE_RUIM_SERVICE_PROVIDER_PUK = 23,
1043 RIL_PERSOSUBSTATE_RUIM_RUIM_PUK = 24
1044 } RIL_PersoSubstate;
1047 RIL_APPSTATE_UNKNOWN = 0,
1048 RIL_APPSTATE_DETECTED = 1,
1049 RIL_APPSTATE_PIN = 2, /* If PIN1 or UPin is required */
1050 RIL_APPSTATE_PUK = 3, /* If PUK1 or Puk for UPin is required */
1051 RIL_APPSTATE_SUBSCRIPTION_PERSO = 4, /* perso_substate should be look at
1052 when app_state is assigned to this value */
1053 RIL_APPSTATE_READY = 5
1057 RIL_PINSTATE_UNKNOWN = 0,
1058 RIL_PINSTATE_ENABLED_NOT_VERIFIED = 1,
1059 RIL_PINSTATE_ENABLED_VERIFIED = 2,
1060 RIL_PINSTATE_DISABLED = 3,
1061 RIL_PINSTATE_ENABLED_BLOCKED = 4,
1062 RIL_PINSTATE_ENABLED_PERM_BLOCKED = 5
1066 RIL_APPTYPE_UNKNOWN = 0,
1067 RIL_APPTYPE_SIM = 1,
1068 RIL_APPTYPE_USIM = 2,
1069 RIL_APPTYPE_RUIM = 3,
1070 RIL_APPTYPE_CSIM = 4,
1071 RIL_APPTYPE_ISIM = 5
1075 * Please note that registration state UNKNOWN is
1076 * treated as "out of service" in the Android telephony.
1077 * Registration state REG_DENIED must be returned if Location Update
1078 * Reject (with cause 17 - Network Failure) is received
1079 * repeatedly from the network, to facilitate
1083 RIL_NOT_REG_AND_NOT_SEARCHING = 0, // Not registered, MT is not currently searching
1084 // a new operator to register
1085 RIL_REG_HOME = 1, // Registered, home network
1086 RIL_NOT_REG_AND_SEARCHING = 2, // Not registered, but MT is currently searching
1087 // a new operator to register
1088 RIL_REG_DENIED = 3, // Registration denied
1089 RIL_UNKNOWN = 4, // Unknown
1090 RIL_REG_ROAMING = 5, // Registered, roaming
1091 RIL_NOT_REG_AND_EMERGENCY_AVAILABLE_AND_NOT_SEARCHING = 10, // Same as
1092 // RIL_NOT_REG_AND_NOT_SEARCHING but indicates that
1093 // emergency calls are enabled.
1094 RIL_NOT_REG_AND_EMERGENCY_AVAILABLE_AND_SEARCHING = 12, // Same as RIL_NOT_REG_AND_SEARCHING
1095 // but indicates that
1096 // emergency calls are enabled.
1097 RIL_REG_DENIED_AND_EMERGENCY_AVAILABLE = 13, // Same as REG_DENIED but indicates that
1098 // emergency calls are enabled.
1099 RIL_UNKNOWN_AND_EMERGENCY_AVAILABLE = 14, // Same as UNKNOWN but indicates that
1100 // emergency calls are enabled.
1105 RIL_AppType app_type;
1106 RIL_AppState app_state;
1107 RIL_PersoSubstate perso_substate; /* applicable only if app_state ==
1108 RIL_APPSTATE_SUBSCRIPTION_PERSO */
1109 char *aid_ptr; /* null terminated string, e.g., from 0xA0, 0x00 -> 0x41,
1111 char *app_label_ptr; /* null terminated string */
1112 int pin1_replaced; /* applicable to USIM, CSIM & ISIM */
1117 /* Deprecated, use RIL_CardStatus_v6 */
1120 RIL_CardState card_state;
1121 RIL_PinState universal_pin_state; /* applicable to USIM and CSIM: RIL_PINSTATE_xxx */
1122 int gsm_umts_subscription_app_index; /* value < RIL_CARD_MAX_APPS, -1 if none */
1123 int cdma_subscription_app_index; /* value < RIL_CARD_MAX_APPS, -1 if none */
1124 int num_applications; /* value <= RIL_CARD_MAX_APPS */
1125 RIL_AppStatus applications[RIL_CARD_MAX_APPS];
1126 } RIL_CardStatus_v5;
1130 RIL_CardState card_state;
1131 RIL_PinState universal_pin_state; /* applicable to USIM and CSIM: RIL_PINSTATE_xxx */
1132 int gsm_umts_subscription_app_index; /* value < RIL_CARD_MAX_APPS, -1 if none */
1133 int cdma_subscription_app_index; /* value < RIL_CARD_MAX_APPS, -1 if none */
1134 int ims_subscription_app_index; /* value < RIL_CARD_MAX_APPS, -1 if none */
1135 int num_applications; /* value <= RIL_CARD_MAX_APPS */
1136 RIL_AppStatus applications[RIL_CARD_MAX_APPS];
1137 } RIL_CardStatus_v6;
1139 /** The result of a SIM refresh, returned in data[0] of RIL_UNSOL_SIM_REFRESH
1140 * or as part of RIL_SimRefreshResponse_v7
1143 /* A file on SIM has been updated. data[1] contains the EFID. */
1144 SIM_FILE_UPDATE = 0,
1145 /* SIM initialized. All files should be re-read. */
1147 /* SIM reset. SIM power required, SIM may be locked and all files should be re-read. */
1149 } RIL_SimRefreshResult;
1152 RIL_SimRefreshResult result;
1153 int ef_id; /* is the EFID of the updated file if the result is */
1154 /* SIM_FILE_UPDATE or 0 for any other result. */
1155 char * aid; /* is AID(application ID) of the card application */
1156 /* See ETSI 102.221 8.1 and 101.220 4 */
1157 /* For SIM_FILE_UPDATE result it can be set to AID of */
1158 /* application in which updated EF resides or it can be */
1159 /* NULL if EF is outside of an application. */
1160 /* For SIM_INIT result this field is set to AID of */
1161 /* application that caused REFRESH */
1162 /* For SIM_RESET result it is NULL. */
1163 } RIL_SimRefreshResponse_v7;
1165 /* Deprecated, use RIL_CDMA_CallWaiting_v6 */
1167 char * number; /* Remote party number */
1168 int numberPresentation; /* 0=Allowed, 1=Restricted, 2=Not Specified/Unknown */
1169 char * name; /* Remote party name */
1170 RIL_CDMA_SignalInfoRecord signalInfoRecord;
1171 } RIL_CDMA_CallWaiting_v5;
1174 char * number; /* Remote party number */
1175 int numberPresentation; /* 0=Allowed, 1=Restricted, 2=Not Specified/Unknown */
1176 char * name; /* Remote party name */
1177 RIL_CDMA_SignalInfoRecord signalInfoRecord;
1178 /* Number type/Number plan required to support International Call Waiting */
1179 int number_type; /* 0=Unknown, 1=International, 2=National,
1180 3=Network specific, 4=subscriber */
1181 int number_plan; /* 0=Unknown, 1=ISDN, 3=Data, 4=Telex, 8=Nat'l, 9=Private */
1182 } RIL_CDMA_CallWaiting_v6;
1185 * Which types of Cell Broadcast Message (CBM) are to be received by the ME
1187 * uFromServiceID - uToServiceID defines a range of CBM message identifiers
1188 * whose value is 0x0000 - 0xFFFF as defined in TS 23.041 9.4.1.2.2 for GMS
1189 * and 9.4.4.2.2 for UMTS. All other values can be treated as empty
1192 * uFromCodeScheme - uToCodeScheme defines a range of CBM data coding schemes
1193 * whose value is 0x00 - 0xFF as defined in TS 23.041 9.4.1.2.3 for GMS
1194 * and 9.4.4.2.3 for UMTS.
1195 * All other values can be treated as empty CBM data coding scheme.
1197 * selected 0 means message types specified in <fromServiceId, toServiceId>
1198 * and <fromCodeScheme, toCodeScheme>are not accepted, while 1 means accepted.
1200 * Used by RIL_REQUEST_GSM_GET_BROADCAST_CONFIG and
1201 * RIL_REQUEST_GSM_SET_BROADCAST_CONFIG.
1208 unsigned char selected;
1209 } RIL_GSM_BroadcastSmsConfigInfo;
1211 /* No restriction at all including voice/SMS/USSD/SS/AV64 and packet data. */
1212 #define RIL_RESTRICTED_STATE_NONE 0x00
1213 /* Block emergency call due to restriction. But allow all normal voice/SMS/USSD/SS/AV64. */
1214 #define RIL_RESTRICTED_STATE_CS_EMERGENCY 0x01
1215 /* Block all normal voice/SMS/USSD/SS/AV64 due to restriction. Only Emergency call allowed. */
1216 #define RIL_RESTRICTED_STATE_CS_NORMAL 0x02
1217 /* Block all voice/SMS/USSD/SS/AV64 including emergency call due to restriction.*/
1218 #define RIL_RESTRICTED_STATE_CS_ALL 0x04
1219 /* Block packet data access due to restriction. */
1220 #define RIL_RESTRICTED_STATE_PS_ALL 0x10
1222 /* The status for an OTASP/OTAPA session */
1224 CDMA_OTA_PROVISION_STATUS_SPL_UNLOCKED,
1225 CDMA_OTA_PROVISION_STATUS_SPC_RETRIES_EXCEEDED,
1226 CDMA_OTA_PROVISION_STATUS_A_KEY_EXCHANGED,
1227 CDMA_OTA_PROVISION_STATUS_SSD_UPDATED,
1228 CDMA_OTA_PROVISION_STATUS_NAM_DOWNLOADED,
1229 CDMA_OTA_PROVISION_STATUS_MDN_DOWNLOADED,
1230 CDMA_OTA_PROVISION_STATUS_IMSI_DOWNLOADED,
1231 CDMA_OTA_PROVISION_STATUS_PRL_DOWNLOADED,
1232 CDMA_OTA_PROVISION_STATUS_COMMITTED,
1233 CDMA_OTA_PROVISION_STATUS_OTAPA_STARTED,
1234 CDMA_OTA_PROVISION_STATUS_OTAPA_STOPPED,
1235 CDMA_OTA_PROVISION_STATUS_OTAPA_ABORTED
1236 } RIL_CDMA_OTA_ProvisionStatus;
1239 int signalStrength; /* Valid values are (0-31, 99) as defined in TS 27.007 8.5 */
1240 int bitErrorRate; /* bit error rate (0-7, 99) as defined in TS 27.007 8.5 */
1241 } RIL_GW_SignalStrength;
1244 int signalStrength; /* Valid values are (0-31, 99) as defined in TS 27.007 8.5 */
1245 int bitErrorRate; /* bit error rate (0-7, 99) as defined in TS 27.007 8.5 */
1246 int timingAdvance; /* Timing Advance in bit periods. 1 bit period = 48/13 us.
1247 * INT_MAX denotes invalid value */
1248 } RIL_GSM_SignalStrength_v12;
1251 int signalStrength; /* Valid values are (0-31, 99) as defined in TS 27.007 8.5 */
1252 int bitErrorRate; /* bit error rate (0-7, 99) as defined in TS 27.007 8.5 */
1253 } RIL_SignalStrengthWcdma;
1256 int dbm; /* Valid values are positive integers. This value is the actual RSSI value
1257 * multiplied by -1. Example: If the actual RSSI is -75, then this response
1260 int ecio; /* Valid values are positive integers. This value is the actual Ec/Io multiplied
1261 * by -10. Example: If the actual Ec/Io is -12.5 dB, then this response value
1264 } RIL_CDMA_SignalStrength;
1268 int dbm; /* Valid values are positive integers. This value is the actual RSSI value
1269 * multiplied by -1. Example: If the actual RSSI is -75, then this response
1272 int ecio; /* Valid values are positive integers. This value is the actual Ec/Io multiplied
1273 * by -10. Example: If the actual Ec/Io is -12.5 dB, then this response value
1276 int signalNoiseRatio; /* Valid values are 0-8. 8 is the highest signal to noise ratio. */
1277 } RIL_EVDO_SignalStrength;
1280 int signalStrength; /* Valid values are (0-31, 99) as defined in TS 27.007 8.5 */
1281 int rsrp; /* The current Reference Signal Receive Power in dBm multipled by -1.
1282 * Range: 44 to 140 dBm
1283 * INT_MAX: 0x7FFFFFFF denotes invalid value.
1284 * Reference: 3GPP TS 36.133 9.1.4 */
1285 int rsrq; /* The current Reference Signal Receive Quality in dB multiplied by -1.
1286 * Range: 20 to 3 dB.
1287 * INT_MAX: 0x7FFFFFFF denotes invalid value.
1288 * Reference: 3GPP TS 36.133 9.1.7 */
1289 int rssnr; /* The current reference signal signal-to-noise ratio in 0.1 dB units.
1290 * Range: -200 to +300 (-200 = -20.0 dB, +300 = 30dB).
1291 * INT_MAX : 0x7FFFFFFF denotes invalid value.
1292 * Reference: 3GPP TS 36.101 8.1.1 */
1293 int cqi; /* The current Channel Quality Indicator.
1295 * INT_MAX : 0x7FFFFFFF denotes invalid value.
1296 * Reference: 3GPP TS 36.101 9.2, 9.3, A.4 */
1297 } RIL_LTE_SignalStrength;
1300 int signalStrength; /* Valid values are (0-31, 99) as defined in TS 27.007 8.5 */
1301 int rsrp; /* The current Reference Signal Receive Power in dBm multipled by -1.
1302 * Range: 44 to 140 dBm
1303 * INT_MAX: 0x7FFFFFFF denotes invalid value.
1304 * Reference: 3GPP TS 36.133 9.1.4 */
1305 int rsrq; /* The current Reference Signal Receive Quality in dB multiplied by -1.
1306 * Range: 20 to 3 dB.
1307 * INT_MAX: 0x7FFFFFFF denotes invalid value.
1308 * Reference: 3GPP TS 36.133 9.1.7 */
1309 int rssnr; /* The current reference signal signal-to-noise ratio in 0.1 dB units.
1310 * Range: -200 to +300 (-200 = -20.0 dB, +300 = 30dB).
1311 * INT_MAX : 0x7FFFFFFF denotes invalid value.
1312 * Reference: 3GPP TS 36.101 8.1.1 */
1313 int cqi; /* The current Channel Quality Indicator.
1315 * INT_MAX : 0x7FFFFFFF denotes invalid value.
1316 * Reference: 3GPP TS 36.101 9.2, 9.3, A.4 */
1317 int timingAdvance; /* timing advance in micro seconds for a one way trip from cell to device.
1318 * Approximate distance can be calculated using 300m/us * timingAdvance.
1319 * Range: 0 to 0x7FFFFFFE
1320 * INT_MAX : 0x7FFFFFFF denotes invalid value.
1321 * Reference: 3GPP 36.321 section 6.1.3.5
1322 * also: http://www.cellular-planningoptimization.com/2010/02/timing-advance-with-calculation.html */
1323 } RIL_LTE_SignalStrength_v8;
1326 int rscp; /* The Received Signal Code Power in dBm multipled by -1.
1328 * INT_MAX: 0x7FFFFFFF denotes invalid value.
1329 * Reference: 3GPP TS 25.123, section 9.1.1.1 */
1330 } RIL_TD_SCDMA_SignalStrength;
1332 /* Deprecated, use RIL_SignalStrength_v6 */
1334 RIL_GW_SignalStrength GW_SignalStrength;
1335 RIL_CDMA_SignalStrength CDMA_SignalStrength;
1336 RIL_EVDO_SignalStrength EVDO_SignalStrength;
1337 } RIL_SignalStrength_v5;
1340 RIL_GW_SignalStrength GW_SignalStrength;
1341 RIL_CDMA_SignalStrength CDMA_SignalStrength;
1342 RIL_EVDO_SignalStrength EVDO_SignalStrength;
1343 RIL_LTE_SignalStrength LTE_SignalStrength;
1344 } RIL_SignalStrength_v6;
1347 RIL_GW_SignalStrength GW_SignalStrength;
1348 RIL_CDMA_SignalStrength CDMA_SignalStrength;
1349 RIL_EVDO_SignalStrength EVDO_SignalStrength;
1350 RIL_LTE_SignalStrength_v8 LTE_SignalStrength;
1351 } RIL_SignalStrength_v8;
1354 RIL_GW_SignalStrength GW_SignalStrength;
1355 RIL_CDMA_SignalStrength CDMA_SignalStrength;
1356 RIL_EVDO_SignalStrength EVDO_SignalStrength;
1357 RIL_LTE_SignalStrength_v8 LTE_SignalStrength;
1358 RIL_TD_SCDMA_SignalStrength TD_SCDMA_SignalStrength;
1359 } RIL_SignalStrength_v10;
1362 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1363 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1364 int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
1365 int cid; /* 16-bit GSM Cell Identity described in TS 27.007, 0..65535, INT_MAX if unknown */
1366 } RIL_CellIdentityGsm;
1369 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1370 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1371 int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
1372 int cid; /* 16-bit GSM Cell Identity described in TS 27.007, 0..65535, INT_MAX if unknown */
1373 int arfcn; /* 16-bit GSM Absolute RF channel number; this value must be reported */
1374 uint8_t bsic; /* 6-bit Base Station Identity Code; 0xFF if unknown */
1375 } RIL_CellIdentityGsm_v12;
1378 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1379 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1380 int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
1381 int cid; /* 28-bit UMTS Cell Identity described in TS 25.331, 0..268435455, INT_MAX if unknown */
1382 int psc; /* 9-bit UMTS Primary Scrambling Code described in TS 25.331, 0..511, INT_MAX if unknown */
1383 } RIL_CellIdentityWcdma;
1386 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1387 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1388 int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
1389 int cid; /* 28-bit UMTS Cell Identity described in TS 25.331, 0..268435455, INT_MAX if unknown */
1390 int psc; /* 9-bit UMTS Primary Scrambling Code described in TS 25.331, 0..511; this value must be reported */
1391 int uarfcn; /* 16-bit UMTS Absolute RF Channel Number; this value must be reported */
1392 } RIL_CellIdentityWcdma_v12;
1395 int networkId; /* Network Id 0..65535, INT_MAX if unknown */
1396 int systemId; /* CDMA System Id 0..32767, INT_MAX if unknown */
1397 int basestationId; /* Base Station Id 0..65535, INT_MAX if unknown */
1398 int longitude; /* Longitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0.
1399 * It is represented in units of 0.25 seconds and ranges from -2592000
1400 * to 2592000, both values inclusive (corresponding to a range of -180
1401 * to +180 degrees). INT_MAX if unknown */
1403 int latitude; /* Latitude is a decimal number as specified in 3GPP2 C.S0005-A v6.0.
1404 * It is represented in units of 0.25 seconds and ranges from -1296000
1405 * to 1296000, both values inclusive (corresponding to a range of -90
1406 * to +90 degrees). INT_MAX if unknown */
1407 } RIL_CellIdentityCdma;
1410 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1411 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1412 int ci; /* 28-bit Cell Identity described in TS ???, INT_MAX if unknown */
1413 int pci; /* physical cell id 0..503, INT_MAX if unknown */
1414 int tac; /* 16-bit tracking area code, INT_MAX if unknown */
1415 } RIL_CellIdentityLte;
1418 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1419 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1420 int ci; /* 28-bit Cell Identity described in TS ???, INT_MAX if unknown */
1421 int pci; /* physical cell id 0..503; this value must be reported */
1422 int tac; /* 16-bit tracking area code, INT_MAX if unknown */
1423 int earfcn; /* 18-bit LTE Absolute RF Channel Number; this value must be reported */
1424 } RIL_CellIdentityLte_v12;
1427 int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
1428 int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
1429 int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
1430 int cid; /* 28-bit UMTS Cell Identity described in TS 25.331, 0..268435455, INT_MAX if unknown */
1431 int cpid; /* 8-bit Cell Parameters ID described in TS 25.331, 0..127, INT_MAX if unknown */
1432 } RIL_CellIdentityTdscdma;
1435 RIL_CellIdentityGsm cellIdentityGsm;
1436 RIL_GW_SignalStrength signalStrengthGsm;
1440 RIL_CellIdentityGsm_v12 cellIdentityGsm;
1441 RIL_GSM_SignalStrength_v12 signalStrengthGsm;
1442 } RIL_CellInfoGsm_v12;
1445 RIL_CellIdentityWcdma cellIdentityWcdma;
1446 RIL_SignalStrengthWcdma signalStrengthWcdma;
1447 } RIL_CellInfoWcdma;
1450 RIL_CellIdentityWcdma_v12 cellIdentityWcdma;
1451 RIL_SignalStrengthWcdma signalStrengthWcdma;
1452 } RIL_CellInfoWcdma_v12;
1455 RIL_CellIdentityCdma cellIdentityCdma;
1456 RIL_CDMA_SignalStrength signalStrengthCdma;
1457 RIL_EVDO_SignalStrength signalStrengthEvdo;
1461 RIL_CellIdentityLte cellIdentityLte;
1462 RIL_LTE_SignalStrength_v8 signalStrengthLte;
1466 RIL_CellIdentityLte_v12 cellIdentityLte;
1467 RIL_LTE_SignalStrength_v8 signalStrengthLte;
1468 } RIL_CellInfoLte_v12;
1471 RIL_CellIdentityTdscdma cellIdentityTdscdma;
1472 RIL_TD_SCDMA_SignalStrength signalStrengthTdscdma;
1473 } RIL_CellInfoTdscdma;
1475 // Must be the same as CellInfo.TYPE_XXX
1477 RIL_CELL_INFO_TYPE_NONE = 0, /* indicates no cell information */
1478 RIL_CELL_INFO_TYPE_GSM = 1,
1479 RIL_CELL_INFO_TYPE_CDMA = 2,
1480 RIL_CELL_INFO_TYPE_LTE = 3,
1481 RIL_CELL_INFO_TYPE_WCDMA = 4,
1482 RIL_CELL_INFO_TYPE_TD_SCDMA = 5
1485 // Must be the same as CellInfo.TIMESTAMP_TYPE_XXX
1487 RIL_TIMESTAMP_TYPE_UNKNOWN = 0,
1488 RIL_TIMESTAMP_TYPE_ANTENNA = 1,
1489 RIL_TIMESTAMP_TYPE_MODEM = 2,
1490 RIL_TIMESTAMP_TYPE_OEM_RIL = 3,
1491 RIL_TIMESTAMP_TYPE_JAVA_RIL = 4,
1492 } RIL_TimeStampType;
1495 RIL_CellInfoType cellInfoType; /* cell type for selecting from union CellInfo */
1496 int registered; /* !0 if this cell is registered 0 if not registered */
1497 RIL_TimeStampType timeStampType; /* type of time stamp represented by timeStamp */
1498 uint64_t timeStamp; /* Time in nanos as returned by ril_nano_time */
1500 RIL_CellInfoGsm gsm;
1501 RIL_CellInfoCdma cdma;
1502 RIL_CellInfoLte lte;
1503 RIL_CellInfoWcdma wcdma;
1504 RIL_CellInfoTdscdma tdscdma;
1509 RIL_CellInfoType cellInfoType; /* cell type for selecting from union CellInfo */
1510 int registered; /* !0 if this cell is registered 0 if not registered */
1511 RIL_TimeStampType timeStampType; /* type of time stamp represented by timeStamp */
1512 uint64_t timeStamp; /* Time in nanos as returned by ril_nano_time */
1514 RIL_CellInfoGsm_v12 gsm;
1515 RIL_CellInfoCdma cdma;
1516 RIL_CellInfoLte_v12 lte;
1517 RIL_CellInfoWcdma_v12 wcdma;
1518 RIL_CellInfoTdscdma tdscdma;
1523 RIL_CellInfoType cellInfoType; /* cell type for selecting from union CellInfo */
1525 RIL_CellIdentityGsm_v12 cellIdentityGsm;
1526 RIL_CellIdentityWcdma_v12 cellIdentityWcdma;
1527 RIL_CellIdentityLte_v12 cellIdentityLte;
1528 RIL_CellIdentityTdscdma cellIdentityTdscdma;
1529 RIL_CellIdentityCdma cellIdentityCdma;
1531 }RIL_CellIdentity_v16;
1534 RIL_RegState regState; // Valid reg states are RIL_NOT_REG_AND_NOT_SEARCHING,
1535 // REG_HOME, RIL_NOT_REG_AND_SEARCHING, REG_DENIED,
1536 // UNKNOWN, REG_ROAMING defined in RegState
1537 RIL_RadioTechnology rat; // indicates the available voice radio technology,
1538 // valid values as defined by RadioTechnology.
1539 int32_t cssSupported; // concurrent services support indicator. if
1540 // registered on a CDMA system.
1541 // 0 - Concurrent services not supported,
1542 // 1 - Concurrent services supported
1543 int32_t roamingIndicator; // TSB-58 Roaming Indicator if registered
1544 // on a CDMA or EVDO system or -1 if not.
1545 // Valid values are 0-255.
1546 int32_t systemIsInPrl; // indicates whether the current system is in the
1547 // PRL if registered on a CDMA or EVDO system or -1 if
1548 // not. 0=not in the PRL, 1=in the PRL
1549 int32_t defaultRoamingIndicator; // default Roaming Indicator from the PRL,
1550 // if registered on a CDMA or EVDO system or -1 if not.
1551 // Valid values are 0-255.
1552 int32_t reasonForDenial; // reasonForDenial if registration state is 3
1553 // (Registration denied) this is an enumerated reason why
1554 // registration was denied. See 3GPP TS 24.008,
1555 // 10.5.3.6 and Annex G.
1557 // 1 - Authentication Failure
1558 // 2 - IMSI unknown in HLR
1561 // 5 - PLMN not allowed
1562 // 6 - Location area not allowed
1563 // 7 - Roaming not allowed
1564 // 8 - No Suitable Cells in this Location Area
1565 // 9 - Network failure
1566 // 10 - Persistent location update reject
1567 // 11 - PLMN not allowed
1568 // 12 - Location area not allowed
1569 // 13 - Roaming not allowed in this Location Area
1570 // 15 - No Suitable Cells in this Location Area
1571 // 17 - Network Failure
1573 // 21 - Sync Failure
1575 // 23 - GSM Authentication unacceptable
1576 // 25 - Not Authorized for this CSG
1577 // 32 - Service option not supported
1578 // 33 - Requested service option not subscribed
1579 // 34 - Service option temporarily out of order
1580 // 38 - Call cannot be identified
1581 // 48-63 - Retry upon entry into a new cell
1582 // 95 - Semantically incorrect message
1583 // 96 - Invalid mandatory information
1584 // 97 - Message type non-existent or not implemented
1585 // 98 - Message type not compatible with protocol state
1586 // 99 - Information element non-existent or
1588 // 100 - Conditional IE error
1589 // 101 - Message not compatible with protocol state;
1590 RIL_CellIdentity_v16 cellIdentity; // current cell information
1591 }RIL_VoiceRegistrationStateResponse;
1595 RIL_RegState regState; // Valid reg states are RIL_NOT_REG_AND_NOT_SEARCHING,
1596 // REG_HOME, RIL_NOT_REG_AND_SEARCHING, REG_DENIED,
1597 // UNKNOWN, REG_ROAMING defined in RegState
1598 RIL_RadioTechnology rat; // indicates the available data radio technology,
1599 // valid values as defined by RadioTechnology.
1600 int32_t reasonDataDenied; // if registration state is 3 (Registration
1601 // denied) this is an enumerated reason why
1602 // registration was denied. See 3GPP TS 24.008,
1603 // Annex G.6 "Additional cause codes for GMM".
1604 // 7 == GPRS services not allowed
1605 // 8 == GPRS services and non-GPRS services not allowed
1606 // 9 == MS identity cannot be derived by the network
1607 // 10 == Implicitly detached
1608 // 14 == GPRS services not allowed in this PLMN
1609 // 16 == MSC temporarily not reachable
1610 // 40 == No PDP context activated
1611 int32_t maxDataCalls; // The maximum number of simultaneous Data Calls that
1612 // must be established using setupDataCall().
1613 RIL_CellIdentity_v16 cellIdentity; // Current cell information
1614 }RIL_DataRegistrationStateResponse;
1616 /* Names of the CDMA info records (C.S0005 section 3.7.5) */
1618 RIL_CDMA_DISPLAY_INFO_REC,
1619 RIL_CDMA_CALLED_PARTY_NUMBER_INFO_REC,
1620 RIL_CDMA_CALLING_PARTY_NUMBER_INFO_REC,
1621 RIL_CDMA_CONNECTED_NUMBER_INFO_REC,
1622 RIL_CDMA_SIGNAL_INFO_REC,
1623 RIL_CDMA_REDIRECTING_NUMBER_INFO_REC,
1624 RIL_CDMA_LINE_CONTROL_INFO_REC,
1625 RIL_CDMA_EXTENDED_DISPLAY_INFO_REC,
1626 RIL_CDMA_T53_CLIR_INFO_REC,
1627 RIL_CDMA_T53_RELEASE_INFO_REC,
1628 RIL_CDMA_T53_AUDIO_CONTROL_INFO_REC
1629 } RIL_CDMA_InfoRecName;
1631 /* Display Info Rec as defined in C.S0005 section 3.7.5.1
1632 Extended Display Info Rec as defined in C.S0005 section 3.7.5.16
1633 Note: the Extended Display info rec contains multiple records of the
1634 form: display_tag, display_len, and display_len occurrences of the
1635 chari field if the display_tag is not 10000000 or 10000001.
1636 To save space, the records are stored consecutively in a byte buffer.
1637 The display_tag, display_len and chari fields are all 1 byte.
1642 char alpha_buf[CDMA_ALPHA_INFO_BUFFER_LENGTH];
1643 } RIL_CDMA_DisplayInfoRecord;
1645 /* Called Party Number Info Rec as defined in C.S0005 section 3.7.5.2
1646 Calling Party Number Info Rec as defined in C.S0005 section 3.7.5.3
1647 Connected Number Info Rec as defined in C.S0005 section 3.7.5.4
1652 char buf[CDMA_NUMBER_INFO_BUFFER_LENGTH];
1657 } RIL_CDMA_NumberInfoRecord;
1659 /* Redirecting Number Information Record as defined in C.S0005 section 3.7.5.11 */
1661 RIL_REDIRECTING_REASON_UNKNOWN = 0,
1662 RIL_REDIRECTING_REASON_CALL_FORWARDING_BUSY = 1,
1663 RIL_REDIRECTING_REASON_CALL_FORWARDING_NO_REPLY = 2,
1664 RIL_REDIRECTING_REASON_CALLED_DTE_OUT_OF_ORDER = 9,
1665 RIL_REDIRECTING_REASON_CALL_FORWARDING_BY_THE_CALLED_DTE = 10,
1666 RIL_REDIRECTING_REASON_CALL_FORWARDING_UNCONDITIONAL = 15,
1667 RIL_REDIRECTING_REASON_RESERVED
1668 } RIL_CDMA_RedirectingReason;
1671 RIL_CDMA_NumberInfoRecord redirectingNumber;
1672 /* redirectingReason is set to RIL_REDIRECTING_REASON_UNKNOWN if not included */
1673 RIL_CDMA_RedirectingReason redirectingReason;
1674 } RIL_CDMA_RedirectingNumberInfoRecord;
1676 /* Line Control Information Record as defined in C.S0005 section 3.7.5.15 */
1678 char lineCtrlPolarityIncluded;
1679 char lineCtrlToggle;
1680 char lineCtrlReverse;
1681 char lineCtrlPowerDenial;
1682 } RIL_CDMA_LineControlInfoRecord;
1684 /* T53 CLIR Information Record */
1687 } RIL_CDMA_T53_CLIRInfoRecord;
1689 /* T53 Audio Control Information Record */
1693 } RIL_CDMA_T53_AudioControlInfoRecord;
1697 RIL_CDMA_InfoRecName name;
1700 /* Display and Extended Display Info Rec */
1701 RIL_CDMA_DisplayInfoRecord display;
1703 /* Called Party Number, Calling Party Number, Connected Number Info Rec */
1704 RIL_CDMA_NumberInfoRecord number;
1706 /* Signal Info Rec */
1707 RIL_CDMA_SignalInfoRecord signal;
1709 /* Redirecting Number Info Rec */
1710 RIL_CDMA_RedirectingNumberInfoRecord redir;
1712 /* Line Control Info Rec */
1713 RIL_CDMA_LineControlInfoRecord lineCtrl;
1715 /* T53 CLIR Info Rec */
1716 RIL_CDMA_T53_CLIRInfoRecord clir;
1718 /* T53 Audio Control Info Rec */
1719 RIL_CDMA_T53_AudioControlInfoRecord audioCtrl;
1721 } RIL_CDMA_InformationRecord;
1723 #define RIL_CDMA_MAX_NUMBER_OF_INFO_RECS 10
1726 char numberOfInfoRecs;
1727 RIL_CDMA_InformationRecord infoRec[RIL_CDMA_MAX_NUMBER_OF_INFO_RECS];
1728 } RIL_CDMA_InformationRecords;
1730 /* See RIL_REQUEST_NV_READ_ITEM */
1735 /* See RIL_REQUEST_NV_WRITE_ITEM */
1742 HANDOVER_STARTED = 0,
1743 HANDOVER_COMPLETED = 1,
1744 HANDOVER_FAILED = 2,
1745 HANDOVER_CANCELED = 3
1748 /* hardware configuration reported to RILJ. */
1750 RIL_HARDWARE_CONFIG_MODEM = 0,
1751 RIL_HARDWARE_CONFIG_SIM = 1,
1752 } RIL_HardwareConfig_Type;
1755 RIL_HARDWARE_CONFIG_STATE_ENABLED = 0,
1756 RIL_HARDWARE_CONFIG_STATE_STANDBY = 1,
1757 RIL_HARDWARE_CONFIG_STATE_DISABLED = 2,
1758 } RIL_HardwareConfig_State;
1762 uint32_t rat; /* bitset - ref. RIL_RadioTechnology. */
1766 } RIL_HardwareConfig_Modem;
1769 char modemUuid[MAX_UUID_LENGTH];
1770 } RIL_HardwareConfig_Sim;
1773 RIL_HardwareConfig_Type type;
1774 char uuid[MAX_UUID_LENGTH];
1775 RIL_HardwareConfig_State state;
1777 RIL_HardwareConfig_Modem modem;
1778 RIL_HardwareConfig_Sim sim;
1780 } RIL_HardwareConfig;
1786 SS_CF_NOT_REACHABLE,
1788 SS_CF_ALL_CONDITIONAL,
1800 SS_OUTGOING_BARRING,
1802 } RIL_SsServiceType;
1810 } RIL_SsRequestType;
1813 SS_ALL_TELE_AND_BEARER_SERVICES,
1816 SS_ALL_DATA_TELESERVICES,
1818 SS_ALL_TELESERVICES_EXCEPT_SMS
1819 } RIL_SsTeleserviceType;
1821 #define SS_INFO_MAX 4
1822 #define NUM_SERVICE_CLASSES 7
1825 int numValidIndexes; /* This gives the number of valid values in cfInfo.
1826 For example if voice is forwarded to one number and data
1827 is forwarded to a different one then numValidIndexes will be
1828 2 indicating total number of valid values in cfInfo.
1829 Similarly if all the services are forwarded to the same
1830 number then the value of numValidIndexes will be 1. */
1832 RIL_CallForwardInfo cfInfo[NUM_SERVICE_CLASSES]; /* This is the response data
1833 for SS request to query call
1835 RIL_REQUEST_QUERY_CALL_FORWARD_STATUS */
1839 RIL_SsServiceType serviceType;
1840 RIL_SsRequestType requestType;
1841 RIL_SsTeleserviceType teleserviceType;
1846 int ssInfo[SS_INFO_MAX]; /* This is the response data for most of the SS GET/SET
1847 RIL requests. E.g. RIL_REQUSET_GET_CLIR returns
1848 two ints, so first two values of ssInfo[] will be
1849 used for response if serviceType is SS_CLIR and
1850 requestType is SS_INTERROGATION */
1854 } RIL_StkCcUnsolSsResponse;
1857 * Data connection power state
1860 RIL_DC_POWER_STATE_LOW = 1, // Low power state
1861 RIL_DC_POWER_STATE_MEDIUM = 2, // Medium power state
1862 RIL_DC_POWER_STATE_HIGH = 3, // High power state
1863 RIL_DC_POWER_STATE_UNKNOWN = INT32_MAX // Unknown state
1864 } RIL_DcPowerStates;
1867 * Data connection real time info
1870 uint64_t time; // Time in nanos as returned by ril_nano_time
1871 RIL_DcPowerStates powerState; // Current power state
1875 * Data profile to modem
1878 /* id of the data profile */
1880 /* the APN to connect to */
1882 /** one of the PDP_type values in TS 27.007 section 10.1.1.
1883 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
1886 /** authentication protocol used for this PDP context
1887 * (None: 0, PAP: 1, CHAP: 2, PAP&CHAP: 3)
1890 /* the username for APN, or NULL */
1892 /* the password for APN, or NULL */
1894 /* the profile type, TYPE_COMMON-0, TYPE_3GPP-1, TYPE_3GPP2-2 */
1896 /* the period in seconds to limit the maximum connections */
1898 /* the maximum connections during maxConnsTime */
1900 /** the required wait time in seconds after a successful UE initiated
1901 * disconnect of a given PDN connection before the device can send
1902 * a new PDN connection request for that given PDN
1905 /* true to enable the profile, 0 to disable, 1 to enable */
1907 } RIL_DataProfileInfo;
1910 /* id of the data profile */
1912 /* the APN to connect to */
1914 /** one of the PDP_type values in TS 27.007 section 10.1.1.
1915 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
1918 /** one of the PDP_type values in TS 27.007 section 10.1.1 used on roaming network.
1919 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
1921 char *roamingProtocol;
1922 /** authentication protocol used for this PDP context
1923 * (None: 0, PAP: 1, CHAP: 2, PAP&CHAP: 3)
1926 /* the username for APN, or NULL */
1928 /* the password for APN, or NULL */
1930 /* the profile type, TYPE_COMMON-0, TYPE_3GPP-1, TYPE_3GPP2-2 */
1932 /* the period in seconds to limit the maximum connections */
1934 /* the maximum connections during maxConnsTime */
1936 /** the required wait time in seconds after a successful UE initiated
1937 * disconnect of a given PDN connection before the device can send
1938 * a new PDN connection request for that given PDN
1941 /* true to enable the profile, 0 to disable, 1 to enable */
1943 /* supported APN types bitmask. See RIL_ApnTypes for the value of each bit. */
1944 int supportedTypesBitmask;
1945 /** the bearer bitmask. See RIL_RadioAccessFamily for the value of each bit. */
1947 /** maximum transmission unit (MTU) size in bytes */
1949 /** the MVNO type: possible values are "imsi", "gid", "spn" */
1951 /** MVNO match data. Can be anything defined by the carrier. For example,
1952 * SPN like: "A MOBILE", "BEN NL", etc...
1953 * IMSI like: "302720x94", "2060188", etc...
1954 * GID like: "4E", "33", etc...
1956 char *mvnoMatchData;
1957 } RIL_DataProfileInfo_v15;
1959 /* Tx Power Levels */
1960 #define RIL_NUM_TX_POWER_LEVELS 5
1963 * Aggregate modem activity information
1967 /* total time (in ms) when modem is in a low power or
1970 uint32_t sleep_mode_time_ms;
1972 /* total time (in ms) when modem is awake but neither
1973 * the transmitter nor receiver are active/awake */
1974 uint32_t idle_mode_time_ms;
1976 /* total time (in ms) during which the transmitter is active/awake,
1977 * subdivided by manufacturer-defined device-specific
1978 * contiguous increasing ranges of transmit power between
1979 * 0 and the transmitter's maximum transmit power.
1981 uint32_t tx_mode_time_ms[RIL_NUM_TX_POWER_LEVELS];
1983 /* total time (in ms) for which receiver is active/awake and
1984 * the transmitter is inactive */
1985 uint32_t rx_mode_time_ms;
1986 } RIL_ActivityStatsInfo;
1989 RIL_APN_TYPE_UNKNOWN = 0x0, // Unknown
1990 RIL_APN_TYPE_DEFAULT = 0x1, // APN type for default data traffic
1991 RIL_APN_TYPE_MMS = 0x2, // APN type for MMS traffic
1992 RIL_APN_TYPE_SUPL = 0x4, // APN type for SUPL assisted GPS
1993 RIL_APN_TYPE_DUN = 0x8, // APN type for DUN traffic
1994 RIL_APN_TYPE_HIPRI = 0x10, // APN type for HiPri traffic
1995 RIL_APN_TYPE_FOTA = 0x20, // APN type for FOTA
1996 RIL_APN_TYPE_IMS = 0x40, // APN type for IMS
1997 RIL_APN_TYPE_CBS = 0x80, // APN type for CBS
1998 RIL_APN_TYPE_IA = 0x100, // APN type for IA Initial Attach APN
1999 RIL_APN_TYPE_EMERGENCY = 0x200, // APN type for Emergency PDN. This is not an IA apn,
2000 // but is used for access to carrier services in an
2001 // emergency call situation.
2002 RIL_APN_TYPE_ALL = 0xFFFFFFFF // All APN types
2006 RIL_DST_POWER_SAVE_MODE, // Device power save mode (provided by PowerManager)
2007 // True indicates the device is in power save mode.
2008 RIL_DST_CHARGING_STATE, // Device charging state (provided by BatteryManager)
2009 // True indicates the device is charging.
2010 RIL_DST_LOW_DATA_EXPECTED // Low data expected mode. True indicates low data traffic
2011 // is expected, for example, when the device is idle
2012 // (e.g. not doing tethering in the background). Note
2013 // this doesn't mean no data is expected.
2014 } RIL_DeviceStateType;
2017 RIL_UR_SIGNAL_STRENGTH = 0x01, // When this bit is set, modem should always send the
2018 // signal strength update through
2019 // RIL_UNSOL_SIGNAL_STRENGTH, otherwise suppress it.
2020 RIL_UR_FULL_NETWORK_STATE = 0x02, // When this bit is set, modem should always send
2021 // RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED
2022 // when any field in
2023 // RIL_REQUEST_VOICE_REGISTRATION_STATE or
2024 // RIL_REQUEST_DATA_REGISTRATION_STATE changes. When
2025 // this bit is not set, modem should suppress
2026 // RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED
2027 // only when insignificant fields change
2028 // (e.g. cell info).
2029 // Modem should continue sending
2030 // RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED
2031 // when significant fields are updated even when this
2032 // bit is not set. The following fields are
2033 // considered significant, registration state and
2034 // radio technology.
2035 RIL_UR_DATA_CALL_DORMANCY_CHANGED = 0x04 // When this bit is set, modem should send the data
2036 // call list changed unsolicited response
2037 // RIL_UNSOL_DATA_CALL_LIST_CHANGED whenever any
2038 // field in RIL_Data_Call_Response changes.
2039 // Otherwise modem should suppress the unsolicited
2040 // response when the only changed field is 'active'
2041 // (for data dormancy). For all other fields change,
2042 // modem should continue sending
2043 // RIL_UNSOL_DATA_CALL_LIST_CHANGED regardless this
2044 // bit is set or not.
2045 } RIL_UnsolicitedResponseFilter;
2048 char * aidPtr; /* AID value, See ETSI 102.221 and 101.220*/
2049 int p2; /* P2 parameter (described in ISO 7816-4)
2050 P2Constants:NO_P2 if to be ignored */
2051 } RIL_OpenChannelParams;
2054 RIL_ONE_SHOT = 0x01, // Performs the scan only once
2055 RIL_PERIODIC = 0x02 // Performs the scan periodically until cancelled
2059 GERAN = 0x01, // GSM EDGE Radio Access Network
2060 UTRAN = 0x02, // Universal Terrestrial Radio Access Network
2061 EUTRAN = 0x03, // Evolved Universal Terrestrial Radio Access Network
2062 } RIL_RadioAccessNetworks;
2065 GERAN_BAND_T380 = 1,
2066 GERAN_BAND_T410 = 2,
2071 GERAN_BAND_T810 = 7,
2073 GERAN_BAND_P900 = 9,
2074 GERAN_BAND_E900 = 10,
2075 GERAN_BAND_R900 = 11,
2076 GERAN_BAND_DCS1800 = 12,
2077 GERAN_BAND_PCS1900 = 13,
2078 GERAN_BAND_ER900 = 14,
2114 EUTRAN_BAND_10 = 10,
2115 EUTRAN_BAND_11 = 11,
2116 EUTRAN_BAND_12 = 12,
2117 EUTRAN_BAND_13 = 13,
2118 EUTRAN_BAND_14 = 14,
2119 EUTRAN_BAND_17 = 17,
2120 EUTRAN_BAND_18 = 18,
2121 EUTRAN_BAND_19 = 19,
2122 EUTRAN_BAND_20 = 20,
2123 EUTRAN_BAND_21 = 21,
2124 EUTRAN_BAND_22 = 22,
2125 EUTRAN_BAND_23 = 23,
2126 EUTRAN_BAND_24 = 24,
2127 EUTRAN_BAND_25 = 25,
2128 EUTRAN_BAND_26 = 26,
2129 EUTRAN_BAND_27 = 27,
2130 EUTRAN_BAND_28 = 28,
2131 EUTRAN_BAND_30 = 30,
2132 EUTRAN_BAND_31 = 31,
2133 EUTRAN_BAND_33 = 33,
2134 EUTRAN_BAND_34 = 34,
2135 EUTRAN_BAND_35 = 35,
2136 EUTRAN_BAND_36 = 36,
2137 EUTRAN_BAND_37 = 37,
2138 EUTRAN_BAND_38 = 38,
2139 EUTRAN_BAND_39 = 39,
2140 EUTRAN_BAND_40 = 40,
2141 EUTRAN_BAND_41 = 41,
2142 EUTRAN_BAND_42 = 42,
2143 EUTRAN_BAND_43 = 43,
2144 EUTRAN_BAND_44 = 44,
2145 EUTRAN_BAND_45 = 45,
2146 EUTRAN_BAND_46 = 46,
2147 EUTRAN_BAND_47 = 47,
2148 EUTRAN_BAND_48 = 48,
2149 EUTRAN_BAND_65 = 65,
2150 EUTRAN_BAND_66 = 66,
2151 EUTRAN_BAND_68 = 68,
2152 EUTRAN_BAND_70 = 70,
2156 RIL_RadioAccessNetworks radio_access_network; // The type of network to scan.
2157 uint32_t bands_length; // Length of bands
2159 RIL_GeranBands geran_bands[MAX_BANDS];
2160 RIL_UtranBands utran_bands[MAX_BANDS];
2161 RIL_EutranBands eutran_bands[MAX_BANDS];
2163 uint32_t channels_length; // Length of channels
2164 uint32_t channels[MAX_CHANNELS]; // Frequency channels to scan
2165 } RIL_RadioAccessSpecifier;
2168 RIL_ScanType type; // Type of the scan
2169 int32_t interval; // Time interval in seconds
2170 // between periodic scans, only
2171 // valid when type=RIL_PERIODIC
2172 uint32_t specifiers_length; // Length of specifiers
2173 RIL_RadioAccessSpecifier specifiers[MAX_RADIO_ACCESS_NETWORKS]; // Radio access networks
2174 // with bands/channels.
2175 } RIL_NetworkScanRequest;
2178 PARTIAL = 0x01, // The result contains a part of the scan results
2179 COMPLETE = 0x02, // The result contains the last part of the scan results
2183 RIL_ScanStatus status; // The status of the scan
2184 uint32_t network_infos_length; // Total length of RIL_CellInfo
2185 RIL_CellInfo_v12* network_infos; // List of network information
2187 } RIL_NetworkScanResult;
2190 * RIL_REQUEST_GET_SIM_STATUS
2192 * Requests status of the SIM interface and the SIM card
2196 * "response" is const RIL_CardStatus_v6 *
2201 * RADIO_NOT_AVAILABLE
2206 * REQUEST_NOT_SUPPORTED
2208 #define RIL_REQUEST_GET_SIM_STATUS 1
2211 * RIL_REQUEST_ENTER_SIM_PIN
2213 * Supplies SIM PIN. Only called if RIL_CardStatus has RIL_APPSTATE_PIN state
2215 * "data" is const char **
2216 * ((const char **)data)[0] is PIN value
2217 * ((const char **)data)[1] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2219 * "response" is int *
2220 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2225 * RADIO_NOT_AVAILABLE (radio resetting)
2226 * PASSWORD_INCORRECT
2233 * REQUEST_NOT_SUPPORTED
2236 #define RIL_REQUEST_ENTER_SIM_PIN 2
2239 * RIL_REQUEST_ENTER_SIM_PUK
2241 * Supplies SIM PUK and new PIN.
2243 * "data" is const char **
2244 * ((const char **)data)[0] is PUK value
2245 * ((const char **)data)[1] is new PIN value
2246 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2248 * "response" is int *
2249 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2254 * RADIO_NOT_AVAILABLE (radio resetting)
2255 * PASSWORD_INCORRECT
2263 * REQUEST_NOT_SUPPORTED
2266 #define RIL_REQUEST_ENTER_SIM_PUK 3
2269 * RIL_REQUEST_ENTER_SIM_PIN2
2271 * Supplies SIM PIN2. Only called following operation where SIM_PIN2 was
2272 * returned as a a failure from a previous operation.
2274 * "data" is const char **
2275 * ((const char **)data)[0] is PIN2 value
2276 * ((const char **)data)[1] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2278 * "response" is int *
2279 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2284 * RADIO_NOT_AVAILABLE (radio resetting)
2285 * PASSWORD_INCORRECT
2292 * REQUEST_NOT_SUPPORTED
2295 #define RIL_REQUEST_ENTER_SIM_PIN2 4
2298 * RIL_REQUEST_ENTER_SIM_PUK2
2300 * Supplies SIM PUK2 and new PIN2.
2302 * "data" is const char **
2303 * ((const char **)data)[0] is PUK2 value
2304 * ((const char **)data)[1] is new PIN2 value
2305 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2307 * "response" is int *
2308 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2313 * RADIO_NOT_AVAILABLE (radio resetting)
2314 * PASSWORD_INCORRECT
2322 * REQUEST_NOT_SUPPORTED
2325 #define RIL_REQUEST_ENTER_SIM_PUK2 5
2328 * RIL_REQUEST_CHANGE_SIM_PIN
2330 * Supplies old SIM PIN and new PIN.
2332 * "data" is const char **
2333 * ((const char **)data)[0] is old PIN value
2334 * ((const char **)data)[1] is new PIN value
2335 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2337 * "response" is int *
2338 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2343 * RADIO_NOT_AVAILABLE (radio resetting)
2344 * PASSWORD_INCORRECT
2345 * (old PIN is invalid)
2352 * REQUEST_NOT_SUPPORTED
2355 #define RIL_REQUEST_CHANGE_SIM_PIN 6
2359 * RIL_REQUEST_CHANGE_SIM_PIN2
2361 * Supplies old SIM PIN2 and new PIN2.
2363 * "data" is const char **
2364 * ((const char **)data)[0] is old PIN2 value
2365 * ((const char **)data)[1] is new PIN2 value
2366 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2368 * "response" is int *
2369 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2374 * RADIO_NOT_AVAILABLE (radio resetting)
2375 * PASSWORD_INCORRECT
2376 * (old PIN2 is invalid)
2383 * REQUEST_NOT_SUPPORTED
2387 #define RIL_REQUEST_CHANGE_SIM_PIN2 7
2390 * RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION
2392 * Requests that network personlization be deactivated
2394 * "data" is const char **
2395 * ((const char **)(data))[0]] is network depersonlization code
2397 * "response" is int *
2398 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2403 * RADIO_NOT_AVAILABLE (radio resetting)
2404 * PASSWORD_INCORRECT
2411 * REQUEST_NOT_SUPPORTED
2414 #define RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION 8
2417 * RIL_REQUEST_GET_CURRENT_CALLS
2419 * Requests current call list
2423 * "response" must be a "const RIL_Call **"
2428 * RADIO_NOT_AVAILABLE (radio resetting)
2430 * (request will be made again in a few hundred msec)
2434 * REQUEST_NOT_SUPPORTED
2437 #define RIL_REQUEST_GET_CURRENT_CALLS 9
2443 * Initiate voice call
2445 * "data" is const RIL_Dial *
2446 * "response" is NULL
2448 * This method is never used for supplementary service codes
2452 * RADIO_NOT_AVAILABLE (radio resetting)
2453 * DIAL_MODIFIED_TO_USSD
2454 * DIAL_MODIFIED_TO_SS
2455 * DIAL_MODIFIED_TO_DIAL
2467 * OPERATION_NOT_ALLOWED
2470 * REQUEST_NOT_SUPPORTED
2472 #define RIL_REQUEST_DIAL 10
2475 * RIL_REQUEST_GET_IMSI
2479 * Only valid when radio state is "RADIO_STATE_ON"
2481 * "data" is const char **
2482 * ((const char **)data)[0] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2483 * "response" is a const char * containing the IMSI
2487 * RADIO_NOT_AVAILABLE (radio resetting)
2493 * REQUEST_NOT_SUPPORTED
2496 #define RIL_REQUEST_GET_IMSI 11
2499 * RIL_REQUEST_HANGUP
2501 * Hang up a specific line (like AT+CHLD=1x)
2503 * After this HANGUP request returns, RIL should show the connection is NOT
2504 * active anymore in next RIL_REQUEST_GET_CURRENT_CALLS query.
2506 * "data" is an int *
2507 * (int *)data)[0] contains Connection index (value of 'x' in CHLD above)
2509 * "response" is NULL
2513 * RADIO_NOT_AVAILABLE (radio resetting)
2524 * REQUEST_NOT_SUPPORTED
2527 #define RIL_REQUEST_HANGUP 12
2530 * RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND
2532 * Hang up waiting or held (like AT+CHLD=0)
2534 * After this HANGUP request returns, RIL should show the connection is NOT
2535 * active anymore in next RIL_REQUEST_GET_CURRENT_CALLS query.
2538 * "response" is NULL
2542 * RADIO_NOT_AVAILABLE (radio resetting)
2550 * OPERATION_NOT_ALLOWED
2554 * REQUEST_NOT_SUPPORTED
2557 #define RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND 13
2560 * RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND
2562 * Hang up waiting or held (like AT+CHLD=1)
2564 * After this HANGUP request returns, RIL should show the connection is NOT
2565 * active anymore in next RIL_REQUEST_GET_CURRENT_CALLS query.
2568 * "response" is NULL
2572 * RADIO_NOT_AVAILABLE (radio resetting)
2578 * OPERATION_NOT_ALLOWED
2582 * REQUEST_NOT_SUPPORTED
2585 #define RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND 14
2588 * RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE
2590 * Switch waiting or holding call and active call (like AT+CHLD=2)
2592 * State transitions should be is follows:
2594 * If call 1 is waiting and call 2 is active, then if this re
2597 * Call 1 Call 2 Call 1 Call 2
2598 * ACTIVE HOLDING HOLDING ACTIVE
2599 * ACTIVE WAITING HOLDING ACTIVE
2600 * HOLDING WAITING HOLDING ACTIVE
2601 * ACTIVE IDLE HOLDING IDLE
2602 * IDLE IDLE IDLE IDLE
2605 * "response" is NULL
2609 * RADIO_NOT_AVAILABLE (radio resetting)
2617 * OPERATION_NOT_ALLOWED
2620 * REQUEST_NOT_SUPPORTED
2623 #define RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE 15
2624 #define RIL_REQUEST_SWITCH_HOLDING_AND_ACTIVE 15
2627 * RIL_REQUEST_CONFERENCE
2629 * Conference holding and active (like AT+CHLD=3)
2632 * "response" is NULL
2636 * RADIO_NOT_AVAILABLE (radio resetting)
2643 * OPERATION_NOT_ALLOWED
2646 * REQUEST_NOT_SUPPORTED
2648 #define RIL_REQUEST_CONFERENCE 16
2653 * Send UDUB (user determined used busy) to ringing or
2654 * waiting call answer)(RIL_BasicRequest r);
2657 * "response" is NULL
2661 * RADIO_NOT_AVAILABLE (radio resetting)
2668 * OPERATION_NOT_ALLOWED
2671 * REQUEST_NOT_SUPPORTED
2673 #define RIL_REQUEST_UDUB 17
2676 * RIL_REQUEST_LAST_CALL_FAIL_CAUSE
2678 * Requests the failure cause code for the most recently terminated call
2681 * "response" is a const RIL_LastCallFailCauseInfo *
2682 * RIL_LastCallFailCauseInfo contains LastCallFailCause and vendor cause.
2683 * The vendor cause code must be used for debugging purpose only.
2684 * The implementation must return one of the values of LastCallFailCause
2685 * as mentioned below.
2687 * GSM failure reasons codes for the cause codes defined in TS 24.008 Annex H
2689 * CDMA failure reasons codes for the possible call failure scenarios
2690 * described in the "CDMA IS-2000 Release A (C.S0005-A v6.0)" standard.
2691 * Any of the following reason codes if the call is failed or dropped due to reason
2692 * mentioned with in the braces.
2694 * CALL_FAIL_RADIO_OFF (Radio is OFF)
2695 * CALL_FAIL_OUT_OF_SERVICE (No cell coverage)
2696 * CALL_FAIL_NO_VALID_SIM (No valid SIM)
2697 * CALL_FAIL_RADIO_INTERNAL_ERROR (Modem hit unexpected error scenario)
2698 * CALL_FAIL_NETWORK_RESP_TIMEOUT (No response from network)
2699 * CALL_FAIL_NETWORK_REJECT (Explicit network reject)
2700 * CALL_FAIL_RADIO_ACCESS_FAILURE (RRC connection failure. Eg.RACH)
2701 * CALL_FAIL_RADIO_LINK_FAILURE (Radio Link Failure)
2702 * CALL_FAIL_RADIO_LINK_LOST (Radio link lost due to poor coverage)
2703 * CALL_FAIL_RADIO_UPLINK_FAILURE (Radio uplink failure)
2704 * CALL_FAIL_RADIO_SETUP_FAILURE (RRC connection setup failure)
2705 * CALL_FAIL_RADIO_RELEASE_NORMAL (RRC connection release, normal)
2706 * CALL_FAIL_RADIO_RELEASE_ABNORMAL (RRC connection release, abnormal)
2707 * CALL_FAIL_ACCESS_CLASS_BLOCKED (Access class barring)
2708 * CALL_FAIL_NETWORK_DETACH (Explicit network detach)
2710 * OEM causes (CALL_FAIL_OEM_CAUSE_XX) must be used for debug purpose only
2712 * If the implementation does not have access to the exact cause codes,
2713 * then it should return one of the values listed in RIL_LastCallFailCause,
2714 * as the UI layer needs to distinguish these cases for tone generation or
2715 * error notification.
2719 * RADIO_NOT_AVAILABLE
2724 * REQUEST_NOT_SUPPORTED
2726 * See also: RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE
2728 #define RIL_REQUEST_LAST_CALL_FAIL_CAUSE 18
2731 * RIL_REQUEST_SIGNAL_STRENGTH
2733 * Requests current signal strength and associated information
2735 * Must succeed if radio is on.
2739 * "response" is a const RIL_SignalStrength *
2743 * RADIO_NOT_AVAILABLE
2749 * REQUEST_NOT_SUPPORTED
2753 #define RIL_REQUEST_SIGNAL_STRENGTH 19
2756 * RIL_REQUEST_VOICE_REGISTRATION_STATE
2758 * Request current registration state
2761 * "response" is a const RIL_VoiceRegistrationStateResponse *
2765 * RADIO_NOT_AVAILABLE
2770 * REQUEST_NOT_SUPPORTED
2772 #define RIL_REQUEST_VOICE_REGISTRATION_STATE 20
2775 * RIL_REQUEST_DATA_REGISTRATION_STATE
2777 * Request current DATA registration state
2780 * "response" is a const RIL_DataRegistrationStateResponse *
2784 * RADIO_NOT_AVAILABLE
2790 * REQUEST_NOT_SUPPORTED
2794 #define RIL_REQUEST_DATA_REGISTRATION_STATE 21
2797 * RIL_REQUEST_OPERATOR
2799 * Request current operator ONS or EONS
2802 * "response" is a "const char **"
2803 * ((const char **)response)[0] is long alpha ONS or EONS
2804 * or NULL if unregistered
2806 * ((const char **)response)[1] is short alpha ONS or EONS
2807 * or NULL if unregistered
2808 * ((const char **)response)[2] is 5 or 6 digit numeric code (MCC + MNC)
2809 * or NULL if unregistered
2813 * RADIO_NOT_AVAILABLE
2817 * REQUEST_NOT_SUPPORTED
2821 #define RIL_REQUEST_OPERATOR 22
2824 * RIL_REQUEST_RADIO_POWER
2826 * Toggle radio on and off (for "airplane" mode)
2827 * If the radio is is turned off/on the radio modem subsystem
2828 * is expected return to an initialized state. For instance,
2829 * any voice and data calls will be terminated and all associated
2833 * ((int *)data)[0] is > 0 for "Radio On"
2834 * ((int *)data)[0] is == 0 for "Radio Off"
2836 * "response" is NULL
2838 * Turn radio on if "on" > 0
2839 * Turn radio off if "on" == 0
2843 * RADIO_NOT_AVAILABLE
2844 * OPERATION_NOT_ALLOWED
2852 * OPERATION_NOT_ALLOWED
2853 * INVALID_MODEM_STATE
2854 * REQUEST_NOT_SUPPORTED
2858 #define RIL_REQUEST_RADIO_POWER 23
2865 * If the implementation is currently playing a tone requested via
2866 * RIL_REQUEST_DTMF_START, that tone should be cancelled and the new tone
2867 * should be played instead
2869 * "data" is a char * containing a single character with one of 12 values: 0-9,*,#
2870 * "response" is NULL
2872 * FIXME should this block/mute microphone?
2873 * How does this interact with local DTMF feedback?
2877 * RADIO_NOT_AVAILABLE
2886 * INVALID_MODEM_STATE
2887 * REQUEST_NOT_SUPPORTED
2889 * See also: RIL_REQUEST_DTMF_STOP, RIL_REQUEST_DTMF_START
2892 #define RIL_REQUEST_DTMF 24
2895 * RIL_REQUEST_SEND_SMS
2897 * Send an SMS message
2899 * "data" is const char **
2900 * ((const char **)data)[0] is SMSC address in GSM BCD format prefixed
2901 * by a length byte (as expected by TS 27.005) or NULL for default SMSC
2902 * ((const char **)data)[1] is SMS in PDU format as an ASCII hex string
2903 * less the SMSC address
2904 * TP-Layer-Length is be "strlen(((const char **)data)[1])/2"
2906 * "response" is a const RIL_SMS_Response *
2908 * Based on the return error, caller decides to resend if sending sms
2909 * fails. SMS_SEND_FAIL_RETRY means retry (i.e. error cause is 332)
2913 * RADIO_NOT_AVAILABLE
2914 * SMS_SEND_FAIL_RETRY
2920 * REQUEST_RATE_LIMITED
2921 * INVALID_SMS_FORMAT
2924 * INVALID_SMSC_ADDRESS
2927 * OPERATION_NOT_ALLOWED
2931 * REQUEST_NOT_SUPPORTED
2932 * MODE_NOT_SUPPORTED
2935 * FIXME how do we specify TP-Message-Reference if we need to resend?
2937 #define RIL_REQUEST_SEND_SMS 25
2941 * RIL_REQUEST_SEND_SMS_EXPECT_MORE
2943 * Send an SMS message. Identical to RIL_REQUEST_SEND_SMS,
2944 * except that more messages are expected to be sent soon. If possible,
2945 * keep SMS relay protocol link open (eg TS 27.005 AT+CMMS command)
2947 * "data" is const char **
2948 * ((const char **)data)[0] is SMSC address in GSM BCD format prefixed
2949 * by a length byte (as expected by TS 27.005) or NULL for default SMSC
2950 * ((const char **)data)[1] is SMS in PDU format as an ASCII hex string
2951 * less the SMSC address
2952 * TP-Layer-Length is be "strlen(((const char **)data)[1])/2"
2954 * "response" is a const RIL_SMS_Response *
2956 * Based on the return error, caller decides to resend if sending sms
2957 * fails. SMS_SEND_FAIL_RETRY means retry (i.e. error cause is 332)
2961 * RADIO_NOT_AVAILABLE
2962 * SMS_SEND_FAIL_RETRY
2967 * INVALID_SMS_FORMAT
2969 * REQUEST_RATE_LIMITED
2974 * INVALID_SMSC_ADDRESS
2975 * OPERATION_NOT_ALLOWED
2979 * REQUEST_NOT_SUPPORTED
2980 * MODE_NOT_SUPPORTED
2984 #define RIL_REQUEST_SEND_SMS_EXPECT_MORE 26
2988 * RIL_REQUEST_SETUP_DATA_CALL
2990 * Setup a packet data connection. If RIL_Data_Call_Response_v6.status
2991 * return success it is added to the list of data calls and a
2992 * RIL_UNSOL_DATA_CALL_LIST_CHANGED is sent. The call remains in the
2993 * list until RIL_REQUEST_DEACTIVATE_DATA_CALL is issued or the
2994 * radio is powered off/on. This list is returned by RIL_REQUEST_DATA_CALL_LIST
2995 * and RIL_UNSOL_DATA_CALL_LIST_CHANGED.
2997 * The RIL is expected to:
2998 * - Create one data call context.
2999 * - Create and configure a dedicated interface for the context
3000 * - The interface must be point to point.
3001 * - The interface is configured with one or more addresses and
3002 * is capable of sending and receiving packets. The prefix length
3003 * of the addresses must be /32 for IPv4 and /128 for IPv6.
3004 * - Must NOT change the linux routing table.
3005 * - Support up to RIL_REQUEST_DATA_REGISTRATION_STATE response[5]
3006 * number of simultaneous data call contexts.
3008 * "data" is a const char **
3009 * ((const char **)data)[0] Radio technology to use: 0-CDMA, 1-GSM/UMTS, 2...
3010 * for values above 2 this is RIL_RadioTechnology + 2.
3011 * ((const char **)data)[1] is a RIL_DataProfile (support is optional)
3012 * ((const char **)data)[2] is the APN to connect to if radio technology is GSM/UMTS. This APN will
3013 * override the one in the profile. NULL indicates no APN overrride.
3014 * ((const char **)data)[3] is the username for APN, or NULL
3015 * ((const char **)data)[4] is the password for APN, or NULL
3016 * ((const char **)data)[5] is the PAP / CHAP auth type. Values:
3017 * 0 => PAP and CHAP is never performed.
3018 * 1 => PAP may be performed; CHAP is never performed.
3019 * 2 => CHAP may be performed; PAP is never performed.
3020 * 3 => PAP / CHAP may be performed - baseband dependent.
3021 * ((const char **)data)[6] is the non-roaming/home connection type to request. Must be one of the
3022 * PDP_type values in TS 27.007 section 10.1.1.
3023 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
3024 * ((const char **)data)[7] is the roaming connection type to request. Must be one of the
3025 * PDP_type values in TS 27.007 section 10.1.1.
3026 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
3027 * ((const char **)data)[8] is the bitmask of APN type in decimal string format. The
3028 * bitmask will encapsulate the following values:
3029 * ia,mms,agps,supl,hipri,fota,dun,ims,default.
3030 * ((const char **)data)[9] is the bearer bitmask in decimal string format. Each bit is a
3031 * RIL_RadioAccessFamily. "0" or NULL indicates all RATs.
3032 * ((const char **)data)[10] is the boolean in string format indicating the APN setting was
3033 * sent to the modem through RIL_REQUEST_SET_DATA_PROFILE earlier.
3034 * ((const char **)data)[11] is the mtu size in bytes of the mobile interface to which
3035 * the apn is connected.
3036 * ((const char **)data)[12] is the MVNO type:
3037 * possible values are "imsi", "gid", "spn".
3038 * ((const char **)data)[13] is MVNO match data in string. Can be anything defined by the carrier.
3040 * SPN like: "A MOBILE", "BEN NL", etc...
3041 * IMSI like: "302720x94", "2060188", etc...
3042 * GID like: "4E", "33", etc...
3043 * ((const char **)data)[14] is the boolean string indicating data roaming is allowed or not. "1"
3044 * indicates data roaming is enabled by the user, "0" indicates disabled.
3046 * "response" is a RIL_Data_Call_Response_v11
3048 * FIXME may need way to configure QoS settings
3051 * SUCCESS should be returned on both success and failure of setup with
3052 * the RIL_Data_Call_Response_v6.status containing the actual status.
3053 * For all other errors the RIL_Data_Call_Resonse_v6 is ignored.
3055 * Other errors could include:
3056 * RADIO_NOT_AVAILABLE, OP_NOT_ALLOWED_BEFORE_REG_TO_NW,
3057 * OP_NOT_ALLOWED_DURING_VOICE_CALL, REQUEST_NOT_SUPPORTED,
3058 * INVALID_ARGUMENTS, INTERNAL_ERR, NO_MEMORY, NO_RESOURCES,
3059 * CANCELLED and SIM_ABSENT
3061 * See also: RIL_REQUEST_DEACTIVATE_DATA_CALL
3063 #define RIL_REQUEST_SETUP_DATA_CALL 27
3067 * RIL_REQUEST_SIM_IO
3069 * Request SIM I/O operation.
3070 * This is similar to the TS 27.007 "restricted SIM" operation
3071 * where it assumes all of the EF selection will be done by the
3074 * "data" is a const RIL_SIM_IO_v6 *
3075 * Please note that RIL_SIM_IO has a "PIN2" field which may be NULL,
3076 * or may specify a PIN2 for operations that require a PIN2 (eg
3077 * updating FDN records)
3079 * "response" is a const RIL_SIM_IO_Response *
3081 * Arguments and responses that are unused for certain
3082 * values of "command" should be ignored or set to NULL
3086 * RADIO_NOT_AVAILABLE
3091 * REQUEST_NOT_SUPPORTED
3093 #define RIL_REQUEST_SIM_IO 28
3096 * RIL_REQUEST_SEND_USSD
3098 * Send a USSD message
3100 * If a USSD session already exists, the message should be sent in the
3101 * context of that session. Otherwise, a new session should be created.
3103 * The network reply should be reported via RIL_UNSOL_ON_USSD
3105 * Only one USSD session may exist at a time, and the session is assumed
3107 * a) The android system invokes RIL_REQUEST_CANCEL_USSD
3108 * b) The implementation sends a RIL_UNSOL_ON_USSD with a type code
3109 * of "0" (USSD-Notify/no further action) or "2" (session terminated)
3111 * "data" is a const char * containing the USSD request in UTF-8 format
3112 * "response" is NULL
3116 * RADIO_NOT_AVAILABLE
3118 * USSD_MODIFIED_TO_DIAL
3119 * USSD_MODIFIED_TO_SS
3120 * USSD_MODIFIED_TO_USSD
3122 * OPERATION_NOT_ALLOWED
3132 * REQUEST_NOT_SUPPORTED
3134 * See also: RIL_REQUEST_CANCEL_USSD, RIL_UNSOL_ON_USSD
3137 #define RIL_REQUEST_SEND_USSD 29
3140 * RIL_REQUEST_CANCEL_USSD
3142 * Cancel the current USSD session if one exists
3145 * "response" is NULL
3149 * RADIO_NOT_AVAILABLE
3151 * OPERATION_NOT_ALLOWED
3158 * REQUEST_NOT_SUPPORTED
3161 #define RIL_REQUEST_CANCEL_USSD 30
3164 * RIL_REQUEST_GET_CLIR
3166 * Gets current CLIR status
3168 * "response" is int *
3169 * ((int *)data)[0] is "n" parameter from TS 27.007 7.7
3170 * ((int *)data)[1] is "m" parameter from TS 27.007 7.7
3174 * RADIO_NOT_AVAILABLE
3175 * SS_MODIFIED_TO_DIAL
3176 * SS_MODIFIED_TO_USSD
3185 * REQUEST_NOT_SUPPORTED
3187 #define RIL_REQUEST_GET_CLIR 31
3190 * RIL_REQUEST_SET_CLIR
3193 * ((int *)data)[0] is "n" parameter from TS 27.007 7.7
3195 * "response" is NULL
3199 * RADIO_NOT_AVAILABLE
3200 * SS_MODIFIED_TO_DIAL
3201 * SS_MODIFIED_TO_USSD
3209 * REQUEST_NOT_SUPPORTED
3211 #define RIL_REQUEST_SET_CLIR 32
3214 * RIL_REQUEST_QUERY_CALL_FORWARD_STATUS
3216 * "data" is const RIL_CallForwardInfo *
3218 * "response" is const RIL_CallForwardInfo **
3219 * "response" points to an array of RIL_CallForwardInfo *'s, one for
3220 * each distinct registered phone number.
3222 * For example, if data is forwarded to +18005551212 and voice is forwarded
3223 * to +18005559999, then two separate RIL_CallForwardInfo's should be returned
3225 * If, however, both data and voice are forwarded to +18005551212, then
3226 * a single RIL_CallForwardInfo can be returned with the service class
3227 * set to "data + voice = 3")
3231 * RADIO_NOT_AVAILABLE
3232 * SS_MODIFIED_TO_DIAL
3233 * SS_MODIFIED_TO_USSD
3244 * REQUEST_NOT_SUPPORTED
3246 #define RIL_REQUEST_QUERY_CALL_FORWARD_STATUS 33
3250 * RIL_REQUEST_SET_CALL_FORWARD
3252 * Configure call forward rule
3254 * "data" is const RIL_CallForwardInfo *
3255 * "response" is NULL
3259 * RADIO_NOT_AVAILABLE
3260 * SS_MODIFIED_TO_DIAL
3261 * SS_MODIFIED_TO_USSD
3272 * REQUEST_NOT_SUPPORTED
3274 #define RIL_REQUEST_SET_CALL_FORWARD 34
3278 * RIL_REQUEST_QUERY_CALL_WAITING
3280 * Query current call waiting state
3282 * "data" is const int *
3283 * ((const int *)data)[0] is the TS 27.007 service class to query.
3284 * "response" is a const int *
3285 * ((const int *)response)[0] is 0 for "disabled" and 1 for "enabled"
3287 * If ((const int *)response)[0] is = 1, then ((const int *)response)[1]
3288 * must follow, with the TS 27.007 service class bit vector of services
3289 * for which call waiting is enabled.
3291 * For example, if ((const int *)response)[0] is 1 and
3292 * ((const int *)response)[1] is 3, then call waiting is enabled for data
3293 * and voice and disabled for everything else
3297 * RADIO_NOT_AVAILABLE
3298 * SS_MODIFIED_TO_DIAL
3299 * SS_MODIFIED_TO_USSD
3309 * REQUEST_NOT_SUPPORTED
3311 #define RIL_REQUEST_QUERY_CALL_WAITING 35
3315 * RIL_REQUEST_SET_CALL_WAITING
3317 * Configure current call waiting state
3319 * "data" is const int *
3320 * ((const int *)data)[0] is 0 for "disabled" and 1 for "enabled"
3321 * ((const int *)data)[1] is the TS 27.007 service class bit vector of
3322 * services to modify
3323 * "response" is NULL
3327 * RADIO_NOT_AVAILABLE
3328 * SS_MODIFIED_TO_DIAL
3329 * SS_MODIFIED_TO_USSD
3339 * REQUEST_NOT_SUPPORTED
3341 #define RIL_REQUEST_SET_CALL_WAITING 36
3344 * RIL_REQUEST_SMS_ACKNOWLEDGE
3346 * Acknowledge successful or failed receipt of SMS previously indicated
3347 * via RIL_UNSOL_RESPONSE_NEW_SMS
3350 * ((int *)data)[0] is 1 on successful receipt
3351 * (basically, AT+CNMA=1 from TS 27.005
3352 * is 0 on failed receipt
3353 * (basically, AT+CNMA=2 from TS 27.005)
3354 * ((int *)data)[1] if data[0] is 0, this contains the failure cause as defined
3355 * in TS 23.040, 9.2.3.22. Currently only 0xD3 (memory
3356 * capacity exceeded) and 0xFF (unspecified error) are
3359 * "response" is NULL
3361 * FIXME would like request that specified RP-ACK/RP-ERROR PDU
3365 * RADIO_NOT_AVAILABLE
3370 * REQUEST_NOT_SUPPORTED
3372 #define RIL_REQUEST_SMS_ACKNOWLEDGE 37
3375 * RIL_REQUEST_GET_IMEI - DEPRECATED
3377 * Get the device IMEI, including check digit
3379 * The request is DEPRECATED, use RIL_REQUEST_DEVICE_IDENTITY
3380 * Valid when RadioState is not RADIO_STATE_UNAVAILABLE
3383 * "response" is a const char * containing the IMEI
3387 * RADIO_NOT_AVAILABLE (radio resetting)
3393 * REQUEST_NOT_SUPPORTED
3398 #define RIL_REQUEST_GET_IMEI 38
3401 * RIL_REQUEST_GET_IMEISV - DEPRECATED
3403 * Get the device IMEISV, which should be two decimal digits
3405 * The request is DEPRECATED, use RIL_REQUEST_DEVICE_IDENTITY
3406 * Valid when RadioState is not RADIO_STATE_UNAVAILABLE
3409 * "response" is a const char * containing the IMEISV
3413 * RADIO_NOT_AVAILABLE (radio resetting)
3419 * REQUEST_NOT_SUPPORTED
3424 #define RIL_REQUEST_GET_IMEISV 39
3428 * RIL_REQUEST_ANSWER
3430 * Answer incoming call
3432 * Will not be called for WAITING calls.
3433 * RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE will be used in this case
3437 * "response" is NULL
3441 * RADIO_NOT_AVAILABLE (radio resetting)
3450 * REQUEST_NOT_SUPPORTED
3453 #define RIL_REQUEST_ANSWER 40
3456 * RIL_REQUEST_DEACTIVATE_DATA_CALL
3458 * Deactivate packet data connection and remove from the
3459 * data call list if SUCCESS is returned. Any other return
3460 * values should also try to remove the call from the list,
3461 * but that may not be possible. In any event a
3462 * RIL_REQUEST_RADIO_POWER off/on must clear the list. An
3463 * RIL_UNSOL_DATA_CALL_LIST_CHANGED is not expected to be
3464 * issued because of an RIL_REQUEST_DEACTIVATE_DATA_CALL.
3466 * "data" is const char **
3467 * ((char**)data)[0] indicating CID
3468 * ((char**)data)[1] indicating Disconnect Reason
3469 * 0 => No specific reason specified
3470 * 1 => Radio shutdown requested
3472 * "response" is NULL
3476 * RADIO_NOT_AVAILABLE
3480 * REQUEST_NOT_SUPPORTED
3487 * See also: RIL_REQUEST_SETUP_DATA_CALL
3489 #define RIL_REQUEST_DEACTIVATE_DATA_CALL 41
3492 * RIL_REQUEST_QUERY_FACILITY_LOCK
3494 * Query the status of a facility lock state
3496 * "data" is const char **
3497 * ((const char **)data)[0] is the facility string code from TS 27.007 7.4
3498 * (eg "AO" for BAOC, "SC" for SIM lock)
3499 * ((const char **)data)[1] is the password, or "" if not required
3500 * ((const char **)data)[2] is the TS 27.007 service class bit vector of
3502 * ((const char **)data)[3] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
3503 * This is only applicable in the case of Fixed Dialing Numbers
3506 * "response" is an int *
3507 * ((const int *)response) 0 is the TS 27.007 service class bit vector of
3508 * services for which the specified barring facility
3509 * is active. "0" means "disabled for all"
3514 * RADIO_NOT_AVAILABLE
3515 * SS_MODIFIED_TO_DIAL
3516 * SS_MODIFIED_TO_USSD
3526 * REQUEST_NOT_SUPPORTED
3529 #define RIL_REQUEST_QUERY_FACILITY_LOCK 42
3532 * RIL_REQUEST_SET_FACILITY_LOCK
3534 * Enable/disable one facility lock
3536 * "data" is const char **
3538 * ((const char **)data)[0] = facility string code from TS 27.007 7.4
3539 * (eg "AO" for BAOC)
3540 * ((const char **)data)[1] = "0" for "unlock" and "1" for "lock"
3541 * ((const char **)data)[2] = password
3542 * ((const char **)data)[3] = string representation of decimal TS 27.007
3543 * service class bit vector. Eg, the string
3544 * "1" means "set this facility for voice services"
3545 * ((const char **)data)[4] = AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
3546 * This is only applicable in the case of Fixed Dialing Numbers
3549 * "response" is int *
3550 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
3554 * RADIO_NOT_AVAILABLE
3555 * SS_MODIFIED_TO_DIAL
3556 * SS_MODIFIED_TO_USSD
3566 * REQUEST_NOT_SUPPORTED
3569 #define RIL_REQUEST_SET_FACILITY_LOCK 43
3572 * RIL_REQUEST_CHANGE_BARRING_PASSWORD
3574 * Change call barring facility password
3576 * "data" is const char **
3578 * ((const char **)data)[0] = facility string code from TS 27.007 7.4
3579 * (eg "AO" for BAOC)
3580 * ((const char **)data)[1] = old password
3581 * ((const char **)data)[2] = new password
3583 * "response" is NULL
3587 * RADIO_NOT_AVAILABLE
3588 * SS_MODIFIED_TO_DIAL
3589 * SS_MODIFIED_TO_USSD
3599 * REQUEST_NOT_SUPPORTED
3602 #define RIL_REQUEST_CHANGE_BARRING_PASSWORD 44
3605 * RIL_REQUEST_QUERY_NETWORK_SELECTION_MODE
3607 * Query current network selectin mode
3611 * "response" is int *
3612 * ((const int *)response)[0] is
3613 * 0 for automatic selection
3614 * 1 for manual selection
3618 * RADIO_NOT_AVAILABLE
3624 * REQUEST_NOT_SUPPORTED
3629 #define RIL_REQUEST_QUERY_NETWORK_SELECTION_MODE 45
3632 * RIL_REQUEST_SET_NETWORK_SELECTION_AUTOMATIC
3634 * Specify that the network should be selected automatically
3637 * "response" is NULL
3639 * This request must not respond until the new operator is selected
3644 * RADIO_NOT_AVAILABLE
3646 * OPERATION_NOT_ALLOWED
3652 * REQUEST_NOT_SUPPORTED
3656 * Note: Returns ILLEGAL_SIM_OR_ME when the failure is permanent and
3657 * no retries needed, such as illegal SIM or ME.
3660 #define RIL_REQUEST_SET_NETWORK_SELECTION_AUTOMATIC 46
3663 * RIL_REQUEST_SET_NETWORK_SELECTION_MANUAL
3665 * Manually select a specified network.
3667 * "data" is const char * specifying MCCMNC of network to select (eg "310170")
3668 * "response" is NULL
3670 * This request must not respond until the new operator is selected
3675 * RADIO_NOT_AVAILABLE
3677 * OPERATION_NOT_ALLOWED
3684 * REQUEST_NOT_SUPPORTED
3688 * Note: Returns ILLEGAL_SIM_OR_ME when the failure is permanent and
3689 * no retries needed, such as illegal SIM or ME.
3692 #define RIL_REQUEST_SET_NETWORK_SELECTION_MANUAL 47
3695 * RIL_REQUEST_QUERY_AVAILABLE_NETWORKS
3697 * Scans for available networks
3700 * "response" is const char ** that should be an array of n*4 strings, where
3701 * n is the number of available networks
3702 * For each available network:
3704 * ((const char **)response)[n+0] is long alpha ONS or EONS
3705 * ((const char **)response)[n+1] is short alpha ONS or EONS
3706 * ((const char **)response)[n+2] is 5 or 6 digit numeric code (MCC + MNC)
3707 * ((const char **)response)[n+3] is a string value of the status:
3715 * RADIO_NOT_AVAILABLE
3716 * OPERATION_NOT_ALLOWED
3722 * REQUEST_NOT_SUPPORTED
3724 * OPERATION_NOT_ALLOWED
3729 #define RIL_REQUEST_QUERY_AVAILABLE_NETWORKS 48
3732 * RIL_REQUEST_DTMF_START
3734 * Start playing a DTMF tone. Continue playing DTMF tone until
3735 * RIL_REQUEST_DTMF_STOP is received
3737 * If a RIL_REQUEST_DTMF_START is received while a tone is currently playing,
3738 * it should cancel the previous tone and play the new one.
3740 * "data" is a char *
3741 * ((char *)data)[0] is a single character with one of 12 values: 0-9,*,#
3742 * "response" is NULL
3746 * RADIO_NOT_AVAILABLE
3755 * INVALID_MODEM_STATE
3756 * REQUEST_NOT_SUPPORTED
3758 * See also: RIL_REQUEST_DTMF, RIL_REQUEST_DTMF_STOP
3760 #define RIL_REQUEST_DTMF_START 49
3763 * RIL_REQUEST_DTMF_STOP
3765 * Stop playing a currently playing DTMF tone.
3768 * "response" is NULL
3772 * RADIO_NOT_AVAILABLE
3773 * OPERATION_NOT_ALLOWED
3782 * INVALID_MODEM_STATE
3783 * REQUEST_NOT_SUPPORTED
3785 * See also: RIL_REQUEST_DTMF, RIL_REQUEST_DTMF_START
3787 #define RIL_REQUEST_DTMF_STOP 50
3790 * RIL_REQUEST_BASEBAND_VERSION
3792 * Return string value indicating baseband version, eg
3793 * response from AT+CGMR
3796 * "response" is const char * containing version string for log reporting
3800 * RADIO_NOT_AVAILABLE
3807 * REQUEST_NOT_SUPPORTED
3812 #define RIL_REQUEST_BASEBAND_VERSION 51
3815 * RIL_REQUEST_SEPARATE_CONNECTION
3817 * Separate a party from a multiparty call placing the multiparty call
3818 * (less the specified party) on hold and leaving the specified party
3819 * as the only other member of the current (active) call
3823 * See TS 22.084 1.3.8.2 (iii)
3824 * TS 22.030 6.5.5 "Entering "2X followed by send"
3825 * TS 27.007 "AT+CHLD=2x"
3827 * "data" is an int *
3828 * (int *)data)[0] contains Connection index (value of 'x' in CHLD above) "response" is NULL
3830 * "response" is NULL
3834 * RADIO_NOT_AVAILABLE (radio resetting)
3844 * OPERATION_NOT_ALLOWED
3846 * REQUEST_NOT_SUPPORTED
3848 #define RIL_REQUEST_SEPARATE_CONNECTION 52
3852 * RIL_REQUEST_SET_MUTE
3854 * Turn on or off uplink (microphone) mute.
3856 * Will only be sent while voice call is active.
3857 * Will always be reset to "disable mute" when a new voice call is initiated
3859 * "data" is an int *
3860 * (int *)data)[0] is 1 for "enable mute" and 0 for "disable mute"
3862 * "response" is NULL
3866 * RADIO_NOT_AVAILABLE (radio resetting)
3869 * REQUEST_RATE_LIMITED
3873 * REQUEST_NOT_SUPPORTED
3876 #define RIL_REQUEST_SET_MUTE 53
3879 * RIL_REQUEST_GET_MUTE
3881 * Queries the current state of the uplink mute setting
3884 * "response" is an int *
3885 * (int *)response)[0] is 1 for "mute enabled" and 0 for "mute disabled"
3889 * RADIO_NOT_AVAILABLE (radio resetting)
3890 * SS_MODIFIED_TO_DIAL
3891 * SS_MODIFIED_TO_USSD
3894 * REQUEST_RATE_LIMITED
3898 * REQUEST_NOT_SUPPORTED
3901 #define RIL_REQUEST_GET_MUTE 54
3904 * RIL_REQUEST_QUERY_CLIP
3906 * Queries the status of the CLIP supplementary service
3908 * (for MMI code "*#30#")
3911 * "response" is an int *
3912 * (int *)response)[0] is 1 for "CLIP provisioned"
3913 * and 0 for "CLIP not provisioned"
3914 * and 2 for "unknown, e.g. no network etc"
3918 * RADIO_NOT_AVAILABLE (radio resetting)
3926 * REQUEST_NOT_SUPPORTED
3929 #define RIL_REQUEST_QUERY_CLIP 55
3932 * RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE - Deprecated use the status
3933 * field in RIL_Data_Call_Response_v6.
3935 * Requests the failure cause code for the most recently failed PDP
3936 * context or CDMA data connection active
3937 * replaces RIL_REQUEST_LAST_PDP_FAIL_CAUSE
3941 * "response" is a "int *"
3942 * ((int *)response)[0] is an integer cause code defined in TS 24.008
3943 * section 6.1.3.1.3 or close approximation
3945 * If the implementation does not have access to the exact cause codes,
3946 * then it should return one of the values listed in
3947 * RIL_DataCallFailCause, as the UI layer needs to distinguish these
3948 * cases for error notification
3949 * and potential retries.
3953 * RADIO_NOT_AVAILABLE
3958 * REQUEST_NOT_SUPPORTED
3960 * See also: RIL_REQUEST_LAST_CALL_FAIL_CAUSE
3962 * Deprecated use the status field in RIL_Data_Call_Response_v6.
3965 #define RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE 56
3968 * RIL_REQUEST_DATA_CALL_LIST
3970 * Returns the data call list. An entry is added when a
3971 * RIL_REQUEST_SETUP_DATA_CALL is issued and removed on a
3972 * RIL_REQUEST_DEACTIVATE_DATA_CALL. The list is emptied
3973 * when RIL_REQUEST_RADIO_POWER off/on is issued.
3976 * "response" is an array of RIL_Data_Call_Response_v6
3980 * RADIO_NOT_AVAILABLE (radio resetting)
3985 * REQUEST_NOT_SUPPORTED
3988 * See also: RIL_UNSOL_DATA_CALL_LIST_CHANGED
3991 #define RIL_REQUEST_DATA_CALL_LIST 57
3994 * RIL_REQUEST_RESET_RADIO - DEPRECATED
3996 * Request a radio reset. The RIL implementation may postpone
3997 * the reset until after this request is responded to if the baseband
3998 * is presently busy.
4000 * The request is DEPRECATED, use RIL_REQUEST_RADIO_POWER
4003 * "response" is NULL
4007 * RADIO_NOT_AVAILABLE (radio resetting)
4008 * REQUEST_NOT_SUPPORTED
4011 #define RIL_REQUEST_RESET_RADIO 58
4014 * RIL_REQUEST_OEM_HOOK_RAW
4016 * This request reserved for OEM-specific uses. It passes raw byte arrays
4019 * It can be invoked on the Java side from
4020 * com.android.internal.telephony.Phone.invokeOemRilRequestRaw()
4022 * "data" is a char * of bytes copied from the byte[] data argument in java
4023 * "response" is a char * of bytes that will returned via the
4024 * caller's "response" Message here:
4025 * (byte[])(((AsyncResult)response.obj).result)
4027 * An error response here will result in
4028 * (((AsyncResult)response.obj).result) == null and
4029 * (((AsyncResult)response.obj).exception) being an instance of
4030 * com.android.internal.telephony.gsm.CommandException
4036 #define RIL_REQUEST_OEM_HOOK_RAW 59
4039 * RIL_REQUEST_OEM_HOOK_STRINGS
4041 * This request reserved for OEM-specific uses. It passes strings
4044 * It can be invoked on the Java side from
4045 * com.android.internal.telephony.Phone.invokeOemRilRequestStrings()
4047 * "data" is a const char **, representing an array of null-terminated UTF-8
4048 * strings copied from the "String[] strings" argument to
4049 * invokeOemRilRequestStrings()
4051 * "response" is a const char **, representing an array of null-terminated UTF-8
4052 * stings that will be returned via the caller's response message here:
4054 * (String[])(((AsyncResult)response.obj).result)
4056 * An error response here will result in
4057 * (((AsyncResult)response.obj).result) == null and
4058 * (((AsyncResult)response.obj).exception) being an instance of
4059 * com.android.internal.telephony.gsm.CommandException
4065 #define RIL_REQUEST_OEM_HOOK_STRINGS 60
4068 * RIL_REQUEST_SCREEN_STATE - DEPRECATED
4070 * Indicates the current state of the screen. When the screen is off, the
4071 * RIL should notify the baseband to suppress certain notifications (eg,
4072 * signal strength and changes in LAC/CID or BID/SID/NID/latitude/longitude)
4073 * in an effort to conserve power. These notifications should resume when the
4076 * Note this request is deprecated. Use RIL_REQUEST_SEND_DEVICE_STATE to report the device state
4077 * to the modem and use RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER to turn on/off unsolicited
4078 * response from the modem in different scenarios.
4081 * ((int *)data)[0] is == 1 for "Screen On"
4082 * ((int *)data)[0] is == 0 for "Screen Off"
4084 * "response" is NULL
4094 * REQUEST_NOT_SUPPORTED
4096 #define RIL_REQUEST_SCREEN_STATE 61
4100 * RIL_REQUEST_SET_SUPP_SVC_NOTIFICATION
4102 * Enables/disables supplementary service related notifications
4105 * Notifications are reported via RIL_UNSOL_SUPP_SVC_NOTIFICATION.
4108 * ((int *)data)[0] is == 1 for notifications enabled
4109 * ((int *)data)[0] is == 0 for notifications disabled
4111 * "response" is NULL
4115 * RADIO_NOT_AVAILABLE
4124 * REQUEST_NOT_SUPPORTED
4126 * See also: RIL_UNSOL_SUPP_SVC_NOTIFICATION.
4128 #define RIL_REQUEST_SET_SUPP_SVC_NOTIFICATION 62
4131 * RIL_REQUEST_WRITE_SMS_TO_SIM
4133 * Stores a SMS message to SIM memory.
4135 * "data" is RIL_SMS_WriteArgs *
4137 * "response" is int *
4138 * ((const int *)response)[0] is the record index where the message is stored.
4144 * INVALID_SMS_FORMAT
4150 * INVALID_MODEM_STATE
4151 * OPERATION_NOT_ALLOWED
4152 * INVALID_SMSC_ADDRESS
4154 * INVALID_MODEM_STATE
4155 * REQUEST_NOT_SUPPORTED
4159 #define RIL_REQUEST_WRITE_SMS_TO_SIM 63
4162 * RIL_REQUEST_DELETE_SMS_ON_SIM
4164 * Deletes a SMS message from SIM memory.
4167 * ((int *)data)[0] is the record index of the message to delete.
4169 * "response" is NULL
4176 * REQUEST_RATE_LIMITED
4183 * INVALID_MODEM_STATE
4184 * REQUEST_NOT_SUPPORTED
4188 #define RIL_REQUEST_DELETE_SMS_ON_SIM 64
4191 * RIL_REQUEST_SET_BAND_MODE
4193 * Assign a specified band for RF configuration.
4196 * ((int *)data)[0] is a RIL_RadioBandMode
4198 * "response" is NULL
4202 * RADIO_NOT_AVAILABLE
4203 * OPERATION_NOT_ALLOWED
4209 * REQUEST_NOT_SUPPORTED
4213 * See also: RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE
4215 #define RIL_REQUEST_SET_BAND_MODE 65
4218 * RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE
4220 * Query the list of band mode supported by RF.
4224 * "response" is int *
4225 * "response" points to an array of int's, the int[0] is the size of array;
4226 * subsequent values are a list of RIL_RadioBandMode listing supported modes.
4230 * RADIO_NOT_AVAILABLE
4235 * REQUEST_NOT_SUPPORTED
4239 * See also: RIL_REQUEST_SET_BAND_MODE
4241 #define RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE 66
4244 * RIL_REQUEST_STK_GET_PROFILE
4246 * Requests the profile of SIM tool kit.
4247 * The profile indicates the SAT/USAT features supported by ME.
4248 * The SAT/USAT features refer to 3GPP TS 11.14 and 3GPP TS 31.111
4252 * "response" is a const char * containing SAT/USAT profile
4253 * in hexadecimal format string starting with first byte of terminal profile
4257 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4262 * REQUEST_NOT_SUPPORTED
4264 #define RIL_REQUEST_STK_GET_PROFILE 67
4267 * RIL_REQUEST_STK_SET_PROFILE
4269 * Download the STK terminal profile as part of SIM initialization
4272 * "data" is a const char * containing SAT/USAT profile
4273 * in hexadecimal format string starting with first byte of terminal profile
4275 * "response" is NULL
4279 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4284 * REQUEST_NOT_SUPPORTED
4286 #define RIL_REQUEST_STK_SET_PROFILE 68
4289 * RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND
4291 * Requests to send a SAT/USAT envelope command to SIM.
4292 * The SAT/USAT envelope command refers to 3GPP TS 11.14 and 3GPP TS 31.111
4294 * "data" is a const char * containing SAT/USAT command
4295 * in hexadecimal format string starting with command tag
4297 * "response" is a const char * containing SAT/USAT response
4298 * in hexadecimal format string starting with first byte of response
4303 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4305 * OPERATION_NOT_ALLOWED
4312 * REQUEST_NOT_SUPPORTED
4314 #define RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND 69
4317 * RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE
4319 * Requests to send a terminal response to SIM for a received
4322 * "data" is a const char * containing SAT/USAT response
4323 * in hexadecimal format string starting with first byte of response data
4325 * "response" is NULL
4329 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4330 * RIL_E_OPERATION_NOT_ALLOWED
4335 * INVALID_MODEM_STATE
4336 * REQUEST_NOT_SUPPORTED
4338 #define RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE 70
4341 * RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM
4343 * When STK application gets RIL_UNSOL_STK_CALL_SETUP, the call actually has
4344 * been initialized by ME already. (We could see the call has been in the 'call
4345 * list') So, STK application needs to accept/reject the call according as user
4349 * ((int *)data)[0] is > 0 for "accept" the call setup
4350 * ((int *)data)[0] is == 0 for "reject" the call setup
4352 * "response" is NULL
4356 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4357 * RIL_E_OPERATION_NOT_ALLOWED
4362 * REQUEST_NOT_SUPPORTED
4364 #define RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM 71
4367 * RIL_REQUEST_EXPLICIT_CALL_TRANSFER
4369 * Connects the two calls and disconnects the subscriber from both calls.
4372 * "response" is NULL
4376 * RADIO_NOT_AVAILABLE (radio resetting)
4386 * OPERATION_NOT_ALLOWED
4389 * REQUEST_NOT_SUPPORTED
4391 #define RIL_REQUEST_EXPLICIT_CALL_TRANSFER 72
4394 * RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE
4396 * Requests to set the preferred network type for searching and registering
4397 * (CS/PS domain, RAT, and operation mode)
4399 * "data" is int * which is RIL_PreferredNetworkType
4401 * "response" is NULL
4405 * RADIO_NOT_AVAILABLE (radio resetting)
4406 * OPERATION_NOT_ALLOWED
4407 * MODE_NOT_SUPPORTED
4413 * REQUEST_NOT_SUPPORTED
4417 #define RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE 73
4420 * RIL_REQUEST_GET_PREFERRED_NETWORK_TYPE
4422 * Query the preferred network type (CS/PS domain, RAT, and operation mode)
4423 * for searching and registering
4427 * "response" is int *
4428 * ((int *)reponse)[0] is == RIL_PreferredNetworkType
4432 * RADIO_NOT_AVAILABLE
4438 * REQUEST_NOT_SUPPORTED
4442 * See also: RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE
4444 #define RIL_REQUEST_GET_PREFERRED_NETWORK_TYPE 74
4447 * RIL_REQUEST_NEIGHBORING_CELL_IDS
4449 * Request neighboring cell id in GSM network
4452 * "response" must be a " const RIL_NeighboringCell** "
4456 * RADIO_NOT_AVAILABLE
4462 * REQUEST_NOT_SUPPORTED
4466 #define RIL_REQUEST_GET_NEIGHBORING_CELL_IDS 75
4469 * RIL_REQUEST_SET_LOCATION_UPDATES
4471 * Enables/disables network state change notifications due to changes in
4472 * LAC and/or CID (for GSM) or BID/SID/NID/latitude/longitude (for CDMA).
4473 * Basically +CREG=2 vs. +CREG=1 (TS 27.007).
4475 * Note: The RIL implementation should default to "updates enabled"
4476 * when the screen is on and "updates disabled" when the screen is off.
4479 * ((int *)data)[0] is == 1 for updates enabled (+CREG=2)
4480 * ((int *)data)[0] is == 0 for updates disabled (+CREG=1)
4482 * "response" is NULL
4486 * RADIO_NOT_AVAILABLE
4492 * REQUEST_NOT_SUPPORTED
4496 * See also: RIL_REQUEST_SCREEN_STATE, RIL_UNSOL_RESPONSE_NETWORK_STATE_CHANGED
4498 #define RIL_REQUEST_SET_LOCATION_UPDATES 76
4501 * RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE
4503 * Request to set the location where the CDMA subscription shall
4507 * ((int *)data)[0] is == RIL_CdmaSubscriptionSource
4509 * "response" is NULL
4513 * RADIO_NOT_AVAILABLE
4515 * SUBSCRIPTION_NOT_AVAILABLE
4520 * REQUEST_NOT_SUPPORTED
4522 * See also: RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE
4524 #define RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE 77
4527 * RIL_REQUEST_CDMA_SET_ROAMING_PREFERENCE
4529 * Request to set the roaming preferences in CDMA
4532 * ((int *)data)[0] is == 0 for Home Networks only, as defined in PRL
4533 * ((int *)data)[0] is == 1 for Roaming on Affiliated networks, as defined in PRL
4534 * ((int *)data)[0] is == 2 for Roaming on Any Network, as defined in the PRL
4536 * "response" is NULL
4540 * RADIO_NOT_AVAILABLE
4546 * REQUEST_NOT_SUPPORTED
4547 * OPERATION_NOT_ALLOWED
4551 #define RIL_REQUEST_CDMA_SET_ROAMING_PREFERENCE 78
4554 * RIL_REQUEST_CDMA_QUERY_ROAMING_PREFERENCE
4556 * Request the actual setting of the roaming preferences in CDMA in the modem
4560 * "response" is int *
4561 * ((int *)response)[0] is == 0 for Home Networks only, as defined in PRL
4562 * ((int *)response)[0] is == 1 for Roaming on Affiliated networks, as defined in PRL
4563 * ((int *)response)[0] is == 2 for Roaming on Any Network, as defined in the PRL
4565 * "response" is NULL
4569 * RADIO_NOT_AVAILABLE
4575 * REQUEST_NOT_SUPPORTED
4579 #define RIL_REQUEST_CDMA_QUERY_ROAMING_PREFERENCE 79
4582 * RIL_REQUEST_SET_TTY_MODE
4584 * Request to set the TTY mode
4587 * ((int *)data)[0] is == 0 for TTY off
4588 * ((int *)data)[0] is == 1 for TTY Full
4589 * ((int *)data)[0] is == 2 for TTY HCO (hearing carryover)
4590 * ((int *)data)[0] is == 3 for TTY VCO (voice carryover)
4592 * "response" is NULL
4596 * RADIO_NOT_AVAILABLE
4607 * REQUEST_NOT_SUPPORTED
4609 #define RIL_REQUEST_SET_TTY_MODE 80
4612 * RIL_REQUEST_QUERY_TTY_MODE
4614 * Request the setting of TTY mode
4618 * "response" is int *
4619 * ((int *)response)[0] is == 0 for TTY off
4620 * ((int *)response)[0] is == 1 for TTY Full
4621 * ((int *)response)[0] is == 2 for TTY HCO (hearing carryover)
4622 * ((int *)response)[0] is == 3 for TTY VCO (voice carryover)
4624 * "response" is NULL
4628 * RADIO_NOT_AVAILABLE
4635 * REQUEST_NOT_SUPPORTED
4637 #define RIL_REQUEST_QUERY_TTY_MODE 81
4640 * RIL_REQUEST_CDMA_SET_PREFERRED_VOICE_PRIVACY_MODE
4642 * Request to set the preferred voice privacy mode used in voice
4646 * ((int *)data)[0] is == 0 for Standard Privacy Mode (Public Long Code Mask)
4647 * ((int *)data)[0] is == 1 for Enhanced Privacy Mode (Private Long Code Mask)
4649 * "response" is NULL
4653 * RADIO_NOT_AVAILABLE
4662 * REQUEST_NOT_SUPPORTED
4664 #define RIL_REQUEST_CDMA_SET_PREFERRED_VOICE_PRIVACY_MODE 82
4667 * RIL_REQUEST_CDMA_QUERY_PREFERRED_VOICE_PRIVACY_MODE
4669 * Request the setting of preferred voice privacy mode
4673 * "response" is int *
4674 * ((int *)response)[0] is == 0 for Standard Privacy Mode (Public Long Code Mask)
4675 * ((int *)response)[0] is == 1 for Enhanced Privacy Mode (Private Long Code Mask)
4677 * "response" is NULL
4681 * RADIO_NOT_AVAILABLE
4688 * REQUEST_NOT_SUPPORTED
4690 #define RIL_REQUEST_CDMA_QUERY_PREFERRED_VOICE_PRIVACY_MODE 83
4693 * RIL_REQUEST_CDMA_FLASH
4697 * "data" is const char *
4698 * ((const char *)data)[0] is a FLASH string
4700 * "response" is NULL
4704 * RADIO_NOT_AVAILABLE
4714 * REQUEST_NOT_SUPPORTED
4717 #define RIL_REQUEST_CDMA_FLASH 84
4720 * RIL_REQUEST_CDMA_BURST_DTMF
4724 * "data" is const char **
4725 * ((const char **)data)[0] is a DTMF string
4726 * ((const char **)data)[1] is the DTMF ON length in milliseconds, or 0 to use
4728 * ((const char **)data)[2] is the DTMF OFF length in milliseconds, or 0 to use
4731 * "response" is NULL
4735 * RADIO_NOT_AVAILABLE
4744 * OPERATION_NOT_ALLOWED
4745 * REQUEST_NOT_SUPPORTED
4748 #define RIL_REQUEST_CDMA_BURST_DTMF 85
4751 * RIL_REQUEST_CDMA_VALIDATE_AND_WRITE_AKEY
4753 * Takes a 26 digit string (20 digit AKEY + 6 digit checksum).
4754 * If the checksum is valid the 20 digit AKEY is written to NV,
4755 * replacing the existing AKEY no matter what it was before.
4757 * "data" is const char *
4758 * ((const char *)data)[0] is a 26 digit string (ASCII digits '0'-'9')
4759 * where the last 6 digits are a checksum of the
4760 * first 20, as specified in TR45.AHAG
4761 * "Common Cryptographic Algorithms, Revision D.1
4764 * "response" is NULL
4768 * RADIO_NOT_AVAILABLE
4774 * REQUEST_NOT_SUPPORTED
4779 #define RIL_REQUEST_CDMA_VALIDATE_AND_WRITE_AKEY 86
4782 * RIL_REQUEST_CDMA_SEND_SMS
4784 * Send a CDMA SMS message
4786 * "data" is const RIL_CDMA_SMS_Message *
4788 * "response" is a const RIL_SMS_Response *
4790 * Based on the return error, caller decides to resend if sending sms
4791 * fails. The CDMA error class is derived as follows,
4792 * SUCCESS is error class 0 (no error)
4793 * SMS_SEND_FAIL_RETRY is error class 2 (temporary failure)
4797 * RADIO_NOT_AVAILABLE
4798 * SMS_SEND_FAIL_RETRY
4803 * REQUEST_RATE_LIMITED
4804 * INVALID_SMS_FORMAT
4810 * INVALID_SMSC_ADDRESS
4811 * OPERATION_NOT_ALLOWED
4814 * REQUEST_NOT_SUPPORTED
4815 * MODE_NOT_SUPPORTED
4819 #define RIL_REQUEST_CDMA_SEND_SMS 87
4822 * RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE
4824 * Acknowledge the success or failure in the receipt of SMS
4825 * previously indicated via RIL_UNSOL_RESPONSE_CDMA_NEW_SMS
4827 * "data" is const RIL_CDMA_SMS_Ack *
4829 * "response" is NULL
4833 * RADIO_NOT_AVAILABLE
4838 * REQUEST_RATE_LIMITED
4842 * OPERATION_NOT_ALLOWED
4844 * INVALID_MODEM_STATE
4845 * REQUEST_NOT_SUPPORTED
4848 #define RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE 88
4851 * RIL_REQUEST_GSM_GET_BROADCAST_SMS_CONFIG
4853 * Request the setting of GSM/WCDMA Cell Broadcast SMS config.
4857 * "response" is a const RIL_GSM_BroadcastSmsConfigInfo **
4858 * "responselen" is count * sizeof (RIL_GSM_BroadcastSmsConfigInfo *)
4862 * RADIO_NOT_AVAILABLE
4865 * REQUEST_RATE_LIMITED
4873 * INVALID_MODEM_STATE
4874 * REQUEST_NOT_SUPPORTED
4876 #define RIL_REQUEST_GSM_GET_BROADCAST_SMS_CONFIG 89
4879 * RIL_REQUEST_GSM_SET_BROADCAST_SMS_CONFIG
4881 * Set GSM/WCDMA Cell Broadcast SMS config
4883 * "data" is a const RIL_GSM_BroadcastSmsConfigInfo **
4884 * "datalen" is count * sizeof(RIL_GSM_BroadcastSmsConfigInfo *)
4886 * "response" is NULL
4890 * RADIO_NOT_AVAILABLE
4895 * REQUEST_RATE_LIMITED
4901 * INVALID_MODEM_STATE
4902 * REQUEST_NOT_SUPPORTED
4905 #define RIL_REQUEST_GSM_SET_BROADCAST_SMS_CONFIG 90
4908 * RIL_REQUEST_GSM_SMS_BROADCAST_ACTIVATION
4910 * Enable or disable the reception of GSM/WCDMA Cell Broadcast SMS
4912 * "data" is const int *
4913 * (const int *)data[0] indicates to activate or turn off the
4914 * reception of GSM/WCDMA Cell Broadcast SMS, 0-1,
4915 * 0 - Activate, 1 - Turn off
4917 * "response" is NULL
4921 * RADIO_NOT_AVAILABLE
4926 * REQUEST_RATE_LIMITED
4931 * INVALID_MODEM_STATE
4932 * REQUEST_NOT_SUPPORTED
4935 #define RIL_REQUEST_GSM_SMS_BROADCAST_ACTIVATION 91
4938 * RIL_REQUEST_CDMA_GET_BROADCAST_SMS_CONFIG
4940 * Request the setting of CDMA Broadcast SMS config
4944 * "response" is a const RIL_CDMA_BroadcastSmsConfigInfo **
4945 * "responselen" is count * sizeof (RIL_CDMA_BroadcastSmsConfigInfo *)
4949 * RADIO_NOT_AVAILABLE
4952 * REQUEST_RATE_LIMITED
4960 * INVALID_MODEM_STATE
4961 * REQUEST_NOT_SUPPORTED
4964 #define RIL_REQUEST_CDMA_GET_BROADCAST_SMS_CONFIG 92
4967 * RIL_REQUEST_CDMA_SET_BROADCAST_SMS_CONFIG
4969 * Set CDMA Broadcast SMS config
4971 * "data" is a const RIL_CDMA_BroadcastSmsConfigInfo **
4972 * "datalen" is count * sizeof(const RIL_CDMA_BroadcastSmsConfigInfo *)
4974 * "response" is NULL
4978 * RADIO_NOT_AVAILABLE
4983 * REQUEST_RATE_LIMITED
4989 * INVALID_MODEM_STATE
4990 * REQUEST_NOT_SUPPORTED
4993 #define RIL_REQUEST_CDMA_SET_BROADCAST_SMS_CONFIG 93
4996 * RIL_REQUEST_CDMA_SMS_BROADCAST_ACTIVATION
4998 * Enable or disable the reception of CDMA Broadcast SMS
5000 * "data" is const int *
5001 * (const int *)data[0] indicates to activate or turn off the
5002 * reception of CDMA Broadcast SMS, 0-1,
5003 * 0 - Activate, 1 - Turn off
5005 * "response" is NULL
5009 * RADIO_NOT_AVAILABLE
5014 * REQUEST_RATE_LIMITED
5019 * INVALID_MODEM_STATE
5020 * REQUEST_NOT_SUPPORTED
5023 #define RIL_REQUEST_CDMA_SMS_BROADCAST_ACTIVATION 94
5026 * RIL_REQUEST_CDMA_SUBSCRIPTION
5028 * Request the device MDN / H_SID / H_NID.
5030 * The request is only allowed when CDMA subscription is available. When CDMA
5031 * subscription is changed, application layer should re-issue the request to
5032 * update the subscription information.
5034 * If a NULL value is returned for any of the device id, it means that error
5035 * accessing the device.
5037 * "response" is const char **
5038 * ((const char **)response)[0] is MDN if CDMA subscription is available
5039 * ((const char **)response)[1] is a comma separated list of H_SID (Home SID) if
5040 * CDMA subscription is available, in decimal format
5041 * ((const char **)response)[2] is a comma separated list of H_NID (Home NID) if
5042 * CDMA subscription is available, in decimal format
5043 * ((const char **)response)[3] is MIN (10 digits, MIN2+MIN1) if CDMA subscription is available
5044 * ((const char **)response)[4] is PRL version if CDMA subscription is available
5048 * RIL_E_SUBSCRIPTION_NOT_AVAILABLE
5055 * REQUEST_NOT_SUPPORTED
5062 #define RIL_REQUEST_CDMA_SUBSCRIPTION 95
5065 * RIL_REQUEST_CDMA_WRITE_SMS_TO_RUIM
5067 * Stores a CDMA SMS message to RUIM memory.
5069 * "data" is RIL_CDMA_SMS_WriteArgs *
5071 * "response" is int *
5072 * ((const int *)response)[0] is the record index where the message is stored.
5076 * RADIO_NOT_AVAILABLE
5079 * INVALID_SMS_FORMAT
5085 * INVALID_MODEM_STATE
5086 * OPERATION_NOT_ALLOWED
5087 * INVALID_SMSC_ADDRESS
5089 * INVALID_MODEM_STATE
5090 * REQUEST_NOT_SUPPORTED
5094 #define RIL_REQUEST_CDMA_WRITE_SMS_TO_RUIM 96
5097 * RIL_REQUEST_CDMA_DELETE_SMS_ON_RUIM
5099 * Deletes a CDMA SMS message from RUIM memory.
5102 * ((int *)data)[0] is the record index of the message to delete.
5104 * "response" is NULL
5108 * RADIO_NOT_AVAILABLE
5111 * REQUEST_RATE_LIMITED
5118 * INVALID_MODEM_STATE
5119 * REQUEST_NOT_SUPPORTED
5122 #define RIL_REQUEST_CDMA_DELETE_SMS_ON_RUIM 97
5125 * RIL_REQUEST_DEVICE_IDENTITY
5127 * Request the device ESN / MEID / IMEI / IMEISV.
5129 * The request is always allowed and contains GSM and CDMA device identity;
5130 * it substitutes the deprecated requests RIL_REQUEST_GET_IMEI and
5131 * RIL_REQUEST_GET_IMEISV.
5133 * If a NULL value is returned for any of the device id, it means that error
5134 * accessing the device.
5136 * When CDMA subscription is changed the ESN/MEID may change. The application
5137 * layer should re-issue the request to update the device identity in this case.
5139 * "response" is const char **
5140 * ((const char **)response)[0] is IMEI if GSM subscription is available
5141 * ((const char **)response)[1] is IMEISV if GSM subscription is available
5142 * ((const char **)response)[2] is ESN if CDMA subscription is available
5143 * ((const char **)response)[3] is MEID if CDMA subscription is available
5147 * RADIO_NOT_AVAILABLE
5154 * REQUEST_NOT_SUPPORTED
5159 #define RIL_REQUEST_DEVICE_IDENTITY 98
5162 * RIL_REQUEST_EXIT_EMERGENCY_CALLBACK_MODE
5164 * Request the radio's system selection module to exit emergency
5165 * callback mode. RIL will not respond with SUCCESS until the modem has
5166 * completely exited from Emergency Callback Mode.
5170 * "response" is NULL
5174 * RADIO_NOT_AVAILABLE
5175 * OPERATION_NOT_ALLOWED
5181 * REQUEST_NOT_SUPPORTED
5186 #define RIL_REQUEST_EXIT_EMERGENCY_CALLBACK_MODE 99
5189 * RIL_REQUEST_GET_SMSC_ADDRESS
5191 * Queries the default Short Message Service Center address on the device.
5195 * "response" is const char * containing the SMSC address.
5199 * RADIO_NOT_AVAILABLE
5201 * REQUEST_RATE_LIMITED
5206 * INVALID_MODEM_STATE
5210 * REQUEST_NOT_SUPPORTED
5214 #define RIL_REQUEST_GET_SMSC_ADDRESS 100
5217 * RIL_REQUEST_SET_SMSC_ADDRESS
5219 * Sets the default Short Message Service Center address on the device.
5221 * "data" is const char * containing the SMSC address.
5223 * "response" is NULL
5227 * RADIO_NOT_AVAILABLE
5229 * INVALID_SMS_FORMAT
5232 * REQUEST_RATE_LIMITED
5237 * REQUEST_NOT_SUPPORTED
5240 #define RIL_REQUEST_SET_SMSC_ADDRESS 101
5243 * RIL_REQUEST_REPORT_SMS_MEMORY_STATUS
5245 * Indicates whether there is storage available for new SMS messages.
5248 * ((int *)data)[0] is 1 if memory is available for storing new messages
5249 * is 0 if memory capacity is exceeded
5251 * "response" is NULL
5255 * RADIO_NOT_AVAILABLE
5260 * REQUEST_RATE_LIMITED
5265 * REQUEST_NOT_SUPPORTED
5268 #define RIL_REQUEST_REPORT_SMS_MEMORY_STATUS 102
5271 * RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING
5273 * Indicates that the StkSerivce is running and is
5274 * ready to receive RIL_UNSOL_STK_XXXXX commands.
5277 * "response" is NULL
5281 * RADIO_NOT_AVAILABLE
5286 * REQUEST_NOT_SUPPORTED
5289 #define RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING 103
5292 * RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE
5294 * Request to query the location where the CDMA subscription shall
5299 * "response" is int *
5300 * ((int *)data)[0] is == RIL_CdmaSubscriptionSource
5304 * RADIO_NOT_AVAILABLE
5305 * SUBSCRIPTION_NOT_AVAILABLE
5310 * REQUEST_NOT_SUPPORTED
5312 * See also: RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE
5314 #define RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE 104
5317 * RIL_REQUEST_ISIM_AUTHENTICATION
5319 * Request the ISIM application on the UICC to perform AKA
5320 * challenge/response algorithm for IMS authentication
5322 * "data" is a const char * containing the challenge string in Base64 format
5323 * "response" is a const char * containing the response in Base64 format
5327 * RADIO_NOT_AVAILABLE
5332 * REQUEST_NOT_SUPPORTED
5334 #define RIL_REQUEST_ISIM_AUTHENTICATION 105
5337 * RIL_REQUEST_ACKNOWLEDGE_INCOMING_GSM_SMS_WITH_PDU
5339 * Acknowledge successful or failed receipt of SMS previously indicated
5340 * via RIL_UNSOL_RESPONSE_NEW_SMS, including acknowledgement TPDU to send
5341 * as the RP-User-Data element of the RP-ACK or RP-ERROR PDU.
5343 * "data" is const char **
5344 * ((const char **)data)[0] is "1" on successful receipt (send RP-ACK)
5345 * is "0" on failed receipt (send RP-ERROR)
5346 * ((const char **)data)[1] is the acknowledgement TPDU in hexadecimal format
5348 * "response" is NULL
5352 * RADIO_NOT_AVAILABLE
5357 * REQUEST_NOT_SUPPORTED
5359 #define RIL_REQUEST_ACKNOWLEDGE_INCOMING_GSM_SMS_WITH_PDU 106
5362 * RIL_REQUEST_STK_SEND_ENVELOPE_WITH_STATUS
5364 * Requests to send a SAT/USAT envelope command to SIM.
5365 * The SAT/USAT envelope command refers to 3GPP TS 11.14 and 3GPP TS 31.111.
5367 * This request has one difference from RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND:
5368 * the SW1 and SW2 status bytes from the UICC response are returned along with
5369 * the response data, using the same structure as RIL_REQUEST_SIM_IO.
5371 * The RIL implementation shall perform the normal processing of a '91XX'
5372 * response in SW1/SW2 to retrieve the pending proactive command and send it
5373 * as an unsolicited response, as RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND does.
5375 * "data" is a const char * containing the SAT/USAT command
5376 * in hexadecimal format starting with command tag
5378 * "response" is a const RIL_SIM_IO_Response *
5382 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
5384 * OPERATION_NOT_ALLOWED
5389 * REQUEST_NOT_SUPPORTED
5392 #define RIL_REQUEST_STK_SEND_ENVELOPE_WITH_STATUS 107
5395 * RIL_REQUEST_VOICE_RADIO_TECH
5397 * Query the radio technology type (3GPP/3GPP2) used for voice. Query is valid only
5398 * when radio state is not RADIO_STATE_UNAVAILABLE
5401 * "response" is int *
5402 * ((int *) response)[0] is of type const RIL_RadioTechnology
5406 * RADIO_NOT_AVAILABLE
5411 * REQUEST_NOT_SUPPORTED
5413 #define RIL_REQUEST_VOICE_RADIO_TECH 108
5416 * RIL_REQUEST_GET_CELL_INFO_LIST
5418 * Request all of the current cell information known to the radio. The radio
5419 * must a list of all current cells, including the neighboring cells. If for a particular
5420 * cell information isn't known then the appropriate unknown value will be returned.
5421 * This does not cause or change the rate of RIL_UNSOL_CELL_INFO_LIST.
5425 * "response" is an array of RIL_CellInfo_v12.
5429 * RADIO_NOT_AVAILABLE
5435 * REQUEST_NOT_SUPPORTED
5440 #define RIL_REQUEST_GET_CELL_INFO_LIST 109
5443 * RIL_REQUEST_SET_UNSOL_CELL_INFO_LIST_RATE
5445 * Sets the minimum time between when RIL_UNSOL_CELL_INFO_LIST should be invoked.
5446 * A value of 0, means invoke RIL_UNSOL_CELL_INFO_LIST when any of the reported
5447 * information changes. Setting the value to INT_MAX(0x7fffffff) means never issue
5448 * a RIL_UNSOL_CELL_INFO_LIST.
5451 * ((int *)data)[0] is minimum time in milliseconds
5453 * "response" is NULL
5457 * RADIO_NOT_AVAILABLE
5462 * REQUEST_NOT_SUPPORTED
5466 #define RIL_REQUEST_SET_UNSOL_CELL_INFO_LIST_RATE 110
5469 * RIL_REQUEST_SET_INITIAL_ATTACH_APN
5471 * Set an apn to initial attach network
5473 * "data" is a const char **
5474 * ((const char **)data)[0] is the APN to connect if radio technology is LTE
5475 * ((const char **)data)[1] is the connection type to request must be one of the
5476 * PDP_type values in TS 27.007 section 10.1.1.
5477 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
5478 * ((const char **)data)[2] is the PAP / CHAP auth type. Values:
5479 * 0 => PAP and CHAP is never performed.
5480 * 1 => PAP may be performed; CHAP is never performed.
5481 * 2 => CHAP may be performed; PAP is never performed.
5482 * 3 => PAP / CHAP may be performed - baseband dependent.
5483 * ((const char **)data)[3] is the username for APN, or NULL
5484 * ((const char **)data)[4] is the password for APN, or NULL
5486 * "response" is NULL
5490 * RADIO_NOT_AVAILABLE (radio resetting)
5491 * SUBSCRIPTION_NOT_AVAILABLE
5498 * REQUEST_NOT_SUPPORTED
5503 #define RIL_REQUEST_SET_INITIAL_ATTACH_APN 111
5506 * RIL_REQUEST_IMS_REGISTRATION_STATE
5508 * This message is DEPRECATED and shall be removed in a future release (target: 2018);
5509 * instead, provide IMS registration status via an IMS Service.
5511 * Request current IMS registration state
5515 * "response" is int *
5516 * ((int *)response)[0] is registration state:
5517 * 0 - Not registered
5520 * If ((int*)response)[0] is = 1, then ((int *) response)[1]
5521 * must follow with IMS SMS format:
5523 * ((int *) response)[1] is of type RIL_RadioTechnologyFamily
5527 * RADIO_NOT_AVAILABLE
5532 * INVALID_MODEM_STATE
5533 * REQUEST_NOT_SUPPORTED
5535 #define RIL_REQUEST_IMS_REGISTRATION_STATE 112
5538 * RIL_REQUEST_IMS_SEND_SMS
5540 * Send a SMS message over IMS
5542 * "data" is const RIL_IMS_SMS_Message *
5544 * "response" is a const RIL_SMS_Response *
5546 * Based on the return error, caller decides to resend if sending sms
5547 * fails. SMS_SEND_FAIL_RETRY means retry, and other errors means no retry.
5548 * In case of retry, data is encoded based on Voice Technology available.
5552 * RADIO_NOT_AVAILABLE
5553 * SMS_SEND_FAIL_RETRY
5559 * INVALID_SMS_FORMAT
5561 * REQUEST_RATE_LIMITED
5565 * INVALID_SMSC_ADDRESS
5566 * OPERATION_NOT_ALLOWED
5570 * REQUEST_NOT_SUPPORTED
5573 #define RIL_REQUEST_IMS_SEND_SMS 113
5576 * RIL_REQUEST_SIM_TRANSMIT_APDU_BASIC
5578 * Request APDU exchange on the basic channel. This command reflects TS 27.007
5579 * "generic SIM access" operation (+CSIM). The modem must ensure proper function
5580 * of GSM/CDMA, and filter commands appropriately. It should filter
5581 * channel management and SELECT by DF name commands.
5583 * "data" is a const RIL_SIM_APDU *
5584 * "sessionid" field should be ignored.
5586 * "response" is a const RIL_SIM_IO_Response *
5590 * RADIO_NOT_AVAILABLE
5595 * REQUEST_NOT_SUPPORTED
5597 #define RIL_REQUEST_SIM_TRANSMIT_APDU_BASIC 114
5600 * RIL_REQUEST_SIM_OPEN_CHANNEL
5602 * Open a new logical channel and select the given application. This command
5603 * reflects TS 27.007 "open logical channel" operation (+CCHO). This request
5604 * also specifies the P2 parameter (described in ISO 7816-4).
5606 * "data" is a const RIL_OpenChannelParam *
5608 * "response" is int *
5609 * ((int *)data)[0] contains the session id of the logical channel.
5610 * ((int *)data)[1] onwards may optionally contain the select response for the
5611 * open channel command with one byte per integer.
5615 * RADIO_NOT_AVAILABLE
5625 * REQUEST_NOT_SUPPORTED
5627 #define RIL_REQUEST_SIM_OPEN_CHANNEL 115
5630 * RIL_REQUEST_SIM_CLOSE_CHANNEL
5632 * Close a previously opened logical channel. This command reflects TS 27.007
5633 * "close logical channel" operation (+CCHC).
5636 * ((int *)data)[0] is the session id of logical the channel to close.
5638 * "response" is NULL
5642 * RADIO_NOT_AVAILABLE
5647 * REQUEST_NOT_SUPPORTED
5649 #define RIL_REQUEST_SIM_CLOSE_CHANNEL 116
5652 * RIL_REQUEST_SIM_TRANSMIT_APDU_CHANNEL
5654 * Exchange APDUs with a UICC over a previously opened logical channel. This
5655 * command reflects TS 27.007 "generic logical channel access" operation
5656 * (+CGLA). The modem should filter channel management and SELECT by DF name
5659 * "data" is a const RIL_SIM_APDU*
5661 * "response" is a const RIL_SIM_IO_Response *
5665 * RADIO_NOT_AVAILABLE
5670 * REQUEST_NOT_SUPPORTED
5672 #define RIL_REQUEST_SIM_TRANSMIT_APDU_CHANNEL 117
5675 * RIL_REQUEST_NV_READ_ITEM
5677 * Read one of the radio NV items defined in RadioNVItems.java / ril_nv_items.h.
5678 * This is used for device configuration by some CDMA operators.
5680 * "data" is a const RIL_NV_ReadItem *
5682 * "response" is const char * containing the contents of the NV item
5686 * RADIO_NOT_AVAILABLE
5687 * REQUEST_NOT_SUPPORTED
5689 #define RIL_REQUEST_NV_READ_ITEM 118
5692 * RIL_REQUEST_NV_WRITE_ITEM
5694 * Write one of the radio NV items defined in RadioNVItems.java / ril_nv_items.h.
5695 * This is used for device configuration by some CDMA operators.
5697 * "data" is a const RIL_NV_WriteItem *
5699 * "response" is NULL
5703 * RADIO_NOT_AVAILABLE
5704 * REQUEST_NOT_SUPPORTED
5706 #define RIL_REQUEST_NV_WRITE_ITEM 119
5709 * RIL_REQUEST_NV_WRITE_CDMA_PRL
5711 * Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
5712 * This is used for device configuration by some CDMA operators.
5714 * "data" is a const char * containing the PRL as a byte array
5716 * "response" is NULL
5720 * RADIO_NOT_AVAILABLE
5721 * REQUEST_NOT_SUPPORTED
5723 #define RIL_REQUEST_NV_WRITE_CDMA_PRL 120
5726 * RIL_REQUEST_NV_RESET_CONFIG
5728 * Reset the radio NV configuration to the factory state.
5729 * This is used for device configuration by some CDMA operators.
5732 * ((int *)data)[0] is 1 to reload all NV items
5733 * ((int *)data)[0] is 2 for erase NV reset (SCRTN)
5734 * ((int *)data)[0] is 3 for factory reset (RTN)
5736 * "response" is NULL
5740 * RADIO_NOT_AVAILABLE
5741 * REQUEST_NOT_SUPPORTED
5743 #define RIL_REQUEST_NV_RESET_CONFIG 121
5745 /** RIL_REQUEST_SET_UICC_SUBSCRIPTION
5746 * FIXME This API needs to have more documentation.
5748 * Selection/de-selection of a subscription from a SIM card
5749 * "data" is const RIL_SelectUiccSub*
5752 * "response" is NULL
5756 * RADIO_NOT_AVAILABLE (radio resetting)
5757 * SUBSCRIPTION_NOT_SUPPORTED
5763 * REQUEST_NOT_SUPPORTED
5768 #define RIL_REQUEST_SET_UICC_SUBSCRIPTION 122
5771 * RIL_REQUEST_ALLOW_DATA
5773 * Tells the modem whether data calls are allowed or not
5776 * FIXME slotId and aid will be added.
5777 * ((int *)data)[0] is == 0 to allow data calls
5778 * ((int *)data)[0] is == 1 to disallow data calls
5780 * "response" is NULL
5785 * RADIO_NOT_AVAILABLE (radio resetting)
5792 * INVALID_MODEM_STATE
5793 * REQUEST_NOT_SUPPORTED
5798 #define RIL_REQUEST_ALLOW_DATA 123
5801 * RIL_REQUEST_GET_HARDWARE_CONFIG
5803 * Request all of the current hardware (modem and sim) associated
5808 * "response" is an array of RIL_HardwareConfig.
5811 * RADIO_NOT_AVAILABLE
5812 * REQUEST_NOT_SUPPORTED
5814 #define RIL_REQUEST_GET_HARDWARE_CONFIG 124
5817 * RIL_REQUEST_SIM_AUTHENTICATION
5819 * Returns the response of SIM Authentication through RIL to a
5820 * challenge request.
5822 * "data" Base64 encoded string containing challenge:
5823 * int authContext; P2 value of authentication command, see P2 parameter in
5824 * 3GPP TS 31.102 7.1.2
5825 * char *authData; the challenge string in Base64 format, see 3GPP
5827 * char *aid; AID value, See ETSI 102.221 8.1 and 101.220 4,
5830 * "response" Base64 encoded strings containing response:
5831 * int sw1; Status bytes per 3GPP TS 31.102 section 7.3
5833 * char *simResponse; Response in Base64 format, see 3GPP TS 31.102 7.1.2
5836 * RADIO_NOT_AVAILABLE
5841 * INVALID_MODEM_STATE
5844 * REQUEST_NOT_SUPPORTED
5846 #define RIL_REQUEST_SIM_AUTHENTICATION 125
5849 * RIL_REQUEST_GET_DC_RT_INFO
5851 * The request is DEPRECATED, use RIL_REQUEST_GET_ACTIVITY_INFO
5852 * Requests the Data Connection Real Time Info
5856 * "response" is the most recent RIL_DcRtInfo
5860 * RADIO_NOT_AVAILABLE
5861 * REQUEST_NOT_SUPPORTED
5867 * See also: RIL_UNSOL_DC_RT_INFO_CHANGED
5869 #define RIL_REQUEST_GET_DC_RT_INFO 126
5872 * RIL_REQUEST_SET_DC_RT_INFO_RATE
5874 * The request is DEPRECATED
5875 * This is the minimum number of milliseconds between successive
5876 * RIL_UNSOL_DC_RT_INFO_CHANGED messages and defines the highest rate
5877 * at which RIL_UNSOL_DC_RT_INFO_CHANGED's will be sent. A value of
5878 * 0 means send as fast as possible.
5880 * "data" The number of milliseconds as an int
5882 * "response" is null
5885 * SUCCESS must not fail
5887 #define RIL_REQUEST_SET_DC_RT_INFO_RATE 127
5890 * RIL_REQUEST_SET_DATA_PROFILE
5892 * Set data profile in modem
5893 * Modem should erase existed profiles from framework, and apply new profiles
5894 * "data" is a const RIL_DataProfileInfo **
5895 * "datalen" is count * sizeof(const RIL_DataProfileInfo *)
5896 * "response" is NULL
5900 * RADIO_NOT_AVAILABLE (radio resetting)
5901 * SUBSCRIPTION_NOT_AVAILABLE
5906 * REQUEST_NOT_SUPPORTED
5909 #define RIL_REQUEST_SET_DATA_PROFILE 128
5912 * RIL_REQUEST_SHUTDOWN
5914 * Device is shutting down. All further commands are ignored
5915 * and RADIO_NOT_AVAILABLE must be returned.
5918 * "response" is NULL
5922 * RADIO_NOT_AVAILABLE
5923 * OPERATION_NOT_ALLOWED
5927 * REQUEST_NOT_SUPPORTED
5931 #define RIL_REQUEST_SHUTDOWN 129
5934 * RIL_REQUEST_GET_RADIO_CAPABILITY
5936 * Used to get phone radio capablility.
5938 * "data" is the RIL_RadioCapability structure
5942 * RADIO_NOT_AVAILABLE
5943 * OPERATION_NOT_ALLOWED
5945 * REQUEST_NOT_SUPPORTED
5951 #define RIL_REQUEST_GET_RADIO_CAPABILITY 130
5954 * RIL_REQUEST_SET_RADIO_CAPABILITY
5956 * Used to set the phones radio capability. Be VERY careful
5957 * using this request as it may cause some vendor modems to reset. Because
5958 * of the possible modem reset any RIL commands after this one may not be
5961 * "data" is the RIL_RadioCapability structure
5963 * "response" is the RIL_RadioCapability structure, used to feedback return status
5966 * SUCCESS means a RIL_UNSOL_RADIO_CAPABILITY will be sent within 30 seconds.
5967 * RADIO_NOT_AVAILABLE
5968 * OPERATION_NOT_ALLOWED
5975 * REQUEST_NOT_SUPPORTED
5979 #define RIL_REQUEST_SET_RADIO_CAPABILITY 131
5982 * RIL_REQUEST_START_LCE
5984 * Start Link Capacity Estimate (LCE) service if supported by the radio.
5986 * "data" is const int *
5987 * ((const int*)data)[0] specifies the desired reporting interval (ms).
5988 * ((const int*)data)[1] specifies the LCE service mode. 1: PULL; 0: PUSH.
5990 * "response" is the RIL_LceStatusInfo.
5994 * RADIO_NOT_AVAILABLE
5997 * REQUEST_NOT_SUPPORTED
6003 #define RIL_REQUEST_START_LCE 132
6006 * RIL_REQUEST_STOP_LCE
6008 * Stop Link Capacity Estimate (LCE) service, the STOP operation should be
6009 * idempotent for the radio modem.
6011 * "response" is the RIL_LceStatusInfo.
6015 * RADIO_NOT_AVAILABLE
6021 * REQUEST_NOT_SUPPORTED
6024 #define RIL_REQUEST_STOP_LCE 133
6027 * RIL_REQUEST_PULL_LCEDATA
6029 * Pull LCE service for capacity information.
6031 * "response" is the RIL_LceDataInfo.
6035 * RADIO_NOT_AVAILABLE
6041 * REQUEST_NOT_SUPPORTED
6044 #define RIL_REQUEST_PULL_LCEDATA 134
6047 * RIL_REQUEST_GET_ACTIVITY_INFO
6049 * Get modem activity information for power consumption estimation.
6051 * Request clear-on-read statistics information that is used for
6052 * estimating the per-millisecond power consumption of the cellular
6056 * "response" is const RIL_ActivityStatsInfo *
6061 * RADIO_NOT_AVAILABLE (radio resetting)
6067 * REQUEST_NOT_SUPPORTED
6068 * NO_RESOURCES CANCELLED
6070 #define RIL_REQUEST_GET_ACTIVITY_INFO 135
6073 * RIL_REQUEST_SET_CARRIER_RESTRICTIONS
6075 * Set carrier restrictions for this sim slot. Expected modem behavior:
6076 * If never receives this command
6077 * - Must allow all carriers
6078 * Receives this command with data being NULL
6079 * - Must allow all carriers. If a previously allowed SIM is present, modem must not reload
6080 * the SIM. If a previously disallowed SIM is present, reload the SIM and notify Android.
6081 * Receives this command with a list of carriers
6082 * - Only allow specified carriers, persist across power cycles and FDR. If a present SIM
6083 * is in the allowed list, modem must not reload the SIM. If a present SIM is *not* in
6084 * the allowed list, modem must detach from the registered network and only keep emergency
6085 * service, and notify Android SIM refresh reset with new SIM state being
6086 * RIL_CARDSTATE_RESTRICTED. Emergency service must be enabled.
6088 * "data" is const RIL_CarrierRestrictions *
6089 * A list of allowed carriers and possibly a list of excluded carriers.
6090 * If data is NULL, means to clear previous carrier restrictions and allow all carriers
6092 * "response" is int *
6093 * ((int *)data)[0] contains the number of allowed carriers which have been set correctly.
6094 * On success, it should match the length of list data->allowed_carriers.
6095 * If data is NULL, the value must be 0.
6099 * RIL_E_INVALID_ARGUMENTS
6100 * RIL_E_RADIO_NOT_AVAILABLE
6101 * RIL_E_REQUEST_NOT_SUPPORTED
6107 #define RIL_REQUEST_SET_CARRIER_RESTRICTIONS 136
6110 * RIL_REQUEST_GET_CARRIER_RESTRICTIONS
6112 * Get carrier restrictions for this sim slot. Expected modem behavior:
6113 * Return list of allowed carriers, or null if all carriers are allowed.
6117 * "response" is const RIL_CarrierRestrictions *.
6118 * If response is NULL, it means all carriers are allowed.
6122 * RIL_E_RADIO_NOT_AVAILABLE
6123 * RIL_E_REQUEST_NOT_SUPPORTED
6129 #define RIL_REQUEST_GET_CARRIER_RESTRICTIONS 137
6132 * RIL_REQUEST_SEND_DEVICE_STATE
6134 * Send the updated device state.
6135 * Modem can perform power saving based on the provided device state.
6136 * "data" is const int *
6137 * ((const int*)data)[0] A RIL_DeviceStateType that specifies the device state type.
6138 * ((const int*)data)[1] Specifies the state. See RIL_DeviceStateType for the definition of each
6141 * "datalen" is count * sizeof(const RIL_DeviceState *)
6142 * "response" is NULL
6146 * RADIO_NOT_AVAILABLE (radio resetting)
6151 * REQUEST_NOT_SUPPORTED
6155 #define RIL_REQUEST_SEND_DEVICE_STATE 138
6158 * RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER
6160 * Set the unsolicited response filter
6161 * This is used to prevent unnecessary application processor
6162 * wake up for power saving purposes by suppressing the
6163 * unsolicited responses in certain scenarios.
6165 * "data" is an int *
6167 * ((int *)data)[0] is a 32-bit bitmask of RIL_UnsolicitedResponseFilter
6169 * "response" is NULL
6173 * INVALID_ARGUMENTS (e.g. the requested filter doesn't exist)
6174 * RADIO_NOT_AVAILABLE (radio resetting)
6178 * REQUEST_NOT_SUPPORTED
6182 #define RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER 139
6185 * RIL_REQUEST_SET_SIM_CARD_POWER
6187 * Set SIM card power up or down
6189 * Request is equivalent to inserting and removing the card, with
6190 * an additional effect where the ability to detect card removal/insertion
6191 * is disabled when the SIM card is powered down.
6193 * This will generate RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED
6194 * as if the SIM had been inserted or removed.
6197 * ((int *)data)[0] is 1 for "SIM POWER UP"
6198 * ((int *)data)[0] is 0 for "SIM POWER DOWN"
6200 * "response" is NULL
6204 * RADIO_NOT_AVAILABLE
6205 * REQUEST_NOT_SUPPORTED
6213 #define RIL_REQUEST_SET_SIM_CARD_POWER 140
6216 * RIL_REQUEST_SET_CARRIER_INFO_IMSI_ENCRYPTION
6218 * Provide Carrier specific information to the modem that will be used to
6219 * encrypt the IMSI and IMPI. Sent by the framework during boot, carrier
6220 * switch and everytime we receive a new certificate.
6222 * "data" is the RIL_CarrierInfoForImsiEncryption * structure.
6224 * "response" is NULL
6228 * RIL_E_RADIO_NOT_AVAILABLE
6230 * RIL_E_REQUEST_NOT_SUPPORTED
6232 * MODEM_INTERNAL_FAILURE
6238 #define RIL_REQUEST_SET_CARRIER_INFO_IMSI_ENCRYPTION 141
6241 * RIL_REQUEST_START_NETWORK_SCAN
6243 * Starts a new network scan
6245 * Request to start a network scan with specified radio access networks with frequency bands and/or
6248 * "data" is a const RIL_NetworkScanRequest *.
6249 * "response" is NULL
6253 * RADIO_NOT_AVAILABLE
6254 * OPERATION_NOT_ALLOWED
6260 * REQUEST_NOT_SUPPORTED
6265 #define RIL_REQUEST_START_NETWORK_SCAN 142
6268 * RIL_REQUEST_STOP_NETWORK_SCAN
6270 * Stops an ongoing network scan
6272 * Request to stop the ongoing network scan. Since the modem can only perform one scan at a time,
6273 * there is no parameter for this request.
6276 * "response" is NULL
6285 * REQUEST_NOT_SUPPORTED
6288 #define RIL_REQUEST_STOP_NETWORK_SCAN 143
6291 * RIL_REQUEST_START_KEEPALIVE
6293 * Start a keepalive session
6295 * Request that the modem begin sending keepalive packets on a particular
6296 * data call, with a specified source, destination, and format.
6298 * "data" is a const RIL_RequestKeepalive
6299 * "response" is RIL_KeepaliveStatus with a valid "handle"
6307 #define RIL_REQUEST_START_KEEPALIVE 144
6310 * RIL_REQUEST_STOP_KEEPALIVE
6312 * Stops an ongoing keepalive session
6314 * Requests that a keepalive session with the given handle be stopped.
6315 * there is no parameter for this request.
6317 * "data" is an integer handle
6318 * "response" is NULL
6325 #define RIL_REQUEST_STOP_KEEPALIVE 145
6327 /***********************************************************************/
6330 * RIL_RESPONSE_ACKNOWLEDGEMENT
6332 * This is used by Asynchronous solicited messages and Unsolicited messages
6333 * to acknowledge the receipt of those messages in RIL.java so that the ack
6334 * can be used to let ril.cpp to release wakelock.
6338 * RADIO_NOT_AVAILABLE
6341 #define RIL_RESPONSE_ACKNOWLEDGEMENT 800
6343 /***********************************************************************/
6346 #define RIL_UNSOL_RESPONSE_BASE 1000
6349 * RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED
6351 * Indicate when value of RIL_RadioState has changed.
6353 * Callee will invoke RIL_RadioStateRequest method on main thread
6358 #define RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED 1000
6362 * RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED
6364 * Indicate when call state has changed
6366 * Callee will invoke RIL_REQUEST_GET_CURRENT_CALLS on main thread
6370 * Response should be invoked on, for example,
6371 * "RING", "BUSY", "NO CARRIER", and also call state
6372 * transitions (DIALING->ALERTING ALERTING->ACTIVE)
6374 * Redundent or extraneous invocations are tolerated
6376 #define RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED 1001
6380 * RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED
6382 * Called when the voice network state changed
6384 * Callee will invoke the following requests on main thread:
6386 * RIL_REQUEST_VOICE_REGISTRATION_STATE
6387 * RIL_REQUEST_OPERATOR
6391 * FIXME should this happen when SIM records are loaded? (eg, for
6394 #define RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED 1002
6397 * RIL_UNSOL_RESPONSE_NEW_SMS
6399 * Called when new SMS is received.
6401 * "data" is const char *
6402 * This is a pointer to a string containing the PDU of an SMS-DELIVER
6403 * as an ascii string of hex digits. The PDU starts with the SMSC address
6404 * per TS 27.005 (+CMT:)
6406 * Callee will subsequently confirm the receipt of thei SMS with a
6407 * RIL_REQUEST_SMS_ACKNOWLEDGE
6409 * No new RIL_UNSOL_RESPONSE_NEW_SMS
6410 * or RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT messages should be sent until a
6411 * RIL_REQUEST_SMS_ACKNOWLEDGE has been received
6414 #define RIL_UNSOL_RESPONSE_NEW_SMS 1003
6417 * RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT
6419 * Called when new SMS Status Report is received.
6421 * "data" is const char *
6422 * This is a pointer to a string containing the PDU of an SMS-STATUS-REPORT
6423 * as an ascii string of hex digits. The PDU starts with the SMSC address
6424 * per TS 27.005 (+CDS:).
6426 * Callee will subsequently confirm the receipt of the SMS with a
6427 * RIL_REQUEST_SMS_ACKNOWLEDGE
6429 * No new RIL_UNSOL_RESPONSE_NEW_SMS
6430 * or RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT messages should be sent until a
6431 * RIL_REQUEST_SMS_ACKNOWLEDGE has been received
6434 #define RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT 1004
6437 * RIL_UNSOL_RESPONSE_NEW_SMS_ON_SIM
6439 * Called when new SMS has been stored on SIM card
6441 * "data" is const int *
6442 * ((const int *)data)[0] contains the slot index on the SIM that contains
6446 #define RIL_UNSOL_RESPONSE_NEW_SMS_ON_SIM 1005
6451 * Called when a new USSD message is received.
6453 * "data" is const char **
6454 * ((const char **)data)[0] points to a type code, which is
6455 * one of these string values:
6456 * "0" USSD-Notify -- text in ((const char **)data)[1]
6457 * "1" USSD-Request -- text in ((const char **)data)[1]
6458 * "2" Session terminated by network
6459 * "3" other local client (eg, SIM Toolkit) has responded
6460 * "4" Operation not supported
6461 * "5" Network timeout
6463 * The USSD session is assumed to persist if the type code is "1", otherwise
6464 * the current session (if any) is assumed to have terminated.
6466 * ((const char **)data)[1] points to a message string if applicable, which
6467 * should always be in UTF-8.
6469 #define RIL_UNSOL_ON_USSD 1006
6470 /* Previously #define RIL_UNSOL_ON_USSD_NOTIFY 1006 */
6473 * RIL_UNSOL_ON_USSD_REQUEST
6475 * Obsolete. Send via RIL_UNSOL_ON_USSD
6477 #define RIL_UNSOL_ON_USSD_REQUEST 1007
6480 * RIL_UNSOL_NITZ_TIME_RECEIVED
6482 * Called when radio has received a NITZ time message
6484 * "data" is const char * pointing to NITZ time string
6485 * in the form "yy/mm/dd,hh:mm:ss(+/-)tz,dt"
6487 #define RIL_UNSOL_NITZ_TIME_RECEIVED 1008
6490 * RIL_UNSOL_SIGNAL_STRENGTH
6492 * Radio may report signal strength rather han have it polled.
6494 * "data" is a const RIL_SignalStrength *
6496 #define RIL_UNSOL_SIGNAL_STRENGTH 1009
6500 * RIL_UNSOL_DATA_CALL_LIST_CHANGED
6502 * "data" is an array of RIL_Data_Call_Response_v6 identical to that
6503 * returned by RIL_REQUEST_DATA_CALL_LIST. It is the complete list
6504 * of current data contexts including new contexts that have been
6505 * activated. A data call is only removed from this list when the
6506 * framework sends a RIL_REQUEST_DEACTIVATE_DATA_CALL or the radio
6507 * is powered off/on.
6509 * See also: RIL_REQUEST_DATA_CALL_LIST
6512 #define RIL_UNSOL_DATA_CALL_LIST_CHANGED 1010
6515 * RIL_UNSOL_SUPP_SVC_NOTIFICATION
6517 * Reports supplementary service related notification from the network.
6519 * "data" is a const RIL_SuppSvcNotification *
6523 #define RIL_UNSOL_SUPP_SVC_NOTIFICATION 1011
6526 * RIL_UNSOL_STK_SESSION_END
6528 * Indicate when STK session is terminated by SIM.
6532 #define RIL_UNSOL_STK_SESSION_END 1012
6535 * RIL_UNSOL_STK_PROACTIVE_COMMAND
6537 * Indicate when SIM issue a STK proactive command to applications
6539 * "data" is a const char * containing SAT/USAT proactive command
6540 * in hexadecimal format string starting with command tag
6543 #define RIL_UNSOL_STK_PROACTIVE_COMMAND 1013
6546 * RIL_UNSOL_STK_EVENT_NOTIFY
6548 * Indicate when SIM notifies applcations some event happens.
6549 * Generally, application does not need to have any feedback to
6550 * SIM but shall be able to indicate appropriate messages to users.
6552 * "data" is a const char * containing SAT/USAT commands or responses
6553 * sent by ME to SIM or commands handled by ME, in hexadecimal format string
6554 * starting with first byte of response data or command tag
6557 #define RIL_UNSOL_STK_EVENT_NOTIFY 1014
6560 * RIL_UNSOL_STK_CALL_SETUP
6562 * Indicate when SIM wants application to setup a voice call.
6564 * "data" is const int *
6565 * ((const int *)data)[0] contains timeout value (in milliseconds)
6567 #define RIL_UNSOL_STK_CALL_SETUP 1015
6570 * RIL_UNSOL_SIM_SMS_STORAGE_FULL
6572 * Indicates that SMS storage on the SIM is full. Sent when the network
6573 * attempts to deliver a new SMS message. Messages cannot be saved on the
6574 * SIM until space is freed. In particular, incoming Class 2 messages
6580 #define RIL_UNSOL_SIM_SMS_STORAGE_FULL 1016
6583 * RIL_UNSOL_SIM_REFRESH
6585 * Indicates that file(s) on the SIM have been updated, or the SIM
6586 * has been reinitialized.
6588 * In the case where RIL is version 6 or older:
6589 * "data" is an int *
6590 * ((int *)data)[0] is a RIL_SimRefreshResult.
6591 * ((int *)data)[1] is the EFID of the updated file if the result is
6592 * SIM_FILE_UPDATE or NULL for any other result.
6594 * In the case where RIL is version 7:
6595 * "data" is a RIL_SimRefreshResponse_v7 *
6597 * Note: If the SIM state changes as a result of the SIM refresh (eg,
6598 * SIM_READY -> SIM_LOCKED_OR_ABSENT), RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED
6601 #define RIL_UNSOL_SIM_REFRESH 1017
6604 * RIL_UNSOL_CALL_RING
6606 * Ring indication for an incoming call (eg, RING or CRING event).
6607 * There must be at least one RIL_UNSOL_CALL_RING at the beginning
6608 * of a call and sending multiple is optional. If the system property
6609 * ro.telephony.call_ring.multiple is false then the upper layers
6610 * will generate the multiple events internally. Otherwise the vendor
6611 * ril must generate multiple RIL_UNSOL_CALL_RING if
6612 * ro.telephony.call_ring.multiple is true or if it is absent.
6614 * The rate of these events is controlled by ro.telephony.call_ring.delay
6615 * and has a default value of 3000 (3 seconds) if absent.
6617 * "data" is null for GSM
6618 * "data" is const RIL_CDMA_SignalInfoRecord * if CDMA
6620 #define RIL_UNSOL_CALL_RING 1018
6623 * RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED
6625 * Indicates that SIM state changes.
6627 * Callee will invoke RIL_REQUEST_GET_SIM_STATUS on main thread
6631 #define RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED 1019
6634 * RIL_UNSOL_RESPONSE_CDMA_NEW_SMS
6636 * Called when new CDMA SMS is received
6638 * "data" is const RIL_CDMA_SMS_Message *
6640 * Callee will subsequently confirm the receipt of the SMS with
6641 * a RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE
6643 * No new RIL_UNSOL_RESPONSE_CDMA_NEW_SMS should be sent until
6644 * RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE has been received
6647 #define RIL_UNSOL_RESPONSE_CDMA_NEW_SMS 1020
6650 * RIL_UNSOL_RESPONSE_NEW_BROADCAST_SMS
6652 * Called when new Broadcast SMS is received
6654 * "data" can be one of the following:
6655 * If received from GSM network, "data" is const char of 88 bytes
6656 * which indicates each page of a CBS Message sent to the MS by the
6657 * BTS as coded in 3GPP 23.041 Section 9.4.1.2.
6658 * If received from UMTS network, "data" is const char of 90 up to 1252
6659 * bytes which contain between 1 and 15 CBS Message pages sent as one
6660 * packet to the MS by the BTS as coded in 3GPP 23.041 Section 9.4.2.2.
6663 #define RIL_UNSOL_RESPONSE_NEW_BROADCAST_SMS 1021
6666 * RIL_UNSOL_CDMA_RUIM_SMS_STORAGE_FULL
6668 * Indicates that SMS storage on the RUIM is full. Messages
6669 * cannot be saved on the RUIM until space is freed.
6674 #define RIL_UNSOL_CDMA_RUIM_SMS_STORAGE_FULL 1022
6677 * RIL_UNSOL_RESTRICTED_STATE_CHANGED
6679 * Indicates a restricted state change (eg, for Domain Specific Access Control).
6681 * Radio need send this msg after radio off/on cycle no matter it is changed or not.
6683 * "data" is an int *
6684 * ((int *)data)[0] contains a bitmask of RIL_RESTRICTED_STATE_* values.
6686 #define RIL_UNSOL_RESTRICTED_STATE_CHANGED 1023
6689 * RIL_UNSOL_ENTER_EMERGENCY_CALLBACK_MODE
6691 * Indicates that the radio system selection module has
6692 * autonomously entered emergency callback mode.
6697 #define RIL_UNSOL_ENTER_EMERGENCY_CALLBACK_MODE 1024
6700 * RIL_UNSOL_CDMA_CALL_WAITING
6702 * Called when CDMA radio receives a call waiting indication.
6704 * "data" is const RIL_CDMA_CallWaiting *
6707 #define RIL_UNSOL_CDMA_CALL_WAITING 1025
6710 * RIL_UNSOL_CDMA_OTA_PROVISION_STATUS
6712 * Called when CDMA radio receives an update of the progress of an
6715 * "data" is const int *
6716 * For CDMA this is an integer OTASP/OTAPA status listed in
6717 * RIL_CDMA_OTA_ProvisionStatus.
6720 #define RIL_UNSOL_CDMA_OTA_PROVISION_STATUS 1026
6723 * RIL_UNSOL_CDMA_INFO_REC
6725 * Called when CDMA radio receives one or more info recs.
6727 * "data" is const RIL_CDMA_InformationRecords *
6730 #define RIL_UNSOL_CDMA_INFO_REC 1027
6733 * RIL_UNSOL_OEM_HOOK_RAW
6735 * This is for OEM specific use.
6737 * "data" is a byte[]
6739 #define RIL_UNSOL_OEM_HOOK_RAW 1028
6742 * RIL_UNSOL_RINGBACK_TONE
6744 * Indicates that nework doesn't have in-band information, need to
6745 * play out-band tone.
6747 * "data" is an int *
6748 * ((int *)data)[0] == 0 for stop play ringback tone.
6749 * ((int *)data)[0] == 1 for start play ringback tone.
6751 #define RIL_UNSOL_RINGBACK_TONE 1029
6754 * RIL_UNSOL_RESEND_INCALL_MUTE
6756 * Indicates that framework/application need reset the uplink mute state.
6758 * There may be situations where the mute state becomes out of sync
6759 * between the application and device in some GSM infrastructures.
6763 #define RIL_UNSOL_RESEND_INCALL_MUTE 1030
6766 * RIL_UNSOL_CDMA_SUBSCRIPTION_SOURCE_CHANGED
6768 * Called when CDMA subscription source changed.
6771 * ((int *)data)[0] is == RIL_CdmaSubscriptionSource
6773 #define RIL_UNSOL_CDMA_SUBSCRIPTION_SOURCE_CHANGED 1031
6776 * RIL_UNSOL_CDMA_PRL_CHANGED
6778 * Called when PRL (preferred roaming list) changes.
6781 * ((int *)data)[0] is PRL_VERSION as would be returned by RIL_REQUEST_CDMA_SUBSCRIPTION
6783 #define RIL_UNSOL_CDMA_PRL_CHANGED 1032
6786 * RIL_UNSOL_EXIT_EMERGENCY_CALLBACK_MODE
6788 * Called when Emergency Callback Mode Ends
6790 * Indicates that the radio system selection module has
6791 * proactively exited emergency callback mode.
6796 #define RIL_UNSOL_EXIT_EMERGENCY_CALLBACK_MODE 1033
6799 * RIL_UNSOL_RIL_CONNECTED
6801 * Called the ril connects and returns the version
6804 * ((int *)data)[0] is RIL_VERSION
6806 #define RIL_UNSOL_RIL_CONNECTED 1034
6809 * RIL_UNSOL_VOICE_RADIO_TECH_CHANGED
6811 * Indicates that voice technology has changed. Contains new radio technology
6812 * as a data in the message.
6815 * ((int *)data)[0] is of type const RIL_RadioTechnology
6818 #define RIL_UNSOL_VOICE_RADIO_TECH_CHANGED 1035
6821 * RIL_UNSOL_CELL_INFO_LIST
6823 * Same information as returned by RIL_REQUEST_GET_CELL_INFO_LIST, but returned
6824 * at the rate no greater than specified by RIL_REQUEST_SET_UNSOL_CELL_INFO_RATE.
6828 * "response" is an array of RIL_CellInfo_v12.
6830 #define RIL_UNSOL_CELL_INFO_LIST 1036
6833 * RIL_UNSOL_RESPONSE_IMS_NETWORK_STATE_CHANGED
6835 * This message is DEPRECATED and shall be removed in a future release (target: 2018);
6836 * instead, provide IMS registration status via an IMS Service.
6838 * Called when IMS registration state has changed
6840 * To get IMS registration state and IMS SMS format, callee needs to invoke the
6841 * following request on main thread:
6843 * RIL_REQUEST_IMS_REGISTRATION_STATE
6848 #define RIL_UNSOL_RESPONSE_IMS_NETWORK_STATE_CHANGED 1037
6851 * RIL_UNSOL_UICC_SUBSCRIPTION_STATUS_CHANGED
6853 * Indicated when there is a change in subscription status.
6854 * This event will be sent in the following scenarios
6855 * - subscription readiness at modem, which was selected by telephony layer
6856 * - when subscription is deactivated by modem due to UICC card removal
6857 * - When network invalidates the subscription i.e. attach reject due to authentication reject
6859 * "data" is const int *
6860 * ((const int *)data)[0] == 0 for Subscription Deactivated
6861 * ((const int *)data)[0] == 1 for Subscription Activated
6864 #define RIL_UNSOL_UICC_SUBSCRIPTION_STATUS_CHANGED 1038
6867 * RIL_UNSOL_SRVCC_STATE_NOTIFY
6869 * Called when Single Radio Voice Call Continuity(SRVCC)
6870 * progress state has changed
6873 * ((int *)data)[0] is of type const RIL_SrvccState
6877 #define RIL_UNSOL_SRVCC_STATE_NOTIFY 1039
6880 * RIL_UNSOL_HARDWARE_CONFIG_CHANGED
6882 * Called when the hardware configuration associated with the RILd changes
6884 * "data" is an array of RIL_HardwareConfig
6887 #define RIL_UNSOL_HARDWARE_CONFIG_CHANGED 1040
6890 * RIL_UNSOL_DC_RT_INFO_CHANGED
6892 * The message is DEPRECATED, use RIL_REQUEST_GET_ACTIVITY_INFO
6893 * Sent when the DC_RT_STATE changes but the time
6894 * between these messages must not be less than the
6895 * value set by RIL_REQUEST_SET_DC_RT_RATE.
6897 * "data" is the most recent RIL_DcRtInfo
6900 #define RIL_UNSOL_DC_RT_INFO_CHANGED 1041
6903 * RIL_UNSOL_RADIO_CAPABILITY
6905 * Sent when RIL_REQUEST_SET_RADIO_CAPABILITY completes.
6906 * Returns the phone radio capability exactly as
6907 * RIL_REQUEST_GET_RADIO_CAPABILITY and should be the
6908 * same set as sent by RIL_REQUEST_SET_RADIO_CAPABILITY.
6910 * "data" is the RIL_RadioCapability structure
6912 #define RIL_UNSOL_RADIO_CAPABILITY 1042
6917 * Called when SS response is received when DIAL/USSD/SS is changed to SS by
6920 * "data" is const RIL_StkCcUnsolSsResponse *
6923 #define RIL_UNSOL_ON_SS 1043
6926 * RIL_UNSOL_STK_CC_ALPHA_NOTIFY
6928 * Called when there is an ALPHA from UICC during Call Control.
6930 * "data" is const char * containing ALPHA string from UICC in UTF-8 format.
6933 #define RIL_UNSOL_STK_CC_ALPHA_NOTIFY 1044
6936 * RIL_UNSOL_LCEDATA_RECV
6938 * Called when there is an incoming Link Capacity Estimate (LCE) info report.
6940 * "data" is the RIL_LceDataInfo structure.
6943 #define RIL_UNSOL_LCEDATA_RECV 1045
6946 * RIL_UNSOL_PCO_DATA
6948 * Called when there is new Carrier PCO data received for a data call. Ideally
6949 * only new data will be forwarded, though this is not required. Multiple
6950 * boxes of carrier PCO data for a given call should result in a series of
6951 * RIL_UNSOL_PCO_DATA calls.
6953 * "data" is the RIL_PCO_Data structure.
6956 #define RIL_UNSOL_PCO_DATA 1046
6959 * RIL_UNSOL_MODEM_RESTART
6961 * Called when there is a modem reset.
6963 * "reason" is "const char *" containing the reason for the reset. It
6964 * could be a crash signature if the restart was due to a crash or some
6965 * string such as "user-initiated restart" or "AT command initiated
6966 * restart" that explains the cause of the modem restart.
6968 * When modem restarts, one of the following radio state transitions will happen
6969 * 1) RADIO_STATE_ON->RADIO_STATE_UNAVAILABLE->RADIO_STATE_ON or
6970 * 2) RADIO_STATE_OFF->RADIO_STATE_UNAVAILABLE->RADIO_STATE_OFF
6971 * This message can be sent either just before the RADIO_STATE changes to RADIO_STATE_UNAVAILABLE
6972 * or just after but should never be sent after the RADIO_STATE changes from UNAVAILABLE to
6973 * AVAILABLE(RADIO_STATE_ON/RADIO_STATE_OFF) again.
6975 * It should NOT be sent after the RADIO_STATE changes to AVAILABLE after the
6976 * modem restart as that could be interpreted as a second modem reset by the
6979 #define RIL_UNSOL_MODEM_RESTART 1047
6982 * RIL_UNSOL_CARRIER_INFO_IMSI_ENCRYPTION
6984 * Called when the modem needs Carrier specific information that will
6985 * be used to encrypt IMSI and IMPI.
6990 #define RIL_UNSOL_CARRIER_INFO_IMSI_ENCRYPTION 1048
6993 * RIL_UNSOL_NETWORK_SCAN_RESULT
6995 * Returns incremental result for the network scan which is started by
6996 * RIL_REQUEST_START_NETWORK_SCAN, sent to report results, status, or errors.
6999 * "response" is a const RIL_NetworkScanResult *
7001 #define RIL_UNSOL_NETWORK_SCAN_RESULT 1049
7004 * RIL_UNSOL_KEEPALIVE_STATUS
7007 * "response" is a const RIL_KeepaliveStatus *
7009 #define RIL_UNSOL_KEEPALIVE_STATUS 1050
7011 /***********************************************************************/
7014 #if defined(ANDROID_MULTI_SIM)
7016 * RIL_Request Function pointer
7018 * @param request is one of RIL_REQUEST_*
7019 * @param data is pointer to data defined for that RIL_REQUEST_*
7020 * data is owned by caller, and should not be modified or freed by callee
7021 * structures passed as data may contain pointers to non-contiguous memory
7022 * @param t should be used in subsequent call to RIL_onResponse
7023 * @param datalen is the length of "data" which is defined as other argument. It may or may
7024 * not be equal to sizeof(data). Refer to the documentation of individual structures
7025 * to find if pointers listed in the structure are contiguous and counted in the datalen
7027 * (Eg: RIL_IMS_SMS_Message where we don't have datalen equal to sizeof(data))
7030 typedef void (*RIL_RequestFunc) (int request, void *data,
7031 size_t datalen, RIL_Token t, RIL_SOCKET_ID socket_id);
7034 * This function should return the current radio state synchronously
7036 typedef RIL_RadioState (*RIL_RadioStateRequest)(RIL_SOCKET_ID socket_id);
7039 /* Backward compatible */
7042 * RIL_Request Function pointer
7044 * @param request is one of RIL_REQUEST_*
7045 * @param data is pointer to data defined for that RIL_REQUEST_*
7046 * data is owned by caller, and should not be modified or freed by callee
7047 * structures passed as data may contain pointers to non-contiguous memory
7048 * @param t should be used in subsequent call to RIL_onResponse
7049 * @param datalen is the length of "data" which is defined as other argument. It may or may
7050 * not be equal to sizeof(data). Refer to the documentation of individual structures
7051 * to find if pointers listed in the structure are contiguous and counted in the datalen
7053 * (Eg: RIL_IMS_SMS_Message where we don't have datalen equal to sizeof(data))
7056 typedef void (*RIL_RequestFunc) (int request, void *data,
7057 size_t datalen, RIL_Token t);
7060 * This function should return the current radio state synchronously
7062 typedef RIL_RadioState (*RIL_RadioStateRequest)();
7068 * This function returns "1" if the specified RIL_REQUEST code is
7069 * supported and 0 if it is not
7071 * @param requestCode is one of RIL_REQUEST codes
7074 typedef int (*RIL_Supports)(int requestCode);
7077 * This function is called from a separate thread--not the
7078 * thread that calls RIL_RequestFunc--and indicates that a pending
7079 * request should be cancelled.
7081 * On cancel, the callee should do its best to abandon the request and
7082 * call RIL_onRequestComplete with RIL_Errno CANCELLED at some later point.
7084 * Subsequent calls to RIL_onRequestComplete for this request with
7085 * other results will be tolerated but ignored. (That is, it is valid
7086 * to ignore the cancellation request)
7088 * RIL_Cancel calls should return immediately, and not wait for cancellation
7090 * Please see ITU v.250 5.6.1 for how one might implement this on a TS 27.007
7093 * @param t token wants to be canceled
7096 typedef void (*RIL_Cancel)(RIL_Token t);
7098 typedef void (*RIL_TimedCallback) (void *param);
7101 * Return a version string for your RIL implementation
7103 typedef const char * (*RIL_GetVersion) (void);
7106 int version; /* set to RIL_VERSION */
7107 RIL_RequestFunc onRequest;
7108 RIL_RadioStateRequest onStateRequest;
7109 RIL_Supports supports;
7110 RIL_Cancel onCancel;
7111 RIL_GetVersion getVersion;
7112 } RIL_RadioFunctions;
7115 char *apn; /* the APN to connect to */
7116 char *protocol; /* one of the PDP_type values in TS 27.007 section 10.1.1 used on
7117 roaming network. For example, "IP", "IPV6", "IPV4V6", or "PPP".*/
7118 int authtype; /* authentication protocol used for this PDP context
7119 (None: 0, PAP: 1, CHAP: 2, PAP&CHAP: 3) */
7120 char *username; /* the username for APN, or NULL */
7121 char *password; /* the password for APN, or NULL */
7122 } RIL_InitialAttachApn;
7125 char *apn; /* the APN to connect to */
7126 char *protocol; /* one of the PDP_type values in TS 27.007 section 10.1.1 used on
7127 home network. For example, "IP", "IPV6", "IPV4V6", or "PPP". */
7128 char *roamingProtocol; /* one of the PDP_type values in TS 27.007 section 10.1.1 used on
7129 roaming network. For example, "IP", "IPV6", "IPV4V6", or "PPP".*/
7130 int authtype; /* authentication protocol used for this PDP context
7131 (None: 0, PAP: 1, CHAP: 2, PAP&CHAP: 3) */
7132 char *username; /* the username for APN, or NULL */
7133 char *password; /* the password for APN, or NULL */
7134 int supportedTypesBitmask; /* supported APN types bitmask. See RIL_ApnTypes for the value of
7136 int bearerBitmask; /* the bearer bitmask. See RIL_RadioAccessFamily for the value of
7138 int modemCognitive; /* indicating the APN setting was sent to the modem through
7139 setDataProfile earlier. */
7140 int mtu; /* maximum transmission unit (MTU) size in bytes */
7141 char *mvnoType; /* the MVNO type: possible values are "imsi", "gid", "spn" */
7142 char *mvnoMatchData; /* MVNO match data. Can be anything defined by the carrier.
7144 SPN like: "A MOBILE", "BEN NL", etc...
7145 IMSI like: "302720x94", "2060188", etc...
7146 GID like: "4E", "33", etc... */
7147 } RIL_InitialAttachApn_v15;
7150 int authContext; /* P2 value of authentication command, see P2 parameter in
7151 3GPP TS 31.102 7.1.2 */
7152 char *authData; /* the challenge string in Base64 format, see 3GPP
7154 char *aid; /* AID value, See ETSI 102.221 8.1 and 101.220 4,
7155 NULL if no value. */
7156 } RIL_SimAuthentication;
7159 int cid; /* Context ID, uniquely identifies this call */
7160 char *bearer_proto; /* One of the PDP_type values in TS 27.007 section 10.1.1.
7161 For example, "IP", "IPV6", "IPV4V6". */
7162 int pco_id; /* The protocol ID for this box. Note that only IDs from
7163 FF00H - FFFFH are accepted. If more than one is included
7164 from the network, multiple calls should be made to send all
7166 int contents_length; /* The number of octets in the contents. */
7167 char *contents; /* Carrier-defined content. It is binary, opaque and
7168 loosely defined in LTE Layer 3 spec 24.008 */
7172 NATT_IPV4 = 0, /* Keepalive specified by RFC 3948 Sec. 2.3 using IPv4 */
7173 NATT_IPV6 = 1 /* Keepalive specified by RFC 3948 Sec. 2.3 using IPv6 */
7174 } RIL_KeepaliveType;
7176 #define MAX_INADDR_LEN 16
7178 RIL_KeepaliveType type; /* Type of keepalive packet */
7179 char sourceAddress[MAX_INADDR_LEN]; /* Source address in network-byte order */
7180 int sourcePort; /* Source port if applicable, or 0x7FFFFFFF;
7181 the maximum value is 65535 */
7182 char destinationAddress[MAX_INADDR_LEN]; /* Destination address in network-byte order */
7183 int destinationPort; /* Destination port if applicable or 0x7FFFFFFF;
7184 the maximum value is 65535 */
7185 int maxKeepaliveIntervalMillis; /* Maximum milliseconds between two packets */
7186 int cid; /* Context ID, uniquely identifies this call */
7187 } RIL_KeepaliveRequest;
7190 KEEPALIVE_ACTIVE, /* Keepalive session is active */
7191 KEEPALIVE_INACTIVE, /* Keepalive session is inactive */
7192 KEEPALIVE_PENDING /* Keepalive session status not available */
7193 } RIL_KeepaliveStatusCode;
7196 uint32_t sessionHandle;
7197 RIL_KeepaliveStatusCode code;
7198 } RIL_KeepaliveStatus;
7203 * "t" is parameter passed in on previous call to RIL_Notification
7206 * If "e" != SUCCESS, then response can be null/is ignored
7208 * "response" is owned by caller, and should not be modified or
7211 * RIL_onRequestComplete will return as soon as possible
7213 void (*OnRequestComplete)(RIL_Token t, RIL_Errno e,
7214 void *response, size_t responselen);
7216 #if defined(ANDROID_MULTI_SIM)
7218 * "unsolResponse" is one of RIL_UNSOL_RESPONSE_*
7219 * "data" is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7221 * "data" is owned by caller, and should not be modified or freed by callee
7223 void (*OnUnsolicitedResponse)(int unsolResponse, const void *data, size_t datalen, RIL_SOCKET_ID socket_id);
7226 * "unsolResponse" is one of RIL_UNSOL_RESPONSE_*
7227 * "data" is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7229 * "data" is owned by caller, and should not be modified or freed by callee
7231 void (*OnUnsolicitedResponse)(int unsolResponse, const void *data, size_t datalen);
7234 * Call user-specifed "callback" function on on the same thread that
7235 * RIL_RequestFunc is called. If "relativeTime" is specified, then it specifies
7236 * a relative time value at which the callback is invoked. If relativeTime is
7237 * NULL or points to a 0-filled structure, the callback will be invoked as
7241 void (*RequestTimedCallback) (RIL_TimedCallback callback,
7242 void *param, const struct timeval *relativeTime);
7244 * "t" is parameter passed in on previous call RIL_Notification routine
7246 * RIL_onRequestAck will be called by vendor when an Async RIL request was received
7247 * by them and an ack needs to be sent back to java ril.
7249 void (*OnRequestAck) (RIL_Token t);
7254 * RIL implementations must defined RIL_Init
7255 * argc and argv will be command line arguments intended for the RIL implementation
7256 * Return NULL on error
7258 * @param env is environment point defined as RIL_Env
7259 * @param argc number of arguments
7260 * @param argv list fo arguments
7263 const RIL_RadioFunctions *RIL_Init(const struct RIL_Env *env, int argc, char **argv);
7266 * If BT SAP(SIM Access Profile) is supported, then RIL implementations must define RIL_SAP_Init
7267 * for initializing RIL_RadioFunctions used for BT SAP communcations. It is called whenever RILD
7268 * starts or modem restarts. Returns handlers for SAP related request that are made on SAP
7269 * sepecific socket, analogous to the RIL_RadioFunctions returned by the call to RIL_Init
7270 * and used on the general RIL socket.
7271 * argc and argv will be command line arguments intended for the RIL implementation
7272 * Return NULL on error.
7274 * @param env is environment point defined as RIL_Env
7275 * @param argc number of arguments
7276 * @param argv list fo arguments
7279 const RIL_RadioFunctions *RIL_SAP_Init(const struct RIL_Env *env, int argc, char **argv);
7281 #else /* RIL_SHLIB */
7284 * Call this once at startup to register notification routine
7286 * @param callbacks user-specifed callback function
7288 void RIL_register (const RIL_RadioFunctions *callbacks);
7290 void rilc_thread_pool();
7295 * RIL_onRequestComplete will return as soon as possible
7297 * @param t is parameter passed in on previous call to RIL_Notification
7299 * @param e error code
7300 * if "e" != SUCCESS, then response can be null/is ignored
7301 * @param response is owned by caller, and should not be modified or
7303 * @param responselen the length of response in byte
7305 void RIL_onRequestComplete(RIL_Token t, RIL_Errno e,
7306 void *response, size_t responselen);
7309 * RIL_onRequestAck will be called by vendor when an Async RIL request was received by them and
7310 * an ack needs to be sent back to java ril. This doesn't mark the end of the command or it's
7311 * results, just that the command was received and will take a while. After sending this Ack
7312 * its vendor's responsibility to make sure that AP is up whenever needed while command is
7315 * @param t is parameter passed in on previous call to RIL_Notification
7318 void RIL_onRequestAck(RIL_Token t);
7320 #if defined(ANDROID_MULTI_SIM)
7322 * @param unsolResponse is one of RIL_UNSOL_RESPONSE_*
7323 * @param data is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7324 * "data" is owned by caller, and should not be modified or freed by callee
7325 * @param datalen the length of data in byte
7328 void RIL_onUnsolicitedResponse(int unsolResponse, const void *data,
7329 size_t datalen, RIL_SOCKET_ID socket_id);
7332 * @param unsolResponse is one of RIL_UNSOL_RESPONSE_*
7333 * @param data is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7334 * "data" is owned by caller, and should not be modified or freed by callee
7335 * @param datalen the length of data in byte
7338 void RIL_onUnsolicitedResponse(int unsolResponse, const void *data,
7343 * Call user-specifed "callback" function on on the same thread that
7344 * RIL_RequestFunc is called. If "relativeTime" is specified, then it specifies
7345 * a relative time value at which the callback is invoked. If relativeTime is
7346 * NULL or points to a 0-filled structure, the callback will be invoked as
7349 * @param callback user-specifed callback function
7350 * @param param parameter list
7351 * @param relativeTime a relative time value at which the callback is invoked
7354 void RIL_requestTimedCallback (RIL_TimedCallback callback,
7355 void *param, const struct timeval *relativeTime);
7357 #endif /* RIL_SHLIB */
7363 #endif /*ANDROID_RIL_H*/