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
2186 } RIL_NetworkScanResult;
2189 * RIL_REQUEST_GET_SIM_STATUS
2191 * Requests status of the SIM interface and the SIM card
2195 * "response" is const RIL_CardStatus_v6 *
2200 * RADIO_NOT_AVAILABLE
2205 * REQUEST_NOT_SUPPORTED
2207 #define RIL_REQUEST_GET_SIM_STATUS 1
2210 * RIL_REQUEST_ENTER_SIM_PIN
2212 * Supplies SIM PIN. Only called if RIL_CardStatus has RIL_APPSTATE_PIN state
2214 * "data" is const char **
2215 * ((const char **)data)[0] is PIN value
2216 * ((const char **)data)[1] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2218 * "response" is int *
2219 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2224 * RADIO_NOT_AVAILABLE (radio resetting)
2225 * PASSWORD_INCORRECT
2232 * REQUEST_NOT_SUPPORTED
2235 #define RIL_REQUEST_ENTER_SIM_PIN 2
2238 * RIL_REQUEST_ENTER_SIM_PUK
2240 * Supplies SIM PUK and new PIN.
2242 * "data" is const char **
2243 * ((const char **)data)[0] is PUK value
2244 * ((const char **)data)[1] is new PIN value
2245 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2247 * "response" is int *
2248 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2253 * RADIO_NOT_AVAILABLE (radio resetting)
2254 * PASSWORD_INCORRECT
2262 * REQUEST_NOT_SUPPORTED
2265 #define RIL_REQUEST_ENTER_SIM_PUK 3
2268 * RIL_REQUEST_ENTER_SIM_PIN2
2270 * Supplies SIM PIN2. Only called following operation where SIM_PIN2 was
2271 * returned as a a failure from a previous operation.
2273 * "data" is const char **
2274 * ((const char **)data)[0] is PIN2 value
2275 * ((const char **)data)[1] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2277 * "response" is int *
2278 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2283 * RADIO_NOT_AVAILABLE (radio resetting)
2284 * PASSWORD_INCORRECT
2291 * REQUEST_NOT_SUPPORTED
2294 #define RIL_REQUEST_ENTER_SIM_PIN2 4
2297 * RIL_REQUEST_ENTER_SIM_PUK2
2299 * Supplies SIM PUK2 and new PIN2.
2301 * "data" is const char **
2302 * ((const char **)data)[0] is PUK2 value
2303 * ((const char **)data)[1] is new PIN2 value
2304 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2306 * "response" is int *
2307 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2312 * RADIO_NOT_AVAILABLE (radio resetting)
2313 * PASSWORD_INCORRECT
2321 * REQUEST_NOT_SUPPORTED
2324 #define RIL_REQUEST_ENTER_SIM_PUK2 5
2327 * RIL_REQUEST_CHANGE_SIM_PIN
2329 * Supplies old SIM PIN and new PIN.
2331 * "data" is const char **
2332 * ((const char **)data)[0] is old PIN value
2333 * ((const char **)data)[1] is new PIN value
2334 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2336 * "response" is int *
2337 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2342 * RADIO_NOT_AVAILABLE (radio resetting)
2343 * PASSWORD_INCORRECT
2344 * (old PIN is invalid)
2351 * REQUEST_NOT_SUPPORTED
2354 #define RIL_REQUEST_CHANGE_SIM_PIN 6
2358 * RIL_REQUEST_CHANGE_SIM_PIN2
2360 * Supplies old SIM PIN2 and new PIN2.
2362 * "data" is const char **
2363 * ((const char **)data)[0] is old PIN2 value
2364 * ((const char **)data)[1] is new PIN2 value
2365 * ((const char **)data)[2] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2367 * "response" is int *
2368 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2373 * RADIO_NOT_AVAILABLE (radio resetting)
2374 * PASSWORD_INCORRECT
2375 * (old PIN2 is invalid)
2382 * REQUEST_NOT_SUPPORTED
2386 #define RIL_REQUEST_CHANGE_SIM_PIN2 7
2389 * RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION
2391 * Requests that network personlization be deactivated
2393 * "data" is const char **
2394 * ((const char **)(data))[0]] is network depersonlization code
2396 * "response" is int *
2397 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
2402 * RADIO_NOT_AVAILABLE (radio resetting)
2403 * PASSWORD_INCORRECT
2410 * REQUEST_NOT_SUPPORTED
2413 #define RIL_REQUEST_ENTER_NETWORK_DEPERSONALIZATION 8
2416 * RIL_REQUEST_GET_CURRENT_CALLS
2418 * Requests current call list
2422 * "response" must be a "const RIL_Call **"
2427 * RADIO_NOT_AVAILABLE (radio resetting)
2429 * (request will be made again in a few hundred msec)
2433 * REQUEST_NOT_SUPPORTED
2436 #define RIL_REQUEST_GET_CURRENT_CALLS 9
2442 * Initiate voice call
2444 * "data" is const RIL_Dial *
2445 * "response" is NULL
2447 * This method is never used for supplementary service codes
2451 * RADIO_NOT_AVAILABLE (radio resetting)
2452 * DIAL_MODIFIED_TO_USSD
2453 * DIAL_MODIFIED_TO_SS
2454 * DIAL_MODIFIED_TO_DIAL
2466 * OPERATION_NOT_ALLOWED
2469 * REQUEST_NOT_SUPPORTED
2471 #define RIL_REQUEST_DIAL 10
2474 * RIL_REQUEST_GET_IMSI
2478 * Only valid when radio state is "RADIO_STATE_ON"
2480 * "data" is const char **
2481 * ((const char **)data)[0] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
2482 * "response" is a const char * containing the IMSI
2486 * RADIO_NOT_AVAILABLE (radio resetting)
2492 * REQUEST_NOT_SUPPORTED
2495 #define RIL_REQUEST_GET_IMSI 11
2498 * RIL_REQUEST_HANGUP
2500 * Hang up a specific line (like AT+CHLD=1x)
2502 * After this HANGUP request returns, RIL should show the connection is NOT
2503 * active anymore in next RIL_REQUEST_GET_CURRENT_CALLS query.
2505 * "data" is an int *
2506 * (int *)data)[0] contains Connection index (value of 'x' in CHLD above)
2508 * "response" is NULL
2512 * RADIO_NOT_AVAILABLE (radio resetting)
2523 * REQUEST_NOT_SUPPORTED
2526 #define RIL_REQUEST_HANGUP 12
2529 * RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND
2531 * Hang up waiting or held (like AT+CHLD=0)
2533 * After this HANGUP request returns, RIL should show the connection is NOT
2534 * active anymore in next RIL_REQUEST_GET_CURRENT_CALLS query.
2537 * "response" is NULL
2541 * RADIO_NOT_AVAILABLE (radio resetting)
2549 * OPERATION_NOT_ALLOWED
2553 * REQUEST_NOT_SUPPORTED
2556 #define RIL_REQUEST_HANGUP_WAITING_OR_BACKGROUND 13
2559 * RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND
2561 * Hang up waiting or held (like AT+CHLD=1)
2563 * After this HANGUP request returns, RIL should show the connection is NOT
2564 * active anymore in next RIL_REQUEST_GET_CURRENT_CALLS query.
2567 * "response" is NULL
2571 * RADIO_NOT_AVAILABLE (radio resetting)
2577 * OPERATION_NOT_ALLOWED
2581 * REQUEST_NOT_SUPPORTED
2584 #define RIL_REQUEST_HANGUP_FOREGROUND_RESUME_BACKGROUND 14
2587 * RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE
2589 * Switch waiting or holding call and active call (like AT+CHLD=2)
2591 * State transitions should be is follows:
2593 * If call 1 is waiting and call 2 is active, then if this re
2596 * Call 1 Call 2 Call 1 Call 2
2597 * ACTIVE HOLDING HOLDING ACTIVE
2598 * ACTIVE WAITING HOLDING ACTIVE
2599 * HOLDING WAITING HOLDING ACTIVE
2600 * ACTIVE IDLE HOLDING IDLE
2601 * IDLE IDLE IDLE IDLE
2604 * "response" is NULL
2608 * RADIO_NOT_AVAILABLE (radio resetting)
2616 * OPERATION_NOT_ALLOWED
2619 * REQUEST_NOT_SUPPORTED
2622 #define RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE 15
2623 #define RIL_REQUEST_SWITCH_HOLDING_AND_ACTIVE 15
2626 * RIL_REQUEST_CONFERENCE
2628 * Conference holding and active (like AT+CHLD=3)
2631 * "response" is NULL
2635 * RADIO_NOT_AVAILABLE (radio resetting)
2642 * OPERATION_NOT_ALLOWED
2645 * REQUEST_NOT_SUPPORTED
2647 #define RIL_REQUEST_CONFERENCE 16
2652 * Send UDUB (user determined used busy) to ringing or
2653 * waiting call answer)(RIL_BasicRequest r);
2656 * "response" is NULL
2660 * RADIO_NOT_AVAILABLE (radio resetting)
2667 * OPERATION_NOT_ALLOWED
2670 * REQUEST_NOT_SUPPORTED
2672 #define RIL_REQUEST_UDUB 17
2675 * RIL_REQUEST_LAST_CALL_FAIL_CAUSE
2677 * Requests the failure cause code for the most recently terminated call
2680 * "response" is a const RIL_LastCallFailCauseInfo *
2681 * RIL_LastCallFailCauseInfo contains LastCallFailCause and vendor cause.
2682 * The vendor cause code must be used for debugging purpose only.
2683 * The implementation must return one of the values of LastCallFailCause
2684 * as mentioned below.
2686 * GSM failure reasons codes for the cause codes defined in TS 24.008 Annex H
2688 * CDMA failure reasons codes for the possible call failure scenarios
2689 * described in the "CDMA IS-2000 Release A (C.S0005-A v6.0)" standard.
2690 * Any of the following reason codes if the call is failed or dropped due to reason
2691 * mentioned with in the braces.
2693 * CALL_FAIL_RADIO_OFF (Radio is OFF)
2694 * CALL_FAIL_OUT_OF_SERVICE (No cell coverage)
2695 * CALL_FAIL_NO_VALID_SIM (No valid SIM)
2696 * CALL_FAIL_RADIO_INTERNAL_ERROR (Modem hit unexpected error scenario)
2697 * CALL_FAIL_NETWORK_RESP_TIMEOUT (No response from network)
2698 * CALL_FAIL_NETWORK_REJECT (Explicit network reject)
2699 * CALL_FAIL_RADIO_ACCESS_FAILURE (RRC connection failure. Eg.RACH)
2700 * CALL_FAIL_RADIO_LINK_FAILURE (Radio Link Failure)
2701 * CALL_FAIL_RADIO_LINK_LOST (Radio link lost due to poor coverage)
2702 * CALL_FAIL_RADIO_UPLINK_FAILURE (Radio uplink failure)
2703 * CALL_FAIL_RADIO_SETUP_FAILURE (RRC connection setup failure)
2704 * CALL_FAIL_RADIO_RELEASE_NORMAL (RRC connection release, normal)
2705 * CALL_FAIL_RADIO_RELEASE_ABNORMAL (RRC connection release, abnormal)
2706 * CALL_FAIL_ACCESS_CLASS_BLOCKED (Access class barring)
2707 * CALL_FAIL_NETWORK_DETACH (Explicit network detach)
2709 * OEM causes (CALL_FAIL_OEM_CAUSE_XX) must be used for debug purpose only
2711 * If the implementation does not have access to the exact cause codes,
2712 * then it should return one of the values listed in RIL_LastCallFailCause,
2713 * as the UI layer needs to distinguish these cases for tone generation or
2714 * error notification.
2718 * RADIO_NOT_AVAILABLE
2723 * REQUEST_NOT_SUPPORTED
2725 * See also: RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE
2727 #define RIL_REQUEST_LAST_CALL_FAIL_CAUSE 18
2730 * RIL_REQUEST_SIGNAL_STRENGTH
2732 * Requests current signal strength and associated information
2734 * Must succeed if radio is on.
2738 * "response" is a const RIL_SignalStrength *
2742 * RADIO_NOT_AVAILABLE
2748 * REQUEST_NOT_SUPPORTED
2752 #define RIL_REQUEST_SIGNAL_STRENGTH 19
2755 * RIL_REQUEST_VOICE_REGISTRATION_STATE
2757 * Request current registration state
2760 * "response" is a const RIL_VoiceRegistrationStateResponse *
2764 * RADIO_NOT_AVAILABLE
2769 * REQUEST_NOT_SUPPORTED
2771 #define RIL_REQUEST_VOICE_REGISTRATION_STATE 20
2774 * RIL_REQUEST_DATA_REGISTRATION_STATE
2776 * Request current DATA registration state
2779 * "response" is a const RIL_DataRegistrationStateResponse *
2783 * RADIO_NOT_AVAILABLE
2789 * REQUEST_NOT_SUPPORTED
2793 #define RIL_REQUEST_DATA_REGISTRATION_STATE 21
2796 * RIL_REQUEST_OPERATOR
2798 * Request current operator ONS or EONS
2801 * "response" is a "const char **"
2802 * ((const char **)response)[0] is long alpha ONS or EONS
2803 * or NULL if unregistered
2805 * ((const char **)response)[1] is short alpha ONS or EONS
2806 * or NULL if unregistered
2807 * ((const char **)response)[2] is 5 or 6 digit numeric code (MCC + MNC)
2808 * or NULL if unregistered
2812 * RADIO_NOT_AVAILABLE
2816 * REQUEST_NOT_SUPPORTED
2820 #define RIL_REQUEST_OPERATOR 22
2823 * RIL_REQUEST_RADIO_POWER
2825 * Toggle radio on and off (for "airplane" mode)
2826 * If the radio is is turned off/on the radio modem subsystem
2827 * is expected return to an initialized state. For instance,
2828 * any voice and data calls will be terminated and all associated
2832 * ((int *)data)[0] is > 0 for "Radio On"
2833 * ((int *)data)[0] is == 0 for "Radio Off"
2835 * "response" is NULL
2837 * Turn radio on if "on" > 0
2838 * Turn radio off if "on" == 0
2842 * RADIO_NOT_AVAILABLE
2843 * OPERATION_NOT_ALLOWED
2851 * OPERATION_NOT_ALLOWED
2852 * INVALID_MODEM_STATE
2853 * REQUEST_NOT_SUPPORTED
2857 #define RIL_REQUEST_RADIO_POWER 23
2864 * If the implementation is currently playing a tone requested via
2865 * RIL_REQUEST_DTMF_START, that tone should be cancelled and the new tone
2866 * should be played instead
2868 * "data" is a char * containing a single character with one of 12 values: 0-9,*,#
2869 * "response" is NULL
2871 * FIXME should this block/mute microphone?
2872 * How does this interact with local DTMF feedback?
2876 * RADIO_NOT_AVAILABLE
2885 * INVALID_MODEM_STATE
2886 * REQUEST_NOT_SUPPORTED
2888 * See also: RIL_REQUEST_DTMF_STOP, RIL_REQUEST_DTMF_START
2891 #define RIL_REQUEST_DTMF 24
2894 * RIL_REQUEST_SEND_SMS
2896 * Send an SMS message
2898 * "data" is const char **
2899 * ((const char **)data)[0] is SMSC address in GSM BCD format prefixed
2900 * by a length byte (as expected by TS 27.005) or NULL for default SMSC
2901 * ((const char **)data)[1] is SMS in PDU format as an ASCII hex string
2902 * less the SMSC address
2903 * TP-Layer-Length is be "strlen(((const char **)data)[1])/2"
2905 * "response" is a const RIL_SMS_Response *
2907 * Based on the return error, caller decides to resend if sending sms
2908 * fails. SMS_SEND_FAIL_RETRY means retry (i.e. error cause is 332)
2912 * RADIO_NOT_AVAILABLE
2913 * SMS_SEND_FAIL_RETRY
2919 * REQUEST_RATE_LIMITED
2920 * INVALID_SMS_FORMAT
2923 * INVALID_SMSC_ADDRESS
2926 * OPERATION_NOT_ALLOWED
2930 * REQUEST_NOT_SUPPORTED
2931 * MODE_NOT_SUPPORTED
2934 * FIXME how do we specify TP-Message-Reference if we need to resend?
2936 #define RIL_REQUEST_SEND_SMS 25
2940 * RIL_REQUEST_SEND_SMS_EXPECT_MORE
2942 * Send an SMS message. Identical to RIL_REQUEST_SEND_SMS,
2943 * except that more messages are expected to be sent soon. If possible,
2944 * keep SMS relay protocol link open (eg TS 27.005 AT+CMMS command)
2946 * "data" is const char **
2947 * ((const char **)data)[0] is SMSC address in GSM BCD format prefixed
2948 * by a length byte (as expected by TS 27.005) or NULL for default SMSC
2949 * ((const char **)data)[1] is SMS in PDU format as an ASCII hex string
2950 * less the SMSC address
2951 * TP-Layer-Length is be "strlen(((const char **)data)[1])/2"
2953 * "response" is a const RIL_SMS_Response *
2955 * Based on the return error, caller decides to resend if sending sms
2956 * fails. SMS_SEND_FAIL_RETRY means retry (i.e. error cause is 332)
2960 * RADIO_NOT_AVAILABLE
2961 * SMS_SEND_FAIL_RETRY
2966 * INVALID_SMS_FORMAT
2968 * REQUEST_RATE_LIMITED
2973 * INVALID_SMSC_ADDRESS
2974 * OPERATION_NOT_ALLOWED
2978 * REQUEST_NOT_SUPPORTED
2979 * MODE_NOT_SUPPORTED
2983 #define RIL_REQUEST_SEND_SMS_EXPECT_MORE 26
2987 * RIL_REQUEST_SETUP_DATA_CALL
2989 * Setup a packet data connection. If RIL_Data_Call_Response_v6.status
2990 * return success it is added to the list of data calls and a
2991 * RIL_UNSOL_DATA_CALL_LIST_CHANGED is sent. The call remains in the
2992 * list until RIL_REQUEST_DEACTIVATE_DATA_CALL is issued or the
2993 * radio is powered off/on. This list is returned by RIL_REQUEST_DATA_CALL_LIST
2994 * and RIL_UNSOL_DATA_CALL_LIST_CHANGED.
2996 * The RIL is expected to:
2997 * - Create one data call context.
2998 * - Create and configure a dedicated interface for the context
2999 * - The interface must be point to point.
3000 * - The interface is configured with one or more addresses and
3001 * is capable of sending and receiving packets. The prefix length
3002 * of the addresses must be /32 for IPv4 and /128 for IPv6.
3003 * - Must NOT change the linux routing table.
3004 * - Support up to RIL_REQUEST_DATA_REGISTRATION_STATE response[5]
3005 * number of simultaneous data call contexts.
3007 * "data" is a const char **
3008 * ((const char **)data)[0] Radio technology to use: 0-CDMA, 1-GSM/UMTS, 2...
3009 * for values above 2 this is RIL_RadioTechnology + 2.
3010 * ((const char **)data)[1] is a RIL_DataProfile (support is optional)
3011 * ((const char **)data)[2] is the APN to connect to if radio technology is GSM/UMTS. This APN will
3012 * override the one in the profile. NULL indicates no APN overrride.
3013 * ((const char **)data)[3] is the username for APN, or NULL
3014 * ((const char **)data)[4] is the password for APN, or NULL
3015 * ((const char **)data)[5] is the PAP / CHAP auth type. Values:
3016 * 0 => PAP and CHAP is never performed.
3017 * 1 => PAP may be performed; CHAP is never performed.
3018 * 2 => CHAP may be performed; PAP is never performed.
3019 * 3 => PAP / CHAP may be performed - baseband dependent.
3020 * ((const char **)data)[6] is the non-roaming/home connection type to request. Must be one of the
3021 * PDP_type values in TS 27.007 section 10.1.1.
3022 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
3023 * ((const char **)data)[7] is the roaming connection type to request. Must be one of the
3024 * PDP_type values in TS 27.007 section 10.1.1.
3025 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
3026 * ((const char **)data)[8] is the bitmask of APN type in decimal string format. The
3027 * bitmask will encapsulate the following values:
3028 * ia,mms,agps,supl,hipri,fota,dun,ims,default.
3029 * ((const char **)data)[9] is the bearer bitmask in decimal string format. Each bit is a
3030 * RIL_RadioAccessFamily. "0" or NULL indicates all RATs.
3031 * ((const char **)data)[10] is the boolean in string format indicating the APN setting was
3032 * sent to the modem through RIL_REQUEST_SET_DATA_PROFILE earlier.
3033 * ((const char **)data)[11] is the mtu size in bytes of the mobile interface to which
3034 * the apn is connected.
3035 * ((const char **)data)[12] is the MVNO type:
3036 * possible values are "imsi", "gid", "spn".
3037 * ((const char **)data)[13] is MVNO match data in string. Can be anything defined by the carrier.
3039 * SPN like: "A MOBILE", "BEN NL", etc...
3040 * IMSI like: "302720x94", "2060188", etc...
3041 * GID like: "4E", "33", etc...
3042 * ((const char **)data)[14] is the boolean string indicating data roaming is allowed or not. "1"
3043 * indicates data roaming is enabled by the user, "0" indicates disabled.
3045 * "response" is a RIL_Data_Call_Response_v11
3047 * FIXME may need way to configure QoS settings
3050 * SUCCESS should be returned on both success and failure of setup with
3051 * the RIL_Data_Call_Response_v6.status containing the actual status.
3052 * For all other errors the RIL_Data_Call_Resonse_v6 is ignored.
3054 * Other errors could include:
3055 * RADIO_NOT_AVAILABLE, OP_NOT_ALLOWED_BEFORE_REG_TO_NW,
3056 * OP_NOT_ALLOWED_DURING_VOICE_CALL, REQUEST_NOT_SUPPORTED,
3057 * INVALID_ARGUMENTS, INTERNAL_ERR, NO_MEMORY, NO_RESOURCES,
3058 * CANCELLED and SIM_ABSENT
3060 * See also: RIL_REQUEST_DEACTIVATE_DATA_CALL
3062 #define RIL_REQUEST_SETUP_DATA_CALL 27
3066 * RIL_REQUEST_SIM_IO
3068 * Request SIM I/O operation.
3069 * This is similar to the TS 27.007 "restricted SIM" operation
3070 * where it assumes all of the EF selection will be done by the
3073 * "data" is a const RIL_SIM_IO_v6 *
3074 * Please note that RIL_SIM_IO has a "PIN2" field which may be NULL,
3075 * or may specify a PIN2 for operations that require a PIN2 (eg
3076 * updating FDN records)
3078 * "response" is a const RIL_SIM_IO_Response *
3080 * Arguments and responses that are unused for certain
3081 * values of "command" should be ignored or set to NULL
3085 * RADIO_NOT_AVAILABLE
3090 * REQUEST_NOT_SUPPORTED
3092 #define RIL_REQUEST_SIM_IO 28
3095 * RIL_REQUEST_SEND_USSD
3097 * Send a USSD message
3099 * If a USSD session already exists, the message should be sent in the
3100 * context of that session. Otherwise, a new session should be created.
3102 * The network reply should be reported via RIL_UNSOL_ON_USSD
3104 * Only one USSD session may exist at a time, and the session is assumed
3106 * a) The android system invokes RIL_REQUEST_CANCEL_USSD
3107 * b) The implementation sends a RIL_UNSOL_ON_USSD with a type code
3108 * of "0" (USSD-Notify/no further action) or "2" (session terminated)
3110 * "data" is a const char * containing the USSD request in UTF-8 format
3111 * "response" is NULL
3115 * RADIO_NOT_AVAILABLE
3117 * USSD_MODIFIED_TO_DIAL
3118 * USSD_MODIFIED_TO_SS
3119 * USSD_MODIFIED_TO_USSD
3121 * OPERATION_NOT_ALLOWED
3131 * REQUEST_NOT_SUPPORTED
3133 * See also: RIL_REQUEST_CANCEL_USSD, RIL_UNSOL_ON_USSD
3136 #define RIL_REQUEST_SEND_USSD 29
3139 * RIL_REQUEST_CANCEL_USSD
3141 * Cancel the current USSD session if one exists
3144 * "response" is NULL
3148 * RADIO_NOT_AVAILABLE
3150 * OPERATION_NOT_ALLOWED
3157 * REQUEST_NOT_SUPPORTED
3160 #define RIL_REQUEST_CANCEL_USSD 30
3163 * RIL_REQUEST_GET_CLIR
3165 * Gets current CLIR status
3167 * "response" is int *
3168 * ((int *)data)[0] is "n" parameter from TS 27.007 7.7
3169 * ((int *)data)[1] is "m" parameter from TS 27.007 7.7
3173 * RADIO_NOT_AVAILABLE
3174 * SS_MODIFIED_TO_DIAL
3175 * SS_MODIFIED_TO_USSD
3184 * REQUEST_NOT_SUPPORTED
3186 #define RIL_REQUEST_GET_CLIR 31
3189 * RIL_REQUEST_SET_CLIR
3192 * ((int *)data)[0] is "n" parameter from TS 27.007 7.7
3194 * "response" is NULL
3198 * RADIO_NOT_AVAILABLE
3199 * SS_MODIFIED_TO_DIAL
3200 * SS_MODIFIED_TO_USSD
3208 * REQUEST_NOT_SUPPORTED
3210 #define RIL_REQUEST_SET_CLIR 32
3213 * RIL_REQUEST_QUERY_CALL_FORWARD_STATUS
3215 * "data" is const RIL_CallForwardInfo *
3217 * "response" is const RIL_CallForwardInfo **
3218 * "response" points to an array of RIL_CallForwardInfo *'s, one for
3219 * each distinct registered phone number.
3221 * For example, if data is forwarded to +18005551212 and voice is forwarded
3222 * to +18005559999, then two separate RIL_CallForwardInfo's should be returned
3224 * If, however, both data and voice are forwarded to +18005551212, then
3225 * a single RIL_CallForwardInfo can be returned with the service class
3226 * set to "data + voice = 3")
3230 * RADIO_NOT_AVAILABLE
3231 * SS_MODIFIED_TO_DIAL
3232 * SS_MODIFIED_TO_USSD
3243 * REQUEST_NOT_SUPPORTED
3245 #define RIL_REQUEST_QUERY_CALL_FORWARD_STATUS 33
3249 * RIL_REQUEST_SET_CALL_FORWARD
3251 * Configure call forward rule
3253 * "data" is const RIL_CallForwardInfo *
3254 * "response" is NULL
3258 * RADIO_NOT_AVAILABLE
3259 * SS_MODIFIED_TO_DIAL
3260 * SS_MODIFIED_TO_USSD
3271 * REQUEST_NOT_SUPPORTED
3273 #define RIL_REQUEST_SET_CALL_FORWARD 34
3277 * RIL_REQUEST_QUERY_CALL_WAITING
3279 * Query current call waiting state
3281 * "data" is const int *
3282 * ((const int *)data)[0] is the TS 27.007 service class to query.
3283 * "response" is a const int *
3284 * ((const int *)response)[0] is 0 for "disabled" and 1 for "enabled"
3286 * If ((const int *)response)[0] is = 1, then ((const int *)response)[1]
3287 * must follow, with the TS 27.007 service class bit vector of services
3288 * for which call waiting is enabled.
3290 * For example, if ((const int *)response)[0] is 1 and
3291 * ((const int *)response)[1] is 3, then call waiting is enabled for data
3292 * and voice and disabled for everything else
3296 * RADIO_NOT_AVAILABLE
3297 * SS_MODIFIED_TO_DIAL
3298 * SS_MODIFIED_TO_USSD
3308 * REQUEST_NOT_SUPPORTED
3310 #define RIL_REQUEST_QUERY_CALL_WAITING 35
3314 * RIL_REQUEST_SET_CALL_WAITING
3316 * Configure current call waiting state
3318 * "data" is const int *
3319 * ((const int *)data)[0] is 0 for "disabled" and 1 for "enabled"
3320 * ((const int *)data)[1] is the TS 27.007 service class bit vector of
3321 * services to modify
3322 * "response" is NULL
3326 * RADIO_NOT_AVAILABLE
3327 * SS_MODIFIED_TO_DIAL
3328 * SS_MODIFIED_TO_USSD
3338 * REQUEST_NOT_SUPPORTED
3340 #define RIL_REQUEST_SET_CALL_WAITING 36
3343 * RIL_REQUEST_SMS_ACKNOWLEDGE
3345 * Acknowledge successful or failed receipt of SMS previously indicated
3346 * via RIL_UNSOL_RESPONSE_NEW_SMS
3349 * ((int *)data)[0] is 1 on successful receipt
3350 * (basically, AT+CNMA=1 from TS 27.005
3351 * is 0 on failed receipt
3352 * (basically, AT+CNMA=2 from TS 27.005)
3353 * ((int *)data)[1] if data[0] is 0, this contains the failure cause as defined
3354 * in TS 23.040, 9.2.3.22. Currently only 0xD3 (memory
3355 * capacity exceeded) and 0xFF (unspecified error) are
3358 * "response" is NULL
3360 * FIXME would like request that specified RP-ACK/RP-ERROR PDU
3364 * RADIO_NOT_AVAILABLE
3369 * REQUEST_NOT_SUPPORTED
3371 #define RIL_REQUEST_SMS_ACKNOWLEDGE 37
3374 * RIL_REQUEST_GET_IMEI - DEPRECATED
3376 * Get the device IMEI, including check digit
3378 * The request is DEPRECATED, use RIL_REQUEST_DEVICE_IDENTITY
3379 * Valid when RadioState is not RADIO_STATE_UNAVAILABLE
3382 * "response" is a const char * containing the IMEI
3386 * RADIO_NOT_AVAILABLE (radio resetting)
3392 * REQUEST_NOT_SUPPORTED
3397 #define RIL_REQUEST_GET_IMEI 38
3400 * RIL_REQUEST_GET_IMEISV - DEPRECATED
3402 * Get the device IMEISV, which should be two decimal digits
3404 * The request is DEPRECATED, use RIL_REQUEST_DEVICE_IDENTITY
3405 * Valid when RadioState is not RADIO_STATE_UNAVAILABLE
3408 * "response" is a const char * containing the IMEISV
3412 * RADIO_NOT_AVAILABLE (radio resetting)
3418 * REQUEST_NOT_SUPPORTED
3423 #define RIL_REQUEST_GET_IMEISV 39
3427 * RIL_REQUEST_ANSWER
3429 * Answer incoming call
3431 * Will not be called for WAITING calls.
3432 * RIL_REQUEST_SWITCH_WAITING_OR_HOLDING_AND_ACTIVE will be used in this case
3436 * "response" is NULL
3440 * RADIO_NOT_AVAILABLE (radio resetting)
3449 * REQUEST_NOT_SUPPORTED
3452 #define RIL_REQUEST_ANSWER 40
3455 * RIL_REQUEST_DEACTIVATE_DATA_CALL
3457 * Deactivate packet data connection and remove from the
3458 * data call list if SUCCESS is returned. Any other return
3459 * values should also try to remove the call from the list,
3460 * but that may not be possible. In any event a
3461 * RIL_REQUEST_RADIO_POWER off/on must clear the list. An
3462 * RIL_UNSOL_DATA_CALL_LIST_CHANGED is not expected to be
3463 * issued because of an RIL_REQUEST_DEACTIVATE_DATA_CALL.
3465 * "data" is const char **
3466 * ((char**)data)[0] indicating CID
3467 * ((char**)data)[1] indicating Disconnect Reason
3468 * 0 => No specific reason specified
3469 * 1 => Radio shutdown requested
3471 * "response" is NULL
3475 * RADIO_NOT_AVAILABLE
3479 * REQUEST_NOT_SUPPORTED
3486 * See also: RIL_REQUEST_SETUP_DATA_CALL
3488 #define RIL_REQUEST_DEACTIVATE_DATA_CALL 41
3491 * RIL_REQUEST_QUERY_FACILITY_LOCK
3493 * Query the status of a facility lock state
3495 * "data" is const char **
3496 * ((const char **)data)[0] is the facility string code from TS 27.007 7.4
3497 * (eg "AO" for BAOC, "SC" for SIM lock)
3498 * ((const char **)data)[1] is the password, or "" if not required
3499 * ((const char **)data)[2] is the TS 27.007 service class bit vector of
3501 * ((const char **)data)[3] is AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
3502 * This is only applicable in the case of Fixed Dialing Numbers
3505 * "response" is an int *
3506 * ((const int *)response) 0 is the TS 27.007 service class bit vector of
3507 * services for which the specified barring facility
3508 * is active. "0" means "disabled for all"
3513 * RADIO_NOT_AVAILABLE
3514 * SS_MODIFIED_TO_DIAL
3515 * SS_MODIFIED_TO_USSD
3525 * REQUEST_NOT_SUPPORTED
3528 #define RIL_REQUEST_QUERY_FACILITY_LOCK 42
3531 * RIL_REQUEST_SET_FACILITY_LOCK
3533 * Enable/disable one facility lock
3535 * "data" is const char **
3537 * ((const char **)data)[0] = facility string code from TS 27.007 7.4
3538 * (eg "AO" for BAOC)
3539 * ((const char **)data)[1] = "0" for "unlock" and "1" for "lock"
3540 * ((const char **)data)[2] = password
3541 * ((const char **)data)[3] = string representation of decimal TS 27.007
3542 * service class bit vector. Eg, the string
3543 * "1" means "set this facility for voice services"
3544 * ((const char **)data)[4] = AID value, See ETSI 102.221 8.1 and 101.220 4, NULL if no value.
3545 * This is only applicable in the case of Fixed Dialing Numbers
3548 * "response" is int *
3549 * ((int *)response)[0] is the number of retries remaining, or -1 if unknown
3553 * RADIO_NOT_AVAILABLE
3554 * SS_MODIFIED_TO_DIAL
3555 * SS_MODIFIED_TO_USSD
3565 * REQUEST_NOT_SUPPORTED
3568 #define RIL_REQUEST_SET_FACILITY_LOCK 43
3571 * RIL_REQUEST_CHANGE_BARRING_PASSWORD
3573 * Change call barring facility password
3575 * "data" is const char **
3577 * ((const char **)data)[0] = facility string code from TS 27.007 7.4
3578 * (eg "AO" for BAOC)
3579 * ((const char **)data)[1] = old password
3580 * ((const char **)data)[2] = new password
3582 * "response" is NULL
3586 * RADIO_NOT_AVAILABLE
3587 * SS_MODIFIED_TO_DIAL
3588 * SS_MODIFIED_TO_USSD
3598 * REQUEST_NOT_SUPPORTED
3601 #define RIL_REQUEST_CHANGE_BARRING_PASSWORD 44
3604 * RIL_REQUEST_QUERY_NETWORK_SELECTION_MODE
3606 * Query current network selectin mode
3610 * "response" is int *
3611 * ((const int *)response)[0] is
3612 * 0 for automatic selection
3613 * 1 for manual selection
3617 * RADIO_NOT_AVAILABLE
3623 * REQUEST_NOT_SUPPORTED
3628 #define RIL_REQUEST_QUERY_NETWORK_SELECTION_MODE 45
3631 * RIL_REQUEST_SET_NETWORK_SELECTION_AUTOMATIC
3633 * Specify that the network should be selected automatically
3636 * "response" is NULL
3638 * This request must not respond until the new operator is selected
3643 * RADIO_NOT_AVAILABLE
3645 * OPERATION_NOT_ALLOWED
3651 * REQUEST_NOT_SUPPORTED
3655 * Note: Returns ILLEGAL_SIM_OR_ME when the failure is permanent and
3656 * no retries needed, such as illegal SIM or ME.
3659 #define RIL_REQUEST_SET_NETWORK_SELECTION_AUTOMATIC 46
3662 * RIL_REQUEST_SET_NETWORK_SELECTION_MANUAL
3664 * Manually select a specified network.
3666 * "data" is const char * specifying MCCMNC of network to select (eg "310170")
3667 * "response" is NULL
3669 * This request must not respond until the new operator is selected
3674 * RADIO_NOT_AVAILABLE
3676 * OPERATION_NOT_ALLOWED
3683 * REQUEST_NOT_SUPPORTED
3687 * Note: Returns ILLEGAL_SIM_OR_ME when the failure is permanent and
3688 * no retries needed, such as illegal SIM or ME.
3691 #define RIL_REQUEST_SET_NETWORK_SELECTION_MANUAL 47
3694 * RIL_REQUEST_QUERY_AVAILABLE_NETWORKS
3696 * Scans for available networks
3699 * "response" is const char ** that should be an array of n*4 strings, where
3700 * n is the number of available networks
3701 * For each available network:
3703 * ((const char **)response)[n+0] is long alpha ONS or EONS
3704 * ((const char **)response)[n+1] is short alpha ONS or EONS
3705 * ((const char **)response)[n+2] is 5 or 6 digit numeric code (MCC + MNC)
3706 * ((const char **)response)[n+3] is a string value of the status:
3714 * RADIO_NOT_AVAILABLE
3715 * OPERATION_NOT_ALLOWED
3721 * REQUEST_NOT_SUPPORTED
3723 * OPERATION_NOT_ALLOWED
3728 #define RIL_REQUEST_QUERY_AVAILABLE_NETWORKS 48
3731 * RIL_REQUEST_DTMF_START
3733 * Start playing a DTMF tone. Continue playing DTMF tone until
3734 * RIL_REQUEST_DTMF_STOP is received
3736 * If a RIL_REQUEST_DTMF_START is received while a tone is currently playing,
3737 * it should cancel the previous tone and play the new one.
3739 * "data" is a char *
3740 * ((char *)data)[0] is a single character with one of 12 values: 0-9,*,#
3741 * "response" is NULL
3745 * RADIO_NOT_AVAILABLE
3754 * INVALID_MODEM_STATE
3755 * REQUEST_NOT_SUPPORTED
3757 * See also: RIL_REQUEST_DTMF, RIL_REQUEST_DTMF_STOP
3759 #define RIL_REQUEST_DTMF_START 49
3762 * RIL_REQUEST_DTMF_STOP
3764 * Stop playing a currently playing DTMF tone.
3767 * "response" is NULL
3771 * RADIO_NOT_AVAILABLE
3772 * OPERATION_NOT_ALLOWED
3781 * INVALID_MODEM_STATE
3782 * REQUEST_NOT_SUPPORTED
3784 * See also: RIL_REQUEST_DTMF, RIL_REQUEST_DTMF_START
3786 #define RIL_REQUEST_DTMF_STOP 50
3789 * RIL_REQUEST_BASEBAND_VERSION
3791 * Return string value indicating baseband version, eg
3792 * response from AT+CGMR
3795 * "response" is const char * containing version string for log reporting
3799 * RADIO_NOT_AVAILABLE
3806 * REQUEST_NOT_SUPPORTED
3811 #define RIL_REQUEST_BASEBAND_VERSION 51
3814 * RIL_REQUEST_SEPARATE_CONNECTION
3816 * Separate a party from a multiparty call placing the multiparty call
3817 * (less the specified party) on hold and leaving the specified party
3818 * as the only other member of the current (active) call
3822 * See TS 22.084 1.3.8.2 (iii)
3823 * TS 22.030 6.5.5 "Entering "2X followed by send"
3824 * TS 27.007 "AT+CHLD=2x"
3826 * "data" is an int *
3827 * (int *)data)[0] contains Connection index (value of 'x' in CHLD above) "response" is NULL
3829 * "response" is NULL
3833 * RADIO_NOT_AVAILABLE (radio resetting)
3843 * OPERATION_NOT_ALLOWED
3845 * REQUEST_NOT_SUPPORTED
3847 #define RIL_REQUEST_SEPARATE_CONNECTION 52
3851 * RIL_REQUEST_SET_MUTE
3853 * Turn on or off uplink (microphone) mute.
3855 * Will only be sent while voice call is active.
3856 * Will always be reset to "disable mute" when a new voice call is initiated
3858 * "data" is an int *
3859 * (int *)data)[0] is 1 for "enable mute" and 0 for "disable mute"
3861 * "response" is NULL
3865 * RADIO_NOT_AVAILABLE (radio resetting)
3868 * REQUEST_RATE_LIMITED
3872 * REQUEST_NOT_SUPPORTED
3875 #define RIL_REQUEST_SET_MUTE 53
3878 * RIL_REQUEST_GET_MUTE
3880 * Queries the current state of the uplink mute setting
3883 * "response" is an int *
3884 * (int *)response)[0] is 1 for "mute enabled" and 0 for "mute disabled"
3888 * RADIO_NOT_AVAILABLE (radio resetting)
3889 * SS_MODIFIED_TO_DIAL
3890 * SS_MODIFIED_TO_USSD
3893 * REQUEST_RATE_LIMITED
3897 * REQUEST_NOT_SUPPORTED
3900 #define RIL_REQUEST_GET_MUTE 54
3903 * RIL_REQUEST_QUERY_CLIP
3905 * Queries the status of the CLIP supplementary service
3907 * (for MMI code "*#30#")
3910 * "response" is an int *
3911 * (int *)response)[0] is 1 for "CLIP provisioned"
3912 * and 0 for "CLIP not provisioned"
3913 * and 2 for "unknown, e.g. no network etc"
3917 * RADIO_NOT_AVAILABLE (radio resetting)
3925 * REQUEST_NOT_SUPPORTED
3928 #define RIL_REQUEST_QUERY_CLIP 55
3931 * RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE - Deprecated use the status
3932 * field in RIL_Data_Call_Response_v6.
3934 * Requests the failure cause code for the most recently failed PDP
3935 * context or CDMA data connection active
3936 * replaces RIL_REQUEST_LAST_PDP_FAIL_CAUSE
3940 * "response" is a "int *"
3941 * ((int *)response)[0] is an integer cause code defined in TS 24.008
3942 * section 6.1.3.1.3 or close approximation
3944 * If the implementation does not have access to the exact cause codes,
3945 * then it should return one of the values listed in
3946 * RIL_DataCallFailCause, as the UI layer needs to distinguish these
3947 * cases for error notification
3948 * and potential retries.
3952 * RADIO_NOT_AVAILABLE
3957 * REQUEST_NOT_SUPPORTED
3959 * See also: RIL_REQUEST_LAST_CALL_FAIL_CAUSE
3961 * Deprecated use the status field in RIL_Data_Call_Response_v6.
3964 #define RIL_REQUEST_LAST_DATA_CALL_FAIL_CAUSE 56
3967 * RIL_REQUEST_DATA_CALL_LIST
3969 * Returns the data call list. An entry is added when a
3970 * RIL_REQUEST_SETUP_DATA_CALL is issued and removed on a
3971 * RIL_REQUEST_DEACTIVATE_DATA_CALL. The list is emptied
3972 * when RIL_REQUEST_RADIO_POWER off/on is issued.
3975 * "response" is an array of RIL_Data_Call_Response_v6
3979 * RADIO_NOT_AVAILABLE (radio resetting)
3984 * REQUEST_NOT_SUPPORTED
3987 * See also: RIL_UNSOL_DATA_CALL_LIST_CHANGED
3990 #define RIL_REQUEST_DATA_CALL_LIST 57
3993 * RIL_REQUEST_RESET_RADIO - DEPRECATED
3995 * Request a radio reset. The RIL implementation may postpone
3996 * the reset until after this request is responded to if the baseband
3997 * is presently busy.
3999 * The request is DEPRECATED, use RIL_REQUEST_RADIO_POWER
4002 * "response" is NULL
4006 * RADIO_NOT_AVAILABLE (radio resetting)
4007 * REQUEST_NOT_SUPPORTED
4010 #define RIL_REQUEST_RESET_RADIO 58
4013 * RIL_REQUEST_OEM_HOOK_RAW
4015 * This request reserved for OEM-specific uses. It passes raw byte arrays
4018 * It can be invoked on the Java side from
4019 * com.android.internal.telephony.Phone.invokeOemRilRequestRaw()
4021 * "data" is a char * of bytes copied from the byte[] data argument in java
4022 * "response" is a char * of bytes that will returned via the
4023 * caller's "response" Message here:
4024 * (byte[])(((AsyncResult)response.obj).result)
4026 * An error response here will result in
4027 * (((AsyncResult)response.obj).result) == null and
4028 * (((AsyncResult)response.obj).exception) being an instance of
4029 * com.android.internal.telephony.gsm.CommandException
4035 #define RIL_REQUEST_OEM_HOOK_RAW 59
4038 * RIL_REQUEST_OEM_HOOK_STRINGS
4040 * This request reserved for OEM-specific uses. It passes strings
4043 * It can be invoked on the Java side from
4044 * com.android.internal.telephony.Phone.invokeOemRilRequestStrings()
4046 * "data" is a const char **, representing an array of null-terminated UTF-8
4047 * strings copied from the "String[] strings" argument to
4048 * invokeOemRilRequestStrings()
4050 * "response" is a const char **, representing an array of null-terminated UTF-8
4051 * stings that will be returned via the caller's response message here:
4053 * (String[])(((AsyncResult)response.obj).result)
4055 * An error response here will result in
4056 * (((AsyncResult)response.obj).result) == null and
4057 * (((AsyncResult)response.obj).exception) being an instance of
4058 * com.android.internal.telephony.gsm.CommandException
4064 #define RIL_REQUEST_OEM_HOOK_STRINGS 60
4067 * RIL_REQUEST_SCREEN_STATE - DEPRECATED
4069 * Indicates the current state of the screen. When the screen is off, the
4070 * RIL should notify the baseband to suppress certain notifications (eg,
4071 * signal strength and changes in LAC/CID or BID/SID/NID/latitude/longitude)
4072 * in an effort to conserve power. These notifications should resume when the
4075 * Note this request is deprecated. Use RIL_REQUEST_SEND_DEVICE_STATE to report the device state
4076 * to the modem and use RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER to turn on/off unsolicited
4077 * response from the modem in different scenarios.
4080 * ((int *)data)[0] is == 1 for "Screen On"
4081 * ((int *)data)[0] is == 0 for "Screen Off"
4083 * "response" is NULL
4093 * REQUEST_NOT_SUPPORTED
4095 #define RIL_REQUEST_SCREEN_STATE 61
4099 * RIL_REQUEST_SET_SUPP_SVC_NOTIFICATION
4101 * Enables/disables supplementary service related notifications
4104 * Notifications are reported via RIL_UNSOL_SUPP_SVC_NOTIFICATION.
4107 * ((int *)data)[0] is == 1 for notifications enabled
4108 * ((int *)data)[0] is == 0 for notifications disabled
4110 * "response" is NULL
4114 * RADIO_NOT_AVAILABLE
4123 * REQUEST_NOT_SUPPORTED
4125 * See also: RIL_UNSOL_SUPP_SVC_NOTIFICATION.
4127 #define RIL_REQUEST_SET_SUPP_SVC_NOTIFICATION 62
4130 * RIL_REQUEST_WRITE_SMS_TO_SIM
4132 * Stores a SMS message to SIM memory.
4134 * "data" is RIL_SMS_WriteArgs *
4136 * "response" is int *
4137 * ((const int *)response)[0] is the record index where the message is stored.
4143 * INVALID_SMS_FORMAT
4149 * INVALID_MODEM_STATE
4150 * OPERATION_NOT_ALLOWED
4151 * INVALID_SMSC_ADDRESS
4153 * INVALID_MODEM_STATE
4154 * REQUEST_NOT_SUPPORTED
4158 #define RIL_REQUEST_WRITE_SMS_TO_SIM 63
4161 * RIL_REQUEST_DELETE_SMS_ON_SIM
4163 * Deletes a SMS message from SIM memory.
4166 * ((int *)data)[0] is the record index of the message to delete.
4168 * "response" is NULL
4175 * REQUEST_RATE_LIMITED
4182 * INVALID_MODEM_STATE
4183 * REQUEST_NOT_SUPPORTED
4187 #define RIL_REQUEST_DELETE_SMS_ON_SIM 64
4190 * RIL_REQUEST_SET_BAND_MODE
4192 * Assign a specified band for RF configuration.
4195 * ((int *)data)[0] is a RIL_RadioBandMode
4197 * "response" is NULL
4201 * RADIO_NOT_AVAILABLE
4202 * OPERATION_NOT_ALLOWED
4208 * REQUEST_NOT_SUPPORTED
4212 * See also: RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE
4214 #define RIL_REQUEST_SET_BAND_MODE 65
4217 * RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE
4219 * Query the list of band mode supported by RF.
4223 * "response" is int *
4224 * "response" points to an array of int's, the int[0] is the size of array;
4225 * subsequent values are a list of RIL_RadioBandMode listing supported modes.
4229 * RADIO_NOT_AVAILABLE
4234 * REQUEST_NOT_SUPPORTED
4238 * See also: RIL_REQUEST_SET_BAND_MODE
4240 #define RIL_REQUEST_QUERY_AVAILABLE_BAND_MODE 66
4243 * RIL_REQUEST_STK_GET_PROFILE
4245 * Requests the profile of SIM tool kit.
4246 * The profile indicates the SAT/USAT features supported by ME.
4247 * The SAT/USAT features refer to 3GPP TS 11.14 and 3GPP TS 31.111
4251 * "response" is a const char * containing SAT/USAT profile
4252 * in hexadecimal format string starting with first byte of terminal profile
4256 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4261 * REQUEST_NOT_SUPPORTED
4263 #define RIL_REQUEST_STK_GET_PROFILE 67
4266 * RIL_REQUEST_STK_SET_PROFILE
4268 * Download the STK terminal profile as part of SIM initialization
4271 * "data" is a const char * containing SAT/USAT profile
4272 * in hexadecimal format string starting with first byte of terminal profile
4274 * "response" is NULL
4278 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4283 * REQUEST_NOT_SUPPORTED
4285 #define RIL_REQUEST_STK_SET_PROFILE 68
4288 * RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND
4290 * Requests to send a SAT/USAT envelope command to SIM.
4291 * The SAT/USAT envelope command refers to 3GPP TS 11.14 and 3GPP TS 31.111
4293 * "data" is a const char * containing SAT/USAT command
4294 * in hexadecimal format string starting with command tag
4296 * "response" is a const char * containing SAT/USAT response
4297 * in hexadecimal format string starting with first byte of response
4302 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4304 * OPERATION_NOT_ALLOWED
4311 * REQUEST_NOT_SUPPORTED
4313 #define RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND 69
4316 * RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE
4318 * Requests to send a terminal response to SIM for a received
4321 * "data" is a const char * containing SAT/USAT response
4322 * in hexadecimal format string starting with first byte of response data
4324 * "response" is NULL
4328 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4329 * RIL_E_OPERATION_NOT_ALLOWED
4334 * INVALID_MODEM_STATE
4335 * REQUEST_NOT_SUPPORTED
4337 #define RIL_REQUEST_STK_SEND_TERMINAL_RESPONSE 70
4340 * RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM
4342 * When STK application gets RIL_UNSOL_STK_CALL_SETUP, the call actually has
4343 * been initialized by ME already. (We could see the call has been in the 'call
4344 * list') So, STK application needs to accept/reject the call according as user
4348 * ((int *)data)[0] is > 0 for "accept" the call setup
4349 * ((int *)data)[0] is == 0 for "reject" the call setup
4351 * "response" is NULL
4355 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
4356 * RIL_E_OPERATION_NOT_ALLOWED
4361 * REQUEST_NOT_SUPPORTED
4363 #define RIL_REQUEST_STK_HANDLE_CALL_SETUP_REQUESTED_FROM_SIM 71
4366 * RIL_REQUEST_EXPLICIT_CALL_TRANSFER
4368 * Connects the two calls and disconnects the subscriber from both calls.
4371 * "response" is NULL
4375 * RADIO_NOT_AVAILABLE (radio resetting)
4385 * OPERATION_NOT_ALLOWED
4388 * REQUEST_NOT_SUPPORTED
4390 #define RIL_REQUEST_EXPLICIT_CALL_TRANSFER 72
4393 * RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE
4395 * Requests to set the preferred network type for searching and registering
4396 * (CS/PS domain, RAT, and operation mode)
4398 * "data" is int * which is RIL_PreferredNetworkType
4400 * "response" is NULL
4404 * RADIO_NOT_AVAILABLE (radio resetting)
4405 * OPERATION_NOT_ALLOWED
4406 * MODE_NOT_SUPPORTED
4412 * REQUEST_NOT_SUPPORTED
4416 #define RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE 73
4419 * RIL_REQUEST_GET_PREFERRED_NETWORK_TYPE
4421 * Query the preferred network type (CS/PS domain, RAT, and operation mode)
4422 * for searching and registering
4426 * "response" is int *
4427 * ((int *)reponse)[0] is == RIL_PreferredNetworkType
4431 * RADIO_NOT_AVAILABLE
4437 * REQUEST_NOT_SUPPORTED
4441 * See also: RIL_REQUEST_SET_PREFERRED_NETWORK_TYPE
4443 #define RIL_REQUEST_GET_PREFERRED_NETWORK_TYPE 74
4446 * RIL_REQUEST_NEIGHBORING_CELL_IDS
4448 * Request neighboring cell id in GSM network
4451 * "response" must be a " const RIL_NeighboringCell** "
4455 * RADIO_NOT_AVAILABLE
4461 * REQUEST_NOT_SUPPORTED
4465 #define RIL_REQUEST_GET_NEIGHBORING_CELL_IDS 75
4468 * RIL_REQUEST_SET_LOCATION_UPDATES
4470 * Enables/disables network state change notifications due to changes in
4471 * LAC and/or CID (for GSM) or BID/SID/NID/latitude/longitude (for CDMA).
4472 * Basically +CREG=2 vs. +CREG=1 (TS 27.007).
4474 * Note: The RIL implementation should default to "updates enabled"
4475 * when the screen is on and "updates disabled" when the screen is off.
4478 * ((int *)data)[0] is == 1 for updates enabled (+CREG=2)
4479 * ((int *)data)[0] is == 0 for updates disabled (+CREG=1)
4481 * "response" is NULL
4485 * RADIO_NOT_AVAILABLE
4491 * REQUEST_NOT_SUPPORTED
4495 * See also: RIL_REQUEST_SCREEN_STATE, RIL_UNSOL_RESPONSE_NETWORK_STATE_CHANGED
4497 #define RIL_REQUEST_SET_LOCATION_UPDATES 76
4500 * RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE
4502 * Request to set the location where the CDMA subscription shall
4506 * ((int *)data)[0] is == RIL_CdmaSubscriptionSource
4508 * "response" is NULL
4512 * RADIO_NOT_AVAILABLE
4514 * SUBSCRIPTION_NOT_AVAILABLE
4519 * REQUEST_NOT_SUPPORTED
4521 * See also: RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE
4523 #define RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE 77
4526 * RIL_REQUEST_CDMA_SET_ROAMING_PREFERENCE
4528 * Request to set the roaming preferences in CDMA
4531 * ((int *)data)[0] is == 0 for Home Networks only, as defined in PRL
4532 * ((int *)data)[0] is == 1 for Roaming on Affiliated networks, as defined in PRL
4533 * ((int *)data)[0] is == 2 for Roaming on Any Network, as defined in the PRL
4535 * "response" is NULL
4539 * RADIO_NOT_AVAILABLE
4545 * REQUEST_NOT_SUPPORTED
4546 * OPERATION_NOT_ALLOWED
4550 #define RIL_REQUEST_CDMA_SET_ROAMING_PREFERENCE 78
4553 * RIL_REQUEST_CDMA_QUERY_ROAMING_PREFERENCE
4555 * Request the actual setting of the roaming preferences in CDMA in the modem
4559 * "response" is int *
4560 * ((int *)response)[0] is == 0 for Home Networks only, as defined in PRL
4561 * ((int *)response)[0] is == 1 for Roaming on Affiliated networks, as defined in PRL
4562 * ((int *)response)[0] is == 2 for Roaming on Any Network, as defined in the PRL
4564 * "response" is NULL
4568 * RADIO_NOT_AVAILABLE
4574 * REQUEST_NOT_SUPPORTED
4578 #define RIL_REQUEST_CDMA_QUERY_ROAMING_PREFERENCE 79
4581 * RIL_REQUEST_SET_TTY_MODE
4583 * Request to set the TTY mode
4586 * ((int *)data)[0] is == 0 for TTY off
4587 * ((int *)data)[0] is == 1 for TTY Full
4588 * ((int *)data)[0] is == 2 for TTY HCO (hearing carryover)
4589 * ((int *)data)[0] is == 3 for TTY VCO (voice carryover)
4591 * "response" is NULL
4595 * RADIO_NOT_AVAILABLE
4606 * REQUEST_NOT_SUPPORTED
4608 #define RIL_REQUEST_SET_TTY_MODE 80
4611 * RIL_REQUEST_QUERY_TTY_MODE
4613 * Request the setting of TTY mode
4617 * "response" is int *
4618 * ((int *)response)[0] is == 0 for TTY off
4619 * ((int *)response)[0] is == 1 for TTY Full
4620 * ((int *)response)[0] is == 2 for TTY HCO (hearing carryover)
4621 * ((int *)response)[0] is == 3 for TTY VCO (voice carryover)
4623 * "response" is NULL
4627 * RADIO_NOT_AVAILABLE
4634 * REQUEST_NOT_SUPPORTED
4636 #define RIL_REQUEST_QUERY_TTY_MODE 81
4639 * RIL_REQUEST_CDMA_SET_PREFERRED_VOICE_PRIVACY_MODE
4641 * Request to set the preferred voice privacy mode used in voice
4645 * ((int *)data)[0] is == 0 for Standard Privacy Mode (Public Long Code Mask)
4646 * ((int *)data)[0] is == 1 for Enhanced Privacy Mode (Private Long Code Mask)
4648 * "response" is NULL
4652 * RADIO_NOT_AVAILABLE
4661 * REQUEST_NOT_SUPPORTED
4663 #define RIL_REQUEST_CDMA_SET_PREFERRED_VOICE_PRIVACY_MODE 82
4666 * RIL_REQUEST_CDMA_QUERY_PREFERRED_VOICE_PRIVACY_MODE
4668 * Request the setting of preferred voice privacy mode
4672 * "response" is int *
4673 * ((int *)response)[0] is == 0 for Standard Privacy Mode (Public Long Code Mask)
4674 * ((int *)response)[0] is == 1 for Enhanced Privacy Mode (Private Long Code Mask)
4676 * "response" is NULL
4680 * RADIO_NOT_AVAILABLE
4687 * REQUEST_NOT_SUPPORTED
4689 #define RIL_REQUEST_CDMA_QUERY_PREFERRED_VOICE_PRIVACY_MODE 83
4692 * RIL_REQUEST_CDMA_FLASH
4696 * "data" is const char *
4697 * ((const char *)data)[0] is a FLASH string
4699 * "response" is NULL
4703 * RADIO_NOT_AVAILABLE
4713 * REQUEST_NOT_SUPPORTED
4716 #define RIL_REQUEST_CDMA_FLASH 84
4719 * RIL_REQUEST_CDMA_BURST_DTMF
4723 * "data" is const char **
4724 * ((const char **)data)[0] is a DTMF string
4725 * ((const char **)data)[1] is the DTMF ON length in milliseconds, or 0 to use
4727 * ((const char **)data)[2] is the DTMF OFF length in milliseconds, or 0 to use
4730 * "response" is NULL
4734 * RADIO_NOT_AVAILABLE
4743 * OPERATION_NOT_ALLOWED
4744 * REQUEST_NOT_SUPPORTED
4747 #define RIL_REQUEST_CDMA_BURST_DTMF 85
4750 * RIL_REQUEST_CDMA_VALIDATE_AND_WRITE_AKEY
4752 * Takes a 26 digit string (20 digit AKEY + 6 digit checksum).
4753 * If the checksum is valid the 20 digit AKEY is written to NV,
4754 * replacing the existing AKEY no matter what it was before.
4756 * "data" is const char *
4757 * ((const char *)data)[0] is a 26 digit string (ASCII digits '0'-'9')
4758 * where the last 6 digits are a checksum of the
4759 * first 20, as specified in TR45.AHAG
4760 * "Common Cryptographic Algorithms, Revision D.1
4763 * "response" is NULL
4767 * RADIO_NOT_AVAILABLE
4773 * REQUEST_NOT_SUPPORTED
4778 #define RIL_REQUEST_CDMA_VALIDATE_AND_WRITE_AKEY 86
4781 * RIL_REQUEST_CDMA_SEND_SMS
4783 * Send a CDMA SMS message
4785 * "data" is const RIL_CDMA_SMS_Message *
4787 * "response" is a const RIL_SMS_Response *
4789 * Based on the return error, caller decides to resend if sending sms
4790 * fails. The CDMA error class is derived as follows,
4791 * SUCCESS is error class 0 (no error)
4792 * SMS_SEND_FAIL_RETRY is error class 2 (temporary failure)
4796 * RADIO_NOT_AVAILABLE
4797 * SMS_SEND_FAIL_RETRY
4802 * REQUEST_RATE_LIMITED
4803 * INVALID_SMS_FORMAT
4809 * INVALID_SMSC_ADDRESS
4810 * OPERATION_NOT_ALLOWED
4813 * REQUEST_NOT_SUPPORTED
4814 * MODE_NOT_SUPPORTED
4818 #define RIL_REQUEST_CDMA_SEND_SMS 87
4821 * RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE
4823 * Acknowledge the success or failure in the receipt of SMS
4824 * previously indicated via RIL_UNSOL_RESPONSE_CDMA_NEW_SMS
4826 * "data" is const RIL_CDMA_SMS_Ack *
4828 * "response" is NULL
4832 * RADIO_NOT_AVAILABLE
4837 * REQUEST_RATE_LIMITED
4841 * OPERATION_NOT_ALLOWED
4843 * INVALID_MODEM_STATE
4844 * REQUEST_NOT_SUPPORTED
4847 #define RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE 88
4850 * RIL_REQUEST_GSM_GET_BROADCAST_SMS_CONFIG
4852 * Request the setting of GSM/WCDMA Cell Broadcast SMS config.
4856 * "response" is a const RIL_GSM_BroadcastSmsConfigInfo **
4857 * "responselen" is count * sizeof (RIL_GSM_BroadcastSmsConfigInfo *)
4861 * RADIO_NOT_AVAILABLE
4864 * REQUEST_RATE_LIMITED
4872 * INVALID_MODEM_STATE
4873 * REQUEST_NOT_SUPPORTED
4875 #define RIL_REQUEST_GSM_GET_BROADCAST_SMS_CONFIG 89
4878 * RIL_REQUEST_GSM_SET_BROADCAST_SMS_CONFIG
4880 * Set GSM/WCDMA Cell Broadcast SMS config
4882 * "data" is a const RIL_GSM_BroadcastSmsConfigInfo **
4883 * "datalen" is count * sizeof(RIL_GSM_BroadcastSmsConfigInfo *)
4885 * "response" is NULL
4889 * RADIO_NOT_AVAILABLE
4894 * REQUEST_RATE_LIMITED
4900 * INVALID_MODEM_STATE
4901 * REQUEST_NOT_SUPPORTED
4904 #define RIL_REQUEST_GSM_SET_BROADCAST_SMS_CONFIG 90
4907 * RIL_REQUEST_GSM_SMS_BROADCAST_ACTIVATION
4909 * Enable or disable the reception of GSM/WCDMA Cell Broadcast SMS
4911 * "data" is const int *
4912 * (const int *)data[0] indicates to activate or turn off the
4913 * reception of GSM/WCDMA Cell Broadcast SMS, 0-1,
4914 * 0 - Activate, 1 - Turn off
4916 * "response" is NULL
4920 * RADIO_NOT_AVAILABLE
4925 * REQUEST_RATE_LIMITED
4930 * INVALID_MODEM_STATE
4931 * REQUEST_NOT_SUPPORTED
4934 #define RIL_REQUEST_GSM_SMS_BROADCAST_ACTIVATION 91
4937 * RIL_REQUEST_CDMA_GET_BROADCAST_SMS_CONFIG
4939 * Request the setting of CDMA Broadcast SMS config
4943 * "response" is a const RIL_CDMA_BroadcastSmsConfigInfo **
4944 * "responselen" is count * sizeof (RIL_CDMA_BroadcastSmsConfigInfo *)
4948 * RADIO_NOT_AVAILABLE
4951 * REQUEST_RATE_LIMITED
4959 * INVALID_MODEM_STATE
4960 * REQUEST_NOT_SUPPORTED
4963 #define RIL_REQUEST_CDMA_GET_BROADCAST_SMS_CONFIG 92
4966 * RIL_REQUEST_CDMA_SET_BROADCAST_SMS_CONFIG
4968 * Set CDMA Broadcast SMS config
4970 * "data" is a const RIL_CDMA_BroadcastSmsConfigInfo **
4971 * "datalen" is count * sizeof(const RIL_CDMA_BroadcastSmsConfigInfo *)
4973 * "response" is NULL
4977 * RADIO_NOT_AVAILABLE
4982 * REQUEST_RATE_LIMITED
4988 * INVALID_MODEM_STATE
4989 * REQUEST_NOT_SUPPORTED
4992 #define RIL_REQUEST_CDMA_SET_BROADCAST_SMS_CONFIG 93
4995 * RIL_REQUEST_CDMA_SMS_BROADCAST_ACTIVATION
4997 * Enable or disable the reception of CDMA Broadcast SMS
4999 * "data" is const int *
5000 * (const int *)data[0] indicates to activate or turn off the
5001 * reception of CDMA Broadcast SMS, 0-1,
5002 * 0 - Activate, 1 - Turn off
5004 * "response" is NULL
5008 * RADIO_NOT_AVAILABLE
5013 * REQUEST_RATE_LIMITED
5018 * INVALID_MODEM_STATE
5019 * REQUEST_NOT_SUPPORTED
5022 #define RIL_REQUEST_CDMA_SMS_BROADCAST_ACTIVATION 94
5025 * RIL_REQUEST_CDMA_SUBSCRIPTION
5027 * Request the device MDN / H_SID / H_NID.
5029 * The request is only allowed when CDMA subscription is available. When CDMA
5030 * subscription is changed, application layer should re-issue the request to
5031 * update the subscription information.
5033 * If a NULL value is returned for any of the device id, it means that error
5034 * accessing the device.
5036 * "response" is const char **
5037 * ((const char **)response)[0] is MDN if CDMA subscription is available
5038 * ((const char **)response)[1] is a comma separated list of H_SID (Home SID) if
5039 * CDMA subscription is available, in decimal format
5040 * ((const char **)response)[2] is a comma separated list of H_NID (Home NID) if
5041 * CDMA subscription is available, in decimal format
5042 * ((const char **)response)[3] is MIN (10 digits, MIN2+MIN1) if CDMA subscription is available
5043 * ((const char **)response)[4] is PRL version if CDMA subscription is available
5047 * RIL_E_SUBSCRIPTION_NOT_AVAILABLE
5054 * REQUEST_NOT_SUPPORTED
5061 #define RIL_REQUEST_CDMA_SUBSCRIPTION 95
5064 * RIL_REQUEST_CDMA_WRITE_SMS_TO_RUIM
5066 * Stores a CDMA SMS message to RUIM memory.
5068 * "data" is RIL_CDMA_SMS_WriteArgs *
5070 * "response" is int *
5071 * ((const int *)response)[0] is the record index where the message is stored.
5075 * RADIO_NOT_AVAILABLE
5078 * INVALID_SMS_FORMAT
5084 * INVALID_MODEM_STATE
5085 * OPERATION_NOT_ALLOWED
5086 * INVALID_SMSC_ADDRESS
5088 * INVALID_MODEM_STATE
5089 * REQUEST_NOT_SUPPORTED
5093 #define RIL_REQUEST_CDMA_WRITE_SMS_TO_RUIM 96
5096 * RIL_REQUEST_CDMA_DELETE_SMS_ON_RUIM
5098 * Deletes a CDMA SMS message from RUIM memory.
5101 * ((int *)data)[0] is the record index of the message to delete.
5103 * "response" is NULL
5107 * RADIO_NOT_AVAILABLE
5110 * REQUEST_RATE_LIMITED
5117 * INVALID_MODEM_STATE
5118 * REQUEST_NOT_SUPPORTED
5121 #define RIL_REQUEST_CDMA_DELETE_SMS_ON_RUIM 97
5124 * RIL_REQUEST_DEVICE_IDENTITY
5126 * Request the device ESN / MEID / IMEI / IMEISV.
5128 * The request is always allowed and contains GSM and CDMA device identity;
5129 * it substitutes the deprecated requests RIL_REQUEST_GET_IMEI and
5130 * RIL_REQUEST_GET_IMEISV.
5132 * If a NULL value is returned for any of the device id, it means that error
5133 * accessing the device.
5135 * When CDMA subscription is changed the ESN/MEID may change. The application
5136 * layer should re-issue the request to update the device identity in this case.
5138 * "response" is const char **
5139 * ((const char **)response)[0] is IMEI if GSM subscription is available
5140 * ((const char **)response)[1] is IMEISV if GSM subscription is available
5141 * ((const char **)response)[2] is ESN if CDMA subscription is available
5142 * ((const char **)response)[3] is MEID if CDMA subscription is available
5146 * RADIO_NOT_AVAILABLE
5153 * REQUEST_NOT_SUPPORTED
5158 #define RIL_REQUEST_DEVICE_IDENTITY 98
5161 * RIL_REQUEST_EXIT_EMERGENCY_CALLBACK_MODE
5163 * Request the radio's system selection module to exit emergency
5164 * callback mode. RIL will not respond with SUCCESS until the modem has
5165 * completely exited from Emergency Callback Mode.
5169 * "response" is NULL
5173 * RADIO_NOT_AVAILABLE
5174 * OPERATION_NOT_ALLOWED
5180 * REQUEST_NOT_SUPPORTED
5185 #define RIL_REQUEST_EXIT_EMERGENCY_CALLBACK_MODE 99
5188 * RIL_REQUEST_GET_SMSC_ADDRESS
5190 * Queries the default Short Message Service Center address on the device.
5194 * "response" is const char * containing the SMSC address.
5198 * RADIO_NOT_AVAILABLE
5200 * REQUEST_RATE_LIMITED
5205 * INVALID_MODEM_STATE
5209 * REQUEST_NOT_SUPPORTED
5213 #define RIL_REQUEST_GET_SMSC_ADDRESS 100
5216 * RIL_REQUEST_SET_SMSC_ADDRESS
5218 * Sets the default Short Message Service Center address on the device.
5220 * "data" is const char * containing the SMSC address.
5222 * "response" is NULL
5226 * RADIO_NOT_AVAILABLE
5228 * INVALID_SMS_FORMAT
5231 * REQUEST_RATE_LIMITED
5236 * REQUEST_NOT_SUPPORTED
5239 #define RIL_REQUEST_SET_SMSC_ADDRESS 101
5242 * RIL_REQUEST_REPORT_SMS_MEMORY_STATUS
5244 * Indicates whether there is storage available for new SMS messages.
5247 * ((int *)data)[0] is 1 if memory is available for storing new messages
5248 * is 0 if memory capacity is exceeded
5250 * "response" is NULL
5254 * RADIO_NOT_AVAILABLE
5259 * REQUEST_RATE_LIMITED
5264 * REQUEST_NOT_SUPPORTED
5267 #define RIL_REQUEST_REPORT_SMS_MEMORY_STATUS 102
5270 * RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING
5272 * Indicates that the StkSerivce is running and is
5273 * ready to receive RIL_UNSOL_STK_XXXXX commands.
5276 * "response" is NULL
5280 * RADIO_NOT_AVAILABLE
5285 * REQUEST_NOT_SUPPORTED
5288 #define RIL_REQUEST_REPORT_STK_SERVICE_IS_RUNNING 103
5291 * RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE
5293 * Request to query the location where the CDMA subscription shall
5298 * "response" is int *
5299 * ((int *)data)[0] is == RIL_CdmaSubscriptionSource
5303 * RADIO_NOT_AVAILABLE
5304 * SUBSCRIPTION_NOT_AVAILABLE
5309 * REQUEST_NOT_SUPPORTED
5311 * See also: RIL_REQUEST_CDMA_SET_SUBSCRIPTION_SOURCE
5313 #define RIL_REQUEST_CDMA_GET_SUBSCRIPTION_SOURCE 104
5316 * RIL_REQUEST_ISIM_AUTHENTICATION
5318 * Request the ISIM application on the UICC to perform AKA
5319 * challenge/response algorithm for IMS authentication
5321 * "data" is a const char * containing the challenge string in Base64 format
5322 * "response" is a const char * containing the response in Base64 format
5326 * RADIO_NOT_AVAILABLE
5331 * REQUEST_NOT_SUPPORTED
5333 #define RIL_REQUEST_ISIM_AUTHENTICATION 105
5336 * RIL_REQUEST_ACKNOWLEDGE_INCOMING_GSM_SMS_WITH_PDU
5338 * Acknowledge successful or failed receipt of SMS previously indicated
5339 * via RIL_UNSOL_RESPONSE_NEW_SMS, including acknowledgement TPDU to send
5340 * as the RP-User-Data element of the RP-ACK or RP-ERROR PDU.
5342 * "data" is const char **
5343 * ((const char **)data)[0] is "1" on successful receipt (send RP-ACK)
5344 * is "0" on failed receipt (send RP-ERROR)
5345 * ((const char **)data)[1] is the acknowledgement TPDU in hexadecimal format
5347 * "response" is NULL
5351 * RADIO_NOT_AVAILABLE
5356 * REQUEST_NOT_SUPPORTED
5358 #define RIL_REQUEST_ACKNOWLEDGE_INCOMING_GSM_SMS_WITH_PDU 106
5361 * RIL_REQUEST_STK_SEND_ENVELOPE_WITH_STATUS
5363 * Requests to send a SAT/USAT envelope command to SIM.
5364 * The SAT/USAT envelope command refers to 3GPP TS 11.14 and 3GPP TS 31.111.
5366 * This request has one difference from RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND:
5367 * the SW1 and SW2 status bytes from the UICC response are returned along with
5368 * the response data, using the same structure as RIL_REQUEST_SIM_IO.
5370 * The RIL implementation shall perform the normal processing of a '91XX'
5371 * response in SW1/SW2 to retrieve the pending proactive command and send it
5372 * as an unsolicited response, as RIL_REQUEST_STK_SEND_ENVELOPE_COMMAND does.
5374 * "data" is a const char * containing the SAT/USAT command
5375 * in hexadecimal format starting with command tag
5377 * "response" is a const RIL_SIM_IO_Response *
5381 * RIL_E_RADIO_NOT_AVAILABLE (radio resetting)
5383 * OPERATION_NOT_ALLOWED
5388 * REQUEST_NOT_SUPPORTED
5391 #define RIL_REQUEST_STK_SEND_ENVELOPE_WITH_STATUS 107
5394 * RIL_REQUEST_VOICE_RADIO_TECH
5396 * Query the radio technology type (3GPP/3GPP2) used for voice. Query is valid only
5397 * when radio state is not RADIO_STATE_UNAVAILABLE
5400 * "response" is int *
5401 * ((int *) response)[0] is of type const RIL_RadioTechnology
5405 * RADIO_NOT_AVAILABLE
5410 * REQUEST_NOT_SUPPORTED
5412 #define RIL_REQUEST_VOICE_RADIO_TECH 108
5415 * RIL_REQUEST_GET_CELL_INFO_LIST
5417 * Request all of the current cell information known to the radio. The radio
5418 * must a list of all current cells, including the neighboring cells. If for a particular
5419 * cell information isn't known then the appropriate unknown value will be returned.
5420 * This does not cause or change the rate of RIL_UNSOL_CELL_INFO_LIST.
5424 * "response" is an array of RIL_CellInfo_v12.
5428 * RADIO_NOT_AVAILABLE
5434 * REQUEST_NOT_SUPPORTED
5439 #define RIL_REQUEST_GET_CELL_INFO_LIST 109
5442 * RIL_REQUEST_SET_UNSOL_CELL_INFO_LIST_RATE
5444 * Sets the minimum time between when RIL_UNSOL_CELL_INFO_LIST should be invoked.
5445 * A value of 0, means invoke RIL_UNSOL_CELL_INFO_LIST when any of the reported
5446 * information changes. Setting the value to INT_MAX(0x7fffffff) means never issue
5447 * a RIL_UNSOL_CELL_INFO_LIST.
5450 * ((int *)data)[0] is minimum time in milliseconds
5452 * "response" is NULL
5456 * RADIO_NOT_AVAILABLE
5461 * REQUEST_NOT_SUPPORTED
5465 #define RIL_REQUEST_SET_UNSOL_CELL_INFO_LIST_RATE 110
5468 * RIL_REQUEST_SET_INITIAL_ATTACH_APN
5470 * Set an apn to initial attach network
5472 * "data" is a const char **
5473 * ((const char **)data)[0] is the APN to connect if radio technology is LTE
5474 * ((const char **)data)[1] is the connection type to request must be one of the
5475 * PDP_type values in TS 27.007 section 10.1.1.
5476 * For example, "IP", "IPV6", "IPV4V6", or "PPP".
5477 * ((const char **)data)[2] is the PAP / CHAP auth type. Values:
5478 * 0 => PAP and CHAP is never performed.
5479 * 1 => PAP may be performed; CHAP is never performed.
5480 * 2 => CHAP may be performed; PAP is never performed.
5481 * 3 => PAP / CHAP may be performed - baseband dependent.
5482 * ((const char **)data)[3] is the username for APN, or NULL
5483 * ((const char **)data)[4] is the password for APN, or NULL
5485 * "response" is NULL
5489 * RADIO_NOT_AVAILABLE (radio resetting)
5490 * SUBSCRIPTION_NOT_AVAILABLE
5497 * REQUEST_NOT_SUPPORTED
5502 #define RIL_REQUEST_SET_INITIAL_ATTACH_APN 111
5505 * RIL_REQUEST_IMS_REGISTRATION_STATE
5507 * This message is DEPRECATED and shall be removed in a future release (target: 2018);
5508 * instead, provide IMS registration status via an IMS Service.
5510 * Request current IMS registration state
5514 * "response" is int *
5515 * ((int *)response)[0] is registration state:
5516 * 0 - Not registered
5519 * If ((int*)response)[0] is = 1, then ((int *) response)[1]
5520 * must follow with IMS SMS format:
5522 * ((int *) response)[1] is of type RIL_RadioTechnologyFamily
5526 * RADIO_NOT_AVAILABLE
5531 * INVALID_MODEM_STATE
5532 * REQUEST_NOT_SUPPORTED
5534 #define RIL_REQUEST_IMS_REGISTRATION_STATE 112
5537 * RIL_REQUEST_IMS_SEND_SMS
5539 * Send a SMS message over IMS
5541 * "data" is const RIL_IMS_SMS_Message *
5543 * "response" is a const RIL_SMS_Response *
5545 * Based on the return error, caller decides to resend if sending sms
5546 * fails. SMS_SEND_FAIL_RETRY means retry, and other errors means no retry.
5547 * In case of retry, data is encoded based on Voice Technology available.
5551 * RADIO_NOT_AVAILABLE
5552 * SMS_SEND_FAIL_RETRY
5558 * INVALID_SMS_FORMAT
5560 * REQUEST_RATE_LIMITED
5564 * INVALID_SMSC_ADDRESS
5565 * OPERATION_NOT_ALLOWED
5569 * REQUEST_NOT_SUPPORTED
5572 #define RIL_REQUEST_IMS_SEND_SMS 113
5575 * RIL_REQUEST_SIM_TRANSMIT_APDU_BASIC
5577 * Request APDU exchange on the basic channel. This command reflects TS 27.007
5578 * "generic SIM access" operation (+CSIM). The modem must ensure proper function
5579 * of GSM/CDMA, and filter commands appropriately. It should filter
5580 * channel management and SELECT by DF name commands.
5582 * "data" is a const RIL_SIM_APDU *
5583 * "sessionid" field should be ignored.
5585 * "response" is a const RIL_SIM_IO_Response *
5589 * RADIO_NOT_AVAILABLE
5594 * REQUEST_NOT_SUPPORTED
5596 #define RIL_REQUEST_SIM_TRANSMIT_APDU_BASIC 114
5599 * RIL_REQUEST_SIM_OPEN_CHANNEL
5601 * Open a new logical channel and select the given application. This command
5602 * reflects TS 27.007 "open logical channel" operation (+CCHO). This request
5603 * also specifies the P2 parameter (described in ISO 7816-4).
5605 * "data" is a const RIL_OpenChannelParam *
5607 * "response" is int *
5608 * ((int *)data)[0] contains the session id of the logical channel.
5609 * ((int *)data)[1] onwards may optionally contain the select response for the
5610 * open channel command with one byte per integer.
5614 * RADIO_NOT_AVAILABLE
5624 * REQUEST_NOT_SUPPORTED
5626 #define RIL_REQUEST_SIM_OPEN_CHANNEL 115
5629 * RIL_REQUEST_SIM_CLOSE_CHANNEL
5631 * Close a previously opened logical channel. This command reflects TS 27.007
5632 * "close logical channel" operation (+CCHC).
5635 * ((int *)data)[0] is the session id of logical the channel to close.
5637 * "response" is NULL
5641 * RADIO_NOT_AVAILABLE
5646 * REQUEST_NOT_SUPPORTED
5648 #define RIL_REQUEST_SIM_CLOSE_CHANNEL 116
5651 * RIL_REQUEST_SIM_TRANSMIT_APDU_CHANNEL
5653 * Exchange APDUs with a UICC over a previously opened logical channel. This
5654 * command reflects TS 27.007 "generic logical channel access" operation
5655 * (+CGLA). The modem should filter channel management and SELECT by DF name
5658 * "data" is a const RIL_SIM_APDU*
5660 * "response" is a const RIL_SIM_IO_Response *
5664 * RADIO_NOT_AVAILABLE
5669 * REQUEST_NOT_SUPPORTED
5671 #define RIL_REQUEST_SIM_TRANSMIT_APDU_CHANNEL 117
5674 * RIL_REQUEST_NV_READ_ITEM
5676 * Read one of the radio NV items defined in RadioNVItems.java / ril_nv_items.h.
5677 * This is used for device configuration by some CDMA operators.
5679 * "data" is a const RIL_NV_ReadItem *
5681 * "response" is const char * containing the contents of the NV item
5685 * RADIO_NOT_AVAILABLE
5686 * REQUEST_NOT_SUPPORTED
5688 #define RIL_REQUEST_NV_READ_ITEM 118
5691 * RIL_REQUEST_NV_WRITE_ITEM
5693 * Write one of the radio NV items defined in RadioNVItems.java / ril_nv_items.h.
5694 * This is used for device configuration by some CDMA operators.
5696 * "data" is a const RIL_NV_WriteItem *
5698 * "response" is NULL
5702 * RADIO_NOT_AVAILABLE
5703 * REQUEST_NOT_SUPPORTED
5705 #define RIL_REQUEST_NV_WRITE_ITEM 119
5708 * RIL_REQUEST_NV_WRITE_CDMA_PRL
5710 * Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
5711 * This is used for device configuration by some CDMA operators.
5713 * "data" is a const char * containing the PRL as a byte array
5715 * "response" is NULL
5719 * RADIO_NOT_AVAILABLE
5720 * REQUEST_NOT_SUPPORTED
5722 #define RIL_REQUEST_NV_WRITE_CDMA_PRL 120
5725 * RIL_REQUEST_NV_RESET_CONFIG
5727 * Reset the radio NV configuration to the factory state.
5728 * This is used for device configuration by some CDMA operators.
5731 * ((int *)data)[0] is 1 to reload all NV items
5732 * ((int *)data)[0] is 2 for erase NV reset (SCRTN)
5733 * ((int *)data)[0] is 3 for factory reset (RTN)
5735 * "response" is NULL
5739 * RADIO_NOT_AVAILABLE
5740 * REQUEST_NOT_SUPPORTED
5742 #define RIL_REQUEST_NV_RESET_CONFIG 121
5744 /** RIL_REQUEST_SET_UICC_SUBSCRIPTION
5745 * FIXME This API needs to have more documentation.
5747 * Selection/de-selection of a subscription from a SIM card
5748 * "data" is const RIL_SelectUiccSub*
5751 * "response" is NULL
5755 * RADIO_NOT_AVAILABLE (radio resetting)
5756 * SUBSCRIPTION_NOT_SUPPORTED
5762 * REQUEST_NOT_SUPPORTED
5767 #define RIL_REQUEST_SET_UICC_SUBSCRIPTION 122
5770 * RIL_REQUEST_ALLOW_DATA
5772 * Tells the modem whether data calls are allowed or not
5775 * FIXME slotId and aid will be added.
5776 * ((int *)data)[0] is == 0 to allow data calls
5777 * ((int *)data)[0] is == 1 to disallow data calls
5779 * "response" is NULL
5784 * RADIO_NOT_AVAILABLE (radio resetting)
5791 * INVALID_MODEM_STATE
5792 * REQUEST_NOT_SUPPORTED
5797 #define RIL_REQUEST_ALLOW_DATA 123
5800 * RIL_REQUEST_GET_HARDWARE_CONFIG
5802 * Request all of the current hardware (modem and sim) associated
5807 * "response" is an array of RIL_HardwareConfig.
5810 * RADIO_NOT_AVAILABLE
5811 * REQUEST_NOT_SUPPORTED
5813 #define RIL_REQUEST_GET_HARDWARE_CONFIG 124
5816 * RIL_REQUEST_SIM_AUTHENTICATION
5818 * Returns the response of SIM Authentication through RIL to a
5819 * challenge request.
5821 * "data" Base64 encoded string containing challenge:
5822 * int authContext; P2 value of authentication command, see P2 parameter in
5823 * 3GPP TS 31.102 7.1.2
5824 * char *authData; the challenge string in Base64 format, see 3GPP
5826 * char *aid; AID value, See ETSI 102.221 8.1 and 101.220 4,
5829 * "response" Base64 encoded strings containing response:
5830 * int sw1; Status bytes per 3GPP TS 31.102 section 7.3
5832 * char *simResponse; Response in Base64 format, see 3GPP TS 31.102 7.1.2
5835 * RADIO_NOT_AVAILABLE
5840 * INVALID_MODEM_STATE
5843 * REQUEST_NOT_SUPPORTED
5845 #define RIL_REQUEST_SIM_AUTHENTICATION 125
5848 * RIL_REQUEST_GET_DC_RT_INFO
5850 * The request is DEPRECATED, use RIL_REQUEST_GET_ACTIVITY_INFO
5851 * Requests the Data Connection Real Time Info
5855 * "response" is the most recent RIL_DcRtInfo
5859 * RADIO_NOT_AVAILABLE
5860 * REQUEST_NOT_SUPPORTED
5866 * See also: RIL_UNSOL_DC_RT_INFO_CHANGED
5868 #define RIL_REQUEST_GET_DC_RT_INFO 126
5871 * RIL_REQUEST_SET_DC_RT_INFO_RATE
5873 * The request is DEPRECATED
5874 * This is the minimum number of milliseconds between successive
5875 * RIL_UNSOL_DC_RT_INFO_CHANGED messages and defines the highest rate
5876 * at which RIL_UNSOL_DC_RT_INFO_CHANGED's will be sent. A value of
5877 * 0 means send as fast as possible.
5879 * "data" The number of milliseconds as an int
5881 * "response" is null
5884 * SUCCESS must not fail
5886 #define RIL_REQUEST_SET_DC_RT_INFO_RATE 127
5889 * RIL_REQUEST_SET_DATA_PROFILE
5891 * Set data profile in modem
5892 * Modem should erase existed profiles from framework, and apply new profiles
5893 * "data" is a const RIL_DataProfileInfo **
5894 * "datalen" is count * sizeof(const RIL_DataProfileInfo *)
5895 * "response" is NULL
5899 * RADIO_NOT_AVAILABLE (radio resetting)
5900 * SUBSCRIPTION_NOT_AVAILABLE
5905 * REQUEST_NOT_SUPPORTED
5908 #define RIL_REQUEST_SET_DATA_PROFILE 128
5911 * RIL_REQUEST_SHUTDOWN
5913 * Device is shutting down. All further commands are ignored
5914 * and RADIO_NOT_AVAILABLE must be returned.
5917 * "response" is NULL
5921 * RADIO_NOT_AVAILABLE
5922 * OPERATION_NOT_ALLOWED
5926 * REQUEST_NOT_SUPPORTED
5930 #define RIL_REQUEST_SHUTDOWN 129
5933 * RIL_REQUEST_GET_RADIO_CAPABILITY
5935 * Used to get phone radio capablility.
5937 * "data" is the RIL_RadioCapability structure
5941 * RADIO_NOT_AVAILABLE
5942 * OPERATION_NOT_ALLOWED
5944 * REQUEST_NOT_SUPPORTED
5950 #define RIL_REQUEST_GET_RADIO_CAPABILITY 130
5953 * RIL_REQUEST_SET_RADIO_CAPABILITY
5955 * Used to set the phones radio capability. Be VERY careful
5956 * using this request as it may cause some vendor modems to reset. Because
5957 * of the possible modem reset any RIL commands after this one may not be
5960 * "data" is the RIL_RadioCapability structure
5962 * "response" is the RIL_RadioCapability structure, used to feedback return status
5965 * SUCCESS means a RIL_UNSOL_RADIO_CAPABILITY will be sent within 30 seconds.
5966 * RADIO_NOT_AVAILABLE
5967 * OPERATION_NOT_ALLOWED
5974 * REQUEST_NOT_SUPPORTED
5978 #define RIL_REQUEST_SET_RADIO_CAPABILITY 131
5981 * RIL_REQUEST_START_LCE
5983 * Start Link Capacity Estimate (LCE) service if supported by the radio.
5985 * "data" is const int *
5986 * ((const int*)data)[0] specifies the desired reporting interval (ms).
5987 * ((const int*)data)[1] specifies the LCE service mode. 1: PULL; 0: PUSH.
5989 * "response" is the RIL_LceStatusInfo.
5993 * RADIO_NOT_AVAILABLE
5996 * REQUEST_NOT_SUPPORTED
6002 #define RIL_REQUEST_START_LCE 132
6005 * RIL_REQUEST_STOP_LCE
6007 * Stop Link Capacity Estimate (LCE) service, the STOP operation should be
6008 * idempotent for the radio modem.
6010 * "response" is the RIL_LceStatusInfo.
6014 * RADIO_NOT_AVAILABLE
6020 * REQUEST_NOT_SUPPORTED
6023 #define RIL_REQUEST_STOP_LCE 133
6026 * RIL_REQUEST_PULL_LCEDATA
6028 * Pull LCE service for capacity information.
6030 * "response" is the RIL_LceDataInfo.
6034 * RADIO_NOT_AVAILABLE
6040 * REQUEST_NOT_SUPPORTED
6043 #define RIL_REQUEST_PULL_LCEDATA 134
6046 * RIL_REQUEST_GET_ACTIVITY_INFO
6048 * Get modem activity information for power consumption estimation.
6050 * Request clear-on-read statistics information that is used for
6051 * estimating the per-millisecond power consumption of the cellular
6055 * "response" is const RIL_ActivityStatsInfo *
6060 * RADIO_NOT_AVAILABLE (radio resetting)
6066 * REQUEST_NOT_SUPPORTED
6067 * NO_RESOURCES CANCELLED
6069 #define RIL_REQUEST_GET_ACTIVITY_INFO 135
6072 * RIL_REQUEST_SET_CARRIER_RESTRICTIONS
6074 * Set carrier restrictions for this sim slot. Expected modem behavior:
6075 * If never receives this command
6076 * - Must allow all carriers
6077 * Receives this command with data being NULL
6078 * - Must allow all carriers. If a previously allowed SIM is present, modem must not reload
6079 * the SIM. If a previously disallowed SIM is present, reload the SIM and notify Android.
6080 * Receives this command with a list of carriers
6081 * - Only allow specified carriers, persist across power cycles and FDR. If a present SIM
6082 * is in the allowed list, modem must not reload the SIM. If a present SIM is *not* in
6083 * the allowed list, modem must detach from the registered network and only keep emergency
6084 * service, and notify Android SIM refresh reset with new SIM state being
6085 * RIL_CARDSTATE_RESTRICTED. Emergency service must be enabled.
6087 * "data" is const RIL_CarrierRestrictions *
6088 * A list of allowed carriers and possibly a list of excluded carriers.
6089 * If data is NULL, means to clear previous carrier restrictions and allow all carriers
6091 * "response" is int *
6092 * ((int *)data)[0] contains the number of allowed carriers which have been set correctly.
6093 * On success, it should match the length of list data->allowed_carriers.
6094 * If data is NULL, the value must be 0.
6098 * RIL_E_INVALID_ARGUMENTS
6099 * RIL_E_RADIO_NOT_AVAILABLE
6100 * RIL_E_REQUEST_NOT_SUPPORTED
6106 #define RIL_REQUEST_SET_CARRIER_RESTRICTIONS 136
6109 * RIL_REQUEST_GET_CARRIER_RESTRICTIONS
6111 * Get carrier restrictions for this sim slot. Expected modem behavior:
6112 * Return list of allowed carriers, or null if all carriers are allowed.
6116 * "response" is const RIL_CarrierRestrictions *.
6117 * If response is NULL, it means all carriers are allowed.
6121 * RIL_E_RADIO_NOT_AVAILABLE
6122 * RIL_E_REQUEST_NOT_SUPPORTED
6128 #define RIL_REQUEST_GET_CARRIER_RESTRICTIONS 137
6131 * RIL_REQUEST_SEND_DEVICE_STATE
6133 * Send the updated device state.
6134 * Modem can perform power saving based on the provided device state.
6135 * "data" is const int *
6136 * ((const int*)data)[0] A RIL_DeviceStateType that specifies the device state type.
6137 * ((const int*)data)[1] Specifies the state. See RIL_DeviceStateType for the definition of each
6140 * "datalen" is count * sizeof(const RIL_DeviceState *)
6141 * "response" is NULL
6145 * RADIO_NOT_AVAILABLE (radio resetting)
6150 * REQUEST_NOT_SUPPORTED
6154 #define RIL_REQUEST_SEND_DEVICE_STATE 138
6157 * RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER
6159 * Set the unsolicited response filter
6160 * This is used to prevent unnecessary application processor
6161 * wake up for power saving purposes by suppressing the
6162 * unsolicited responses in certain scenarios.
6164 * "data" is an int *
6166 * ((int *)data)[0] is a 32-bit bitmask of RIL_UnsolicitedResponseFilter
6168 * "response" is NULL
6172 * INVALID_ARGUMENTS (e.g. the requested filter doesn't exist)
6173 * RADIO_NOT_AVAILABLE (radio resetting)
6177 * REQUEST_NOT_SUPPORTED
6181 #define RIL_REQUEST_SET_UNSOLICITED_RESPONSE_FILTER 139
6184 * RIL_REQUEST_SET_SIM_CARD_POWER
6186 * Set SIM card power up or down
6188 * Request is equivalent to inserting and removing the card, with
6189 * an additional effect where the ability to detect card removal/insertion
6190 * is disabled when the SIM card is powered down.
6192 * This will generate RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED
6193 * as if the SIM had been inserted or removed.
6196 * ((int *)data)[0] is 1 for "SIM POWER UP"
6197 * ((int *)data)[0] is 0 for "SIM POWER DOWN"
6199 * "response" is NULL
6203 * RADIO_NOT_AVAILABLE
6204 * REQUEST_NOT_SUPPORTED
6212 #define RIL_REQUEST_SET_SIM_CARD_POWER 140
6215 * RIL_REQUEST_SET_CARRIER_INFO_IMSI_ENCRYPTION
6217 * Provide Carrier specific information to the modem that will be used to
6218 * encrypt the IMSI and IMPI. Sent by the framework during boot, carrier
6219 * switch and everytime we receive a new certificate.
6221 * "data" is the RIL_CarrierInfoForImsiEncryption * structure.
6223 * "response" is NULL
6227 * RIL_E_RADIO_NOT_AVAILABLE
6229 * RIL_E_REQUEST_NOT_SUPPORTED
6231 * MODEM_INTERNAL_FAILURE
6237 #define RIL_REQUEST_SET_CARRIER_INFO_IMSI_ENCRYPTION 141
6240 * RIL_REQUEST_START_NETWORK_SCAN
6242 * Starts a new network scan
6244 * Request to start a network scan with specified radio access networks with frequency bands and/or
6247 * "data" is a const RIL_NetworkScanRequest *.
6248 * "response" is NULL
6252 * RADIO_NOT_AVAILABLE
6253 * OPERATION_NOT_ALLOWED
6259 * REQUEST_NOT_SUPPORTED
6264 #define RIL_REQUEST_START_NETWORK_SCAN 142
6267 * RIL_REQUEST_STOP_NETWORK_SCAN
6269 * Stops an ongoing network scan
6271 * Request to stop the ongoing network scan. Since the modem can only perform one scan at a time,
6272 * there is no parameter for this request.
6275 * "response" is NULL
6284 * REQUEST_NOT_SUPPORTED
6287 #define RIL_REQUEST_STOP_NETWORK_SCAN 143
6290 * RIL_REQUEST_START_KEEPALIVE
6292 * Start a keepalive session
6294 * Request that the modem begin sending keepalive packets on a particular
6295 * data call, with a specified source, destination, and format.
6297 * "data" is a const RIL_RequestKeepalive
6298 * "response" is RIL_KeepaliveStatus with a valid "handle"
6306 #define RIL_REQUEST_START_KEEPALIVE 144
6309 * RIL_REQUEST_STOP_KEEPALIVE
6311 * Stops an ongoing keepalive session
6313 * Requests that a keepalive session with the given handle be stopped.
6314 * there is no parameter for this request.
6316 * "data" is an integer handle
6317 * "response" is NULL
6324 #define RIL_REQUEST_STOP_KEEPALIVE 145
6326 /***********************************************************************/
6329 * RIL_RESPONSE_ACKNOWLEDGEMENT
6331 * This is used by Asynchronous solicited messages and Unsolicited messages
6332 * to acknowledge the receipt of those messages in RIL.java so that the ack
6333 * can be used to let ril.cpp to release wakelock.
6337 * RADIO_NOT_AVAILABLE
6340 #define RIL_RESPONSE_ACKNOWLEDGEMENT 800
6342 /***********************************************************************/
6345 #define RIL_UNSOL_RESPONSE_BASE 1000
6348 * RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED
6350 * Indicate when value of RIL_RadioState has changed.
6352 * Callee will invoke RIL_RadioStateRequest method on main thread
6357 #define RIL_UNSOL_RESPONSE_RADIO_STATE_CHANGED 1000
6361 * RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED
6363 * Indicate when call state has changed
6365 * Callee will invoke RIL_REQUEST_GET_CURRENT_CALLS on main thread
6369 * Response should be invoked on, for example,
6370 * "RING", "BUSY", "NO CARRIER", and also call state
6371 * transitions (DIALING->ALERTING ALERTING->ACTIVE)
6373 * Redundent or extraneous invocations are tolerated
6375 #define RIL_UNSOL_RESPONSE_CALL_STATE_CHANGED 1001
6379 * RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED
6381 * Called when the voice network state changed
6383 * Callee will invoke the following requests on main thread:
6385 * RIL_REQUEST_VOICE_REGISTRATION_STATE
6386 * RIL_REQUEST_OPERATOR
6390 * FIXME should this happen when SIM records are loaded? (eg, for
6393 #define RIL_UNSOL_RESPONSE_VOICE_NETWORK_STATE_CHANGED 1002
6396 * RIL_UNSOL_RESPONSE_NEW_SMS
6398 * Called when new SMS is received.
6400 * "data" is const char *
6401 * This is a pointer to a string containing the PDU of an SMS-DELIVER
6402 * as an ascii string of hex digits. The PDU starts with the SMSC address
6403 * per TS 27.005 (+CMT:)
6405 * Callee will subsequently confirm the receipt of thei SMS with a
6406 * RIL_REQUEST_SMS_ACKNOWLEDGE
6408 * No new RIL_UNSOL_RESPONSE_NEW_SMS
6409 * or RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT messages should be sent until a
6410 * RIL_REQUEST_SMS_ACKNOWLEDGE has been received
6413 #define RIL_UNSOL_RESPONSE_NEW_SMS 1003
6416 * RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT
6418 * Called when new SMS Status Report is received.
6420 * "data" is const char *
6421 * This is a pointer to a string containing the PDU of an SMS-STATUS-REPORT
6422 * as an ascii string of hex digits. The PDU starts with the SMSC address
6423 * per TS 27.005 (+CDS:).
6425 * Callee will subsequently confirm the receipt of the SMS with a
6426 * RIL_REQUEST_SMS_ACKNOWLEDGE
6428 * No new RIL_UNSOL_RESPONSE_NEW_SMS
6429 * or RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT messages should be sent until a
6430 * RIL_REQUEST_SMS_ACKNOWLEDGE has been received
6433 #define RIL_UNSOL_RESPONSE_NEW_SMS_STATUS_REPORT 1004
6436 * RIL_UNSOL_RESPONSE_NEW_SMS_ON_SIM
6438 * Called when new SMS has been stored on SIM card
6440 * "data" is const int *
6441 * ((const int *)data)[0] contains the slot index on the SIM that contains
6445 #define RIL_UNSOL_RESPONSE_NEW_SMS_ON_SIM 1005
6450 * Called when a new USSD message is received.
6452 * "data" is const char **
6453 * ((const char **)data)[0] points to a type code, which is
6454 * one of these string values:
6455 * "0" USSD-Notify -- text in ((const char **)data)[1]
6456 * "1" USSD-Request -- text in ((const char **)data)[1]
6457 * "2" Session terminated by network
6458 * "3" other local client (eg, SIM Toolkit) has responded
6459 * "4" Operation not supported
6460 * "5" Network timeout
6462 * The USSD session is assumed to persist if the type code is "1", otherwise
6463 * the current session (if any) is assumed to have terminated.
6465 * ((const char **)data)[1] points to a message string if applicable, which
6466 * should always be in UTF-8.
6468 #define RIL_UNSOL_ON_USSD 1006
6469 /* Previously #define RIL_UNSOL_ON_USSD_NOTIFY 1006 */
6472 * RIL_UNSOL_ON_USSD_REQUEST
6474 * Obsolete. Send via RIL_UNSOL_ON_USSD
6476 #define RIL_UNSOL_ON_USSD_REQUEST 1007
6479 * RIL_UNSOL_NITZ_TIME_RECEIVED
6481 * Called when radio has received a NITZ time message
6483 * "data" is const char * pointing to NITZ time string
6484 * in the form "yy/mm/dd,hh:mm:ss(+/-)tz,dt"
6486 #define RIL_UNSOL_NITZ_TIME_RECEIVED 1008
6489 * RIL_UNSOL_SIGNAL_STRENGTH
6491 * Radio may report signal strength rather han have it polled.
6493 * "data" is a const RIL_SignalStrength *
6495 #define RIL_UNSOL_SIGNAL_STRENGTH 1009
6499 * RIL_UNSOL_DATA_CALL_LIST_CHANGED
6501 * "data" is an array of RIL_Data_Call_Response_v6 identical to that
6502 * returned by RIL_REQUEST_DATA_CALL_LIST. It is the complete list
6503 * of current data contexts including new contexts that have been
6504 * activated. A data call is only removed from this list when the
6505 * framework sends a RIL_REQUEST_DEACTIVATE_DATA_CALL or the radio
6506 * is powered off/on.
6508 * See also: RIL_REQUEST_DATA_CALL_LIST
6511 #define RIL_UNSOL_DATA_CALL_LIST_CHANGED 1010
6514 * RIL_UNSOL_SUPP_SVC_NOTIFICATION
6516 * Reports supplementary service related notification from the network.
6518 * "data" is a const RIL_SuppSvcNotification *
6522 #define RIL_UNSOL_SUPP_SVC_NOTIFICATION 1011
6525 * RIL_UNSOL_STK_SESSION_END
6527 * Indicate when STK session is terminated by SIM.
6531 #define RIL_UNSOL_STK_SESSION_END 1012
6534 * RIL_UNSOL_STK_PROACTIVE_COMMAND
6536 * Indicate when SIM issue a STK proactive command to applications
6538 * "data" is a const char * containing SAT/USAT proactive command
6539 * in hexadecimal format string starting with command tag
6542 #define RIL_UNSOL_STK_PROACTIVE_COMMAND 1013
6545 * RIL_UNSOL_STK_EVENT_NOTIFY
6547 * Indicate when SIM notifies applcations some event happens.
6548 * Generally, application does not need to have any feedback to
6549 * SIM but shall be able to indicate appropriate messages to users.
6551 * "data" is a const char * containing SAT/USAT commands or responses
6552 * sent by ME to SIM or commands handled by ME, in hexadecimal format string
6553 * starting with first byte of response data or command tag
6556 #define RIL_UNSOL_STK_EVENT_NOTIFY 1014
6559 * RIL_UNSOL_STK_CALL_SETUP
6561 * Indicate when SIM wants application to setup a voice call.
6563 * "data" is const int *
6564 * ((const int *)data)[0] contains timeout value (in milliseconds)
6566 #define RIL_UNSOL_STK_CALL_SETUP 1015
6569 * RIL_UNSOL_SIM_SMS_STORAGE_FULL
6571 * Indicates that SMS storage on the SIM is full. Sent when the network
6572 * attempts to deliver a new SMS message. Messages cannot be saved on the
6573 * SIM until space is freed. In particular, incoming Class 2 messages
6579 #define RIL_UNSOL_SIM_SMS_STORAGE_FULL 1016
6582 * RIL_UNSOL_SIM_REFRESH
6584 * Indicates that file(s) on the SIM have been updated, or the SIM
6585 * has been reinitialized.
6587 * In the case where RIL is version 6 or older:
6588 * "data" is an int *
6589 * ((int *)data)[0] is a RIL_SimRefreshResult.
6590 * ((int *)data)[1] is the EFID of the updated file if the result is
6591 * SIM_FILE_UPDATE or NULL for any other result.
6593 * In the case where RIL is version 7:
6594 * "data" is a RIL_SimRefreshResponse_v7 *
6596 * Note: If the SIM state changes as a result of the SIM refresh (eg,
6597 * SIM_READY -> SIM_LOCKED_OR_ABSENT), RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED
6600 #define RIL_UNSOL_SIM_REFRESH 1017
6603 * RIL_UNSOL_CALL_RING
6605 * Ring indication for an incoming call (eg, RING or CRING event).
6606 * There must be at least one RIL_UNSOL_CALL_RING at the beginning
6607 * of a call and sending multiple is optional. If the system property
6608 * ro.telephony.call_ring.multiple is false then the upper layers
6609 * will generate the multiple events internally. Otherwise the vendor
6610 * ril must generate multiple RIL_UNSOL_CALL_RING if
6611 * ro.telephony.call_ring.multiple is true or if it is absent.
6613 * The rate of these events is controlled by ro.telephony.call_ring.delay
6614 * and has a default value of 3000 (3 seconds) if absent.
6616 * "data" is null for GSM
6617 * "data" is const RIL_CDMA_SignalInfoRecord * if CDMA
6619 #define RIL_UNSOL_CALL_RING 1018
6622 * RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED
6624 * Indicates that SIM state changes.
6626 * Callee will invoke RIL_REQUEST_GET_SIM_STATUS on main thread
6630 #define RIL_UNSOL_RESPONSE_SIM_STATUS_CHANGED 1019
6633 * RIL_UNSOL_RESPONSE_CDMA_NEW_SMS
6635 * Called when new CDMA SMS is received
6637 * "data" is const RIL_CDMA_SMS_Message *
6639 * Callee will subsequently confirm the receipt of the SMS with
6640 * a RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE
6642 * No new RIL_UNSOL_RESPONSE_CDMA_NEW_SMS should be sent until
6643 * RIL_REQUEST_CDMA_SMS_ACKNOWLEDGE has been received
6646 #define RIL_UNSOL_RESPONSE_CDMA_NEW_SMS 1020
6649 * RIL_UNSOL_RESPONSE_NEW_BROADCAST_SMS
6651 * Called when new Broadcast SMS is received
6653 * "data" can be one of the following:
6654 * If received from GSM network, "data" is const char of 88 bytes
6655 * which indicates each page of a CBS Message sent to the MS by the
6656 * BTS as coded in 3GPP 23.041 Section 9.4.1.2.
6657 * If received from UMTS network, "data" is const char of 90 up to 1252
6658 * bytes which contain between 1 and 15 CBS Message pages sent as one
6659 * packet to the MS by the BTS as coded in 3GPP 23.041 Section 9.4.2.2.
6662 #define RIL_UNSOL_RESPONSE_NEW_BROADCAST_SMS 1021
6665 * RIL_UNSOL_CDMA_RUIM_SMS_STORAGE_FULL
6667 * Indicates that SMS storage on the RUIM is full. Messages
6668 * cannot be saved on the RUIM until space is freed.
6673 #define RIL_UNSOL_CDMA_RUIM_SMS_STORAGE_FULL 1022
6676 * RIL_UNSOL_RESTRICTED_STATE_CHANGED
6678 * Indicates a restricted state change (eg, for Domain Specific Access Control).
6680 * Radio need send this msg after radio off/on cycle no matter it is changed or not.
6682 * "data" is an int *
6683 * ((int *)data)[0] contains a bitmask of RIL_RESTRICTED_STATE_* values.
6685 #define RIL_UNSOL_RESTRICTED_STATE_CHANGED 1023
6688 * RIL_UNSOL_ENTER_EMERGENCY_CALLBACK_MODE
6690 * Indicates that the radio system selection module has
6691 * autonomously entered emergency callback mode.
6696 #define RIL_UNSOL_ENTER_EMERGENCY_CALLBACK_MODE 1024
6699 * RIL_UNSOL_CDMA_CALL_WAITING
6701 * Called when CDMA radio receives a call waiting indication.
6703 * "data" is const RIL_CDMA_CallWaiting *
6706 #define RIL_UNSOL_CDMA_CALL_WAITING 1025
6709 * RIL_UNSOL_CDMA_OTA_PROVISION_STATUS
6711 * Called when CDMA radio receives an update of the progress of an
6714 * "data" is const int *
6715 * For CDMA this is an integer OTASP/OTAPA status listed in
6716 * RIL_CDMA_OTA_ProvisionStatus.
6719 #define RIL_UNSOL_CDMA_OTA_PROVISION_STATUS 1026
6722 * RIL_UNSOL_CDMA_INFO_REC
6724 * Called when CDMA radio receives one or more info recs.
6726 * "data" is const RIL_CDMA_InformationRecords *
6729 #define RIL_UNSOL_CDMA_INFO_REC 1027
6732 * RIL_UNSOL_OEM_HOOK_RAW
6734 * This is for OEM specific use.
6736 * "data" is a byte[]
6738 #define RIL_UNSOL_OEM_HOOK_RAW 1028
6741 * RIL_UNSOL_RINGBACK_TONE
6743 * Indicates that nework doesn't have in-band information, need to
6744 * play out-band tone.
6746 * "data" is an int *
6747 * ((int *)data)[0] == 0 for stop play ringback tone.
6748 * ((int *)data)[0] == 1 for start play ringback tone.
6750 #define RIL_UNSOL_RINGBACK_TONE 1029
6753 * RIL_UNSOL_RESEND_INCALL_MUTE
6755 * Indicates that framework/application need reset the uplink mute state.
6757 * There may be situations where the mute state becomes out of sync
6758 * between the application and device in some GSM infrastructures.
6762 #define RIL_UNSOL_RESEND_INCALL_MUTE 1030
6765 * RIL_UNSOL_CDMA_SUBSCRIPTION_SOURCE_CHANGED
6767 * Called when CDMA subscription source changed.
6770 * ((int *)data)[0] is == RIL_CdmaSubscriptionSource
6772 #define RIL_UNSOL_CDMA_SUBSCRIPTION_SOURCE_CHANGED 1031
6775 * RIL_UNSOL_CDMA_PRL_CHANGED
6777 * Called when PRL (preferred roaming list) changes.
6780 * ((int *)data)[0] is PRL_VERSION as would be returned by RIL_REQUEST_CDMA_SUBSCRIPTION
6782 #define RIL_UNSOL_CDMA_PRL_CHANGED 1032
6785 * RIL_UNSOL_EXIT_EMERGENCY_CALLBACK_MODE
6787 * Called when Emergency Callback Mode Ends
6789 * Indicates that the radio system selection module has
6790 * proactively exited emergency callback mode.
6795 #define RIL_UNSOL_EXIT_EMERGENCY_CALLBACK_MODE 1033
6798 * RIL_UNSOL_RIL_CONNECTED
6800 * Called the ril connects and returns the version
6803 * ((int *)data)[0] is RIL_VERSION
6805 #define RIL_UNSOL_RIL_CONNECTED 1034
6808 * RIL_UNSOL_VOICE_RADIO_TECH_CHANGED
6810 * Indicates that voice technology has changed. Contains new radio technology
6811 * as a data in the message.
6814 * ((int *)data)[0] is of type const RIL_RadioTechnology
6817 #define RIL_UNSOL_VOICE_RADIO_TECH_CHANGED 1035
6820 * RIL_UNSOL_CELL_INFO_LIST
6822 * Same information as returned by RIL_REQUEST_GET_CELL_INFO_LIST, but returned
6823 * at the rate no greater than specified by RIL_REQUEST_SET_UNSOL_CELL_INFO_RATE.
6827 * "response" is an array of RIL_CellInfo_v12.
6829 #define RIL_UNSOL_CELL_INFO_LIST 1036
6832 * RIL_UNSOL_RESPONSE_IMS_NETWORK_STATE_CHANGED
6834 * This message is DEPRECATED and shall be removed in a future release (target: 2018);
6835 * instead, provide IMS registration status via an IMS Service.
6837 * Called when IMS registration state has changed
6839 * To get IMS registration state and IMS SMS format, callee needs to invoke the
6840 * following request on main thread:
6842 * RIL_REQUEST_IMS_REGISTRATION_STATE
6847 #define RIL_UNSOL_RESPONSE_IMS_NETWORK_STATE_CHANGED 1037
6850 * RIL_UNSOL_UICC_SUBSCRIPTION_STATUS_CHANGED
6852 * Indicated when there is a change in subscription status.
6853 * This event will be sent in the following scenarios
6854 * - subscription readiness at modem, which was selected by telephony layer
6855 * - when subscription is deactivated by modem due to UICC card removal
6856 * - When network invalidates the subscription i.e. attach reject due to authentication reject
6858 * "data" is const int *
6859 * ((const int *)data)[0] == 0 for Subscription Deactivated
6860 * ((const int *)data)[0] == 1 for Subscription Activated
6863 #define RIL_UNSOL_UICC_SUBSCRIPTION_STATUS_CHANGED 1038
6866 * RIL_UNSOL_SRVCC_STATE_NOTIFY
6868 * Called when Single Radio Voice Call Continuity(SRVCC)
6869 * progress state has changed
6872 * ((int *)data)[0] is of type const RIL_SrvccState
6876 #define RIL_UNSOL_SRVCC_STATE_NOTIFY 1039
6879 * RIL_UNSOL_HARDWARE_CONFIG_CHANGED
6881 * Called when the hardware configuration associated with the RILd changes
6883 * "data" is an array of RIL_HardwareConfig
6886 #define RIL_UNSOL_HARDWARE_CONFIG_CHANGED 1040
6889 * RIL_UNSOL_DC_RT_INFO_CHANGED
6891 * The message is DEPRECATED, use RIL_REQUEST_GET_ACTIVITY_INFO
6892 * Sent when the DC_RT_STATE changes but the time
6893 * between these messages must not be less than the
6894 * value set by RIL_REQUEST_SET_DC_RT_RATE.
6896 * "data" is the most recent RIL_DcRtInfo
6899 #define RIL_UNSOL_DC_RT_INFO_CHANGED 1041
6902 * RIL_UNSOL_RADIO_CAPABILITY
6904 * Sent when RIL_REQUEST_SET_RADIO_CAPABILITY completes.
6905 * Returns the phone radio capability exactly as
6906 * RIL_REQUEST_GET_RADIO_CAPABILITY and should be the
6907 * same set as sent by RIL_REQUEST_SET_RADIO_CAPABILITY.
6909 * "data" is the RIL_RadioCapability structure
6911 #define RIL_UNSOL_RADIO_CAPABILITY 1042
6916 * Called when SS response is received when DIAL/USSD/SS is changed to SS by
6919 * "data" is const RIL_StkCcUnsolSsResponse *
6922 #define RIL_UNSOL_ON_SS 1043
6925 * RIL_UNSOL_STK_CC_ALPHA_NOTIFY
6927 * Called when there is an ALPHA from UICC during Call Control.
6929 * "data" is const char * containing ALPHA string from UICC in UTF-8 format.
6932 #define RIL_UNSOL_STK_CC_ALPHA_NOTIFY 1044
6935 * RIL_UNSOL_LCEDATA_RECV
6937 * Called when there is an incoming Link Capacity Estimate (LCE) info report.
6939 * "data" is the RIL_LceDataInfo structure.
6942 #define RIL_UNSOL_LCEDATA_RECV 1045
6945 * RIL_UNSOL_PCO_DATA
6947 * Called when there is new Carrier PCO data received for a data call. Ideally
6948 * only new data will be forwarded, though this is not required. Multiple
6949 * boxes of carrier PCO data for a given call should result in a series of
6950 * RIL_UNSOL_PCO_DATA calls.
6952 * "data" is the RIL_PCO_Data structure.
6955 #define RIL_UNSOL_PCO_DATA 1046
6958 * RIL_UNSOL_MODEM_RESTART
6960 * Called when there is a modem reset.
6962 * "reason" is "const char *" containing the reason for the reset. It
6963 * could be a crash signature if the restart was due to a crash or some
6964 * string such as "user-initiated restart" or "AT command initiated
6965 * restart" that explains the cause of the modem restart.
6967 * When modem restarts, one of the following radio state transitions will happen
6968 * 1) RADIO_STATE_ON->RADIO_STATE_UNAVAILABLE->RADIO_STATE_ON or
6969 * 2) RADIO_STATE_OFF->RADIO_STATE_UNAVAILABLE->RADIO_STATE_OFF
6970 * This message can be sent either just before the RADIO_STATE changes to RADIO_STATE_UNAVAILABLE
6971 * or just after but should never be sent after the RADIO_STATE changes from UNAVAILABLE to
6972 * AVAILABLE(RADIO_STATE_ON/RADIO_STATE_OFF) again.
6974 * It should NOT be sent after the RADIO_STATE changes to AVAILABLE after the
6975 * modem restart as that could be interpreted as a second modem reset by the
6978 #define RIL_UNSOL_MODEM_RESTART 1047
6981 * RIL_UNSOL_CARRIER_INFO_IMSI_ENCRYPTION
6983 * Called when the modem needs Carrier specific information that will
6984 * be used to encrypt IMSI and IMPI.
6989 #define RIL_UNSOL_CARRIER_INFO_IMSI_ENCRYPTION 1048
6992 * RIL_UNSOL_NETWORK_SCAN_RESULT
6994 * Returns incremental result for the network scan which is started by
6995 * RIL_REQUEST_START_NETWORK_SCAN, sent to report results, status, or errors.
6998 * "response" is a const RIL_NetworkScanResult *
7000 #define RIL_UNSOL_NETWORK_SCAN_RESULT 1049
7003 * RIL_UNSOL_KEEPALIVE_STATUS
7006 * "response" is a const RIL_KeepaliveStatus *
7008 #define RIL_UNSOL_KEEPALIVE_STATUS 1050
7010 /***********************************************************************/
7013 #if defined(ANDROID_MULTI_SIM)
7015 * RIL_Request Function pointer
7017 * @param request is one of RIL_REQUEST_*
7018 * @param data is pointer to data defined for that RIL_REQUEST_*
7019 * data is owned by caller, and should not be modified or freed by callee
7020 * structures passed as data may contain pointers to non-contiguous memory
7021 * @param t should be used in subsequent call to RIL_onResponse
7022 * @param datalen is the length of "data" which is defined as other argument. It may or may
7023 * not be equal to sizeof(data). Refer to the documentation of individual structures
7024 * to find if pointers listed in the structure are contiguous and counted in the datalen
7026 * (Eg: RIL_IMS_SMS_Message where we don't have datalen equal to sizeof(data))
7029 typedef void (*RIL_RequestFunc) (int request, void *data,
7030 size_t datalen, RIL_Token t, RIL_SOCKET_ID socket_id);
7033 * This function should return the current radio state synchronously
7035 typedef RIL_RadioState (*RIL_RadioStateRequest)(RIL_SOCKET_ID socket_id);
7038 /* Backward compatible */
7041 * RIL_Request Function pointer
7043 * @param request is one of RIL_REQUEST_*
7044 * @param data is pointer to data defined for that RIL_REQUEST_*
7045 * data is owned by caller, and should not be modified or freed by callee
7046 * structures passed as data may contain pointers to non-contiguous memory
7047 * @param t should be used in subsequent call to RIL_onResponse
7048 * @param datalen is the length of "data" which is defined as other argument. It may or may
7049 * not be equal to sizeof(data). Refer to the documentation of individual structures
7050 * to find if pointers listed in the structure are contiguous and counted in the datalen
7052 * (Eg: RIL_IMS_SMS_Message where we don't have datalen equal to sizeof(data))
7055 typedef void (*RIL_RequestFunc) (int request, void *data,
7056 size_t datalen, RIL_Token t);
7059 * This function should return the current radio state synchronously
7061 typedef RIL_RadioState (*RIL_RadioStateRequest)();
7067 * This function returns "1" if the specified RIL_REQUEST code is
7068 * supported and 0 if it is not
7070 * @param requestCode is one of RIL_REQUEST codes
7073 typedef int (*RIL_Supports)(int requestCode);
7076 * This function is called from a separate thread--not the
7077 * thread that calls RIL_RequestFunc--and indicates that a pending
7078 * request should be cancelled.
7080 * On cancel, the callee should do its best to abandon the request and
7081 * call RIL_onRequestComplete with RIL_Errno CANCELLED at some later point.
7083 * Subsequent calls to RIL_onRequestComplete for this request with
7084 * other results will be tolerated but ignored. (That is, it is valid
7085 * to ignore the cancellation request)
7087 * RIL_Cancel calls should return immediately, and not wait for cancellation
7089 * Please see ITU v.250 5.6.1 for how one might implement this on a TS 27.007
7092 * @param t token wants to be canceled
7095 typedef void (*RIL_Cancel)(RIL_Token t);
7097 typedef void (*RIL_TimedCallback) (void *param);
7100 * Return a version string for your RIL implementation
7102 typedef const char * (*RIL_GetVersion) (void);
7105 int version; /* set to RIL_VERSION */
7106 RIL_RequestFunc onRequest;
7107 RIL_RadioStateRequest onStateRequest;
7108 RIL_Supports supports;
7109 RIL_Cancel onCancel;
7110 RIL_GetVersion getVersion;
7111 } RIL_RadioFunctions;
7114 char *apn; /* the APN to connect to */
7115 char *protocol; /* one of the PDP_type values in TS 27.007 section 10.1.1 used on
7116 roaming network. For example, "IP", "IPV6", "IPV4V6", or "PPP".*/
7117 int authtype; /* authentication protocol used for this PDP context
7118 (None: 0, PAP: 1, CHAP: 2, PAP&CHAP: 3) */
7119 char *username; /* the username for APN, or NULL */
7120 char *password; /* the password for APN, or NULL */
7121 } RIL_InitialAttachApn;
7124 char *apn; /* the APN to connect to */
7125 char *protocol; /* one of the PDP_type values in TS 27.007 section 10.1.1 used on
7126 home network. For example, "IP", "IPV6", "IPV4V6", or "PPP". */
7127 char *roamingProtocol; /* one of the PDP_type values in TS 27.007 section 10.1.1 used on
7128 roaming network. For example, "IP", "IPV6", "IPV4V6", or "PPP".*/
7129 int authtype; /* authentication protocol used for this PDP context
7130 (None: 0, PAP: 1, CHAP: 2, PAP&CHAP: 3) */
7131 char *username; /* the username for APN, or NULL */
7132 char *password; /* the password for APN, or NULL */
7133 int supportedTypesBitmask; /* supported APN types bitmask. See RIL_ApnTypes for the value of
7135 int bearerBitmask; /* the bearer bitmask. See RIL_RadioAccessFamily for the value of
7137 int modemCognitive; /* indicating the APN setting was sent to the modem through
7138 setDataProfile earlier. */
7139 int mtu; /* maximum transmission unit (MTU) size in bytes */
7140 char *mvnoType; /* the MVNO type: possible values are "imsi", "gid", "spn" */
7141 char *mvnoMatchData; /* MVNO match data. Can be anything defined by the carrier.
7143 SPN like: "A MOBILE", "BEN NL", etc...
7144 IMSI like: "302720x94", "2060188", etc...
7145 GID like: "4E", "33", etc... */
7146 } RIL_InitialAttachApn_v15;
7149 int authContext; /* P2 value of authentication command, see P2 parameter in
7150 3GPP TS 31.102 7.1.2 */
7151 char *authData; /* the challenge string in Base64 format, see 3GPP
7153 char *aid; /* AID value, See ETSI 102.221 8.1 and 101.220 4,
7154 NULL if no value. */
7155 } RIL_SimAuthentication;
7158 int cid; /* Context ID, uniquely identifies this call */
7159 char *bearer_proto; /* One of the PDP_type values in TS 27.007 section 10.1.1.
7160 For example, "IP", "IPV6", "IPV4V6". */
7161 int pco_id; /* The protocol ID for this box. Note that only IDs from
7162 FF00H - FFFFH are accepted. If more than one is included
7163 from the network, multiple calls should be made to send all
7165 int contents_length; /* The number of octets in the contents. */
7166 char *contents; /* Carrier-defined content. It is binary, opaque and
7167 loosely defined in LTE Layer 3 spec 24.008 */
7171 NATT_IPV4 = 0, /* Keepalive specified by RFC 3948 Sec. 2.3 using IPv4 */
7172 NATT_IPV6 = 1 /* Keepalive specified by RFC 3948 Sec. 2.3 using IPv6 */
7173 } RIL_KeepaliveType;
7175 #define MAX_INADDR_LEN 16
7177 RIL_KeepaliveType type; /* Type of keepalive packet */
7178 char sourceAddress[MAX_INADDR_LEN]; /* Source address in network-byte order */
7179 int sourcePort; /* Source port if applicable, or 0x7FFFFFFF;
7180 the maximum value is 65535 */
7181 char destinationAddress[MAX_INADDR_LEN]; /* Destination address in network-byte order */
7182 int destinationPort; /* Destination port if applicable or 0x7FFFFFFF;
7183 the maximum value is 65535 */
7184 int maxKeepaliveIntervalMillis; /* Maximum milliseconds between two packets */
7185 int cid; /* Context ID, uniquely identifies this call */
7186 } RIL_KeepaliveRequest;
7189 KEEPALIVE_ACTIVE, /* Keepalive session is active */
7190 KEEPALIVE_INACTIVE, /* Keepalive session is inactive */
7191 KEEPALIVE_PENDING /* Keepalive session status not available */
7192 } RIL_KeepaliveStatusCode;
7195 uint32_t sessionHandle;
7196 RIL_KeepaliveStatusCode code;
7197 } RIL_KeepaliveStatus;
7202 * "t" is parameter passed in on previous call to RIL_Notification
7205 * If "e" != SUCCESS, then response can be null/is ignored
7207 * "response" is owned by caller, and should not be modified or
7210 * RIL_onRequestComplete will return as soon as possible
7212 void (*OnRequestComplete)(RIL_Token t, RIL_Errno e,
7213 void *response, size_t responselen);
7215 #if defined(ANDROID_MULTI_SIM)
7217 * "unsolResponse" is one of RIL_UNSOL_RESPONSE_*
7218 * "data" is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7220 * "data" is owned by caller, and should not be modified or freed by callee
7222 void (*OnUnsolicitedResponse)(int unsolResponse, const void *data, size_t datalen, RIL_SOCKET_ID socket_id);
7225 * "unsolResponse" is one of RIL_UNSOL_RESPONSE_*
7226 * "data" is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7228 * "data" is owned by caller, and should not be modified or freed by callee
7230 void (*OnUnsolicitedResponse)(int unsolResponse, const void *data, size_t datalen);
7233 * Call user-specifed "callback" function on on the same thread that
7234 * RIL_RequestFunc is called. If "relativeTime" is specified, then it specifies
7235 * a relative time value at which the callback is invoked. If relativeTime is
7236 * NULL or points to a 0-filled structure, the callback will be invoked as
7240 void (*RequestTimedCallback) (RIL_TimedCallback callback,
7241 void *param, const struct timeval *relativeTime);
7243 * "t" is parameter passed in on previous call RIL_Notification routine
7245 * RIL_onRequestAck will be called by vendor when an Async RIL request was received
7246 * by them and an ack needs to be sent back to java ril.
7248 void (*OnRequestAck) (RIL_Token t);
7253 * RIL implementations must defined RIL_Init
7254 * argc and argv will be command line arguments intended for the RIL implementation
7255 * Return NULL on error
7257 * @param env is environment point defined as RIL_Env
7258 * @param argc number of arguments
7259 * @param argv list fo arguments
7262 const RIL_RadioFunctions *RIL_Init(const struct RIL_Env *env, int argc, char **argv);
7265 * If BT SAP(SIM Access Profile) is supported, then RIL implementations must define RIL_SAP_Init
7266 * for initializing RIL_RadioFunctions used for BT SAP communcations. It is called whenever RILD
7267 * starts or modem restarts. Returns handlers for SAP related request that are made on SAP
7268 * sepecific socket, analogous to the RIL_RadioFunctions returned by the call to RIL_Init
7269 * and used on the general RIL socket.
7270 * argc and argv will be command line arguments intended for the RIL implementation
7271 * Return NULL on error.
7273 * @param env is environment point defined as RIL_Env
7274 * @param argc number of arguments
7275 * @param argv list fo arguments
7278 const RIL_RadioFunctions *RIL_SAP_Init(const struct RIL_Env *env, int argc, char **argv);
7280 #else /* RIL_SHLIB */
7283 * Call this once at startup to register notification routine
7285 * @param callbacks user-specifed callback function
7287 void RIL_register (const RIL_RadioFunctions *callbacks);
7289 void rilc_thread_pool();
7294 * RIL_onRequestComplete will return as soon as possible
7296 * @param t is parameter passed in on previous call to RIL_Notification
7298 * @param e error code
7299 * if "e" != SUCCESS, then response can be null/is ignored
7300 * @param response is owned by caller, and should not be modified or
7302 * @param responselen the length of response in byte
7304 void RIL_onRequestComplete(RIL_Token t, RIL_Errno e,
7305 void *response, size_t responselen);
7308 * RIL_onRequestAck will be called by vendor when an Async RIL request was received by them and
7309 * an ack needs to be sent back to java ril. This doesn't mark the end of the command or it's
7310 * results, just that the command was received and will take a while. After sending this Ack
7311 * its vendor's responsibility to make sure that AP is up whenever needed while command is
7314 * @param t is parameter passed in on previous call to RIL_Notification
7317 void RIL_onRequestAck(RIL_Token t);
7319 #if defined(ANDROID_MULTI_SIM)
7321 * @param unsolResponse is one of RIL_UNSOL_RESPONSE_*
7322 * @param data is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7323 * "data" is owned by caller, and should not be modified or freed by callee
7324 * @param datalen the length of data in byte
7327 void RIL_onUnsolicitedResponse(int unsolResponse, const void *data,
7328 size_t datalen, RIL_SOCKET_ID socket_id);
7331 * @param unsolResponse is one of RIL_UNSOL_RESPONSE_*
7332 * @param data is pointer to data defined for that RIL_UNSOL_RESPONSE_*
7333 * "data" is owned by caller, and should not be modified or freed by callee
7334 * @param datalen the length of data in byte
7337 void RIL_onUnsolicitedResponse(int unsolResponse, const void *data,
7342 * Call user-specifed "callback" function on on the same thread that
7343 * RIL_RequestFunc is called. If "relativeTime" is specified, then it specifies
7344 * a relative time value at which the callback is invoked. If relativeTime is
7345 * NULL or points to a 0-filled structure, the callback will be invoked as
7348 * @param callback user-specifed callback function
7349 * @param param parameter list
7350 * @param relativeTime a relative time value at which the callback is invoked
7353 void RIL_requestTimedCallback (RIL_TimedCallback callback,
7354 void *param, const struct timeval *relativeTime);
7356 #endif /* RIL_SHLIB */
7362 #endif /*ANDROID_RIL_H*/