/* * Copyright (C) 2006 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.telephony; import android.annotation.FlaggedApi; import android.annotation.IntDef; import android.annotation.NonNull; import android.annotation.Nullable; import android.annotation.RequiresPermission; import android.annotation.SystemApi; import android.annotation.TestApi; import android.compat.annotation.UnsupportedAppUsage; import android.content.Intent; import android.os.Build; import android.os.Bundle; import android.os.Parcel; import android.os.Parcelable; import android.telephony.AccessNetworkConstants.AccessNetworkType; import android.telephony.AccessNetworkConstants.TransportType; import android.telephony.Annotation.NetworkType; import android.telephony.NetworkRegistrationInfo.Domain; import android.telephony.NetworkRegistrationInfo.NRState; import android.text.TextUtils; import com.android.internal.telephony.flags.Flags; import com.android.telephony.Rlog; 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; import java.util.stream.Collectors; /** * Contains phone state and service related information. * * The following phone information is included in returned ServiceState: * * * * For historical reasons this class is not declared as final; however, * it should be treated as though it were final. */ @android.ravenwood.annotation.RavenwoodKeepPartialClass public class ServiceState implements Parcelable { static final String LOG_TAG = "PHONE"; static final boolean DBG = false; static final boolean VDBG = false; // STOPSHIP if true /** @hide */ @Retention(RetentionPolicy.SOURCE) @IntDef(prefix = "STATE_", value = {STATE_IN_SERVICE, STATE_OUT_OF_SERVICE, STATE_EMERGENCY_ONLY, STATE_POWER_OFF}) public @interface RegState {} /** * Normal operation condition, the phone is registered * with an operator either in home network or in roaming. */ public static final int STATE_IN_SERVICE = TelephonyProtoEnums.SERVICE_STATE_IN_SERVICE; // 0 /** * Phone is not registered with any operator, the phone * can be currently searching a new operator to register to, or not * searching to registration at all, or registration is denied, or radio * signal is not available. */ public static final int STATE_OUT_OF_SERVICE = TelephonyProtoEnums.SERVICE_STATE_OUT_OF_SERVICE; // 1 /** * The phone is registered and locked. Only emergency numbers are allowed. {@more} */ //TODO: This state is not used anymore. It should be deprecated in a future release. public static final int STATE_EMERGENCY_ONLY = TelephonyProtoEnums.SERVICE_STATE_EMERGENCY_ONLY; // 2 /** * Radio of telephony is explicitly powered off. */ public static final int STATE_POWER_OFF = TelephonyProtoEnums.SERVICE_STATE_POWER_OFF; // 3 /** @hide */ @Retention(RetentionPolicy.SOURCE) @IntDef(prefix = "FREQUENCY_RANGE_", value = {FREQUENCY_RANGE_UNKNOWN, FREQUENCY_RANGE_LOW, FREQUENCY_RANGE_MID, FREQUENCY_RANGE_HIGH, FREQUENCY_RANGE_MMWAVE}) public @interface FrequencyRange {} /** * Indicates frequency range is unknown. * @hide */ public static final int FREQUENCY_RANGE_UNKNOWN = 0; /** * Indicates the frequency range is below 1GHz. * @hide */ public static final int FREQUENCY_RANGE_LOW = 1; /** * Indicates the frequency range is between 1GHz to 3GHz. * @hide */ public static final int FREQUENCY_RANGE_MID = 2; /** * Indicates the frequency range is between 3GHz and 6GHz. * @hide */ public static final int FREQUENCY_RANGE_HIGH = 3; /** * Indicates the frequency range is above 6GHz (millimeter wave frequency). * @hide */ public static final int FREQUENCY_RANGE_MMWAVE = 4; /** * Number of frequency ranges. * @hide */ public static final int FREQUENCY_RANGE_COUNT = 5; /** @hide */ @Retention(RetentionPolicy.SOURCE) @IntDef(prefix = "DUPLEX_MODE_", value = {DUPLEX_MODE_UNKNOWN, DUPLEX_MODE_FDD, DUPLEX_MODE_TDD}) public @interface DuplexMode {} /** * Duplex mode for the phone is unknown. */ public static final int DUPLEX_MODE_UNKNOWN = 0; /** * Duplex mode for the phone is frequency-division duplexing. */ public static final int DUPLEX_MODE_FDD = 1; /** * Duplex mode for the phone is time-division duplexing. */ public static final int DUPLEX_MODE_TDD = 2; /** * Available radio technologies for GSM, UMTS and CDMA. * Duplicates the constants from hardware/radio/include/ril.h * This should only be used by agents working with the ril. Others * should use the equivalent TelephonyManager.NETWORK_TYPE_* */ /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_UNKNOWN = 0; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_GPRS = 1; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_EDGE = 2; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_UMTS = 3; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_IS95A = 4; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_IS95B = 5; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_1xRTT = 6; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_EVDO_0 = 7; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_EVDO_A = 8; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_HSDPA = 9; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_HSUPA = 10; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_HSPA = 11; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_EVDO_B = 12; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_EHRPD = 13; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_LTE = 14; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_HSPAP = 15; /** * GSM radio technology only supports voice. It does not support data. * @hide */ public static final int RIL_RADIO_TECHNOLOGY_GSM = 16; /** @hide */ public static final int RIL_RADIO_TECHNOLOGY_TD_SCDMA = 17; /** * IWLAN * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public static final int RIL_RADIO_TECHNOLOGY_IWLAN = 18; /** * LTE_CA * @hide */ public static final int RIL_RADIO_TECHNOLOGY_LTE_CA = 19; /** * NR(New Radio) 5G. * @hide */ public static final int RIL_RADIO_TECHNOLOGY_NR = 20; /** * RIL Radio Annotation * @hide */ @Retention(RetentionPolicy.SOURCE) @IntDef(prefix = {"RIL_RADIO_TECHNOLOGY_" }, value = { ServiceState.RIL_RADIO_TECHNOLOGY_UNKNOWN, ServiceState.RIL_RADIO_TECHNOLOGY_GPRS, ServiceState.RIL_RADIO_TECHNOLOGY_EDGE, ServiceState.RIL_RADIO_TECHNOLOGY_UMTS, ServiceState.RIL_RADIO_TECHNOLOGY_IS95A, ServiceState.RIL_RADIO_TECHNOLOGY_IS95B, ServiceState.RIL_RADIO_TECHNOLOGY_1xRTT, ServiceState.RIL_RADIO_TECHNOLOGY_EVDO_0, ServiceState.RIL_RADIO_TECHNOLOGY_EVDO_A, ServiceState.RIL_RADIO_TECHNOLOGY_HSDPA, ServiceState.RIL_RADIO_TECHNOLOGY_HSUPA, ServiceState.RIL_RADIO_TECHNOLOGY_HSPA, ServiceState.RIL_RADIO_TECHNOLOGY_EVDO_B, ServiceState.RIL_RADIO_TECHNOLOGY_EHRPD, ServiceState.RIL_RADIO_TECHNOLOGY_LTE, ServiceState.RIL_RADIO_TECHNOLOGY_HSPAP, ServiceState.RIL_RADIO_TECHNOLOGY_GSM, ServiceState.RIL_RADIO_TECHNOLOGY_TD_SCDMA, ServiceState.RIL_RADIO_TECHNOLOGY_IWLAN, ServiceState.RIL_RADIO_TECHNOLOGY_LTE_CA, ServiceState.RIL_RADIO_TECHNOLOGY_NR}) public @interface RilRadioTechnology {} /** * The number of the radio technologies. */ private static final int NEXT_RIL_RADIO_TECHNOLOGY = 21; /** @hide */ public static final int RIL_RADIO_CDMA_TECHNOLOGY_BITMASK = (1 << (RIL_RADIO_TECHNOLOGY_IS95A - 1)) | (1 << (RIL_RADIO_TECHNOLOGY_IS95B - 1)) | (1 << (RIL_RADIO_TECHNOLOGY_1xRTT - 1)) | (1 << (RIL_RADIO_TECHNOLOGY_EVDO_0 - 1)) | (1 << (RIL_RADIO_TECHNOLOGY_EVDO_A - 1)) | (1 << (RIL_RADIO_TECHNOLOGY_EVDO_B - 1)) | (1 << (RIL_RADIO_TECHNOLOGY_EHRPD - 1)); private int mVoiceRegState = STATE_OUT_OF_SERVICE; private int mDataRegState = STATE_OUT_OF_SERVICE; /** @hide */ @Retention(RetentionPolicy.SOURCE) @IntDef(prefix = { "ROAMING_TYPE_" }, value = { ROAMING_TYPE_NOT_ROAMING, ROAMING_TYPE_UNKNOWN, ROAMING_TYPE_DOMESTIC, ROAMING_TYPE_INTERNATIONAL }) public @interface RoamingType {} /** * Not roaming, registered in home network. * @hide */ @SystemApi public static final int ROAMING_TYPE_NOT_ROAMING = 0; /** * registered in a roaming network, but can not tell if it's domestic or international. * @hide */ @SystemApi public static final int ROAMING_TYPE_UNKNOWN = 1; /** * registered in a domestic roaming network * @hide */ @SystemApi public static final int ROAMING_TYPE_DOMESTIC = 2; /** * registered in an international roaming network * @hide */ @SystemApi public static final int ROAMING_TYPE_INTERNATIONAL = 3; /** * Unknown ID. Could be returned by {@link #getCdmaNetworkId()} or {@link #getCdmaSystemId()} */ public static final int UNKNOWN_ID = -1; /** * A parcelable extra used with {@link Intent#ACTION_SERVICE_STATE} representing the service * state. * @hide */ private static final String EXTRA_SERVICE_STATE = "android.intent.extra.SERVICE_STATE"; private String mOperatorAlphaLong; private String mOperatorAlphaShort; private String mOperatorNumeric; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) private boolean mIsManualNetworkSelection; private boolean mIsEmergencyOnly; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) private boolean mCssIndicator; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) private int mNetworkId; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) private int mSystemId; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) private int mCdmaRoamingIndicator; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) private int mCdmaDefaultRoamingIndicator; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) private int mCdmaEriIconIndex; @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) private int mCdmaEriIconMode; @FrequencyRange private int mNrFrequencyRange; private int mChannelNumber; private int[] mCellBandwidths = new int[0]; /** * ARFCN stands for Absolute Radio Frequency Channel Number. This field is current used for * LTE where it represents the boost for EARFCN (Reference: 3GPP TS 36.104 5.4.3) and for NR * where it's for NR ARFCN (Reference: 3GPP TS 36.108) */ private int mArfcnRsrpBoost = 0; private final List mNetworkRegistrationInfos = new ArrayList<>(); private String mOperatorAlphaLongRaw; private String mOperatorAlphaShortRaw; private boolean mIsDataRoamingFromRegistration; private boolean mIsIwlanPreferred; /** * get String description of roaming type * @hide */ public static final String getRoamingLogString(int roamingType) { switch (roamingType) { case ROAMING_TYPE_NOT_ROAMING: return "home"; case ROAMING_TYPE_UNKNOWN: return "roaming"; case ROAMING_TYPE_DOMESTIC: return "Domestic Roaming"; case ROAMING_TYPE_INTERNATIONAL: return "International Roaming"; default: return "UNKNOWN"; } } /** * Create a new ServiceState from a intent notifier Bundle * * This method is used to get ServiceState object from extras upon receiving * {@link Intent#ACTION_SERVICE_STATE}. * * @param m Bundle from intent notifier * @return newly created ServiceState * @hide */ @NonNull @UnsupportedAppUsage public static ServiceState newFromBundle(@NonNull Bundle m) { ServiceState ret; ret = new ServiceState(); ret.setFromNotifierBundle(m); return ret; } /** * Empty constructor */ public ServiceState() { } /** * Copy constructors * * @param s Source service state */ public ServiceState(ServiceState s) { copyFrom(s); } protected void copyFrom(ServiceState s) { mVoiceRegState = s.mVoiceRegState; mDataRegState = s.mDataRegState; mOperatorAlphaLong = s.mOperatorAlphaLong; mOperatorAlphaShort = s.mOperatorAlphaShort; mOperatorNumeric = s.mOperatorNumeric; mIsManualNetworkSelection = s.mIsManualNetworkSelection; mCssIndicator = s.mCssIndicator; mNetworkId = s.mNetworkId; mSystemId = s.mSystemId; mCdmaRoamingIndicator = s.mCdmaRoamingIndicator; mCdmaDefaultRoamingIndicator = s.mCdmaDefaultRoamingIndicator; mCdmaEriIconIndex = s.mCdmaEriIconIndex; mCdmaEriIconMode = s.mCdmaEriIconMode; mIsEmergencyOnly = s.mIsEmergencyOnly; mChannelNumber = s.mChannelNumber; mCellBandwidths = s.mCellBandwidths == null ? null : Arrays.copyOf(s.mCellBandwidths, s.mCellBandwidths.length); mArfcnRsrpBoost = s.mArfcnRsrpBoost; synchronized (mNetworkRegistrationInfos) { mNetworkRegistrationInfos.clear(); for (NetworkRegistrationInfo nri : s.getNetworkRegistrationInfoList()) { mNetworkRegistrationInfos.add(new NetworkRegistrationInfo(nri)); } } mNrFrequencyRange = s.mNrFrequencyRange; mOperatorAlphaLongRaw = s.mOperatorAlphaLongRaw; mOperatorAlphaShortRaw = s.mOperatorAlphaShortRaw; mIsDataRoamingFromRegistration = s.mIsDataRoamingFromRegistration; mIsIwlanPreferred = s.mIsIwlanPreferred; } /** * Construct a ServiceState object from the given parcel. * * @deprecated The constructor takes parcel should not be public at the beginning. Use * {@link #ServiceState()} instead. */ @Deprecated public ServiceState(Parcel in) { mVoiceRegState = in.readInt(); mDataRegState = in.readInt(); mOperatorAlphaLong = in.readString(); mOperatorAlphaShort = in.readString(); mOperatorNumeric = in.readString(); mIsManualNetworkSelection = in.readInt() != 0; mCssIndicator = (in.readInt() != 0); mNetworkId = in.readInt(); mSystemId = in.readInt(); mCdmaRoamingIndicator = in.readInt(); mCdmaDefaultRoamingIndicator = in.readInt(); mCdmaEriIconIndex = in.readInt(); mCdmaEriIconMode = in.readInt(); mIsEmergencyOnly = in.readInt() != 0; mArfcnRsrpBoost = in.readInt(); synchronized (mNetworkRegistrationInfos) { in.readList(mNetworkRegistrationInfos, NetworkRegistrationInfo.class.getClassLoader(), android.telephony.NetworkRegistrationInfo.class); } mChannelNumber = in.readInt(); mCellBandwidths = in.createIntArray(); mNrFrequencyRange = in.readInt(); mOperatorAlphaLongRaw = in.readString(); mOperatorAlphaShortRaw = in.readString(); mIsDataRoamingFromRegistration = in.readBoolean(); mIsIwlanPreferred = in.readBoolean(); } public void writeToParcel(Parcel out, int flags) { out.writeInt(mVoiceRegState); out.writeInt(mDataRegState); out.writeString(mOperatorAlphaLong); out.writeString(mOperatorAlphaShort); out.writeString(mOperatorNumeric); out.writeInt(mIsManualNetworkSelection ? 1 : 0); out.writeInt(mCssIndicator ? 1 : 0); out.writeInt(mNetworkId); out.writeInt(mSystemId); out.writeInt(mCdmaRoamingIndicator); out.writeInt(mCdmaDefaultRoamingIndicator); out.writeInt(mCdmaEriIconIndex); out.writeInt(mCdmaEriIconMode); out.writeInt(mIsEmergencyOnly ? 1 : 0); out.writeInt(mArfcnRsrpBoost); synchronized (mNetworkRegistrationInfos) { out.writeList(mNetworkRegistrationInfos); } out.writeInt(mChannelNumber); out.writeIntArray(mCellBandwidths); out.writeInt(mNrFrequencyRange); out.writeString(mOperatorAlphaLongRaw); out.writeString(mOperatorAlphaShortRaw); out.writeBoolean(mIsDataRoamingFromRegistration); out.writeBoolean(mIsIwlanPreferred); } public int describeContents() { return 0; } public static final @android.annotation.NonNull Parcelable.Creator CREATOR = new Parcelable.Creator() { public ServiceState createFromParcel(Parcel in) { return new ServiceState(in); } public ServiceState[] newArray(int size) { return new ServiceState[size]; } }; /** * Get current voice service state */ public int getState() { return getVoiceRegState(); } /** * Get current voice service state * * @see #STATE_IN_SERVICE * @see #STATE_OUT_OF_SERVICE * @see #STATE_EMERGENCY_ONLY * @see #STATE_POWER_OFF * * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public int getVoiceRegState() { return mVoiceRegState; } /** * Get current data registration state. * * @see #STATE_IN_SERVICE * @see #STATE_OUT_OF_SERVICE * @see #STATE_EMERGENCY_ONLY * @see #STATE_POWER_OFF * * @return current data registration state * * @hide */ @UnsupportedAppUsage @TestApi public int getDataRegState() { return mDataRegState; } /** * Get current data registration state. * * @see #STATE_IN_SERVICE * @see #STATE_OUT_OF_SERVICE * @see #STATE_EMERGENCY_ONLY * @see #STATE_POWER_OFF * * @return current data registration state * * @hide */ public @RegState int getDataRegistrationState() { return getDataRegState(); } /** * Get the current duplex mode * * @see #DUPLEX_MODE_UNKNOWN * @see #DUPLEX_MODE_FDD * @see #DUPLEX_MODE_TDD * * @return Current {@code DuplexMode} for the phone */ @DuplexMode public int getDuplexMode() { // support LTE/NR duplex mode if (!isPsOnlyTech(getRilDataRadioTechnology())) { return DUPLEX_MODE_UNKNOWN; } int band = AccessNetworkUtils.getOperatingBandForEarfcn(mChannelNumber); return AccessNetworkUtils.getDuplexModeForEutranBand(band); } /** * Get the channel number of the current primary serving cell, or -1 if unknown * *

This is NRARFCN for NR, EARFCN for LTE, UARFCN for UMTS, and ARFCN for GSM. * * @return Channel number of primary serving cell */ public int getChannelNumber() { return mChannelNumber; } /** * Get an array of cell bandwidths (kHz) for the current serving cells * * @return Current serving cell bandwidths */ public int[] getCellBandwidths() { return mCellBandwidths == null ? new int[0] : mCellBandwidths; } /** * Get current roaming indicator of phone. This roaming state could be overridden by the carrier * config. * (note: not just decoding from TS 27.007 7.2) * @see TelephonyDisplayInfo#isRoaming() for visualization purpose. * @return true if TS 27.007 7.2 roaming is true * and ONS is different from SPN * @see CarrierConfigManager#KEY_FORCE_HOME_NETWORK_BOOL * @see CarrierConfigManager#KEY_GSM_ROAMING_NETWORKS_STRING_ARRAY * @see CarrierConfigManager#KEY_GSM_NONROAMING_NETWORKS_STRING_ARRAY * @see CarrierConfigManager#KEY_CDMA_ROAMING_NETWORKS_STRING_ARRAY * @see CarrierConfigManager#KEY_CDMA_NONROAMING_NETWORKS_STRING_ARRAY */ public boolean getRoaming() { return getVoiceRoaming() || getDataRoaming(); } /** * Get current voice network roaming status * @return roaming status * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public boolean getVoiceRoaming() { return getVoiceRoamingType() != ROAMING_TYPE_NOT_ROAMING; } /** * Get current voice roaming type. This roaming type could be overridden by the carrier config. * @return roaming type * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public @RoamingType int getVoiceRoamingType() { final NetworkRegistrationInfo regState = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_CS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regState != null) { return regState.getRoamingType(); } return ROAMING_TYPE_NOT_ROAMING; } /** * Get whether the current data network is roaming. * This value may be overwritten by resource overlay or carrier configuration. * @see #getDataRoamingFromRegistration() to get the value from the network registration. * @return roaming type * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public boolean getDataRoaming() { return getDataRoamingType() != ROAMING_TYPE_NOT_ROAMING; } /** * Set whether the data network registration state is roaming. * This should only be set to the roaming value received * once the data registration phase has completed. * @hide */ public void setDataRoamingFromRegistration(boolean dataRoaming) { mIsDataRoamingFromRegistration = dataRoaming; } /** * Get whether data network registration state is roaming. * This value is set directly from the modem and will not be overwritten * by resource overlay or carrier configuration. * @return true if registration indicates roaming, false otherwise * @hide */ public boolean getDataRoamingFromRegistration() { // TODO: all callers should refactor to get roaming state directly from modem // this should not be exposed as a public API return mIsDataRoamingFromRegistration; } /** * Get current data roaming type. This roaming type could be overridden by the carrier config. * @return roaming type * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public @RoamingType int getDataRoamingType() { final NetworkRegistrationInfo regState = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regState != null) { return regState.getRoamingType(); } return ROAMING_TYPE_NOT_ROAMING; } /** * @hide */ @UnsupportedAppUsage public boolean isEmergencyOnly() { return mIsEmergencyOnly; } /** * @hide */ @UnsupportedAppUsage public int getCdmaRoamingIndicator(){ return this.mCdmaRoamingIndicator; } /** * @hide */ @UnsupportedAppUsage public int getCdmaDefaultRoamingIndicator(){ return this.mCdmaDefaultRoamingIndicator; } /** * @hide */ @UnsupportedAppUsage public int getCdmaEriIconIndex() { return this.mCdmaEriIconIndex; } /** * @hide */ @UnsupportedAppUsage public int getCdmaEriIconMode() { return this.mCdmaEriIconMode; } /** * Get current registered operator name in long alphanumeric format. * * In GSM/UMTS, long format can be up to 16 characters long. * In CDMA, returns the ERI text, if set. Otherwise, returns the ONS. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return long name of operator, null if unregistered or unknown */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) public String getOperatorAlphaLong() { return mOperatorAlphaLong; } /** * Get current registered voice network operator name in long alphanumeric format. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return long name of operator * @hide */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.Q, publicAlternatives = "Use {@link #getOperatorAlphaLong} instead.") public String getVoiceOperatorAlphaLong() { return mOperatorAlphaLong; } /** * Get current registered operator name in short alphanumeric format. * * In GSM/UMTS, short format can be up to 8 characters long. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return short name of operator, null if unregistered or unknown */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) public String getOperatorAlphaShort() { return mOperatorAlphaShort; } /** * Get current registered voice network operator name in short alphanumeric format. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not have neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return short name of operator, null if unregistered or unknown * @hide */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.Q, publicAlternatives = "Use {@link #getOperatorAlphaShort} instead.") public String getVoiceOperatorAlphaShort() { return mOperatorAlphaShort; } /** * Get current registered data network operator name in short alphanumeric format. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not have neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return short name of operator, null if unregistered or unknown * @hide */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.Q, publicAlternatives = "Use {@link #getOperatorAlphaShort} instead.") public String getDataOperatorAlphaShort() { return mOperatorAlphaShort; } /** * Get current registered operator name in long alphanumeric format if * available or short otherwise. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @see #getOperatorAlphaLong * @see #getOperatorAlphaShort * * @return name of operator, null if unregistered or unknown * @hide */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) public String getOperatorAlpha() { if (TextUtils.isEmpty(mOperatorAlphaLong)) { return mOperatorAlphaShort; } return mOperatorAlphaLong; } /** * Get current registered operator numeric id. * * In GSM/UMTS, numeric format is 3 digit country code plus 2 or 3 digit * network code. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return numeric format of operator, null if unregistered or unknown */ /* * The country code can be decoded using * {@link com.android.internal.telephony.MccTable#countryCodeForMcc(int)}. */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) public String getOperatorNumeric() { return mOperatorNumeric; } /** * Get current registered voice network operator numeric id. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return numeric format of operator, null if unregistered or unknown * @hide */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public String getVoiceOperatorNumeric() { return mOperatorNumeric; } /** * Get current registered data network operator numeric id. * * Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return null if the * caller does not hold neither {@link android.Manifest.permission#ACCESS_FINE_LOCATION} nor * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. * * @return numeric format of operator, null if unregistered or unknown * @hide */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.Q, publicAlternatives = "Use {@link #getOperatorNumeric} instead.") public String getDataOperatorNumeric() { return mOperatorNumeric; } /** * Get current network selection mode. * * @return true if manual mode, false if automatic mode */ public boolean getIsManualSelection() { return mIsManualNetworkSelection; } @Override public int hashCode() { synchronized (mNetworkRegistrationInfos) { return Objects.hash( mVoiceRegState, mDataRegState, mChannelNumber, Arrays.hashCode(mCellBandwidths), mOperatorAlphaLong, mOperatorAlphaShort, mOperatorNumeric, mIsManualNetworkSelection, mCssIndicator, mNetworkId, mSystemId, mCdmaRoamingIndicator, mCdmaDefaultRoamingIndicator, mCdmaEriIconIndex, mCdmaEriIconMode, mIsEmergencyOnly, mArfcnRsrpBoost, mNetworkRegistrationInfos, mNrFrequencyRange, mOperatorAlphaLongRaw, mOperatorAlphaShortRaw, mIsDataRoamingFromRegistration, mIsIwlanPreferred); } } @Override public boolean equals (Object o) { if (!(o instanceof ServiceState)) return false; ServiceState s = (ServiceState) o; synchronized (mNetworkRegistrationInfos) { return mVoiceRegState == s.mVoiceRegState && mDataRegState == s.mDataRegState && mIsManualNetworkSelection == s.mIsManualNetworkSelection && mChannelNumber == s.mChannelNumber && Arrays.equals(mCellBandwidths, s.mCellBandwidths) && equalsHandlesNulls(mOperatorAlphaLong, s.mOperatorAlphaLong) && equalsHandlesNulls(mOperatorAlphaShort, s.mOperatorAlphaShort) && equalsHandlesNulls(mOperatorNumeric, s.mOperatorNumeric) && equalsHandlesNulls(mCssIndicator, s.mCssIndicator) && equalsHandlesNulls(mNetworkId, s.mNetworkId) && equalsHandlesNulls(mSystemId, s.mSystemId) && equalsHandlesNulls(mCdmaRoamingIndicator, s.mCdmaRoamingIndicator) && equalsHandlesNulls(mCdmaDefaultRoamingIndicator, s.mCdmaDefaultRoamingIndicator) && mIsEmergencyOnly == s.mIsEmergencyOnly && equalsHandlesNulls(mOperatorAlphaLongRaw, s.mOperatorAlphaLongRaw) && equalsHandlesNulls(mOperatorAlphaShortRaw, s.mOperatorAlphaShortRaw) && mNetworkRegistrationInfos.size() == s.mNetworkRegistrationInfos.size() && mNetworkRegistrationInfos.containsAll(s.mNetworkRegistrationInfos) && mNrFrequencyRange == s.mNrFrequencyRange && mIsDataRoamingFromRegistration == s.mIsDataRoamingFromRegistration && mIsIwlanPreferred == s.mIsIwlanPreferred; } } /** * Convert roaming type to string * * @param roamingType roaming type * @return The roaming type in string format * * @hide */ public static String roamingTypeToString(@RoamingType int roamingType) { switch (roamingType) { case ROAMING_TYPE_NOT_ROAMING: return "NOT_ROAMING"; case ROAMING_TYPE_UNKNOWN: return "UNKNOWN"; case ROAMING_TYPE_DOMESTIC: return "DOMESTIC"; case ROAMING_TYPE_INTERNATIONAL: return "INTERNATIONAL"; } return "Unknown roaming type " + roamingType; } /** * Convert radio technology to String * * @param rt radioTechnology * @return String representation of the RAT * * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public static String rilRadioTechnologyToString(int rt) { String rtString; switch(rt) { case RIL_RADIO_TECHNOLOGY_UNKNOWN: rtString = "Unknown"; break; case RIL_RADIO_TECHNOLOGY_GPRS: rtString = "GPRS"; break; case RIL_RADIO_TECHNOLOGY_EDGE: rtString = "EDGE"; break; case RIL_RADIO_TECHNOLOGY_UMTS: rtString = "UMTS"; break; case RIL_RADIO_TECHNOLOGY_IS95A: rtString = "CDMA-IS95A"; break; case RIL_RADIO_TECHNOLOGY_IS95B: rtString = "CDMA-IS95B"; break; case RIL_RADIO_TECHNOLOGY_1xRTT: rtString = "1xRTT"; break; case RIL_RADIO_TECHNOLOGY_EVDO_0: rtString = "EvDo-rev.0"; break; case RIL_RADIO_TECHNOLOGY_EVDO_A: rtString = "EvDo-rev.A"; break; case RIL_RADIO_TECHNOLOGY_HSDPA: rtString = "HSDPA"; break; case RIL_RADIO_TECHNOLOGY_HSUPA: rtString = "HSUPA"; break; case RIL_RADIO_TECHNOLOGY_HSPA: rtString = "HSPA"; break; case RIL_RADIO_TECHNOLOGY_EVDO_B: rtString = "EvDo-rev.B"; break; case RIL_RADIO_TECHNOLOGY_EHRPD: rtString = "eHRPD"; break; case RIL_RADIO_TECHNOLOGY_LTE: rtString = "LTE"; break; case RIL_RADIO_TECHNOLOGY_HSPAP: rtString = "HSPAP"; break; case RIL_RADIO_TECHNOLOGY_GSM: rtString = "GSM"; break; case RIL_RADIO_TECHNOLOGY_IWLAN: rtString = "IWLAN"; break; case RIL_RADIO_TECHNOLOGY_TD_SCDMA: rtString = "TD-SCDMA"; break; case RIL_RADIO_TECHNOLOGY_LTE_CA: rtString = "LTE_CA"; break; case RIL_RADIO_TECHNOLOGY_NR: rtString = "NR_SA"; break; default: rtString = "Unexpected"; Rlog.w(LOG_TAG, "Unexpected radioTechnology=" + rt); break; } return rtString; } /** * Convert frequency range into string * * @param range The cellular frequency range * @return Frequency range in string format * * @hide */ @android.ravenwood.annotation.RavenwoodKeep public static @NonNull String frequencyRangeToString(@FrequencyRange int range) { switch (range) { case FREQUENCY_RANGE_UNKNOWN: return "UNKNOWN"; case FREQUENCY_RANGE_LOW: return "LOW"; case FREQUENCY_RANGE_MID: return "MID"; case FREQUENCY_RANGE_HIGH: return "HIGH"; case FREQUENCY_RANGE_MMWAVE: return "MMWAVE"; default: return Integer.toString(range); } } /** * Convert RIL Service State to String * * @param serviceState * @return String representation of the ServiceState * * @hide */ public static String rilServiceStateToString(int serviceState) { switch(serviceState) { case STATE_IN_SERVICE: return "IN_SERVICE"; case STATE_OUT_OF_SERVICE: return "OUT_OF_SERVICE"; case STATE_EMERGENCY_ONLY: return "EMERGENCY_ONLY"; case STATE_POWER_OFF: return "POWER_OFF"; default: return "UNKNOWN"; } } @Override public String toString() { synchronized (mNetworkRegistrationInfos) { return new StringBuilder().append("{mVoiceRegState=").append(mVoiceRegState) .append("(" + rilServiceStateToString(mVoiceRegState) + ")") .append(", mDataRegState=").append(mDataRegState) .append("(" + rilServiceStateToString(mDataRegState) + ")") .append(", mChannelNumber=").append(mChannelNumber) .append(", duplexMode()=").append(getDuplexMode()) .append(", mCellBandwidths=").append(Arrays.toString(mCellBandwidths)) .append(", mOperatorAlphaLong=").append(mOperatorAlphaLong) .append(", mOperatorAlphaShort=").append(mOperatorAlphaShort) .append(", isManualNetworkSelection=").append(mIsManualNetworkSelection) .append(mIsManualNetworkSelection ? "(manual)" : "(automatic)") .append(", getRilVoiceRadioTechnology=").append(getRilVoiceRadioTechnology()) .append("(" + rilRadioTechnologyToString(getRilVoiceRadioTechnology()) + ")") .append(", getRilDataRadioTechnology=").append(getRilDataRadioTechnology()) .append("(" + rilRadioTechnologyToString(getRilDataRadioTechnology()) + ")") .append(", mCssIndicator=").append(mCssIndicator ? "supported" : "unsupported") .append(", mNetworkId=").append(mNetworkId) .append(", mSystemId=").append(mSystemId) .append(", mCdmaRoamingIndicator=").append(mCdmaRoamingIndicator) .append(", mCdmaDefaultRoamingIndicator=").append(mCdmaDefaultRoamingIndicator) .append(", mIsEmergencyOnly=").append(mIsEmergencyOnly) .append(", isUsingCarrierAggregation=").append(isUsingCarrierAggregation()) .append(", mArfcnRsrpBoost=").append(mArfcnRsrpBoost) .append(", mNetworkRegistrationInfos=").append(mNetworkRegistrationInfos) .append(", mNrFrequencyRange=").append(Build.IS_DEBUGGABLE ? mNrFrequencyRange : FREQUENCY_RANGE_UNKNOWN) .append(", mOperatorAlphaLongRaw=").append(mOperatorAlphaLongRaw) .append(", mOperatorAlphaShortRaw=").append(mOperatorAlphaShortRaw) .append(", mIsDataRoamingFromRegistration=") .append(mIsDataRoamingFromRegistration) .append(", mIsIwlanPreferred=").append(mIsIwlanPreferred) .append("}").toString(); } } /** * Initialize the service state. Set everything to the default value. */ private void init() { if (DBG) Rlog.d(LOG_TAG, "init"); mVoiceRegState = STATE_OUT_OF_SERVICE; mDataRegState = STATE_OUT_OF_SERVICE; mChannelNumber = -1; mCellBandwidths = new int[0]; mOperatorAlphaLong = null; mOperatorAlphaShort = null; mOperatorNumeric = null; mIsManualNetworkSelection = false; mCssIndicator = false; mNetworkId = -1; mSystemId = -1; mCdmaRoamingIndicator = -1; mCdmaDefaultRoamingIndicator = -1; mCdmaEriIconIndex = -1; mCdmaEriIconMode = -1; mIsEmergencyOnly = false; mArfcnRsrpBoost = 0; mNrFrequencyRange = FREQUENCY_RANGE_UNKNOWN; synchronized (mNetworkRegistrationInfos) { mNetworkRegistrationInfos.clear(); addNetworkRegistrationInfo(new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_CS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WWAN) .setRegistrationState(NetworkRegistrationInfo.REGISTRATION_STATE_UNKNOWN) .build()); addNetworkRegistrationInfo(new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_PS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WWAN) .setRegistrationState(NetworkRegistrationInfo.REGISTRATION_STATE_UNKNOWN) .build()); addNetworkRegistrationInfo(new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_PS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WLAN) .setRegistrationState(NetworkRegistrationInfo.REGISTRATION_STATE_UNKNOWN) .build()); } mOperatorAlphaLongRaw = null; mOperatorAlphaShortRaw = null; mIsDataRoamingFromRegistration = false; mIsIwlanPreferred = false; } public void setStateOutOfService() { init(); } public void setStateOff() { init(); mVoiceRegState = STATE_POWER_OFF; mDataRegState = STATE_POWER_OFF; } /** * Set the service state to out-of-service * * @param powerOff {@code true} if this is a power off case (i.e. Airplane mode on). * @hide */ public void setOutOfService(boolean powerOff) { init(); if (powerOff) { mVoiceRegState = STATE_POWER_OFF; mDataRegState = STATE_POWER_OFF; } } public void setState(int state) { setVoiceRegState(state); if (DBG) Rlog.e(LOG_TAG, "[ServiceState] setState deprecated use setVoiceRegState()"); } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public void setVoiceRegState(int state) { mVoiceRegState = state; if (DBG) Rlog.d(LOG_TAG, "[ServiceState] setVoiceRegState=" + mVoiceRegState); } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setDataRegState(int state) { mDataRegState = state; if (VDBG) Rlog.d(LOG_TAG, "[ServiceState] setDataRegState=" + mDataRegState); } /** @hide */ @TestApi public void setCellBandwidths(int[] bandwidths) { mCellBandwidths = bandwidths; } /** @hide */ @TestApi public void setChannelNumber(int channelNumber) { mChannelNumber = channelNumber; } public void setRoaming(boolean roaming) { setVoiceRoaming(roaming); setDataRoaming(roaming); } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public void setVoiceRoaming(boolean roaming) { setVoiceRoamingType(roaming ? ROAMING_TYPE_UNKNOWN : ROAMING_TYPE_NOT_ROAMING); } /** @hide */ @TestApi public void setVoiceRoamingType(@RoamingType int type) { NetworkRegistrationInfo regInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_CS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regInfo == null) { regInfo = new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_CS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WWAN) .build(); } regInfo.setRoamingType(type); addNetworkRegistrationInfo(regInfo); } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public void setDataRoaming(boolean dataRoaming) { setDataRoamingType(dataRoaming ? ROAMING_TYPE_UNKNOWN : ROAMING_TYPE_NOT_ROAMING); } /** @hide */ @TestApi public void setDataRoamingType(@RoamingType int type) { NetworkRegistrationInfo regInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regInfo == null) { regInfo = new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_PS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WWAN) .build(); } regInfo.setRoamingType(type); addNetworkRegistrationInfo(regInfo); } /** * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setEmergencyOnly(boolean emergencyOnly) { mIsEmergencyOnly = emergencyOnly; } /** * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setCdmaRoamingIndicator(int roaming) { this.mCdmaRoamingIndicator = roaming; } /** * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setCdmaDefaultRoamingIndicator (int roaming) { this.mCdmaDefaultRoamingIndicator = roaming; } /** * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setCdmaEriIconIndex(int index) { this.mCdmaEriIconIndex = index; } /** * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setCdmaEriIconMode(int mode) { this.mCdmaEriIconMode = mode; } public void setOperatorName(String longName, String shortName, String numeric) { mOperatorAlphaLong = longName; mOperatorAlphaShort = shortName; mOperatorNumeric = numeric; } /** * In CDMA, mOperatorAlphaLong can be set from the ERI text. * This is done from the GsmCdmaPhone and not from the ServiceStateTracker. * * @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public void setOperatorAlphaLong(@Nullable String longName) { mOperatorAlphaLong = longName; } public void setIsManualSelection(boolean isManual) { mIsManualNetworkSelection = isManual; } /** * Test whether two objects hold the same data values or both are null. * * @param a first obj * @param b second obj * @return true if two objects equal or both are null */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) private static boolean equalsHandlesNulls (Object a, Object b) { return (a == null) ? (b == null) : a.equals (b); } /** * Set ServiceState based on intent notifier map. * * @param m intent notifier map * @hide */ @UnsupportedAppUsage private void setFromNotifierBundle(Bundle m) { ServiceState ssFromBundle = m.getParcelable(EXTRA_SERVICE_STATE, android.telephony.ServiceState.class); if (ssFromBundle != null) { copyFrom(ssFromBundle); } } /** * Set intent notifier Bundle based on service state. * * Put ServiceState object and its fields into bundle which is used by TelephonyRegistry * to broadcast {@link Intent#ACTION_SERVICE_STATE}. * * @param m intent notifier Bundle * @hide * */ @UnsupportedAppUsage public void fillInNotifierBundle(@NonNull Bundle m) { m.putParcelable(EXTRA_SERVICE_STATE, this); // serviceState already consists of below entries. // for backward compatibility, we continue fill in below entries. m.putInt("voiceRegState", mVoiceRegState); m.putInt("dataRegState", mDataRegState); m.putInt("dataRoamingType", getDataRoamingType()); m.putInt("voiceRoamingType", getVoiceRoamingType()); m.putString("operator-alpha-long", mOperatorAlphaLong); m.putString("operator-alpha-short", mOperatorAlphaShort); m.putString("operator-numeric", mOperatorNumeric); m.putString("data-operator-alpha-long", mOperatorAlphaLong); m.putString("data-operator-alpha-short", mOperatorAlphaShort); m.putString("data-operator-numeric", mOperatorNumeric); m.putBoolean("manual", mIsManualNetworkSelection); m.putInt("radioTechnology", getRilVoiceRadioTechnology()); m.putInt("dataRadioTechnology", getRilDataRadioTechnology()); m.putBoolean("cssIndicator", mCssIndicator); m.putInt("networkId", mNetworkId); m.putInt("systemId", mSystemId); m.putInt("cdmaRoamingIndicator", mCdmaRoamingIndicator); m.putInt("cdmaDefaultRoamingIndicator", mCdmaDefaultRoamingIndicator); m.putBoolean("emergencyOnly", mIsEmergencyOnly); m.putBoolean("isDataRoamingFromRegistration", getDataRoamingFromRegistration()); m.putBoolean("isUsingCarrierAggregation", isUsingCarrierAggregation()); m.putInt("ArfcnRsrpBoost", mArfcnRsrpBoost); m.putInt("ChannelNumber", mChannelNumber); m.putIntArray("CellBandwidths", mCellBandwidths); m.putInt("mNrFrequencyRange", mNrFrequencyRange); m.putString("operator-alpha-long-raw", mOperatorAlphaLongRaw); m.putString("operator-alpha-short-raw", mOperatorAlphaShortRaw); } /** @hide */ @TestApi public void setRilVoiceRadioTechnology(@RilRadioTechnology int rt) { Rlog.e(LOG_TAG, "ServiceState.setRilVoiceRadioTechnology() called. It's encouraged to " + "use addNetworkRegistrationInfo() instead *******"); // Sync to network registration state NetworkRegistrationInfo regInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_CS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regInfo == null) { regInfo = new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_CS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WWAN) .build(); } regInfo.setAccessNetworkTechnology(rilRadioTechnologyToNetworkType(rt)); addNetworkRegistrationInfo(regInfo); } /** @hide */ @TestApi public void setRilDataRadioTechnology(@RilRadioTechnology int rt) { Rlog.e(LOG_TAG, "ServiceState.setRilDataRadioTechnology() called. It's encouraged to " + "use addNetworkRegistrationInfo() instead *******"); // Sync to network registration state. Always write down the WWAN transport. For AP-assisted // mode device, use addNetworkRegistrationInfo() to set the correct transport if RAT // is IWLAN. NetworkRegistrationInfo regInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regInfo == null) { regInfo = new NetworkRegistrationInfo.Builder() .setDomain(NetworkRegistrationInfo.DOMAIN_PS) .setTransportType(AccessNetworkConstants.TRANSPORT_TYPE_WWAN) .build(); } regInfo.setAccessNetworkTechnology(rilRadioTechnologyToNetworkType(rt)); addNetworkRegistrationInfo(regInfo); } /** @hide */ public boolean isUsingCarrierAggregation() { if (getCellBandwidths().length > 1) return true; synchronized (mNetworkRegistrationInfos) { for (NetworkRegistrationInfo nri : mNetworkRegistrationInfos) { if (nri.isUsingCarrierAggregation()) return true; } } return false; } /** * Get the 5G NR frequency range the device is currently registered. * * @return the frequency range of 5G NR. * @hide */ public @FrequencyRange int getNrFrequencyRange() { return mNrFrequencyRange; } /** * Get the NR 5G state of the mobile data network. * @return the NR 5G state. * @hide */ public @NRState int getNrState() { final NetworkRegistrationInfo regInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regInfo == null) return NetworkRegistrationInfo.NR_STATE_NONE; return regInfo.getNrState(); } /** * @param nrFrequencyRange the frequency range of 5G NR. * @hide */ public void setNrFrequencyRange(@FrequencyRange int nrFrequencyRange) { mNrFrequencyRange = nrFrequencyRange; } /** @hide */ public int getArfcnRsrpBoost() { return mArfcnRsrpBoost; } /** @hide */ public void setArfcnRsrpBoost(int arfcnRsrpBoost) { mArfcnRsrpBoost = arfcnRsrpBoost; } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public void setCssIndicator(int css) { this.mCssIndicator = (css != 0); } /** @hide */ @TestApi public void setCdmaSystemAndNetworkId(int systemId, int networkId) { this.mSystemId = systemId; this.mNetworkId = networkId; } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public int getRilVoiceRadioTechnology() { NetworkRegistrationInfo wwanRegInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_CS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (wwanRegInfo != null) { return networkTypeToRilRadioTechnology(wwanRegInfo.getAccessNetworkTechnology()); } return RIL_RADIO_TECHNOLOGY_UNKNOWN; } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public int getRilDataRadioTechnology() { return networkTypeToRilRadioTechnology(getDataNetworkType()); } /** * Transform RIL radio technology {@link RilRadioTechnology} value to Network * type {@link NetworkType}. * * @param rat The RIL radio technology {@link RilRadioTechnology}. * @return The network type {@link NetworkType}. * * @hide */ public static int rilRadioTechnologyToNetworkType(@RilRadioTechnology int rat) { switch(rat) { case RIL_RADIO_TECHNOLOGY_GPRS: return TelephonyManager.NETWORK_TYPE_GPRS; case RIL_RADIO_TECHNOLOGY_EDGE: return TelephonyManager.NETWORK_TYPE_EDGE; case RIL_RADIO_TECHNOLOGY_UMTS: return TelephonyManager.NETWORK_TYPE_UMTS; case RIL_RADIO_TECHNOLOGY_HSDPA: return TelephonyManager.NETWORK_TYPE_HSDPA; case RIL_RADIO_TECHNOLOGY_HSUPA: return TelephonyManager.NETWORK_TYPE_HSUPA; case RIL_RADIO_TECHNOLOGY_HSPA: return TelephonyManager.NETWORK_TYPE_HSPA; case RIL_RADIO_TECHNOLOGY_IS95A: case RIL_RADIO_TECHNOLOGY_IS95B: return TelephonyManager.NETWORK_TYPE_CDMA; case RIL_RADIO_TECHNOLOGY_1xRTT: return TelephonyManager.NETWORK_TYPE_1xRTT; case RIL_RADIO_TECHNOLOGY_EVDO_0: return TelephonyManager.NETWORK_TYPE_EVDO_0; case RIL_RADIO_TECHNOLOGY_EVDO_A: return TelephonyManager.NETWORK_TYPE_EVDO_A; case RIL_RADIO_TECHNOLOGY_EVDO_B: return TelephonyManager.NETWORK_TYPE_EVDO_B; case RIL_RADIO_TECHNOLOGY_EHRPD: return TelephonyManager.NETWORK_TYPE_EHRPD; case RIL_RADIO_TECHNOLOGY_LTE: return TelephonyManager.NETWORK_TYPE_LTE; case RIL_RADIO_TECHNOLOGY_HSPAP: return TelephonyManager.NETWORK_TYPE_HSPAP; case RIL_RADIO_TECHNOLOGY_GSM: return TelephonyManager.NETWORK_TYPE_GSM; case RIL_RADIO_TECHNOLOGY_TD_SCDMA: return TelephonyManager.NETWORK_TYPE_TD_SCDMA; case RIL_RADIO_TECHNOLOGY_IWLAN: return TelephonyManager.NETWORK_TYPE_IWLAN; case RIL_RADIO_TECHNOLOGY_LTE_CA: return TelephonyManager.NETWORK_TYPE_LTE_CA; case RIL_RADIO_TECHNOLOGY_NR: return TelephonyManager.NETWORK_TYPE_NR; default: return TelephonyManager.NETWORK_TYPE_UNKNOWN; } } /** @hide */ public static int rilRadioTechnologyToAccessNetworkType(@RilRadioTechnology int rt) { switch(rt) { case RIL_RADIO_TECHNOLOGY_GPRS: case RIL_RADIO_TECHNOLOGY_EDGE: case RIL_RADIO_TECHNOLOGY_GSM: return AccessNetworkType.GERAN; case RIL_RADIO_TECHNOLOGY_UMTS: case RIL_RADIO_TECHNOLOGY_HSDPA: case RIL_RADIO_TECHNOLOGY_HSPAP: case RIL_RADIO_TECHNOLOGY_HSUPA: case RIL_RADIO_TECHNOLOGY_HSPA: case RIL_RADIO_TECHNOLOGY_TD_SCDMA: return AccessNetworkType.UTRAN; case RIL_RADIO_TECHNOLOGY_IS95A: case RIL_RADIO_TECHNOLOGY_IS95B: case RIL_RADIO_TECHNOLOGY_1xRTT: case RIL_RADIO_TECHNOLOGY_EVDO_0: case RIL_RADIO_TECHNOLOGY_EVDO_A: case RIL_RADIO_TECHNOLOGY_EVDO_B: case RIL_RADIO_TECHNOLOGY_EHRPD: return AccessNetworkType.CDMA2000; case RIL_RADIO_TECHNOLOGY_LTE: case RIL_RADIO_TECHNOLOGY_LTE_CA: return AccessNetworkType.EUTRAN; case RIL_RADIO_TECHNOLOGY_NR: return AccessNetworkType.NGRAN; case RIL_RADIO_TECHNOLOGY_IWLAN: return AccessNetworkType.IWLAN; case RIL_RADIO_TECHNOLOGY_UNKNOWN: default: return AccessNetworkType.UNKNOWN; } } /** * Transform network type {@link NetworkType} value to RIL radio technology * {@link RilRadioTechnology}. * * @param networkType The network type {@link NetworkType}. * @return The RIL radio technology {@link RilRadioTechnology}. * * @hide */ public static int networkTypeToRilRadioTechnology(int networkType) { switch(networkType) { case TelephonyManager.NETWORK_TYPE_GPRS: return RIL_RADIO_TECHNOLOGY_GPRS; case TelephonyManager.NETWORK_TYPE_EDGE: return RIL_RADIO_TECHNOLOGY_EDGE; case TelephonyManager.NETWORK_TYPE_UMTS: return RIL_RADIO_TECHNOLOGY_UMTS; case TelephonyManager.NETWORK_TYPE_HSDPA: return RIL_RADIO_TECHNOLOGY_HSDPA; case TelephonyManager.NETWORK_TYPE_HSUPA: return RIL_RADIO_TECHNOLOGY_HSUPA; case TelephonyManager.NETWORK_TYPE_HSPA: return RIL_RADIO_TECHNOLOGY_HSPA; case TelephonyManager.NETWORK_TYPE_CDMA: return RIL_RADIO_TECHNOLOGY_IS95A; case TelephonyManager.NETWORK_TYPE_1xRTT: return RIL_RADIO_TECHNOLOGY_1xRTT; case TelephonyManager.NETWORK_TYPE_EVDO_0: return RIL_RADIO_TECHNOLOGY_EVDO_0; case TelephonyManager.NETWORK_TYPE_EVDO_A: return RIL_RADIO_TECHNOLOGY_EVDO_A; case TelephonyManager.NETWORK_TYPE_EVDO_B: return RIL_RADIO_TECHNOLOGY_EVDO_B; case TelephonyManager.NETWORK_TYPE_EHRPD: return RIL_RADIO_TECHNOLOGY_EHRPD; case TelephonyManager.NETWORK_TYPE_LTE: return RIL_RADIO_TECHNOLOGY_LTE; case TelephonyManager.NETWORK_TYPE_HSPAP: return RIL_RADIO_TECHNOLOGY_HSPAP; case TelephonyManager.NETWORK_TYPE_GSM: return RIL_RADIO_TECHNOLOGY_GSM; case TelephonyManager.NETWORK_TYPE_TD_SCDMA: return RIL_RADIO_TECHNOLOGY_TD_SCDMA; case TelephonyManager.NETWORK_TYPE_IWLAN: return RIL_RADIO_TECHNOLOGY_IWLAN; case TelephonyManager.NETWORK_TYPE_LTE_CA: return RIL_RADIO_TECHNOLOGY_LTE_CA; case TelephonyManager.NETWORK_TYPE_NR: return RIL_RADIO_TECHNOLOGY_NR; default: return RIL_RADIO_TECHNOLOGY_UNKNOWN; } } /** * Get current data network type. * * Note that for IWLAN AP-assisted mode device, which is reporting both camped access networks * (cellular RAT and IWLAN)at the same time, this API is simulating the old legacy mode device * behavior, * * @return Current data network type * @hide */ @TestApi public @NetworkType int getDataNetworkType() { final NetworkRegistrationInfo iwlanRegInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WLAN); final NetworkRegistrationInfo wwanRegInfo = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); // For legacy mode device, or AP-assisted mode device but IWLAN is out of service, use // the RAT from cellular. if (iwlanRegInfo == null || !iwlanRegInfo.isInService()) { return (wwanRegInfo != null) ? wwanRegInfo.getAccessNetworkTechnology() : TelephonyManager.NETWORK_TYPE_UNKNOWN; } // At this point, it must be an AP-assisted mode device and IWLAN is in service. We should // use the RAT from IWLAN service is cellular is out of service, or when both are in service // and any APN type of data is preferred on IWLAN. if (!wwanRegInfo.isInService() || mIsIwlanPreferred) { return iwlanRegInfo.getAccessNetworkTechnology(); } // If both cellular and IWLAN are in service, but no APN is preferred on IWLAN, still use // the RAT from cellular. return wwanRegInfo.getAccessNetworkTechnology(); } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P) public @NetworkType int getVoiceNetworkType() { final NetworkRegistrationInfo regState = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_CS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (regState != null) { return regState.getAccessNetworkTechnology(); } return TelephonyManager.NETWORK_TYPE_UNKNOWN; } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public int getCssIndicator() { return this.mCssIndicator ? 1 : 0; } /** * Get the CDMA NID (Network Identification Number), a number uniquely identifying a network * within a wireless system. (Defined in 3GPP2 C.S0023 3.4.8) * *

Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return * {@link #UNKNOWN_ID}. * * @return The CDMA NID or {@link #UNKNOWN_ID} if not available. */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) public int getCdmaNetworkId() { return this.mNetworkId; } /** * Get the CDMA SID (System Identification Number), a number uniquely identifying a wireless * system. (Defined in 3GPP2 C.S0023 3.4.8) * *

Require at least {@link android.Manifest.permission#ACCESS_FINE_LOCATION} or * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION}. Otherwise return * {@link #UNKNOWN_ID}. * * @return The CDMA SID or {@link #UNKNOWN_ID} if not available. */ @RequiresPermission(anyOf = { android.Manifest.permission.ACCESS_FINE_LOCATION, android.Manifest.permission.ACCESS_COARSE_LOCATION }) public int getCdmaSystemId() { return this.mSystemId; } /** @hide */ @UnsupportedAppUsage public static boolean isGsm(int radioTechnology) { return radioTechnology == RIL_RADIO_TECHNOLOGY_GPRS || radioTechnology == RIL_RADIO_TECHNOLOGY_EDGE || radioTechnology == RIL_RADIO_TECHNOLOGY_UMTS || radioTechnology == RIL_RADIO_TECHNOLOGY_HSDPA || radioTechnology == RIL_RADIO_TECHNOLOGY_HSUPA || radioTechnology == RIL_RADIO_TECHNOLOGY_HSPA || radioTechnology == RIL_RADIO_TECHNOLOGY_LTE || radioTechnology == RIL_RADIO_TECHNOLOGY_HSPAP || radioTechnology == RIL_RADIO_TECHNOLOGY_GSM || radioTechnology == RIL_RADIO_TECHNOLOGY_TD_SCDMA || radioTechnology == RIL_RADIO_TECHNOLOGY_IWLAN || radioTechnology == RIL_RADIO_TECHNOLOGY_LTE_CA || radioTechnology == RIL_RADIO_TECHNOLOGY_NR; } /** @hide */ @UnsupportedAppUsage public static boolean isCdma(int radioTechnology) { return radioTechnology == RIL_RADIO_TECHNOLOGY_IS95A || radioTechnology == RIL_RADIO_TECHNOLOGY_IS95B || radioTechnology == RIL_RADIO_TECHNOLOGY_1xRTT || radioTechnology == RIL_RADIO_TECHNOLOGY_EVDO_0 || radioTechnology == RIL_RADIO_TECHNOLOGY_EVDO_A || radioTechnology == RIL_RADIO_TECHNOLOGY_EVDO_B || radioTechnology == RIL_RADIO_TECHNOLOGY_EHRPD; } /** @hide */ public static boolean isPsOnlyTech(int radioTechnology) { return radioTechnology == RIL_RADIO_TECHNOLOGY_LTE || radioTechnology == RIL_RADIO_TECHNOLOGY_LTE_CA || radioTechnology == RIL_RADIO_TECHNOLOGY_NR; } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.P, trackingBug = 115609023) public static boolean bearerBitmapHasCdma(int networkTypeBitmask) { return (RIL_RADIO_CDMA_TECHNOLOGY_BITMASK & convertNetworkTypeBitmaskToBearerBitmask(networkTypeBitmask)) != 0; } /** @hide */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public static boolean bitmaskHasTech(int bearerBitmask, int radioTech) { if (bearerBitmask == 0) { return true; } else if (radioTech >= 1) { return ((bearerBitmask & (1 << (radioTech - 1))) != 0); } return false; } /** @hide */ public static int getBitmaskForTech(int radioTech) { if (radioTech >= 1) { return (1 << (radioTech - 1)); } return 0; } /** @hide */ public static int getBitmaskFromString(String bearerList) { String[] bearers = bearerList.split("\\|"); int bearerBitmask = 0; for (String bearer : bearers) { int bearerInt = 0; try { bearerInt = Integer.parseInt(bearer.trim()); } catch (NumberFormatException nfe) { return 0; } if (bearerInt == 0) { return 0; } bearerBitmask |= getBitmaskForTech(bearerInt); } return bearerBitmask; } /** * Convert network type bitmask to bearer bitmask. * * @param networkTypeBitmask The network type bitmask value * @return The bearer bitmask value. * * @hide */ public static int convertNetworkTypeBitmaskToBearerBitmask(int networkTypeBitmask) { if (networkTypeBitmask == 0) { return 0; } int bearerBitmask = 0; for (int bearerInt = 0; bearerInt < NEXT_RIL_RADIO_TECHNOLOGY; bearerInt++) { if (bitmaskHasTech(networkTypeBitmask, rilRadioTechnologyToNetworkType(bearerInt))) { bearerBitmask |= getBitmaskForTech(bearerInt); } } return bearerBitmask; } /** * Convert bearer bitmask to network type bitmask. * * @param bearerBitmask The bearer bitmask value. * @return The network type bitmask value. * * @hide */ public static int convertBearerBitmaskToNetworkTypeBitmask(int bearerBitmask) { if (bearerBitmask == 0) { return 0; } int networkTypeBitmask = 0; for (int bearerInt = 0; bearerInt < NEXT_RIL_RADIO_TECHNOLOGY; bearerInt++) { if (bitmaskHasTech(bearerBitmask, bearerInt)) { networkTypeBitmask |= getBitmaskForTech(rilRadioTechnologyToNetworkType(bearerInt)); } } return networkTypeBitmask; } /** * Returns a merged ServiceState consisting of the base SS with voice settings from the * voice SS. The voice SS is only used if it is IN_SERVICE (otherwise the base SS is returned). * @hide * */ @UnsupportedAppUsage(maxTargetSdk = Build.VERSION_CODES.R, trackingBug = 170729553) public static ServiceState mergeServiceStates(ServiceState baseSs, ServiceState voiceSs) { if (voiceSs.mVoiceRegState != STATE_IN_SERVICE) { return baseSs; } ServiceState newSs = new ServiceState(baseSs); // voice overrides newSs.mVoiceRegState = voiceSs.mVoiceRegState; newSs.mIsEmergencyOnly = false; // only get here if voice is IN_SERVICE return newSs; } /** * Get all of the available network registration info. * * @return List of {@link NetworkRegistrationInfo} */ @NonNull public List getNetworkRegistrationInfoList() { synchronized (mNetworkRegistrationInfos) { List newList = new ArrayList<>(); for (NetworkRegistrationInfo nri : mNetworkRegistrationInfos) { newList.add(new NetworkRegistrationInfo(nri)); } return newList; } } /** * Get the network registration info list for the transport type. * * @param transportType The transport type * @return List of {@link NetworkRegistrationInfo} * @hide */ @NonNull @SystemApi public List getNetworkRegistrationInfoListForTransportType( @TransportType int transportType) { List list = new ArrayList<>(); synchronized (mNetworkRegistrationInfos) { for (NetworkRegistrationInfo networkRegistrationInfo : mNetworkRegistrationInfos) { if (networkRegistrationInfo.getTransportType() == transportType) { list.add(new NetworkRegistrationInfo(networkRegistrationInfo)); } } } return list; } /** * Get the network registration info list for the network domain. * * @param domain The network {@link NetworkRegistrationInfo.Domain domain} * @return List of {@link NetworkRegistrationInfo} * @hide */ @NonNull @SystemApi public List getNetworkRegistrationInfoListForDomain( @Domain int domain) { List list = new ArrayList<>(); synchronized (mNetworkRegistrationInfos) { for (NetworkRegistrationInfo networkRegistrationInfo : mNetworkRegistrationInfos) { if ((networkRegistrationInfo.getDomain() & domain) != 0) { list.add(new NetworkRegistrationInfo(networkRegistrationInfo)); } } } return list; } /** * Get the network registration state for the transport type and network domain. * If multiple domains are in the input bitmask, only the first one from * networkRegistrationInfo.getDomain() will be returned. * * @param domain The network {@link NetworkRegistrationInfo.Domain domain} * @param transportType The transport type * @return The matching {@link NetworkRegistrationInfo} * @hide */ @Nullable @SystemApi public NetworkRegistrationInfo getNetworkRegistrationInfo(@Domain int domain, @TransportType int transportType) { synchronized (mNetworkRegistrationInfos) { for (NetworkRegistrationInfo networkRegistrationInfo : mNetworkRegistrationInfos) { if (networkRegistrationInfo.getTransportType() == transportType && (networkRegistrationInfo.getDomain() & domain) != 0) { return new NetworkRegistrationInfo(networkRegistrationInfo); } } } return null; } /** * @hide */ @TestApi public void addNetworkRegistrationInfo(NetworkRegistrationInfo nri) { if (nri == null) return; synchronized (mNetworkRegistrationInfos) { for (int i = 0; i < mNetworkRegistrationInfos.size(); i++) { NetworkRegistrationInfo curRegState = mNetworkRegistrationInfos.get(i); if (curRegState.getTransportType() == nri.getTransportType() && curRegState.getDomain() == nri.getDomain()) { mNetworkRegistrationInfos.remove(i); break; } } mNetworkRegistrationInfos.add(new NetworkRegistrationInfo(nri)); } } /** * Returns a copy of self with location-identifying information removed. * Always clears the NetworkRegistrationInfo's CellIdentity fields, but if removeCoarseLocation * is true, clears other info as well. * * @param removeCoarseLocation Whether to also remove coarse location information. * if false, it only clears fine location information such as * NetworkRegistrationInfo's CellIdentity fields; If true, it will * also remove other location information such as operator's MCC * and MNC. * @return the copied ServiceState with location info sanitized. * @hide */ @NonNull public ServiceState createLocationInfoSanitizedCopy(boolean removeCoarseLocation) { ServiceState state = new ServiceState(this); synchronized (state.mNetworkRegistrationInfos) { List networkRegistrationInfos = state.mNetworkRegistrationInfos.stream() .map(NetworkRegistrationInfo::sanitizeLocationInfo) .collect(Collectors.toList()); state.mNetworkRegistrationInfos.clear(); state.mNetworkRegistrationInfos.addAll(networkRegistrationInfos); } if (!removeCoarseLocation) return state; state.mOperatorAlphaLong = null; state.mOperatorAlphaShort = null; state.mOperatorNumeric = null; state.mSystemId = UNKNOWN_ID; state.mNetworkId = UNKNOWN_ID; return state; } /** * @hide */ public void setOperatorAlphaLongRaw(String operatorAlphaLong) { mOperatorAlphaLongRaw = operatorAlphaLong; } /** * The current registered raw data network operator name in long alphanumeric format. * * The long format can be up to 16 characters long. * * @return long raw name of operator, null if unregistered or unknown * @hide */ @Nullable public String getOperatorAlphaLongRaw() { return mOperatorAlphaLongRaw; } /** * @hide */ public void setOperatorAlphaShortRaw(String operatorAlphaShort) { mOperatorAlphaShortRaw = operatorAlphaShort; } /** * The current registered raw data network operator name in short alphanumeric format. * * The short format can be up to 8 characters long. * * @return short raw name of operator, null if unregistered or unknown * @hide */ @Nullable public String getOperatorAlphaShortRaw() { return mOperatorAlphaShortRaw; } /** * Set to {@code true} if any data network is preferred on IWLAN. * * @param isIwlanPreferred {@code true} if IWLAN is preferred. * @hide */ public void setIwlanPreferred(boolean isIwlanPreferred) { mIsIwlanPreferred = isIwlanPreferred; } /** * @return {@code true} if any data network is preferred on IWLAN. * * Note only when this value is true, {@link #getDataNetworkType()} will return * {@link TelephonyManager#NETWORK_TYPE_IWLAN} when AP-assisted mode device camps on both * cellular and IWLAN. This value does not affect legacy mode devices as the data network * type is directly reported by the modem. * * @hide */ public boolean isIwlanPreferred() { return mIsIwlanPreferred; } /** * This indicates whether the device is searching for service. * * This API reports the modem searching status for * {@link AccessNetworkConstants#TRANSPORT_TYPE_WWAN} (cellular) service in either * {@link NetworkRegistrationInfo#DOMAIN_CS} or {@link NetworkRegistrationInfo#DOMAIN_PS}. * This API will not report searching status for * {@link AccessNetworkConstants#TRANSPORT_TYPE_WLAN}. * * @return {@code true} whenever the modem is searching for service. */ public boolean isSearching() { NetworkRegistrationInfo psRegState = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_PS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (psRegState != null && psRegState.getRegistrationState() == NetworkRegistrationInfo.REGISTRATION_STATE_NOT_REGISTERED_SEARCHING) { return true; } NetworkRegistrationInfo csRegState = getNetworkRegistrationInfo( NetworkRegistrationInfo.DOMAIN_CS, AccessNetworkConstants.TRANSPORT_TYPE_WWAN); if (csRegState != null && csRegState.getRegistrationState() == NetworkRegistrationInfo.REGISTRATION_STATE_NOT_REGISTERED_SEARCHING) { return true; } return false; } /** * The frequency range is valid or not. * * @param frequencyRange The frequency range {@link FrequencyRange}. * @return {@code true} if valid, {@code false} otherwise. * * @hide */ public static boolean isFrequencyRangeValid(int frequencyRange) { if (frequencyRange == FREQUENCY_RANGE_LOW || frequencyRange == FREQUENCY_RANGE_MID || frequencyRange == FREQUENCY_RANGE_HIGH || frequencyRange == FREQUENCY_RANGE_MMWAVE) { return true; } else { return false; } } /** * Get whether device is connected to a non-terrestrial network. * * @return {@code true} if device is connected to a non-terrestrial network else {@code false}. */ @FlaggedApi(Flags.FLAG_CARRIER_ENABLED_SATELLITE_FLAG) public boolean isUsingNonTerrestrialNetwork() { synchronized (mNetworkRegistrationInfos) { for (NetworkRegistrationInfo nri : mNetworkRegistrationInfos) { if (nri.isNonTerrestrialNetwork()) return true; } } return false; } }