/* * Copyright 2017 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.server.wifi; import static com.android.server.wifi.WifiController.CMD_WIFI_TOGGLED; import android.content.Context; import android.database.ContentObserver; import android.net.wifi.ScanResult; import android.net.wifi.WifiConfiguration; import android.net.wifi.WifiScanner; import android.os.Handler; import android.os.Looper; import android.provider.Settings; import android.util.Log; import com.android.internal.annotations.VisibleForTesting; import java.io.FileDescriptor; import java.io.PrintWriter; import java.util.Arrays; import java.util.Collection; import java.util.HashSet; import java.util.List; import java.util.Set; import java.util.stream.Collectors; /** * WakeupController is responsible managing Auto Wifi. * *

It determines if and when to re-enable wifi after it has been turned off by the user. */ public class WakeupController { private static final String TAG = "WakeupController"; private static final boolean USE_PLATFORM_WIFI_WAKE = true; private final Context mContext; private final Handler mHandler; private final FrameworkFacade mFrameworkFacade; private final ContentObserver mContentObserver; private final WakeupLock mWakeupLock; private final WakeupEvaluator mWakeupEvaluator; private final WakeupOnboarding mWakeupOnboarding; private final WifiConfigManager mWifiConfigManager; private final WifiInjector mWifiInjector; private final WakeupConfigStoreData mWakeupConfigStoreData; private final WifiWakeMetrics mWifiWakeMetrics; private final WifiScanner.ScanListener mScanListener = new WifiScanner.ScanListener() { @Override public void onPeriodChanged(int periodInMs) { // no-op } @Override public void onResults(WifiScanner.ScanData[] results) { if (results.length == 1 && results[0].isAllChannelsScanned()) { handleScanResults(filterDfsScanResults(Arrays.asList(results[0].getResults()))); } } @Override public void onFullResult(ScanResult fullScanResult) { // no-op } @Override public void onSuccess() { // no-op } @Override public void onFailure(int reason, String description) { Log.e(TAG, "ScanListener onFailure: " + reason + ": " + description); } }; /** Whether this feature is enabled in Settings. */ private boolean mWifiWakeupEnabled; /** Whether the WakeupController is currently active. */ private boolean mIsActive = false; /** The number of scans that have been handled by the controller since last {@link #reset()}. */ private int mNumScansHandled = 0; /** Whether Wifi verbose logging is enabled. */ private boolean mVerboseLoggingEnabled; public WakeupController( Context context, Looper looper, WakeupLock wakeupLock, WakeupEvaluator wakeupEvaluator, WakeupOnboarding wakeupOnboarding, WifiConfigManager wifiConfigManager, WifiConfigStore wifiConfigStore, WifiWakeMetrics wifiWakeMetrics, WifiInjector wifiInjector, FrameworkFacade frameworkFacade) { mContext = context; mHandler = new Handler(looper); mWakeupLock = wakeupLock; mWakeupEvaluator = wakeupEvaluator; mWakeupOnboarding = wakeupOnboarding; mWifiConfigManager = wifiConfigManager; mWifiWakeMetrics = wifiWakeMetrics; mFrameworkFacade = frameworkFacade; mWifiInjector = wifiInjector; mContentObserver = new ContentObserver(mHandler) { @Override public void onChange(boolean selfChange) { readWifiWakeupEnabledFromSettings(); mWakeupOnboarding.setOnboarded(); } }; mFrameworkFacade.registerContentObserver(mContext, Settings.Global.getUriFor( Settings.Global.WIFI_WAKEUP_ENABLED), true, mContentObserver); readWifiWakeupEnabledFromSettings(); // registering the store data here has the effect of reading the persisted value of the // data sources after system boot finishes mWakeupConfigStoreData = new WakeupConfigStoreData( new IsActiveDataSource(), mWakeupOnboarding.getIsOnboadedDataSource(), mWakeupOnboarding.getNotificationsDataSource(), mWakeupLock.getDataSource()); wifiConfigStore.registerStoreData(mWakeupConfigStoreData); } private void readWifiWakeupEnabledFromSettings() { mWifiWakeupEnabled = mFrameworkFacade.getIntegerSetting( mContext, Settings.Global.WIFI_WAKEUP_ENABLED, 0) == 1; Log.d(TAG, "WifiWake " + (mWifiWakeupEnabled ? "enabled" : "disabled")); } private void setActive(boolean isActive) { if (mIsActive != isActive) { Log.d(TAG, "Setting active to " + isActive); mIsActive = isActive; mWifiConfigManager.saveToStore(false /* forceWrite */); } } /** * Starts listening for incoming scans. * *

Should only be called upon entering ScanMode. WakeupController registers its listener with * the WifiScanner. If the WakeupController is already active, then it returns early. Otherwise * it performs its initialization steps and sets {@link #mIsActive} to true. */ public void start() { Log.d(TAG, "start()"); mWifiInjector.getWifiScanner().registerScanListener(mScanListener); // If already active, we don't want to restart the session, so return early. if (mIsActive) { mWifiWakeMetrics.recordIgnoredStart(); return; } setActive(true); // ensure feature is enabled and store data has been read before performing work if (isEnabled()) { mWakeupOnboarding.maybeShowNotification(); List scanResults = filterDfsScanResults(mWifiInjector.getWifiScanner().getSingleScanResults()); Set matchInfos = toMatchInfos(scanResults); matchInfos.retainAll(getGoodSavedNetworks()); if (mVerboseLoggingEnabled) { Log.d(TAG, "Saved networks in most recent scan:" + matchInfos); } mWifiWakeMetrics.recordStartEvent(matchInfos.size()); mWakeupLock.setLock(matchInfos); // TODO(b/77291248): request low latency scan here } } /** * Stops listening for scans. * *

Should only be called upon leaving ScanMode. It deregisters the listener from * WifiScanner. */ public void stop() { Log.d(TAG, "stop()"); mWifiInjector.getWifiScanner().deregisterScanListener(mScanListener); mWakeupOnboarding.onStop(); } /** Resets the WakeupController, setting {@link #mIsActive} to false. */ public void reset() { Log.d(TAG, "reset()"); mWifiWakeMetrics.recordResetEvent(mNumScansHandled); mNumScansHandled = 0; setActive(false); } /** Sets verbose logging flag based on verbose level. */ public void enableVerboseLogging(int verbose) { mVerboseLoggingEnabled = verbose > 0; mWakeupLock.enableVerboseLogging(mVerboseLoggingEnabled); } /** Returns a list of ScanResults with DFS channels removed. */ private List filterDfsScanResults(Collection scanResults) { int[] dfsChannels = mWifiInjector.getWifiNative() .getChannelsForBand(WifiScanner.WIFI_BAND_5_GHZ_DFS_ONLY); if (dfsChannels == null) { dfsChannels = new int[0]; } final Set dfsChannelSet = Arrays.stream(dfsChannels).boxed() .collect(Collectors.toSet()); return scanResults.stream() .filter(scanResult -> !dfsChannelSet.contains(scanResult.frequency)) .collect(Collectors.toList()); } /** Returns a filtered set of saved networks from WifiConfigManager. */ private Set getGoodSavedNetworks() { List savedNetworks = mWifiConfigManager.getSavedNetworks(); Set goodSavedNetworks = new HashSet<>(savedNetworks.size()); for (WifiConfiguration config : savedNetworks) { if (isWideAreaNetwork(config) || config.hasNoInternetAccess() || config.noInternetAccessExpected || !config.getNetworkSelectionStatus().getHasEverConnected()) { continue; } goodSavedNetworks.add(ScanResultMatchInfo.fromWifiConfiguration(config)); } return goodSavedNetworks; } //TODO(b/69271702) implement WAN filtering private static boolean isWideAreaNetwork(WifiConfiguration config) { return false; } /** * Handles incoming scan results. * *

The controller updates the WakeupLock with the incoming scan results. If WakeupLock is not * yet fully initialized, it adds the current scanResults to the lock and returns. If WakeupLock * is initialized but not empty, the controller updates the lock with the current scan. If it is * both initialized and empty, it evaluates scan results for a match with saved networks. If a * match exists, it enables wifi. * *

The feature must be enabled and the store data must be loaded in order for the controller * to handle scan results. * * @param scanResults The scan results with which to update the controller */ private void handleScanResults(Collection scanResults) { if (!isEnabled()) { Log.d(TAG, "Attempted to handleScanResults while not enabled"); return; } // only count scan as handled if isEnabled mNumScansHandled++; if (mVerboseLoggingEnabled) { Log.d(TAG, "Incoming scan #" + mNumScansHandled); } // need to show notification here in case user turns phone on while wifi is off mWakeupOnboarding.maybeShowNotification(); // filter out unsaved networks Set goodSavedNetworks = getGoodSavedNetworks(); Set matchInfos = toMatchInfos(scanResults); matchInfos.retainAll(goodSavedNetworks); mWakeupLock.update(matchInfos); if (!mWakeupLock.isUnlocked()) { return; } ScanResult network = mWakeupEvaluator.findViableNetwork(scanResults, goodSavedNetworks); if (network != null) { Log.d(TAG, "Enabling wifi for network: " + network.SSID); enableWifi(); } } /** * Converts ScanResults to ScanResultMatchInfos. */ private static Set toMatchInfos(Collection scanResults) { return scanResults.stream() .map(ScanResultMatchInfo::fromScanResult) .collect(Collectors.toSet()); } /** * Enables wifi. * *

This method ignores all checks and assumes that {@link WifiStateMachine} is currently * in ScanModeState. */ private void enableWifi() { if (USE_PLATFORM_WIFI_WAKE) { // TODO(b/72180295): ensure that there is no race condition with WifiServiceImpl here if (mWifiInjector.getWifiSettingsStore().handleWifiToggled(true /* wifiEnabled */)) { mWifiInjector.getWifiController().sendMessage(CMD_WIFI_TOGGLED); mWifiWakeMetrics.recordWakeupEvent(mNumScansHandled); } } } /** * Whether the feature is currently enabled. * *

This method checks both the Settings value and the store data to ensure that it has been * read. */ @VisibleForTesting boolean isEnabled() { return mWifiWakeupEnabled && mWakeupConfigStoreData.hasBeenRead(); } /** Dumps wakeup controller state. */ public void dump(FileDescriptor fd, PrintWriter pw, String[] args) { pw.println("Dump of WakeupController"); pw.println("USE_PLATFORM_WIFI_WAKE: " + USE_PLATFORM_WIFI_WAKE); pw.println("mWifiWakeupEnabled: " + mWifiWakeupEnabled); pw.println("isOnboarded: " + mWakeupOnboarding.isOnboarded()); pw.println("configStore hasBeenRead: " + mWakeupConfigStoreData.hasBeenRead()); pw.println("mIsActive: " + mIsActive); pw.println("mNumScansHandled: " + mNumScansHandled); mWakeupLock.dump(fd, pw, args); } private class IsActiveDataSource implements WakeupConfigStoreData.DataSource { @Override public Boolean getData() { return mIsActive; } @Override public void setData(Boolean data) { mIsActive = data; } } }