WifiManager.java revision b625377b1a9b324254fcde9928eade4473712486
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.net.wifi; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.annotation.SdkConstant.SdkConstantType; 21cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tongimport android.annotation.SystemApi; 22ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport android.content.Context; 231022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport android.net.ConnectivityManager; 241022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport android.net.ConnectivityManager.NetworkCallback; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.DhcpInfo; 261022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport android.net.Network; 271022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport android.net.NetworkCapabilities; 281022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport android.net.NetworkRequest; 29738803fee62a98f244250996380820c4923e7f7bYuhao Zhengimport android.net.wifi.ScanSettings; 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport android.os.Build; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 3488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport android.os.HandlerThread; 35d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.os.Looper; 36d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.os.Message; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 387e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackbornimport android.os.WorkSource; 39227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriffimport android.os.Messenger; 4088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport android.util.Log; 41d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.util.SparseArray; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapndeimport java.net.InetAddress; 4488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport java.util.concurrent.CountDownLatch; 4588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 461022dde719ca430f062f9e628574d70ae1320677Lorenzo Colittiimport com.android.internal.annotations.GuardedBy; 47ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport com.android.internal.util.AsyncChannel; 48d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport com.android.internal.util.Protocol; 49ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final String TAG = "WifiManager"; 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8389710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * Broadcast intent action indicating whether Wi-Fi scanning is allowed currently 8489710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * @hide 8589710842585404ea33f941afeb2c321e706005e9Robert Greenwalt */ 8689710842585404ea33f941afeb2c321e706005e9Robert Greenwalt public static final String WIFI_SCAN_AVAILABLE = "wifi_scan_available"; 8789710842585404ea33f941afeb2c321e706005e9Robert Greenwalt 8889710842585404ea33f941afeb2c321e706005e9Robert Greenwalt /** 8989710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * Extra int indicating scan availability, WIFI_STATE_ENABLED and WIFI_STATE_DISABLED 9089710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * @hide 9189710842585404ea33f941afeb2c321e706005e9Robert Greenwalt */ 92cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong public static final String EXTRA_SCAN_AVAILABLE = "scan_enabled"; 93cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong 94cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong /** 95cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong * Broadcast intent action indicating that the credential of a Wi-Fi network 96cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong * has been changed. One extra provides the ssid of the network. Another 97cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong * extra provides the event type, whether the credential is saved or forgot. 98cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong * @hide 99cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong */ 100cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong @SystemApi 101cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong public static final String WIFI_CREDENTIAL_CHANGED_ACTION = 102cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong "android.net.wifi.WIFI_CREDENTIAL_CHANGED"; 103cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong /** @hide */ 104cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong @SystemApi 105cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong public static final String EXTRA_WIFI_CREDENTIAL_EVENT_TYPE = "et"; 106cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong /** @hide */ 107cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong @SystemApi 108cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong public static final String EXTRA_WIFI_CREDENTIAL_SSID = "ssid"; 109cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong /** @hide */ 110cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong @SystemApi 111cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong public static final int WIFI_CREDENTIAL_SAVED = 0; 112cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong /** @hide */ 113cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong @SystemApi 114cdd5858e481fb0087c40c5997a9fa1446b326165Wenchao Tong public static final int WIFI_CREDENTIAL_FORGOT = 1; 11589710842585404ea33f941afeb2c321e706005e9Robert Greenwalt 11689710842585404ea33f941afeb2c321e706005e9Robert Greenwalt /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 120227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 131227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 141227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 145227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 149227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 1549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 156227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 164227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 171227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 179227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_UNKNOWN = 4; 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 191b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 2045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 208b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 2095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 210e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe 211e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe /** 212e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * The look up key for an int that indicates why softAP started failed 213e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * currently support general and no_channel 214e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @see #SAP_START_FAILURE_GENERAL 215e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @see #SAP_START_FAILURE_NO_CHANNEL 216e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * 217e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @hide 218e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe */ 219e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe public static final String EXTRA_WIFI_AP_FAILURE_REASON = "wifi_ap_error_code"; 2205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 2225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 2245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 227b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 2285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 2295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 2315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 2325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 238b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 239a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 2405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 2425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 2455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 248b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 249a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 2505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 2525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 2535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 259b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 260a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 2615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 2635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 269b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 270a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 280b8c7badbb5b0cf2d101ddfabdcf7c95135965eeaJeremy Klein @SystemApi 281a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 284e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * If WIFI AP start failed, this reason code means there is no legal channel exists on 285e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * user selected band by regulatory 286e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * 287e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @hide 288e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe */ 289e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe public static final int SAP_START_FAILURE_GENERAL= 0; 290e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe 291e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe /** 292e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * All other reason for AP start failed besides SAP_START_FAILURE_GENERAL 293e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * 294e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @hide 295e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe */ 296e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe public static final int SAP_START_FAILURE_NO_CHANNEL = 1; 297e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe /** 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 3183550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 3193550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 3203550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 3243550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3423550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 3433550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 3443550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 3453550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 3463550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 3473550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 3483550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 375fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 376fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 377be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 3781b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * This can be as a result of adding/updating/deleting a network. If 3791b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set to true the new configuration 3801b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * can be retreived with the {@link #EXTRA_WIFI_CONFIGURATION} extra. If multiple 3811b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Wi-Fi configurations changed, {@link #EXTRA_WIFI_CONFIGURATION} will not be present. 382e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 383e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 384e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 385be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 386be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3881b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for a (@link android.net.wifi.WifiConfiguration} object representing 3891b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * the changed Wi-Fi configuration when the {@link #CONFIGURED_NETWORKS_CHANGED_ACTION} 3901b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * broadcast is sent. 3911b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3921b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 393e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 3941b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_WIFI_CONFIGURATION = "wifiConfiguration"; 3951b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3961b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Multiple network configurations have changed. 3971b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3981b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * 3991b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4001b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 401e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4021b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_MULTIPLE_NETWORKS_CHANGED = "multipleChanges"; 4031b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4041b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for an integer indicating the reason a Wi-Fi network configuration 4051b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * has changed. Only present if {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is {@code false} 4061b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 4071b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4081b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 409e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4101b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_CHANGE_REASON = "changeReason"; 4111b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4121b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration is new and was added. 4131b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4141b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 415e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4161b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_ADDED = 0; 4171b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4181b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration was removed and is no longer present in the system's list of 4191b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * configured networks. 4201b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4211b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 422e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4231b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_REMOVED = 1; 4241b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4251b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration has changed as a result of explicit action or because the system 4261b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * took an automated action such as disabling a malfunctioning configuration. 4271b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4281b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 429e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4301b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_CONFIG_CHANGE = 2; 4311b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 433a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * Call {@link #getScanResults()} to obtain the results. {@link #EXTRA_RESULTS_UPDATED} 434a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * indicates if the scan was completed successfully. 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 43829ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande 43929ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande /** 440a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * Lookup key for a {@code boolean} representing the result of previous {@link #startScan} 441a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * operation, reported with {@link #SCAN_RESULTS_AVAILABLE_ACTION}. 442a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * @return true scan was successful, results are updated 44329ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande * @return false scan was not successful, results haven't been updated since previous scan 44429ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande */ 44529ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande public static final String EXTRA_RESULTS_UPDATED = "resultsUpdated"; 44629ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4480451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * A batch of access point scans has been completed and the results areavailable. 4490451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Call {@link #getBatchedScanResults()} to obtain the results. 45088d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 45188d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 45288d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @hide 4530451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 45488d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 4550451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4560451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public static final String BATCHED_SCAN_RESULTS_AVAILABLE_ACTION = 4570451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt "android.net.wifi.BATCHED_RESULTS"; 4580451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 470be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 4710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 4720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 4730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 474be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 475be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 476f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 4770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 47837e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 4790d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 4800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 4810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 4820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 48337e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 4840d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 4850d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 486f9cb86aebe9647e0fe0137fc198ba16c017445c6Robert Greenwalt * The lookup key for a {@link android.net.NetworkCapabilities} object associated with the 487f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 488f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 489f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 490f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 491f9cb86aebe9647e0fe0137fc198ba16c017445c6Robert Greenwalt public static final String EXTRA_NETWORK_CAPABILITIES = "networkCapabilities"; 492f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 493f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 49837e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5001ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Activity Action: Show a system activity that allows the user to enable 5011ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * scans to be available even with Wi-Fi turned off. 5021ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 5031ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <p>Notification of the result of this activity is posted using the 5041ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * {@link android.app.Activity#onActivityResult} callback. The 5051ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <code>resultCode</code> 5061ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * will be {@link android.app.Activity#RESULT_OK} if scan always mode has 5071ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * been turned on or {@link android.app.Activity#RESULT_CANCELED} if the user 5081ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * has rejected the request or an error has occurred. 5091ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 5101ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 5111ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff public static final String ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE = 5121ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff "android.net.wifi.action.REQUEST_SCAN_ALWAYS_AVAILABLE"; 5131ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 5141ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 52399001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 53199001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 540652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 541652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 542652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 543652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 544652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 545652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 546652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 547652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 548652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 549652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 550652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 551652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 552652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 553652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 554652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 555652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 556652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 557652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 558652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 562652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 56536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 56636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 567ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 568ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 569ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 570ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 571ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 572ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 573ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 57436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 57536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 57636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 57736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 57836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 57936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 58036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 58136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 58236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 58336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 58436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 58536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 58636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 58736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 58836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 58936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 59036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 59136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 592227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 593227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 594227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 595227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 596227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 597227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 598227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 599227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 600227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 601227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 602227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 603227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 604227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 605227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 606227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 607227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 608ffadfb9ffdced62db215319d3edc7717802088fbVinit Deshapnde /** @hide */ 609ffadfb9ffdced62db215319d3edc7717802088fbVinit Deshapnde public static final boolean DEFAULT_POOR_NETWORK_AVOIDANCE_ENABLED = false; 610ffadfb9ffdced62db215319d3edc7717802088fbVinit Deshapnde 611617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 612617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 613617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 614617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 615617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 616617750604c69e6068f68266d0e30324273aa990eMike Lockwood 617617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 618617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 619617750604c69e6068f68266d0e30324273aa990eMike Lockwood 62088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Context mContext; 62188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff IWifiManager mService; 6221022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private final int mTargetSdkVersion; 62388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 62488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final int INVALID_KEY = 0; 625302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int sListenerKey = 1; 626302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final SparseArray sListenerMap = new SparseArray(); 627302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sListenerMapLock = new Object(); 62888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 629302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static AsyncChannel sAsyncChannel; 630302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static CountDownLatch sConnected; 6311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private static ConnectivityManager sCM; 63288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 633302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sThreadRefLock = new Object(); 634cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static int sThreadRefCount; 635cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static HandlerThread sHandlerThread; 636cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff 6371022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti @GuardedBy("sCM") 6381022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // TODO: Introduce refcounting and make this a per-process static callback, instead of a 6391022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // per-WifiManager callback. 6401022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private PinningNetworkCallback mNetworkCallback; 6411022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 64788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @param context the application context 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 65288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public WifiManager(Context context, IWifiManager service) { 65388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mContext = context; 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 6551022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mTargetSdkVersion = context.getApplicationInfo().targetSdkVersion; 65688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff init(); 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 67559358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * of {@link WifiConfiguration} objects. Upon failure to fetch or 6760d3d1f825f399c62f2ba236b53bef17581e03a16Sungsoo Lim * when Wi-Fi is turned off, it can be null. 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 682f6d3d148d50562823e5f953ddd9c084266ac4c1bJan Nordqvist Log.w(TAG, "Caught RemoteException trying to get configured networks: " + e); 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 687758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong /** @hide */ 688758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong @SystemApi 689758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong public List<WifiConfiguration> getPrivilegedConfiguredNetworks() { 690758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong try { 691758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong return mService.getPrivilegedConfiguredNetworks(); 692758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong } catch (RemoteException e) { 693758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong return null; 694758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong } 695758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong } 696758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong 6974eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle /** @hide */ 6984eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle @SystemApi 6994eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle public WifiConnectionStatistics getConnectionStatistics() { 7004eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle try { 7014eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle return mService.getConnectionStatistics(); 7024eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle } catch (RemoteException e) { 7034eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle return null; 7044eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle } 7054eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle } 7064eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 708b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * Returns a WifiConfiguration matching this ScanResult 709b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * @param scanResult scanResult that represents the BSSID 710b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * @return {@link WifiConfiguration} that matches this BSSID or null 711b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * @hide 712b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande */ 713b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande public WifiConfiguration getMatchingWifiConfig(ScanResult scanResult) { 714b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande try { 715b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande return mService.getMatchingWifiConfig(scanResult); 716b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande } catch (RemoteException e) { 717b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande return null; 718b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande } 719b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande } 720b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande 721b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande /** 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 728227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 768227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 8031022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * <p> 8041022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * <b>Note:</b> If an application's target SDK version is 805976f044b2b3eff2ce968e3ea59022414180c268dLorenzo Colitti * {@link android.os.Build.VERSION_CODES#LOLLIPOP} or newer, network 8061022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * communication may not use Wi-Fi even if Wi-Fi is connected; traffic may 8071022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * instead be sent through another network, such as cellular data, 8081022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * Bluetooth tethering, or Ethernet. For example, traffic will never use a 8091022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * Wi-Fi network that does not provide Internet access (e.g. a wireless 8101022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * printer), if another network that does offer Internet access (e.g. 8111022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * cellular data) is available. Applications that need to ensure that their 8121022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * network traffic uses Wi-Fi should use APIs such as 8131022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * {@link Network#bindSocket(java.net.Socket)}, 8141022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * {@link Network#openConnection(java.net.URL)}, or 8151022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * {@link ConnectivityManager#bindProcessToNetwork} to do so. 8161022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 824976f044b2b3eff2ce968e3ea59022414180c268dLorenzo Colitti final boolean pin = disableOthers && mTargetSdkVersion < Build.VERSION_CODES.LOLLIPOP; 8251022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (pin) { 8261022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti registerPinningNetworkCallback(); 8271022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 8281022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 8291022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti boolean success; 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti success = mService.enableNetwork(netId, disableOthers); 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8331022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti success = false; 8341022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 8351022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 8361022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (pin && !success) { 8371022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti unregisterPinningNetworkCallback(); 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8391022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 8401022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti return success; 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 865e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 866e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 880e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 881e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 895e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 896e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 91773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /* Keep this list in sync with wifi_hal.h */ 91873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 91973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_INFRA = 0x0001; // Basic infrastructure mode 92073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_INFRA_5G = 0x0002; // Support for 5 GHz Band 92273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_PASSPOINT = 0x0004; // Support for GAS/ANQP 92473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_P2P = 0x0008; // Wifi-Direct 92673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_MOBILE_HOTSPOT = 0x0010; // Soft AP 92873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_SCANNER = 0x0020; // WifiScanner APIs 93073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_NAN = 0x0040; // Neighbor Awareness Networking 93273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_D2D_RTT = 0x0080; // Device-to-device RTT 93473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_D2AP_RTT = 0x0100; // Device-to-AP RTT 93673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_BATCH_SCAN = 0x0200; // Batched Scan (deprecated) 93873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_PNO = 0x0400; // Preferred network offload 94073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 94173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_ADDITIONAL_STA = 0x0800; // Support for two STAs 94273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 94373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_TDLS = 0x1000; // Tunnel directed link setup 94473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 94573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_TDLS_OFFCHANNEL = 0x2000; // Support for TDLS off channel 94673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 94773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_EPR = 0x4000; // Enhanced power reporting 948ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 949ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_AP_STA = 0x8000; // Support for AP STA Concurrency 950ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 951ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_LINK_LAYER_STATS = 0x10000; // Link layer stats collection 952ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 953ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_LOGGER = 0x20000; // WiFi Logger 954ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 955ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_HAL_EPNO = 0x40000; // WiFi PNO enhanced 95673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 95773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande private int getSupportedFeatures() { 95873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande try { 95973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return mService.getSupportedFeatures(); 96073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } catch (RemoteException e) { 96173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return 0; 96273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 96373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 96473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 96573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande private boolean isFeatureSupported(int feature) { 96673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return (getSupportedFeatures() & feature) == feature; 96773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 96873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 96973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports 5 GHz band 97073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 97173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean is5GHzBandSupported() { 97273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_INFRA_5G); 97373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 97473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 97573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 97673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports passpoint 97773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 97873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 97973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isPasspointSupported() { 98073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_PASSPOINT); 98173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 98273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 98373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 98473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports WifiP2pManager (Wi-Fi Direct) 98573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 98673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isP2pSupported() { 98773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_P2P); 98873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 98973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 99073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 99173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports portable Wi-Fi hotspot 99273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 99373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 99473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 99573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isPortableHotspotSupported() { 99673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_MOBILE_HOTSPOT); 99773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 99873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 99973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 100073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports WifiScanner APIs 100173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 100273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 100373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 100473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isWifiScannerSupported() { 100573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_SCANNER); 100673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 100773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 100873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 100973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Neighbour Awareness Network APIs 101073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 101173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 101273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isNanSupported() { 101373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_NAN); 101473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 101573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 101673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 101773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Device-to-device RTT 101873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 101973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 102073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 102173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isDeviceToDeviceRttSupported() { 102273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_D2D_RTT); 102373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 102473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 102573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 102673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Device-to-AP RTT 102773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 102873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 102973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isDeviceToApRttSupported() { 103073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_D2AP_RTT); 103173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 103273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 103373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 103473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports offloaded connectivity scan 103573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 103673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isPreferredNetworkOffloadSupported() { 103773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_PNO); 103873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 103973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 104073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 104173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports multiple simultaneous connections 104273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 104373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 104473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isAdditionalStaSupported() { 104573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_ADDITIONAL_STA); 104673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 104773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 104873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 104973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Tunnel Directed Link Setup 105073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 105173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isTdlsSupported() { 105273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_TDLS); 105373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 105473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 105573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 105673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Off Channel Tunnel Directed Link Setup 105773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 105873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 105973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isOffChannelTdlsSupported() { 106073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_TDLS_OFFCHANNEL); 106173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 106273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 106373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 106473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports advanced power/performance counters 106573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 106673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isEnhancedPowerReportingSupported() { 1067ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle return isFeatureSupported(WIFI_FEATURE_LINK_LAYER_STATS); 106873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 106973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 107073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 107173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * Return the record of {@link WifiActivityEnergyInfo} object that 107273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * has the activity and energy info. This can be used to ascertain what 107373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * the controller has been up to, since the last sample. 107473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @param updateType Type of info, cached vs refreshed. 107573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * 107673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return a record with {@link WifiActivityEnergyInfo} or null if 107773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * report is unavailable or unsupported 107873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 107973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 108073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public WifiActivityEnergyInfo getControllerActivityEnergyInfo(int updateType) { 108173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (mService == null) return null; 108273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande try { 108373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande synchronized(this) { 10849a568e6f2f69cc923bbfc1ffb07c2f194acdb981Mitchell Wills return mService.reportActivityInfo(); 108573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 108673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } catch (RemoteException e) { 108773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande Log.e(TAG, "getControllerActivityEnergyInfo: " + e); 108873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 108973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return null; 109073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 109173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 1092738803fee62a98f244250996380820c4923e7f7bYuhao Zheng /** 10939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1098a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 10999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1100738803fee62a98f244250996380820c4923e7f7bYuhao Zheng mService.startScan(null, null); 11016942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie return true; 11026942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } catch (RemoteException e) { 11036942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie return false; 11046942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } 11056942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } 11066942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie 11076942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie /** @hide */ 1108c20b795cf05b48fe5e024c19dab9c7e4b18cd10fDavid Christie @SystemApi 11096942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie public boolean startScan(WorkSource workSource) { 11106942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie try { 1111738803fee62a98f244250996380820c4923e7f7bYuhao Zheng mService.startScan(null, workSource); 1112738803fee62a98f244250996380820c4923e7f7bYuhao Zheng return true; 1113738803fee62a98f244250996380820c4923e7f7bYuhao Zheng } catch (RemoteException e) { 1114738803fee62a98f244250996380820c4923e7f7bYuhao Zheng return false; 1115738803fee62a98f244250996380820c4923e7f7bYuhao Zheng } 1116738803fee62a98f244250996380820c4923e7f7bYuhao Zheng } 1117738803fee62a98f244250996380820c4923e7f7bYuhao Zheng 1118738803fee62a98f244250996380820c4923e7f7bYuhao Zheng /** 1119da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * startLocationRestrictedScan() 1120da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * Trigger a scan which will not make use of DFS channels and is thus not suitable for 1121da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * establishing wifi connection. 112288d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 112388d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 1124da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * @hide 1125da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle */ 112688d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 1127da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle @SystemApi 1128da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle public boolean startLocationRestrictedScan(WorkSource workSource) { 112988d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills return false; 11300451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 11310451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 11320451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 11330451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Check if the Batched Scan feature is supported. 11340451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * 11350451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @return false if not supported. 113688d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 113788d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 11380451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 11390451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 114088d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 1141c20b795cf05b48fe5e024c19dab9c7e4b18cd10fDavid Christie @SystemApi 11420451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public boolean isBatchedScanSupported() { 114388d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills return false; 11440451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 11450451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 11460451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 11470451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Retrieve the latest batched scan result. This should be called immediately after 11480451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * {@link BATCHED_SCAN_RESULTS_AVAILABLE_ACTION} is received. 114988d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 115088d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 11510451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 11520451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 115388d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 1154c20b795cf05b48fe5e024c19dab9c7e4b18cd10fDavid Christie @SystemApi 11550451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public List<BatchedScanResult> getBatchedScanResults() { 115688d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills return null; 11578e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt } 11588e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt 11598e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt /** 1160b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * Creates a configuration token describing the network referenced by {@code netId} 1161b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * of MIME type application/vnd.wfa.wsc. Can be used to configure WiFi networks via NFC. 1162b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * 1163b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * @return hex-string encoded configuration token 1164b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * @hide 1165b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales */ 1166b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales public String getWpsNfcConfigurationToken(int netId) { 1167b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales try { 1168b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales return mService.getWpsNfcConfigurationToken(netId); 1169b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales } catch (RemoteException e) { 1170b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales return null; 1171b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales } 1172b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales } 1173b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales 1174b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales /** 11759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the results of the latest access point scan. 1188cb13aebfec313a3433ed0f53cc2e3b6dbaf888d0Fyodor Kupolov * @return the list of access points found in the most recent scan. An app must hold 1189cb13aebfec313a3433ed0f53cc2e3b6dbaf888d0Fyodor Kupolov * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION} or 1190959991b957fb58672aef17c46a7662941f138e19Fyodor Kupolov * {@link android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION} permission 1191cb13aebfec313a3433ed0f53cc2e3b6dbaf888d0Fyodor Kupolov * in order to get valid results. 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 119595d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn return mService.getScanResults(mContext.getOpPackageName()); 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 120252eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * An augmented version of getScanResults that returns ScanResults as well as OSU information 120352eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * wrapped in ScanInfo objects. 120452eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * @return 120552eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist */ 120652eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist public List<ScanInfo> getScanInfos() { 120752eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist try { 120852eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist return mService.getScanInfos(mContext.getOpPackageName()); 120952eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } catch (RemoteException e) { 121052eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist return null; 121152eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 121252eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 121352eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist 121452eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist /** 121552eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * Notify the OSU framework about the currently selected OSU. 121652eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * @param osuID The OSU ID from ScanInfo.getOsuIdentity() 121752eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist */ 121852eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist public void setOsuSelection(int osuID) { 121952eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist try { 122052eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist mService.setOsuSelection(osuID); 122152eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } catch (RemoteException e) { 122252eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 122352eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 122452eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist 122552eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist /** 12261ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Check if scanning is always available. 12271ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 12281ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * If this return {@code true}, apps can issue {@link #startScan} and fetch scan results 12291ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * even when Wi-Fi is turned off. 12301ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 12311ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * To change this setting, see {@link #ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE}. 12321ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 12337ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff public boolean isScanAlwaysAvailable() { 12341ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff try { 12357ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff return mService.isScanAlwaysAvailable(); 12361ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } catch (RemoteException e) { 12371ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff return false; 12381ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 12391ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 12401ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 12411ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 1247227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1259ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 1260ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 1261ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 12629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1263ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1265ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1267ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 1268ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1272b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * get the country code. 1273b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * @return the country code in ISO 3166 format. 1274b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * 1275b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * @hide 1276b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe */ 1277b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe public String getCountryCode() { 1278b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe try { 1279b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe String country = mService.getCountryCode(); 1280b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe return(country); 1281b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe } catch (RemoteException e) { 1282b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe return null; 1283b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe } 1284b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe } 1285b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe 1286b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe /** 128736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 128836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 128936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 129036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 129136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 129236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 129336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 129436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 129536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 129636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 129736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 129836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 129936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 130036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 130136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 130236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 130336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 130436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 130536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 130636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 130736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 130836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 130936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 131036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 131136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 131236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 131336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 131436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 131536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 131636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 131736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 131836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 131936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 132036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 132136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 132236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 132336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 132436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 132536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 132636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 132736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 132836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 132936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 133036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 133136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1372227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1374227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1381227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1383f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * Return TX packet counter, for CTS test of WiFi watchdog. 1384f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param listener is the interface to receive result 1385f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * 1386f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @hide for CTS test only 1387f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1388f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void getTxPacketCount(TxPacketCountListener listener) { 1389f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng validateChannel(); 1390302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(RSSI_PKTCNT_FETCH, 0, putListener(listener)); 1391f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1392f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1393f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 13949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 1396227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14094c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 14104c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 14114c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1414227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 1417227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 14305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 14315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 14325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 14335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 14345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 14355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 14365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 14375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1438b625377b1a9b324254fcde9928eade4473712486Jeremy Klein * @hide 14395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1440b625377b1a9b324254fcde9928eade4473712486Jeremy Klein @SystemApi 14415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 14425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 1443ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff mService.setWifiApEnabled(wifiConfig, enabled); 1444ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff return true; 14455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 14465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 14475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 14505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 14515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 14525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 14535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 14545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 14555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 14565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1457b625377b1a9b324254fcde9928eade4473712486Jeremy Klein * @hide 14585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1459b625377b1a9b324254fcde9928eade4473712486Jeremy Klein @SystemApi 14605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 14615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 14625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 14635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 14645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 14655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 14685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 14695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 14705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 14715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 14725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1473b625377b1a9b324254fcde9928eade4473712486Jeremy Klein * @hide 14745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1475b625377b1a9b324254fcde9928eade4473712486Jeremy Klein @SystemApi 14765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 14775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 14785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 14805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 14819ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 14829ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 14839ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 1484b625377b1a9b324254fcde9928eade4473712486Jeremy Klein * @hide 14859ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 1486b625377b1a9b324254fcde9928eade4473712486Jeremy Klein @SystemApi 14879ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 14889ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 14899ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 14909ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 14919ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 14929ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 14939ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 14949ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 14959ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 1496e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * Builds a WifiConfiguration from Hotspot 2.0 MIME file. 1497e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * @return AP details in WifiConfiguration 1498e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * 1499e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * @hide Dont open yet 1500e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist */ 1501e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist public WifiConfiguration buildWifiConfig(String uriString, String mimeType, byte[] data) { 1502e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist try { 1503e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist return mService.buildWifiConfig(uriString, mimeType, data); 1504e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist } catch (RemoteException e) { 1505f6d3d148d50562823e5f953ddd9c084266ac4c1bJan Nordqvist Log.w(TAG, "Caught RemoteException trying to build wifi config: " + e); 15069ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 15079ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 15089ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 15099ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 15109ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 151117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 151217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 151317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 1514b625377b1a9b324254fcde9928eade4473712486Jeremy Klein * @hide 151517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 1516b625377b1a9b324254fcde9928eade4473712486Jeremy Klein @SystemApi 151717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 151817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 151917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 152017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 152117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 152217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 152317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 152417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 152517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 15260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 15270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 15280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 15300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 15320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 15330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 15340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 15350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 15360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 15370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 15380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 15390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 15400d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15420d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 15430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 15440d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 15450d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15460d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 15470d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15480d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 15490d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 15500d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 15510d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 15520d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 15530d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 15540d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 15550d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 15560d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 15570d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15580d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15590d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 156064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 156164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 1562b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * Enable/Disable TDLS on a specific local route. 156364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 1564b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * <p> 1565b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * TDLS enables two wireless endpoints to talk to each other directly 1566b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * without going through the access point that is managing the local 1567b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * network. It saves bandwidth and improves quality of the link. 1568b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * </p> 1569b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * <p> 1570b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * This API enables/disables the option of using TDLS. If enabled, the 1571b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * underlying hardware is free to use TDLS or a hop through the access 1572b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * point. If disabled, existing TDLS session is torn down and 1573b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * hardware is restricted to use access point for transferring wireless 1574b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * packets. Default value for all routes is 'disabled', meaning restricted 1575b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * to use access point for transferring packets. 1576b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * </p> 157764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 157864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteIPAddress IP address of the endpoint to setup TDLS with 157964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 158064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 1581b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde public void setTdlsEnabled(InetAddress remoteIPAddress, boolean enable) { 158264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 158364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdls(remoteIPAddress.getHostAddress(), enable); 158464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 158564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 158664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 158764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 158864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 158964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 1590b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * Similar to {@link #setTdlsEnabled(InetAddress, boolean) }, except 1591b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * this version allows you to specify remote endpoint with a MAC address. 159264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteMacAddress MAC address of the remote endpoint such as 00:00:0c:9f:f2:ab 159364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 159464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 1595b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde public void setTdlsEnabledWithMacAddress(String remoteMacAddress, boolean enable) { 159664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 159764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdlsWithMacAddress(remoteMacAddress, enable); 159864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 159964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 160064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 160164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 160264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 1603e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1604ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1605d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private static final int BASE = Protocol.BASE_WIFI_MANAGER; 1606d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1607ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1608ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1609d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK = BASE + 1; 1610d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1611d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_FAILED = BASE + 2; 1612d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1613d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_SUCCEEDED = BASE + 3; 1614d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1615d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1616d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK = BASE + 4; 1617d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1618d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_FAILED = BASE + 5; 1619ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1620d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_SUCCEEDED = BASE + 6; 1621d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1622ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1623d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK = BASE + 7; 1624ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1625d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_FAILED = BASE + 8; 16268dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 1627d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_SUCCEEDED = BASE + 9; 1628ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1629ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1630d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS = BASE + 10; 1631d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1632d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS_SUCCEEDED = BASE + 11; 1633d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1634d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_FAILED = BASE + 12; 163586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 1636d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_COMPLETED = BASE + 13; 1637d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1638d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 163986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS = BASE + 14; 164086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 164186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_FAILED = BASE + 15; 164286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 164386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_SUCCEDED = BASE + 16; 164486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 164586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 164686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK = BASE + 17; 1647d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 164886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_FAILED = BASE + 18; 1649d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 165086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_SUCCEEDED = BASE + 19; 1651ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1652f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1653f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH = BASE + 20; 1654f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1655f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_SUCCEEDED = BASE + 21; 1656f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1657f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_FAILED = BASE + 22; 1658f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1659d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1660d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1661d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed due to an internal error. 166273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 1663d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 166486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int ERROR = 0; 1665d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1666d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1667d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1668d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation is already in progress 166973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 1670d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 167186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int IN_PROGRESS = 1; 1672d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1673d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1674d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1675d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed because the framework is busy and 1676d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * unable to service the request 167773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 1678d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 167986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int BUSY = 2; 1680d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1681d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* WPS specific errors */ 1682674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** WPS overlap detected */ 168386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_OVERLAP_ERROR = 3; 1684674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** WEP on WPS is prohibited */ 168586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_WEP_PROHIBITED = 4; 1686674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** TKIP only prohibited */ 168786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TKIP_ONLY_PROHIBITED = 5; 1688674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** Authentication failure on WPS */ 168986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_AUTH_FAILURE = 6; 1690674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** WPS timed out */ 169186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TIMED_OUT = 7; 1692d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 169310652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde /** 169410652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * Passed with {@link ActionListener#onFailure}. 169510652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * Indicates that the operation failed due to invalid inputs 169673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 169710652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde */ 169810652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde public static final int INVALID_ARGS = 8; 169910652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde 1700ae81483a15bb3811cfc221970ea290599b43d4deSky Faber /** 1701ae81483a15bb3811cfc221970ea290599b43d4deSky Faber * Passed with {@link ActionListener#onFailure}. 1702ae81483a15bb3811cfc221970ea290599b43d4deSky Faber * Indicates that the operation failed due to user permissions. 1703ae81483a15bb3811cfc221970ea290599b43d4deSky Faber * @hide 1704ae81483a15bb3811cfc221970ea290599b43d4deSky Faber */ 1705ae81483a15bb3811cfc221970ea290599b43d4deSky Faber public static final int NOT_AUTHORIZED = 9; 1706ae81483a15bb3811cfc221970ea290599b43d4deSky Faber 170773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 170873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * Interface for callback invocation on an application action 170973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 171073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 1711d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ActionListener { 1712d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** The operation succeeded */ 1713d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onSuccess(); 1714d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1715d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The operation failed 1716d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1717d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1718d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1719d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1720d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1721d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1722674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** Interface for callback invocation on a start WPS action */ 172373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static abstract class WpsCallback { 1724d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS start succeeded */ 172573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public abstract void onStarted(String pin); 1726d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1727d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS operation completed succesfully */ 172873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public abstract void onSucceeded(); 1729d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1730d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1731d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * WPS operation failed 1732d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 173373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * {@link #WPS_TKIP_ONLY_PROHIBITED}, {@link #WPS_OVERLAP_ERROR}, 173473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * {@link #WPS_WEP_PROHIBITED}, {@link #WPS_TIMED_OUT} or {@link #WPS_AUTH_FAILURE} 173573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * and some generic errors. 1736d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 173773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public abstract void onFailed(int reason); 1738d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1739d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1740f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** Interface for callback invocation on a TX packet count poll action {@hide} */ 1741f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public interface TxPacketCountListener { 1742f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1743f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation succeeded 1744f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param count TX packet counter 1745f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1746f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onSuccess(int count); 1747f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1748f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation failed 1749f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param reason The reason for failure could be one of 1750f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1751f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1752f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onFailure(int reason); 1753f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1754f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1755302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static class ServiceHandler extends Handler { 175688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ServiceHandler(Looper looper) { 175788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff super(looper); 1758d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1759d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 176088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff @Override 176188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void handleMessage(Message message) { 176288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Object listener = removeListener(message.arg2); 176388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff switch (message.what) { 176488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_HALF_CONNECTED: 176588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (message.arg1 == AsyncChannel.STATUS_SUCCESSFUL) { 1766302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(AsyncChannel.CMD_CHANNEL_FULL_CONNECTION); 176788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } else { 176888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Failed to set up channel connection"); 176988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 177088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1771302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 177288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1773302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.countDown(); 177488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 177588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_FULLY_CONNECTED: 177688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // Ignore 177788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 177888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_DISCONNECTED: 177988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Channel connection lost"); 178088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 178188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1782302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1783fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff getLooper().quit(); 178488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 178588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 178688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_FAILED: 178788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_FAILED: 178888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_FAILED: 178988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_FAILED: 179088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 179188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onFailure(message.arg1); 179288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 179388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 179488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 179588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_SUCCEEDED: 179688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_SUCCEEDED: 179788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_SUCCEEDED: 179888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_SUCCEEDED: 179988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 180088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onSuccess(); 180188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 180288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 180388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.START_WPS_SUCCEEDED: 180488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 180588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff WpsResult result = (WpsResult) message.obj; 180673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onStarted(result.pin); 180788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //Listener needs to stay until completion or failure 1808302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized(sListenerMapLock) { 1809302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(message.arg2, listener); 1810d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 181188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 181288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 181388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_COMPLETED: 181488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 181573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onSucceeded(); 181688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 181788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 181888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_FAILED: 181988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 182073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onFailed(message.arg1); 182173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 182273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande break; 182373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande case WifiManager.CANCEL_WPS_SUCCEDED: 182473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (listener != null) { 182573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onSucceeded(); 182673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 182773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande break; 182873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande case WifiManager.CANCEL_WPS_FAILED: 182973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (listener != null) { 183073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onFailed(message.arg1); 183188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1832f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1833f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_SUCCEEDED: 1834f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1835f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng RssiPacketCountInfo info = (RssiPacketCountInfo) message.obj; 1836f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (info != null) 1837f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onSuccess(info.txgood + info.txbad); 1838f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng else 1839f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(ERROR); 1840f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1841f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1842f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_FAILED: 1843f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1844f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(message.arg1); 1845f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 184688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 184788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff default: 184888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //ignore 184988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 1850d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1851d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 185288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1853d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1854302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int putListener(Object listener) { 185588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener == null) return INVALID_KEY; 185688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff int key; 1857302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 185888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff do { 1859302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff key = sListenerKey++; 186088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } while (key == INVALID_KEY); 1861302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(key, listener); 1862d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 186388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return key; 186488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1865d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1866302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static Object removeListener(int key) { 186788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (key == INVALID_KEY) return null; 1868302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 1869302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Object listener = sListenerMap.get(key); 1870302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.remove(key); 187188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return listener; 1872d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1873d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1874ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 187588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void init() { 1876cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 1877cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff if (++sThreadRefCount == 1) { 1878302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Messenger messenger = getWifiServiceMessenger(); 1879302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (messenger == null) { 1880302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1881302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff return; 1882302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1883302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1884cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread = new HandlerThread("WifiManager"); 1885302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = new AsyncChannel(); 1886302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected = new CountDownLatch(1); 1887302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1888cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread.start(); 1889302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Handler handler = new ServiceHandler(sHandlerThread.getLooper()); 1890302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.connect(mContext, handler, messenger); 1891302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff try { 1892302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.await(); 1893302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } catch (InterruptedException e) { 1894302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Log.e(TAG, "interrupted wait at init"); 1895302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1896cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1897cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1898d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1899ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 190088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void validateChannel() { 1901302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (sAsyncChannel == null) throw new IllegalStateException( 190235bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff "No permission to access and change wifi or a bad initialization"); 190388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 190488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 19051022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private void initConnectivityManager() { 19061022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // TODO: what happens if an app calls a WifiManager API before ConnectivityManager is 19071022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // registered? Can we fix this by starting ConnectivityService before WifiService? 19081022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (sCM == null) { 19091022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti sCM = (ConnectivityManager) mContext.getSystemService(Context.CONNECTIVITY_SERVICE); 19101022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (sCM == null) { 19111022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti throw new IllegalStateException("Bad luck, ConnectivityService not started."); 19121022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19131022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19141022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19151022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19161022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti /** 19171022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * A NetworkCallback that pins the process to the first wifi network to connect. 19181022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19191022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * We use this to maintain compatibility with pre-M apps that call WifiManager.enableNetwork() 19201022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * to connect to a Wi-Fi network that has no Internet access, and then assume that they will be 19211022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * able to use that network because it's the system default. 19221022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19231022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * In order to maintain compatibility with apps that call setProcessDefaultNetwork themselves, 19241022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * we try not to set the default network unless they have already done so, and we try not to 19251022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * clear the default network unless we set it ourselves. 19261022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19271022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * This should maintain behaviour that's compatible with L, which would pin the whole system to 19281022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * any wifi network that was created via enableNetwork(..., true) until that network 19291022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * disconnected. 19301022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * Note that while this hack allows network traffic to flow, it is quite limited. For example: 19321022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19331022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 1. setProcessDefaultNetwork only affects this process, so: 19341022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - Any subprocesses spawned by this process will not be pinned to Wi-Fi. 19351022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - If this app relies on any other apps on the device also being on Wi-Fi, that won't work 19361022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * either, because other apps on the device will not be pinned. 19371022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 2. The behaviour of other APIs is not modified. For example: 19381022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - getActiveNetworkInfo will return the system default network, not Wi-Fi. 19391022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - There will be no CONNECTIVITY_ACTION broadcasts about TYPE_WIFI. 19401022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - getProcessDefaultNetwork will not return null, so if any apps are relying on that, they 19411022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * will be surprised as well. 19421022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti */ 19431022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private class PinningNetworkCallback extends NetworkCallback { 19441022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private Network mPinnedNetwork; 19451022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19461022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti @Override 19471022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti public void onPreCheck(Network network) { 19481022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (sCM.getProcessDefaultNetwork() == null && mPinnedNetwork == null) { 19491022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti sCM.setProcessDefaultNetwork(network); 19501022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mPinnedNetwork = network; 19511022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti Log.d(TAG, "Wifi alternate reality enabled on network " + network); 19521022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19531022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19541022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19551022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti @Override 19561022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti public void onLost(Network network) { 19571022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (network.equals(mPinnedNetwork) && network.equals(sCM.getProcessDefaultNetwork())) { 19581022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti sCM.setProcessDefaultNetwork(null); 19591022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti Log.d(TAG, "Wifi alternate reality disabled on network " + network); 19601022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mPinnedNetwork = null; 19611022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti unregisterPinningNetworkCallback(); 19621022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19631022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19641022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19651022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19661022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private void registerPinningNetworkCallback() { 19671022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti initConnectivityManager(); 19681022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti synchronized (sCM) { 19691022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (mNetworkCallback == null) { 19701022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // TODO: clear all capabilities. 19711022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti NetworkRequest request = new NetworkRequest.Builder() 19721022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti .addTransportType(NetworkCapabilities.TRANSPORT_WIFI) 19731022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti .removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) 19741022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti .build(); 19751022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mNetworkCallback = new PinningNetworkCallback(); 1976fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti try { 1977fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti sCM.registerNetworkCallback(request, mNetworkCallback); 1978fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } catch (SecurityException e) { 1979fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti Log.d(TAG, "Failed to register network callback", e); 1980fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } 19811022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19821022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19831022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19841022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19851022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private void unregisterPinningNetworkCallback() { 19861022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti initConnectivityManager(); 19871022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti synchronized (sCM) { 19881022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (mNetworkCallback != null) { 1989fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti try { 1990fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti sCM.unregisterNetworkCallback(mNetworkCallback); 1991fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } catch (SecurityException e) { 1992fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti Log.d(TAG, "Failed to unregister network callback", e); 1993fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } 19941022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mNetworkCallback = null; 19951022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19961022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19971022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19981022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 1999e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2000e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 2001e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 2002e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2003e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 2004e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 2005e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 2006e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2007e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 2008e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 2009d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 201088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 201188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 201288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * 2013e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2014e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 201588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(WifiConfiguration config, ActionListener listener) { 2016d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 201788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2018ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // Use INVALID_NETWORK_ID for arg1 when passing a config object 2019ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // arg1 is used to pass network id when the network already exists 2020302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, WifiConfiguration.INVALID_NETWORK_ID, 202188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff putListener(listener), config); 2022e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2023e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 2024e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2025e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 2026e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2027e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 2028e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 2029e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2030e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 2031e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 2032d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 203388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 203488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2035e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2036e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 203788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(int networkId, ActionListener listener) { 2038d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (networkId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 203988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2040302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, networkId, putListener(listener)); 2041e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2042e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 2043e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2044e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 2045e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 2046e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 2047e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2048e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 2049e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 2050e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2051e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 2052e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 2053e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2054e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 2055e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 2056d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 205788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 205888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2059e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2060e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 206188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void save(WifiConfiguration config, ActionListener listener) { 2062d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 206388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2064302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(SAVE_NETWORK, 0, putListener(listener), config); 2065e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2066e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 2067e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2068e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 2069e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2070e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 2071e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 2072e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2073e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 2074e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 2075d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 207688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 207788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2078e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2079e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 208088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void forget(int netId, ActionListener listener) { 2081d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 208288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2083302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(FORGET_NETWORK, netId, putListener(listener)); 2084d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 2085d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 2086d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 2087d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Disable network 2088d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 2089d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param netId is the network Id 2090d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 209188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 209288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2093d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 2094d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 209588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void disable(int netId, ActionListener listener) { 2096d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 209788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2098302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(DISABLE_NETWORK, netId, putListener(listener)); 2099e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2100e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 210117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 210293e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * Disable ephemeral Network 210393e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * 210493e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * @param SSID, in the format of WifiConfiguration's SSID. 210593e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * @hide 210693e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle */ 210793e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle public void disableEphemeralNetwork(String SSID) { 210893e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle if (SSID == null) throw new IllegalArgumentException("SSID cannot be null"); 210993e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle try { 211093e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle mService.disableEphemeralNetwork(SSID); 211193e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle } catch (RemoteException e) { 211293e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle } 211393e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle } 211493e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle 211593e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle /** 211602fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 21175ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 2118c3eb1556446c932b5674adc40af8ff9bfc3a1880Vinit Deshpande * @param config WPS configuration (does not support {@link WpsInfo#LABEL}) 2119d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 212088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 212188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 21225ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 212373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public void startWps(WpsInfo config, WpsCallback listener) { 2124d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 212588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2126302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(START_WPS, 0, putListener(listener), config); 2127f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 2128f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 2129f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 213086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * Cancel any ongoing Wi-fi Protected Setup 213186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * 213286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @param listener for callbacks on success or failure. Can be null. 213388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 213488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 213586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff */ 213673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public void cancelWps(WpsCallback listener) { 213788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2138302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CANCEL_WPS, 0, putListener(listener)); 213986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff } 214086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 214186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** 2142227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 2143227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 2144227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 2145227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 2146227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 2147227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 214807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiServiceMessenger() { 2149227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 215007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiServiceMessenger(); 2151227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 2152227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 215335bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff } catch (SecurityException e) { 215435bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff return null; 2155227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 2156227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 2157227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 215807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 215907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff /** 21604aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 21614aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 21624aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 21634aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 21644aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 21654aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 21664aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 21674aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 21684aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 21694aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 21704aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 21714aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 21729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 21739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 2174227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 21759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 21769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 2177d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 21789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 21799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 21809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 21819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 21829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 2183d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 21849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 21859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 21869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 2187d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 2188d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 218971fbb81b14958b80fe55738607740c6630e4e9daNeil Fuller * permission in an {@code <uses-permission>} element of the application's manifest. 21909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 21929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 21939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 21949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 21959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 21969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 21979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 21987e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 21999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 22019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 22029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 22039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 22049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 22059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 22069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 22079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 22119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 2213227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 22149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 22159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 22179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 22189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 22199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 22219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 22222c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 22239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 22247e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 2225617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2226617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 2227617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 2228617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 2229617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 2230617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2231617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 2232617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 22339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 22349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 22369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 22429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 22449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 22459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 22469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 22479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 22499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 22509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 22519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 22539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 22549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 22559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 22569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 2257617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2258617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2259617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 22609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 22619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 22639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 22659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 22669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 22729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 22749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 22759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 22769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 22779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 22789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 22809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 22829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 22839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 22879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 22899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 22919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 22929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 22939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22967e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 22977e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 22987e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 22997e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 23007e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23017e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 23027e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 23037e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 23047e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 2305a31510e47a0f0c2525702c2f10a85064322a28f2David Christie ws.clearNames(); 2306a31510e47a0f0c2525702c2f10a85064322a28f2David Christie if (mWorkSource == null) { 2307a31510e47a0f0c2525702c2f10a85064322a28f2David Christie changed = mWorkSource != null; 2308a31510e47a0f0c2525702c2f10a85064322a28f2David Christie mWorkSource = new WorkSource(ws); 2309a31510e47a0f0c2525702c2f10a85064322a28f2David Christie } else { 2310a31510e47a0f0c2525702c2f10a85064322a28f2David Christie changed = mWorkSource.diff(ws); 2311a31510e47a0f0c2525702c2f10a85064322a28f2David Christie if (changed) { 2312a31510e47a0f0c2525702c2f10a85064322a28f2David Christie mWorkSource.set(ws); 2313a31510e47a0f0c2525702c2f10a85064322a28f2David Christie } 23147e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23157e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23167e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 23177e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 23187e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 23197e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 23207e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23217e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23227e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23237e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23247e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 23259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 23269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 23279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 23289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 23299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 23309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 23319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 23329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 23339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 23349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 23369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 23399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 23409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 23419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 23429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 23439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 23449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 23459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 2346617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2347617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2348617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 23499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 23509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 23569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 23589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23595876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 2360652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 2361652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 2362652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 2363652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 23649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 23659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 23669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 23689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 23709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 23729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 23739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2374652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 23759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 23779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 23799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 23809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 23819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 23829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 23849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 23869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 23889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 23899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23905347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 2391fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 23925347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2393fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 23945347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2395fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 239641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 239741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 239841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 239941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 24005347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2401fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 2402fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2403fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 24045347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2405fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 2406fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 24075347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 24085347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 24095347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2410fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 2411fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 2412fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 2413fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 2414fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 241541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 24165347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2417fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 2418fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 2419fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 242041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 242141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 2422fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 2423fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2424fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 2425fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 2426fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 242741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 242841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 2429fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 2430fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2431fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2432fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 2433fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 2434fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 243541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 243641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 243741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 243841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 243941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 244041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 244141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 244241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 244341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 244441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 2445fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2446fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 2447fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 2448fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2449fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 2450fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 2451fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2452fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 2453fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 24542c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 2455fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 2456fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 2457617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2458617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 2459617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 2460617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 2461617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 2462617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2463617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 2464617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2465fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 2466fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 246741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 2468fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2469fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2470fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2471fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2472fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 2473fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 2474fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 2475fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 247641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 247741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 247841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 247941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 248041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 248141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 248241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 248341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 248441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 24854a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 248641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 248741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 2488fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 2489fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 2490fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 2491fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 2492fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2493fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 2494fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 2495fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2496fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 2497fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 249841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 2499fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 2500fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 2501617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2502617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2503617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2504fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 2505fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 250641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 250741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 250841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 250941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 251041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 2511fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2512fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2513fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2514fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2515fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 251641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 251741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 251841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 251941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 252041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 252141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 252241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 252341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 252441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 252541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 252641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 252741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 252841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 252941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 253041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 253141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 253241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 253341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 253441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 2535fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 2536fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2537fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 2538fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2539fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 2540fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 2541fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 2542fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2543fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2544fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2545fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 254641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 2547fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 2548fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 2549fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 255041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 255141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 255241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 255341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 255441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 255541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 2556fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2557fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2558fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2559fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 2560fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 2561fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 256241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 2563fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 25645347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 25655347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 25665347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 25675347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2568fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 25695347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2570fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 25715347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 25725347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 25735347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2574fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 25755347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 2576fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 25775347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 25785347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 25795347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 25805347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 2581e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 2582e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 2583e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 2584e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 2585e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 2586e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 2587e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 2588e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 2589e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 2590e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 2591e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 2592e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2593e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2594da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff 2595fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff protected void finalize() throws Throwable { 2596fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff try { 2597cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 2598302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (--sThreadRefCount == 0 && sAsyncChannel != null) { 2599302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.disconnect(); 2600cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 2601939caef712f306a1c80ea27e9f41ef6e3ea9e0f1Irfan Sheriff } 2602fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } finally { 2603fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff super.finalize(); 2604fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 2605fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 26065fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle 26075fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle /** 26085fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * Set wifi verbose log. Called from developer settings. 26095fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * @hide 26105fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle */ 26115fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle public void enableVerboseLogging (int verbose) { 26125fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle try { 26135fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle mService.enableVerboseLogging(verbose); 2614f5af4a972598611c46d4bf169919e23b7375a5a9vandwalle } catch (Exception e) { 2615f5af4a972598611c46d4bf169919e23b7375a5a9vandwalle //ignore any failure here 2616f5af4a972598611c46d4bf169919e23b7375a5a9vandwalle Log.e(TAG, "enableVerboseLogging " + e.toString()); 26175fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 26185fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 26195fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle 26205fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle /** 26215fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * Get the WiFi verbose logging level.This is used by settings 26225fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * to decide what to show within the picker. 26235fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * @hide 26245fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle */ 26255fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle public int getVerboseLoggingLevel() { 26265fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle try { 26275fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle return mService.getVerboseLoggingLevel(); 26285fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } catch (RemoteException e) { 26295fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle return 0; 26305fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 26315fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 2632d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2633d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2634d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Set wifi Aggressive Handover. Called from developer settings. 2635d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2636d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2637d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public void enableAggressiveHandover(int enabled) { 2638d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2639d524c78d9358e2fa1e67124468cffa5284870c62vandwalle mService.enableAggressiveHandover(enabled); 2640d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2641d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2642d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2643d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2644d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2645d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2646d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Get the WiFi Handover aggressiveness.This is used by settings 2647d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * to decide what to show within the picker. 2648d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2649d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2650d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public int getAggressiveHandover() { 2651d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2652d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return mService.getAggressiveHandover(); 2653d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2654d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return 0; 2655d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2656d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2657d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2658d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2659d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Set setting for allowing Scans when traffic is ongoing. 2660d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2661d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2662d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public void setAllowScansWithTraffic(int enabled) { 2663d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2664d524c78d9358e2fa1e67124468cffa5284870c62vandwalle mService.setAllowScansWithTraffic(enabled); 2665d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2666d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2667d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2668d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2669d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2670d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2671d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Get setting for allowing Scans when traffic is ongoing. 2672d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2673d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2674d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public int getAllowScansWithTraffic() { 2675d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2676d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return mService.getAllowScansWithTraffic(); 2677d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2678d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return 0; 2679d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2680d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 268173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 26825914caff06f9790238bea0536acfbf533cee9046Pierre Vandwalle /** 2683984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott * Resets all wifi manager settings back to factory defaults. 2684984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott * 2685984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott * @hide 2686984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott */ 2687984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott public void factoryReset() { 2688f1fb39763d87dabe254b6ed64ac8f20145035bc0Stuart Scott try { 2689f1fb39763d87dabe254b6ed64ac8f20145035bc0Stuart Scott mService.factoryReset(); 2690f1fb39763d87dabe254b6ed64ac8f20145035bc0Stuart Scott } catch (RemoteException e) { 2691984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott } 2692984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott } 26937094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe 26947094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe /** 26957094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe * Get Network object of current wifi network 26967094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe * @return Get Network object of current wifi network 26977094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe * @hide 26987094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe */ 26997094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe public Network getCurrentNetwork() { 27007094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe try { 27017094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe return mService.getCurrentNetwork(); 27027094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe } catch (RemoteException e) { 27037094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe return null; 27047094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe } 27057094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe } 2706358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2707358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2708e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Framework layer autojoin enable/disable when device is associated 2709e8de06d2feb6680df15c1473fb72efb214ced744xinhe * this will enable/disable autojoin scan and switch network when connected 2710e8de06d2feb6680df15c1473fb72efb214ced744xinhe * @return true -- if set successful false -- if set failed 2711358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2712358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2713e8de06d2feb6680df15c1473fb72efb214ced744xinhe public boolean enableAutoJoinWhenAssociated(boolean enabled) { 2714358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2715e8de06d2feb6680df15c1473fb72efb214ced744xinhe return mService.enableAutoJoinWhenAssociated(enabled); 2716358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2717e8de06d2feb6680df15c1473fb72efb214ced744xinhe return false; 2718358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2719358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2720358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2721358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2722e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Get setting for Framework layer autojoin enable status 2723358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2724358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2725e8de06d2feb6680df15c1473fb72efb214ced744xinhe public boolean getEnableAutoJoinWhenAssociated() { 2726358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2727e8de06d2feb6680df15c1473fb72efb214ced744xinhe return mService.getEnableAutoJoinWhenAssociated(); 2728358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2729e8de06d2feb6680df15c1473fb72efb214ced744xinhe return false; 2730358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2731358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2732358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2733e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Set setting for enabling autojoin Offload thru Wifi HAL layer 2734358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2735358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2736e8de06d2feb6680df15c1473fb72efb214ced744xinhe public void setHalBasedAutojoinOffload(int enabled) { 2737358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2738e8de06d2feb6680df15c1473fb72efb214ced744xinhe mService.setHalBasedAutojoinOffload(enabled); 2739358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2740358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2741358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2742358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2743358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2744358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2745e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Get setting for enabling autojoin Offload thru Wifi HAL layer 2746358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2747358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2748e8de06d2feb6680df15c1473fb72efb214ced744xinhe public int getHalBasedAutojoinOffload() { 2749358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2750e8de06d2feb6680df15c1473fb72efb214ced744xinhe return mService.getHalBasedAutojoinOffload(); 2751358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2752358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2753358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle return 0; 2754358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2755651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 2756