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