TelephonyManager.java revision f1fb39763d87dabe254b6ed64ac8f20145035bc0
1/*
2 * Copyright (C) 2008 The Android Open Source Project
3 *
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
7 *
8 *      http://www.apache.org/licenses/LICENSE-2.0
9 *
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.
15 */
16
17package android.telephony;
18
19import android.annotation.Nullable;
20import android.annotation.SystemApi;
21import android.annotation.SdkConstant;
22import android.annotation.SdkConstant.SdkConstantType;
23import android.content.ContentResolver;
24import android.content.Context;
25import android.content.Intent;
26import android.provider.Settings;
27import android.provider.Settings.SettingNotFoundException;
28import android.os.Bundle;
29import android.os.RemoteException;
30import android.os.ServiceManager;
31import android.os.SystemProperties;
32import android.telecom.PhoneAccount;
33import android.util.Log;
34
35import com.android.internal.telecom.ITelecomService;
36import com.android.internal.telephony.IPhoneSubInfo;
37import com.android.internal.telephony.ITelephony;
38import com.android.internal.telephony.ITelephonyRegistry;
39import com.android.internal.telephony.PhoneConstants;
40import com.android.internal.telephony.RILConstants;
41import com.android.internal.telephony.TelephonyProperties;
42
43import java.io.FileInputStream;
44import java.io.IOException;
45import java.util.List;
46import java.util.regex.Matcher;
47import java.util.regex.Pattern;
48
49/**
50 * Provides access to information about the telephony services on
51 * the device. Applications can use the methods in this class to
52 * determine telephony services and states, as well as to access some
53 * types of subscriber information. Applications can also register
54 * a listener to receive notification of telephony state changes.
55 * <p>
56 * You do not instantiate this class directly; instead, you retrieve
57 * a reference to an instance through
58 * {@link android.content.Context#getSystemService
59 * Context.getSystemService(Context.TELEPHONY_SERVICE)}.
60 * <p>
61 * Note that access to some telephony information is
62 * permission-protected. Your application cannot access the protected
63 * information unless it has the appropriate permissions declared in
64 * its manifest file. Where permissions apply, they are noted in the
65 * the methods through which you access the protected information.
66 */
67public class TelephonyManager {
68    private static final String TAG = "TelephonyManager";
69
70    private static ITelephonyRegistry sRegistry;
71
72    /**
73     * The allowed states of Wi-Fi calling.
74     *
75     * @hide
76     */
77    public interface WifiCallingChoices {
78        /** Always use Wi-Fi calling */
79        static final int ALWAYS_USE = 0;
80        /** Ask the user whether to use Wi-Fi on every call */
81        static final int ASK_EVERY_TIME = 1;
82        /** Never use Wi-Fi calling */
83        static final int NEVER_USE = 2;
84    }
85
86    private final Context mContext;
87    private SubscriptionManager mSubscriptionManager;
88
89    private static String multiSimConfig =
90            SystemProperties.get(TelephonyProperties.PROPERTY_MULTI_SIM_CONFIG);
91
92    /** Enum indicating multisim variants
93     *  DSDS - Dual SIM Dual Standby
94     *  DSDA - Dual SIM Dual Active
95     *  TSTS - Triple SIM Triple Standby
96     **/
97    /** @hide */
98    public enum MultiSimVariants {
99        DSDS,
100        DSDA,
101        TSTS,
102        UNKNOWN
103    };
104
105    /** @hide */
106    public TelephonyManager(Context context) {
107        Context appContext = context.getApplicationContext();
108        if (appContext != null) {
109            mContext = appContext;
110        } else {
111            mContext = context;
112        }
113        mSubscriptionManager = SubscriptionManager.from(mContext);
114
115        if (sRegistry == null) {
116            sRegistry = ITelephonyRegistry.Stub.asInterface(ServiceManager.getService(
117                    "telephony.registry"));
118        }
119    }
120
121    /** @hide */
122    private TelephonyManager() {
123        mContext = null;
124    }
125
126    private static TelephonyManager sInstance = new TelephonyManager();
127
128    /** @hide
129    /* @deprecated - use getSystemService as described above */
130    public static TelephonyManager getDefault() {
131        return sInstance;
132    }
133
134
135    /**
136     * Returns the multi SIM variant
137     * Returns DSDS for Dual SIM Dual Standby
138     * Returns DSDA for Dual SIM Dual Active
139     * Returns TSTS for Triple SIM Triple Standby
140     * Returns UNKNOWN for others
141     */
142    /** {@hide} */
143    public MultiSimVariants getMultiSimConfiguration() {
144        String mSimConfig =
145            SystemProperties.get(TelephonyProperties.PROPERTY_MULTI_SIM_CONFIG);
146        if (mSimConfig.equals("dsds")) {
147            return MultiSimVariants.DSDS;
148        } else if (mSimConfig.equals("dsda")) {
149            return MultiSimVariants.DSDA;
150        } else if (mSimConfig.equals("tsts")) {
151            return MultiSimVariants.TSTS;
152        } else {
153            return MultiSimVariants.UNKNOWN;
154        }
155    }
156
157
158    /**
159     * Returns the number of phones available.
160     * Returns 1 for Single standby mode (Single SIM functionality)
161     * Returns 2 for Dual standby mode.(Dual SIM functionality)
162     */
163    public int getPhoneCount() {
164        int phoneCount = 1;
165        switch (getMultiSimConfiguration()) {
166            case UNKNOWN:
167                phoneCount = 1;
168                break;
169            case DSDS:
170            case DSDA:
171                phoneCount = PhoneConstants.MAX_PHONE_COUNT_DUAL_SIM;
172                break;
173            case TSTS:
174                phoneCount = PhoneConstants.MAX_PHONE_COUNT_TRI_SIM;
175                break;
176        }
177        return phoneCount;
178    }
179
180    /** {@hide} */
181    public static TelephonyManager from(Context context) {
182        return (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
183    }
184
185    /** {@hide} */
186    public boolean isMultiSimEnabled() {
187        return (multiSimConfig.equals("dsds") || multiSimConfig.equals("dsda") ||
188            multiSimConfig.equals("tsts"));
189    }
190
191    //
192    // Broadcast Intent actions
193    //
194
195    /**
196     * Broadcast intent action indicating that the call state (cellular)
197     * on the device has changed.
198     *
199     * <p>
200     * The {@link #EXTRA_STATE} extra indicates the new call state.
201     * If the new state is RINGING, a second extra
202     * {@link #EXTRA_INCOMING_NUMBER} provides the incoming phone number as
203     * a String.
204     *
205     * <p class="note">
206     * Requires the READ_PHONE_STATE permission.
207     *
208     * <p class="note">
209     * This was a {@link android.content.Context#sendStickyBroadcast sticky}
210     * broadcast in version 1.0, but it is no longer sticky.
211     * Instead, use {@link #getCallState} to synchronously query the current call state.
212     *
213     * @see #EXTRA_STATE
214     * @see #EXTRA_INCOMING_NUMBER
215     * @see #getCallState
216     */
217    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
218    public static final String ACTION_PHONE_STATE_CHANGED =
219            "android.intent.action.PHONE_STATE";
220
221    /**
222     * The Phone app sends this intent when a user opts to respond-via-message during an incoming
223     * call. By default, the device's default SMS app consumes this message and sends a text message
224     * to the caller. A third party app can also provide this functionality by consuming this Intent
225     * with a {@link android.app.Service} and sending the message using its own messaging system.
226     * <p>The intent contains a URI (available from {@link android.content.Intent#getData})
227     * describing the recipient, using either the {@code sms:}, {@code smsto:}, {@code mms:},
228     * or {@code mmsto:} URI schema. Each of these URI schema carry the recipient information the
229     * same way: the path part of the URI contains the recipient's phone number or a comma-separated
230     * set of phone numbers if there are multiple recipients. For example, {@code
231     * smsto:2065551234}.</p>
232     *
233     * <p>The intent may also contain extras for the message text (in {@link
234     * android.content.Intent#EXTRA_TEXT}) and a message subject
235     * (in {@link android.content.Intent#EXTRA_SUBJECT}).</p>
236     *
237     * <p class="note"><strong>Note:</strong>
238     * The intent-filter that consumes this Intent needs to be in a {@link android.app.Service}
239     * that requires the
240     * permission {@link android.Manifest.permission#SEND_RESPOND_VIA_MESSAGE}.</p>
241     * <p>For example, the service that receives this intent can be declared in the manifest file
242     * with an intent filter like this:</p>
243     * <pre>
244     * &lt;!-- Service that delivers SMS messages received from the phone "quick response" -->
245     * &lt;service android:name=".HeadlessSmsSendService"
246     *          android:permission="android.permission.SEND_RESPOND_VIA_MESSAGE"
247     *          android:exported="true" >
248     *   &lt;intent-filter>
249     *     &lt;action android:name="android.intent.action.RESPOND_VIA_MESSAGE" />
250     *     &lt;category android:name="android.intent.category.DEFAULT" />
251     *     &lt;data android:scheme="sms" />
252     *     &lt;data android:scheme="smsto" />
253     *     &lt;data android:scheme="mms" />
254     *     &lt;data android:scheme="mmsto" />
255     *   &lt;/intent-filter>
256     * &lt;/service></pre>
257     * <p>
258     * Output: nothing.
259     */
260    @SdkConstant(SdkConstantType.SERVICE_ACTION)
261    public static final String ACTION_RESPOND_VIA_MESSAGE =
262            "android.intent.action.RESPOND_VIA_MESSAGE";
263
264    /**
265     * The emergency dialer may choose to present activities with intent filters for this
266     * action as emergency assistance buttons that launch the activity when clicked.
267     */
268    @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
269    public static final String ACTION_EMERGENCY_ASSISTANCE =
270            "android.telephony.action.EMERGENCY_ASSISTANCE";
271
272    /**
273     * The lookup key used with the {@link #ACTION_PHONE_STATE_CHANGED} broadcast
274     * for a String containing the new call state.
275     *
276     * @see #EXTRA_STATE_IDLE
277     * @see #EXTRA_STATE_RINGING
278     * @see #EXTRA_STATE_OFFHOOK
279     *
280     * <p class="note">
281     * Retrieve with
282     * {@link android.content.Intent#getStringExtra(String)}.
283     */
284    public static final String EXTRA_STATE = PhoneConstants.STATE_KEY;
285
286    /**
287     * Value used with {@link #EXTRA_STATE} corresponding to
288     * {@link #CALL_STATE_IDLE}.
289     */
290    public static final String EXTRA_STATE_IDLE = PhoneConstants.State.IDLE.toString();
291
292    /**
293     * Value used with {@link #EXTRA_STATE} corresponding to
294     * {@link #CALL_STATE_RINGING}.
295     */
296    public static final String EXTRA_STATE_RINGING = PhoneConstants.State.RINGING.toString();
297
298    /**
299     * Value used with {@link #EXTRA_STATE} corresponding to
300     * {@link #CALL_STATE_OFFHOOK}.
301     */
302    public static final String EXTRA_STATE_OFFHOOK = PhoneConstants.State.OFFHOOK.toString();
303
304    /**
305     * The lookup key used with the {@link #ACTION_PHONE_STATE_CHANGED} broadcast
306     * for a String containing the incoming phone number.
307     * Only valid when the new call state is RINGING.
308     *
309     * <p class="note">
310     * Retrieve with
311     * {@link android.content.Intent#getStringExtra(String)}.
312     */
313    public static final String EXTRA_INCOMING_NUMBER = "incoming_number";
314
315    /**
316     * Broadcast intent action indicating that a precise call state
317     * (cellular) on the device has changed.
318     *
319     * <p>
320     * The {@link #EXTRA_RINGING_CALL_STATE} extra indicates the ringing call state.
321     * The {@link #EXTRA_FOREGROUND_CALL_STATE} extra indicates the foreground call state.
322     * The {@link #EXTRA_BACKGROUND_CALL_STATE} extra indicates the background call state.
323     * The {@link #EXTRA_DISCONNECT_CAUSE} extra indicates the disconnect cause.
324     * The {@link #EXTRA_PRECISE_DISCONNECT_CAUSE} extra indicates the precise disconnect cause.
325     *
326     * <p class="note">
327     * Requires the READ_PRECISE_PHONE_STATE permission.
328     *
329     * @see #EXTRA_RINGING_CALL_STATE
330     * @see #EXTRA_FOREGROUND_CALL_STATE
331     * @see #EXTRA_BACKGROUND_CALL_STATE
332     * @see #EXTRA_DISCONNECT_CAUSE
333     * @see #EXTRA_PRECISE_DISCONNECT_CAUSE
334     *
335     * <p class="note">
336     * Requires the READ_PRECISE_PHONE_STATE permission.
337     *
338     * @hide
339     */
340    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
341    public static final String ACTION_PRECISE_CALL_STATE_CHANGED =
342            "android.intent.action.PRECISE_CALL_STATE";
343
344    /**
345     * The lookup key used with the {@link #ACTION_PRECISE_CALL_STATE_CHANGED} broadcast
346     * for an integer containing the state of the current ringing call.
347     *
348     * @see PreciseCallState#PRECISE_CALL_STATE_NOT_VALID
349     * @see PreciseCallState#PRECISE_CALL_STATE_IDLE
350     * @see PreciseCallState#PRECISE_CALL_STATE_ACTIVE
351     * @see PreciseCallState#PRECISE_CALL_STATE_HOLDING
352     * @see PreciseCallState#PRECISE_CALL_STATE_DIALING
353     * @see PreciseCallState#PRECISE_CALL_STATE_ALERTING
354     * @see PreciseCallState#PRECISE_CALL_STATE_INCOMING
355     * @see PreciseCallState#PRECISE_CALL_STATE_WAITING
356     * @see PreciseCallState#PRECISE_CALL_STATE_DISCONNECTED
357     * @see PreciseCallState#PRECISE_CALL_STATE_DISCONNECTING
358     *
359     * <p class="note">
360     * Retrieve with
361     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
362     *
363     * @hide
364     */
365    public static final String EXTRA_RINGING_CALL_STATE = "ringing_state";
366
367    /**
368     * The lookup key used with the {@link #ACTION_PRECISE_CALL_STATE_CHANGED} broadcast
369     * for an integer containing the state of the current foreground call.
370     *
371     * @see PreciseCallState#PRECISE_CALL_STATE_NOT_VALID
372     * @see PreciseCallState#PRECISE_CALL_STATE_IDLE
373     * @see PreciseCallState#PRECISE_CALL_STATE_ACTIVE
374     * @see PreciseCallState#PRECISE_CALL_STATE_HOLDING
375     * @see PreciseCallState#PRECISE_CALL_STATE_DIALING
376     * @see PreciseCallState#PRECISE_CALL_STATE_ALERTING
377     * @see PreciseCallState#PRECISE_CALL_STATE_INCOMING
378     * @see PreciseCallState#PRECISE_CALL_STATE_WAITING
379     * @see PreciseCallState#PRECISE_CALL_STATE_DISCONNECTED
380     * @see PreciseCallState#PRECISE_CALL_STATE_DISCONNECTING
381     *
382     * <p class="note">
383     * Retrieve with
384     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
385     *
386     * @hide
387     */
388    public static final String EXTRA_FOREGROUND_CALL_STATE = "foreground_state";
389
390    /**
391     * The lookup key used with the {@link #ACTION_PRECISE_CALL_STATE_CHANGED} broadcast
392     * for an integer containing the state of the current background call.
393     *
394     * @see PreciseCallState#PRECISE_CALL_STATE_NOT_VALID
395     * @see PreciseCallState#PRECISE_CALL_STATE_IDLE
396     * @see PreciseCallState#PRECISE_CALL_STATE_ACTIVE
397     * @see PreciseCallState#PRECISE_CALL_STATE_HOLDING
398     * @see PreciseCallState#PRECISE_CALL_STATE_DIALING
399     * @see PreciseCallState#PRECISE_CALL_STATE_ALERTING
400     * @see PreciseCallState#PRECISE_CALL_STATE_INCOMING
401     * @see PreciseCallState#PRECISE_CALL_STATE_WAITING
402     * @see PreciseCallState#PRECISE_CALL_STATE_DISCONNECTED
403     * @see PreciseCallState#PRECISE_CALL_STATE_DISCONNECTING
404     *
405     * <p class="note">
406     * Retrieve with
407     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
408     *
409     * @hide
410     */
411    public static final String EXTRA_BACKGROUND_CALL_STATE = "background_state";
412
413    /**
414     * The lookup key used with the {@link #ACTION_PRECISE_CALL_STATE_CHANGED} broadcast
415     * for an integer containing the disconnect cause.
416     *
417     * @see DisconnectCause
418     *
419     * <p class="note">
420     * Retrieve with
421     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
422     *
423     * @hide
424     */
425    public static final String EXTRA_DISCONNECT_CAUSE = "disconnect_cause";
426
427    /**
428     * The lookup key used with the {@link #ACTION_PRECISE_CALL_STATE_CHANGED} broadcast
429     * for an integer containing the disconnect cause provided by the RIL.
430     *
431     * @see PreciseDisconnectCause
432     *
433     * <p class="note">
434     * Retrieve with
435     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
436     *
437     * @hide
438     */
439    public static final String EXTRA_PRECISE_DISCONNECT_CAUSE = "precise_disconnect_cause";
440
441    /**
442     * Broadcast intent action indicating a data connection has changed,
443     * providing precise information about the connection.
444     *
445     * <p>
446     * The {@link #EXTRA_DATA_STATE} extra indicates the connection state.
447     * The {@link #EXTRA_DATA_NETWORK_TYPE} extra indicates the connection network type.
448     * The {@link #EXTRA_DATA_APN_TYPE} extra indicates the APN type.
449     * The {@link #EXTRA_DATA_APN} extra indicates the APN.
450     * The {@link #EXTRA_DATA_CHANGE_REASON} extra indicates the connection change reason.
451     * The {@link #EXTRA_DATA_IFACE_PROPERTIES} extra indicates the connection interface.
452     * The {@link #EXTRA_DATA_FAILURE_CAUSE} extra indicates the connection fail cause.
453     *
454     * <p class="note">
455     * Requires the READ_PRECISE_PHONE_STATE permission.
456     *
457     * @see #EXTRA_DATA_STATE
458     * @see #EXTRA_DATA_NETWORK_TYPE
459     * @see #EXTRA_DATA_APN_TYPE
460     * @see #EXTRA_DATA_APN
461     * @see #EXTRA_DATA_CHANGE_REASON
462     * @see #EXTRA_DATA_IFACE
463     * @see #EXTRA_DATA_FAILURE_CAUSE
464     * @hide
465     */
466    @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION)
467    public static final String ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED =
468            "android.intent.action.PRECISE_DATA_CONNECTION_STATE_CHANGED";
469
470    /**
471     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
472     * for an integer containing the state of the current data connection.
473     *
474     * @see TelephonyManager#DATA_UNKNOWN
475     * @see TelephonyManager#DATA_DISCONNECTED
476     * @see TelephonyManager#DATA_CONNECTING
477     * @see TelephonyManager#DATA_CONNECTED
478     * @see TelephonyManager#DATA_SUSPENDED
479     *
480     * <p class="note">
481     * Retrieve with
482     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
483     *
484     * @hide
485     */
486    public static final String EXTRA_DATA_STATE = PhoneConstants.STATE_KEY;
487
488    /**
489     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
490     * for an integer containing the network type.
491     *
492     * @see TelephonyManager#NETWORK_TYPE_UNKNOWN
493     * @see TelephonyManager#NETWORK_TYPE_GPRS
494     * @see TelephonyManager#NETWORK_TYPE_EDGE
495     * @see TelephonyManager#NETWORK_TYPE_UMTS
496     * @see TelephonyManager#NETWORK_TYPE_CDMA
497     * @see TelephonyManager#NETWORK_TYPE_EVDO_0
498     * @see TelephonyManager#NETWORK_TYPE_EVDO_A
499     * @see TelephonyManager#NETWORK_TYPE_1xRTT
500     * @see TelephonyManager#NETWORK_TYPE_HSDPA
501     * @see TelephonyManager#NETWORK_TYPE_HSUPA
502     * @see TelephonyManager#NETWORK_TYPE_HSPA
503     * @see TelephonyManager#NETWORK_TYPE_IDEN
504     * @see TelephonyManager#NETWORK_TYPE_EVDO_B
505     * @see TelephonyManager#NETWORK_TYPE_LTE
506     * @see TelephonyManager#NETWORK_TYPE_EHRPD
507     * @see TelephonyManager#NETWORK_TYPE_HSPAP
508     *
509     * <p class="note">
510     * Retrieve with
511     * {@link android.content.Intent#getIntExtra(String name, int defaultValue)}.
512     *
513     * @hide
514     */
515    public static final String EXTRA_DATA_NETWORK_TYPE = PhoneConstants.DATA_NETWORK_TYPE_KEY;
516
517    /**
518     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
519     * for an String containing the data APN type.
520     *
521     * <p class="note">
522     * Retrieve with
523     * {@link android.content.Intent#getStringExtra(String name)}.
524     *
525     * @hide
526     */
527    public static final String EXTRA_DATA_APN_TYPE = PhoneConstants.DATA_APN_TYPE_KEY;
528
529    /**
530     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
531     * for an String containing the data APN.
532     *
533     * <p class="note">
534     * Retrieve with
535     * {@link android.content.Intent#getStringExtra(String name)}.
536     *
537     * @hide
538     */
539    public static final String EXTRA_DATA_APN = PhoneConstants.DATA_APN_KEY;
540
541    /**
542     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
543     * for an String representation of the change reason.
544     *
545     * <p class="note">
546     * Retrieve with
547     * {@link android.content.Intent#getStringExtra(String name)}.
548     *
549     * @hide
550     */
551    public static final String EXTRA_DATA_CHANGE_REASON = PhoneConstants.STATE_CHANGE_REASON_KEY;
552
553    /**
554     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
555     * for an String representation of the data interface.
556     *
557     * <p class="note">
558     * Retrieve with
559     * {@link android.content.Intent#getParcelableExtra(String name)}.
560     *
561     * @hide
562     */
563    public static final String EXTRA_DATA_LINK_PROPERTIES_KEY = PhoneConstants.DATA_LINK_PROPERTIES_KEY;
564
565    /**
566     * The lookup key used with the {@link #ACTION_PRECISE_DATA_CONNECTION_STATE_CHANGED} broadcast
567     * for the data connection fail cause.
568     *
569     * <p class="note">
570     * Retrieve with
571     * {@link android.content.Intent#getStringExtra(String name)}.
572     *
573     * @hide
574     */
575    public static final String EXTRA_DATA_FAILURE_CAUSE = PhoneConstants.DATA_FAILURE_CAUSE_KEY;
576
577    /**
578     * Response codes for sim activation. Activation completed successfully.
579     * @hide
580     */
581    @SystemApi
582    public static final int SIM_ACTIVATION_RESULT_COMPLETE = 0;
583    /**
584     * Response codes for sim activation. Activation not supported (device has no SIM).
585     * @hide
586     */
587    @SystemApi
588    public static final int SIM_ACTIVATION_RESULT_NOT_SUPPORTED = 1;
589    /**
590     * Response codes for sim activation. Activation is in progress.
591     * @hide
592     */
593    @SystemApi
594    public static final int SIM_ACTIVATION_RESULT_IN_PROGRESS = 2;
595    /**
596     * Response codes for sim activation. Activation failed to complete.
597     * @hide
598     */
599    @SystemApi
600    public static final int SIM_ACTIVATION_RESULT_FAILED = 3;
601    /**
602     * Response codes for sim activation. Activation canceled by user.
603     * @hide
604     */
605    @SystemApi
606    public static final int SIM_ACTIVATION_RESULT_CANCELED = 4;
607
608    //
609    //
610    // Device Info
611    //
612    //
613
614    /**
615     * Returns the software version number for the device, for example,
616     * the IMEI/SV for GSM phones. Return null if the software version is
617     * not available.
618     *
619     * <p>Requires Permission:
620     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
621     */
622    public String getDeviceSoftwareVersion() {
623        return getDeviceSoftwareVersion(getDefaultSim());
624    }
625
626    /**
627     * Returns the software version number for the device, for example,
628     * the IMEI/SV for GSM phones. Return null if the software version is
629     * not available.
630     *
631     * <p>Requires Permission:
632     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
633     *
634     * @param slotId of which deviceID is returned
635     */
636    /** {@hide} */
637    public String getDeviceSoftwareVersion(int slotId) {
638        // FIXME methods taking slot id should not use subscription, instead us Uicc directly
639        int[] subId = SubscriptionManager.getSubId(slotId);
640        if (subId == null || subId.length == 0) {
641            return null;
642        }
643        try {
644            IPhoneSubInfo info = getSubscriberInfo();
645            if (info == null)
646                return null;
647            return info.getDeviceSvnUsingSubId(subId[0]);
648        } catch (RemoteException ex) {
649            return null;
650        } catch (NullPointerException ex) {
651            return null;
652        }
653    }
654
655    /**
656     * Returns the unique device ID, for example, the IMEI for GSM and the MEID
657     * or ESN for CDMA phones. Return null if device ID is not available.
658     *
659     * <p>Requires Permission:
660     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
661     */
662    public String getDeviceId() {
663        try {
664            ITelephony telephony = getITelephony();
665            if (telephony == null)
666                return null;
667            return telephony.getDeviceId(mContext.getOpPackageName());
668        } catch (RemoteException ex) {
669            return null;
670        } catch (NullPointerException ex) {
671            return null;
672        }
673    }
674
675    /**
676     * Returns the unique device ID of a subscription, for example, the IMEI for
677     * GSM and the MEID for CDMA phones. Return null if device ID is not available.
678     *
679     * <p>Requires Permission:
680     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
681     *
682     * @param slotId of which deviceID is returned
683     */
684    public String getDeviceId(int slotId) {
685        // FIXME this assumes phoneId == slotId
686        try {
687            IPhoneSubInfo info = getSubscriberInfo();
688            if (info == null)
689                return null;
690            return info.getDeviceIdForPhone(slotId);
691        } catch (RemoteException ex) {
692            return null;
693        } catch (NullPointerException ex) {
694            return null;
695        }
696    }
697
698    /**
699     * Returns the IMEI. Return null if IMEI is not available.
700     *
701     * <p>Requires Permission:
702     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
703     */
704    /** {@hide} */
705    public String getImei() {
706        return getImei(getDefaultSim());
707    }
708
709    /**
710     * Returns the IMEI. Return null if IMEI is not available.
711     *
712     * <p>Requires Permission:
713     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
714     *
715     * @param slotId of which deviceID is returned
716     */
717    /** {@hide} */
718    public String getImei(int slotId) {
719        int[] subId = SubscriptionManager.getSubId(slotId);
720        try {
721            IPhoneSubInfo info = getSubscriberInfo();
722            if (info == null)
723                return null;
724            return info.getImeiForSubscriber(subId[0]);
725        } catch (RemoteException ex) {
726            return null;
727        } catch (NullPointerException ex) {
728            return null;
729        }
730    }
731
732    /**
733     * Returns the NAI. Return null if NAI is not available.
734     *
735     */
736    /** {@hide}*/
737    public String getNai() {
738        return getNai(getDefaultSim());
739    }
740
741    /**
742     * Returns the NAI. Return null if NAI is not available.
743     *
744     *  @param slotId of which Nai is returned
745     */
746    /** {@hide}*/
747    public String getNai(int slotId) {
748        int[] subId = SubscriptionManager.getSubId(slotId);
749        try {
750            IPhoneSubInfo info = getSubscriberInfo();
751            if (info == null)
752                return null;
753            String nai = info.getNaiForSubscriber(subId[0]);
754            if (Log.isLoggable(TAG, Log.VERBOSE)) {
755                Rlog.v(TAG, "Nai = " + nai);
756            }
757            return nai;
758        } catch (RemoteException ex) {
759            return null;
760        } catch (NullPointerException ex) {
761            return null;
762        }
763    }
764
765    /**
766     * Returns the current location of the device.
767     *<p>
768     * If there is only one radio in the device and that radio has an LTE connection,
769     * this method will return null. The implementation must not to try add LTE
770     * identifiers into the existing cdma/gsm classes.
771     *<p>
772     * In the future this call will be deprecated.
773     *<p>
774     * @return Current location of the device or null if not available.
775     *
776     * <p>Requires Permission:
777     * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION} or
778     * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_FINE_LOCATION}.
779     */
780    public CellLocation getCellLocation() {
781        try {
782            ITelephony telephony = getITelephony();
783            if (telephony == null)
784                return null;
785            Bundle bundle = telephony.getCellLocation(mContext.getOpPackageName());
786            if (bundle.isEmpty()) return null;
787            CellLocation cl = CellLocation.newFromBundle(bundle);
788            if (cl.isEmpty())
789                return null;
790            return cl;
791        } catch (RemoteException ex) {
792            return null;
793        } catch (NullPointerException ex) {
794            return null;
795        }
796    }
797
798    /**
799     * Enables location update notifications.  {@link PhoneStateListener#onCellLocationChanged
800     * PhoneStateListener.onCellLocationChanged} will be called on location updates.
801     *
802     * <p>Requires Permission: {@link android.Manifest.permission#CONTROL_LOCATION_UPDATES
803     * CONTROL_LOCATION_UPDATES}
804     *
805     * @hide
806     */
807    public void enableLocationUpdates() {
808            enableLocationUpdates(getDefaultSubscription());
809    }
810
811    /**
812     * Enables location update notifications for a subscription.
813     * {@link PhoneStateListener#onCellLocationChanged
814     * PhoneStateListener.onCellLocationChanged} will be called on location updates.
815     *
816     * <p>Requires Permission: {@link android.Manifest.permission#CONTROL_LOCATION_UPDATES
817     * CONTROL_LOCATION_UPDATES}
818     *
819     * @param subId for which the location updates are enabled
820     */
821    /** @hide */
822    public void enableLocationUpdates(int subId) {
823        try {
824            ITelephony telephony = getITelephony();
825            if (telephony != null)
826                telephony.enableLocationUpdatesForSubscriber(subId);
827        } catch (RemoteException ex) {
828        } catch (NullPointerException ex) {
829        }
830    }
831
832    /**
833     * Disables location update notifications.  {@link PhoneStateListener#onCellLocationChanged
834     * PhoneStateListener.onCellLocationChanged} will be called on location updates.
835     *
836     * <p>Requires Permission: {@link android.Manifest.permission#CONTROL_LOCATION_UPDATES
837     * CONTROL_LOCATION_UPDATES}
838     *
839     * @hide
840     */
841    public void disableLocationUpdates() {
842            disableLocationUpdates(getDefaultSubscription());
843    }
844
845    /** @hide */
846    public void disableLocationUpdates(int subId) {
847        try {
848            ITelephony telephony = getITelephony();
849            if (telephony != null)
850                telephony.disableLocationUpdatesForSubscriber(subId);
851        } catch (RemoteException ex) {
852        } catch (NullPointerException ex) {
853        }
854    }
855
856    /**
857     * Returns the neighboring cell information of the device. The getAllCellInfo is preferred
858     * and use this only if getAllCellInfo return nulls or an empty list.
859     *<p>
860     * In the future this call will be deprecated.
861     *<p>
862     * @return List of NeighboringCellInfo or null if info unavailable.
863     *
864     * <p>Requires Permission:
865     * (@link android.Manifest.permission#ACCESS_COARSE_UPDATES}
866     */
867    public List<NeighboringCellInfo> getNeighboringCellInfo() {
868        try {
869            ITelephony telephony = getITelephony();
870            if (telephony == null)
871                return null;
872            return telephony.getNeighboringCellInfo(mContext.getOpPackageName());
873        } catch (RemoteException ex) {
874            return null;
875        } catch (NullPointerException ex) {
876            return null;
877        }
878    }
879
880    /** No phone radio. */
881    public static final int PHONE_TYPE_NONE = PhoneConstants.PHONE_TYPE_NONE;
882    /** Phone radio is GSM. */
883    public static final int PHONE_TYPE_GSM = PhoneConstants.PHONE_TYPE_GSM;
884    /** Phone radio is CDMA. */
885    public static final int PHONE_TYPE_CDMA = PhoneConstants.PHONE_TYPE_CDMA;
886    /** Phone is via SIP. */
887    public static final int PHONE_TYPE_SIP = PhoneConstants.PHONE_TYPE_SIP;
888
889    /**
890     * Returns the current phone type.
891     * TODO: This is a last minute change and hence hidden.
892     *
893     * @see #PHONE_TYPE_NONE
894     * @see #PHONE_TYPE_GSM
895     * @see #PHONE_TYPE_CDMA
896     * @see #PHONE_TYPE_SIP
897     *
898     * {@hide}
899     */
900    @SystemApi
901    public int getCurrentPhoneType() {
902        return getCurrentPhoneType(getDefaultSubscription());
903    }
904
905    /**
906     * Returns a constant indicating the device phone type for a subscription.
907     *
908     * @see #PHONE_TYPE_NONE
909     * @see #PHONE_TYPE_GSM
910     * @see #PHONE_TYPE_CDMA
911     *
912     * @param subId for which phone type is returned
913     */
914    /** {@hide} */
915    @SystemApi
916    public int getCurrentPhoneType(int subId) {
917        int phoneId = SubscriptionManager.getPhoneId(subId);
918        try{
919            ITelephony telephony = getITelephony();
920            if (telephony != null) {
921                return telephony.getActivePhoneTypeForSubscriber(subId);
922            } else {
923                // This can happen when the ITelephony interface is not up yet.
924                return getPhoneTypeFromProperty(phoneId);
925            }
926        } catch (RemoteException ex) {
927            // This shouldn't happen in the normal case, as a backup we
928            // read from the system property.
929            return getPhoneTypeFromProperty(phoneId);
930        } catch (NullPointerException ex) {
931            // This shouldn't happen in the normal case, as a backup we
932            // read from the system property.
933            return getPhoneTypeFromProperty(phoneId);
934        }
935    }
936
937    /**
938     * Returns a constant indicating the device phone type.  This
939     * indicates the type of radio used to transmit voice calls.
940     *
941     * @see #PHONE_TYPE_NONE
942     * @see #PHONE_TYPE_GSM
943     * @see #PHONE_TYPE_CDMA
944     * @see #PHONE_TYPE_SIP
945     */
946    public int getPhoneType() {
947        if (!isVoiceCapable()) {
948            return PHONE_TYPE_NONE;
949        }
950        return getCurrentPhoneType();
951    }
952
953    private int getPhoneTypeFromProperty() {
954        return getPhoneTypeFromProperty(getDefaultPhone());
955    }
956
957    /** {@hide} */
958    private int getPhoneTypeFromProperty(int phoneId) {
959        String type = getTelephonyProperty(phoneId,
960                TelephonyProperties.CURRENT_ACTIVE_PHONE, null);
961        if (type == null || type.equals("")) {
962            return getPhoneTypeFromNetworkType(phoneId);
963        }
964        return Integer.parseInt(type);
965    }
966
967    private int getPhoneTypeFromNetworkType() {
968        return getPhoneTypeFromNetworkType(getDefaultPhone());
969    }
970
971    /** {@hide} */
972    private int getPhoneTypeFromNetworkType(int phoneId) {
973        // When the system property CURRENT_ACTIVE_PHONE, has not been set,
974        // use the system property for default network type.
975        // This is a fail safe, and can only happen at first boot.
976        String mode = getTelephonyProperty(phoneId, "ro.telephony.default_network", null);
977        if (mode != null) {
978            return TelephonyManager.getPhoneType(Integer.parseInt(mode));
979        }
980        return TelephonyManager.PHONE_TYPE_NONE;
981    }
982
983    /**
984     * This function returns the type of the phone, depending
985     * on the network mode.
986     *
987     * @param networkMode
988     * @return Phone Type
989     *
990     * @hide
991     */
992    public static int getPhoneType(int networkMode) {
993        switch(networkMode) {
994        case RILConstants.NETWORK_MODE_CDMA:
995        case RILConstants.NETWORK_MODE_CDMA_NO_EVDO:
996        case RILConstants.NETWORK_MODE_EVDO_NO_CDMA:
997            return PhoneConstants.PHONE_TYPE_CDMA;
998
999        case RILConstants.NETWORK_MODE_WCDMA_PREF:
1000        case RILConstants.NETWORK_MODE_GSM_ONLY:
1001        case RILConstants.NETWORK_MODE_WCDMA_ONLY:
1002        case RILConstants.NETWORK_MODE_GSM_UMTS:
1003        case RILConstants.NETWORK_MODE_LTE_GSM_WCDMA:
1004        case RILConstants.NETWORK_MODE_LTE_WCDMA:
1005        case RILConstants.NETWORK_MODE_LTE_CDMA_EVDO_GSM_WCDMA:
1006            return PhoneConstants.PHONE_TYPE_GSM;
1007
1008        // Use CDMA Phone for the global mode including CDMA
1009        case RILConstants.NETWORK_MODE_GLOBAL:
1010        case RILConstants.NETWORK_MODE_LTE_CDMA_EVDO:
1011            return PhoneConstants.PHONE_TYPE_CDMA;
1012
1013        case RILConstants.NETWORK_MODE_LTE_ONLY:
1014            if (getLteOnCdmaModeStatic() == PhoneConstants.LTE_ON_CDMA_TRUE) {
1015                return PhoneConstants.PHONE_TYPE_CDMA;
1016            } else {
1017                return PhoneConstants.PHONE_TYPE_GSM;
1018            }
1019        default:
1020            return PhoneConstants.PHONE_TYPE_GSM;
1021        }
1022    }
1023
1024    /**
1025     * The contents of the /proc/cmdline file
1026     */
1027    private static String getProcCmdLine()
1028    {
1029        String cmdline = "";
1030        FileInputStream is = null;
1031        try {
1032            is = new FileInputStream("/proc/cmdline");
1033            byte [] buffer = new byte[2048];
1034            int count = is.read(buffer);
1035            if (count > 0) {
1036                cmdline = new String(buffer, 0, count);
1037            }
1038        } catch (IOException e) {
1039            Rlog.d(TAG, "No /proc/cmdline exception=" + e);
1040        } finally {
1041            if (is != null) {
1042                try {
1043                    is.close();
1044                } catch (IOException e) {
1045                }
1046            }
1047        }
1048        Rlog.d(TAG, "/proc/cmdline=" + cmdline);
1049        return cmdline;
1050    }
1051
1052    /** Kernel command line */
1053    private static final String sKernelCmdLine = getProcCmdLine();
1054
1055    /** Pattern for selecting the product type from the kernel command line */
1056    private static final Pattern sProductTypePattern =
1057        Pattern.compile("\\sproduct_type\\s*=\\s*(\\w+)");
1058
1059    /** The ProductType used for LTE on CDMA devices */
1060    private static final String sLteOnCdmaProductType =
1061        SystemProperties.get(TelephonyProperties.PROPERTY_LTE_ON_CDMA_PRODUCT_TYPE, "");
1062
1063    /**
1064     * Return if the current radio is LTE on CDMA. This
1065     * is a tri-state return value as for a period of time
1066     * the mode may be unknown.
1067     *
1068     * @return {@link PhoneConstants#LTE_ON_CDMA_UNKNOWN}, {@link PhoneConstants#LTE_ON_CDMA_FALSE}
1069     * or {@link PhoneConstants#LTE_ON_CDMA_TRUE}
1070     *
1071     * @hide
1072     */
1073    public static int getLteOnCdmaModeStatic() {
1074        int retVal;
1075        int curVal;
1076        String productType = "";
1077
1078        curVal = SystemProperties.getInt(TelephonyProperties.PROPERTY_LTE_ON_CDMA_DEVICE,
1079                    PhoneConstants.LTE_ON_CDMA_UNKNOWN);
1080        retVal = curVal;
1081        if (retVal == PhoneConstants.LTE_ON_CDMA_UNKNOWN) {
1082            Matcher matcher = sProductTypePattern.matcher(sKernelCmdLine);
1083            if (matcher.find()) {
1084                productType = matcher.group(1);
1085                if (sLteOnCdmaProductType.equals(productType)) {
1086                    retVal = PhoneConstants.LTE_ON_CDMA_TRUE;
1087                } else {
1088                    retVal = PhoneConstants.LTE_ON_CDMA_FALSE;
1089                }
1090            } else {
1091                retVal = PhoneConstants.LTE_ON_CDMA_FALSE;
1092            }
1093        }
1094
1095        Rlog.d(TAG, "getLteOnCdmaMode=" + retVal + " curVal=" + curVal +
1096                " product_type='" + productType +
1097                "' lteOnCdmaProductType='" + sLteOnCdmaProductType + "'");
1098        return retVal;
1099    }
1100
1101    //
1102    //
1103    // Current Network
1104    //
1105    //
1106
1107    /**
1108     * Returns the alphabetic name of current registered operator.
1109     * <p>
1110     * Availability: Only when user is registered to a network. Result may be
1111     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1112     * on a CDMA network).
1113     */
1114    public String getNetworkOperatorName() {
1115        return getNetworkOperatorName(getDefaultSubscription());
1116    }
1117
1118    /**
1119     * Returns the alphabetic name of current registered operator
1120     * for a particular subscription.
1121     * <p>
1122     * Availability: Only when user is registered to a network. Result may be
1123     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1124     * on a CDMA network).
1125     * @param subId
1126     */
1127    /** {@hide} */
1128    public String getNetworkOperatorName(int subId) {
1129        int phoneId = SubscriptionManager.getPhoneId(subId);
1130        return getTelephonyProperty(phoneId, TelephonyProperties.PROPERTY_OPERATOR_ALPHA, "");
1131    }
1132
1133    /**
1134     * Returns the numeric name (MCC+MNC) of current registered operator.
1135     * <p>
1136     * Availability: Only when user is registered to a network. Result may be
1137     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1138     * on a CDMA network).
1139     */
1140    public String getNetworkOperator() {
1141        return getNetworkOperatorForPhone(getDefaultPhone());
1142    }
1143
1144    /**
1145     * Returns the numeric name (MCC+MNC) of current registered operator
1146     * for a particular subscription.
1147     * <p>
1148     * Availability: Only when user is registered to a network. Result may be
1149     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1150     * on a CDMA network).
1151     *
1152     * @param subId
1153     */
1154    /** {@hide} */
1155   public String getNetworkOperatorForSubscription(int subId) {
1156        int phoneId = SubscriptionManager.getPhoneId(subId);
1157        return getNetworkOperatorForPhone(phoneId);
1158     }
1159
1160    /**
1161     * Returns the numeric name (MCC+MNC) of current registered operator
1162     * for a particular subscription.
1163     * <p>
1164     * Availability: Only when user is registered to a network. Result may be
1165     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1166     * on a CDMA network).
1167     *
1168     * @param phoneId
1169     * @hide
1170     **/
1171   public String getNetworkOperatorForPhone(int phoneId) {
1172        return getTelephonyProperty(phoneId, TelephonyProperties.PROPERTY_OPERATOR_NUMERIC, "");
1173     }
1174
1175    /**
1176     * Returns true if the device is considered roaming on the current
1177     * network, for GSM purposes.
1178     * <p>
1179     * Availability: Only when user registered to a network.
1180     */
1181    public boolean isNetworkRoaming() {
1182        return isNetworkRoaming(getDefaultSubscription());
1183    }
1184
1185    /**
1186     * Returns true if the device is considered roaming on the current
1187     * network for a subscription.
1188     * <p>
1189     * Availability: Only when user registered to a network.
1190     *
1191     * @param subId
1192     */
1193    /** {@hide} */
1194    public boolean isNetworkRoaming(int subId) {
1195        int phoneId = SubscriptionManager.getPhoneId(subId);
1196        return Boolean.parseBoolean(getTelephonyProperty(phoneId,
1197                TelephonyProperties.PROPERTY_OPERATOR_ISROAMING, null));
1198    }
1199
1200    /**
1201     * Returns the ISO country code equivalent of the current registered
1202     * operator's MCC (Mobile Country Code).
1203     * <p>
1204     * Availability: Only when user is registered to a network. Result may be
1205     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1206     * on a CDMA network).
1207     */
1208    public String getNetworkCountryIso() {
1209        return getNetworkCountryIsoForPhone(getDefaultPhone());
1210    }
1211
1212    /**
1213     * Returns the ISO country code equivalent of the current registered
1214     * operator's MCC (Mobile Country Code) of a subscription.
1215     * <p>
1216     * Availability: Only when user is registered to a network. Result may be
1217     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1218     * on a CDMA network).
1219     *
1220     * @param subId for which Network CountryIso is returned
1221     */
1222    /** {@hide} */
1223    public String getNetworkCountryIsoForSubscription(int subId) {
1224        int phoneId = SubscriptionManager.getPhoneId(subId);
1225        return getNetworkCountryIsoForPhone(phoneId);
1226    }
1227
1228    /**
1229     * Returns the ISO country code equivalent of the current registered
1230     * operator's MCC (Mobile Country Code) of a subscription.
1231     * <p>
1232     * Availability: Only when user is registered to a network. Result may be
1233     * unreliable on CDMA networks (use {@link #getPhoneType()} to determine if
1234     * on a CDMA network).
1235     *
1236     * @param phoneId for which Network CountryIso is returned
1237     */
1238    /** {@hide} */
1239    public String getNetworkCountryIsoForPhone(int phoneId) {
1240        return getTelephonyProperty(phoneId, TelephonyProperties.PROPERTY_OPERATOR_ISO_COUNTRY, "");
1241    }
1242
1243    /** Network type is unknown */
1244    public static final int NETWORK_TYPE_UNKNOWN = 0;
1245    /** Current network is GPRS */
1246    public static final int NETWORK_TYPE_GPRS = 1;
1247    /** Current network is EDGE */
1248    public static final int NETWORK_TYPE_EDGE = 2;
1249    /** Current network is UMTS */
1250    public static final int NETWORK_TYPE_UMTS = 3;
1251    /** Current network is CDMA: Either IS95A or IS95B*/
1252    public static final int NETWORK_TYPE_CDMA = 4;
1253    /** Current network is EVDO revision 0*/
1254    public static final int NETWORK_TYPE_EVDO_0 = 5;
1255    /** Current network is EVDO revision A*/
1256    public static final int NETWORK_TYPE_EVDO_A = 6;
1257    /** Current network is 1xRTT*/
1258    public static final int NETWORK_TYPE_1xRTT = 7;
1259    /** Current network is HSDPA */
1260    public static final int NETWORK_TYPE_HSDPA = 8;
1261    /** Current network is HSUPA */
1262    public static final int NETWORK_TYPE_HSUPA = 9;
1263    /** Current network is HSPA */
1264    public static final int NETWORK_TYPE_HSPA = 10;
1265    /** Current network is iDen */
1266    public static final int NETWORK_TYPE_IDEN = 11;
1267    /** Current network is EVDO revision B*/
1268    public static final int NETWORK_TYPE_EVDO_B = 12;
1269    /** Current network is LTE */
1270    public static final int NETWORK_TYPE_LTE = 13;
1271    /** Current network is eHRPD */
1272    public static final int NETWORK_TYPE_EHRPD = 14;
1273    /** Current network is HSPA+ */
1274    public static final int NETWORK_TYPE_HSPAP = 15;
1275    /** Current network is GSM {@hide} */
1276    public static final int NETWORK_TYPE_GSM = 16;
1277     /** Current network is TD_SCDMA {@hide} */
1278    public static final int NETWORK_TYPE_TD_SCDMA = 17;
1279   /** Current network is IWLAN {@hide} */
1280    public static final int NETWORK_TYPE_IWLAN = 18;
1281
1282    /**
1283     * @return the NETWORK_TYPE_xxxx for current data connection.
1284     */
1285    public int getNetworkType() {
1286        return getDataNetworkType();
1287    }
1288
1289    /**
1290     * Returns a constant indicating the radio technology (network type)
1291     * currently in use on the device for a subscription.
1292     * @return the network type
1293     *
1294     * @param subId for which network type is returned
1295     *
1296     * @see #NETWORK_TYPE_UNKNOWN
1297     * @see #NETWORK_TYPE_GPRS
1298     * @see #NETWORK_TYPE_EDGE
1299     * @see #NETWORK_TYPE_UMTS
1300     * @see #NETWORK_TYPE_HSDPA
1301     * @see #NETWORK_TYPE_HSUPA
1302     * @see #NETWORK_TYPE_HSPA
1303     * @see #NETWORK_TYPE_CDMA
1304     * @see #NETWORK_TYPE_EVDO_0
1305     * @see #NETWORK_TYPE_EVDO_A
1306     * @see #NETWORK_TYPE_EVDO_B
1307     * @see #NETWORK_TYPE_1xRTT
1308     * @see #NETWORK_TYPE_IDEN
1309     * @see #NETWORK_TYPE_LTE
1310     * @see #NETWORK_TYPE_EHRPD
1311     * @see #NETWORK_TYPE_HSPAP
1312     */
1313    /** {@hide} */
1314   public int getNetworkType(int subId) {
1315       try {
1316           ITelephony telephony = getITelephony();
1317           if (telephony != null) {
1318               return telephony.getNetworkTypeForSubscriber(subId);
1319           } else {
1320               // This can happen when the ITelephony interface is not up yet.
1321               return NETWORK_TYPE_UNKNOWN;
1322           }
1323       } catch(RemoteException ex) {
1324           // This shouldn't happen in the normal case
1325           return NETWORK_TYPE_UNKNOWN;
1326       } catch (NullPointerException ex) {
1327           // This could happen before phone restarts due to crashing
1328           return NETWORK_TYPE_UNKNOWN;
1329       }
1330   }
1331
1332    /**
1333     * Returns a constant indicating the radio technology (network type)
1334     * currently in use on the device for data transmission.
1335     * @return the network type
1336     *
1337     * @see #NETWORK_TYPE_UNKNOWN
1338     * @see #NETWORK_TYPE_GPRS
1339     * @see #NETWORK_TYPE_EDGE
1340     * @see #NETWORK_TYPE_UMTS
1341     * @see #NETWORK_TYPE_HSDPA
1342     * @see #NETWORK_TYPE_HSUPA
1343     * @see #NETWORK_TYPE_HSPA
1344     * @see #NETWORK_TYPE_CDMA
1345     * @see #NETWORK_TYPE_EVDO_0
1346     * @see #NETWORK_TYPE_EVDO_A
1347     * @see #NETWORK_TYPE_EVDO_B
1348     * @see #NETWORK_TYPE_1xRTT
1349     * @see #NETWORK_TYPE_IDEN
1350     * @see #NETWORK_TYPE_LTE
1351     * @see #NETWORK_TYPE_EHRPD
1352     * @see #NETWORK_TYPE_HSPAP
1353     *
1354     * @hide
1355     */
1356    public int getDataNetworkType() {
1357        return getDataNetworkType(getDefaultSubscription());
1358    }
1359
1360    /**
1361     * Returns a constant indicating the radio technology (network type)
1362     * currently in use on the device for data transmission for a subscription
1363     * @return the network type
1364     *
1365     * @param subId for which network type is returned
1366     */
1367    /** {@hide} */
1368    public int getDataNetworkType(int subId) {
1369        try{
1370            ITelephony telephony = getITelephony();
1371            if (telephony != null) {
1372                return telephony.getDataNetworkTypeForSubscriber(subId);
1373            } else {
1374                // This can happen when the ITelephony interface is not up yet.
1375                return NETWORK_TYPE_UNKNOWN;
1376            }
1377        } catch(RemoteException ex) {
1378            // This shouldn't happen in the normal case
1379            return NETWORK_TYPE_UNKNOWN;
1380        } catch (NullPointerException ex) {
1381            // This could happen before phone restarts due to crashing
1382            return NETWORK_TYPE_UNKNOWN;
1383        }
1384    }
1385
1386    /**
1387     * Returns the NETWORK_TYPE_xxxx for voice
1388     *
1389     * @hide
1390     */
1391    public int getVoiceNetworkType() {
1392        return getVoiceNetworkType(getDefaultSubscription());
1393    }
1394
1395    /**
1396     * Returns the NETWORK_TYPE_xxxx for voice for a subId
1397     *
1398     */
1399    /** {@hide} */
1400    public int getVoiceNetworkType(int subId) {
1401        try{
1402            ITelephony telephony = getITelephony();
1403            if (telephony != null) {
1404                return telephony.getVoiceNetworkTypeForSubscriber(subId);
1405            } else {
1406                // This can happen when the ITelephony interface is not up yet.
1407                return NETWORK_TYPE_UNKNOWN;
1408            }
1409        } catch(RemoteException ex) {
1410            // This shouldn't happen in the normal case
1411            return NETWORK_TYPE_UNKNOWN;
1412        } catch (NullPointerException ex) {
1413            // This could happen before phone restarts due to crashing
1414            return NETWORK_TYPE_UNKNOWN;
1415        }
1416    }
1417
1418    /** Unknown network class. {@hide} */
1419    public static final int NETWORK_CLASS_UNKNOWN = 0;
1420    /** Class of broadly defined "2G" networks. {@hide} */
1421    public static final int NETWORK_CLASS_2_G = 1;
1422    /** Class of broadly defined "3G" networks. {@hide} */
1423    public static final int NETWORK_CLASS_3_G = 2;
1424    /** Class of broadly defined "4G" networks. {@hide} */
1425    public static final int NETWORK_CLASS_4_G = 3;
1426
1427    /**
1428     * Return general class of network type, such as "3G" or "4G". In cases
1429     * where classification is contentious, this method is conservative.
1430     *
1431     * @hide
1432     */
1433    public static int getNetworkClass(int networkType) {
1434        switch (networkType) {
1435            case NETWORK_TYPE_GPRS:
1436            case NETWORK_TYPE_GSM:
1437            case NETWORK_TYPE_EDGE:
1438            case NETWORK_TYPE_CDMA:
1439            case NETWORK_TYPE_1xRTT:
1440            case NETWORK_TYPE_IDEN:
1441                return NETWORK_CLASS_2_G;
1442            case NETWORK_TYPE_UMTS:
1443            case NETWORK_TYPE_EVDO_0:
1444            case NETWORK_TYPE_EVDO_A:
1445            case NETWORK_TYPE_HSDPA:
1446            case NETWORK_TYPE_HSUPA:
1447            case NETWORK_TYPE_HSPA:
1448            case NETWORK_TYPE_EVDO_B:
1449            case NETWORK_TYPE_EHRPD:
1450            case NETWORK_TYPE_HSPAP:
1451            case NETWORK_TYPE_TD_SCDMA:
1452                return NETWORK_CLASS_3_G;
1453            case NETWORK_TYPE_LTE:
1454            case NETWORK_TYPE_IWLAN:
1455                return NETWORK_CLASS_4_G;
1456            default:
1457                return NETWORK_CLASS_UNKNOWN;
1458        }
1459    }
1460
1461    /**
1462     * Returns a string representation of the radio technology (network type)
1463     * currently in use on the device.
1464     * @return the name of the radio technology
1465     *
1466     * @hide pending API council review
1467     */
1468    public String getNetworkTypeName() {
1469        return getNetworkTypeName(getNetworkType());
1470    }
1471
1472    /**
1473     * Returns a string representation of the radio technology (network type)
1474     * currently in use on the device.
1475     * @param subId for which network type is returned
1476     * @return the name of the radio technology
1477     *
1478     */
1479    /** {@hide} */
1480    public static String getNetworkTypeName(int type) {
1481        switch (type) {
1482            case NETWORK_TYPE_GPRS:
1483                return "GPRS";
1484            case NETWORK_TYPE_EDGE:
1485                return "EDGE";
1486            case NETWORK_TYPE_UMTS:
1487                return "UMTS";
1488            case NETWORK_TYPE_HSDPA:
1489                return "HSDPA";
1490            case NETWORK_TYPE_HSUPA:
1491                return "HSUPA";
1492            case NETWORK_TYPE_HSPA:
1493                return "HSPA";
1494            case NETWORK_TYPE_CDMA:
1495                return "CDMA";
1496            case NETWORK_TYPE_EVDO_0:
1497                return "CDMA - EvDo rev. 0";
1498            case NETWORK_TYPE_EVDO_A:
1499                return "CDMA - EvDo rev. A";
1500            case NETWORK_TYPE_EVDO_B:
1501                return "CDMA - EvDo rev. B";
1502            case NETWORK_TYPE_1xRTT:
1503                return "CDMA - 1xRTT";
1504            case NETWORK_TYPE_LTE:
1505                return "LTE";
1506            case NETWORK_TYPE_EHRPD:
1507                return "CDMA - eHRPD";
1508            case NETWORK_TYPE_IDEN:
1509                return "iDEN";
1510            case NETWORK_TYPE_HSPAP:
1511                return "HSPA+";
1512            case NETWORK_TYPE_GSM:
1513                return "GSM";
1514            case NETWORK_TYPE_TD_SCDMA:
1515                return "TD_SCDMA";
1516            case NETWORK_TYPE_IWLAN:
1517                return "IWLAN";
1518            default:
1519                return "UNKNOWN";
1520        }
1521    }
1522
1523    //
1524    //
1525    // SIM Card
1526    //
1527    //
1528
1529    /**
1530     * SIM card state: Unknown. Signifies that the SIM is in transition
1531     * between states. For example, when the user inputs the SIM pin
1532     * under PIN_REQUIRED state, a query for sim status returns
1533     * this state before turning to SIM_STATE_READY.
1534     *
1535     * These are the ordinal value of IccCardConstants.State.
1536     */
1537    public static final int SIM_STATE_UNKNOWN = 0;
1538    /** SIM card state: no SIM card is available in the device */
1539    public static final int SIM_STATE_ABSENT = 1;
1540    /** SIM card state: Locked: requires the user's SIM PIN to unlock */
1541    public static final int SIM_STATE_PIN_REQUIRED = 2;
1542    /** SIM card state: Locked: requires the user's SIM PUK to unlock */
1543    public static final int SIM_STATE_PUK_REQUIRED = 3;
1544    /** SIM card state: Locked: requires a network PIN to unlock */
1545    public static final int SIM_STATE_NETWORK_LOCKED = 4;
1546    /** SIM card state: Ready */
1547    public static final int SIM_STATE_READY = 5;
1548    /** SIM card state: SIM Card is NOT READY
1549     *@hide
1550     */
1551    public static final int SIM_STATE_NOT_READY = 6;
1552    /** SIM card state: SIM Card Error, permanently disabled
1553     *@hide
1554     */
1555    public static final int SIM_STATE_PERM_DISABLED = 7;
1556    /** SIM card state: SIM Card Error, present but faulty
1557     *@hide
1558     */
1559    public static final int SIM_STATE_CARD_IO_ERROR = 8;
1560
1561    /**
1562     * @return true if a ICC card is present
1563     */
1564    public boolean hasIccCard() {
1565        return hasIccCard(getDefaultSim());
1566    }
1567
1568    /**
1569     * @return true if a ICC card is present for a subscription
1570     *
1571     * @param slotId for which icc card presence is checked
1572     */
1573    /** {@hide} */
1574    // FIXME Input argument slotId should be of type int
1575    public boolean hasIccCard(int slotId) {
1576
1577        try {
1578            ITelephony telephony = getITelephony();
1579            if (telephony == null)
1580                return false;
1581            return telephony.hasIccCardUsingSlotId(slotId);
1582        } catch (RemoteException ex) {
1583            // Assume no ICC card if remote exception which shouldn't happen
1584            return false;
1585        } catch (NullPointerException ex) {
1586            // This could happen before phone restarts due to crashing
1587            return false;
1588        }
1589    }
1590
1591    /**
1592     * Returns a constant indicating the state of the default SIM card.
1593     *
1594     * @see #SIM_STATE_UNKNOWN
1595     * @see #SIM_STATE_ABSENT
1596     * @see #SIM_STATE_PIN_REQUIRED
1597     * @see #SIM_STATE_PUK_REQUIRED
1598     * @see #SIM_STATE_NETWORK_LOCKED
1599     * @see #SIM_STATE_READY
1600     * @see #SIM_STATE_NOT_READY
1601     * @see #SIM_STATE_PERM_DISABLED
1602     * @see #SIM_STATE_CARD_IO_ERROR
1603     */
1604    public int getSimState() {
1605        return getSimState(getDefaultSim());
1606    }
1607
1608    /**
1609     * Returns a constant indicating the state of the device SIM card in a slot.
1610     *
1611     * @param slotIdx
1612     *
1613     * @see #SIM_STATE_UNKNOWN
1614     * @see #SIM_STATE_ABSENT
1615     * @see #SIM_STATE_PIN_REQUIRED
1616     * @see #SIM_STATE_PUK_REQUIRED
1617     * @see #SIM_STATE_NETWORK_LOCKED
1618     * @see #SIM_STATE_READY
1619     * @see #SIM_STATE_NOT_READY
1620     * @see #SIM_STATE_PERM_DISABLED
1621     * @see #SIM_STATE_CARD_IO_ERROR
1622     */
1623    /** {@hide} */
1624    public int getSimState(int slotIdx) {
1625        int[] subId = SubscriptionManager.getSubId(slotIdx);
1626        if (subId == null || subId.length == 0) {
1627            Rlog.d(TAG, "getSimState:- empty subId return SIM_STATE_ABSENT");
1628            return SIM_STATE_UNKNOWN;
1629        }
1630        int simState = SubscriptionManager.getSimStateForSubscriber(subId[0]);
1631        Rlog.d(TAG, "getSimState: simState=" + simState + " slotIdx=" + slotIdx);
1632        return simState;
1633    }
1634
1635    /**
1636     * Returns the MCC+MNC (mobile country code + mobile network code) of the
1637     * provider of the SIM. 5 or 6 decimal digits.
1638     * <p>
1639     * Availability: SIM state must be {@link #SIM_STATE_READY}
1640     *
1641     * @see #getSimState
1642     */
1643    public String getSimOperator() {
1644        return getSimOperatorNumeric();
1645    }
1646
1647    /**
1648     * Returns the MCC+MNC (mobile country code + mobile network code) of the
1649     * provider of the SIM. 5 or 6 decimal digits.
1650     * <p>
1651     * Availability: SIM state must be {@link #SIM_STATE_READY}
1652     *
1653     * @see #getSimState
1654     *
1655     * @param subId for which SimOperator is returned
1656     * @hide
1657     */
1658    public String getSimOperator(int subId) {
1659        return getSimOperatorNumericForSubscription(subId);
1660    }
1661
1662    /**
1663     * Returns the MCC+MNC (mobile country code + mobile network code) of the
1664     * provider of the SIM. 5 or 6 decimal digits.
1665     * <p>
1666     * Availability: SIM state must be {@link #SIM_STATE_READY}
1667     *
1668     * @see #getSimState
1669     * @hide
1670     */
1671    public String getSimOperatorNumeric() {
1672        int subId = SubscriptionManager.getDefaultDataSubId();
1673        if (!SubscriptionManager.isUsableSubIdValue(subId)) {
1674            subId = SubscriptionManager.getDefaultSmsSubId();
1675            if (!SubscriptionManager.isUsableSubIdValue(subId)) {
1676                subId = SubscriptionManager.getDefaultVoiceSubId();
1677                if (!SubscriptionManager.isUsableSubIdValue(subId)) {
1678                    subId = SubscriptionManager.getDefaultSubId();
1679                }
1680            }
1681        }
1682        Rlog.d(TAG, "getSimOperatorNumeric(): default subId=" + subId);
1683        return getSimOperatorNumericForSubscription(subId);
1684    }
1685
1686    /**
1687     * Returns the MCC+MNC (mobile country code + mobile network code) of the
1688     * provider of the SIM for a particular subscription. 5 or 6 decimal digits.
1689     * <p>
1690     * Availability: SIM state must be {@link #SIM_STATE_READY}
1691     *
1692     * @see #getSimState
1693     *
1694     * @param subId for which SimOperator is returned
1695     * @hide
1696     */
1697    public String getSimOperatorNumericForSubscription(int subId) {
1698        int phoneId = SubscriptionManager.getPhoneId(subId);
1699        return getSimOperatorNumericForPhone(phoneId);
1700    }
1701
1702   /**
1703     * Returns the MCC+MNC (mobile country code + mobile network code) of the
1704     * provider of the SIM for a particular subscription. 5 or 6 decimal digits.
1705     * <p>
1706     *
1707     * @param phoneId for which SimOperator is returned
1708     * @hide
1709     */
1710    public String getSimOperatorNumericForPhone(int phoneId) {
1711        return getTelephonyProperty(phoneId,
1712                TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC, "");
1713    }
1714
1715    /**
1716     * Returns the Service Provider Name (SPN).
1717     * <p>
1718     * Availability: SIM state must be {@link #SIM_STATE_READY}
1719     *
1720     * @see #getSimState
1721     */
1722    public String getSimOperatorName() {
1723        return getSimOperatorNameForPhone(getDefaultPhone());
1724    }
1725
1726    /**
1727     * Returns the Service Provider Name (SPN).
1728     * <p>
1729     * Availability: SIM state must be {@link #SIM_STATE_READY}
1730     *
1731     * @see #getSimState
1732     *
1733     * @param subId for which SimOperatorName is returned
1734     * @hide
1735     */
1736    public String getSimOperatorNameForSubscription(int subId) {
1737        int phoneId = SubscriptionManager.getPhoneId(subId);
1738        return getSimOperatorNameForPhone(phoneId);
1739    }
1740
1741    /**
1742     * Returns the Service Provider Name (SPN).
1743     *
1744     * @hide
1745     */
1746    public String getSimOperatorNameForPhone(int phoneId) {
1747         return getTelephonyProperty(phoneId,
1748                TelephonyProperties.PROPERTY_ICC_OPERATOR_ALPHA, "");
1749    }
1750
1751    /**
1752     * Returns the ISO country code equivalent for the SIM provider's country code.
1753     */
1754    public String getSimCountryIso() {
1755        return getSimCountryIsoForPhone(getDefaultPhone());
1756    }
1757
1758    /**
1759     * Returns the ISO country code equivalent for the SIM provider's country code.
1760     *
1761     * @param subId for which SimCountryIso is returned
1762     *
1763     * @hide
1764     */
1765    public String getSimCountryIso(int subId) {
1766        return getSimCountryIsoForSubscription(subId);
1767    }
1768
1769    /**
1770     * Returns the ISO country code equivalent for the SIM provider's country code.
1771     *
1772     * @param subId for which SimCountryIso is returned
1773     *
1774     * @hide
1775     */
1776    public String getSimCountryIsoForSubscription(int subId) {
1777        int phoneId = SubscriptionManager.getPhoneId(subId);
1778        return getSimCountryIsoForPhone(phoneId);
1779    }
1780
1781    /**
1782     * Returns the ISO country code equivalent for the SIM provider's country code.
1783     *
1784     * @hide
1785     */
1786    public String getSimCountryIsoForPhone(int phoneId) {
1787        return getTelephonyProperty(phoneId,
1788                TelephonyProperties.PROPERTY_ICC_OPERATOR_ISO_COUNTRY, "");
1789    }
1790
1791    /**
1792     * Returns the serial number of the SIM, if applicable. Return null if it is
1793     * unavailable.
1794     * <p>
1795     * Requires Permission:
1796     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1797     */
1798    public String getSimSerialNumber() {
1799         return getSimSerialNumber(getDefaultSubscription());
1800    }
1801
1802    /**
1803     * Returns the serial number for the given subscription, if applicable. Return null if it is
1804     * unavailable.
1805     * <p>
1806     * @param subId for which Sim Serial number is returned
1807     * Requires Permission:
1808     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1809     */
1810    /** {@hide} */
1811    public String getSimSerialNumber(int subId) {
1812        try {
1813            IPhoneSubInfo info = getSubscriberInfo();
1814            if (info == null)
1815                return null;
1816            return info.getIccSerialNumberForSubscriber(subId);
1817        } catch (RemoteException ex) {
1818            return null;
1819        } catch (NullPointerException ex) {
1820            // This could happen before phone restarts due to crashing
1821            return null;
1822        }
1823    }
1824
1825    /**
1826     * Return if the current radio is LTE on CDMA. This
1827     * is a tri-state return value as for a period of time
1828     * the mode may be unknown.
1829     *
1830     * @return {@link PhoneConstants#LTE_ON_CDMA_UNKNOWN}, {@link PhoneConstants#LTE_ON_CDMA_FALSE}
1831     * or {@link PhoneConstants#LTE_ON_CDMA_TRUE}
1832     *
1833     * @hide
1834     */
1835    public int getLteOnCdmaMode() {
1836        return getLteOnCdmaMode(getDefaultSubscription());
1837    }
1838
1839    /**
1840     * Return if the current radio is LTE on CDMA for Subscription. This
1841     * is a tri-state return value as for a period of time
1842     * the mode may be unknown.
1843     *
1844     * @param subId for which radio is LTE on CDMA is returned
1845     * @return {@link PhoneConstants#LTE_ON_CDMA_UNKNOWN}, {@link PhoneConstants#LTE_ON_CDMA_FALSE}
1846     * or {@link PhoneConstants#LTE_ON_CDMA_TRUE}
1847     *
1848     */
1849    /** {@hide} */
1850    public int getLteOnCdmaMode(int subId) {
1851        try {
1852            ITelephony telephony = getITelephony();
1853            if (telephony == null)
1854                return PhoneConstants.LTE_ON_CDMA_UNKNOWN;
1855            return telephony.getLteOnCdmaModeForSubscriber(subId);
1856        } catch (RemoteException ex) {
1857            // Assume no ICC card if remote exception which shouldn't happen
1858            return PhoneConstants.LTE_ON_CDMA_UNKNOWN;
1859        } catch (NullPointerException ex) {
1860            // This could happen before phone restarts due to crashing
1861            return PhoneConstants.LTE_ON_CDMA_UNKNOWN;
1862        }
1863    }
1864
1865    //
1866    //
1867    // Subscriber Info
1868    //
1869    //
1870
1871    /**
1872     * Returns the unique subscriber ID, for example, the IMSI for a GSM phone.
1873     * Return null if it is unavailable.
1874     * <p>
1875     * Requires Permission:
1876     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1877     */
1878    public String getSubscriberId() {
1879        return getSubscriberId(getDefaultSubscription());
1880    }
1881
1882    /**
1883     * Returns the unique subscriber ID, for example, the IMSI for a GSM phone
1884     * for a subscription.
1885     * Return null if it is unavailable.
1886     * <p>
1887     * Requires Permission:
1888     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1889     *
1890     * @param subId whose subscriber id is returned
1891     */
1892    /** {@hide} */
1893    public String getSubscriberId(int subId) {
1894        try {
1895            IPhoneSubInfo info = getSubscriberInfo();
1896            if (info == null)
1897                return null;
1898            return info.getSubscriberIdForSubscriber(subId);
1899        } catch (RemoteException ex) {
1900            return null;
1901        } catch (NullPointerException ex) {
1902            // This could happen before phone restarts due to crashing
1903            return null;
1904        }
1905    }
1906
1907    /**
1908     * Returns the Group Identifier Level1 for a GSM phone.
1909     * Return null if it is unavailable.
1910     * <p>
1911     * Requires Permission:
1912     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1913     */
1914    public String getGroupIdLevel1() {
1915        try {
1916            IPhoneSubInfo info = getSubscriberInfo();
1917            if (info == null)
1918                return null;
1919            return info.getGroupIdLevel1();
1920        } catch (RemoteException ex) {
1921            return null;
1922        } catch (NullPointerException ex) {
1923            // This could happen before phone restarts due to crashing
1924            return null;
1925        }
1926    }
1927
1928    /**
1929     * Returns the Group Identifier Level1 for a GSM phone for a particular subscription.
1930     * Return null if it is unavailable.
1931     * <p>
1932     * Requires Permission:
1933     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1934     *
1935     * @param subscription whose subscriber id is returned
1936     */
1937    /** {@hide} */
1938    public String getGroupIdLevel1(int subId) {
1939        try {
1940            IPhoneSubInfo info = getSubscriberInfo();
1941            if (info == null)
1942                return null;
1943            return info.getGroupIdLevel1ForSubscriber(subId);
1944        } catch (RemoteException ex) {
1945            return null;
1946        } catch (NullPointerException ex) {
1947            // This could happen before phone restarts due to crashing
1948            return null;
1949        }
1950    }
1951
1952    /**
1953     * Returns the phone number string for line 1, for example, the MSISDN
1954     * for a GSM phone. Return null if it is unavailable.
1955     * <p>
1956     * Requires Permission:
1957     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1958     */
1959    public String getLine1Number() {
1960        return getLine1NumberForSubscriber(getDefaultSubscription());
1961    }
1962
1963    /**
1964     * Returns the phone number string for line 1, for example, the MSISDN
1965     * for a GSM phone for a particular subscription. Return null if it is unavailable.
1966     * <p>
1967     * Requires Permission:
1968     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
1969     *
1970     * @param subId whose phone number for line 1 is returned
1971     */
1972    /** {@hide} */
1973    public String getLine1NumberForSubscriber(int subId) {
1974        String number = null;
1975        try {
1976            ITelephony telephony = getITelephony();
1977            if (telephony != null)
1978                number = telephony.getLine1NumberForDisplay(subId, mContext.getOpPackageName());
1979        } catch (RemoteException ex) {
1980        } catch (NullPointerException ex) {
1981        }
1982        if (number != null) {
1983            return number;
1984        }
1985        try {
1986            IPhoneSubInfo info = getSubscriberInfo();
1987            if (info == null)
1988                return null;
1989            return info.getLine1NumberForSubscriber(subId);
1990        } catch (RemoteException ex) {
1991            return null;
1992        } catch (NullPointerException ex) {
1993            // This could happen before phone restarts due to crashing
1994            return null;
1995        }
1996    }
1997
1998    /**
1999     * Set the line 1 phone number string and its alphatag for the current ICCID
2000     * for display purpose only, for example, displayed in Phone Status. It won't
2001     * change the actual MSISDN/MDN. To unset alphatag or number, pass in a null
2002     * value.
2003     *
2004     * <p>Requires that the calling app has carrier privileges.
2005     * @see #hasCarrierPrivileges
2006     *
2007     * @param alphaTag alpha-tagging of the dailing nubmer
2008     * @param number The dialing number
2009     * @return true if the operation was executed correctly.
2010     */
2011    public boolean setLine1NumberForDisplay(String alphaTag, String number) {
2012        return setLine1NumberForDisplayForSubscriber(getDefaultSubscription(), alphaTag, number);
2013    }
2014
2015    /**
2016     * Set the line 1 phone number string and its alphatag for the current ICCID
2017     * for display purpose only, for example, displayed in Phone Status. It won't
2018     * change the actual MSISDN/MDN. To unset alphatag or number, pass in a null
2019     * value.
2020     *
2021     * <p>Requires that the calling app has carrier privileges.
2022     * @see #hasCarrierPrivileges
2023     *
2024     * @param subId the subscriber that the alphatag and dialing number belongs to.
2025     * @param alphaTag alpha-tagging of the dailing nubmer
2026     * @param number The dialing number
2027     * @return true if the operation was executed correctly.
2028     * @hide
2029     */
2030    public boolean setLine1NumberForDisplayForSubscriber(int subId, String alphaTag, String number) {
2031        try {
2032            ITelephony telephony = getITelephony();
2033            if (telephony != null)
2034                return telephony.setLine1NumberForDisplayForSubscriber(subId, alphaTag, number);
2035        } catch (RemoteException ex) {
2036        } catch (NullPointerException ex) {
2037        }
2038        return false;
2039    }
2040
2041    /**
2042     * Informs the system of an intentional upcoming carrier network change by
2043     * a carrier app. This call is optional and is only used to allow the
2044     * system to provide alternative UI while telephony is performing an action
2045     * that may result in intentional, temporary network lack of connectivity.
2046     * <p>
2047     * Based on the active parameter passed in, this method will either show or
2048     * hide the alternative UI. There is no timeout associated with showing
2049     * this UX, so a carrier app must be sure to call with active set to false
2050     * sometime after calling with it set to true.
2051     * <p>
2052     * Requires Permission:
2053     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2054     * Or the calling app has carrier privileges.
2055     *   @see #hasCarrierPrivileges
2056     *
2057     * @param active Whether the carrier network change is or shortly will be
2058     *               active. Set this value to true to begin showing
2059     *               alternative UI and false to stop.
2060     */
2061    public void notifyCarrierNetworkChange(boolean active) {
2062        try {
2063            if (sRegistry != null)
2064                sRegistry.notifyCarrierNetworkChange(active);
2065        } catch (RemoteException ex) {
2066        } catch (NullPointerException ex) {
2067        }
2068    }
2069
2070    /**
2071     * Returns the alphabetic identifier associated with the line 1 number.
2072     * Return null if it is unavailable.
2073     * <p>
2074     * Requires Permission:
2075     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2076     * @hide
2077     * nobody seems to call this.
2078     */
2079    public String getLine1AlphaTag() {
2080        return getLine1AlphaTagForSubscriber(getDefaultSubscription());
2081    }
2082
2083    /**
2084     * Returns the alphabetic identifier associated with the line 1 number
2085     * for a subscription.
2086     * Return null if it is unavailable.
2087     * <p>
2088     * Requires Permission:
2089     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2090     * @param subId whose alphabetic identifier associated with line 1 is returned
2091     * nobody seems to call this.
2092     */
2093    /** {@hide} */
2094    public String getLine1AlphaTagForSubscriber(int subId) {
2095        String alphaTag = null;
2096        try {
2097            ITelephony telephony = getITelephony();
2098            if (telephony != null)
2099                alphaTag = telephony.getLine1AlphaTagForDisplay(subId,
2100                        mContext.getOpPackageName());
2101        } catch (RemoteException ex) {
2102        } catch (NullPointerException ex) {
2103        }
2104        if (alphaTag != null) {
2105            return alphaTag;
2106        }
2107        try {
2108            IPhoneSubInfo info = getSubscriberInfo();
2109            if (info == null)
2110                return null;
2111            return info.getLine1AlphaTagForSubscriber(subId);
2112        } catch (RemoteException ex) {
2113            return null;
2114        } catch (NullPointerException ex) {
2115            // This could happen before phone restarts due to crashing
2116            return null;
2117        }
2118    }
2119
2120    /**
2121     * Return the set of subscriber IDs that should be considered as "merged
2122     * together" for data usage purposes. This is commonly {@code null} to
2123     * indicate no merging is required. Any returned subscribers are sorted in a
2124     * deterministic order.
2125     *
2126     * @hide
2127     */
2128    public @Nullable String[] getMergedSubscriberIds() {
2129        try {
2130            ITelephony telephony = getITelephony();
2131            if (telephony != null)
2132                return telephony.getMergedSubscriberIds();
2133        } catch (RemoteException ex) {
2134        } catch (NullPointerException ex) {
2135        }
2136        return null;
2137    }
2138
2139    /**
2140     * Returns the MSISDN string.
2141     * for a GSM phone. Return null if it is unavailable.
2142     * <p>
2143     * Requires Permission:
2144     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2145     *
2146     * @hide
2147     */
2148    public String getMsisdn() {
2149        return getMsisdn(getDefaultSubscription());
2150    }
2151
2152    /**
2153     * Returns the MSISDN string.
2154     * for a GSM phone. Return null if it is unavailable.
2155     * <p>
2156     * Requires Permission:
2157     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2158     *
2159     * @param subId for which msisdn is returned
2160     */
2161    /** {@hide} */
2162    public String getMsisdn(int subId) {
2163        try {
2164            IPhoneSubInfo info = getSubscriberInfo();
2165            if (info == null)
2166                return null;
2167            return info.getMsisdnForSubscriber(subId);
2168        } catch (RemoteException ex) {
2169            return null;
2170        } catch (NullPointerException ex) {
2171            // This could happen before phone restarts due to crashing
2172            return null;
2173        }
2174    }
2175
2176    /**
2177     * Returns the voice mail number. Return null if it is unavailable.
2178     * <p>
2179     * Requires Permission:
2180     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2181     */
2182    public String getVoiceMailNumber() {
2183        return getVoiceMailNumber(getDefaultSubscription());
2184    }
2185
2186    /**
2187     * Returns the voice mail number for a subscription.
2188     * Return null if it is unavailable.
2189     * <p>
2190     * Requires Permission:
2191     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2192     * @param subId whose voice mail number is returned
2193     */
2194    /** {@hide} */
2195    public String getVoiceMailNumber(int subId) {
2196        try {
2197            IPhoneSubInfo info = getSubscriberInfo();
2198            if (info == null)
2199                return null;
2200            return info.getVoiceMailNumberForSubscriber(subId);
2201        } catch (RemoteException ex) {
2202            return null;
2203        } catch (NullPointerException ex) {
2204            // This could happen before phone restarts due to crashing
2205            return null;
2206        }
2207    }
2208
2209    /**
2210     * Returns the complete voice mail number. Return null if it is unavailable.
2211     * <p>
2212     * Requires Permission:
2213     *   {@link android.Manifest.permission#CALL_PRIVILEGED CALL_PRIVILEGED}
2214     *
2215     * @hide
2216     */
2217    public String getCompleteVoiceMailNumber() {
2218        return getCompleteVoiceMailNumber(getDefaultSubscription());
2219    }
2220
2221    /**
2222     * Returns the complete voice mail number. Return null if it is unavailable.
2223     * <p>
2224     * Requires Permission:
2225     *   {@link android.Manifest.permission#CALL_PRIVILEGED CALL_PRIVILEGED}
2226     *
2227     * @param subId
2228     */
2229    /** {@hide} */
2230    public String getCompleteVoiceMailNumber(int subId) {
2231        try {
2232            IPhoneSubInfo info = getSubscriberInfo();
2233            if (info == null)
2234                return null;
2235            return info.getCompleteVoiceMailNumberForSubscriber(subId);
2236        } catch (RemoteException ex) {
2237            return null;
2238        } catch (NullPointerException ex) {
2239            // This could happen before phone restarts due to crashing
2240            return null;
2241        }
2242    }
2243
2244    /**
2245     * Sets the voice mail number.
2246     *
2247     * <p>Requires that the calling app has carrier privileges.
2248     * @see #hasCarrierPrivileges
2249     *
2250     * @param alphaTag The alpha tag to display.
2251     * @param number The voicemail number.
2252     */
2253    public boolean setVoiceMailNumber(String alphaTag, String number) {
2254        return setVoiceMailNumber(getDefaultSubscription(), alphaTag, number);
2255    }
2256
2257    /**
2258     * Sets the voicemail number for the given subscriber.
2259     *
2260     * <p>Requires that the calling app has carrier privileges.
2261     * @see #hasCarrierPrivileges
2262     *
2263     * @param subId The subscription id.
2264     * @param alphaTag The alpha tag to display.
2265     * @param number The voicemail number.
2266     */
2267    /** {@hide} */
2268    public boolean setVoiceMailNumber(int subId, String alphaTag, String number) {
2269        try {
2270            ITelephony telephony = getITelephony();
2271            if (telephony != null)
2272                return telephony.setVoiceMailNumber(subId, alphaTag, number);
2273        } catch (RemoteException ex) {
2274        } catch (NullPointerException ex) {
2275        }
2276        return false;
2277    }
2278
2279    /**
2280     * Returns the voice mail count. Return 0 if unavailable.
2281     * <p>
2282     * Requires Permission:
2283     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2284     * @hide
2285     */
2286    public int getVoiceMessageCount() {
2287        return getVoiceMessageCount(getDefaultSubscription());
2288    }
2289
2290    /**
2291     * Returns the voice mail count for a subscription. Return 0 if unavailable.
2292     * <p>
2293     * Requires Permission:
2294     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2295     * @param subId whose voice message count is returned
2296     */
2297    /** {@hide} */
2298    public int getVoiceMessageCount(int subId) {
2299        try {
2300            ITelephony telephony = getITelephony();
2301            if (telephony == null)
2302                return 0;
2303            return telephony.getVoiceMessageCountForSubscriber(subId);
2304        } catch (RemoteException ex) {
2305            return 0;
2306        } catch (NullPointerException ex) {
2307            // This could happen before phone restarts due to crashing
2308            return 0;
2309        }
2310    }
2311
2312    /**
2313     * Retrieves the alphabetic identifier associated with the voice
2314     * mail number.
2315     * <p>
2316     * Requires Permission:
2317     *   {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2318     */
2319    public String getVoiceMailAlphaTag() {
2320        return getVoiceMailAlphaTag(getDefaultSubscription());
2321    }
2322
2323    /**
2324     * Retrieves the alphabetic identifier associated with the voice
2325     * mail number for a subscription.
2326     * <p>
2327     * Requires Permission:
2328     * {@link android.Manifest.permission#READ_PHONE_STATE READ_PHONE_STATE}
2329     * @param subId whose alphabetic identifier associated with the
2330     * voice mail number is returned
2331     */
2332    /** {@hide} */
2333    public String getVoiceMailAlphaTag(int subId) {
2334        try {
2335            IPhoneSubInfo info = getSubscriberInfo();
2336            if (info == null)
2337                return null;
2338            return info.getVoiceMailAlphaTagForSubscriber(subId);
2339        } catch (RemoteException ex) {
2340            return null;
2341        } catch (NullPointerException ex) {
2342            // This could happen before phone restarts due to crashing
2343            return null;
2344        }
2345    }
2346
2347    /**
2348     * Returns the IMS private user identity (IMPI) that was loaded from the ISIM.
2349     * @return the IMPI, or null if not present or not loaded
2350     * @hide
2351     */
2352    public String getIsimImpi() {
2353        try {
2354            IPhoneSubInfo info = getSubscriberInfo();
2355            if (info == null)
2356                return null;
2357            return info.getIsimImpi();
2358        } catch (RemoteException ex) {
2359            return null;
2360        } catch (NullPointerException ex) {
2361            // This could happen before phone restarts due to crashing
2362            return null;
2363        }
2364    }
2365
2366    /**
2367     * Returns the IMS home network domain name that was loaded from the ISIM.
2368     * @return the IMS domain name, or null if not present or not loaded
2369     * @hide
2370     */
2371    public String getIsimDomain() {
2372        try {
2373            IPhoneSubInfo info = getSubscriberInfo();
2374            if (info == null)
2375                return null;
2376            return info.getIsimDomain();
2377        } catch (RemoteException ex) {
2378            return null;
2379        } catch (NullPointerException ex) {
2380            // This could happen before phone restarts due to crashing
2381            return null;
2382        }
2383    }
2384
2385    /**
2386     * Returns the IMS public user identities (IMPU) that were loaded from the ISIM.
2387     * @return an array of IMPU strings, with one IMPU per string, or null if
2388     *      not present or not loaded
2389     * @hide
2390     */
2391    public String[] getIsimImpu() {
2392        try {
2393            IPhoneSubInfo info = getSubscriberInfo();
2394            if (info == null)
2395                return null;
2396            return info.getIsimImpu();
2397        } catch (RemoteException ex) {
2398            return null;
2399        } catch (NullPointerException ex) {
2400            // This could happen before phone restarts due to crashing
2401            return null;
2402        }
2403    }
2404
2405   /**
2406    * @hide
2407    */
2408    private IPhoneSubInfo getSubscriberInfo() {
2409        // get it each time because that process crashes a lot
2410        return IPhoneSubInfo.Stub.asInterface(ServiceManager.getService("iphonesubinfo"));
2411    }
2412
2413    /** Device call state: No activity. */
2414    public static final int CALL_STATE_IDLE = 0;
2415    /** Device call state: Ringing. A new call arrived and is
2416     *  ringing or waiting. In the latter case, another call is
2417     *  already active. */
2418    public static final int CALL_STATE_RINGING = 1;
2419    /** Device call state: Off-hook. At least one call exists
2420      * that is dialing, active, or on hold, and no calls are ringing
2421      * or waiting. */
2422    public static final int CALL_STATE_OFFHOOK = 2;
2423
2424    /**
2425     * Returns a constant indicating the call state (cellular) on the device.
2426     */
2427    public int getCallState() {
2428        return getCallState(getDefaultSubscription());
2429    }
2430
2431    /**
2432     * Returns a constant indicating the call state (cellular) on the device
2433     * for a subscription.
2434     *
2435     * @param subId whose call state is returned
2436     */
2437    /** {@hide} */
2438    public int getCallState(int subId) {
2439        try {
2440            ITelephony telephony = getITelephony();
2441            if (telephony == null)
2442                return CALL_STATE_IDLE;
2443            return telephony.getCallStateForSubscriber(subId);
2444        } catch (RemoteException ex) {
2445            // the phone process is restarting.
2446            return CALL_STATE_IDLE;
2447        } catch (NullPointerException ex) {
2448          // the phone process is restarting.
2449          return CALL_STATE_IDLE;
2450      }
2451    }
2452
2453    /** Data connection activity: No traffic. */
2454    public static final int DATA_ACTIVITY_NONE = 0x00000000;
2455    /** Data connection activity: Currently receiving IP PPP traffic. */
2456    public static final int DATA_ACTIVITY_IN = 0x00000001;
2457    /** Data connection activity: Currently sending IP PPP traffic. */
2458    public static final int DATA_ACTIVITY_OUT = 0x00000002;
2459    /** Data connection activity: Currently both sending and receiving
2460     *  IP PPP traffic. */
2461    public static final int DATA_ACTIVITY_INOUT = DATA_ACTIVITY_IN | DATA_ACTIVITY_OUT;
2462    /**
2463     * Data connection is active, but physical link is down
2464     */
2465    public static final int DATA_ACTIVITY_DORMANT = 0x00000004;
2466
2467    /**
2468     * Returns a constant indicating the type of activity on a data connection
2469     * (cellular).
2470     *
2471     * @see #DATA_ACTIVITY_NONE
2472     * @see #DATA_ACTIVITY_IN
2473     * @see #DATA_ACTIVITY_OUT
2474     * @see #DATA_ACTIVITY_INOUT
2475     * @see #DATA_ACTIVITY_DORMANT
2476     */
2477    public int getDataActivity() {
2478        try {
2479            ITelephony telephony = getITelephony();
2480            if (telephony == null)
2481                return DATA_ACTIVITY_NONE;
2482            return telephony.getDataActivity();
2483        } catch (RemoteException ex) {
2484            // the phone process is restarting.
2485            return DATA_ACTIVITY_NONE;
2486        } catch (NullPointerException ex) {
2487          // the phone process is restarting.
2488          return DATA_ACTIVITY_NONE;
2489      }
2490    }
2491
2492    /** Data connection state: Unknown.  Used before we know the state.
2493     * @hide
2494     */
2495    public static final int DATA_UNKNOWN        = -1;
2496    /** Data connection state: Disconnected. IP traffic not available. */
2497    public static final int DATA_DISCONNECTED   = 0;
2498    /** Data connection state: Currently setting up a data connection. */
2499    public static final int DATA_CONNECTING     = 1;
2500    /** Data connection state: Connected. IP traffic should be available. */
2501    public static final int DATA_CONNECTED      = 2;
2502    /** Data connection state: Suspended. The connection is up, but IP
2503     * traffic is temporarily unavailable. For example, in a 2G network,
2504     * data activity may be suspended when a voice call arrives. */
2505    public static final int DATA_SUSPENDED      = 3;
2506
2507    /**
2508     * Returns a constant indicating the current data connection state
2509     * (cellular).
2510     *
2511     * @see #DATA_DISCONNECTED
2512     * @see #DATA_CONNECTING
2513     * @see #DATA_CONNECTED
2514     * @see #DATA_SUSPENDED
2515     */
2516    public int getDataState() {
2517        try {
2518            ITelephony telephony = getITelephony();
2519            if (telephony == null)
2520                return DATA_DISCONNECTED;
2521            return telephony.getDataState();
2522        } catch (RemoteException ex) {
2523            // the phone process is restarting.
2524            return DATA_DISCONNECTED;
2525        } catch (NullPointerException ex) {
2526            return DATA_DISCONNECTED;
2527        }
2528    }
2529
2530   /**
2531    * @hide
2532    */
2533    private ITelephony getITelephony() {
2534        return ITelephony.Stub.asInterface(ServiceManager.getService(Context.TELEPHONY_SERVICE));
2535    }
2536
2537    /**
2538    * @hide
2539    */
2540    private ITelecomService getTelecomService() {
2541        return ITelecomService.Stub.asInterface(ServiceManager.getService(Context.TELECOM_SERVICE));
2542    }
2543
2544    //
2545    //
2546    // PhoneStateListener
2547    //
2548    //
2549
2550    /**
2551     * Registers a listener object to receive notification of changes
2552     * in specified telephony states.
2553     * <p>
2554     * To register a listener, pass a {@link PhoneStateListener}
2555     * and specify at least one telephony state of interest in
2556     * the events argument.
2557     *
2558     * At registration, and when a specified telephony state
2559     * changes, the telephony manager invokes the appropriate
2560     * callback method on the listener object and passes the
2561     * current (updated) values.
2562     * <p>
2563     * To unregister a listener, pass the listener object and set the
2564     * events argument to
2565     * {@link PhoneStateListener#LISTEN_NONE LISTEN_NONE} (0).
2566     *
2567     * @param listener The {@link PhoneStateListener} object to register
2568     *                 (or unregister)
2569     * @param events The telephony state(s) of interest to the listener,
2570     *               as a bitwise-OR combination of {@link PhoneStateListener}
2571     *               LISTEN_ flags.
2572     */
2573    public void listen(PhoneStateListener listener, int events) {
2574        if (mContext == null) return;
2575        try {
2576            Boolean notifyNow = (getITelephony() != null);
2577            sRegistry.listenForSubscriber(listener.mSubId, mContext.getOpPackageName(),
2578                    listener.callback, events, notifyNow);
2579        } catch (RemoteException ex) {
2580            // system process dead
2581        } catch (NullPointerException ex) {
2582            // system process dead
2583        }
2584    }
2585
2586    /**
2587     * Returns the CDMA ERI icon index to display
2588     *
2589     * @hide
2590     */
2591    public int getCdmaEriIconIndex() {
2592        return getCdmaEriIconIndex(getDefaultSubscription());
2593    }
2594
2595    /**
2596     * Returns the CDMA ERI icon index to display for a subscription
2597     */
2598    /** {@hide} */
2599    public int getCdmaEriIconIndex(int subId) {
2600        try {
2601            ITelephony telephony = getITelephony();
2602            if (telephony == null)
2603                return -1;
2604            return telephony.getCdmaEriIconIndexForSubscriber(subId);
2605        } catch (RemoteException ex) {
2606            // the phone process is restarting.
2607            return -1;
2608        } catch (NullPointerException ex) {
2609            return -1;
2610        }
2611    }
2612
2613    /**
2614     * Returns the CDMA ERI icon mode,
2615     * 0 - ON
2616     * 1 - FLASHING
2617     *
2618     * @hide
2619     */
2620    public int getCdmaEriIconMode() {
2621        return getCdmaEriIconMode(getDefaultSubscription());
2622    }
2623
2624    /**
2625     * Returns the CDMA ERI icon mode for a subscription.
2626     * 0 - ON
2627     * 1 - FLASHING
2628     */
2629    /** {@hide} */
2630    public int getCdmaEriIconMode(int subId) {
2631        try {
2632            ITelephony telephony = getITelephony();
2633            if (telephony == null)
2634                return -1;
2635            return telephony.getCdmaEriIconModeForSubscriber(subId);
2636        } catch (RemoteException ex) {
2637            // the phone process is restarting.
2638            return -1;
2639        } catch (NullPointerException ex) {
2640            return -1;
2641        }
2642    }
2643
2644    /**
2645     * Returns the CDMA ERI text,
2646     *
2647     * @hide
2648     */
2649    public String getCdmaEriText() {
2650        return getCdmaEriText(getDefaultSubscription());
2651    }
2652
2653    /**
2654     * Returns the CDMA ERI text, of a subscription
2655     *
2656     */
2657    /** {@hide} */
2658    public String getCdmaEriText(int subId) {
2659        try {
2660            ITelephony telephony = getITelephony();
2661            if (telephony == null)
2662                return null;
2663            return telephony.getCdmaEriTextForSubscriber(subId);
2664        } catch (RemoteException ex) {
2665            // the phone process is restarting.
2666            return null;
2667        } catch (NullPointerException ex) {
2668            return null;
2669        }
2670    }
2671
2672    /**
2673     * @return true if the current device is "voice capable".
2674     * <p>
2675     * "Voice capable" means that this device supports circuit-switched
2676     * (i.e. voice) phone calls over the telephony network, and is allowed
2677     * to display the in-call UI while a cellular voice call is active.
2678     * This will be false on "data only" devices which can't make voice
2679     * calls and don't support any in-call UI.
2680     * <p>
2681     * Note: the meaning of this flag is subtly different from the
2682     * PackageManager.FEATURE_TELEPHONY system feature, which is available
2683     * on any device with a telephony radio, even if the device is
2684     * data-only.
2685     */
2686    public boolean isVoiceCapable() {
2687        if (mContext == null) return true;
2688        return mContext.getResources().getBoolean(
2689                com.android.internal.R.bool.config_voice_capable);
2690    }
2691
2692    /**
2693     * @return true if the current device supports sms service.
2694     * <p>
2695     * If true, this means that the device supports both sending and
2696     * receiving sms via the telephony network.
2697     * <p>
2698     * Note: Voicemail waiting sms, cell broadcasting sms, and MMS are
2699     *       disabled when device doesn't support sms.
2700     */
2701    public boolean isSmsCapable() {
2702        if (mContext == null) return true;
2703        return mContext.getResources().getBoolean(
2704                com.android.internal.R.bool.config_sms_capable);
2705    }
2706
2707    /**
2708     * Returns all observed cell information from all radios on the
2709     * device including the primary and neighboring cells. This does
2710     * not cause or change the rate of PhoneStateListner#onCellInfoChanged.
2711     *<p>
2712     * The list can include one or more of {@link android.telephony.CellInfoGsm CellInfoGsm},
2713     * {@link android.telephony.CellInfoCdma CellInfoCdma},
2714     * {@link android.telephony.CellInfoLte CellInfoLte} and
2715     * {@link android.telephony.CellInfoWcdma CellInfoCdma} in any combination.
2716     * Specifically on devices with multiple radios it is typical to see instances of
2717     * one or more of any these in the list. In addition 0, 1 or more CellInfo
2718     * objects may return isRegistered() true.
2719     *<p>
2720     * This is preferred over using getCellLocation although for older
2721     * devices this may return null in which case getCellLocation should
2722     * be called.
2723     *<p>
2724     * @return List of CellInfo or null if info unavailable.
2725     *
2726     * <p>Requires Permission: {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}
2727     */
2728    public List<CellInfo> getAllCellInfo() {
2729        try {
2730            ITelephony telephony = getITelephony();
2731            if (telephony == null)
2732                return null;
2733            return telephony.getAllCellInfo(mContext.getOpPackageName());
2734        } catch (RemoteException ex) {
2735            return null;
2736        } catch (NullPointerException ex) {
2737            return null;
2738        }
2739    }
2740
2741    /**
2742     * Sets the minimum time in milli-seconds between {@link PhoneStateListener#onCellInfoChanged
2743     * PhoneStateListener.onCellInfoChanged} will be invoked.
2744     *<p>
2745     * The default, 0, means invoke onCellInfoChanged when any of the reported
2746     * information changes. Setting the value to INT_MAX(0x7fffffff) means never issue
2747     * A onCellInfoChanged.
2748     *<p>
2749     * @param rateInMillis the rate
2750     *
2751     * @hide
2752     */
2753    public void setCellInfoListRate(int rateInMillis) {
2754        try {
2755            ITelephony telephony = getITelephony();
2756            if (telephony != null)
2757                telephony.setCellInfoListRate(rateInMillis);
2758        } catch (RemoteException ex) {
2759        } catch (NullPointerException ex) {
2760        }
2761    }
2762
2763    /**
2764     * Returns the MMS user agent.
2765     */
2766    public String getMmsUserAgent() {
2767        if (mContext == null) return null;
2768        return mContext.getResources().getString(
2769                com.android.internal.R.string.config_mms_user_agent);
2770    }
2771
2772    /**
2773     * Returns the MMS user agent profile URL.
2774     */
2775    public String getMmsUAProfUrl() {
2776        if (mContext == null) return null;
2777        return mContext.getResources().getString(
2778                com.android.internal.R.string.config_mms_user_agent_profile_url);
2779    }
2780
2781    /**
2782     * Opens a logical channel to the ICC card.
2783     *
2784     * Input parameters equivalent to TS 27.007 AT+CCHO command.
2785     *
2786     * <p>Requires Permission:
2787     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2788     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2789     *
2790     * @param AID Application id. See ETSI 102.221 and 101.220.
2791     * @return an IccOpenLogicalChannelResponse object.
2792     */
2793    public IccOpenLogicalChannelResponse iccOpenLogicalChannel(String AID) {
2794        try {
2795            ITelephony telephony = getITelephony();
2796            if (telephony != null)
2797                return telephony.iccOpenLogicalChannel(AID);
2798        } catch (RemoteException ex) {
2799        } catch (NullPointerException ex) {
2800        }
2801        return null;
2802    }
2803
2804    /**
2805     * Closes a previously opened logical channel to the ICC card.
2806     *
2807     * Input parameters equivalent to TS 27.007 AT+CCHC command.
2808     *
2809     * <p>Requires Permission:
2810     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2811     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2812     *
2813     * @param channel is the channel id to be closed as retruned by a successful
2814     *            iccOpenLogicalChannel.
2815     * @return true if the channel was closed successfully.
2816     */
2817    public boolean iccCloseLogicalChannel(int channel) {
2818        try {
2819            ITelephony telephony = getITelephony();
2820            if (telephony != null)
2821                return telephony.iccCloseLogicalChannel(channel);
2822        } catch (RemoteException ex) {
2823        } catch (NullPointerException ex) {
2824        }
2825        return false;
2826    }
2827
2828    /**
2829     * Transmit an APDU to the ICC card over a logical channel.
2830     *
2831     * Input parameters equivalent to TS 27.007 AT+CGLA command.
2832     *
2833     * <p>Requires Permission:
2834     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2835     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2836     *
2837     * @param channel is the channel id to be closed as returned by a successful
2838     *            iccOpenLogicalChannel.
2839     * @param cla Class of the APDU command.
2840     * @param instruction Instruction of the APDU command.
2841     * @param p1 P1 value of the APDU command.
2842     * @param p2 P2 value of the APDU command.
2843     * @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
2844     *            is sent to the SIM.
2845     * @param data Data to be sent with the APDU.
2846     * @return The APDU response from the ICC card with the status appended at
2847     *            the end.
2848     */
2849    public String iccTransmitApduLogicalChannel(int channel, int cla,
2850            int instruction, int p1, int p2, int p3, String data) {
2851        try {
2852            ITelephony telephony = getITelephony();
2853            if (telephony != null)
2854                return telephony.iccTransmitApduLogicalChannel(channel, cla,
2855                    instruction, p1, p2, p3, data);
2856        } catch (RemoteException ex) {
2857        } catch (NullPointerException ex) {
2858        }
2859        return "";
2860    }
2861
2862    /**
2863     * Transmit an APDU to the ICC card over the basic channel.
2864     *
2865     * Input parameters equivalent to TS 27.007 AT+CSIM command.
2866     *
2867     * <p>Requires Permission:
2868     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2869     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2870     *
2871     * @param cla Class of the APDU command.
2872     * @param instruction Instruction of the APDU command.
2873     * @param p1 P1 value of the APDU command.
2874     * @param p2 P2 value of the APDU command.
2875     * @param p3 P3 value of the APDU command. If p3 is negative a 4 byte APDU
2876     *            is sent to the SIM.
2877     * @param data Data to be sent with the APDU.
2878     * @return The APDU response from the ICC card with the status appended at
2879     *            the end.
2880     */
2881    public String iccTransmitApduBasicChannel(int cla,
2882            int instruction, int p1, int p2, int p3, String data) {
2883        try {
2884            ITelephony telephony = getITelephony();
2885            if (telephony != null)
2886                return telephony.iccTransmitApduBasicChannel(cla,
2887                    instruction, p1, p2, p3, data);
2888        } catch (RemoteException ex) {
2889        } catch (NullPointerException ex) {
2890        }
2891        return "";
2892    }
2893
2894    /**
2895     * Returns the response APDU for a command APDU sent through SIM_IO.
2896     *
2897     * <p>Requires Permission:
2898     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2899     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2900     *
2901     * @param fileID
2902     * @param command
2903     * @param p1 P1 value of the APDU command.
2904     * @param p2 P2 value of the APDU command.
2905     * @param p3 P3 value of the APDU command.
2906     * @param filePath
2907     * @return The APDU response.
2908     */
2909    public byte[] iccExchangeSimIO(int fileID, int command, int p1, int p2, int p3,
2910            String filePath) {
2911        try {
2912            ITelephony telephony = getITelephony();
2913            if (telephony != null)
2914                return telephony.iccExchangeSimIO(fileID, command, p1, p2, p3, filePath);
2915        } catch (RemoteException ex) {
2916        } catch (NullPointerException ex) {
2917        }
2918        return null;
2919    }
2920
2921    /**
2922     * Send ENVELOPE to the SIM and return the response.
2923     *
2924     * <p>Requires Permission:
2925     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2926     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2927     *
2928     * @param content String containing SAT/USAT response in hexadecimal
2929     *                format starting with command tag. See TS 102 223 for
2930     *                details.
2931     * @return The APDU response from the ICC card in hexadecimal format
2932     *         with the last 4 bytes being the status word. If the command fails,
2933     *         returns an empty string.
2934     */
2935    public String sendEnvelopeWithStatus(String content) {
2936        try {
2937            ITelephony telephony = getITelephony();
2938            if (telephony != null)
2939                return telephony.sendEnvelopeWithStatus(content);
2940        } catch (RemoteException ex) {
2941        } catch (NullPointerException ex) {
2942        }
2943        return "";
2944    }
2945
2946    /**
2947     * Read one of the NV items defined in com.android.internal.telephony.RadioNVItems.
2948     * Used for device configuration by some CDMA operators.
2949     * <p>
2950     * Requires Permission:
2951     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2952     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2953     *
2954     * @param itemID the ID of the item to read.
2955     * @return the NV item as a String, or null on any failure.
2956     *
2957     * @hide
2958     */
2959    public String nvReadItem(int itemID) {
2960        try {
2961            ITelephony telephony = getITelephony();
2962            if (telephony != null)
2963                return telephony.nvReadItem(itemID);
2964        } catch (RemoteException ex) {
2965            Rlog.e(TAG, "nvReadItem RemoteException", ex);
2966        } catch (NullPointerException ex) {
2967            Rlog.e(TAG, "nvReadItem NPE", ex);
2968        }
2969        return "";
2970    }
2971
2972    /**
2973     * Write one of the NV items defined in com.android.internal.telephony.RadioNVItems.
2974     * Used for device configuration by some CDMA operators.
2975     * <p>
2976     * Requires Permission:
2977     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
2978     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
2979     *
2980     * @param itemID the ID of the item to read.
2981     * @param itemValue the value to write, as a String.
2982     * @return true on success; false on any failure.
2983     *
2984     * @hide
2985     */
2986    public boolean nvWriteItem(int itemID, String itemValue) {
2987        try {
2988            ITelephony telephony = getITelephony();
2989            if (telephony != null)
2990                return telephony.nvWriteItem(itemID, itemValue);
2991        } catch (RemoteException ex) {
2992            Rlog.e(TAG, "nvWriteItem RemoteException", ex);
2993        } catch (NullPointerException ex) {
2994            Rlog.e(TAG, "nvWriteItem NPE", ex);
2995        }
2996        return false;
2997    }
2998
2999    /**
3000     * Update the CDMA Preferred Roaming List (PRL) in the radio NV storage.
3001     * Used for device configuration by some CDMA operators.
3002     * <p>
3003     * Requires Permission:
3004     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
3005     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
3006     *
3007     * @param preferredRoamingList byte array containing the new PRL.
3008     * @return true on success; false on any failure.
3009     *
3010     * @hide
3011     */
3012    public boolean nvWriteCdmaPrl(byte[] preferredRoamingList) {
3013        try {
3014            ITelephony telephony = getITelephony();
3015            if (telephony != null)
3016                return telephony.nvWriteCdmaPrl(preferredRoamingList);
3017        } catch (RemoteException ex) {
3018            Rlog.e(TAG, "nvWriteCdmaPrl RemoteException", ex);
3019        } catch (NullPointerException ex) {
3020            Rlog.e(TAG, "nvWriteCdmaPrl NPE", ex);
3021        }
3022        return false;
3023    }
3024
3025    /**
3026     * Perform the specified type of NV config reset. The radio will be taken offline
3027     * and the device must be rebooted after the operation. Used for device
3028     * configuration by some CDMA operators.
3029     * <p>
3030     * Requires Permission:
3031     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
3032     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
3033     *
3034     * @param resetType reset type: 1: reload NV reset, 2: erase NV reset, 3: factory NV reset
3035     * @return true on success; false on any failure.
3036     *
3037     * @hide
3038     */
3039    public boolean nvResetConfig(int resetType) {
3040        try {
3041            ITelephony telephony = getITelephony();
3042            if (telephony != null)
3043                return telephony.nvResetConfig(resetType);
3044        } catch (RemoteException ex) {
3045            Rlog.e(TAG, "nvResetConfig RemoteException", ex);
3046        } catch (NullPointerException ex) {
3047            Rlog.e(TAG, "nvResetConfig NPE", ex);
3048        }
3049        return false;
3050    }
3051
3052    /**
3053     * Returns Default subscription.
3054     */
3055    private static int getDefaultSubscription() {
3056        return SubscriptionManager.getDefaultSubId();
3057    }
3058
3059    /**
3060     * Returns Default phone.
3061     */
3062    private static int getDefaultPhone() {
3063        return SubscriptionManager.getPhoneId(SubscriptionManager.getDefaultSubId());
3064    }
3065
3066    /** {@hide} */
3067    public int getDefaultSim() {
3068        return SubscriptionManager.getSlotId(SubscriptionManager.getDefaultSubId());
3069    }
3070
3071    /**
3072     * Sets the telephony property with the value specified.
3073     *
3074     * @hide
3075     */
3076    public static void setTelephonyProperty(int phoneId, String property, String value) {
3077        String propVal = "";
3078        String p[] = null;
3079        String prop = SystemProperties.get(property);
3080
3081        if (value == null) {
3082            value = "";
3083        }
3084
3085        if (prop != null) {
3086            p = prop.split(",");
3087        }
3088
3089        if (!SubscriptionManager.isValidPhoneId(phoneId)) {
3090            Rlog.d(TAG, "setTelephonyProperty: invalid phoneId=" + phoneId +
3091                    " property=" + property + " value: " + value + " prop=" + prop);
3092            return;
3093        }
3094
3095        for (int i = 0; i < phoneId; i++) {
3096            String str = "";
3097            if ((p != null) && (i < p.length)) {
3098                str = p[i];
3099            }
3100            propVal = propVal + str + ",";
3101        }
3102
3103        propVal = propVal + value;
3104        if (p != null) {
3105            for (int i = phoneId + 1; i < p.length; i++) {
3106                propVal = propVal + "," + p[i];
3107            }
3108        }
3109
3110        if (property.length() > SystemProperties.PROP_NAME_MAX
3111                || propVal.length() > SystemProperties.PROP_VALUE_MAX) {
3112            Rlog.d(TAG, "setTelephonyProperty: property to long phoneId=" + phoneId +
3113                    " property=" + property + " value: " + value + " propVal=" + propVal);
3114            return;
3115        }
3116
3117        Rlog.d(TAG, "setTelephonyProperty: success phoneId=" + phoneId +
3118                " property=" + property + " value: " + value + " propVal=" + propVal);
3119        SystemProperties.set(property, propVal);
3120    }
3121
3122    /**
3123     * Convenience function for retrieving a value from the secure settings
3124     * value list as an integer.  Note that internally setting values are
3125     * always stored as strings; this function converts the string to an
3126     * integer for you.
3127     * <p>
3128     * This version does not take a default value.  If the setting has not
3129     * been set, or the string value is not a number,
3130     * it throws {@link SettingNotFoundException}.
3131     *
3132     * @param cr The ContentResolver to access.
3133     * @param name The name of the setting to retrieve.
3134     * @param index The index of the list
3135     *
3136     * @throws SettingNotFoundException Thrown if a setting by the given
3137     * name can't be found or the setting value is not an integer.
3138     *
3139     * @return The value at the given index of settings.
3140     * @hide
3141     */
3142    public static int getIntAtIndex(android.content.ContentResolver cr,
3143            String name, int index)
3144            throws android.provider.Settings.SettingNotFoundException {
3145        String v = android.provider.Settings.Global.getString(cr, name);
3146        if (v != null) {
3147            String valArray[] = v.split(",");
3148            if ((index >= 0) && (index < valArray.length) && (valArray[index] != null)) {
3149                try {
3150                    return Integer.parseInt(valArray[index]);
3151                } catch (NumberFormatException e) {
3152                    //Log.e(TAG, "Exception while parsing Integer: ", e);
3153                }
3154            }
3155        }
3156        throw new android.provider.Settings.SettingNotFoundException(name);
3157    }
3158
3159    /**
3160     * Convenience function for updating settings value as coma separated
3161     * integer values. This will either create a new entry in the table if the
3162     * given name does not exist, or modify the value of the existing row
3163     * with that name.  Note that internally setting values are always
3164     * stored as strings, so this function converts the given value to a
3165     * string before storing it.
3166     *
3167     * @param cr The ContentResolver to access.
3168     * @param name The name of the setting to modify.
3169     * @param index The index of the list
3170     * @param value The new value for the setting to be added to the list.
3171     * @return true if the value was set, false on database errors
3172     * @hide
3173     */
3174    public static boolean putIntAtIndex(android.content.ContentResolver cr,
3175            String name, int index, int value) {
3176        String data = "";
3177        String valArray[] = null;
3178        String v = android.provider.Settings.Global.getString(cr, name);
3179
3180        if (index == Integer.MAX_VALUE) {
3181            throw new RuntimeException("putIntAtIndex index == MAX_VALUE index=" + index);
3182        }
3183        if (index < 0) {
3184            throw new RuntimeException("putIntAtIndex index < 0 index=" + index);
3185        }
3186        if (v != null) {
3187            valArray = v.split(",");
3188        }
3189
3190        // Copy the elements from valArray till index
3191        for (int i = 0; i < index; i++) {
3192            String str = "";
3193            if ((valArray != null) && (i < valArray.length)) {
3194                str = valArray[i];
3195            }
3196            data = data + str + ",";
3197        }
3198
3199        data = data + value;
3200
3201        // Copy the remaining elements from valArray if any.
3202        if (valArray != null) {
3203            for (int i = index+1; i < valArray.length; i++) {
3204                data = data + "," + valArray[i];
3205            }
3206        }
3207        return android.provider.Settings.Global.putString(cr, name, data);
3208    }
3209
3210    /**
3211     * Gets the telephony property.
3212     *
3213     * @hide
3214     */
3215    public static String getTelephonyProperty(int phoneId, String property, String defaultVal) {
3216        String propVal = null;
3217        String prop = SystemProperties.get(property);
3218        if ((prop != null) && (prop.length() > 0)) {
3219            String values[] = prop.split(",");
3220            if ((phoneId >= 0) && (phoneId < values.length) && (values[phoneId] != null)) {
3221                propVal = values[phoneId];
3222            }
3223        }
3224        Rlog.d(TAG, "getTelephonyProperty: return propVal='" + propVal + "' phoneId=" + phoneId
3225                + " property='" + property + "' defaultVal='" + defaultVal + "' prop=" + prop);
3226        return propVal == null ? defaultVal : propVal;
3227    }
3228
3229    /** @hide */
3230    public int getSimCount() {
3231        // FIXME Need to get it from Telephony Dev Controller when that gets implemented!
3232        // and then this method shouldn't be used at all!
3233        if(isMultiSimEnabled()) {
3234            return 2;
3235        } else {
3236            return 1;
3237        }
3238    }
3239
3240    /**
3241     * Returns the IMS Service Table (IST) that was loaded from the ISIM.
3242     * @return IMS Service Table or null if not present or not loaded
3243     * @hide
3244     */
3245    public String getIsimIst() {
3246        try {
3247            IPhoneSubInfo info = getSubscriberInfo();
3248            if (info == null)
3249                return null;
3250            return info.getIsimIst();
3251        } catch (RemoteException ex) {
3252            return null;
3253        } catch (NullPointerException ex) {
3254            // This could happen before phone restarts due to crashing
3255            return null;
3256        }
3257    }
3258
3259    /**
3260     * Returns the IMS Proxy Call Session Control Function(PCSCF) that were loaded from the ISIM.
3261     * @return an array of PCSCF strings with one PCSCF per string, or null if
3262     *         not present or not loaded
3263     * @hide
3264     */
3265    public String[] getIsimPcscf() {
3266        try {
3267            IPhoneSubInfo info = getSubscriberInfo();
3268            if (info == null)
3269                return null;
3270            return info.getIsimPcscf();
3271        } catch (RemoteException ex) {
3272            return null;
3273        } catch (NullPointerException ex) {
3274            // This could happen before phone restarts due to crashing
3275            return null;
3276        }
3277    }
3278
3279    /**
3280     * Returns the response of ISIM Authetification through RIL.
3281     * Returns null if the Authentification hasn't been successed or isn't present iphonesubinfo.
3282     * @return the response of ISIM Authetification, or null if not available
3283     * @hide
3284     * @deprecated
3285     * @see getIccSimChallengeResponse with appType=PhoneConstants.APPTYPE_ISIM
3286     */
3287    public String getIsimChallengeResponse(String nonce){
3288        try {
3289            IPhoneSubInfo info = getSubscriberInfo();
3290            if (info == null)
3291                return null;
3292            return info.getIsimChallengeResponse(nonce);
3293        } catch (RemoteException ex) {
3294            return null;
3295        } catch (NullPointerException ex) {
3296            // This could happen before phone restarts due to crashing
3297            return null;
3298        }
3299    }
3300
3301    /**
3302     * Returns the response of SIM Authentication through RIL.
3303     * Returns null if the Authentication hasn't been successful
3304     * @param subId subscription ID to be queried
3305     * @param appType ICC application type (@see com.android.internal.telephony.PhoneConstants#APPTYPE_xxx)
3306     * @param data authentication challenge data
3307     * @return the response of SIM Authentication, or null if not available
3308     * @hide
3309     */
3310    public String getIccSimChallengeResponse(int subId, int appType, String data) {
3311        try {
3312            IPhoneSubInfo info = getSubscriberInfo();
3313            if (info == null)
3314                return null;
3315            return info.getIccSimChallengeResponse(subId, appType, data);
3316        } catch (RemoteException ex) {
3317            return null;
3318        } catch (NullPointerException ex) {
3319            // This could happen before phone starts
3320            return null;
3321        }
3322    }
3323
3324    /**
3325     * Returns the response of SIM Authentication through RIL for the default subscription.
3326     * Returns null if the Authentication hasn't been successful
3327     * @param appType ICC application type (@see com.android.internal.telephony.PhoneConstants#APPTYPE_xxx)
3328     * @param data authentication challenge data
3329     * @return the response of SIM Authentication, or null if not available
3330     * @hide
3331     */
3332    public String getIccSimChallengeResponse(int appType, String data) {
3333        return getIccSimChallengeResponse(getDefaultSubscription(), appType, data);
3334    }
3335
3336    /**
3337     * Get P-CSCF address from PCO after data connection is established or modified.
3338     * @param apnType the apnType, "ims" for IMS APN, "emergency" for EMERGENCY APN
3339     * @return array of P-CSCF address
3340     * @hide
3341     */
3342    public String[] getPcscfAddress(String apnType) {
3343        try {
3344            ITelephony telephony = getITelephony();
3345            if (telephony == null)
3346                return new String[0];
3347            return telephony.getPcscfAddress(apnType, mContext.getOpPackageName());
3348        } catch (RemoteException e) {
3349            return new String[0];
3350        }
3351    }
3352
3353    /**
3354     * Set IMS registration state
3355     *
3356     * @param Registration state
3357     * @hide
3358     */
3359    public void setImsRegistrationState(boolean registered) {
3360        try {
3361            ITelephony telephony = getITelephony();
3362            if (telephony != null)
3363                telephony.setImsRegistrationState(registered);
3364        } catch (RemoteException e) {
3365        }
3366    }
3367
3368    /**
3369     * Get the preferred network type.
3370     * Used for device configuration by some CDMA operators.
3371     * <p>
3372     * Requires Permission:
3373     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
3374     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
3375     *
3376     * @return the preferred network type, defined in RILConstants.java.
3377     * @hide
3378     */
3379    public int getPreferredNetworkType(int subId) {
3380        try {
3381            ITelephony telephony = getITelephony();
3382            if (telephony != null)
3383                return telephony.getPreferredNetworkType(subId);
3384        } catch (RemoteException ex) {
3385            Rlog.e(TAG, "getPreferredNetworkType RemoteException", ex);
3386        } catch (NullPointerException ex) {
3387            Rlog.e(TAG, "getPreferredNetworkType NPE", ex);
3388        }
3389        return -1;
3390    }
3391
3392    /**
3393     * Sets the network selection mode to automatic.
3394     * <p>
3395     * Requires Permission:
3396     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
3397     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
3398     *
3399     * @hide
3400     */
3401    public void setNetworkSelectionModeAutomatic(int subId) {
3402        try {
3403            ITelephony telephony = getITelephony();
3404            if (telephony != null)
3405                telephony.setNetworkSelectionModeAutomatic(subId);
3406        } catch (RemoteException ex) {
3407            Rlog.e(TAG, "setNetworkSelectionModeAutomatic RemoteException", ex);
3408        } catch (NullPointerException ex) {
3409            Rlog.e(TAG, "setNetworkSelectionModeAutomatic NPE", ex);
3410        }
3411    }
3412
3413    /**
3414     * Set the preferred network type.
3415     * Used for device configuration by some CDMA operators.
3416     * <p>
3417     * Requires Permission:
3418     *   {@link android.Manifest.permission#MODIFY_PHONE_STATE MODIFY_PHONE_STATE}
3419     * Or the calling app has carrier privileges. @see #hasCarrierPrivileges
3420     *
3421     * @param subId the id of the subscription to set the preferred network type for.
3422     * @param networkType the preferred network type, defined in RILConstants.java.
3423     * @return true on success; false on any failure.
3424     * @hide
3425     */
3426    public boolean setPreferredNetworkType(int subId, int networkType) {
3427        try {
3428            ITelephony telephony = getITelephony();
3429            if (telephony != null)
3430                return telephony.setPreferredNetworkType(subId, networkType);
3431        } catch (RemoteException ex) {
3432            Rlog.e(TAG, "setPreferredNetworkType RemoteException", ex);
3433        } catch (NullPointerException ex) {
3434            Rlog.e(TAG, "setPreferredNetworkType NPE", ex);
3435        }
3436        return false;
3437    }
3438
3439    /**
3440     * Set the preferred network type to global mode which includes LTE, CDMA, EvDo and GSM/WCDMA.
3441     *
3442     * <p>
3443     * Requires that the calling app has carrier privileges.
3444     * @see #hasCarrierPrivileges
3445     *
3446     * @return true on success; false on any failure.
3447     */
3448    public boolean setPreferredNetworkTypeToGlobal() {
3449        return setPreferredNetworkType(getDefaultSubscription(),
3450                RILConstants.NETWORK_MODE_LTE_CDMA_EVDO_GSM_WCDMA);
3451    }
3452
3453    /**
3454     * Check TETHER_DUN_REQUIRED and TETHER_DUN_APN settings, net.tethering.noprovisioning
3455     * SystemProperty, and config_tether_apndata to decide whether DUN APN is required for
3456     * tethering.
3457     *
3458     * @return 0: Not required. 1: required. 2: Not set.
3459     * @hide
3460     */
3461    public int getTetherApnRequired() {
3462        try {
3463            ITelephony telephony = getITelephony();
3464            if (telephony != null)
3465                return telephony.getTetherApnRequired();
3466        } catch (RemoteException ex) {
3467            Rlog.e(TAG, "hasMatchedTetherApnSetting RemoteException", ex);
3468        } catch (NullPointerException ex) {
3469            Rlog.e(TAG, "hasMatchedTetherApnSetting NPE", ex);
3470        }
3471        return 2;
3472    }
3473
3474
3475    /**
3476     * Values used to return status for hasCarrierPrivileges call.
3477     */
3478    /** @hide */
3479    public static final int CARRIER_PRIVILEGE_STATUS_HAS_ACCESS = 1;
3480    /** @hide */
3481    public static final int CARRIER_PRIVILEGE_STATUS_NO_ACCESS = 0;
3482    /** @hide */
3483    public static final int CARRIER_PRIVILEGE_STATUS_RULES_NOT_LOADED = -1;
3484    /** @hide */
3485    public static final int CARRIER_PRIVILEGE_STATUS_ERROR_LOADING_RULES = -2;
3486
3487    /**
3488     * Has the calling application been granted carrier privileges by the carrier.
3489     *
3490     * If any of the packages in the calling UID has carrier privileges, the
3491     * call will return true. This access is granted by the owner of the UICC
3492     * card and does not depend on the registered carrier.
3493     *
3494     * @return true if the app has carrier privileges.
3495     */
3496    public boolean hasCarrierPrivileges() {
3497        try {
3498            ITelephony telephony = getITelephony();
3499            if (telephony != null)
3500                return telephony.getCarrierPrivilegeStatus() == CARRIER_PRIVILEGE_STATUS_HAS_ACCESS;
3501        } catch (RemoteException ex) {
3502            Rlog.e(TAG, "hasCarrierPrivileges RemoteException", ex);
3503        } catch (NullPointerException ex) {
3504            Rlog.e(TAG, "hasCarrierPrivileges NPE", ex);
3505        }
3506        return false;
3507    }
3508
3509    /**
3510     * Override the branding for the current ICCID.
3511     *
3512     * Once set, whenever the SIM is present in the device, the service
3513     * provider name (SPN) and the operator name will both be replaced by the
3514     * brand value input. To unset the value, the same function should be
3515     * called with a null brand value.
3516     *
3517     * <p>Requires that the calling app has carrier privileges.
3518     * @see #hasCarrierPrivileges
3519     *
3520     * @param brand The brand name to display/set.
3521     * @return true if the operation was executed correctly.
3522     */
3523    public boolean setOperatorBrandOverride(String brand) {
3524        try {
3525            ITelephony telephony = getITelephony();
3526            if (telephony != null)
3527                return telephony.setOperatorBrandOverride(brand);
3528        } catch (RemoteException ex) {
3529            Rlog.e(TAG, "setOperatorBrandOverride RemoteException", ex);
3530        } catch (NullPointerException ex) {
3531            Rlog.e(TAG, "setOperatorBrandOverride NPE", ex);
3532        }
3533        return false;
3534    }
3535
3536    /**
3537     * Override the roaming preference for the current ICCID.
3538     *
3539     * Using this call, the carrier app (see #hasCarrierPrivileges) can override
3540     * the platform's notion of a network operator being considered roaming or not.
3541     * The change only affects the ICCID that was active when this call was made.
3542     *
3543     * If null is passed as any of the input, the corresponding value is deleted.
3544     *
3545     * <p>Requires that the caller have carrier privilege. See #hasCarrierPrivileges.
3546     *
3547     * @param gsmRoamingList - List of MCCMNCs to be considered roaming for 3GPP RATs.
3548     * @param gsmNonRoamingList - List of MCCMNCs to be considered not roaming for 3GPP RATs.
3549     * @param cdmaRoamingList - List of SIDs to be considered roaming for 3GPP2 RATs.
3550     * @param cdmaNonRoamingList - List of SIDs to be considered not roaming for 3GPP2 RATs.
3551     * @return true if the operation was executed correctly.
3552     *
3553     * @hide
3554     */
3555    public boolean setRoamingOverride(List<String> gsmRoamingList,
3556            List<String> gsmNonRoamingList, List<String> cdmaRoamingList,
3557            List<String> cdmaNonRoamingList) {
3558        try {
3559            ITelephony telephony = getITelephony();
3560            if (telephony != null)
3561                return telephony.setRoamingOverride(gsmRoamingList, gsmNonRoamingList,
3562                        cdmaRoamingList, cdmaNonRoamingList);
3563        } catch (RemoteException ex) {
3564            Rlog.e(TAG, "setRoamingOverride RemoteException", ex);
3565        } catch (NullPointerException ex) {
3566            Rlog.e(TAG, "setRoamingOverride NPE", ex);
3567        }
3568        return false;
3569    }
3570
3571    /**
3572     * Expose the rest of ITelephony to @SystemApi
3573     */
3574
3575    /** @hide */
3576    @SystemApi
3577    public String getCdmaMdn() {
3578        return getCdmaMdn(getDefaultSubscription());
3579    }
3580
3581    /** @hide */
3582    @SystemApi
3583    public String getCdmaMdn(int subId) {
3584        try {
3585            ITelephony telephony = getITelephony();
3586            if (telephony == null)
3587                return null;
3588            return telephony.getCdmaMdn(subId);
3589        } catch (RemoteException ex) {
3590            return null;
3591        } catch (NullPointerException ex) {
3592            return null;
3593        }
3594    }
3595
3596    /** @hide */
3597    @SystemApi
3598    public String getCdmaMin() {
3599        return getCdmaMin(getDefaultSubscription());
3600    }
3601
3602    /** @hide */
3603    @SystemApi
3604    public String getCdmaMin(int subId) {
3605        try {
3606            ITelephony telephony = getITelephony();
3607            if (telephony == null)
3608                return null;
3609            return telephony.getCdmaMin(subId);
3610        } catch (RemoteException ex) {
3611            return null;
3612        } catch (NullPointerException ex) {
3613            return null;
3614        }
3615    }
3616
3617    /** @hide */
3618    @SystemApi
3619    public int checkCarrierPrivilegesForPackage(String pkgname) {
3620        try {
3621            ITelephony telephony = getITelephony();
3622            if (telephony != null)
3623                return telephony.checkCarrierPrivilegesForPackage(pkgname);
3624        } catch (RemoteException ex) {
3625            Rlog.e(TAG, "checkCarrierPrivilegesForPackage RemoteException", ex);
3626        } catch (NullPointerException ex) {
3627            Rlog.e(TAG, "checkCarrierPrivilegesForPackage NPE", ex);
3628        }
3629        return CARRIER_PRIVILEGE_STATUS_NO_ACCESS;
3630    }
3631
3632    /** @hide */
3633    @SystemApi
3634    public List<String> getCarrierPackageNamesForIntent(Intent intent) {
3635        try {
3636            ITelephony telephony = getITelephony();
3637            if (telephony != null)
3638                return telephony.getCarrierPackageNamesForIntent(intent);
3639        } catch (RemoteException ex) {
3640            Rlog.e(TAG, "getCarrierPackageNamesForIntent RemoteException", ex);
3641        } catch (NullPointerException ex) {
3642            Rlog.e(TAG, "getCarrierPackageNamesForIntent NPE", ex);
3643        }
3644        return null;
3645    }
3646
3647    /** @hide */
3648    @SystemApi
3649    public void dial(String number) {
3650        try {
3651            ITelephony telephony = getITelephony();
3652            if (telephony != null)
3653                telephony.dial(number);
3654        } catch (RemoteException e) {
3655            Log.e(TAG, "Error calling ITelephony#dial", e);
3656        }
3657    }
3658
3659    /** @hide */
3660    @SystemApi
3661    public void call(String callingPackage, String number) {
3662        try {
3663            ITelephony telephony = getITelephony();
3664            if (telephony != null)
3665                telephony.call(callingPackage, number);
3666        } catch (RemoteException e) {
3667            Log.e(TAG, "Error calling ITelephony#call", e);
3668        }
3669    }
3670
3671    /** @hide */
3672    @SystemApi
3673    public boolean endCall() {
3674        try {
3675            ITelephony telephony = getITelephony();
3676            if (telephony != null)
3677                return telephony.endCall();
3678        } catch (RemoteException e) {
3679            Log.e(TAG, "Error calling ITelephony#endCall", e);
3680        }
3681        return false;
3682    }
3683
3684    /** @hide */
3685    @SystemApi
3686    public void answerRingingCall() {
3687        try {
3688            ITelephony telephony = getITelephony();
3689            if (telephony != null)
3690                telephony.answerRingingCall();
3691        } catch (RemoteException e) {
3692            Log.e(TAG, "Error calling ITelephony#answerRingingCall", e);
3693        }
3694    }
3695
3696    /** @hide */
3697    @SystemApi
3698    public void silenceRinger() {
3699        try {
3700            getTelecomService().silenceRinger();
3701        } catch (RemoteException e) {
3702            Log.e(TAG, "Error calling ITelecomService#silenceRinger", e);
3703        }
3704    }
3705
3706    /** @hide */
3707    @SystemApi
3708    public boolean isOffhook() {
3709        try {
3710            ITelephony telephony = getITelephony();
3711            if (telephony != null)
3712                return telephony.isOffhook();
3713        } catch (RemoteException e) {
3714            Log.e(TAG, "Error calling ITelephony#isOffhook", e);
3715        }
3716        return false;
3717    }
3718
3719    /** @hide */
3720    @SystemApi
3721    public boolean isRinging() {
3722        try {
3723            ITelephony telephony = getITelephony();
3724            if (telephony != null)
3725                return telephony.isRinging();
3726        } catch (RemoteException e) {
3727            Log.e(TAG, "Error calling ITelephony#isRinging", e);
3728        }
3729        return false;
3730    }
3731
3732    /** @hide */
3733    @SystemApi
3734    public boolean isIdle() {
3735        try {
3736            ITelephony telephony = getITelephony();
3737            if (telephony != null)
3738                return telephony.isIdle();
3739        } catch (RemoteException e) {
3740            Log.e(TAG, "Error calling ITelephony#isIdle", e);
3741        }
3742        return true;
3743    }
3744
3745    /** @hide */
3746    @SystemApi
3747    public boolean isRadioOn() {
3748        try {
3749            ITelephony telephony = getITelephony();
3750            if (telephony != null)
3751                return telephony.isRadioOn();
3752        } catch (RemoteException e) {
3753            Log.e(TAG, "Error calling ITelephony#isRadioOn", e);
3754        }
3755        return false;
3756    }
3757
3758    /** @hide */
3759    @SystemApi
3760    public boolean isSimPinEnabled() {
3761        try {
3762            ITelephony telephony = getITelephony();
3763            if (telephony != null)
3764                return telephony.isSimPinEnabled(mContext.getOpPackageName());
3765        } catch (RemoteException e) {
3766            Log.e(TAG, "Error calling ITelephony#isSimPinEnabled", e);
3767        }
3768        return false;
3769    }
3770
3771    /** @hide */
3772    @SystemApi
3773    public boolean supplyPin(String pin) {
3774        try {
3775            ITelephony telephony = getITelephony();
3776            if (telephony != null)
3777                return telephony.supplyPin(pin);
3778        } catch (RemoteException e) {
3779            Log.e(TAG, "Error calling ITelephony#supplyPin", e);
3780        }
3781        return false;
3782    }
3783
3784    /** @hide */
3785    @SystemApi
3786    public boolean supplyPuk(String puk, String pin) {
3787        try {
3788            ITelephony telephony = getITelephony();
3789            if (telephony != null)
3790                return telephony.supplyPuk(puk, pin);
3791        } catch (RemoteException e) {
3792            Log.e(TAG, "Error calling ITelephony#supplyPuk", e);
3793        }
3794        return false;
3795    }
3796
3797    /** @hide */
3798    @SystemApi
3799    public int[] supplyPinReportResult(String pin) {
3800        try {
3801            ITelephony telephony = getITelephony();
3802            if (telephony != null)
3803                return telephony.supplyPinReportResult(pin);
3804        } catch (RemoteException e) {
3805            Log.e(TAG, "Error calling ITelephony#supplyPinReportResult", e);
3806        }
3807        return new int[0];
3808    }
3809
3810    /** @hide */
3811    @SystemApi
3812    public int[] supplyPukReportResult(String puk, String pin) {
3813        try {
3814            ITelephony telephony = getITelephony();
3815            if (telephony != null)
3816                return telephony.supplyPukReportResult(puk, pin);
3817        } catch (RemoteException e) {
3818            Log.e(TAG, "Error calling ITelephony#]", e);
3819        }
3820        return new int[0];
3821    }
3822
3823    /** @hide */
3824    @SystemApi
3825    public boolean handlePinMmi(String dialString) {
3826        try {
3827            ITelephony telephony = getITelephony();
3828            if (telephony != null)
3829                return telephony.handlePinMmi(dialString);
3830        } catch (RemoteException e) {
3831            Log.e(TAG, "Error calling ITelephony#handlePinMmi", e);
3832        }
3833        return false;
3834    }
3835
3836    /** @hide */
3837    @SystemApi
3838    public boolean handlePinMmiForSubscriber(int subId, String dialString) {
3839        try {
3840            ITelephony telephony = getITelephony();
3841            if (telephony != null)
3842                return telephony.handlePinMmiForSubscriber(subId, dialString);
3843        } catch (RemoteException e) {
3844            Log.e(TAG, "Error calling ITelephony#handlePinMmi", e);
3845        }
3846        return false;
3847    }
3848
3849    /** @hide */
3850    @SystemApi
3851    public void toggleRadioOnOff() {
3852        try {
3853            ITelephony telephony = getITelephony();
3854            if (telephony != null)
3855                telephony.toggleRadioOnOff();
3856        } catch (RemoteException e) {
3857            Log.e(TAG, "Error calling ITelephony#toggleRadioOnOff", e);
3858        }
3859    }
3860
3861    /** @hide */
3862    @SystemApi
3863    public boolean setRadio(boolean turnOn) {
3864        try {
3865            ITelephony telephony = getITelephony();
3866            if (telephony != null)
3867                return telephony.setRadio(turnOn);
3868        } catch (RemoteException e) {
3869            Log.e(TAG, "Error calling ITelephony#setRadio", e);
3870        }
3871        return false;
3872    }
3873
3874    /** @hide */
3875    @SystemApi
3876    public boolean setRadioPower(boolean turnOn) {
3877        try {
3878            ITelephony telephony = getITelephony();
3879            if (telephony != null)
3880                return telephony.setRadioPower(turnOn);
3881        } catch (RemoteException e) {
3882            Log.e(TAG, "Error calling ITelephony#setRadioPower", e);
3883        }
3884        return false;
3885    }
3886
3887    /** @hide */
3888    @SystemApi
3889    public void updateServiceLocation() {
3890        try {
3891            ITelephony telephony = getITelephony();
3892            if (telephony != null)
3893                telephony.updateServiceLocation();
3894        } catch (RemoteException e) {
3895            Log.e(TAG, "Error calling ITelephony#updateServiceLocation", e);
3896        }
3897    }
3898
3899    /** @hide */
3900    @SystemApi
3901    public boolean enableDataConnectivity() {
3902        try {
3903            ITelephony telephony = getITelephony();
3904            if (telephony != null)
3905                return telephony.enableDataConnectivity();
3906        } catch (RemoteException e) {
3907            Log.e(TAG, "Error calling ITelephony#enableDataConnectivity", e);
3908        }
3909        return false;
3910    }
3911
3912    /** @hide */
3913    @SystemApi
3914    public boolean disableDataConnectivity() {
3915        try {
3916            ITelephony telephony = getITelephony();
3917            if (telephony != null)
3918                return telephony.disableDataConnectivity();
3919        } catch (RemoteException e) {
3920            Log.e(TAG, "Error calling ITelephony#disableDataConnectivity", e);
3921        }
3922        return false;
3923    }
3924
3925    /** @hide */
3926    @SystemApi
3927    public boolean isDataConnectivityPossible() {
3928        try {
3929            ITelephony telephony = getITelephony();
3930            if (telephony != null)
3931                return telephony.isDataConnectivityPossible();
3932        } catch (RemoteException e) {
3933            Log.e(TAG, "Error calling ITelephony#isDataConnectivityPossible", e);
3934        }
3935        return false;
3936    }
3937
3938    /** @hide */
3939    @SystemApi
3940    public boolean needsOtaServiceProvisioning() {
3941        try {
3942            ITelephony telephony = getITelephony();
3943            if (telephony != null)
3944                return telephony.needsOtaServiceProvisioning();
3945        } catch (RemoteException e) {
3946            Log.e(TAG, "Error calling ITelephony#needsOtaServiceProvisioning", e);
3947        }
3948        return false;
3949    }
3950
3951    /** @hide */
3952    @SystemApi
3953    public void setDataEnabled(boolean enable) {
3954        setDataEnabled(SubscriptionManager.getDefaultDataSubId(), enable);
3955    }
3956
3957    /** @hide */
3958    @SystemApi
3959    public void setDataEnabled(int subId, boolean enable) {
3960        try {
3961            Log.d(TAG, "setDataEnabled: enabled=" + enable);
3962            ITelephony telephony = getITelephony();
3963            if (telephony != null)
3964                telephony.setDataEnabled(subId, enable);
3965        } catch (RemoteException e) {
3966            Log.e(TAG, "Error calling ITelephony#setDataEnabled", e);
3967        }
3968    }
3969
3970    /** @hide */
3971    @SystemApi
3972    public boolean getDataEnabled() {
3973        return getDataEnabled(SubscriptionManager.getDefaultDataSubId());
3974    }
3975
3976    /** @hide */
3977    @SystemApi
3978    public boolean getDataEnabled(int subId) {
3979        boolean retVal = false;
3980        try {
3981            ITelephony telephony = getITelephony();
3982            if (telephony != null)
3983                retVal = telephony.getDataEnabled(subId);
3984        } catch (RemoteException e) {
3985            Log.e(TAG, "Error calling ITelephony#getDataEnabled", e);
3986        } catch (NullPointerException e) {
3987        }
3988        Log.d(TAG, "getDataEnabled: retVal=" + retVal);
3989        return retVal;
3990    }
3991
3992    /**
3993     * Returns the result and response from RIL for oem request
3994     *
3995     * @param oemReq the data is sent to ril.
3996     * @param oemResp the respose data from RIL.
3997     * @return negative value request was not handled or get error
3998     *         0 request was handled succesfully, but no response data
3999     *         positive value success, data length of response
4000     * @hide
4001     */
4002    public int invokeOemRilRequestRaw(byte[] oemReq, byte[] oemResp) {
4003        try {
4004            ITelephony telephony = getITelephony();
4005            if (telephony != null)
4006                return telephony.invokeOemRilRequestRaw(oemReq, oemResp);
4007        } catch (RemoteException ex) {
4008        } catch (NullPointerException ex) {
4009        }
4010        return -1;
4011    }
4012
4013    /** @hide */
4014    @SystemApi
4015    public void enableVideoCalling(boolean enable) {
4016        try {
4017            ITelephony telephony = getITelephony();
4018            if (telephony != null)
4019                telephony.enableVideoCalling(enable);
4020        } catch (RemoteException e) {
4021            Log.e(TAG, "Error calling ITelephony#enableVideoCalling", e);
4022        }
4023    }
4024
4025    /** @hide */
4026    @SystemApi
4027    public boolean isVideoCallingEnabled() {
4028        try {
4029            ITelephony telephony = getITelephony();
4030            if (telephony != null)
4031                return telephony.isVideoCallingEnabled(mContext.getOpPackageName());
4032        } catch (RemoteException e) {
4033            Log.e(TAG, "Error calling ITelephony#isVideoCallingEnabled", e);
4034        }
4035        return false;
4036    }
4037
4038    /**
4039     * Whether the device supports configuring the DTMF tone length.
4040     *
4041     * @return {@code true} if the DTMF tone length can be changed, and {@code false} otherwise.
4042     */
4043    public boolean canChangeDtmfToneLength() {
4044        try {
4045            ITelephony telephony = getITelephony();
4046            if (telephony != null) {
4047                return telephony.canChangeDtmfToneLength();
4048            }
4049        } catch (RemoteException e) {
4050            Log.e(TAG, "Error calling ITelephony#canChangeDtmfToneLength", e);
4051        }
4052        return false;
4053    }
4054
4055    /**
4056     * Whether the device is a world phone.
4057     *
4058     * @return {@code true} if the device is a world phone, and {@code false} otherwise.
4059     */
4060    public boolean isWorldPhone() {
4061        try {
4062            ITelephony telephony = getITelephony();
4063            if (telephony != null) {
4064                return telephony.isWorldPhone();
4065            }
4066        } catch (RemoteException e) {
4067            Log.e(TAG, "Error calling ITelephony#isWorldPhone", e);
4068        }
4069        return false;
4070    }
4071
4072    /**
4073     * Whether the phone supports TTY mode.
4074     *
4075     * @return {@code true} if the device supports TTY mode, and {@code false} otherwise.
4076     */
4077    public boolean isTtyModeSupported() {
4078        try {
4079            ITelephony telephony = getITelephony();
4080            if (telephony != null) {
4081                return telephony.isTtyModeSupported();
4082            }
4083        } catch (RemoteException e) {
4084            Log.e(TAG, "Error calling ITelephony#isTtyModeSupported", e);
4085        }
4086        return false;
4087    }
4088
4089    /**
4090     * Whether the phone supports hearing aid compatibility.
4091     *
4092     * @return {@code true} if the device supports hearing aid compatibility, and {@code false}
4093     * otherwise.
4094     */
4095    public boolean isHearingAidCompatibilitySupported() {
4096        try {
4097            ITelephony telephony = getITelephony();
4098            if (telephony != null) {
4099                return telephony.isHearingAidCompatibilitySupported();
4100            }
4101        } catch (RemoteException e) {
4102            Log.e(TAG, "Error calling ITelephony#isHearingAidCompatibilitySupported", e);
4103        }
4104        return false;
4105    }
4106
4107    /**
4108     * This function retrieves value for setting "name+subId", and if that is not found
4109     * retrieves value for setting "name", and if that is not found throws
4110     * SettingNotFoundException
4111     *
4112     * @hide */
4113    public static int getIntWithSubId(ContentResolver cr, String name, int subId)
4114            throws SettingNotFoundException {
4115        try {
4116            return Settings.Global.getInt(cr, name + subId);
4117        } catch (SettingNotFoundException e) {
4118            try {
4119                int val = Settings.Global.getInt(cr, name);
4120                Settings.Global.putInt(cr, name + subId, val);
4121
4122                /* We are now moving from 'setting' to 'setting+subId', and using the value stored
4123                 * for 'setting' as default. Reset the default (since it may have a user set
4124                 * value). */
4125                int default_val = val;
4126                if (name.equals(Settings.Global.MOBILE_DATA)) {
4127                    default_val = "true".equalsIgnoreCase(
4128                            SystemProperties.get("ro.com.android.mobiledata", "true")) ? 1 : 0;
4129                } else if (name.equals(Settings.Global.DATA_ROAMING)) {
4130                    default_val = "true".equalsIgnoreCase(
4131                            SystemProperties.get("ro.com.android.dataroaming", "false")) ? 1 : 0;
4132                }
4133
4134                if (default_val != val) {
4135                    Settings.Global.putInt(cr, name, default_val);
4136                }
4137
4138                return val;
4139            } catch (SettingNotFoundException exc) {
4140                throw new SettingNotFoundException(name);
4141            }
4142        }
4143    }
4144
4145   /**
4146    * Returns the IMS Registration Status
4147    * @hide
4148    */
4149   public boolean isImsRegistered() {
4150       try {
4151           ITelephony telephony = getITelephony();
4152           if (telephony == null)
4153               return false;
4154           return telephony.isImsRegistered();
4155       } catch (RemoteException ex) {
4156           return false;
4157       } catch (NullPointerException ex) {
4158           return false;
4159       }
4160   }
4161
4162   /**
4163    * Returns the Status of Volte
4164    *@hide
4165    */
4166   public boolean isVolteEnabled() {
4167       try {
4168           return getITelephony().isVolteEnabled();
4169       } catch (RemoteException ex) {
4170           return false;
4171       } catch (NullPointerException ex) {
4172           return false;
4173       }
4174   }
4175
4176   /**
4177    * Returns the Status of Wi-Fi Calling
4178    *@hide
4179    */
4180   public boolean isWifiCallingEnabled() {
4181       try {
4182           return getITelephony().isWifiCallingEnabled();
4183       } catch (RemoteException ex) {
4184           return false;
4185       } catch (NullPointerException ex) {
4186           return false;
4187       }
4188   }
4189
4190   /**
4191    * Set TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC for the default phone.
4192    *
4193    * @hide
4194    */
4195    public void setSimOperatorNumeric(String numeric) {
4196        int phoneId = getDefaultPhone();
4197        setSimOperatorNumericForPhone(phoneId, numeric);
4198    }
4199
4200   /**
4201    * Set TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC for the given phone.
4202    *
4203    * @hide
4204    */
4205    public void setSimOperatorNumericForPhone(int phoneId, String numeric) {
4206        setTelephonyProperty(phoneId,
4207                TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC, numeric);
4208    }
4209
4210    /**
4211     * Set TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC for the default phone.
4212     *
4213     * @hide
4214     */
4215    public void setSimOperatorName(String name) {
4216        int phoneId = getDefaultPhone();
4217        setSimOperatorNameForPhone(phoneId, name);
4218    }
4219
4220    /**
4221     * Set TelephonyProperties.PROPERTY_ICC_OPERATOR_NUMERIC for the given phone.
4222     *
4223     * @hide
4224     */
4225    public void setSimOperatorNameForPhone(int phoneId, String name) {
4226        setTelephonyProperty(phoneId,
4227                TelephonyProperties.PROPERTY_ICC_OPERATOR_ALPHA, name);
4228    }
4229
4230   /**
4231    * Set TelephonyProperties.PROPERTY_ICC_OPERATOR_ISO_COUNTRY for the default phone.
4232    *
4233    * @hide
4234    */
4235    public void setSimCountryIso(String iso) {
4236        int phoneId = getDefaultPhone();
4237        setSimCountryIsoForPhone(phoneId, iso);
4238    }
4239
4240   /**
4241    * Set TelephonyProperties.PROPERTY_ICC_OPERATOR_ISO_COUNTRY for the given phone.
4242    *
4243    * @hide
4244    */
4245    public void setSimCountryIsoForPhone(int phoneId, String iso) {
4246        setTelephonyProperty(phoneId,
4247                TelephonyProperties.PROPERTY_ICC_OPERATOR_ISO_COUNTRY, iso);
4248    }
4249
4250    /**
4251     * Set TelephonyProperties.PROPERTY_SIM_STATE for the default phone.
4252     *
4253     * @hide
4254     */
4255    public void setSimState(String state) {
4256        int phoneId = getDefaultPhone();
4257        setSimStateForPhone(phoneId, state);
4258    }
4259
4260    /**
4261     * Set TelephonyProperties.PROPERTY_SIM_STATE for the given phone.
4262     *
4263     * @hide
4264     */
4265    public void setSimStateForPhone(int phoneId, String state) {
4266        setTelephonyProperty(phoneId,
4267                TelephonyProperties.PROPERTY_SIM_STATE, state);
4268    }
4269
4270    /**
4271     * Set baseband version for the default phone.
4272     *
4273     * @param version baseband version
4274     * @hide
4275     */
4276    public void setBasebandVersion(String version) {
4277        int phoneId = getDefaultPhone();
4278        setBasebandVersionForPhone(phoneId, version);
4279    }
4280
4281    /**
4282     * Set baseband version by phone id.
4283     *
4284     * @param phoneId for which baseband version is set
4285     * @param version baseband version
4286     * @hide
4287     */
4288    public void setBasebandVersionForPhone(int phoneId, String version) {
4289        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4290            String prop = TelephonyProperties.PROPERTY_BASEBAND_VERSION +
4291                    ((phoneId == 0) ? "" : Integer.toString(phoneId));
4292            SystemProperties.set(prop, version);
4293        }
4294    }
4295
4296    /**
4297     * Set phone type for the default phone.
4298     *
4299     * @param type phone type
4300     *
4301     * @hide
4302     */
4303    public void setPhoneType(int type) {
4304        int phoneId = getDefaultPhone();
4305        setPhoneType(phoneId, type);
4306    }
4307
4308    /**
4309     * Set phone type by phone id.
4310     *
4311     * @param phoneId for which phone type is set
4312     * @param type phone type
4313     *
4314     * @hide
4315     */
4316    public void setPhoneType(int phoneId, int type) {
4317        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4318            TelephonyManager.setTelephonyProperty(phoneId,
4319                    TelephonyProperties.CURRENT_ACTIVE_PHONE, String.valueOf(type));
4320        }
4321    }
4322
4323    /**
4324     * Get OTASP number schema for the default phone.
4325     *
4326     * @param defaultValue default value
4327     * @return OTA SP number schema
4328     *
4329     * @hide
4330     */
4331    public String getOtaSpNumberSchema(String defaultValue) {
4332        int phoneId = getDefaultPhone();
4333        return getOtaSpNumberSchemaForPhone(phoneId, defaultValue);
4334    }
4335
4336    /**
4337     * Get OTASP number schema by phone id.
4338     *
4339     * @param phoneId for which OTA SP number schema is get
4340     * @param defaultValue default value
4341     * @return OTA SP number schema
4342     *
4343     * @hide
4344     */
4345    public String getOtaSpNumberSchemaForPhone(int phoneId, String defaultValue) {
4346        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4347            return TelephonyManager.getTelephonyProperty(phoneId,
4348                    TelephonyProperties.PROPERTY_OTASP_NUM_SCHEMA, defaultValue);
4349        }
4350
4351        return defaultValue;
4352    }
4353
4354    /**
4355     * Get SMS receive capable from system property for the default phone.
4356     *
4357     * @param defaultValue default value
4358     * @return SMS receive capable
4359     *
4360     * @hide
4361     */
4362    public boolean getSmsReceiveCapable(boolean defaultValue) {
4363        int phoneId = getDefaultPhone();
4364        return getSmsReceiveCapableForPhone(phoneId, defaultValue);
4365    }
4366
4367    /**
4368     * Get SMS receive capable from system property by phone id.
4369     *
4370     * @param phoneId for which SMS receive capable is get
4371     * @param defaultValue default value
4372     * @return SMS receive capable
4373     *
4374     * @hide
4375     */
4376    public boolean getSmsReceiveCapableForPhone(int phoneId, boolean defaultValue) {
4377        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4378            return Boolean.valueOf(TelephonyManager.getTelephonyProperty(phoneId,
4379                    TelephonyProperties.PROPERTY_SMS_RECEIVE, String.valueOf(defaultValue)));
4380        }
4381
4382        return defaultValue;
4383    }
4384
4385    /**
4386     * Get SMS send capable from system property for the default phone.
4387     *
4388     * @param defaultValue default value
4389     * @return SMS send capable
4390     *
4391     * @hide
4392     */
4393    public boolean getSmsSendCapable(boolean defaultValue) {
4394        int phoneId = getDefaultPhone();
4395        return getSmsSendCapableForPhone(phoneId, defaultValue);
4396    }
4397
4398    /**
4399     * Get SMS send capable from system property by phone id.
4400     *
4401     * @param phoneId for which SMS send capable is get
4402     * @param defaultValue default value
4403     * @return SMS send capable
4404     *
4405     * @hide
4406     */
4407    public boolean getSmsSendCapableForPhone(int phoneId, boolean defaultValue) {
4408        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4409            return Boolean.valueOf(TelephonyManager.getTelephonyProperty(phoneId,
4410                    TelephonyProperties.PROPERTY_SMS_SEND, String.valueOf(defaultValue)));
4411        }
4412
4413        return defaultValue;
4414    }
4415
4416    /**
4417     * Set the alphabetic name of current registered operator.
4418     * @param name the alphabetic name of current registered operator.
4419     * @hide
4420     */
4421    public void setNetworkOperatorName(String name) {
4422        int phoneId = getDefaultPhone();
4423        setNetworkOperatorNameForPhone(phoneId, name);
4424    }
4425
4426    /**
4427     * Set the alphabetic name of current registered operator.
4428     * @param phoneId which phone you want to set
4429     * @param name the alphabetic name of current registered operator.
4430     * @hide
4431     */
4432    public void setNetworkOperatorNameForPhone(int phoneId, String name) {
4433        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4434            setTelephonyProperty(phoneId, TelephonyProperties.PROPERTY_OPERATOR_ALPHA, name);
4435        }
4436    }
4437
4438    /**
4439     * Set the numeric name (MCC+MNC) of current registered operator.
4440     * @param operator the numeric name (MCC+MNC) of current registered operator
4441     * @hide
4442     */
4443    public void setNetworkOperatorNumeric(String numeric) {
4444        int phoneId = getDefaultPhone();
4445        setNetworkOperatorNumericForPhone(phoneId, numeric);
4446    }
4447
4448    /**
4449     * Set the numeric name (MCC+MNC) of current registered operator.
4450     * @param phoneId for which phone type is set
4451     * @param operator the numeric name (MCC+MNC) of current registered operator
4452     * @hide
4453     */
4454    public void setNetworkOperatorNumericForPhone(int phoneId, String numeric) {
4455        setTelephonyProperty(phoneId, TelephonyProperties.PROPERTY_OPERATOR_NUMERIC, numeric);
4456    }
4457
4458    /**
4459     * Set roaming state of the current network, for GSM purposes.
4460     * @param isRoaming is network in romaing state or not
4461     * @hide
4462     */
4463    public void setNetworkRoaming(boolean isRoaming) {
4464        int phoneId = getDefaultPhone();
4465        setNetworkRoamingForPhone(phoneId, isRoaming);
4466    }
4467
4468    /**
4469     * Set roaming state of the current network, for GSM purposes.
4470     * @param phoneId which phone you want to set
4471     * @param isRoaming is network in romaing state or not
4472     * @hide
4473     */
4474    public void setNetworkRoamingForPhone(int phoneId, boolean isRoaming) {
4475        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4476            setTelephonyProperty(phoneId, TelephonyProperties.PROPERTY_OPERATOR_ISROAMING,
4477                    isRoaming ? "true" : "false");
4478        }
4479    }
4480
4481    /**
4482     * Set the ISO country code equivalent of the current registered
4483     * operator's MCC (Mobile Country Code).
4484     * @param iso the ISO country code equivalent of the current registered
4485     * @hide
4486     */
4487    public void setNetworkCountryIso(String iso) {
4488        int phoneId = getDefaultPhone();
4489        setNetworkCountryIsoForPhone(phoneId, iso);
4490    }
4491
4492    /**
4493     * Set the ISO country code equivalent of the current registered
4494     * operator's MCC (Mobile Country Code).
4495     * @param phoneId which phone you want to set
4496     * @param iso the ISO country code equivalent of the current registered
4497     * @hide
4498     */
4499    public void setNetworkCountryIsoForPhone(int phoneId, String iso) {
4500        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4501            setTelephonyProperty(phoneId,
4502                    TelephonyProperties.PROPERTY_OPERATOR_ISO_COUNTRY, iso);
4503        }
4504    }
4505
4506    /**
4507     * Set the network type currently in use on the device for data transmission.
4508     * @param type the network type currently in use on the device for data transmission
4509     * @hide
4510     */
4511    public void setDataNetworkType(int type) {
4512        int phoneId = getDefaultPhone();
4513        setDataNetworkTypeForPhone(phoneId, type);
4514    }
4515
4516    /**
4517     * Set the network type currently in use on the device for data transmission.
4518     * @param phoneId which phone you want to set
4519     * @param type the network type currently in use on the device for data transmission
4520     * @hide
4521     */
4522    public void setDataNetworkTypeForPhone(int phoneId, int type) {
4523        if (SubscriptionManager.isValidPhoneId(phoneId)) {
4524            setTelephonyProperty(phoneId,
4525                    TelephonyProperties.PROPERTY_DATA_NETWORK_TYPE,
4526                    ServiceState.rilRadioTechnologyToString(type));
4527        }
4528    }
4529
4530    /**
4531     * Returns the subscription ID for the given phone account.
4532     * @hide
4533     */
4534    public int getSubIdForPhoneAccount(PhoneAccount phoneAccount) {
4535        int retval = SubscriptionManager.INVALID_SUBSCRIPTION_ID;
4536        try {
4537            ITelephony service = getITelephony();
4538            if (service != null) {
4539                retval = service.getSubIdForPhoneAccount(phoneAccount);
4540            }
4541        } catch (RemoteException e) {
4542        }
4543
4544        return retval;
4545    }
4546
4547    /**
4548     * Resets telephony manager settings back to factory defaults.
4549     *
4550     * @hide
4551     */
4552    public void factoryReset(int subId) {
4553        try {
4554            Log.d(TAG, "factoryReset: subId=" + subId);
4555            ITelephony telephony = getITelephony();
4556            if (telephony != null)
4557                telephony.factoryReset(subId);
4558        } catch (RemoteException e) {
4559        }
4560    }
4561}
4562