| /* |
| * Copyright 2018 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 com.android.internal.telephony; |
| |
| import android.content.ContentResolver; |
| import android.content.Context; |
| import android.os.SystemProperties; |
| import android.provider.Settings; |
| import android.telephony.TelephonyManager; |
| import android.util.TimestampedValue; |
| |
| import com.android.internal.util.IndentingPrintWriter; |
| |
| import java.io.FileDescriptor; |
| import java.io.PrintWriter; |
| |
| /** |
| * {@hide} |
| */ |
| public interface NitzStateMachine { |
| |
| /** |
| * Called when the network country is set on the Phone. Although set, the network country code |
| * may be invalid. |
| * |
| * @param countryChanged true when the country code is known to have changed, false if it |
| * probably hasn't |
| */ |
| void handleNetworkCountryCodeSet(boolean countryChanged); |
| |
| /** |
| * Informs the {@link NitzStateMachine} that the network has become available. |
| */ |
| void handleNetworkAvailable(); |
| |
| /** |
| * Informs the {@link NitzStateMachine} that the network has become unavailable. |
| */ |
| void handleNetworkUnavailable(); |
| |
| /** |
| * Handle a new NITZ signal being received. |
| */ |
| void handleNitzReceived(TimestampedValue<NitzData> nitzSignal); |
| |
| /** |
| * Dumps the current in-memory state to the supplied PrintWriter. |
| */ |
| void dumpState(PrintWriter pw); |
| |
| /** |
| * Dumps the time / time zone logs to the supplied IndentingPrintWriter. |
| */ |
| void dumpLogs(FileDescriptor fd, IndentingPrintWriter ipw, String[] args); |
| |
| /** |
| * Returns the last NITZ data that was cached. |
| */ |
| NitzData getCachedNitzData(); |
| |
| /** |
| * Returns the time zone ID from the most recent time that a time zone could be determined by |
| * this state machine. |
| */ |
| String getSavedTimeZoneId(); |
| |
| /** |
| * A proxy over device state that allows things like system properties, system clock |
| * to be faked for tests. |
| */ |
| // Non-final to allow mocking. |
| class DeviceState { |
| private static final int NITZ_UPDATE_SPACING_DEFAULT = 1000 * 60 * 10; |
| private final int mNitzUpdateSpacing; |
| |
| private static final int NITZ_UPDATE_DIFF_DEFAULT = 2000; |
| private final int mNitzUpdateDiff; |
| |
| private final GsmCdmaPhone mPhone; |
| private final TelephonyManager mTelephonyManager; |
| private final ContentResolver mCr; |
| |
| public DeviceState(GsmCdmaPhone phone) { |
| mPhone = phone; |
| |
| Context context = phone.getContext(); |
| mTelephonyManager = |
| (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE); |
| mCr = context.getContentResolver(); |
| mNitzUpdateSpacing = |
| SystemProperties.getInt("ro.nitz_update_spacing", NITZ_UPDATE_SPACING_DEFAULT); |
| mNitzUpdateDiff = |
| SystemProperties.getInt("ro.nitz_update_diff", NITZ_UPDATE_DIFF_DEFAULT); |
| } |
| |
| /** |
| * If time between NITZ updates is less than {@link #getNitzUpdateSpacingMillis()} the |
| * update may be ignored. |
| */ |
| public int getNitzUpdateSpacingMillis() { |
| return Settings.Global.getInt(mCr, Settings.Global.NITZ_UPDATE_SPACING, |
| mNitzUpdateSpacing); |
| } |
| |
| /** |
| * If {@link #getNitzUpdateSpacingMillis()} hasn't been exceeded but update is > |
| * {@link #getNitzUpdateDiffMillis()} do the update |
| */ |
| public int getNitzUpdateDiffMillis() { |
| return Settings.Global.getInt(mCr, Settings.Global.NITZ_UPDATE_DIFF, mNitzUpdateDiff); |
| } |
| |
| /** |
| * Returns true if the {@code gsm.ignore-nitz} system property is set to "yes". |
| */ |
| public boolean getIgnoreNitz() { |
| String ignoreNitz = SystemProperties.get("gsm.ignore-nitz"); |
| return ignoreNitz != null && ignoreNitz.equals("yes"); |
| } |
| |
| public String getNetworkCountryIsoForPhone() { |
| return mTelephonyManager.getNetworkCountryIsoForPhone(mPhone.getPhoneId()); |
| } |
| } |
| } |