WifiManager.java revision 64f0d5ba158e9135bcd48d64a1c0db282a4628ba
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 38ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport com.android.internal.util.AsyncChannel; 39d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport com.android.internal.util.Protocol; 40ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final String TAG = "WifiManager"; 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7489710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * Broadcast intent action indicating whether Wi-Fi scanning is allowed currently 7589710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * @hide 7689710842585404ea33f941afeb2c321e706005e9Robert Greenwalt */ 7789710842585404ea33f941afeb2c321e706005e9Robert Greenwalt public static final String WIFI_SCAN_AVAILABLE = "wifi_scan_available"; 7889710842585404ea33f941afeb2c321e706005e9Robert Greenwalt 7989710842585404ea33f941afeb2c321e706005e9Robert Greenwalt /** 8089710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * Extra int indicating scan availability, WIFI_STATE_ENABLED and WIFI_STATE_DISABLED 8189710842585404ea33f941afeb2c321e706005e9Robert Greenwalt * @hide 8289710842585404ea33f941afeb2c321e706005e9Robert Greenwalt */ 8389710842585404ea33f941afeb2c321e706005e9Robert Greenwalt public static final String EXTRA_SCAN_AVAILABLE = "scan_enabled"; 8489710842585404ea33f941afeb2c321e706005e9Robert Greenwalt 8589710842585404ea33f941afeb2c321e706005e9Robert Greenwalt /** 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 89227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 100227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 110227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 114227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 118227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 125227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 133227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 140227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 148227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_UNKNOWN = 4; 1535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 1695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 1705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 1715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 1725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 1735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 1775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 1795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 1815321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 1855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 1885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 194a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 1955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 2005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 203a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 2045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 213a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 2145321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 2165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 222a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 232a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 2553550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 2563550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 2573550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 2613550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2793550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 2803550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 2813550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 2823550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 2833550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 2843550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 2853550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 312fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 313fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 314be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 3151b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * This can be as a result of adding/updating/deleting a network. If 3161b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set to true the new configuration 3171b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * can be retreived with the {@link #EXTRA_WIFI_CONFIGURATION} extra. If multiple 3181b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Wi-Fi configurations changed, {@link #EXTRA_WIFI_CONFIGURATION} will not be present. 319e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 320e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 321be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 322be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3241b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for a (@link android.net.wifi.WifiConfiguration} object representing 3251b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * the changed Wi-Fi configuration when the {@link #CONFIGURED_NETWORKS_CHANGED_ACTION} 3261b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * broadcast is sent. 3271b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3281b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3291b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_WIFI_CONFIGURATION = "wifiConfiguration"; 3301b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3311b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Multiple network configurations have changed. 3321b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3331b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * 3341b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3351b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3361b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_MULTIPLE_NETWORKS_CHANGED = "multipleChanges"; 3371b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3381b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for an integer indicating the reason a Wi-Fi network configuration 3391b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * has changed. Only present if {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is {@code false} 3401b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3411b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3421b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3431b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_CHANGE_REASON = "changeReason"; 3441b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3451b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration is new and was added. 3461b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3471b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3481b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_ADDED = 0; 3491b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3501b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration was removed and is no longer present in the system's list of 3511b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * configured networks. 3521b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3531b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3541b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_REMOVED = 1; 3551b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3561b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration has changed as a result of explicit action or because the system 3571b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * took an automated action such as disabling a malfunctioning configuration. 3581b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3591b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3601b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_CONFIG_CHANGE = 2; 3611b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call {@link #getScanResults()} to obtain the results. 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 379be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 3800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 3810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 383be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 384be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 385f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 3860d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 38737e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 3880d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 3890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 3900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3910d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 39237e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 3930d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 3940d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 395f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * The lookup key for a {@link android.net.LinkCapabilities} object associated with the 396f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 397f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 398f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 399f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 400f61101f6266be243c481d163b95e65d67b8d1669Wink Saville public static final String EXTRA_LINK_CAPABILITIES = "linkCapabilities"; 401f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 402f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 4049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 40737e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4091ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Activity Action: Show a system activity that allows the user to enable 4101ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * scans to be available even with Wi-Fi turned off. 4111ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 4121ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <p>Notification of the result of this activity is posted using the 4131ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * {@link android.app.Activity#onActivityResult} callback. The 4141ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * <code>resultCode</code> 4151ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * will be {@link android.app.Activity#RESULT_OK} if scan always mode has 4161ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * been turned on or {@link android.app.Activity#RESULT_CANCELED} if the user 4171ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * has rejected the request or an error has occurred. 4181ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 4191ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 4201ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff public static final String ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE = 4211ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff "android.net.wifi.action.REQUEST_SCAN_ALWAYS_AVAILABLE"; 4221ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 4231ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 43299001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 44099001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 449652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 450652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 451652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 452652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 453652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 454652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 455652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 456652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 457652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 458652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 459652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 460652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 461652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 462652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 463652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 464652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 465652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 466652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 467652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 471652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 47436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 47536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 476ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 477ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 478ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 479ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 480ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 481ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 482ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 48336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 48436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 48536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 48636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 48736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 48836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 48936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 49036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 49136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 49236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 49336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 49436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 49536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 49636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 49736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 49836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 49936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 50036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 501227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 502227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 503227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 504227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 505227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 506227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 507227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 508227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 509227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 510227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 511227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 512227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 513227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 514227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 515227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 516227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 517617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 518617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 519617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 520617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 521617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 522617750604c69e6068f68266d0e30324273aa990eMike Lockwood 523617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 524617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 525617750604c69e6068f68266d0e30324273aa990eMike Lockwood 52688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Context mContext; 52788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff IWifiManager mService; 52888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 52988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final int INVALID_KEY = 0; 530302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int sListenerKey = 1; 531302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final SparseArray sListenerMap = new SparseArray(); 532302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sListenerMapLock = new Object(); 53388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 534302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static AsyncChannel sAsyncChannel; 535302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static CountDownLatch sConnected; 53688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 537302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static final Object sThreadRefLock = new Object(); 538cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static int sThreadRefCount; 539cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff private static HandlerThread sHandlerThread; 540cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 54688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @param context the application context 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 55188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public WifiManager(Context context, IWifiManager service) { 55288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mContext = context; 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 55488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff init(); 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 57359358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * of {@link WifiConfiguration} objects. Upon failure to fetch or 57459358536d2f14b27cdc7386daeabc2b6dca8e177Irfan Sheriff * when when Wi-Fi is turned off, it can be null. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 591227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 631227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.enableNetwork(netId, disableOthers); 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 702e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 703e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 717e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 718e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 732e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 733e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 760a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 762bcc97ca43a339c3356b5c8d9eaf1cbdfb0de3165Irfan Sheriff mService.startScan(); 763e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the results of the latest access point scan. 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the list of access points found in the most recent scan. 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7875e45ee6752528791deb66b83d76250685de15d47Dianne Hackborn return mService.getScanResults(mContext.getBasePackageName()); 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7941ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * Check if scanning is always available. 7951ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 7961ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * If this return {@code true}, apps can issue {@link #startScan} and fetch scan results 7971ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * even when Wi-Fi is turned off. 7981ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * 7991ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff * To change this setting, see {@link #ACTION_REQUEST_SCAN_ALWAYS_AVAILABLE}. 8001ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff */ 8017ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff public boolean isScanAlwaysAvailable() { 8021ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff try { 8037ea33eac4b57aabf9326d60f52e3ed85217ac846Irfan Sheriff return mService.isScanAlwaysAvailable(); 8041ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } catch (RemoteException e) { 8051ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff return false; 8061ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 8071ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff } 8081ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff 8091ef840cdc785d0e8a07e317cc1d7af42a0d0185dIrfan Sheriff /** 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 815227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 827ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 828ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 829ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 831ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 833ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 835ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 836ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 84036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 84136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 84236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 84336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 84436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 84536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 84636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 84736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 84836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 84936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 85036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 85136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 85236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 85336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 85436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 85536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 85636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 85736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 85836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 85936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 86036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 86136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 86236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 86336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 86436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 86536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 86636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 86736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 86836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 86936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 87036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 87136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 87236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 87336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 87436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 87536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 87636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 87736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 87836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 87936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 88036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 88136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 88236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 88336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 88436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 8884717c261b2c670d5c0925e3527a864aa52db6ac0Robert Greenwalt * @deprecated - use ConnectivityManager.getLinkProperties instead. TODO - remove 11/2013 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 9009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 9249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 926227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 928227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 9299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 935227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 937f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * Return TX packet counter, for CTS test of WiFi watchdog. 938f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param listener is the interface to receive result 939f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * 940f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @hide for CTS test only 941f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 942f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void getTxPacketCount(TxPacketCountListener listener) { 943f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng validateChannel(); 944302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(RSSI_PKTCNT_FETCH, 0, putListener(listener)); 945f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 946f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 947f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 9489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 9499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 950227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 9519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 9529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 9539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 9549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 9559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 9569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 9589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 9599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 9619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 9629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9634c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 9644c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 9654c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 9669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 968227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 9699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 971227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 9729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 9739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 9749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 9759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 9769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 9779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 9799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 9809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 9845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 9855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 9865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 9875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 9885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 9895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 9905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 9915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 9935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 9955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 996ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff mService.setWifiApEnabled(wifiConfig, enabled); 997ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff return true; 9985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 10005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 10015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 10025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 10035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 10045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 10055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 10065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 10075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 10085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 10095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 10105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 10115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 10125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 10135321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 10145321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 10155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 10165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 10175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 10185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 10195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 10205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 10215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 10225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 10235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 10245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 10255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 10265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 10275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 10285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 10295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 10305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 10315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 10329ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 10339ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 10349ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 10359ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 10369ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 10379ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 10389ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 10399ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 10409ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 10419ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 10429ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 10439ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 10449ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 10459ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 104617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 104717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 104817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 104917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 105017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 105117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 105217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 105317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 105417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 105517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 105617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 105717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 105817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 105917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 10600d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10610d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Start the driver and connect to network. 10620d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10630d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. For example, 10640d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * even if the device is idle or there is only a scan-only lock held, 10650d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a start wifi would mean that wifi connection is kept active until 10660d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a stopWifi() is sent. 10670d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10680d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 10690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10700d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean startWifi() { 10740d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10750d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.startWifi(); 10760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10780d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10790d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10830d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Disconnect from a network (if any) and stop the driver. 10840d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10850d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. Wi-Fi 10860d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * stays inactive until a startWifi() is issued. 10870d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10880d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 10890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10910d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10920d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10930d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean stopWifi() { 10940d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10950d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.stopWifi(); 10960d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10970d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10980d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10990d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11000d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11010d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 11020d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 11030d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 11040d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11050d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 11060d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11070d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 11080d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 11090d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 11100d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 11110d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 11120d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 11130d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 11140d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 11150d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 11160d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11170d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11180d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 11190d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 11200d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 11210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 11230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 11240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 11250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 11260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 11270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 11280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 11290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 11300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 11310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 11320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 11330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 11350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 113664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 113764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 113864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * Enable TDLS on a specific local route 113964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 114064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * This API is used by WiFi display, but eventually it can be made public, 114164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * just depends on how popular TDLS gets 114264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 114364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteIPAddress IP address of the endpoint to setup TDLS with 114464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 114564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @hide 114664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 114764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde public void enableTdls(InetAddress remoteIPAddress, boolean enable) { 114864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 114964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdls(remoteIPAddress.getHostAddress(), enable); 115064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 115164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 115264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 115364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 115464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 115564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde /** 115664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * Enable TDLS on a specific local route 115764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 115864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * This API is used by WiFi display, but eventually it can be made public, 115964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * just depends on how popular TDLS gets 116064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * 116164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param remoteMacAddress MAC address of the remote endpoint such as 00:00:0c:9f:f2:ab 116264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @param enable true = setup and false = tear down TDLS 116364f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde * @hide 116464f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde */ 116564f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde public void enableTdlsWithMacAddress(String remoteMacAddress, boolean enable) { 116664f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde try { 116764f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde mService.enableTdlsWithMacAddress(remoteMacAddress, enable); 116864f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } catch (RemoteException e) { 116964f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde // Just ignore the exception 117064f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 117164f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde } 117264f0d5ba158e9135bcd48d64a1c0db282a4628baVinit Deshapnde 1173e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1174ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1175d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private static final int BASE = Protocol.BASE_WIFI_MANAGER; 1176d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1177ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1178ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1179d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK = BASE + 1; 1180d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1181d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_FAILED = BASE + 2; 1182d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1183d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_SUCCEEDED = BASE + 3; 1184d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1185d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1186d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK = BASE + 4; 1187d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1188d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_FAILED = BASE + 5; 1189ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1190d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_SUCCEEDED = BASE + 6; 1191d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1192ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1193d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK = BASE + 7; 1194ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1195d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_FAILED = BASE + 8; 11968dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 1197d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_SUCCEEDED = BASE + 9; 1198ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1199ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1200d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS = BASE + 10; 1201d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1202d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS_SUCCEEDED = BASE + 11; 1203d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1204d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_FAILED = BASE + 12; 120586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 1206d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_COMPLETED = BASE + 13; 1207d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1208d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 120986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS = BASE + 14; 121086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 121186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_FAILED = BASE + 15; 121286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 121386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_SUCCEDED = BASE + 16; 121486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 121586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 121686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK = BASE + 17; 1217d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 121886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_FAILED = BASE + 18; 1219d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 122086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_SUCCEEDED = BASE + 19; 1221ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1222f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1223f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH = BASE + 20; 1224f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1225f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_SUCCEEDED = BASE + 21; 1226f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** @hide */ 1227f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public static final int RSSI_PKTCNT_FETCH_FAILED = BASE + 22; 1228f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1229d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1230d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1231d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1232d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed due to an internal error. 1233d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1234d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 123586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int ERROR = 0; 1236d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1237d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1238d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1239d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation is already in progress 1240d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1241d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 124286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int IN_PROGRESS = 1; 1243d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1244d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1245d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1246d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed because the framework is busy and 1247d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * unable to service the request 1248d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1249d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 125086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int BUSY = 2; 1251d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1252d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* WPS specific errors */ 1253d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS overlap detected {@hide} */ 125486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_OVERLAP_ERROR = 3; 125586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** WEP on WPS is prohibited {@hide} */ 125686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_WEP_PROHIBITED = 4; 125786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** TKIP only prohibited {@hide} */ 125886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TKIP_ONLY_PROHIBITED = 5; 125986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** Authentication failure on WPS {@hide} */ 126086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_AUTH_FAILURE = 6; 126186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** WPS timed out {@hide} */ 126286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TIMED_OUT = 7; 1263d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1264d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on an application action {@hide} */ 1265d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ActionListener { 1266d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** The operation succeeded */ 1267d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onSuccess(); 1268d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1269d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The operation failed 1270d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1271d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1272d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1273d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1274d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1275d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1276d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on a start WPS action {@hide} */ 1277d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface WpsListener { 1278d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS start succeeded */ 1279d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onStartSuccess(String pin); 1280d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1281d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS operation completed succesfully */ 1282d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onCompletion(); 1283d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1284d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1285d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * WPS operation failed 1286d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1287d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #IN_PROGRESS}, {@link #WPS_OVERLAP_ERROR},{@link #ERROR} or {@link #BUSY} 1288d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1289d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1290d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1291d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1292f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** Interface for callback invocation on a TX packet count poll action {@hide} */ 1293f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public interface TxPacketCountListener { 1294f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1295f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation succeeded 1296f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param count TX packet counter 1297f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1298f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onSuccess(int count); 1299f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng /** 1300f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * The operation failed 1301f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * @param reason The reason for failure could be one of 1302f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1303f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng */ 1304f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng public void onFailure(int reason); 1305f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1306f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng 1307302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static class ServiceHandler extends Handler { 130888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ServiceHandler(Looper looper) { 130988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff super(looper); 1310d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1311d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 131288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff @Override 131388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void handleMessage(Message message) { 131488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Object listener = removeListener(message.arg2); 131588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff switch (message.what) { 131688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_HALF_CONNECTED: 131788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (message.arg1 == AsyncChannel.STATUS_SUCCESSFUL) { 1318302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(AsyncChannel.CMD_CHANNEL_FULL_CONNECTION); 131988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } else { 132088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Failed to set up channel connection"); 132188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 132288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1323302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 132488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1325302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.countDown(); 132688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 132788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_FULLY_CONNECTED: 132888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // Ignore 132988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 133088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_DISCONNECTED: 133188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Channel connection lost"); 133288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 133388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 1334302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1335fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff getLooper().quit(); 133688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 133788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 133888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_FAILED: 133988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_FAILED: 134088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_FAILED: 134188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CANCEL_WPS_FAILED: 134288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_FAILED: 134388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 134488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onFailure(message.arg1); 134588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 134688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 134788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 134888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_SUCCEEDED: 134988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_SUCCEEDED: 135088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_SUCCEEDED: 135188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CANCEL_WPS_SUCCEDED: 135288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_SUCCEEDED: 135388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 135488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onSuccess(); 135588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 135688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 135788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.START_WPS_SUCCEEDED: 135888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 135988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff WpsResult result = (WpsResult) message.obj; 136088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onStartSuccess(result.pin); 136188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //Listener needs to stay until completion or failure 1362302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized(sListenerMapLock) { 1363302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(message.arg2, listener); 1364d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 136588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 136688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 136788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_COMPLETED: 136888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 136988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onCompletion(); 137088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 137188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 137288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_FAILED: 137388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 137488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onFailure(message.arg1); 137588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1376f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1377f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_SUCCEEDED: 1378f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1379f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng RssiPacketCountInfo info = (RssiPacketCountInfo) message.obj; 1380f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (info != null) 1381f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onSuccess(info.txgood + info.txbad); 1382f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng else 1383f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(ERROR); 1384f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 1385f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng break; 1386f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng case WifiManager.RSSI_PKTCNT_FETCH_FAILED: 1387f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng if (listener != null) { 1388f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng ((TxPacketCountListener) listener).onFailure(message.arg1); 1389f6307820c88e694e102824225b9d8caa6de75a30Yuhao Zheng } 139088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 139188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff default: 139288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //ignore 139388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 1394d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1395d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 139688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1397d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1398302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static int putListener(Object listener) { 139988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener == null) return INVALID_KEY; 140088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff int key; 1401302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 140288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff do { 1403302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff key = sListenerKey++; 140488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } while (key == INVALID_KEY); 1405302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.put(key, listener); 1406d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 140788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return key; 140888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1409d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1410302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff private static Object removeListener(int key) { 141188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (key == INVALID_KEY) return null; 1412302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff synchronized (sListenerMapLock) { 1413302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Object listener = sListenerMap.get(key); 1414302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sListenerMap.remove(key); 141588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return listener; 1416d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1417d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1418ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 141988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void init() { 1420cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 1421cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff if (++sThreadRefCount == 1) { 1422302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Messenger messenger = getWifiServiceMessenger(); 1423302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (messenger == null) { 1424302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = null; 1425302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff return; 1426302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1427302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1428cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread = new HandlerThread("WifiManager"); 1429302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel = new AsyncChannel(); 1430302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected = new CountDownLatch(1); 1431302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff 1432cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff sHandlerThread.start(); 1433302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Handler handler = new ServiceHandler(sHandlerThread.getLooper()); 1434302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.connect(mContext, handler, messenger); 1435302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff try { 1436302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sConnected.await(); 1437302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } catch (InterruptedException e) { 1438302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff Log.e(TAG, "interrupted wait at init"); 1439302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff } 1440cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1441cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 1442d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1443ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 144488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void validateChannel() { 1445302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (sAsyncChannel == null) throw new IllegalStateException( 144635bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff "No permission to access and change wifi or a bad initialization"); 144788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 144888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 1449e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1450e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 1451e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 1452e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1453e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1454e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 1455e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1456e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1457e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1458e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1459d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 146088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 146188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 146288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * 1463e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1464e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 146588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(WifiConfiguration config, ActionListener listener) { 1466d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 146788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1468ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // Use INVALID_NETWORK_ID for arg1 when passing a config object 1469ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // arg1 is used to pass network id when the network already exists 1470302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, WifiConfiguration.INVALID_NETWORK_ID, 147188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff putListener(listener), config); 1472e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1473e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1474e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1475e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 1476e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1477e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 1478e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1479e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1480e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 1481e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 1482d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 148388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 148488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1485e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1486e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 148788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(int networkId, ActionListener listener) { 1488d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (networkId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 148988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1490302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CONNECT_NETWORK, networkId, putListener(listener)); 1491e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1492e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1493e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1494e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 1495e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 1496e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 1497e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1498e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1499e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 1500e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1501e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 1502e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 1503e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1504e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1505e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1506d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 150788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 150888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1509e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1510e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 151188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void save(WifiConfiguration config, ActionListener listener) { 1512d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 151388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1514302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(SAVE_NETWORK, 0, putListener(listener), config); 1515e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1516e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1517e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1518e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 1519e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1520e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 1521e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 1522e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1523e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1524e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1525d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 152688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 152788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1528e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1529e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 153088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void forget(int netId, ActionListener listener) { 1531d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 153288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1533302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(FORGET_NETWORK, netId, putListener(listener)); 1534d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1535d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1536d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1537d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Disable network 1538d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 1539d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param netId is the network Id 1540d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 154188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 154288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1543d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1544d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 154588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void disable(int netId, ActionListener listener) { 1546d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 154788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1548302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(DISABLE_NETWORK, netId, putListener(listener)); 1549e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1550e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 155117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 155202fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 15535ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 155402fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * @param config WPS configuration 1555d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 155688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 155788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 15585ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 15595ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 156088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void startWps(WpsInfo config, WpsListener listener) { 1561d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 156288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1563302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(START_WPS, 0, putListener(listener), config); 1564f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1565f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 1566f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 156786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * Cancel any ongoing Wi-fi Protected Setup 156886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * 156986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @param listener for callbacks on success or failure. Can be null. 157088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 157188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 157286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @hide 157386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff */ 157488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void cancelWps(ActionListener listener) { 157588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1576302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.sendMessage(CANCEL_WPS, 0, putListener(listener)); 157786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff } 157886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 157986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** 1580227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 1581227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 1582227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1583227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 1584227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 1585227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 158607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiServiceMessenger() { 1587227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 158807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiServiceMessenger(); 1589227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 1590227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 159135bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff } catch (SecurityException e) { 159235bbe27d58ccf01ffd170b0f617a568bc843a49eIrfan Sheriff return null; 1593227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1594227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1595227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1596227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** 159707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * Get a reference to WifiStateMachine handler. 159807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @return Messenger pointing to the WifiService handler 159907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @hide 160007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff */ 160107573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiStateMachineMessenger() { 160207573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff try { 160307573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiStateMachineMessenger(); 160407573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } catch (RemoteException e) { 160507573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return null; 160607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 160707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 160807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 160907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff /** 16104aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 16114aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 16124aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 16134aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 16144aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 16154aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 16164aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 16174aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 16184aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 16194aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 16204aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 16214aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 1624227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 1627d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 16329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 1633d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 1637d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 1638d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 1639d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * permission in an {@code <uses-permission>} element of the application's manifest. 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 16487e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 16499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 16519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 1663227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 16722c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 16739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 16747e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 1675617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1676617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1677617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 1678617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1679617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1680617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1681617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1682617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 16869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 17019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1707617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1708617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1709617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 17229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 17249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 17259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 17269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 17279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 17289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 17309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 17329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 17339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 17379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 17399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 17419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 17429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 17439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17467e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 17477e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 17487e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 17497e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 17507e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17517e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 17527e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 17537e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 17547e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else if (mWorkSource == null) { 17557e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource != null; 17567e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = new WorkSource(ws); 17577e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 17587e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource.diff(ws); 17597e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed) { 17607e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource.set(ws); 17617e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17627e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17637e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 17647e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 17657e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 17667e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 17677e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17687e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17697e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17707e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 17717e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 17729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 17739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 17749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 17759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 17769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 17779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 17789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 17799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 17809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 17819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 17839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 17869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 17879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 17889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 17899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 17909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 17919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 17929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1793617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1794617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1795617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 17969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 17979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 18039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 18059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18065876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 1807652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 1808652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 1809652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 1810652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 18119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 18129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 18139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 18159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 18179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 18199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 18209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1821652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 18229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 18239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 18249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 18269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 18279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 18289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 18299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 18319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 18329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 18339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 18349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 18359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 18369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 18375347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 1838fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 18395347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1840fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 18415347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1842fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 184341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 184441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 184541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 184641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 18475347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1848fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 1849fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1850fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 18515347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1852fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 1853fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 18545347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 18555347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 18565347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1857fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 1858fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 1859fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 1860fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 1861fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 186241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 18635347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1864fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 1865fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 1866fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 186741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 186841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 1869fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 1870fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1871fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 1872fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 1873fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 187441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 187541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 1876fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 1877fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1878fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1879fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1880fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 1881fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 188241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 188341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 188441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 188541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 188641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 188741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 188841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 188941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 189041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 189141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 1892fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1893fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 1894fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 1895fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1896fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 1897fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 1898fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1899fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 1900fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 19012c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 1902fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1903fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 1904617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1905617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1906617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 1907617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1908617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1909617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1910617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1911617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1912fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1913fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 191441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 1915fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1916fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1917fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1918fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1919fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1920fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 1921fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 1922fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 192341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 192441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 192541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 192641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 192741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 192841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 192941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 193041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 193141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 19324a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 193341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 193441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 1935fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 1936fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 1937fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 1938fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 1939fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1940fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 1941fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 1942fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1943fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 1944fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 194541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 1946fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1947fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 1948617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1949617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1950617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1951fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1952fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 195341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 195441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 195541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 195641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 195741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 1958fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1959fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1960fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1961fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1962fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 196341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 196441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 196541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 196641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 196741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 196841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 196941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 197041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 197141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 197241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 197341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 197441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 197541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 197641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 197741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 197841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 197941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 198041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 198141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 1982fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 1983fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1984fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 1985fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1986fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 1987fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1988fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 1989fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1990fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1991fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1992fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 199341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 1994fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1995fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 1996fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 199741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 199841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 199941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 200041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 200141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 200241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 2003fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2004fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 2005fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 2006fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 2007fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 2008fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 200941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 2010fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 20115347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 20125347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 20135347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 20145347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 2015fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 20165347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 2017fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 20185347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 20195347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 20205347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 2021fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 20225347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 2023fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 20245347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 20255347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 20265347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 20275347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 2028e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 2029e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 2030e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 2031e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 2032e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 2033e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 2034e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 2035e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 2036e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 2037e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 2038e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 2039e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2040e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 2041da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff 2042da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff /** @hide */ 2043da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff public void captivePortalCheckComplete() { 2044da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff try { 2045da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff mService.captivePortalCheckComplete(); 2046da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff } catch (RemoteException e) {} 2047da6da0907b28d4704aabbdb1bbeb4300954670d1Irfan Sheriff } 2048fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff 2049fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff protected void finalize() throws Throwable { 2050fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff try { 2051cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff synchronized (sThreadRefLock) { 2052302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff if (--sThreadRefCount == 0 && sAsyncChannel != null) { 2053302b06de7ea7ac97ac4a2189213a1133220bfdc8Irfan Sheriff sAsyncChannel.disconnect(); 2054cd3d75f35db669f9671d251a36b51cef8a7ca009Irfan Sheriff } 2055939caef712f306a1c80ea27e9f41ef6e3ea9e0f1Irfan Sheriff } 2056fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } finally { 2057fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff super.finalize(); 2058fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 2059fa3b6258bedf6a66b676020f0ff531d4c9c579ebIrfan Sheriff } 2060651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 2061