WifiManager.java revision 88d93cd68a32e7110f9328ff522226126c7e493e
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 */ 1915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 2005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 2045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 208e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe 209e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe /** 210e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * The look up key for an int that indicates why softAP started failed 211e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * currently support general and no_channel 212e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @see #SAP_START_FAILURE_GENERAL 213e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @see #SAP_START_FAILURE_NO_CHANNEL 214e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * 215e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @hide 216e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe */ 217e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe public static final String EXTRA_WIFI_AP_FAILURE_REASON = "wifi_ap_error_code"; 2185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 2205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 2225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 2255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 2265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 2285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 2295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 235a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 2365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 2385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 2415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 244a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 2455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 2475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 2485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 254a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 2555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 2575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 263a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 273a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 276e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * If WIFI AP start failed, this reason code means there is no legal channel exists on 277e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * user selected band by regulatory 278e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * 279e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @hide 280e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe */ 281e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe public static final int SAP_START_FAILURE_GENERAL= 0; 282e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe 283e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe /** 284e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * All other reason for AP start failed besides SAP_START_FAILURE_GENERAL 285e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * 286e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe * @hide 287e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe */ 288e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe public static final int SAP_START_FAILURE_NO_CHANNEL = 1; 289e0ec6ba9cb6494df147479316c24defb167ab2b1xinhe /** 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 3103550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 3113550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 3123550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 3163550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3343550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 3353550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 3363550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 3373550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 3383550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 3393550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 3403550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 3429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 3439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 3489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 367fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 368fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 369be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 3701b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * This can be as a result of adding/updating/deleting a network. If 3711b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set to true the new configuration 3721b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * can be retreived with the {@link #EXTRA_WIFI_CONFIGURATION} extra. If multiple 3731b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Wi-Fi configurations changed, {@link #EXTRA_WIFI_CONFIGURATION} will not be present. 374e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 375e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 376e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 377be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 378be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3801b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for a (@link android.net.wifi.WifiConfiguration} object representing 3811b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * the changed Wi-Fi configuration when the {@link #CONFIGURED_NETWORKS_CHANGED_ACTION} 3821b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * broadcast is sent. 3831b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3841b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 385e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 3861b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_WIFI_CONFIGURATION = "wifiConfiguration"; 3871b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3881b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Multiple network configurations have changed. 3891b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3901b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * 3911b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3921b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 393e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 3941b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_MULTIPLE_NETWORKS_CHANGED = "multipleChanges"; 3951b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3961b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for an integer indicating the reason a Wi-Fi network configuration 3971b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * has changed. Only present if {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is {@code false} 3981b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3991b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4001b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 401e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4021b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_CHANGE_REASON = "changeReason"; 4031b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4041b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration is new and was added. 4051b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4061b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 407e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4081b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_ADDED = 0; 4091b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4101b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration was removed and is no longer present in the system's list of 4111b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * configured networks. 4121b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4131b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 414e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4151b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_REMOVED = 1; 4161b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4171b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration has changed as a result of explicit action or because the system 4181b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * took an automated action such as disabling a malfunctioning configuration. 4191b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 4201b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 421e75c0b8e3becd9f875679a5240f3b1e26d089a3fChelsea Derrick @SystemApi 4221b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_CONFIG_CHANGE = 2; 4231b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 425a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * Call {@link #getScanResults()} to obtain the results. {@link #EXTRA_RESULTS_UPDATED} 426a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * indicates if the scan was completed successfully. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 43029ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande 43129ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande /** 432a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * Lookup key for a {@code boolean} representing the result of previous {@link #startScan} 433a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * operation, reported with {@link #SCAN_RESULTS_AVAILABLE_ACTION}. 434a0d929e505432a8c84f3899696c910db16bd73bfVinit Deshpande * @return true scan was successful, results are updated 43529ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande * @return false scan was not successful, results haven't been updated since previous scan 43629ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande */ 43729ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande public static final String EXTRA_RESULTS_UPDATED = "resultsUpdated"; 43829ad7c7000393751a0ab0e1a17912db7866d4ff8Vinit Deshpande 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4400451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * A batch of access point scans has been completed and the results areavailable. 4410451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Call {@link #getBatchedScanResults()} to obtain the results. 44288d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 44388d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 44488d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @hide 4450451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 44688d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 4470451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4480451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public static final String BATCHED_SCAN_RESULTS_AVAILABLE_ACTION = 4490451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt "android.net.wifi.BATCHED_RESULTS"; 4500451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 462be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 4630d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 4640d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 4650d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 466be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 467be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 468f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 4690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 47037e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 4710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 4720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 4730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 4740d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 47537e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 4760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 4770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 478f9cb86aebe9647e0fe0137fc198ba16c017445c6Robert Greenwalt * The lookup key for a {@link android.net.NetworkCapabilities} object associated with the 479f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 480f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 481f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 482f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 483f9cb86aebe9647e0fe0137fc198ba16c017445c6Robert Greenwalt public static final String EXTRA_NETWORK_CAPABILITIES = "networkCapabilities"; 484f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 485f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 49037e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4921ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Activity Action: Show a system activity that allows the user to enable 4931ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * scans to be available even with Wi-Fi turned off. 4941ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 4951ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <p>Notification of the result of this activity is posted using the 4961ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * {@link android.app.Activity#onActivityResult} callback. The 4971ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <code>resultCode</code> 4981ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * will be {@link android.app.Activity#RESULT_OK} if scan always mode has 4991ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * been turned on or {@link android.app.Activity#RESULT_CANCELED} if the user 5001ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * has rejected the request or an error has occurred. 5011ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 5021ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 5031ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff public static final String ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE = 5041ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff "android.net.wifi.action.REQUEST_SCAN_ALWAYS_AVAILABLE"; 5051ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 5061ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 51599001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 52399001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 532652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 533652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 534652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 535652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 536652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 537652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 538652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 539652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 540652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 541652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 542652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 543652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 544652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 545652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 546652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 547652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 548652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 549652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 550652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 554652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 55736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 55836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 559ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 560ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 561ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 562ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 563ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 564ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 565ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 56636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 56736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 56836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 56936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 57036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 57136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 57236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 57336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 57436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 57536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 57636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 57736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 57836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 57936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 58036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 58136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 58236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 58336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 584227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 585227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 586227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 587227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 588227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 589227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 590227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 591227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 592227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 593227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 594227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 595227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 596227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 597227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 598227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 599227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 600ffadfb9ffdced62db215319d3edc7717802088fbVinit Deshapnde /** @hide */ 601ffadfb9ffdced62db215319d3edc7717802088fbVinit Deshapnde public static final boolean DEFAULT_POOR_NETWORK_AVOIDANCE_ENABLED = false; 602ffadfb9ffdced62db215319d3edc7717802088fbVinit Deshapnde 603617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 604617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 605617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 606617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 607617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 608617750604c69e6068f68266d0e30324273aa990eMike Lockwood 609617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 610617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 611617750604c69e6068f68266d0e30324273aa990eMike Lockwood 61288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Context mContext; 61388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff IWifiManager mService; 6141022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private final int mTargetSdkVersion; 61588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 61688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final int INVALID_KEY = 0; 617302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int sListenerKey = 1; 618302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final SparseArray sListenerMap = new SparseArray(); 619302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sListenerMapLock = new Object(); 62088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 621302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static AsyncChannel sAsyncChannel; 622302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static CountDownLatch sConnected; 6231022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private static ConnectivityManager sCM; 62488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 625302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sThreadRefLock = new Object(); 626cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static int sThreadRefCount; 627cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static HandlerThread sHandlerThread; 628cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff 6291022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti @GuardedBy("sCM") 6301022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // TODO: Introduce refcounting and make this a per-process static callback, instead of a 6311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // per-WifiManager callback. 6321022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private PinningNetworkCallback mNetworkCallback; 6331022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 63988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @param context the application context 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 64488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public WifiManager(Context context, IWifiManager service) { 64588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mContext = context; 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 6471022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mTargetSdkVersion = context.getApplicationInfo().targetSdkVersion; 64888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff init(); 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 66759358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * of {@link WifiConfiguration} objects. Upon failure to fetch or 66859358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * when when Wi-Fi is turned off, it can be null. 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 674f6d3d148d50562823e5f953ddd9c084266ac4c1bJan Nordqvist Log.w(TAG, "Caught RemoteException trying to get configured networks: " + e); 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong /** @hide */ 680758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong @SystemApi 681758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong public List<WifiConfiguration> getPrivilegedConfiguredNetworks() { 682758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong try { 683758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong return mService.getPrivilegedConfiguredNetworks(); 684758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong } catch (RemoteException e) { 685758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong return null; 686758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong } 687758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong } 688758bdf4a915c313f1c3bef0b95b494c91f363f03Wenchao Tong 6894eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle /** @hide */ 6904eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle @SystemApi 6914eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle public WifiConnectionStatistics getConnectionStatistics() { 6924eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle try { 6934eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle return mService.getConnectionStatistics(); 6944eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle } catch (RemoteException e) { 6954eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle return null; 6964eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle } 6974eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle } 6984eeecb25509f91ac7a6e2cde76dac782fbec5360vandwalle 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 700b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * Returns a WifiConfiguration matching this ScanResult 701b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * @param scanResult scanResult that represents the BSSID 702b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * @return {@link WifiConfiguration} that matches this BSSID or null 703b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande * @hide 704b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande */ 705b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande public WifiConfiguration getMatchingWifiConfig(ScanResult scanResult) { 706b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande try { 707b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande return mService.getMatchingWifiConfig(scanResult); 708b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande } catch (RemoteException e) { 709b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande return null; 710b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande } 711b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande } 712b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande 713b4d90fca0ec461c24cd38e4b7d1990447ad047a1Vinit Deshpande /** 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 720227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 760227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 7951022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * <p> 7961022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * <b>Note:</b> If an application's target SDK version is 797976f044b2b3eff2ce968e3ea59022414180c268dLorenzo Colitti * {@link android.os.Build.VERSION_CODES#LOLLIPOP} or newer, network 7981022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * communication may not use Wi-Fi even if Wi-Fi is connected; traffic may 7991022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * instead be sent through another network, such as cellular data, 8001022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * Bluetooth tethering, or Ethernet. For example, traffic will never use a 8011022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * Wi-Fi network that does not provide Internet access (e.g. a wireless 8021022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * printer), if another network that does offer Internet access (e.g. 8031022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * cellular data) is available. Applications that need to ensure that their 8041022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * network traffic uses Wi-Fi should use APIs such as 8051022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * {@link Network#bindSocket(java.net.Socket)}, 8061022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * {@link Network#openConnection(java.net.URL)}, or 8071022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * {@link ConnectivityManager#bindProcessToNetwork} to do so. 8081022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 816976f044b2b3eff2ce968e3ea59022414180c268dLorenzo Colitti final boolean pin = disableOthers && mTargetSdkVersion < Build.VERSION_CODES.LOLLIPOP; 8171022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (pin) { 8181022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti registerPinningNetworkCallback(); 8191022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 8201022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 8211022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti boolean success; 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8231022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti success = mService.enableNetwork(netId, disableOthers); 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8251022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti success = false; 8261022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 8271022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 8281022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (pin && !success) { 8291022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti unregisterPinningNetworkCallback(); 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 8321022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti return success; 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 857e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 858e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 872e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 873e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 887e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 888e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 90973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /* Keep this list in sync with wifi_hal.h */ 91073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 91173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_INFRA = 0x0001; // Basic infrastructure mode 91273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 91373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_INFRA_5G = 0x0002; // Support for 5 GHz Band 91473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 91573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_PASSPOINT = 0x0004; // Support for GAS/ANQP 91673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 91773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_P2P = 0x0008; // Wifi-Direct 91873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 91973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_MOBILE_HOTSPOT = 0x0010; // Soft AP 92073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_SCANNER = 0x0020; // WifiScanner APIs 92273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_NAN = 0x0040; // Neighbor Awareness Networking 92473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_D2D_RTT = 0x0080; // Device-to-device RTT 92673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_D2AP_RTT = 0x0100; // Device-to-AP RTT 92873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 92973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_BATCH_SCAN = 0x0200; // Batched Scan (deprecated) 93073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_PNO = 0x0400; // Preferred network offload 93273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_ADDITIONAL_STA = 0x0800; // Support for two STAs 93473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_TDLS = 0x1000; // Tunnel directed link setup 93673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_TDLS_OFFCHANNEL = 0x2000; // Support for TDLS off channel 93873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** @hide */ 93973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static final int WIFI_FEATURE_EPR = 0x4000; // Enhanced power reporting 940ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 941ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_AP_STA = 0x8000; // Support for AP STA Concurrency 942ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 943ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_LINK_LAYER_STATS = 0x10000; // Link layer stats collection 944ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 945ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_LOGGER = 0x20000; // WiFi Logger 946ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle /** @hide */ 947ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle public static final int WIFI_FEATURE_HAL_EPNO = 0x40000; // WiFi PNO enhanced 94873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 94973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande private int getSupportedFeatures() { 95073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande try { 95173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return mService.getSupportedFeatures(); 95273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } catch (RemoteException e) { 95373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return 0; 95473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 95573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 95673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 95773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande private boolean isFeatureSupported(int feature) { 95873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return (getSupportedFeatures() & feature) == feature; 95973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 96073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 96173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports 5 GHz band 96273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 96373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean is5GHzBandSupported() { 96473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_INFRA_5G); 96573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 96673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 96773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 96873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports passpoint 96973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 97073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 97173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isPasspointSupported() { 97273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_PASSPOINT); 97373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 97473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 97573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 97673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports WifiP2pManager (Wi-Fi Direct) 97773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 97873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isP2pSupported() { 97973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_P2P); 98073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 98173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 98273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 98373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports portable Wi-Fi hotspot 98473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 98573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 98673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 98773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isPortableHotspotSupported() { 98873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_MOBILE_HOTSPOT); 98973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 99073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 99173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 99273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports WifiScanner APIs 99373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 99473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 99573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 99673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isWifiScannerSupported() { 99773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_SCANNER); 99873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 99973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 100073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 100173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Neighbour Awareness Network APIs 100273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 100373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 100473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isNanSupported() { 100573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_NAN); 100673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 100773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 100873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 100973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Device-to-device RTT 101073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 101173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 101273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 101373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isDeviceToDeviceRttSupported() { 101473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_D2D_RTT); 101573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 101673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 101773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 101873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Device-to-AP RTT 101973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 102073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande @SystemApi 102173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isDeviceToApRttSupported() { 102273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_D2AP_RTT); 102373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 102473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 102573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 102673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports offloaded connectivity scan 102773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 102873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isPreferredNetworkOffloadSupported() { 102973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_PNO); 103073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 103173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 103273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 103373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports multiple simultaneous connections 103473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 103573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 103673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isAdditionalStaSupported() { 103773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_ADDITIONAL_STA); 103873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 103973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 104073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 104173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Tunnel Directed Link Setup 104273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 104373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isTdlsSupported() { 104473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_TDLS); 104573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 104673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 104773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 104873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports Off Channel Tunnel Directed Link Setup 104973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 105073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 105173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isOffChannelTdlsSupported() { 105273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return isFeatureSupported(WIFI_FEATURE_TDLS_OFFCHANNEL); 105373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 105473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 105573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 105673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return true if this adapter supports advanced power/performance counters 105773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 105873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public boolean isEnhancedPowerReportingSupported() { 1059ddfd35dbf9aab0ff196e1d7046ebe6bcd972c7a5Pierre Vandwalle return isFeatureSupported(WIFI_FEATURE_LINK_LAYER_STATS); 106073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 106173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 106273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 106373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * Return the record of {@link WifiActivityEnergyInfo} object that 106473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * has the activity and energy info. This can be used to ascertain what 106573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * the controller has been up to, since the last sample. 106673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @param updateType Type of info, cached vs refreshed. 106773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * 106873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @return a record with {@link WifiActivityEnergyInfo} or null if 106973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * report is unavailable or unsupported 107073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 107173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 107273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public WifiActivityEnergyInfo getControllerActivityEnergyInfo(int updateType) { 107373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (mService == null) return null; 107473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande try { 107573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande WifiActivityEnergyInfo record; 107673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (!isEnhancedPowerReportingSupported()) { 107773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return null; 107873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 107973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande synchronized(this) { 108073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande record = mService.reportActivityInfo(); 108120903b392b78e5f3dc0ce8b782154adc77853468Pierre Vandwalle if (record != null && record.isValid()) { 108273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return record; 108373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } else { 108473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return null; 108573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 108673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 108773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } catch (RemoteException e) { 108873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande Log.e(TAG, "getControllerActivityEnergyInfo: " + e); 108973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 109073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande return null; 109173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 109273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 1093738803fee62a98f244250996380820c4923e7f7bYuhao Zheng /** 10949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 10959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 10969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 10979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 10989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1099a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 11009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1101738803fee62a98f244250996380820c4923e7f7bYuhao Zheng mService.startScan(null, null); 11026942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie return true; 11036942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } catch (RemoteException e) { 11046942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie return false; 11056942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } 11066942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } 11076942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie 11086942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie /** @hide */ 1109c20b795cf05b48fe5e024c19dab9c7e4b18cd10fDavid Christie @SystemApi 11106942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie public boolean startScan(WorkSource workSource) { 11116942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie try { 1112738803fee62a98f244250996380820c4923e7f7bYuhao Zheng mService.startScan(null, workSource); 1113738803fee62a98f244250996380820c4923e7f7bYuhao Zheng return true; 1114738803fee62a98f244250996380820c4923e7f7bYuhao Zheng } catch (RemoteException e) { 1115738803fee62a98f244250996380820c4923e7f7bYuhao Zheng return false; 1116738803fee62a98f244250996380820c4923e7f7bYuhao Zheng } 1117738803fee62a98f244250996380820c4923e7f7bYuhao Zheng } 1118738803fee62a98f244250996380820c4923e7f7bYuhao Zheng 1119738803fee62a98f244250996380820c4923e7f7bYuhao Zheng /** 1120da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * startLocationRestrictedScan() 1121da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * Trigger a scan which will not make use of DFS channels and is thus not suitable for 1122da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * establishing wifi connection. 112388d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 112488d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 1125da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle * @hide 1126da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle */ 112788d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 1128da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle @SystemApi 1129da123a6726e7c64b3f19f74ed0eb02bb4398a989vandwalle public boolean startLocationRestrictedScan(WorkSource workSource) { 113088d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills return false; 11310451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 11320451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 11330451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 11340451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Check if the Batched Scan feature is supported. 11350451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * 11360451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @return false if not supported. 113788d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 113888d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 11390451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 11400451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 114188d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 1142c20b795cf05b48fe5e024c19dab9c7e4b18cd10fDavid Christie @SystemApi 11430451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public boolean isBatchedScanSupported() { 114488d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills return false; 11450451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 11460451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 11470451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 11480451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Retrieve the latest batched scan result. This should be called immediately after 11490451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * {@link BATCHED_SCAN_RESULTS_AVAILABLE_ACTION} is received. 115088d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * @deprecated This API is nolonger supported. 115188d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills * Use {@link android.net.wifi.WifiScanner} API 11520451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 11530451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 115488d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills @Deprecated 1155c20b795cf05b48fe5e024c19dab9c7e4b18cd10fDavid Christie @SystemApi 11560451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public List<BatchedScanResult> getBatchedScanResults() { 115788d93cd68a32e7110f9328ff522226126c7e493eMitchell Wills return null; 11588e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt } 11598e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt 11608e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt /** 1161b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * Creates a configuration token describing the network referenced by {@code netId} 1162b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * of MIME type application/vnd.wfa.wsc. Can be used to configure WiFi networks via NFC. 1163b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * 1164b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * @return hex-string encoded configuration token 1165b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales * @hide 1166b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales */ 1167b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales public String getWpsNfcConfigurationToken(int netId) { 1168b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales try { 1169b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales return mService.getWpsNfcConfigurationToken(netId); 1170b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales } catch (RemoteException e) { 1171b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales return null; 1172b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales } 1173b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales } 1174b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales 1175b2e6bfd0f0fc675b253ce081d97ca192422a7495Andres Morales /** 11769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the results of the latest access point scan. 1189cb13aebfec313a3433ed0f53cc2e3b6dbaf888d0Fyodor Kupolov * @return the list of access points found in the most recent scan. An app must hold 1190cb13aebfec313a3433ed0f53cc2e3b6dbaf888d0Fyodor Kupolov * {@link android.Manifest.permission#ACCESS_COARSE_LOCATION ACCESS_COARSE_LOCATION} or 1191959991b957fb58672aef17c46a7662941f138e19Fyodor Kupolov * {@link android.Manifest.permission#ACCESS_FINE_LOCATION ACCESS_FINE_LOCATION} permission 1192cb13aebfec313a3433ed0f53cc2e3b6dbaf888d0Fyodor Kupolov * in order to get valid results. 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 119695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn return mService.getScanResults(mContext.getOpPackageName()); 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 120352eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * An augmented version of getScanResults that returns ScanResults as well as OSU information 120452eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * wrapped in ScanInfo objects. 120552eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * @return 120652eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist */ 120752eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist public List<ScanInfo> getScanInfos() { 120852eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist try { 120952eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist return mService.getScanInfos(mContext.getOpPackageName()); 121052eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } catch (RemoteException e) { 121152eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist return null; 121252eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 121352eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 121452eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist 121552eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist /** 121652eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * Notify the OSU framework about the currently selected OSU. 121752eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist * @param osuID The OSU ID from ScanInfo.getOsuIdentity() 121852eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist */ 121952eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist public void setOsuSelection(int osuID) { 122052eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist try { 122152eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist mService.setOsuSelection(osuID); 122252eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } catch (RemoteException e) { 122352eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 122452eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist } 122552eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist 122652eb29f0822f129f2b14bacec23dd492f2260ac0Jan Nordqvist /** 12271ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Check if scanning is always available. 12281ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 12291ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * If this return {@code true}, apps can issue {@link #startScan} and fetch scan results 12301ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * even when Wi-Fi is turned off. 12311ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 12321ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * To change this setting, see {@link #ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE}. 12331ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 12347ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff public boolean isScanAlwaysAvailable() { 12351ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff try { 12367ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff return mService.isScanAlwaysAvailable(); 12371ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } catch (RemoteException e) { 12381ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff return false; 12391ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 12401ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 12411ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 12421ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 12479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 1248227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1260ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 1261ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 1262ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1264ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1266ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1268ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 1269ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1273b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * get the country code. 1274b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * @return the country code in ISO 3166 format. 1275b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * 1276b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe * @hide 1277b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe */ 1278b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe public String getCountryCode() { 1279b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe try { 1280b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe String country = mService.getCountryCode(); 1281b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe return(country); 1282b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe } catch (RemoteException e) { 1283b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe return null; 1284b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe } 1285b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe } 1286b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe 1287b938c0e2036d28df24ec626fc8ed7e277248b9a6xinhe /** 128836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 128936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 129036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 129136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 129236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 129336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 129436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 129536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 129636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 129736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 129836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 129936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 130036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 130136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 130236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 130336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 130436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 130536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 130636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 130736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 130836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 130936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 131036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 131136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 131236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 131336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 131436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 131536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 131636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 131736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 131836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 131936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 132036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 132136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 132236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 132336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 132436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 132536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 132636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 132736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 132836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 132936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 133036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 133136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 133236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 13479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 13489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 13499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 13509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 13529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 13549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 13569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 13619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 13629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 13639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 13649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 13659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 13679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 13699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 13709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1373227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1375227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1382227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1384f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * Return TX packet counter, for CTS test of WiFi watchdog. 1385f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param listener is the interface to receive result 1386f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * 1387f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @hide for CTS test only 1388f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1389f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void getTxPacketCount(TxPacketCountListener listener) { 1390f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng validateChannel(); 1391302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(RSSI_PKTCNT_FETCH, 0, putListener(listener)); 1392f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1393f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1394f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 1397227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 14059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 14069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 14079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 14089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 14099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 14104c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 14114c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 14124c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1415227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 1418227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 14209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 14315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 14325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 14335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 14345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 14355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 14365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 14375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 14385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 14395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 14405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 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 * 14575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 14585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 14595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 14605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 14615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 14625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 14635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 14645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 14675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 14685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 14695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 14705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 14715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 14725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 14735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 14745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 14755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 14765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 14775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 14785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 14799ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 14809ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 14819ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 14829ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 14839ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 14849ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 14859ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 14869ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 14879ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 14889ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 14899ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 14909ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 14919ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 14929ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 1493e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * Builds a WifiConfiguration from Hotspot 2.0 MIME file. 1494e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * @return AP details in WifiConfiguration 1495e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * 1496e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist * @hide Dont open yet 1497e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist */ 1498e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist public WifiConfiguration buildWifiConfig(String uriString, String mimeType, byte[] data) { 1499e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist try { 1500e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist return mService.buildWifiConfig(uriString, mimeType, data); 1501e9b056f8860296a08f93f4b7d2a0971c746c227bJan Nordqvist } catch (RemoteException e) { 1502f6d3d148d50562823e5f953ddd9c084266ac4c1bJan Nordqvist Log.w(TAG, "Caught RemoteException trying to build wifi config: " + e); 15039ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 15049ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 15059ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 15069ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 15079ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 150817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 150917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 151017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 151117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 151217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 151317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 151417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 151517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 151617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 151717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 151817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 151917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 152017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 152117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 15220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 15230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 15240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 15260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 15280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 15290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 15300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 15310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 15320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 15330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 15340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 15350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 15360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 15390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 15400d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 15410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15420d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 15430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 15440d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 15450d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 15460d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 15470d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 15480d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 15490d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 15500d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 15510d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 15520d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 15530d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15540d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 15550d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 155664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 155764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 1558b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * Enable/Disable TDLS on a specific local route. 155964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 1560b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * <p> 1561b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * TDLS enables two wireless endpoints to talk to each other directly 1562b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * without going through the access point that is managing the local 1563b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * network. It saves bandwidth and improves quality of the link. 1564b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * </p> 1565b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * <p> 1566b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * This API enables/disables the option of using TDLS. If enabled, the 1567b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * underlying hardware is free to use TDLS or a hop through the access 1568b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * point. If disabled, existing TDLS session is torn down and 1569b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * hardware is restricted to use access point for transferring wireless 1570b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * packets. Default value for all routes is 'disabled', meaning restricted 1571b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * to use access point for transferring packets. 1572b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * </p> 157364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 157464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteIPAddress IP address of the endpoint to setup TDLS with 157564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 157664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 1577b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde public void setTdlsEnabled(InetAddress remoteIPAddress, boolean enable) { 157864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 157964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdls(remoteIPAddress.getHostAddress(), enable); 158064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 158164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 158264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 158364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 158464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 158564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 1586b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * Similar to {@link #setTdlsEnabled(InetAddress, boolean) }, except 1587b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * this version allows you to specify remote endpoint with a MAC address. 158864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteMacAddress MAC address of the remote endpoint such as 00:00:0c:9f:f2:ab 158964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 159064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 1591b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde public void setTdlsEnabledWithMacAddress(String remoteMacAddress, boolean enable) { 159264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 159364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdlsWithMacAddress(remoteMacAddress, enable); 159464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 159564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 159664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 159764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 159864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 1599e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1600ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1601d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private static final int BASE = Protocol.BASE_WIFI_MANAGER; 1602d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1603ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1604ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1605d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK = BASE + 1; 1606d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1607d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_FAILED = BASE + 2; 1608d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1609d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_SUCCEEDED = BASE + 3; 1610d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1611d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1612d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK = BASE + 4; 1613d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1614d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_FAILED = BASE + 5; 1615ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1616d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_SUCCEEDED = BASE + 6; 1617d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1618ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1619d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK = BASE + 7; 1620ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1621d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_FAILED = BASE + 8; 16228dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 1623d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_SUCCEEDED = BASE + 9; 1624ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1625ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1626d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS = BASE + 10; 1627d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1628d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS_SUCCEEDED = BASE + 11; 1629d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1630d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_FAILED = BASE + 12; 163186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 1632d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_COMPLETED = BASE + 13; 1633d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1634d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 163586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS = BASE + 14; 163686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 163786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_FAILED = BASE + 15; 163886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 163986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_SUCCEDED = BASE + 16; 164086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 164186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 164286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK = BASE + 17; 1643d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 164486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_FAILED = BASE + 18; 1645d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 164686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_SUCCEEDED = BASE + 19; 1647ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1648f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1649f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH = BASE + 20; 1650f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1651f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_SUCCEEDED = BASE + 21; 1652f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1653f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_FAILED = BASE + 22; 1654f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1655d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1656d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1657d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed due to an internal error. 165873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 1659d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 166086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int ERROR = 0; 1661d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1662d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1663d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1664d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation is already in progress 166573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 1666d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 166786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int IN_PROGRESS = 1; 1668d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1669d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1670d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1671d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed because the framework is busy and 1672d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * unable to service the request 167373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 1674d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 167586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int BUSY = 2; 1676d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1677d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* WPS specific errors */ 1678674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** WPS overlap detected */ 167986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_OVERLAP_ERROR = 3; 1680674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** WEP on WPS is prohibited */ 168186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_WEP_PROHIBITED = 4; 1682674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** TKIP only prohibited */ 168386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TKIP_ONLY_PROHIBITED = 5; 1684674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** Authentication failure on WPS */ 168586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_AUTH_FAILURE = 6; 1686674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** WPS timed out */ 168786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TIMED_OUT = 7; 1688d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 168910652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde /** 169010652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * Passed with {@link ActionListener#onFailure}. 169110652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * Indicates that the operation failed due to invalid inputs 169273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 169310652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde */ 169410652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde public static final int INVALID_ARGS = 8; 169510652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde 1696ae81483a15bb3811cfc221970ea290599b43d4deSky Faber /** 1697ae81483a15bb3811cfc221970ea290599b43d4deSky Faber * Passed with {@link ActionListener#onFailure}. 1698ae81483a15bb3811cfc221970ea290599b43d4deSky Faber * Indicates that the operation failed due to user permissions. 1699ae81483a15bb3811cfc221970ea290599b43d4deSky Faber * @hide 1700ae81483a15bb3811cfc221970ea290599b43d4deSky Faber */ 1701ae81483a15bb3811cfc221970ea290599b43d4deSky Faber public static final int NOT_AUTHORIZED = 9; 1702ae81483a15bb3811cfc221970ea290599b43d4deSky Faber 170373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande /** 170473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * Interface for callback invocation on an application action 170573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * @hide 170673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande */ 1707d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ActionListener { 1708d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** The operation succeeded */ 1709d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onSuccess(); 1710d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1711d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The operation failed 1712d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1713d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1714d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1715d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1716d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1717d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1718674ca8a1f47c07033645a1016e68a2e82597e2faVinit Deshpande /** Interface for callback invocation on a start WPS action */ 171973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public static abstract class WpsCallback { 1720d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS start succeeded */ 172173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public abstract void onStarted(String pin); 1722d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1723d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS operation completed succesfully */ 172473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public abstract void onSucceeded(); 1725d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1726d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1727d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * WPS operation failed 1728d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 172973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * {@link #WPS_TKIP_ONLY_PROHIBITED}, {@link #WPS_OVERLAP_ERROR}, 173073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * {@link #WPS_WEP_PROHIBITED}, {@link #WPS_TIMED_OUT} or {@link #WPS_AUTH_FAILURE} 173173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande * and some generic errors. 1732d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 173373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public abstract void onFailed(int reason); 1734d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1735d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1736f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** Interface for callback invocation on a TX packet count poll action {@hide} */ 1737f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public interface TxPacketCountListener { 1738f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1739f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation succeeded 1740f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param count TX packet counter 1741f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1742f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onSuccess(int count); 1743f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1744f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation failed 1745f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param reason The reason for failure could be one of 1746f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1747f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1748f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onFailure(int reason); 1749f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1750f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1751302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static class ServiceHandler extends Handler { 175288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ServiceHandler(Looper looper) { 175388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff super(looper); 1754d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1755d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 175688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff @Override 175788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void handleMessage(Message message) { 175888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Object listener = removeListener(message.arg2); 175988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff switch (message.what) { 176088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_HALF_CONNECTED: 176188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (message.arg1 == AsyncChannel.STATUS_SUCCESSFUL) { 1762302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(AsyncChannel.CMD_CHANNEL_FULL_CONNECTION); 176388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } else { 176488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Failed to set up channel connection"); 176588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 176688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1767302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 176888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1769302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.countDown(); 177088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 177188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_FULLY_CONNECTED: 177288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // Ignore 177388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 177488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_DISCONNECTED: 177588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Channel connection lost"); 177688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 177788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1778302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1779fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff getLooper().quit(); 178088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 178188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 178288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_FAILED: 178388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_FAILED: 178488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_FAILED: 178588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_FAILED: 178688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 178788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onFailure(message.arg1); 178888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 178988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 179088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 179188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_SUCCEEDED: 179288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_SUCCEEDED: 179388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_SUCCEEDED: 179488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_SUCCEEDED: 179588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 179688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onSuccess(); 179788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 179888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 179988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.START_WPS_SUCCEEDED: 180088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 180188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff WpsResult result = (WpsResult) message.obj; 180273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onStarted(result.pin); 180388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //Listener needs to stay until completion or failure 1804302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized(sListenerMapLock) { 1805302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(message.arg2, listener); 1806d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 180788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 180888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 180988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_COMPLETED: 181088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 181173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onSucceeded(); 181288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 181388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 181488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_FAILED: 181588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 181673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onFailed(message.arg1); 181773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 181873f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande break; 181973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande case WifiManager.CANCEL_WPS_SUCCEDED: 182073f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (listener != null) { 182173f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onSucceeded(); 182273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande } 182373f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande break; 182473f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande case WifiManager.CANCEL_WPS_FAILED: 182573f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande if (listener != null) { 182673f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande ((WpsCallback) listener).onFailed(message.arg1); 182788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1828f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1829f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_SUCCEEDED: 1830f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1831f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng RssiPacketCountInfo info = (RssiPacketCountInfo) message.obj; 1832f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (info != null) 1833f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onSuccess(info.txgood + info.txbad); 1834f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng else 1835f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(ERROR); 1836f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1837f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1838f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_FAILED: 1839f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1840f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(message.arg1); 1841f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 184288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 184388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff default: 184488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //ignore 184588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 1846d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1847d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 184888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1849d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1850302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int putListener(Object listener) { 185188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener == null) return INVALID_KEY; 185288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff int key; 1853302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 185488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff do { 1855302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff key = sListenerKey++; 185688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } while (key == INVALID_KEY); 1857302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(key, listener); 1858d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 185988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return key; 186088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1861d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1862302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static Object removeListener(int key) { 186388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (key == INVALID_KEY) return null; 1864302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 1865302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Object listener = sListenerMap.get(key); 1866302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.remove(key); 186788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return listener; 1868d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1869d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1870ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 187188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void init() { 1872cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 1873cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff if (++sThreadRefCount == 1) { 1874302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Messenger messenger = getWifiServiceMessenger(); 1875302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (messenger == null) { 1876302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1877302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff return; 1878302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1879302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1880cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread = new HandlerThread("WifiManager"); 1881302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = new AsyncChannel(); 1882302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected = new CountDownLatch(1); 1883302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1884cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread.start(); 1885302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Handler handler = new ServiceHandler(sHandlerThread.getLooper()); 1886302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.connect(mContext, handler, messenger); 1887302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff try { 1888302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.await(); 1889302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } catch (InterruptedException e) { 1890302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Log.e(TAG, "interrupted wait at init"); 1891302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1892cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1893cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1894d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1895ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 189688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void validateChannel() { 1897302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (sAsyncChannel == null) throw new IllegalStateException( 189835bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff "No permission to access and change wifi or a bad initialization"); 189988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 190088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 19011022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private void initConnectivityManager() { 19021022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // TODO: what happens if an app calls a WifiManager API before ConnectivityManager is 19031022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // registered? Can we fix this by starting ConnectivityService before WifiService? 19041022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (sCM == null) { 19051022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti sCM = (ConnectivityManager) mContext.getSystemService(Context.CONNECTIVITY_SERVICE); 19061022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (sCM == null) { 19071022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti throw new IllegalStateException("Bad luck, ConnectivityService not started."); 19081022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19091022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19101022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19111022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19121022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti /** 19131022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * A NetworkCallback that pins the process to the first wifi network to connect. 19141022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19151022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * We use this to maintain compatibility with pre-M apps that call WifiManager.enableNetwork() 19161022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * to connect to a Wi-Fi network that has no Internet access, and then assume that they will be 19171022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * able to use that network because it's the system default. 19181022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19191022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * In order to maintain compatibility with apps that call setProcessDefaultNetwork themselves, 19201022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * we try not to set the default network unless they have already done so, and we try not to 19211022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * clear the default network unless we set it ourselves. 19221022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19231022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * This should maintain behaviour that's compatible with L, which would pin the whole system to 19241022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * any wifi network that was created via enableNetwork(..., true) until that network 19251022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * disconnected. 19261022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19271022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * Note that while this hack allows network traffic to flow, it is quite limited. For example: 19281022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 19291022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 1. setProcessDefaultNetwork only affects this process, so: 19301022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - Any subprocesses spawned by this process will not be pinned to Wi-Fi. 19311022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - If this app relies on any other apps on the device also being on Wi-Fi, that won't work 19321022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * either, because other apps on the device will not be pinned. 19331022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * 2. The behaviour of other APIs is not modified. For example: 19341022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - getActiveNetworkInfo will return the system default network, not Wi-Fi. 19351022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - There will be no CONNECTIVITY_ACTION broadcasts about TYPE_WIFI. 19361022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * - getProcessDefaultNetwork will not return null, so if any apps are relying on that, they 19371022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti * will be surprised as well. 19381022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti */ 19391022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private class PinningNetworkCallback extends NetworkCallback { 19401022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private Network mPinnedNetwork; 19411022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19421022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti @Override 19431022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti public void onPreCheck(Network network) { 19441022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (sCM.getProcessDefaultNetwork() == null && mPinnedNetwork == null) { 19451022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti sCM.setProcessDefaultNetwork(network); 19461022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mPinnedNetwork = network; 19471022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti Log.d(TAG, "Wifi alternate reality enabled on network " + network); 19481022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19491022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19501022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19511022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti @Override 19521022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti public void onLost(Network network) { 19531022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (network.equals(mPinnedNetwork) && network.equals(sCM.getProcessDefaultNetwork())) { 19541022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti sCM.setProcessDefaultNetwork(null); 19551022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti Log.d(TAG, "Wifi alternate reality disabled on network " + network); 19561022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mPinnedNetwork = null; 19571022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti unregisterPinningNetworkCallback(); 19581022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19591022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19601022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19611022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19621022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private void registerPinningNetworkCallback() { 19631022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti initConnectivityManager(); 19641022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti synchronized (sCM) { 19651022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (mNetworkCallback == null) { 19661022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti // TODO: clear all capabilities. 19671022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti NetworkRequest request = new NetworkRequest.Builder() 19681022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti .addTransportType(NetworkCapabilities.TRANSPORT_WIFI) 19691022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti .removeCapability(NetworkCapabilities.NET_CAPABILITY_INTERNET) 19701022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti .build(); 19711022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mNetworkCallback = new PinningNetworkCallback(); 1972fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti try { 1973fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti sCM.registerNetworkCallback(request, mNetworkCallback); 1974fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } catch (SecurityException e) { 1975fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti Log.d(TAG, "Failed to register network callback", e); 1976fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } 19771022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19781022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19791022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19801022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 19811022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti private void unregisterPinningNetworkCallback() { 19821022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti initConnectivityManager(); 19831022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti synchronized (sCM) { 19841022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti if (mNetworkCallback != null) { 1985fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti try { 1986fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti sCM.unregisterNetworkCallback(mNetworkCallback); 1987fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } catch (SecurityException e) { 1988fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti Log.d(TAG, "Failed to unregister network callback", e); 1989fa57c489f621cd10add639cf7df59f630a7f41a4Lorenzo Colitti } 19901022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti mNetworkCallback = null; 19911022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19921022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19931022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti } 19941022dde719ca430f062f9e628574d70ae1320677Lorenzo Colitti 1995e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1996e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 1997e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 1998e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1999e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 2000e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 2001e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 2002e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2003e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 2004e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 2005d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 200688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 200788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 200888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * 2009e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2010e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 201188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(WifiConfiguration config, ActionListener listener) { 2012d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 201388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2014ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // Use INVALID_NETWORK_ID for arg1 when passing a config object 2015ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // arg1 is used to pass network id when the network already exists 2016302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, WifiConfiguration.INVALID_NETWORK_ID, 201788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff putListener(listener), config); 2018e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2019e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 2020e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2021e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 2022e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2023e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 2024e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 2025e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2026e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 2027e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 2028d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 202988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 203088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2031e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2032e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 203388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(int networkId, ActionListener listener) { 2034d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (networkId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 203588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2036302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, networkId, putListener(listener)); 2037e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2038e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 2039e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2040e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 2041e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 2042e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 2043e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2044e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 2045e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 2046e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2047e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 2048e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 2049e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2050e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 2051e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 2052d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 205388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 205488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2055e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2056e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 205788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void save(WifiConfiguration config, ActionListener listener) { 2058d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 205988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2060302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(SAVE_NETWORK, 0, putListener(listener), config); 2061e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2062e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 2063e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 2064e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 2065e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2066e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 2067e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 2068e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 2069e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 2070e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 2071d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 207288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 207388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2074e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 2075e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 207688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void forget(int netId, ActionListener listener) { 2077d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 207888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2079302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(FORGET_NETWORK, netId, putListener(listener)); 2080d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 2081d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 2082d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 2083d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Disable network 2084d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 2085d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param netId is the network Id 2086d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 208788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 208888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 2089d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 2090d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 209188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void disable(int netId, ActionListener listener) { 2092d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 209388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2094302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(DISABLE_NETWORK, netId, putListener(listener)); 2095e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 2096e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 209717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 209893e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * Disable ephemeral Network 209993e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * 210093e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * @param SSID, in the format of WifiConfiguration's SSID. 210193e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle * @hide 210293e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle */ 210393e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle public void disableEphemeralNetwork(String SSID) { 210493e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle if (SSID == null) throw new IllegalArgumentException("SSID cannot be null"); 210593e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle try { 210693e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle mService.disableEphemeralNetwork(SSID); 210793e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle } catch (RemoteException e) { 210893e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle } 210993e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle } 211093e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle 211193e4192c06a28f37bc1c16b280fbd22c735b5c92vandwalle /** 211202fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 21135ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 2114c3eb1556446c932b5674adc40af8ff9bfc3a1880Vinit Deshpande * @param config WPS configuration (does not support {@link WpsInfo#LABEL}) 2115d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 211688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 211788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 21185ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 211973f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public void startWps(WpsInfo config, WpsCallback listener) { 2120d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 212188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2122302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(START_WPS, 0, putListener(listener), config); 2123f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 2124f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 2125f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 212686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * Cancel any ongoing Wi-fi Protected Setup 212786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * 212886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @param listener for callbacks on success or failure. Can be null. 212988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 213088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 213186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff */ 213273f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande public void cancelWps(WpsCallback listener) { 213388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 2134302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CANCEL_WPS, 0, putListener(listener)); 213586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff } 213686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 213786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** 2138227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 2139227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 2140227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 2141227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 2142227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 2143227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 214407573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiServiceMessenger() { 2145227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 214607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiServiceMessenger(); 2147227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 2148227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 214935bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff } catch (SecurityException e) { 215035bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff return null; 2151227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 2152227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 2153227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 215407573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 215507573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff /** 21564aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 21574aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 21584aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 21594aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 21604aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 21614aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 21624aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 21634aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 21644aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 21654aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 21664aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 21674aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 21689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 21699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 2170227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 21719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 21729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 2173d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 21749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 21759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 21769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 21779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 21789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 2179d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 21809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 21819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 21829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 2183d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 2184d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 2185d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * permission in an {@code <uses-permission>} element of the application's manifest. 21869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 21879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 21889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 21899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 21909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 21919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 21929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 21939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 21947e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 21959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 21969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 21979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 21989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 21999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 22009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 22019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 22029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 22039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 22079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 2209227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 22109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 22119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 22139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 22149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 22159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 22179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 22182c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 22199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 22207e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 2221617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2222617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 2223617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 2224617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 2225617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 2226617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2227617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 2228617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 22299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 22309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 22329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 22389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 22409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 22419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 22429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 22439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 22459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 22469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 22479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 22499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 22509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 22519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 22529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 2253617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2254617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2255617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 22569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 22579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 22599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 22619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 22629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 22689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 22709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 22719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 22729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 22739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 22749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 22769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 22789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 22799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 22829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 22839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 22849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 22859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 22869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 22879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 22889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 22899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 22919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 22927e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 22937e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 22947e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 22957e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 22967e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 22977e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 22987e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 22997e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 23007e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 2301a31510e47a0f0c2525702c2f10a85064322a28f2David Christie ws.clearNames(); 2302a31510e47a0f0c2525702c2f10a85064322a28f2David Christie if (mWorkSource == null) { 2303a31510e47a0f0c2525702c2f10a85064322a28f2David Christie changed = mWorkSource != null; 2304a31510e47a0f0c2525702c2f10a85064322a28f2David Christie mWorkSource = new WorkSource(ws); 2305a31510e47a0f0c2525702c2f10a85064322a28f2David Christie } else { 2306a31510e47a0f0c2525702c2f10a85064322a28f2David Christie changed = mWorkSource.diff(ws); 2307a31510e47a0f0c2525702c2f10a85064322a28f2David Christie if (changed) { 2308a31510e47a0f0c2525702c2f10a85064322a28f2David Christie mWorkSource.set(ws); 2309a31510e47a0f0c2525702c2f10a85064322a28f2David Christie } 23107e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23117e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23127e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 23137e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 23147e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 23157e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 23167e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23177e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23187e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23197e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 23207e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 23219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 23229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 23239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 23249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 23259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 23269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 23279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 23289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 23299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 23309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 23329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 23359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 23369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 23379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 23389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 23399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 23409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 23419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 2342617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2343617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2344617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 23459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 23469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 23529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 23549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23555876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 2356652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 2357652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 2358652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 2359652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 23609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 23619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 23629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 23649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 23669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 23689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 23699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 2370652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 23719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 23729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 23739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 23759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 23769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 23779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 23789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 23809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 23819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 23829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 23839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 23849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 23859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 23865347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 2387fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 23885347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2389fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 23905347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2391fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 239241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 239341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 239441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 239541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 23965347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2397fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 2398fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2399fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 24005347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2401fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 2402fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 24035347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 24045347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 24055347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2406fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 2407fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 2408fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 2409fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 2410fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 241141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 24125347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2413fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 2414fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 2415fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 241641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 241741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 2418fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 2419fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2420fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 2421fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 2422fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 242341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 242441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 2425fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 2426fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2427fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2428fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 2429fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 2430fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 243141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 243241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 243341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 243441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 243541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 243641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 243741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 243841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 243941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 244041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 2441fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2442fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 2443fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 2444fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2445fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 2446fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 2447fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2448fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 2449fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 24502c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 2451fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 2452fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 2453617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2454617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 2455617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 2456617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 2457617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 2458617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2459617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 2460617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2461fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 2462fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 246341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 2464fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2465fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2466fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2467fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2468fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 2469fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 2470fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 2471fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 247241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 247341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 247441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 247541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 247641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 247741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 247841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 247941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 248041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 24814a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 248241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 248341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 2484fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 2485fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 2486fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 2487fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 2488fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2489fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 2490fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 2491fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2492fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 2493fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 249441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 2495fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 2496fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 2497617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2498617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2499617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2500fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 2501fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 250241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 250341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 250441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 250541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 250641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 2507fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2508fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2509fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2510fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2511fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 251241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 251341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 251441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 251541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 251641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 251741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 251841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 251941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 252041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 252141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 252241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 252341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 252441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 252541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 252641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 252741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 252841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 252941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 253041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 2531fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 2532fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2533fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 2534fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2535fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 2536fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 2537fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 2538fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2539fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2540fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2541fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 254241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 2543fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 2544fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 2545fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 254641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 254741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 254841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 254941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 255041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 255141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 2552fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2553fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2554fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2555fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 2556fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 2557fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 255841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 2559fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 25605347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 25615347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 25625347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 25635347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2564fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 25655347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2566fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 25675347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 25685347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 25695347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2570fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 25715347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 2572fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 25735347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 25745347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 25755347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 25765347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 2577e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 2578e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 2579e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 2580e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 2581e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 2582e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 2583e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 2584e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 2585e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 2586e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 2587e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 2588e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2589e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2590da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff 2591fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff protected void finalize() throws Throwable { 2592fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff try { 2593cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 2594302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (--sThreadRefCount == 0 && sAsyncChannel != null) { 2595302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.disconnect(); 2596cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 2597939caef712f306a1c80ea27e9f41ef6e3ea9e0f1Irfan Sheriff } 2598fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } finally { 2599fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff super.finalize(); 2600fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 2601fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 26025fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle 26035fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle /** 26045fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * Set wifi verbose log. Called from developer settings. 26055fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * @hide 26065fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle */ 26075fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle public void enableVerboseLogging (int verbose) { 26085fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle try { 26095fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle mService.enableVerboseLogging(verbose); 2610f5af4a972598611c46d4bf169919e23b7375a5a9vandwalle } catch (Exception e) { 2611f5af4a972598611c46d4bf169919e23b7375a5a9vandwalle //ignore any failure here 2612f5af4a972598611c46d4bf169919e23b7375a5a9vandwalle Log.e(TAG, "enableVerboseLogging " + e.toString()); 26135fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 26145fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 26155fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle 26165fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle /** 26175fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * Get the WiFi verbose logging level.This is used by settings 26185fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * to decide what to show within the picker. 26195fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle * @hide 26205fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle */ 26215fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle public int getVerboseLoggingLevel() { 26225fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle try { 26235fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle return mService.getVerboseLoggingLevel(); 26245fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } catch (RemoteException e) { 26255fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle return 0; 26265fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 26275fb7bf5fdb93831684b00eb637ec15b5cf0d1e2dvandwalle } 2628d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2629d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2630d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Set wifi Aggressive Handover. Called from developer settings. 2631d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2632d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2633d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public void enableAggressiveHandover(int enabled) { 2634d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2635d524c78d9358e2fa1e67124468cffa5284870c62vandwalle mService.enableAggressiveHandover(enabled); 2636d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2637d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2638d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2639d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2640d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2641d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2642d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Get the WiFi Handover aggressiveness.This is used by settings 2643d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * to decide what to show within the picker. 2644d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2645d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2646d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public int getAggressiveHandover() { 2647d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2648d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return mService.getAggressiveHandover(); 2649d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2650d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return 0; 2651d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2652d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2653d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2654d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2655d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Set setting for allowing Scans when traffic is ongoing. 2656d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2657d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2658d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public void setAllowScansWithTraffic(int enabled) { 2659d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2660d524c78d9358e2fa1e67124468cffa5284870c62vandwalle mService.setAllowScansWithTraffic(enabled); 2661d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2662d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2663d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2664d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2665d524c78d9358e2fa1e67124468cffa5284870c62vandwalle 2666d524c78d9358e2fa1e67124468cffa5284870c62vandwalle /** 2667d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * Get setting for allowing Scans when traffic is ongoing. 2668d524c78d9358e2fa1e67124468cffa5284870c62vandwalle * @hide 2669d524c78d9358e2fa1e67124468cffa5284870c62vandwalle */ 2670d524c78d9358e2fa1e67124468cffa5284870c62vandwalle public int getAllowScansWithTraffic() { 2671d524c78d9358e2fa1e67124468cffa5284870c62vandwalle try { 2672d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return mService.getAllowScansWithTraffic(); 2673d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } catch (RemoteException e) { 2674d524c78d9358e2fa1e67124468cffa5284870c62vandwalle return 0; 2675d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 2676d524c78d9358e2fa1e67124468cffa5284870c62vandwalle } 267773f5d16ad5c61320deac161fe23e00a8a4aed772Vinit Deshpande 26785914caff06f9790238bea0536acfbf533cee9046Pierre Vandwalle /** 2679984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott * Resets all wifi manager settings back to factory defaults. 2680984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott * 2681984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott * @hide 2682984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott */ 2683984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott public void factoryReset() { 2684f1fb39763d87dabe254b6ed64ac8f20145035bc0Stuart Scott try { 2685f1fb39763d87dabe254b6ed64ac8f20145035bc0Stuart Scott mService.factoryReset(); 2686f1fb39763d87dabe254b6ed64ac8f20145035bc0Stuart Scott } catch (RemoteException e) { 2687984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott } 2688984dc850b4caeb4470e52bce773935be5305cf8eStuart Scott } 26897094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe 26907094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe /** 26917094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe * Get Network object of current wifi network 26927094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe * @return Get Network object of current wifi network 26937094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe * @hide 26947094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe */ 26957094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe public Network getCurrentNetwork() { 26967094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe try { 26977094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe return mService.getCurrentNetwork(); 26987094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe } catch (RemoteException e) { 26997094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe return null; 27007094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe } 27017094d22022c8e0c6ad71920b101434dded8a276eSanket Padawe } 2702358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2703358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2704e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Framework layer autojoin enable/disable when device is associated 2705e8de06d2feb6680df15c1473fb72efb214ced744xinhe * this will enable/disable autojoin scan and switch network when connected 2706e8de06d2feb6680df15c1473fb72efb214ced744xinhe * @return true -- if set successful false -- if set failed 2707358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2708358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2709e8de06d2feb6680df15c1473fb72efb214ced744xinhe public boolean enableAutoJoinWhenAssociated(boolean enabled) { 2710358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2711e8de06d2feb6680df15c1473fb72efb214ced744xinhe return mService.enableAutoJoinWhenAssociated(enabled); 2712358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2713e8de06d2feb6680df15c1473fb72efb214ced744xinhe return false; 2714358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2715358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2716358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2717358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2718e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Get setting for Framework layer autojoin enable status 2719358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2720358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2721e8de06d2feb6680df15c1473fb72efb214ced744xinhe public boolean getEnableAutoJoinWhenAssociated() { 2722358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2723e8de06d2feb6680df15c1473fb72efb214ced744xinhe return mService.getEnableAutoJoinWhenAssociated(); 2724358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2725e8de06d2feb6680df15c1473fb72efb214ced744xinhe return false; 2726358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2727358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2728358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2729e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Set setting for enabling autojoin Offload thru Wifi HAL layer 2730358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2731358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2732e8de06d2feb6680df15c1473fb72efb214ced744xinhe public void setHalBasedAutojoinOffload(int enabled) { 2733358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2734e8de06d2feb6680df15c1473fb72efb214ced744xinhe mService.setHalBasedAutojoinOffload(enabled); 2735358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2736358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2737358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2738358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2739358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle 2740358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle /** 2741e8de06d2feb6680df15c1473fb72efb214ced744xinhe * Get setting for enabling autojoin Offload thru Wifi HAL layer 2742358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle * @hide 2743358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle */ 2744e8de06d2feb6680df15c1473fb72efb214ced744xinhe public int getHalBasedAutojoinOffload() { 2745358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle try { 2746e8de06d2feb6680df15c1473fb72efb214ced744xinhe return mService.getHalBasedAutojoinOffload(); 2747358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } catch (RemoteException e) { 2748358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2749358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle return 0; 2750358673e275ed065fadb04c1722ac458e6c617a89Pierre Vandwalle } 2751651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 2752