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; 21ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport android.content.Context; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.DhcpInfo; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 2688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport android.os.HandlerThread; 27d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.os.Looper; 28d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.os.Message; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 307e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackbornimport android.os.WorkSource; 31227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriffimport android.os.Messenger; 3288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport android.util.Log; 33d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.util.SparseArray; 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapndeimport java.net.InetAddress; 3688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport java.util.concurrent.CountDownLatch; 3788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 380451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwaltimport com.android.internal.R; 39ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport com.android.internal.util.AsyncChannel; 40d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport com.android.internal.util.Protocol; 41ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final String TAG = "WifiManager"; 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7589710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * Broadcast intent action indicating whether Wi-Fi scanning is allowed currently 7689710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * @hide 7789710842585404ea33f941afeb2c321e706005e9Robert Greenwalt */ 7889710842585404ea33f941afeb2c321e706005e9Robert Greenwalt public static final String WIFI_SCAN_AVAILABLE = "wifi_scan_available"; 7989710842585404ea33f941afeb2c321e706005e9Robert Greenwalt 8089710842585404ea33f941afeb2c321e706005e9Robert Greenwalt /** 8189710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * Extra int indicating scan availability, WIFI_STATE_ENABLED and WIFI_STATE_DISABLED 8289710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * @hide 8389710842585404ea33f941afeb2c321e706005e9Robert Greenwalt */ 8489710842585404ea33f941afeb2c321e706005e9Robert Greenwalt public static final String EXTRA_SCAN_AVAILABLE = "scan_enabled"; 8589710842585404ea33f941afeb2c321e706005e9Robert Greenwalt 8689710842585404ea33f941afeb2c321e706005e9Robert Greenwalt /** 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 90227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 101227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 111227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 115227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 119227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 126227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 134227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 141227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 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_UNKNOWN = 4; 1545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 1705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 1715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 1725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 1735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 1745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 1785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 1805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1815321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 1825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 1885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 195a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 204a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 2085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2135321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 214a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 2155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 2175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 223a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 233a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 2563550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 2573550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 2583550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 2623550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2803550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 2813550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 2823550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 2833550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 2843550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 2853550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 2863550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 313fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 314fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 315be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 3161b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * This can be as a result of adding/updating/deleting a network. If 3171b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set to true the new configuration 3181b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * can be retreived with the {@link #EXTRA_WIFI_CONFIGURATION} extra. If multiple 3191b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Wi-Fi configurations changed, {@link #EXTRA_WIFI_CONFIGURATION} will not be present. 320e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 321e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 322be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 323be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3251b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for a (@link android.net.wifi.WifiConfiguration} object representing 3261b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * the changed Wi-Fi configuration when the {@link #CONFIGURED_NETWORKS_CHANGED_ACTION} 3271b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * broadcast is sent. 3281b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3291b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3301b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_WIFI_CONFIGURATION = "wifiConfiguration"; 3311b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3321b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Multiple network configurations have changed. 3331b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3341b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * 3351b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3361b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3371b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_MULTIPLE_NETWORKS_CHANGED = "multipleChanges"; 3381b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3391b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for an integer indicating the reason a Wi-Fi network configuration 3401b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * has changed. Only present if {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is {@code false} 3411b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3421b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3431b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3441b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_CHANGE_REASON = "changeReason"; 3451b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3461b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration is new and was added. 3471b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3481b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3491b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_ADDED = 0; 3501b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3511b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration was removed and is no longer present in the system's list of 3521b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * configured networks. 3531b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3541b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3551b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_REMOVED = 1; 3561b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3571b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration has changed as a result of explicit action or because the system 3581b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * took an automated action such as disabling a malfunctioning configuration. 3591b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3601b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3611b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_CONFIG_CHANGE = 2; 3621b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call {@link #getScanResults()} to obtain the results. 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3690451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * A batch of access point scans has been completed and the results areavailable. 3700451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Call {@link #getBatchedScanResults()} to obtain the results. 3710451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide pending review 3720451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 3730451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3740451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public static final String BATCHED_SCAN_RESULTS_AVAILABLE_ACTION = 3750451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt "android.net.wifi.BATCHED_RESULTS"; 3760451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 388be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 3890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 3900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3910d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 392be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 393be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 394f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 3950d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 39637e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 3970d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 3980d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 3990d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 4000d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 40137e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 4020d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 4030d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 404f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * The lookup key for a {@link android.net.LinkCapabilities} object associated with the 405f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 406f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 407f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 408f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 409f61101f6266be243c481d163b95e65d67b8d1669Wink Saville public static final String EXTRA_LINK_CAPABILITIES = "linkCapabilities"; 410f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 411f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 41637e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4181ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Activity Action: Show a system activity that allows the user to enable 4191ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * scans to be available even with Wi-Fi turned off. 4201ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 4211ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <p>Notification of the result of this activity is posted using the 4221ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * {@link android.app.Activity#onActivityResult} callback. The 4231ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <code>resultCode</code> 4241ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * will be {@link android.app.Activity#RESULT_OK} if scan always mode has 4251ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * been turned on or {@link android.app.Activity#RESULT_CANCELED} if the user 4261ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * has rejected the request or an error has occurred. 4271ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 4281ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 4291ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff public static final String ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE = 4301ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff "android.net.wifi.action.REQUEST_SCAN_ALWAYS_AVAILABLE"; 4311ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 4321ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 44199001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 44999001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 458652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 459652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 460652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 461652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 462652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 463652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 464652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 465652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 466652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 467652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 468652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 469652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 470652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 471652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 472652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 473652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 474652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 475652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 476652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 480652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 48336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 48436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 485ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 486ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 487ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 488ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 489ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 490ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 491ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 49236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 49336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 49436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 49536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 49636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 49736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 49836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 49936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 50036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 50136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 50236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 50336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 50436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 50536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 50636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 50736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 50836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 50936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 510227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 511227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 512227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 513227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 514227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 515227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 516227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 517227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 518227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 519227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 520227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 521227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 522227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 523227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 524227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 525227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 526617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 527617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 528617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 529617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 530617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 531617750604c69e6068f68266d0e30324273aa990eMike Lockwood 532617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 533617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 534617750604c69e6068f68266d0e30324273aa990eMike Lockwood 53588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Context mContext; 53688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff IWifiManager mService; 53788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 53888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final int INVALID_KEY = 0; 539302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int sListenerKey = 1; 540302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final SparseArray sListenerMap = new SparseArray(); 541302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sListenerMapLock = new Object(); 54288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 543302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static AsyncChannel sAsyncChannel; 544302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static CountDownLatch sConnected; 54588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 546302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sThreadRefLock = new Object(); 547cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static int sThreadRefCount; 548cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static HandlerThread sHandlerThread; 549cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 55588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @param context the application context 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 56088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public WifiManager(Context context, IWifiManager service) { 56188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mContext = context; 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 56388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff init(); 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 58259358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * of {@link WifiConfiguration} objects. Upon failure to fetch or 58359358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * when when Wi-Fi is turned off, it can be null. 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 600227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 640227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.enableNetwork(netId, disableOthers); 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 711e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 712e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 726e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 727e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 741e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 742e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 769a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7716942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie final WorkSource workSource = null; 7726942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie mService.startScan(workSource); 7736942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie return true; 7746942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } catch (RemoteException e) { 7756942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie return false; 7766942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } 7776942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie } 7786942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie 7796942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie /** @hide */ 7806942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie public boolean startScan(WorkSource workSource) { 7816942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie try { 7826942a1200cf8872e67e8e0a8ebc9e2e65531595bDavid Christie mService.startScan(workSource); 783e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 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 /** 7900451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Request a batched scan for access points. To end your requested batched scan, 7910451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * call stopBatchedScan with the same Settings. 7920451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * 7930451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * If there are mulitple requests for batched scans, the more demanding settings will 7940451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * take precidence. 7950451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * 7960451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @param requested {@link BatchedScanSettings} the scan settings requested. 7970451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @return false on known error 7980451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 7990451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 8000451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public boolean requestBatchedScan(BatchedScanSettings requested) { 8010451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt try { 802a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt return mService.requestBatchedScan(requested, new Binder(), null); 803a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt } catch (RemoteException e) { return false; } 804a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt } 805a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt /** @hide */ 806a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt public boolean requestBatchedScan(BatchedScanSettings requested, WorkSource workSource) { 807a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt try { 808a029ea131836725b050e1a7550aa171b68171522Robert Greenwalt return mService.requestBatchedScan(requested, new Binder(), workSource); 8090451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } catch (RemoteException e) { return false; } 8100451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 8110451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 8120451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 8130451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Check if the Batched Scan feature is supported. 8140451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * 8150451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @return false if not supported. 8160451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 8170451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 8180451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public boolean isBatchedScanSupported() { 8190451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt try { 8200451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt return mService.isBatchedScanSupported(); 8210451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } catch (RemoteException e) { return false; } 8220451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 8230451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 8240451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 8250451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * End a requested batch scan for this applicaiton. Note that batched scan may 8260451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * still occur if other apps are using them. 827126755cf41710d52554d747f3d3667eb0a3c2694Robert Greenwalt * 828126755cf41710d52554d747f3d3667eb0a3c2694Robert Greenwalt * @param requested {@link BatchedScanSettings} the scan settings you previously requested 829126755cf41710d52554d747f3d3667eb0a3c2694Robert Greenwalt * and now wish to stop. A value of null here will stop all scans requested by the 830126755cf41710d52554d747f3d3667eb0a3c2694Robert Greenwalt * calling App. 8310451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 8320451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 8330451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public void stopBatchedScan(BatchedScanSettings requested) { 8340451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt try { 83582f4218c0d5dbc10404db8cf31f0284140d80175Robert Greenwalt mService.stopBatchedScan(requested); 8360451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } catch (RemoteException e) {} 8370451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 8380451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 8390451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 8400451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * Retrieve the latest batched scan result. This should be called immediately after 8410451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * {@link BATCHED_SCAN_RESULTS_AVAILABLE_ACTION} is received. 8420451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt * @hide 8430451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt */ 8440451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt public List<BatchedScanResult> getBatchedScanResults() { 8450451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt try { 84695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn return mService.getBatchedScanResults(mContext.getOpPackageName()); 8470451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } catch (RemoteException e) { 8480451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt return null; 8490451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 8500451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt } 8510451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt 8520451d59ba2d768e7653752028910f00a6c96e64eRobert Greenwalt /** 8538e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * Force a re-reading of batched scan results. This will attempt 8548e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * to read more information from the chip, but will do so at the expense 8558e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * of previous data. Rate limited to the current scan frequency. 8568e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * 8578e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * pollBatchedScan will always wait 1 period from the start of the batch 8588e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * before trying to read from the chip, so if your #scans/batch == 1 this will 8598e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * have no effect. 8608e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * 8618e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * If you had already waited 1 period before calling, this should have 8628e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * immediate (though async) effect. 8638e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * 8648e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * If you call before that 1 period is up this will set up a timer and fetch 8658e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * results when the 1 period is up. 8668e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * 8678e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * Servicing a pollBatchedScan request (immediate or after timed delay) starts a 8688e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * new batch, so if you were doing 10 scans/batch and called in the 4th scan, you 8698e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * would get data in the 4th and then again 10 scans later. 8708e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt * @hide 8718e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt */ 8728e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt public void pollBatchedScan() { 8738e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt try { 8748e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt mService.pollBatchedScan(); 8758e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt } catch (RemoteException e) { } 8768e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt } 8778e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt 8788e628dadc321bf49e93e482540df87431d014b01Robert Greenwalt /** 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the results of the latest access point scan. 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the list of access points found in the most recent scan. 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 89695d785346b4dae808a2d8f77356175e55a572d96Dianne Hackborn return mService.getScanResults(mContext.getOpPackageName()); 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9031ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Check if scanning is always available. 9041ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 9051ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * If this return {@code true}, apps can issue {@link #startScan} and fetch scan results 9061ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * even when Wi-Fi is turned off. 9071ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 9081ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * To change this setting, see {@link #ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE}. 9091ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 9107ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff public boolean isScanAlwaysAvailable() { 9111ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff try { 9127ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff return mService.isScanAlwaysAvailable(); 9131ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } catch (RemoteException e) { 9141ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff return false; 9151ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 9161ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 9171ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 9181ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 924227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 9269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 936ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 937ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 938ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 940ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 942ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 944ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 945ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 9469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 94936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 95036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 95136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 95236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 95336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 95436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 95536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 95636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 95736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 95836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 95936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 96036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 96136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 96236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 96336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 96436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 96536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 96636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 96736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 96836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 96936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 97036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 97136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 97236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 97336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 97436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 97536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 97636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 97736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 97836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 97936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 98036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 98136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 98236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 98336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 98436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 98536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 98636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 98736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 98836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 98936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 99036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 99136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 99236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 99336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 9949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 9959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 9969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 9979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 9999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 10019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 10039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 10089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 10099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 10109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 10119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 10139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 10159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 10179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 10229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 10239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 10249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 10259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 10269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 10289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 10299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 10309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 10319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 10329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1034227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 10359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1036227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 10379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 10389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 10399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 10419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 10429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1043227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 10449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1045f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * Return TX packet counter, for CTS test of WiFi watchdog. 1046f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param listener is the interface to receive result 1047f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * 1048f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @hide for CTS test only 1049f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1050f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void getTxPacketCount(TxPacketCountListener listener) { 1051f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng validateChannel(); 1052302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(RSSI_PKTCNT_FETCH, 0, putListener(listener)); 1053f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1054f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1055f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 10569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 10579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 1058227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 10599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 10609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 10619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 10629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 10639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 10649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 10669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 10679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 10689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 10699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 10709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 10714c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 10724c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 10734c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 10749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1076227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 10779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 1079227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 10809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 10819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 10829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 10839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 10849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 10859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 10869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 10879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 10889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 10899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 10909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 10915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 10925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 10935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 10945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 10955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 10965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 10975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 10985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 10995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 11005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 11015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 11025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 11035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 1104ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff mService.setWifiApEnabled(wifiConfig, enabled); 1105ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff return true; 11065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 11075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 11085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 11095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 11105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 11115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 11125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 11135321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 11145321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 11155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 11165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 11175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 11185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 11195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 11205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 11215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 11225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 11235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 11245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 11255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 11265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 11275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 11285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 11295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 11305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 11315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 11325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 11335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 11345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 11355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 11365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 11375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 11385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 11395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 11409ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 11419ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 11429ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 11439ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 11449ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 11459ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 11469ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 11479ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 11489ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 11499ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 11509ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 11519ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 11529ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 11539ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 115417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 115517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 115617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 115717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 115817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 115917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 116017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 116117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 116217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 116317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 116417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 116517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 116617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 116717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 11680d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 11690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Start the driver and connect to network. 11700d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. For example, 11720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * even if the device is idle or there is only a scan-only lock held, 11730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a start wifi would mean that wifi connection is kept active until 11740d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a stopWifi() is sent. 11750d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 11770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11780d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 11790d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 11800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 11810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean startWifi() { 11820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 11830d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.startWifi(); 11840d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 11850d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 11860d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 11870d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11880d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 11900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 11910d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Disconnect from a network (if any) and stop the driver. 11920d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11930d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. Wi-Fi 11940d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * stays inactive until a startWifi() is issued. 11950d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11960d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 11970d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11980d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 11990d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 12000d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 12010d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean stopWifi() { 12020d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 12030d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.stopWifi(); 12040d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 12050d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 12060d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 12070d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 12080d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 12090d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 12100d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 12110d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 12120d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 12130d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 12140d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 12150d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 12160d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 12170d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 12180d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 12190d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 12200d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 12210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 12220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 12230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 12240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 12250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 12260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 12270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 12280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 12290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 12300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 12310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 12320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 12330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 12340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 12350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 12360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 12370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 12380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 12390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 12400d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 12410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 12420d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 12430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 124464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 124564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 1246b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * Enable/Disable TDLS on a specific local route. 124764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 1248b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * <p> 1249b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * TDLS enables two wireless endpoints to talk to each other directly 1250b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * without going through the access point that is managing the local 1251b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * network. It saves bandwidth and improves quality of the link. 1252b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * </p> 1253b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * <p> 1254b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * This API enables/disables the option of using TDLS. If enabled, the 1255b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * underlying hardware is free to use TDLS or a hop through the access 1256b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * point. If disabled, existing TDLS session is torn down and 1257b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * hardware is restricted to use access point for transferring wireless 1258b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * packets. Default value for all routes is 'disabled', meaning restricted 1259b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * to use access point for transferring packets. 1260b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * </p> 126164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 126264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteIPAddress IP address of the endpoint to setup TDLS with 126364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 126464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 1265b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde public void setTdlsEnabled(InetAddress remoteIPAddress, boolean enable) { 126664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 126764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdls(remoteIPAddress.getHostAddress(), enable); 126864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 126964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 127064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 127164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 127264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 127364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 1274b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * Similar to {@link #setTdlsEnabled(InetAddress, boolean) }, except 1275b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde * this version allows you to specify remote endpoint with a MAC address. 127664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteMacAddress MAC address of the remote endpoint such as 00:00:0c:9f:f2:ab 127764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 127864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 1279b676a4a70db36bdd6ce5060d16f453f797378098Vinit Deshapnde public void setTdlsEnabledWithMacAddress(String remoteMacAddress, boolean enable) { 128064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 128164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdlsWithMacAddress(remoteMacAddress, enable); 128264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 128364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 128464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 128564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 128664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 1287e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1288ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1289d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private static final int BASE = Protocol.BASE_WIFI_MANAGER; 1290d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1291ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1292ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1293d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK = BASE + 1; 1294d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1295d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_FAILED = BASE + 2; 1296d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1297d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_SUCCEEDED = BASE + 3; 1298d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1299d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1300d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK = BASE + 4; 1301d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1302d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_FAILED = BASE + 5; 1303ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1304d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_SUCCEEDED = BASE + 6; 1305d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1306ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1307d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK = BASE + 7; 1308ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1309d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_FAILED = BASE + 8; 13108dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 1311d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_SUCCEEDED = BASE + 9; 1312ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1313ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1314d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS = BASE + 10; 1315d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1316d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS_SUCCEEDED = BASE + 11; 1317d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1318d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_FAILED = BASE + 12; 131986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 1320d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_COMPLETED = BASE + 13; 1321d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1322d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 132386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS = BASE + 14; 132486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 132586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_FAILED = BASE + 15; 132686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 132786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_SUCCEDED = BASE + 16; 132886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 132986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 133086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK = BASE + 17; 1331d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 133286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_FAILED = BASE + 18; 1333d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 133486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_SUCCEEDED = BASE + 19; 1335ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1336f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1337f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH = BASE + 20; 1338f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1339f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_SUCCEEDED = BASE + 21; 1340f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1341f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_FAILED = BASE + 22; 1342f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1343d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1344d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1345d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1346d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed due to an internal error. 1347d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1348d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 134986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int ERROR = 0; 1350d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1351d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1352d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1353d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation is already in progress 1354d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1355d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 135686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int IN_PROGRESS = 1; 1357d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1358d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1359d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1360d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed because the framework is busy and 1361d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * unable to service the request 1362d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1363d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 136486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int BUSY = 2; 1365d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1366d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* WPS specific errors */ 1367d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS overlap detected {@hide} */ 136886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_OVERLAP_ERROR = 3; 136986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** WEP on WPS is prohibited {@hide} */ 137086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_WEP_PROHIBITED = 4; 137186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** TKIP only prohibited {@hide} */ 137286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TKIP_ONLY_PROHIBITED = 5; 137386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** Authentication failure on WPS {@hide} */ 137486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_AUTH_FAILURE = 6; 137586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** WPS timed out {@hide} */ 137686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TIMED_OUT = 7; 1377d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 137810652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde /** 137910652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * Passed with {@link ActionListener#onFailure}. 138010652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * Indicates that the operation failed due to invalid inputs 138110652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde * @hide 138210652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde */ 138310652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde public static final int INVALID_ARGS = 8; 138410652a95b16909acf26f31cdafc0c6aa09212f26Vinit Deshapnde 1385d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on an application action {@hide} */ 1386d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ActionListener { 1387d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** The operation succeeded */ 1388d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onSuccess(); 1389d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1390d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The operation failed 1391d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1392d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1393d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1394d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1395d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1396d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1397d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on a start WPS action {@hide} */ 1398d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface WpsListener { 1399d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS start succeeded */ 1400d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onStartSuccess(String pin); 1401d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1402d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS operation completed succesfully */ 1403d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onCompletion(); 1404d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1405d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1406d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * WPS operation failed 1407d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1408d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #IN_PROGRESS}, {@link #WPS_OVERLAP_ERROR},{@link #ERROR} or {@link #BUSY} 1409d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1410d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1411d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1412d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1413f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** Interface for callback invocation on a TX packet count poll action {@hide} */ 1414f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public interface TxPacketCountListener { 1415f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1416f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation succeeded 1417f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param count TX packet counter 1418f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1419f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onSuccess(int count); 1420f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1421f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation failed 1422f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param reason The reason for failure could be one of 1423f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1424f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1425f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onFailure(int reason); 1426f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1427f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1428302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static class ServiceHandler extends Handler { 142988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ServiceHandler(Looper looper) { 143088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff super(looper); 1431d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1432d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 143388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff @Override 143488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void handleMessage(Message message) { 143588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Object listener = removeListener(message.arg2); 143688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff switch (message.what) { 143788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_HALF_CONNECTED: 143888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (message.arg1 == AsyncChannel.STATUS_SUCCESSFUL) { 1439302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(AsyncChannel.CMD_CHANNEL_FULL_CONNECTION); 144088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } else { 144188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Failed to set up channel connection"); 144288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 144388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1444302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 144588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1446302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.countDown(); 144788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 144888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_FULLY_CONNECTED: 144988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // Ignore 145088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 145188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_DISCONNECTED: 145288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Channel connection lost"); 145388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 145488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1455302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1456fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff getLooper().quit(); 145788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 145888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 145988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_FAILED: 146088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_FAILED: 146188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_FAILED: 146288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CANCEL_WPS_FAILED: 146388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_FAILED: 146488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 146588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onFailure(message.arg1); 146688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 146788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 146888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 146988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_SUCCEEDED: 147088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_SUCCEEDED: 147188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_SUCCEEDED: 147288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CANCEL_WPS_SUCCEDED: 147388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_SUCCEEDED: 147488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 147588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onSuccess(); 147688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 147788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 147888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.START_WPS_SUCCEEDED: 147988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 148088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff WpsResult result = (WpsResult) message.obj; 148188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onStartSuccess(result.pin); 148288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //Listener needs to stay until completion or failure 1483302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized(sListenerMapLock) { 1484302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(message.arg2, listener); 1485d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 148688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 148788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 148888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_COMPLETED: 148988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 149088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onCompletion(); 149188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 149288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 149388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_FAILED: 149488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 149588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onFailure(message.arg1); 149688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1497f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1498f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_SUCCEEDED: 1499f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1500f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng RssiPacketCountInfo info = (RssiPacketCountInfo) message.obj; 1501f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (info != null) 1502f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onSuccess(info.txgood + info.txbad); 1503f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng else 1504f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(ERROR); 1505f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1506f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1507f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_FAILED: 1508f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1509f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(message.arg1); 1510f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 151188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 151288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff default: 151388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //ignore 151488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 1515d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1516d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 151788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1518d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1519302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int putListener(Object listener) { 152088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener == null) return INVALID_KEY; 152188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff int key; 1522302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 152388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff do { 1524302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff key = sListenerKey++; 152588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } while (key == INVALID_KEY); 1526302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(key, listener); 1527d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 152888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return key; 152988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1530d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1531302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static Object removeListener(int key) { 153288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (key == INVALID_KEY) return null; 1533302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 1534302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Object listener = sListenerMap.get(key); 1535302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.remove(key); 153688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return listener; 1537d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1538d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1539ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 154088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void init() { 1541cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 1542cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff if (++sThreadRefCount == 1) { 1543302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Messenger messenger = getWifiServiceMessenger(); 1544302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (messenger == null) { 1545302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1546302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff return; 1547302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1548302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1549cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread = new HandlerThread("WifiManager"); 1550302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = new AsyncChannel(); 1551302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected = new CountDownLatch(1); 1552302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1553cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread.start(); 1554302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Handler handler = new ServiceHandler(sHandlerThread.getLooper()); 1555302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.connect(mContext, handler, messenger); 1556302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff try { 1557302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.await(); 1558302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } catch (InterruptedException e) { 1559302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Log.e(TAG, "interrupted wait at init"); 1560302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1561cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1562cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1563d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1564ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 156588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void validateChannel() { 1566302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (sAsyncChannel == null) throw new IllegalStateException( 156735bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff "No permission to access and change wifi or a bad initialization"); 156888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 156988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 1570e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1571e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 1572e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 1573e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1574e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1575e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 1576e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1577e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1578e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1579e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1580d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 158188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 158288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 158388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * 1584e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1585e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 158688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(WifiConfiguration config, ActionListener listener) { 1587d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 158888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1589ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // Use INVALID_NETWORK_ID for arg1 when passing a config object 1590ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // arg1 is used to pass network id when the network already exists 1591302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, WifiConfiguration.INVALID_NETWORK_ID, 159288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff putListener(listener), config); 1593e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1594e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1595e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1596e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 1597e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1598e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 1599e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1600e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1601e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 1602e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 1603d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 160488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 160588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1606e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1607e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 160888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(int networkId, ActionListener listener) { 1609d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (networkId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 161088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1611302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, networkId, putListener(listener)); 1612e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1613e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1614e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1615e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 1616e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 1617e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 1618e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1619e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1620e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 1621e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1622e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 1623e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 1624e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1625e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1626e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1627d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 162888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 162988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1630e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1631e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 163288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void save(WifiConfiguration config, ActionListener listener) { 1633d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 163488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1635302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(SAVE_NETWORK, 0, putListener(listener), config); 1636e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1637e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1638e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1639e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 1640e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1641e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 1642e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 1643e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1644e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1645e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1646d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 164788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 164888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1649e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1650e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 165188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void forget(int netId, ActionListener listener) { 1652d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 165388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1654302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(FORGET_NETWORK, netId, putListener(listener)); 1655d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1656d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1657d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1658d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Disable network 1659d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 1660d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param netId is the network Id 1661d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 166288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 166388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1664d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1665d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 166688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void disable(int netId, ActionListener listener) { 1667d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 166888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1669302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(DISABLE_NETWORK, netId, putListener(listener)); 1670e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1671e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 167217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 167302fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 16745ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 167502fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * @param config WPS configuration 1676d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 167788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 167888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 16795ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 16805ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 168188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void startWps(WpsInfo config, WpsListener listener) { 1682d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 168388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1684302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(START_WPS, 0, putListener(listener), config); 1685f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1686f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 1687f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 168886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * Cancel any ongoing Wi-fi Protected Setup 168986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * 169086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @param listener for callbacks on success or failure. Can be null. 169188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 169288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 169386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @hide 169486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff */ 169588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void cancelWps(ActionListener listener) { 169688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1697302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CANCEL_WPS, 0, putListener(listener)); 169886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff } 169986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 170086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** 1701227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 1702227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 1703227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1704227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 1705227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 1706227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 170707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiServiceMessenger() { 1708227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 170907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiServiceMessenger(); 1710227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 1711227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 171235bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff } catch (SecurityException e) { 171335bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff return null; 1714227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1715227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1716227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1717227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** 171807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * Get a reference to WifiStateMachine handler. 171907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @return Messenger pointing to the WifiService handler 172007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @hide 172107573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff */ 172207573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiStateMachineMessenger() { 172307573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff try { 172407573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiStateMachineMessenger(); 172507573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } catch (RemoteException e) { 172607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return null; 172707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 172807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 172907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 173007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff /** 17314aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 17324aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 17334aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 17344aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 17354aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 17364aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 17374aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 17384aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 17394aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 17404aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 17414aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 17424aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 1745227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 17469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 17479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 1748d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 17499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 17509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 17519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 17529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 17539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 1754d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 17559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 17569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 17579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 1758d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 1759d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 1760d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * permission in an {@code <uses-permission>} element of the application's manifest. 17619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 17639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 17649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 17659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 17669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 17679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 17689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 17697e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 17709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 1784227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 17932c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 17949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17957e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 1796617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1797617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1798617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 1799617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1800617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1801617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1802617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1803617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 18079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 18219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 18229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1828617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1829617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1830617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 18379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 18439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 18459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 18469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 18479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 18489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 18499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 18519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 18539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 18549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 18589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 18609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 18629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 18639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 18649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18677e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 18687e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 18697e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 18707e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 18717e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18727e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 18737e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 18747e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 18757e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 1876a31510e47a0f0c2525702c2f10a85064322a28f2David Christie ws.clearNames(); 1877a31510e47a0f0c2525702c2f10a85064322a28f2David Christie if (mWorkSource == null) { 1878a31510e47a0f0c2525702c2f10a85064322a28f2David Christie changed = mWorkSource != null; 1879a31510e47a0f0c2525702c2f10a85064322a28f2David Christie mWorkSource = new WorkSource(ws); 1880a31510e47a0f0c2525702c2f10a85064322a28f2David Christie } else { 1881a31510e47a0f0c2525702c2f10a85064322a28f2David Christie changed = mWorkSource.diff(ws); 1882a31510e47a0f0c2525702c2f10a85064322a28f2David Christie if (changed) { 1883a31510e47a0f0c2525702c2f10a85064322a28f2David Christie mWorkSource.set(ws); 1884a31510e47a0f0c2525702c2f10a85064322a28f2David Christie } 18857e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18867e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18877e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 18887e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 18897e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 18907e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 18917e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18927e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18937e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18947e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 18957e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 18969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 18979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 18989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 18999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 19009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 19019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 19029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 19039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 19049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 19059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 19079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 19119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 19129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 19139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 19149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 19159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 19169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1917617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1918617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1919617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 19209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 19219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 19279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 19299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19305876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 1931652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 1932652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 1933652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 1934652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 19359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 19369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 19379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 19399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 19419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 19439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 19449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1945652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 19469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 19479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 19489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 19509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 19519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 19529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 19539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 19559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 19569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 19579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 19589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 19599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 19609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 19615347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 1962fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 19635347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1964fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 19655347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1966fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 196741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 196841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 196941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 197041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 19715347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1972fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 1973fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1974fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 19755347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1976fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 1977fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 19785347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 19795347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 19805347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1981fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 1982fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 1983fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 1984fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 1985fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 198641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 19875347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1988fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 1989fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 1990fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 199141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 199241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 1993fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 1994fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1995fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 1996fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 1997fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 199841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 199941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 2000fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 2001fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2002fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2003fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 2004fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 2005fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 200641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 200741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 200841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 200941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 201041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 201141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 201241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 201341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 201441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 201541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 2016fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2017fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 2018fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 2019fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2020fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 2021fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 2022fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2023fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 2024fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 20252c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 2026fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 2027fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 2028617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2029617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 2030617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 2031617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 2032617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 2033617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2034617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 2035617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2036fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 2037fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 203841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 2039fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2040fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2041fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2042fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2043fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 2044fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 2045fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 2046fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 204741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 204841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 204941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 205041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 205141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 205241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 205341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 205441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 205541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 20564a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 205741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 205841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 2059fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 2060fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 2061fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 2062fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 2063fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2064fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 2065fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 2066fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2067fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 2068fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 206941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 2070fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 2071fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 2072617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 2073617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 2074617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 2075fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 2076fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 207741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 207841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 207941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 208041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 208141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 2082fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2083fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2084fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2085fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2086fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 208741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 208841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 208941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 209041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 209141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 209241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 209341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 209441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 209541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 209641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 209741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 209841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 209941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 210041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 210141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 210241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 210341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 210441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 210541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 2106fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 2107fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 2108fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 2109fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 2110fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 2111fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 2112fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 2113fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2114fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2115fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2116fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 211741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 2118fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 2119fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 2120fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 212141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 212241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 212341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 212441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 212541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 212641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 2127fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2128fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2129fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2130fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 2131fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 2132fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 213341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 2134fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 21355347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 21365347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 21375347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 21385347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2139fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 21405347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2141fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 21425347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 21435347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 21445347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2145fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 21465347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 2147fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 21485347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 21495347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 21505347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 21515347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 2152e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 2153e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 2154e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 2155e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 2156e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 2157e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 2158e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 2159e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 2160e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 2161e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 2162e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 2163e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2164e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2165da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff 2166da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff /** @hide */ 2167da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff public void captivePortalCheckComplete() { 2168da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff try { 2169da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff mService.captivePortalCheckComplete(); 2170da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff } catch (RemoteException e) {} 2171da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff } 2172fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff 2173fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff protected void finalize() throws Throwable { 2174fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff try { 2175cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 2176302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (--sThreadRefCount == 0 && sAsyncChannel != null) { 2177302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.disconnect(); 2178cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 2179939caef712f306a1c80ea27e9f41ef6e3ea9e0f1Irfan Sheriff } 2180fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } finally { 2181fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff super.finalize(); 2182fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 2183fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 2184651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 2185