1/*
2 * Copyright (c) 2013 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 com.android.ims;
18
19import android.app.PendingIntent;
20import android.content.Context;
21import android.content.Intent;
22import android.net.Uri;
23import android.os.IBinder;
24import android.os.Message;
25import android.os.PersistableBundle;
26import android.os.RemoteException;
27import android.os.ServiceManager;
28import android.os.SystemProperties;
29import android.provider.Settings;
30import android.telecom.TelecomManager;
31import android.telephony.CarrierConfigManager;
32import android.telephony.Rlog;
33import android.telephony.SubscriptionManager;
34import android.telephony.TelephonyManager;
35
36import com.android.ims.internal.IImsCallSession;
37import com.android.ims.internal.IImsEcbm;
38import com.android.ims.internal.IImsEcbmListener;
39import com.android.ims.internal.IImsMultiEndpoint;
40import com.android.ims.internal.IImsRegistrationListener;
41import com.android.ims.internal.IImsService;
42import com.android.ims.internal.IImsUt;
43import com.android.ims.internal.ImsCallSession;
44import com.android.ims.internal.IImsConfig;
45
46import java.io.FileDescriptor;
47import java.io.PrintWriter;
48import java.util.HashMap;
49
50/**
51 * Provides APIs for IMS services, such as initiating IMS calls, and provides access to
52 * the operator's IMS network. This class is the starting point for any IMS actions.
53 * You can acquire an instance of it with {@link #getInstance getInstance()}.</p>
54 * <p>The APIs in this class allows you to:</p>
55 *
56 * @hide
57 */
58public class ImsManager {
59
60    /*
61     * Debug flag to override configuration flag
62     */
63    public static final String PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE = "persist.dbg.volte_avail_ovr";
64    public static final int PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE_DEFAULT = 0;
65    public static final String PROPERTY_DBG_VT_AVAIL_OVERRIDE = "persist.dbg.vt_avail_ovr";
66    public static final int PROPERTY_DBG_VT_AVAIL_OVERRIDE_DEFAULT = 0;
67    public static final String PROPERTY_DBG_WFC_AVAIL_OVERRIDE = "persist.dbg.wfc_avail_ovr";
68    public static final int PROPERTY_DBG_WFC_AVAIL_OVERRIDE_DEFAULT = 0;
69
70    /**
71     * For accessing the IMS related service.
72     * Internal use only.
73     * @hide
74     */
75    private static final String IMS_SERVICE = "ims";
76
77    /**
78     * The result code to be sent back with the incoming call {@link PendingIntent}.
79     * @see #open(PendingIntent, ImsConnectionStateListener)
80     */
81    public static final int INCOMING_CALL_RESULT_CODE = 101;
82
83    /**
84     * Key to retrieve the call ID from an incoming call intent.
85     * @see #open(PendingIntent, ImsConnectionStateListener)
86     */
87    public static final String EXTRA_CALL_ID = "android:imsCallID";
88
89    /**
90     * Action to broadcast when ImsService is up.
91     * Internal use only.
92     * @hide
93     */
94    public static final String ACTION_IMS_SERVICE_UP =
95            "com.android.ims.IMS_SERVICE_UP";
96
97    /**
98     * Action to broadcast when ImsService is down.
99     * Internal use only.
100     * @hide
101     */
102    public static final String ACTION_IMS_SERVICE_DOWN =
103            "com.android.ims.IMS_SERVICE_DOWN";
104
105    /**
106     * Action to broadcast when ImsService registration fails.
107     * Internal use only.
108     * @hide
109     */
110    public static final String ACTION_IMS_REGISTRATION_ERROR =
111            "com.android.ims.REGISTRATION_ERROR";
112
113    /**
114     * Part of the ACTION_IMS_SERVICE_UP or _DOWN intents.
115     * A long value; the phone ID corresponding to the IMS service coming up or down.
116     * Internal use only.
117     * @hide
118     */
119    public static final String EXTRA_PHONE_ID = "android:phone_id";
120
121    /**
122     * Action for the incoming call intent for the Phone app.
123     * Internal use only.
124     * @hide
125     */
126    public static final String ACTION_IMS_INCOMING_CALL =
127            "com.android.ims.IMS_INCOMING_CALL";
128
129    /**
130     * Part of the ACTION_IMS_INCOMING_CALL intents.
131     * An integer value; service identifier obtained from {@link ImsManager#open}.
132     * Internal use only.
133     * @hide
134     */
135    public static final String EXTRA_SERVICE_ID = "android:imsServiceId";
136
137    /**
138     * Part of the ACTION_IMS_INCOMING_CALL intents.
139     * An boolean value; Flag to indicate that the incoming call is a normal call or call for USSD.
140     * The value "true" indicates that the incoming call is for USSD.
141     * Internal use only.
142     * @hide
143     */
144    public static final String EXTRA_USSD = "android:ussd";
145
146    /**
147     * Part of the ACTION_IMS_INCOMING_CALL intents.
148     * A boolean value; Flag to indicate whether the call is an unknown
149     * dialing call. Such calls are originated by sending commands (like
150     * AT commands) directly to modem without Android involvement.
151     * Even though they are not incoming calls, they are propagated
152     * to Phone app using same ACTION_IMS_INCOMING_CALL intent.
153     * Internal use only.
154     * @hide
155     */
156    public static final String EXTRA_IS_UNKNOWN_CALL = "android:isUnknown";
157
158    private static final String TAG = "ImsManager";
159    private static final boolean DBG = true;
160
161    private static HashMap<Integer, ImsManager> sImsManagerInstances =
162            new HashMap<Integer, ImsManager>();
163
164    private Context mContext;
165    private int mPhoneId;
166    private IImsService mImsService = null;
167    private ImsServiceDeathRecipient mDeathRecipient = new ImsServiceDeathRecipient();
168    // Ut interface for the supplementary service configuration
169    private ImsUt mUt = null;
170    // Interface to get/set ims config items
171    private ImsConfig mConfig = null;
172    private boolean mConfigUpdated = false;
173
174    private ImsConfigListener mImsConfigListener;
175
176    // ECBM interface
177    private ImsEcbm mEcbm = null;
178
179    private ImsMultiEndpoint mMultiEndpoint = null;
180
181    /**
182     * Gets a manager instance.
183     *
184     * @param context application context for creating the manager object
185     * @param phoneId the phone ID for the IMS Service
186     * @return the manager instance corresponding to the phoneId
187     */
188    public static ImsManager getInstance(Context context, int phoneId) {
189        synchronized (sImsManagerInstances) {
190            if (sImsManagerInstances.containsKey(phoneId))
191                return sImsManagerInstances.get(phoneId);
192
193            ImsManager mgr = new ImsManager(context, phoneId);
194            sImsManagerInstances.put(phoneId, mgr);
195
196            return mgr;
197        }
198    }
199
200    /**
201     * Returns the user configuration of Enhanced 4G LTE Mode setting
202     */
203    public static boolean isEnhanced4gLteModeSettingEnabledByUser(Context context) {
204        // If user can't edit Enhanced 4G LTE Mode, it assumes Enhanced 4G LTE Mode is always true.
205        // If user changes SIM from editable mode to uneditable mode, need to return true.
206        if (!getBooleanCarrierConfig(context,
207                    CarrierConfigManager.KEY_EDITABLE_ENHANCED_4G_LTE_BOOL)) {
208            return true;
209        }
210        int enabled = android.provider.Settings.Global.getInt(
211                    context.getContentResolver(),
212                    android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED, ImsConfig.FeatureValueConstants.ON);
213        return (enabled == 1) ? true : false;
214    }
215
216    /**
217     * Change persistent Enhanced 4G LTE Mode setting
218     */
219    public static void setEnhanced4gLteModeSetting(Context context, boolean enabled) {
220        int value = enabled ? 1 : 0;
221        android.provider.Settings.Global.putInt(
222                context.getContentResolver(),
223                android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED, value);
224
225        if (isNonTtyOrTtyOnVolteEnabled(context)) {
226            ImsManager imsManager = ImsManager.getInstance(context,
227                    SubscriptionManager.getDefaultVoicePhoneId());
228            if (imsManager != null) {
229                try {
230                    imsManager.setAdvanced4GMode(enabled);
231                } catch (ImsException ie) {
232                    // do nothing
233                }
234            }
235        }
236    }
237
238    /**
239     * Indicates whether the call is non-TTY or if TTY - whether TTY on VoLTE is
240     * supported.
241     */
242    public static boolean isNonTtyOrTtyOnVolteEnabled(Context context) {
243        if (getBooleanCarrierConfig(context,
244                CarrierConfigManager.KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL)) {
245            return true;
246        }
247
248        return Settings.Secure.getInt(context.getContentResolver(),
249                Settings.Secure.PREFERRED_TTY_MODE, TelecomManager.TTY_MODE_OFF)
250                == TelecomManager.TTY_MODE_OFF;
251    }
252
253    /**
254     * Returns a platform configuration for VoLTE which may override the user setting.
255     */
256    public static boolean isVolteEnabledByPlatform(Context context) {
257        if (SystemProperties.getInt(PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE,
258                PROPERTY_DBG_VOLTE_AVAIL_OVERRIDE_DEFAULT) == 1) {
259            return true;
260        }
261
262        return context.getResources().getBoolean(
263                com.android.internal.R.bool.config_device_volte_available)
264                && getBooleanCarrierConfig(context,
265                        CarrierConfigManager.KEY_CARRIER_VOLTE_AVAILABLE_BOOL)
266                && isGbaValid(context);
267    }
268
269    /*
270     * Indicates whether VoLTE is provisioned on device
271     */
272    public static boolean isVolteProvisionedOnDevice(Context context) {
273        boolean isProvisioned = true;
274        if (getBooleanCarrierConfig(context,
275                    CarrierConfigManager.KEY_CARRIER_VOLTE_PROVISIONING_REQUIRED_BOOL)) {
276            isProvisioned = false; // disable on any error
277            ImsManager mgr = ImsManager.getInstance(context,
278                    SubscriptionManager.getDefaultVoicePhoneId());
279            if (mgr != null) {
280                try {
281                    ImsConfig config = mgr.getConfigInterface();
282                    if (config != null) {
283                        isProvisioned = config.getVolteProvisioned();
284                    }
285                } catch (ImsException ie) {
286                    // do nothing
287                }
288            }
289        }
290
291        return isProvisioned;
292    }
293
294    /**
295     * Returns a platform configuration for VT which may override the user setting.
296     *
297     * Note: VT presumes that VoLTE is enabled (these are configuration settings
298     * which must be done correctly).
299     */
300    public static boolean isVtEnabledByPlatform(Context context) {
301        if (SystemProperties.getInt(PROPERTY_DBG_VT_AVAIL_OVERRIDE,
302                PROPERTY_DBG_VT_AVAIL_OVERRIDE_DEFAULT) == 1) {
303            return true;
304        }
305
306        return
307                context.getResources().getBoolean(
308                        com.android.internal.R.bool.config_device_vt_available) &&
309                getBooleanCarrierConfig(context,
310                        CarrierConfigManager.KEY_CARRIER_VT_AVAILABLE_BOOL) &&
311                isGbaValid(context);
312    }
313
314    /**
315     * Returns the user configuration of VT setting
316     */
317    public static boolean isVtEnabledByUser(Context context) {
318        int enabled = android.provider.Settings.Global.getInt(context.getContentResolver(),
319                android.provider.Settings.Global.VT_IMS_ENABLED,
320                ImsConfig.FeatureValueConstants.ON);
321        return (enabled == 1) ? true : false;
322    }
323
324    /**
325     * Change persistent VT enabled setting
326     */
327    public static void setVtSetting(Context context, boolean enabled) {
328        int value = enabled ? 1 : 0;
329        android.provider.Settings.Global.putInt(context.getContentResolver(),
330                android.provider.Settings.Global.VT_IMS_ENABLED, value);
331
332        ImsManager imsManager = ImsManager.getInstance(context,
333                SubscriptionManager.getDefaultVoicePhoneId());
334        if (imsManager != null) {
335            try {
336                ImsConfig config = imsManager.getConfigInterface();
337                config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VIDEO_OVER_LTE,
338                        TelephonyManager.NETWORK_TYPE_LTE,
339                        enabled ? ImsConfig.FeatureValueConstants.ON
340                                : ImsConfig.FeatureValueConstants.OFF,
341                        imsManager.mImsConfigListener);
342
343                if (enabled) {
344                    imsManager.turnOnIms();
345                } else if (getBooleanCarrierConfig(context,
346                        CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)
347                        && (!isVolteEnabledByPlatform(context)
348                        || !isEnhanced4gLteModeSettingEnabledByUser(context))) {
349                    log("setVtSetting() : imsServiceAllowTurnOff -> turnOffIms");
350                    imsManager.turnOffIms();
351                }
352            } catch (ImsException e) {
353                loge("setVtSetting(): " + e);
354            }
355        }
356    }
357
358    /**
359     * Returns the user configuration of WFC setting
360     */
361    public static boolean isWfcEnabledByUser(Context context) {
362        int enabled = android.provider.Settings.Global.getInt(context.getContentResolver(),
363                android.provider.Settings.Global.WFC_IMS_ENABLED,
364                getBooleanCarrierConfig(context,
365                        CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL) ?
366                        ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
367        return (enabled == 1) ? true : false;
368    }
369
370    /**
371     * Change persistent WFC enabled setting
372     */
373    public static void setWfcSetting(Context context, boolean enabled) {
374        int value = enabled ? 1 : 0;
375        android.provider.Settings.Global.putInt(context.getContentResolver(),
376                android.provider.Settings.Global.WFC_IMS_ENABLED, value);
377
378        ImsManager imsManager = ImsManager.getInstance(context,
379                SubscriptionManager.getDefaultVoicePhoneId());
380        if (imsManager != null) {
381            try {
382                ImsConfig config = imsManager.getConfigInterface();
383                config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_WIFI,
384                        TelephonyManager.NETWORK_TYPE_IWLAN,
385                        enabled ? ImsConfig.FeatureValueConstants.ON
386                                : ImsConfig.FeatureValueConstants.OFF,
387                        imsManager.mImsConfigListener);
388
389                if (enabled) {
390                    imsManager.turnOnIms();
391                } else if (getBooleanCarrierConfig(context,
392                        CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)
393                        && (!isVolteEnabledByPlatform(context)
394                        || !isEnhanced4gLteModeSettingEnabledByUser(context))) {
395                    log("setWfcSetting() : imsServiceAllowTurnOff -> turnOffIms");
396                    imsManager.turnOffIms();
397                }
398
399                // Force IMS to register over LTE when turning off WFC
400                setWfcModeInternal(context, enabled
401                        ? getWfcMode(context)
402                        : ImsConfig.WfcModeFeatureValueConstants.CELLULAR_PREFERRED);
403            } catch (ImsException e) {
404                loge("setWfcSetting(): " + e);
405            }
406        }
407    }
408
409    /**
410     * Returns the user configuration of WFC modem setting
411     */
412    public static int getWfcMode(Context context) {
413        int setting = android.provider.Settings.Global.getInt(context.getContentResolver(),
414                android.provider.Settings.Global.WFC_IMS_MODE, getIntCarrierConfig(context,
415                        CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT));
416        if (DBG) log("getWfcMode - setting=" + setting);
417        return setting;
418    }
419
420    /**
421     * Returns the user configuration of WFC modem setting
422     */
423    public static void setWfcMode(Context context, int wfcMode) {
424        if (DBG) log("setWfcMode - setting=" + wfcMode);
425        android.provider.Settings.Global.putInt(context.getContentResolver(),
426                android.provider.Settings.Global.WFC_IMS_MODE, wfcMode);
427
428        setWfcModeInternal(context, wfcMode);
429    }
430
431    private static void setWfcModeInternal(Context context, int wfcMode) {
432        final ImsManager imsManager = ImsManager.getInstance(context,
433                SubscriptionManager.getDefaultVoicePhoneId());
434        if (imsManager != null) {
435            final int value = wfcMode;
436            Thread thread = new Thread(new Runnable() {
437                public void run() {
438                    try {
439                        imsManager.getConfigInterface().setProvisionedValue(
440                                ImsConfig.ConfigConstants.VOICE_OVER_WIFI_MODE,
441                                value);
442                    } catch (ImsException e) {
443                        // do nothing
444                    }
445                }
446            });
447            thread.start();
448        }
449    }
450
451    /**
452     * Returns the user configuration of WFC roaming setting
453     */
454    public static boolean isWfcRoamingEnabledByUser(Context context) {
455        int enabled = android.provider.Settings.Global.getInt(context.getContentResolver(),
456                android.provider.Settings.Global.WFC_IMS_ROAMING_ENABLED,
457                getBooleanCarrierConfig(context,
458                        CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL) ?
459                        ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
460        return (enabled == 1) ? true : false;
461    }
462
463    /**
464     * Change persistent WFC roaming enabled setting
465     */
466    public static void setWfcRoamingSetting(Context context, boolean enabled) {
467        android.provider.Settings.Global.putInt(context.getContentResolver(),
468                android.provider.Settings.Global.WFC_IMS_ROAMING_ENABLED,
469                enabled ? ImsConfig.FeatureValueConstants.ON
470                        : ImsConfig.FeatureValueConstants.OFF);
471
472        setWfcRoamingSettingInternal(context, enabled);
473    }
474
475    private static void setWfcRoamingSettingInternal(Context context, boolean enabled) {
476        final ImsManager imsManager = ImsManager.getInstance(context,
477                SubscriptionManager.getDefaultVoicePhoneId());
478        if (imsManager != null) {
479            final int value = enabled
480                    ? ImsConfig.FeatureValueConstants.ON
481                    : ImsConfig.FeatureValueConstants.OFF;
482            Thread thread = new Thread(new Runnable() {
483                public void run() {
484                    try {
485                        imsManager.getConfigInterface().setProvisionedValue(
486                                ImsConfig.ConfigConstants.VOICE_OVER_WIFI_ROAMING,
487                                value);
488                    } catch (ImsException e) {
489                        // do nothing
490                    }
491                }
492            });
493            thread.start();
494        }
495    }
496
497    /**
498     * Returns a platform configuration for WFC which may override the user
499     * setting. Note: WFC presumes that VoLTE is enabled (these are
500     * configuration settings which must be done correctly).
501     */
502    public static boolean isWfcEnabledByPlatform(Context context) {
503        if (SystemProperties.getInt(PROPERTY_DBG_WFC_AVAIL_OVERRIDE,
504                PROPERTY_DBG_WFC_AVAIL_OVERRIDE_DEFAULT) == 1) {
505            return true;
506        }
507
508        return
509               context.getResources().getBoolean(
510                       com.android.internal.R.bool.config_device_wfc_ims_available) &&
511               getBooleanCarrierConfig(context,
512                       CarrierConfigManager.KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL) &&
513               isGbaValid(context);
514    }
515
516    /**
517     * If carrier requires that IMS is only available if GBA capable SIM is used,
518     * then this function checks GBA bit in EF IST.
519     *
520     * Format of EF IST is defined in 3GPP TS 31.103 (Section 4.2.7).
521     */
522    private static boolean isGbaValid(Context context) {
523        if (getBooleanCarrierConfig(context,
524                CarrierConfigManager.KEY_CARRIER_IMS_GBA_REQUIRED_BOOL)) {
525            final TelephonyManager telephonyManager = TelephonyManager.getDefault();
526            String efIst = telephonyManager.getIsimIst();
527            if (efIst == null) {
528                loge("ISF is NULL");
529                return true;
530            }
531            boolean result = efIst != null && efIst.length() > 1 &&
532                    (0x02 & (byte)efIst.charAt(1)) != 0;
533            if (DBG) log("GBA capable=" + result + ", ISF=" + efIst);
534            return result;
535        }
536        return true;
537    }
538
539    /**
540     * Sync carrier config and user settings with ImsConfig.
541     *
542     * @param context for the manager object
543     * @param phoneId phone id
544     * @param force update
545     */
546    public static void updateImsServiceConfig(Context context, int phoneId, boolean force) {
547        if (!force) {
548            if (TelephonyManager.getDefault().getSimState() != TelephonyManager.SIM_STATE_READY) {
549                log("updateImsServiceConfig: SIM not ready");
550                // Don't disable IMS if SIM is not ready
551                return;
552            }
553        }
554
555        final ImsManager imsManager = ImsManager.getInstance(context, phoneId);
556        if (imsManager != null && (!imsManager.mConfigUpdated || force)) {
557            try {
558                boolean isImsUsed = imsManager.updateVolteFeatureValue();
559                isImsUsed |= imsManager.updateVideoCallFeatureValue();
560                isImsUsed |= imsManager.updateWfcFeatureAndProvisionedValues();
561
562                if (isImsUsed || !getBooleanCarrierConfig(context,
563                      CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)) {
564                    // Turn on IMS if it is used.
565                    // Also, if turning off is not allowed for current carrier,
566                    // we need to turn IMS on because it might be turned off before
567                    // phone switched to current carrier.
568                    imsManager.turnOnIms();
569                } else {
570                    // Turn off IMS if it is not used AND turning off is allowed for carrier.
571                    imsManager.turnOffIms();
572                }
573
574                imsManager.mConfigUpdated = true;
575            } catch (ImsException e) {
576                loge("updateImsServiceConfig: " + e);
577                imsManager.mConfigUpdated = false;
578            }
579        }
580    }
581
582    /**
583     * Update VoLTE config
584     * @return whether feature is On
585     * @throws ImsException
586     */
587    private boolean updateVolteFeatureValue() throws ImsException {
588        boolean available = isVolteEnabledByPlatform(mContext);
589        boolean enabled = isEnhanced4gLteModeSettingEnabledByUser(mContext);
590        boolean isNonTty = isNonTtyOrTtyOnVolteEnabled(mContext);
591        boolean isFeatureOn = available && enabled && isNonTty;
592
593        log("updateVolteFeatureValue: available = " + available
594                + ", enabled = " + enabled
595                + ", nonTTY = " + isNonTty);
596
597        getConfigInterface().setFeatureValue(
598                ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_LTE,
599                TelephonyManager.NETWORK_TYPE_LTE,
600                isFeatureOn ?
601                        ImsConfig.FeatureValueConstants.ON :
602                        ImsConfig.FeatureValueConstants.OFF,
603                mImsConfigListener);
604
605        return isFeatureOn;
606    }
607
608    /**
609     * Update VC config
610     * @return whether feature is On
611     * @throws ImsException
612     */
613    private boolean updateVideoCallFeatureValue() throws ImsException {
614        boolean available = isVtEnabledByPlatform(mContext);
615        boolean enabled = isEnhanced4gLteModeSettingEnabledByUser(mContext) &&
616                isVtEnabledByUser(mContext);
617        boolean isNonTty = isNonTtyOrTtyOnVolteEnabled(mContext);
618        boolean isFeatureOn = available && enabled && isNonTty;
619
620        log("updateVideoCallFeatureValue: available = " + available
621                + ", enabled = " + enabled
622                + ", nonTTY = " + isNonTty);
623
624        getConfigInterface().setFeatureValue(
625                ImsConfig.FeatureConstants.FEATURE_TYPE_VIDEO_OVER_LTE,
626                TelephonyManager.NETWORK_TYPE_LTE,
627                isFeatureOn ?
628                        ImsConfig.FeatureValueConstants.ON :
629                        ImsConfig.FeatureValueConstants.OFF,
630                mImsConfigListener);
631
632        return isFeatureOn;
633    }
634
635    /**
636     * Update WFC config
637     * @return whether feature is On
638     * @throws ImsException
639     */
640    private boolean updateWfcFeatureAndProvisionedValues() throws ImsException {
641        boolean available = isWfcEnabledByPlatform(mContext);
642        boolean enabled = isWfcEnabledByUser(mContext);
643        int mode = getWfcMode(mContext);
644        boolean roaming = isWfcRoamingEnabledByUser(mContext);
645        boolean isFeatureOn = available && enabled;
646
647        log("updateWfcFeatureAndProvisionedValues: available = " + available
648                + ", enabled = " + enabled
649                + ", mode = " + mode
650                + ", roaming = " + roaming);
651
652        getConfigInterface().setFeatureValue(
653                ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_WIFI,
654                TelephonyManager.NETWORK_TYPE_IWLAN,
655                isFeatureOn ?
656                        ImsConfig.FeatureValueConstants.ON :
657                        ImsConfig.FeatureValueConstants.OFF,
658                mImsConfigListener);
659
660        if (!isFeatureOn) {
661            mode = ImsConfig.WfcModeFeatureValueConstants.CELLULAR_PREFERRED;
662            roaming = false;
663        }
664        setWfcModeInternal(mContext, mode);
665        setWfcRoamingSettingInternal(mContext, roaming);
666
667        return isFeatureOn;
668    }
669
670    private ImsManager(Context context, int phoneId) {
671        mContext = context;
672        mPhoneId = phoneId;
673        createImsService(true);
674    }
675
676    /*
677     * Returns a flag indicating whether the IMS service is available.
678     */
679    public boolean isServiceAvailable() {
680        if (mImsService != null) {
681            return true;
682        }
683
684        IBinder binder = ServiceManager.checkService(getImsServiceName(mPhoneId));
685        if (binder != null) {
686            return true;
687        }
688
689        return false;
690    }
691
692    public void setImsConfigListener(ImsConfigListener listener) {
693        mImsConfigListener = listener;
694    }
695
696    /**
697     * Opens the IMS service for making calls and/or receiving generic IMS calls.
698     * The caller may make subsquent calls through {@link #makeCall}.
699     * The IMS service will register the device to the operator's network with the credentials
700     * (from ISIM) periodically in order to receive calls from the operator's network.
701     * When the IMS service receives a new call, it will send out an intent with
702     * the provided action string.
703     * The intent contains a call ID extra {@link getCallId} and it can be used to take a call.
704     *
705     * @param serviceClass a service class specified in {@link ImsServiceClass}
706     *      For VoLTE service, it MUST be a {@link ImsServiceClass#MMTEL}.
707     * @param incomingCallPendingIntent When an incoming call is received,
708     *        the IMS service will call {@link PendingIntent#send(Context, int, Intent)} to
709     *        send back the intent to the caller with {@link #INCOMING_CALL_RESULT_CODE}
710     *        as the result code and the intent to fill in the call ID; It cannot be null
711     * @param listener To listen to IMS registration events; It cannot be null
712     * @return identifier (greater than 0) for the specified service
713     * @throws NullPointerException if {@code incomingCallPendingIntent}
714     *      or {@code listener} is null
715     * @throws ImsException if calling the IMS service results in an error
716     * @see #getCallId
717     * @see #getServiceId
718     */
719    public int open(int serviceClass, PendingIntent incomingCallPendingIntent,
720            ImsConnectionStateListener listener) throws ImsException {
721        checkAndThrowExceptionIfServiceUnavailable();
722
723        if (incomingCallPendingIntent == null) {
724            throw new NullPointerException("incomingCallPendingIntent can't be null");
725        }
726
727        if (listener == null) {
728            throw new NullPointerException("listener can't be null");
729        }
730
731        int result = 0;
732
733        try {
734            result = mImsService.open(mPhoneId, serviceClass, incomingCallPendingIntent,
735                    createRegistrationListenerProxy(serviceClass, listener));
736        } catch (RemoteException e) {
737            throw new ImsException("open()", e,
738                    ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
739        }
740
741        if (result <= 0) {
742            // If the return value is a minus value,
743            // it means that an error occurred in the service.
744            // So, it needs to convert to the reason code specified in ImsReasonInfo.
745            throw new ImsException("open()", (result * (-1)));
746        }
747
748        return result;
749    }
750
751    /**
752     * Closes the specified service ({@link ImsServiceClass}) not to make/receive calls.
753     * All the resources that were allocated to the service are also released.
754     *
755     * @param serviceId a service id to be closed which is obtained from {@link ImsManager#open}
756     * @throws ImsException if calling the IMS service results in an error
757     */
758    public void close(int serviceId) throws ImsException {
759        checkAndThrowExceptionIfServiceUnavailable();
760
761        try {
762            mImsService.close(serviceId);
763        } catch (RemoteException e) {
764            throw new ImsException("close()", e,
765                    ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
766        } finally {
767            mUt = null;
768            mConfig = null;
769            mEcbm = null;
770            mMultiEndpoint = null;
771        }
772    }
773
774    /**
775     * Gets the configuration interface to provision / withdraw the supplementary service settings.
776     *
777     * @param serviceId a service id which is obtained from {@link ImsManager#open}
778     * @return the Ut interface instance
779     * @throws ImsException if getting the Ut interface results in an error
780     */
781    public ImsUtInterface getSupplementaryServiceConfiguration(int serviceId)
782            throws ImsException {
783        // FIXME: manage the multiple Ut interfaces based on the service id
784        if (mUt == null) {
785            checkAndThrowExceptionIfServiceUnavailable();
786
787            try {
788                IImsUt iUt = mImsService.getUtInterface(serviceId);
789
790                if (iUt == null) {
791                    throw new ImsException("getSupplementaryServiceConfiguration()",
792                            ImsReasonInfo.CODE_UT_NOT_SUPPORTED);
793                }
794
795                mUt = new ImsUt(iUt);
796            } catch (RemoteException e) {
797                throw new ImsException("getSupplementaryServiceConfiguration()", e,
798                        ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
799            }
800        }
801
802        return mUt;
803    }
804
805    /**
806     * Checks if the IMS service has successfully registered to the IMS network
807     * with the specified service & call type.
808     *
809     * @param serviceId a service id which is obtained from {@link ImsManager#open}
810     * @param serviceType a service type that is specified in {@link ImsCallProfile}
811     *        {@link ImsCallProfile#SERVICE_TYPE_NORMAL}
812     *        {@link ImsCallProfile#SERVICE_TYPE_EMERGENCY}
813     * @param callType a call type that is specified in {@link ImsCallProfile}
814     *        {@link ImsCallProfile#CALL_TYPE_VOICE_N_VIDEO}
815     *        {@link ImsCallProfile#CALL_TYPE_VOICE}
816     *        {@link ImsCallProfile#CALL_TYPE_VT}
817     *        {@link ImsCallProfile#CALL_TYPE_VS}
818     * @return true if the specified service id is connected to the IMS network;
819     *        false otherwise
820     * @throws ImsException if calling the IMS service results in an error
821     */
822    public boolean isConnected(int serviceId, int serviceType, int callType)
823            throws ImsException {
824        checkAndThrowExceptionIfServiceUnavailable();
825
826        try {
827            return mImsService.isConnected(serviceId, serviceType, callType);
828        } catch (RemoteException e) {
829            throw new ImsException("isServiceConnected()", e,
830                    ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
831        }
832    }
833
834    /**
835     * Checks if the specified IMS service is opend.
836     *
837     * @param serviceId a service id which is obtained from {@link ImsManager#open}
838     * @return true if the specified service id is opened; false otherwise
839     * @throws ImsException if calling the IMS service results in an error
840     */
841    public boolean isOpened(int serviceId) throws ImsException {
842        checkAndThrowExceptionIfServiceUnavailable();
843
844        try {
845            return mImsService.isOpened(serviceId);
846        } catch (RemoteException e) {
847            throw new ImsException("isOpened()", e,
848                    ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
849        }
850    }
851
852    /**
853     * Creates a {@link ImsCallProfile} from the service capabilities & IMS registration state.
854     *
855     * @param serviceId a service id which is obtained from {@link ImsManager#open}
856     * @param serviceType a service type that is specified in {@link ImsCallProfile}
857     *        {@link ImsCallProfile#SERVICE_TYPE_NONE}
858     *        {@link ImsCallProfile#SERVICE_TYPE_NORMAL}
859     *        {@link ImsCallProfile#SERVICE_TYPE_EMERGENCY}
860     * @param callType a call type that is specified in {@link ImsCallProfile}
861     *        {@link ImsCallProfile#CALL_TYPE_VOICE}
862     *        {@link ImsCallProfile#CALL_TYPE_VT}
863     *        {@link ImsCallProfile#CALL_TYPE_VT_TX}
864     *        {@link ImsCallProfile#CALL_TYPE_VT_RX}
865     *        {@link ImsCallProfile#CALL_TYPE_VT_NODIR}
866     *        {@link ImsCallProfile#CALL_TYPE_VS}
867     *        {@link ImsCallProfile#CALL_TYPE_VS_TX}
868     *        {@link ImsCallProfile#CALL_TYPE_VS_RX}
869     * @return a {@link ImsCallProfile} object
870     * @throws ImsException if calling the IMS service results in an error
871     */
872    public ImsCallProfile createCallProfile(int serviceId,
873            int serviceType, int callType) throws ImsException {
874        checkAndThrowExceptionIfServiceUnavailable();
875
876        try {
877            return mImsService.createCallProfile(serviceId, serviceType, callType);
878        } catch (RemoteException e) {
879            throw new ImsException("createCallProfile()", e,
880                    ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
881        }
882    }
883
884    /**
885     * Creates a {@link ImsCall} to make a call.
886     *
887     * @param serviceId a service id which is obtained from {@link ImsManager#open}
888     * @param profile a call profile to make the call
889     *      (it contains service type, call type, media information, etc.)
890     * @param participants participants to invite the conference call
891     * @param listener listen to the call events from {@link ImsCall}
892     * @return a {@link ImsCall} object
893     * @throws ImsException if calling the IMS service results in an error
894     */
895    public ImsCall makeCall(int serviceId, ImsCallProfile profile, String[] callees,
896            ImsCall.Listener listener) throws ImsException {
897        if (DBG) {
898            log("makeCall :: serviceId=" + serviceId
899                    + ", profile=" + profile + ", callees=" + callees);
900        }
901
902        checkAndThrowExceptionIfServiceUnavailable();
903
904        ImsCall call = new ImsCall(mContext, profile);
905
906        call.setListener(listener);
907        ImsCallSession session = createCallSession(serviceId, profile);
908
909        if ((callees != null) && (callees.length == 1)) {
910            call.start(session, callees[0]);
911        } else {
912            call.start(session, callees);
913        }
914
915        return call;
916    }
917
918    /**
919     * Creates a {@link ImsCall} to take an incoming call.
920     *
921     * @param serviceId a service id which is obtained from {@link ImsManager#open}
922     * @param incomingCallIntent the incoming call broadcast intent
923     * @param listener to listen to the call events from {@link ImsCall}
924     * @return a {@link ImsCall} object
925     * @throws ImsException if calling the IMS service results in an error
926     */
927    public ImsCall takeCall(int serviceId, Intent incomingCallIntent,
928            ImsCall.Listener listener) throws ImsException {
929        if (DBG) {
930            log("takeCall :: serviceId=" + serviceId
931                    + ", incomingCall=" + incomingCallIntent);
932        }
933
934        checkAndThrowExceptionIfServiceUnavailable();
935
936        if (incomingCallIntent == null) {
937            throw new ImsException("Can't retrieve session with null intent",
938                    ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
939        }
940
941        int incomingServiceId = getServiceId(incomingCallIntent);
942
943        if (serviceId != incomingServiceId) {
944            throw new ImsException("Service id is mismatched in the incoming call intent",
945                    ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
946        }
947
948        String callId = getCallId(incomingCallIntent);
949
950        if (callId == null) {
951            throw new ImsException("Call ID missing in the incoming call intent",
952                    ImsReasonInfo.CODE_LOCAL_ILLEGAL_ARGUMENT);
953        }
954
955        try {
956            IImsCallSession session = mImsService.getPendingCallSession(serviceId, callId);
957
958            if (session == null) {
959                throw new ImsException("No pending session for the call",
960                        ImsReasonInfo.CODE_LOCAL_NO_PENDING_CALL);
961            }
962
963            ImsCall call = new ImsCall(mContext, session.getCallProfile());
964
965            call.attachSession(new ImsCallSession(session));
966            call.setListener(listener);
967
968            return call;
969        } catch (Throwable t) {
970            throw new ImsException("takeCall()", t, ImsReasonInfo.CODE_UNSPECIFIED);
971        }
972    }
973
974    /**
975     * Gets the config interface to get/set service/capability parameters.
976     *
977     * @return the ImsConfig instance.
978     * @throws ImsException if getting the setting interface results in an error.
979     */
980    public ImsConfig getConfigInterface() throws ImsException {
981
982        if (mConfig == null) {
983            checkAndThrowExceptionIfServiceUnavailable();
984
985            try {
986                IImsConfig config = mImsService.getConfigInterface(mPhoneId);
987                if (config == null) {
988                    throw new ImsException("getConfigInterface()",
989                            ImsReasonInfo.CODE_LOCAL_SERVICE_UNAVAILABLE);
990                }
991                mConfig = new ImsConfig(config, mContext);
992            } catch (RemoteException e) {
993                throw new ImsException("getConfigInterface()", e,
994                        ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
995            }
996        }
997        if (DBG) log("getConfigInterface(), mConfig= " + mConfig);
998        return mConfig;
999    }
1000
1001    public void setUiTTYMode(Context context, int serviceId, int uiTtyMode, Message onComplete)
1002            throws ImsException {
1003
1004        checkAndThrowExceptionIfServiceUnavailable();
1005
1006        try {
1007            mImsService.setUiTTYMode(serviceId, uiTtyMode, onComplete);
1008        } catch (RemoteException e) {
1009            throw new ImsException("setTTYMode()", e,
1010                    ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1011        }
1012
1013        if (!getBooleanCarrierConfig(context,
1014                CarrierConfigManager.KEY_CARRIER_VOLTE_TTY_SUPPORTED_BOOL)) {
1015            setAdvanced4GMode((uiTtyMode == TelecomManager.TTY_MODE_OFF) &&
1016                    isEnhanced4gLteModeSettingEnabledByUser(context));
1017        }
1018    }
1019
1020    /**
1021     * Get the boolean config from carrier config manager.
1022     *
1023     * @param context the context to get carrier service
1024     * @param key config key defined in CarrierConfigManager
1025     * @return boolean value of corresponding key.
1026     */
1027    private static boolean getBooleanCarrierConfig(Context context, String key) {
1028        CarrierConfigManager configManager = (CarrierConfigManager) context.getSystemService(
1029                Context.CARRIER_CONFIG_SERVICE);
1030        PersistableBundle b = null;
1031        if (configManager != null) {
1032            b = configManager.getConfig();
1033        }
1034        if (b != null) {
1035            return b.getBoolean(key);
1036        } else {
1037            // Return static default defined in CarrierConfigManager.
1038            return CarrierConfigManager.getDefaultConfig().getBoolean(key);
1039        }
1040    }
1041
1042    /**
1043     * Get the int config from carrier config manager.
1044     *
1045     * @param context the context to get carrier service
1046     * @param key config key defined in CarrierConfigManager
1047     * @return integer value of corresponding key.
1048     */
1049    private static int getIntCarrierConfig(Context context, String key) {
1050        CarrierConfigManager configManager = (CarrierConfigManager) context.getSystemService(
1051                Context.CARRIER_CONFIG_SERVICE);
1052        PersistableBundle b = null;
1053        if (configManager != null) {
1054            b = configManager.getConfig();
1055        }
1056        if (b != null) {
1057            return b.getInt(key);
1058        } else {
1059            // Return static default defined in CarrierConfigManager.
1060            return CarrierConfigManager.getDefaultConfig().getInt(key);
1061        }
1062    }
1063
1064    /**
1065     * Gets the call ID from the specified incoming call broadcast intent.
1066     *
1067     * @param incomingCallIntent the incoming call broadcast intent
1068     * @return the call ID or null if the intent does not contain it
1069     */
1070    private static String getCallId(Intent incomingCallIntent) {
1071        if (incomingCallIntent == null) {
1072            return null;
1073        }
1074
1075        return incomingCallIntent.getStringExtra(EXTRA_CALL_ID);
1076    }
1077
1078    /**
1079     * Gets the service type from the specified incoming call broadcast intent.
1080     *
1081     * @param incomingCallIntent the incoming call broadcast intent
1082     * @return the service identifier or -1 if the intent does not contain it
1083     */
1084    private static int getServiceId(Intent incomingCallIntent) {
1085        if (incomingCallIntent == null) {
1086            return (-1);
1087        }
1088
1089        return incomingCallIntent.getIntExtra(EXTRA_SERVICE_ID, -1);
1090    }
1091
1092    /**
1093     * Binds the IMS service only if the service is not created.
1094     */
1095    private void checkAndThrowExceptionIfServiceUnavailable()
1096            throws ImsException {
1097        if (mImsService == null) {
1098            createImsService(true);
1099
1100            if (mImsService == null) {
1101                throw new ImsException("Service is unavailable",
1102                        ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1103            }
1104        }
1105    }
1106
1107    private static String getImsServiceName(int phoneId) {
1108        // TODO: MSIM implementation needs to decide on service name as a function of phoneId
1109        return IMS_SERVICE;
1110    }
1111
1112    /**
1113     * Binds the IMS service to make/receive the call.
1114     */
1115    private void createImsService(boolean checkService) {
1116        if (checkService) {
1117            IBinder binder = ServiceManager.checkService(getImsServiceName(mPhoneId));
1118
1119            if (binder == null) {
1120                return;
1121            }
1122        }
1123
1124        IBinder b = ServiceManager.getService(getImsServiceName(mPhoneId));
1125
1126        if (b != null) {
1127            try {
1128                b.linkToDeath(mDeathRecipient, 0);
1129            } catch (RemoteException e) {
1130            }
1131        }
1132
1133        mImsService = IImsService.Stub.asInterface(b);
1134    }
1135
1136    /**
1137     * Creates a {@link ImsCallSession} with the specified call profile.
1138     * Use other methods, if applicable, instead of interacting with
1139     * {@link ImsCallSession} directly.
1140     *
1141     * @param serviceId a service id which is obtained from {@link ImsManager#open}
1142     * @param profile a call profile to make the call
1143     */
1144    private ImsCallSession createCallSession(int serviceId,
1145            ImsCallProfile profile) throws ImsException {
1146        try {
1147            return new ImsCallSession(mImsService.createCallSession(serviceId, profile, null));
1148        } catch (RemoteException e) {
1149            return null;
1150        }
1151    }
1152
1153    private ImsRegistrationListenerProxy createRegistrationListenerProxy(int serviceClass,
1154            ImsConnectionStateListener listener) {
1155        ImsRegistrationListenerProxy proxy =
1156                new ImsRegistrationListenerProxy(serviceClass, listener);
1157        return proxy;
1158    }
1159
1160    private static void log(String s) {
1161        Rlog.d(TAG, s);
1162    }
1163
1164    private static void loge(String s) {
1165        Rlog.e(TAG, s);
1166    }
1167
1168    private static void loge(String s, Throwable t) {
1169        Rlog.e(TAG, s, t);
1170    }
1171
1172    /**
1173     * Used for turning on IMS.if its off already
1174     */
1175    private void turnOnIms() throws ImsException {
1176        checkAndThrowExceptionIfServiceUnavailable();
1177
1178        try {
1179            mImsService.turnOnIms(mPhoneId);
1180        } catch (RemoteException e) {
1181            throw new ImsException("turnOnIms() ", e, ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1182        }
1183    }
1184
1185    private boolean isImsTurnOffAllowed() {
1186        return getBooleanCarrierConfig(mContext,
1187                CarrierConfigManager.KEY_CARRIER_ALLOW_TURNOFF_IMS_BOOL)
1188                && (!isWfcEnabledByPlatform(mContext)
1189                || !isWfcEnabledByUser(mContext));
1190    }
1191
1192    private void setAdvanced4GMode(boolean turnOn) throws ImsException {
1193        checkAndThrowExceptionIfServiceUnavailable();
1194
1195        try {
1196            ImsConfig config = getConfigInterface();
1197            if (config != null && (turnOn || !isImsTurnOffAllowed())) {
1198                config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VOICE_OVER_LTE,
1199                        TelephonyManager.NETWORK_TYPE_LTE, turnOn ? 1 : 0, mImsConfigListener);
1200
1201                if (isVtEnabledByPlatform(mContext)) {
1202                    boolean enableViLte = turnOn && isVtEnabledByUser(mContext);
1203                    config.setFeatureValue(ImsConfig.FeatureConstants.FEATURE_TYPE_VIDEO_OVER_LTE,
1204                            TelephonyManager.NETWORK_TYPE_LTE,
1205                            enableViLte ? 1 : 0,
1206                            mImsConfigListener);
1207                }
1208            }
1209        } catch (ImsException e) {
1210            log("setAdvanced4GMode() : " + e);
1211        }
1212        if (turnOn) {
1213            turnOnIms();
1214        } else if (isImsTurnOffAllowed()) {
1215            log("setAdvanced4GMode() : imsServiceAllowTurnOff -> turnOffIms");
1216            turnOffIms();
1217        }
1218    }
1219
1220    /**
1221     * Used for turning off IMS completely in order to make the device CSFB'ed.
1222     * Once turned off, all calls will be over CS.
1223     */
1224    private void turnOffIms() throws ImsException {
1225        checkAndThrowExceptionIfServiceUnavailable();
1226
1227        try {
1228            mImsService.turnOffIms(mPhoneId);
1229        } catch (RemoteException e) {
1230            throw new ImsException("turnOffIms() ", e, ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1231        }
1232    }
1233
1234    /**
1235     * Death recipient class for monitoring IMS service.
1236     */
1237    private class ImsServiceDeathRecipient implements IBinder.DeathRecipient {
1238        @Override
1239        public void binderDied() {
1240            mImsService = null;
1241            mUt = null;
1242            mConfig = null;
1243            mEcbm = null;
1244            mMultiEndpoint = null;
1245
1246            if (mContext != null) {
1247                Intent intent = new Intent(ACTION_IMS_SERVICE_DOWN);
1248                intent.putExtra(EXTRA_PHONE_ID, mPhoneId);
1249                mContext.sendBroadcast(new Intent(intent));
1250            }
1251        }
1252    }
1253
1254    /**
1255     * Adapter class for {@link IImsRegistrationListener}.
1256     */
1257    private class ImsRegistrationListenerProxy extends IImsRegistrationListener.Stub {
1258        private int mServiceClass;
1259        private ImsConnectionStateListener mListener;
1260
1261        public ImsRegistrationListenerProxy(int serviceClass,
1262                ImsConnectionStateListener listener) {
1263            mServiceClass = serviceClass;
1264            mListener = listener;
1265        }
1266
1267        public boolean isSameProxy(int serviceClass) {
1268            return (mServiceClass == serviceClass);
1269        }
1270
1271        @Deprecated
1272        public void registrationConnected() {
1273            if (DBG) {
1274                log("registrationConnected ::");
1275            }
1276
1277            if (mListener != null) {
1278                mListener.onImsConnected();
1279            }
1280        }
1281
1282        @Deprecated
1283        public void registrationProgressing() {
1284            if (DBG) {
1285                log("registrationProgressing ::");
1286            }
1287
1288            if (mListener != null) {
1289                mListener.onImsProgressing();
1290            }
1291        }
1292
1293        @Override
1294        public void registrationConnectedWithRadioTech(int imsRadioTech) {
1295            // Note: imsRadioTech value maps to RIL_RADIO_TECHNOLOGY
1296            //       values in ServiceState.java.
1297            if (DBG) {
1298                log("registrationConnectedWithRadioTech :: imsRadioTech=" + imsRadioTech);
1299            }
1300
1301            if (mListener != null) {
1302                mListener.onImsConnected();
1303            }
1304        }
1305
1306        @Override
1307        public void registrationProgressingWithRadioTech(int imsRadioTech) {
1308            // Note: imsRadioTech value maps to RIL_RADIO_TECHNOLOGY
1309            //       values in ServiceState.java.
1310            if (DBG) {
1311                log("registrationProgressingWithRadioTech :: imsRadioTech=" + imsRadioTech);
1312            }
1313
1314            if (mListener != null) {
1315                mListener.onImsProgressing();
1316            }
1317        }
1318
1319        @Override
1320        public void registrationDisconnected(ImsReasonInfo imsReasonInfo) {
1321            if (DBG) {
1322                log("registrationDisconnected :: imsReasonInfo" + imsReasonInfo);
1323            }
1324
1325            if (mListener != null) {
1326                mListener.onImsDisconnected(imsReasonInfo);
1327            }
1328        }
1329
1330        @Override
1331        public void registrationResumed() {
1332            if (DBG) {
1333                log("registrationResumed ::");
1334            }
1335
1336            if (mListener != null) {
1337                mListener.onImsResumed();
1338            }
1339        }
1340
1341        @Override
1342        public void registrationSuspended() {
1343            if (DBG) {
1344                log("registrationSuspended ::");
1345            }
1346
1347            if (mListener != null) {
1348                mListener.onImsSuspended();
1349            }
1350        }
1351
1352        @Override
1353        public void registrationServiceCapabilityChanged(int serviceClass, int event) {
1354            log("registrationServiceCapabilityChanged :: serviceClass=" +
1355                    serviceClass + ", event=" + event);
1356
1357            if (mListener != null) {
1358                mListener.onImsConnected();
1359            }
1360        }
1361
1362        @Override
1363        public void registrationFeatureCapabilityChanged(int serviceClass,
1364                int[] enabledFeatures, int[] disabledFeatures) {
1365            log("registrationFeatureCapabilityChanged :: serviceClass=" +
1366                    serviceClass);
1367            if (mListener != null) {
1368                mListener.onFeatureCapabilityChanged(serviceClass,
1369                        enabledFeatures, disabledFeatures);
1370            }
1371        }
1372
1373        @Override
1374        public void voiceMessageCountUpdate(int count) {
1375            log("voiceMessageCountUpdate :: count=" + count);
1376
1377            if (mListener != null) {
1378                mListener.onVoiceMessageCountChanged(count);
1379            }
1380        }
1381
1382        @Override
1383        public void registrationAssociatedUriChanged(Uri[] uris) {
1384            if (DBG) log("registrationAssociatedUriChanged ::");
1385
1386            if (mListener != null) {
1387                mListener.registrationAssociatedUriChanged(uris);
1388            }
1389        }
1390    }
1391
1392    /**
1393     * Gets the ECBM interface to request ECBM exit.
1394     *
1395     * @param serviceId a service id which is obtained from {@link ImsManager#open}
1396     * @return the ECBM interface instance
1397     * @throws ImsException if getting the ECBM interface results in an error
1398     */
1399    public ImsEcbm getEcbmInterface(int serviceId) throws ImsException {
1400        if (mEcbm == null) {
1401            checkAndThrowExceptionIfServiceUnavailable();
1402
1403            try {
1404                IImsEcbm iEcbm = mImsService.getEcbmInterface(serviceId);
1405
1406                if (iEcbm == null) {
1407                    throw new ImsException("getEcbmInterface()",
1408                            ImsReasonInfo.CODE_ECBM_NOT_SUPPORTED);
1409                }
1410                mEcbm = new ImsEcbm(iEcbm);
1411            } catch (RemoteException e) {
1412                throw new ImsException("getEcbmInterface()", e,
1413                        ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1414            }
1415        }
1416        return mEcbm;
1417    }
1418
1419    /**
1420     * Gets the Multi-Endpoint interface to subscribe to multi-enpoint notifications..
1421     *
1422     * @param serviceId a service id which is obtained from {@link ImsManager#open}
1423     * @return the multi-endpoint interface instance
1424     * @throws ImsException if getting the multi-endpoint interface results in an error
1425     */
1426    public ImsMultiEndpoint getMultiEndpointInterface(int serviceId) throws ImsException {
1427        if (mMultiEndpoint == null) {
1428            checkAndThrowExceptionIfServiceUnavailable();
1429
1430            try {
1431                IImsMultiEndpoint iImsMultiEndpoint = mImsService.getMultiEndpointInterface(
1432                        serviceId);
1433
1434                if (iImsMultiEndpoint == null) {
1435                    throw new ImsException("getMultiEndpointInterface()",
1436                            ImsReasonInfo.CODE_MULTIENDPOINT_NOT_SUPPORTED);
1437                }
1438                mMultiEndpoint = new ImsMultiEndpoint(iImsMultiEndpoint);
1439            } catch (RemoteException e) {
1440                throw new ImsException("getMultiEndpointInterface()", e,
1441                        ImsReasonInfo.CODE_LOCAL_IMS_SERVICE_DOWN);
1442            }
1443        }
1444        return mMultiEndpoint;
1445    }
1446
1447    /**
1448     * Resets ImsManager settings back to factory defaults.
1449     *
1450     * @hide
1451     */
1452    public static void factoryReset(Context context) {
1453        // Set VoLTE to default
1454        android.provider.Settings.Global.putInt(context.getContentResolver(),
1455                android.provider.Settings.Global.ENHANCED_4G_MODE_ENABLED,
1456                ImsConfig.FeatureValueConstants.ON);
1457
1458        // Set VoWiFi to default
1459        android.provider.Settings.Global.putInt(context.getContentResolver(),
1460                android.provider.Settings.Global.WFC_IMS_ENABLED,
1461                getBooleanCarrierConfig(context,
1462                        CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ENABLED_BOOL) ?
1463                        ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
1464
1465        // Set VoWiFi mode to default
1466        android.provider.Settings.Global.putInt(context.getContentResolver(),
1467                android.provider.Settings.Global.WFC_IMS_MODE,
1468                getIntCarrierConfig(context,
1469                        CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_MODE_INT));
1470
1471        // Set VoWiFi roaming to default
1472        android.provider.Settings.Global.putInt(context.getContentResolver(),
1473                android.provider.Settings.Global.WFC_IMS_ROAMING_ENABLED,
1474                getBooleanCarrierConfig(context,
1475                        CarrierConfigManager.KEY_CARRIER_DEFAULT_WFC_IMS_ROAMING_ENABLED_BOOL) ?
1476                        ImsConfig.FeatureValueConstants.ON : ImsConfig.FeatureValueConstants.OFF);
1477
1478        // Set VT to default
1479        android.provider.Settings.Global.putInt(context.getContentResolver(),
1480                android.provider.Settings.Global.VT_IMS_ENABLED,
1481                ImsConfig.FeatureValueConstants.ON);
1482
1483        // Push settings to ImsConfig
1484        ImsManager.updateImsServiceConfig(context,
1485                SubscriptionManager.getDefaultVoicePhoneId(), true);
1486    }
1487
1488    public void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
1489        pw.println("ImsManager:");
1490        pw.println("  mPhoneId = " + mPhoneId);
1491        pw.println("  mConfigUpdated = " + mConfigUpdated);
1492        pw.println("  mImsService = " + mImsService);
1493
1494        pw.println("  isGbaValid = " + isGbaValid(mContext));
1495        pw.println("  isImsTurnOffAllowed = " + isImsTurnOffAllowed());
1496        pw.println("  isNonTtyOrTtyOnVolteEnabled = " + isNonTtyOrTtyOnVolteEnabled(mContext));
1497
1498        pw.println("  isVolteEnabledByPlatform = " + isVolteEnabledByPlatform(mContext));
1499        pw.println("  isVolteProvisionedOnDevice = " + isVolteProvisionedOnDevice(mContext));
1500        pw.println("  isEnhanced4gLteModeSettingEnabledByUser = " +
1501                isEnhanced4gLteModeSettingEnabledByUser(mContext));
1502        pw.println("  isVtEnabledByPlatform = " + isVtEnabledByPlatform(mContext));
1503        pw.println("  isVtEnabledByUser = " + isVtEnabledByUser(mContext));
1504
1505        pw.println("  isWfcEnabledByPlatform = " + isWfcEnabledByPlatform(mContext));
1506        pw.println("  isWfcEnabledByUser = " + isWfcEnabledByUser(mContext));
1507        pw.println("  getWfcMode = " + getWfcMode(mContext));
1508        pw.println("  isWfcRoamingEnabledByUser = " + isWfcRoamingEnabledByUser(mContext));
1509
1510        pw.flush();
1511    }
1512}
1513