Add getPhoneCapability function in TelephonyManager

- Add a resource for Device's Nr information.
- Expose below as systemApi
  - getDeviceNrCapabilityBitmask()
  - getMaxActiveInternetData()
  - getMaxActivePacketSwitchedVoiceCalls()
Bug: 175711587
Test: atest TelephonyManager#testGetPhoneCapability
atest PhoneCapabilityTest
atest PhoneConfigurationManagerTest
atest CellularNetworkValidatorTest
atest PhoneSwitcherTest
atest TelephonyRegistryTest
atest PhoneCapabilityTest

Change-Id: Ide25344787c15b3a57a9e6621766ad02a906f12e
Merged-In: Ide25344787c15b3a57a9e6621766ad02a906f12e

core/api/current.txt

@@ -40287,12 +40287,6 @@ package android.telephony {
     field public static final int SCAN_TYPE_PERIODIC = 1; // 0x1
   }
 
-  public final class PhoneCapability implements android.os.Parcelable {
-    method public int describeContents();
-    method public void writeToParcel(@NonNull android.os.Parcel, int);
-    field @NonNull public static final android.os.Parcelable.Creator<android.telephony.PhoneCapability> CREATOR;
-  }
-
   public class PhoneNumberFormattingTextWatcher implements android.text.TextWatcher {
     ctor public PhoneNumberFormattingTextWatcher();
     ctor public PhoneNumberFormattingTextWatcher(String);

core/api/system-current.txt

@@ -9753,6 +9753,18 @@ package android.telephony {
     field public static final int REASON_UNSPECIFIED = 0; // 0x0
   }
 
+  public final class PhoneCapability implements android.os.Parcelable {
+    method public int describeContents();
+    method public int getDeviceNrCapabilityBitmask();
+    method @IntRange(from=1) public int getMaxActiveInternetData();
+    method @IntRange(from=1) public int getMaxActivePacketSwitchedVoiceCalls();
+    method public void writeToParcel(@NonNull android.os.Parcel, int);
+    field @NonNull public static final android.os.Parcelable.Creator<android.telephony.PhoneCapability> CREATOR;
+    field public static final int DEVICE_NR_CAPABILITY_NONE = 0; // 0x0
+    field public static final int DEVICE_NR_CAPABILITY_NSA = 1; // 0x1
+    field public static final int DEVICE_NR_CAPABILITY_SA = 2; // 0x2
+  }
+
   public final class PhoneNumberRange implements android.os.Parcelable {
     ctor public PhoneNumberRange(@NonNull String, @NonNull String, @NonNull String, @NonNull String);
     method public int describeContents();
@@ -10272,6 +10284,7 @@ package android.telephony {
     method public int getMaxNumberOfSimultaneouslyActiveSims();
     method public static long getMaxNumberVerificationTimeoutMillis();
     method @NonNull @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public String[] getMergedImsisFromGroup();
+    method @NonNull @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public android.telephony.PhoneCapability getPhoneCapability();
     method @Deprecated @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE) public long getPreferredNetworkTypeBitmask();
     method @RequiresPermission(anyOf={android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE, android.Manifest.permission.READ_PHONE_STATE}) public int getRadioPowerState();
     method public int getSimApplicationState();

core/res/res/values/config.xml

@@ -4426,4 +4426,9 @@
 
     <!-- Whether to allow the caching of the SIM PIN for verification after unattended reboot -->
     <bool name="config_allow_pin_storage_for_unattended_reboot">true</bool>
+
+    <!-- Whether the device enable the standalone (SA) mode of 5G NR.-->
+    <bool name="config_telephony5gStandalone">false</bool>
+    <!-- Whether the device enable the non-standalone (NSA) mode of 5G NR.-->
+    <bool name="config_telephony5gNonStandalone">false</bool>
 </resources>

core/res/res/values/symbols.xml

@@ -4075,4 +4075,7 @@
   <java-symbol type="array" name="config_keep_warming_services" />
 
   <java-symbol type="bool" name="config_voice_data_sms_auto_fallback" />
+
+  <java-symbol type="bool" name="config_telephony5gStandalone" />
+  <java-symbol type="bool" name="config_telephony5gNonStandalone" />
 </resources>

telephony/java/android/telephony/PhoneCapability.java

@@ -16,19 +16,26 @@
 
 package android.telephony;
 
+import android.annotation.IntDef;
+import android.annotation.IntRange;
 import android.annotation.NonNull;
+import android.annotation.SystemApi;
 import android.os.Parcel;
 import android.os.Parcelable;
 
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
 import java.util.ArrayList;
-import java.util.Arrays;
 import java.util.List;
 import java.util.Objects;
 
 /**
- * Define capability of a modem group. That is, the capabilities
+ * Phone capability which describes the data connection capability of modem.
- * are shared between those modems defined by list of modem IDs.
+ * It's used to evaluate possible phone config change, for example from single
+ * SIM device to multi-SIM device.
+ * @hide
  */
+@SystemApi
 public final class PhoneCapability implements Parcelable {
     // Hardcoded default DSDS capability.
     /** @hide */
@@ -37,6 +44,38 @@ public final class PhoneCapability implements Parcelable {
     /** @hide */
     public static final PhoneCapability DEFAULT_SSSS_CAPABILITY;
 
+    /** @hide */
+    @Retention(RetentionPolicy.SOURCE)
+    @IntDef(prefix = { "DEVICE_NR_CAPABILITY_" }, value = {
+            DEVICE_NR_CAPABILITY_NONE,
+            DEVICE_NR_CAPABILITY_NSA,
+            DEVICE_NR_CAPABILITY_SA,
+    })
+    public @interface DeviceNrCapability {}
+
+    /**
+     * Indicates DEVICE_NR_CAPABILITY_NONE determine that the device does not enable 5G NR.
+     * @hide
+     */
+    @SystemApi
+    public static final int DEVICE_NR_CAPABILITY_NONE = 0;
+
+    /**
+     * Indicates DEVICE_NR_CAPABILITY_NSA determine that the device enable the non-standalone
+     * (NSA) mode of 5G NR.
+     * @hide
+     */
+    @SystemApi
+    public static final int DEVICE_NR_CAPABILITY_NSA = 1 << 0;
+
+    /**
+     * Indicates DEVICE_NR_CAPABILITY_SA determine that the device enable the standalone (SA)
+     * mode of 5G NR.
+     * @hide
+     */
+    @SystemApi
+    public static final int DEVICE_NR_CAPABILITY_SA = 1 << 1;
+
     static {
         ModemInfo modemInfo1 = new ModemInfo(0, 0, true, true);
         ModemInfo modemInfo2 = new ModemInfo(1, 0, true, true);
@@ -44,55 +83,85 @@ public final class PhoneCapability implements Parcelable {
         List<ModemInfo> logicalModemList = new ArrayList<>();
         logicalModemList.add(modemInfo1);
         logicalModemList.add(modemInfo2);
-        DEFAULT_DSDS_CAPABILITY = new PhoneCapability(1, 1, 0, logicalModemList, false);
+        DEFAULT_DSDS_CAPABILITY = new PhoneCapability(1, 1, logicalModemList, false,
+                DEVICE_NR_CAPABILITY_NONE);
 
         logicalModemList = new ArrayList<>();
         logicalModemList.add(modemInfo1);
-        DEFAULT_SSSS_CAPABILITY = new PhoneCapability(1, 1, 0, logicalModemList, false);
+        DEFAULT_SSSS_CAPABILITY = new PhoneCapability(1, 1, logicalModemList, false,
+                DEVICE_NR_CAPABILITY_NONE);
     }
 
-    /** @hide */
+    /**
-    public final int maxActiveVoiceCalls;
+     * MaxActivePsVoice defines the maximum number of active voice calls.  For a dual sim dual
-    /** @hide */
+     * standby (DSDS) modem it would be one, but for a dual sim dual active modem it would be 2.
-    public final int maxActiveData;
+     *
-    /** @hide */
+     * @hide
-    public final int max5G;
+     */
-    /** @hide */
+    private final int mMaxActivePsVoice;
-    public final boolean validationBeforeSwitchSupported;
+
-    /** @hide */
+    /**
-    public final List<ModemInfo> logicalModemList;
+     * MaxActiveInternetData defines how many logical modems can have
+     * PS attached simultaneously. For example, for L+L modem it
+     * should be 2.
+     *
+     * @hide
+     */
+    private final int mMaxActiveInternetData;
+
+    /**
+     * Whether modem supports both internet PDN up so
+     * that we can do ping test before tearing down the
+     * other one.
+     *
+     * @hide
+     */
+    private final boolean mNetworkValidationBeforeSwitchSupported;
 
     /** @hide */
-    public PhoneCapability(int maxActiveVoiceCalls, int maxActiveData, int max5G,
+    private final List<ModemInfo> mLogicalModemList;
-            List<ModemInfo> logicalModemList, boolean validationBeforeSwitchSupported) {
+
-        this.maxActiveVoiceCalls = maxActiveVoiceCalls;
+    /**
-        this.maxActiveData = maxActiveData;
+     * List of logical modem information.
-        this.max5G = max5G;
+     *
+     * @hide
+     */
+    private final int mDeviceNrCapability;
+
+    /** @hide */
+    public PhoneCapability(int maxActivePsVoice, int maxActiveInternetData,
+            List<ModemInfo> logicalModemList, boolean networkValidationBeforeSwitchSupported,
+            int deviceNrCapability) {
+        this.mMaxActivePsVoice = maxActivePsVoice;
+        this.mMaxActiveInternetData = maxActiveInternetData;
         // Make sure it's not null.
-        this.logicalModemList = logicalModemList == null ? new ArrayList<>() : logicalModemList;
+        this.mLogicalModemList = logicalModemList == null ? new ArrayList<>() : logicalModemList;
-        this.validationBeforeSwitchSupported = validationBeforeSwitchSupported;
+        this.mNetworkValidationBeforeSwitchSupported = networkValidationBeforeSwitchSupported;
+        this.mDeviceNrCapability = deviceNrCapability;
     }
 
     @Override
     public String toString() {
-        return "maxActiveVoiceCalls=" + maxActiveVoiceCalls + " maxActiveData=" + maxActiveData
+        return "mMaxActivePsVoice=" + mMaxActivePsVoice
-                + " max5G=" + max5G + "logicalModemList:"
+                + " mMaxActiveInternetData=" + mMaxActiveInternetData
-                + Arrays.toString(logicalModemList.toArray());
+                + " mNetworkValidationBeforeSwitchSupported="
+                + mNetworkValidationBeforeSwitchSupported
+                + " mDeviceNrCapability " + mDeviceNrCapability;
     }
 
     private PhoneCapability(Parcel in) {
-        maxActiveVoiceCalls = in.readInt();
+        mMaxActivePsVoice = in.readInt();
-        maxActiveData = in.readInt();
+        mMaxActiveInternetData = in.readInt();
-        max5G = in.readInt();
+        mNetworkValidationBeforeSwitchSupported = in.readBoolean();
-        validationBeforeSwitchSupported = in.readBoolean();
+        mLogicalModemList = new ArrayList<>();
-        logicalModemList = new ArrayList<>();
+        in.readList(mLogicalModemList, ModemInfo.class.getClassLoader());
-        in.readList(logicalModemList, ModemInfo.class.getClassLoader());
+        mDeviceNrCapability = in.readInt();
     }
 
     @Override
     public int hashCode() {
-        return Objects.hash(maxActiveVoiceCalls, maxActiveData, max5G, logicalModemList,
+        return Objects.hash(mMaxActivePsVoice, mMaxActiveInternetData, mLogicalModemList,
-                validationBeforeSwitchSupported);
+                mNetworkValidationBeforeSwitchSupported, mDeviceNrCapability);
     }
 
     @Override
@@ -107,11 +176,12 @@ public final class PhoneCapability implements Parcelable {
 
         PhoneCapability s = (PhoneCapability) o;
 
-        return (maxActiveVoiceCalls == s.maxActiveVoiceCalls
+        return (mMaxActivePsVoice == s.mMaxActivePsVoice
-                && maxActiveData == s.maxActiveData
+                && mMaxActiveInternetData == s.mMaxActiveInternetData
-                && max5G == s.max5G
+                && mNetworkValidationBeforeSwitchSupported
-                && validationBeforeSwitchSupported == s.validationBeforeSwitchSupported
+                == s.mNetworkValidationBeforeSwitchSupported
-                && logicalModemList.equals(s.logicalModemList));
+                && mLogicalModemList.equals(s.mLogicalModemList)
+                && mDeviceNrCapability == s.mDeviceNrCapability);
     }
 
     /**
@@ -125,14 +195,15 @@ public final class PhoneCapability implements Parcelable {
      * {@link Parcelable#writeToParcel}
      */
     public void writeToParcel(@NonNull Parcel dest, @Parcelable.WriteFlags int flags) {
-        dest.writeInt(maxActiveVoiceCalls);
+        dest.writeInt(mMaxActivePsVoice);
-        dest.writeInt(maxActiveData);
+        dest.writeInt(mMaxActiveInternetData);
-        dest.writeInt(max5G);
+        dest.writeBoolean(mNetworkValidationBeforeSwitchSupported);
-        dest.writeBoolean(validationBeforeSwitchSupported);
+        dest.writeList(mLogicalModemList);
-        dest.writeList(logicalModemList);
+        dest.writeInt(mDeviceNrCapability);
     }
 
-    public static final @android.annotation.NonNull Parcelable.Creator<PhoneCapability> CREATOR = new Parcelable.Creator() {
+    public static final @android.annotation.NonNull Parcelable.Creator<PhoneCapability> CREATOR =
+            new Parcelable.Creator() {
         public PhoneCapability createFromParcel(Parcel in) {
             return new PhoneCapability(in);
         }
@@ -141,4 +212,55 @@ public final class PhoneCapability implements Parcelable {
             return new PhoneCapability[size];
         }
     };
+
+    /**
+     * @return the maximum number of active packet-switched calls.  For a dual
+     * sim dual standby (DSDS) modem it would be one, but for a dual sim dual active modem it
+     * would be 2.
+     * @hide
+     */
+    @SystemApi
+    public @IntRange(from = 1) int getMaxActivePacketSwitchedVoiceCalls() {
+        return mMaxActivePsVoice;
+    }
+
+    /**
+     * @return MaxActiveInternetData defines how many logical modems can have PS attached
+     * simultaneously.
+     * For example, for L+L modem it should be 2.
+     * @hide
+     */
+    @SystemApi
+    public @IntRange(from = 1) int getMaxActiveInternetData() {
+        return mMaxActiveInternetData;
+    }
+
+    /**
+     * @return Check whether the Citizens Broadband Radio Service(CBRS) network validation before
+     * CBRS switch is supported or not.
+     *
+     * @hide
+     */
+    public boolean isNetworkValidationBeforeSwitchSupported() {
+        return mNetworkValidationBeforeSwitchSupported;
+    }
+
+    /**
+     * @return The list of logical modem information.
+     * @hide
+     */
+    public List<ModemInfo> getLogicalModemList() {
+        return mLogicalModemList;
+    }
+
+    /**
+     * Return the device's NR capability.
+     *
+     * @return {@link DeviceNrCapability} the device's NR capability.
+     * @hide
+     */
+    @SystemApi
+    public @DeviceNrCapability int getDeviceNrCapabilityBitmask() {
+        return mDeviceNrCapability;
+    }
 }

telephony/java/android/telephony/TelephonyManager.java

@@ -15065,4 +15065,32 @@ public class TelephonyManager {
         }
         return PREPARE_UNATTENDED_REBOOT_ERROR;
     }
+
+    /**
+     * Gets the current phone capability.
+     *
+     * @return the PhoneCapability which describes the data connection capability of modem.
+     * It's used to evaluate possible phone config change, for example from single
+     * SIM device to multi-SIM device.
+     * @hide
+     */
+    @SystemApi
+    @RequiresPermission(android.Manifest.permission.READ_PRIVILEGED_PHONE_STATE)
+    public @NonNull PhoneCapability getPhoneCapability() {
+        try {
+            ITelephony telephony = getITelephony();
+            if (telephony != null) {
+                return telephony.getPhoneCapability();
+            } else {
+                throw new IllegalStateException("telephony service is null.");
+            }
+        } catch (RemoteException ex) {
+            ex.rethrowAsRuntimeException();
+        }
+        if (getActiveModemCount() > 1) {
+            return PhoneCapability.DEFAULT_DSDS_CAPABILITY;
+        } else {
+            return PhoneCapability.DEFAULT_SSSS_CAPABILITY;
+        }
+    }
 }

telephony/java/com/android/internal/telephony/ITelephony.aidl

@@ -43,6 +43,7 @@ import android.telephony.ICellInfoCallback;
 import android.telephony.ModemActivityInfo;
 import android.telephony.NeighboringCellInfo;
 import android.telephony.NetworkScanRequest;
+import android.telephony.PhoneCapability;
 import android.telephony.PhoneNumberRange;
 import android.telephony.RadioAccessFamily;
 import android.telephony.RadioAccessSpecifier;
@@ -2440,4 +2441,9 @@ interface ITelephony {
      * of error.
      */
     int prepareForUnattendedReboot();
+
+    /**
+     * Gets the current phone capability.
+     */
+    PhoneCapability getPhoneCapability();
 }