WifiManager.java revision 88759bbd31e05a4163e1f8e72804ca83000afd53
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 3588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriffimport java.util.concurrent.CountDownLatch; 3688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 37ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport com.android.internal.util.AsyncChannel; 38d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport com.android.internal.util.Protocol; 39ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final String TAG = "WifiManager"; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 76227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 87227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 97227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 101227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 105227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 112227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 120227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 127227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 135227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_UNKNOWN = 4; 1405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 1565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 1575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 1585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 1595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 1605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 1645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 1665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 1685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 1725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 1745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 1755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 181a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 1825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 190a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 1915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 200a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 209a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2135321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2145321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 219a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 2423550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 2433550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 2443550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 2483550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2663550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 2673550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 2683550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 2693550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 2703550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 2713550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 2723550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 299fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 300fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 301be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 3021b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * This can be as a result of adding/updating/deleting a network. If 3031b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is set to true the new configuration 3041b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * can be retreived with the {@link #EXTRA_WIFI_CONFIGURATION} extra. If multiple 3051b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Wi-Fi configurations changed, {@link #EXTRA_WIFI_CONFIGURATION} will not be present. 306e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 307e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 308be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 309be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3111b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for a (@link android.net.wifi.WifiConfiguration} object representing 3121b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * the changed Wi-Fi configuration when the {@link #CONFIGURED_NETWORKS_CHANGED_ACTION} 3131b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * broadcast is sent. 3141b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3151b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3161b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_WIFI_CONFIGURATION = "wifiConfiguration"; 3171b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3181b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * Multiple network configurations have changed. 3191b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3201b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * 3211b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3221b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3231b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_MULTIPLE_NETWORKS_CHANGED = "multipleChanges"; 3241b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3251b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The lookup key for an integer indicating the reason a Wi-Fi network configuration 3261b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * has changed. Only present if {@link #EXTRA_MULTIPLE_NETWORKS_CHANGED} is {@code false} 3271b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @see #CONFIGURED_NETWORKS_CHANGED_ACTION 3281b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3291b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3301b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final String EXTRA_CHANGE_REASON = "changeReason"; 3311b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3321b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration is new and was added. 3331b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3341b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3351b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_ADDED = 0; 3361b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3371b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration was removed and is no longer present in the system's list of 3381b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * configured networks. 3391b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3401b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3411b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_REMOVED = 1; 3421b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3431b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * The configuration has changed as a result of explicit action or because the system 3441b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * took an automated action such as disabling a malfunctioning configuration. 3451b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood * @hide 3461b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood */ 3471b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood public static final int CHANGE_REASON_CONFIG_CHANGE = 2; 3481b6989cdc212aec7579489a362f99b791abe7352Mike Lockwood /** 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call {@link #getScanResults()} to obtain the results. 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 366be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 3670d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 3680d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 370be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 371be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 372f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 3730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 37437e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 3750d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 3760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 3770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3780d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 37937e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 3800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 3810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 382f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * The lookup key for a {@link android.net.LinkCapabilities} object associated with the 383f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 384f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 385f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 386f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 387f61101f6266be243c481d163b95e65d67b8d1669Wink Saville public static final String EXTRA_LINK_CAPABILITIES = "linkCapabilities"; 388f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 389f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 3909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 3919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 39437e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 4019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 4029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 40499001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 4059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 4069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 41299001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 421652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 422652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 423652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 424652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 425652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 426652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 427652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 428652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 429652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 430652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 431652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 432652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 433652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 434652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 435652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 436652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 437652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 438652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 439652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 443652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 44636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 44736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 448ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 449ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 450ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 451ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 452ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 453ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 454ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 45536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 45636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 45736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 45836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 45936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 46036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 46136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 46236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 46336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 46436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 46536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 46636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 46736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 46836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 46936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 47036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 47136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 47236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 473227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 474227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 475227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 476227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 477227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 478227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 479227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 480227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 481227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 482227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 483227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 484227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 485227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 486227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 487227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 488227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 489617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 490617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 491617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 492617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 493617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 494617750604c69e6068f68266d0e30324273aa990eMike Lockwood 495617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 496617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 497617750604c69e6068f68266d0e30324273aa990eMike Lockwood 49888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Context mContext; 49988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff IWifiManager mService; 50088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 50188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private static final int INVALID_KEY = 0; 50288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private int mListenerKey = 1; 50388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private final SparseArray mListenerMap = new SparseArray(); 50488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private final Object mListenerMapLock = new Object(); 50588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 50688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private AsyncChannel mAsyncChannel = new AsyncChannel(); 50788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private ServiceHandler mHandler; 50888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Messenger mWifiServiceMessenger; 50988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private final CountDownLatch mConnected = new CountDownLatch(1); 51088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 51688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @param context the application context 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 52188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public WifiManager(Context context, IWifiManager service) { 52288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mContext = context; 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 52488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff init(); 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of {@link WifiConfiguration} objects. 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 560227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 600227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.enableNetwork(netId, disableOthers); 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 671e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 672e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 686e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 687e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 701e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 702e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 729a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 731e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(false); 732e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 733a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } catch (RemoteException e) { 734a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood return false; 735a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 736a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 737a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood 738a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood /** 739a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * Request a scan for access points. Returns immediately. The availability 740a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * of the results is made known later by means of an asynchronous event sent 741a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * on completion of the scan. 742a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * This is a variant of startScan that forces an active scan, even if passive 743a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * scans are the current default 744a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @return {@code true} if the operation succeeded, i.e., the scan was initiated 745a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * 746a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @hide 747a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood */ 748a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScanActive() { 749a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood try { 750e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(true); 751e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 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 the results of the latest access point scan. 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the list of access points found in the most recent scan. 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getScanResults(); 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 * Tell the supplicant to persist the current list of configured networks. 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 787227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 799ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 800ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 801ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 803ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 805ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 807ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 808ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 81236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 81336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 81436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 81536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 81636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 81736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 81836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 81936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 82036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 82136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 82236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 82336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 82436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 82536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 82636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 82736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 82836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 82936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 83036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 83136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 83236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 83336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 83436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 83536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 83636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 83736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 83836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 83936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 84036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 84136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 84236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 84336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 84436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 84536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 84636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 84736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 84836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 84936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 85036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 85136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 85236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 85336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 85436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 85536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 85636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 8969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 898227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 900227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 9039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 907227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 911227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 9159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 9169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 9179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 9199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 9209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 9219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 9229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 9239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 9244c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 9254c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 9264c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 9279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 929227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 9309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 932227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 9339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 9349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 9359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 9369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 9379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 9389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 9409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 9419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 9455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 9465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 9475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 9485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 9495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 9505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 9515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 9525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 9545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 9565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 957ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff mService.setWifiApEnabled(wifiConfig, enabled); 958ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff return true; 9595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 9615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 9665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 9675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 9685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 9695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 9705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 9725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 9745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 9755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 9765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 9785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9815321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 9835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 9845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 9855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 9875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 9895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 9905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9939ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 9949ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 9959ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 9969ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 9979ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 9989ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 9999ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 10009ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 10019ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 10029ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 10039ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 10049ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 10059ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 10069ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 100717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 100817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 100917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 101017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 101117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 101217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 101317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 101417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 101517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 101617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 101717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 101817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 101917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 102017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 10210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Start the driver and connect to network. 10230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. For example, 10250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * even if the device is idle or there is only a scan-only lock held, 10260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a start wifi would mean that wifi connection is kept active until 10270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a stopWifi() is sent. 10280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 10300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean startWifi() { 10350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.startWifi(); 10370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10400d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10420d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10440d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Disconnect from a network (if any) and stop the driver. 10450d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10460d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. Wi-Fi 10470d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * stays inactive until a startWifi() is issued. 10480d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10490d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 10500d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10510d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10520d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10530d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10540d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean stopWifi() { 10550d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10560d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.stopWifi(); 10570d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10580d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10590d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10600d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10610d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10620d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10630d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10640d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 10650d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10660d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 10670d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10680d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10700d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 10720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 10740d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10750d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10780d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10790d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 10820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10830d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 10840d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10850d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10860d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10870d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10880d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 10890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 10910d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10920d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10930d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10940d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10950d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10960d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 1097e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1098ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1099d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private static final int BASE = Protocol.BASE_WIFI_MANAGER; 1100d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1101ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1102ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1103d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK = BASE + 1; 1104d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1105d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_FAILED = BASE + 2; 1106d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1107d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_SUCCEEDED = BASE + 3; 1108d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1109d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1110d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK = BASE + 4; 1111d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1112d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_FAILED = BASE + 5; 1113ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1114d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_SUCCEEDED = BASE + 6; 1115d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1116ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1117d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK = BASE + 7; 1118ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1119d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_FAILED = BASE + 8; 11208dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 1121d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_SUCCEEDED = BASE + 9; 1122ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1123ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1124d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS = BASE + 10; 1125d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1126d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS_SUCCEEDED = BASE + 11; 1127d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1128d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_FAILED = BASE + 12; 112986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 1130d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_COMPLETED = BASE + 13; 1131d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1132d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 113386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS = BASE + 14; 113486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 113586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_FAILED = BASE + 15; 113686a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 113786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int CANCEL_WPS_SUCCEDED = BASE + 16; 113886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 113986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** @hide */ 114086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK = BASE + 17; 1141d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 114286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_FAILED = BASE + 18; 1143d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 114486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int DISABLE_NETWORK_SUCCEEDED = BASE + 19; 1145ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1146ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* For system use only */ 1147ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1148d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int ENABLE_TRAFFIC_STATS_POLL = BASE + 21; 1149ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1150d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int TRAFFIC_STATS_POLL = BASE + 22; 1151d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1152d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1153d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1154d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1155d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed due to an internal error. 1156d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1157d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 115886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int ERROR = 0; 1159d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1160d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1161d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1162d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation is already in progress 1163d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1164d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 116586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int IN_PROGRESS = 1; 1166d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1167d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1168d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1169d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed because the framework is busy and 1170d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * unable to service the request 1171d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1172d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 117386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int BUSY = 2; 1174d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1175d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* WPS specific errors */ 1176d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS overlap detected {@hide} */ 117786a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_OVERLAP_ERROR = 3; 117886a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** WEP on WPS is prohibited {@hide} */ 117986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_WEP_PROHIBITED = 4; 118086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** TKIP only prohibited {@hide} */ 118186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TKIP_ONLY_PROHIBITED = 5; 118286a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** Authentication failure on WPS {@hide} */ 118386a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_AUTH_FAILURE = 6; 118486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** WPS timed out {@hide} */ 118586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff public static final int WPS_TIMED_OUT = 7; 1186d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1187d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on an application action {@hide} */ 1188d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ActionListener { 1189d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** The operation succeeded */ 1190d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onSuccess(); 1191d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1192d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The operation failed 1193d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1194d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1195d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1196d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1197d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1198d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1199d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on a start WPS action {@hide} */ 1200d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface WpsListener { 1201d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS start succeeded */ 1202d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onStartSuccess(String pin); 1203d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1204d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS operation completed succesfully */ 1205d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onCompletion(); 1206d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1207d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1208d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * WPS operation failed 1209d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1210d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #IN_PROGRESS}, {@link #WPS_OVERLAP_ERROR},{@link #ERROR} or {@link #BUSY} 1211d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1212d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1213d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1214d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 121588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private class ServiceHandler extends Handler { 121688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ServiceHandler(Looper looper) { 121788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff super(looper); 1218d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1219d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 122088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff @Override 122188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void handleMessage(Message message) { 122288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Object listener = removeListener(message.arg2); 122388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff switch (message.what) { 122488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_HALF_CONNECTED: 122588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (message.arg1 == AsyncChannel.STATUS_SUCCESSFUL) { 122688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(AsyncChannel.CMD_CHANNEL_FULL_CONNECTION); 122788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } else { 122888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Failed to set up channel connection"); 122988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 123088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 123188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel = null; 123288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 123388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mConnected.countDown(); 123488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 123588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_FULLY_CONNECTED: 123688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // Ignore 123788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 123888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case AsyncChannel.CMD_CHANNEL_DISCONNECTED: 123988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "Channel connection lost"); 124088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // This will cause all further async API calls on the WifiManager 124188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff // to fail and throw an exception 124288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel = null; 124388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 124488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 124588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_FAILED: 124688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_FAILED: 124788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_FAILED: 124888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CANCEL_WPS_FAILED: 124988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_FAILED: 125088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 125188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onFailure(message.arg1); 125288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 125388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 125488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff /* ActionListeners grouped together */ 125588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CONNECT_NETWORK_SUCCEEDED: 125688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.FORGET_NETWORK_SUCCEEDED: 125788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.SAVE_NETWORK_SUCCEEDED: 125888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.CANCEL_WPS_SUCCEDED: 125988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.DISABLE_NETWORK_SUCCEEDED: 126088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 126188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((ActionListener) listener).onSuccess(); 126288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 126388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 126488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.START_WPS_SUCCEEDED: 126588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 126688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff WpsResult result = (WpsResult) message.obj; 126788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onStartSuccess(result.pin); 126888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //Listener needs to stay until completion or failure 126988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff synchronized(mListenerMapLock) { 127088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mListenerMap.put(message.arg2, listener); 1271d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 127288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 127388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 127488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_COMPLETED: 127588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 127688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onCompletion(); 127788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 127888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 127988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff case WifiManager.WPS_FAILED: 128088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener != null) { 128188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff ((WpsListener) listener).onFailure(message.arg1); 128288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 128388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 128488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff default: 128588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff //ignore 128688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff break; 1287d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1288d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 128988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1290d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 129188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private int putListener(Object listener) { 129288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (listener == null) return INVALID_KEY; 129388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff int key; 129488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff synchronized (mListenerMapLock) { 129588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff do { 129688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff key = mListenerKey++; 129788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } while (key == INVALID_KEY); 129888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mListenerMap.put(key, listener); 1299d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 130088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return key; 130188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 1302d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 130388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private Object removeListener(int key) { 130488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (key == INVALID_KEY) return null; 130588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff synchronized (mListenerMapLock) { 130688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Object listener = mListenerMap.get(key); 130788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mListenerMap.remove(key); 130888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff return listener; 1309d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1310d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1311ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 131288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void init() { 131388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mWifiServiceMessenger = getWifiServiceMessenger(); 131488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (mWifiServiceMessenger == null) throw new RuntimeException("Failed to initialize"); 131588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff HandlerThread t = new HandlerThread("WifiManager"); 131688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff t.start(); 131788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mHandler = new ServiceHandler(t.getLooper()); 131888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.connect(mContext, mHandler, mWifiServiceMessenger); 131988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff try { 132088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mConnected.await(); 132188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } catch (InterruptedException e) { 132288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff Log.e(TAG, "interrupted wait at init"); 1323d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1324d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1325ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 132688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff private void validateChannel() { 132788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff if (mAsyncChannel == null) throw new IllegalStateException( 132888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff "Bad WifiManager instance state, re-initialize"); 132988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff } 133088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff 1331e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1332e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 1333e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 1334e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1335e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1336e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 1337e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1338e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1339e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1340e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1341d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 134288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 134388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 134488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * 1345e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1346e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 134788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(WifiConfiguration config, ActionListener listener) { 1348d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 134988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 1350ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // Use INVALID_NETWORK_ID for arg1 when passing a config object 1351ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // arg1 is used to pass network id when the network already exists 135288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(CONNECT_NETWORK, WifiConfiguration.INVALID_NETWORK_ID, 135388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff putListener(listener), config); 1354e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1355e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1356e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1357e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 1358e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1359e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 1360e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1361e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1362e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 1363e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 1364d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 136588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 136688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1367e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1368e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 136988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void connect(int networkId, ActionListener listener) { 1370d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (networkId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 137188759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 137288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(CONNECT_NETWORK, networkId, putListener(listener)); 1373e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1374e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1375e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1376e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 1377e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 1378e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 1379e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1380e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1381e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 1382e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1383e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 1384e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 1385e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1386e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1387e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1388d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 138988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 139088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1391e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1392e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 139388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void save(WifiConfiguration config, ActionListener listener) { 1394d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 139588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 139688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(SAVE_NETWORK, 0, putListener(listener), config); 1397e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1398e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1399e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1400e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 1401e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1402e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 1403e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 1404e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1405e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1406e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1407d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 140888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 140988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1410e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1411e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 141288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void forget(int netId, ActionListener listener) { 1413d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 141488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 141588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(FORGET_NETWORK, netId, putListener(listener)); 1416d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1417d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1418d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1419d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Disable network 1420d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 1421d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param netId is the network Id 1422d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 142388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 142488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 1425d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1426d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 142788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void disable(int netId, ActionListener listener) { 1428d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 142988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 143088759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(DISABLE_NETWORK, netId, putListener(listener)); 1431e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1432e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 143317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 143402fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 14355ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 143602fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * @param config WPS configuration 1437d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 143888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 143988759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 14405ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 14415ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 144288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void startWps(WpsInfo config, WpsListener listener) { 1443d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 144488759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 144588759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(START_WPS, 0, putListener(listener), config); 1446f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1447f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 1448f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 144986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * Cancel any ongoing Wi-fi Protected Setup 145086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * 145186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @param listener for callbacks on success or failure. Can be null. 145288759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * @throws IllegalStateException if the WifiManager instance needs to be 145388759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff * initialized again 145486a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff * @hide 145586a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff */ 145688759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff public void cancelWps(ActionListener listener) { 145788759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff validateChannel(); 145888759bbd31e05a4163e1f8e72804ca83000afd53Irfan Sheriff mAsyncChannel.sendMessage(CANCEL_WPS, 0, putListener(listener)); 145986a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff } 146086a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff 146186a5f5b9afa97a4ed6f5a2466fb9359ea131e2fbIrfan Sheriff /** 1462227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 1463227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 1464227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1465227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 1466227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 1467227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 146807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiServiceMessenger() { 1469227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 147007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiServiceMessenger(); 1471227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 1472227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 1473227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1474227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1475227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1476227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** 147707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * Get a reference to WifiStateMachine handler. 147807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @return Messenger pointing to the WifiService handler 147907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @hide 148007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff */ 148107573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiStateMachineMessenger() { 148207573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff try { 148307573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiStateMachineMessenger(); 148407573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } catch (RemoteException e) { 148507573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return null; 148607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 148707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 148807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 148907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff /** 14904aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 14914aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 14924aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 14934aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 14944aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 14954aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 14964aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 14974aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 14984aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 14994aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 15004aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 15014aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 1504227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 1507d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 1513d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 1517d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 1518d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 1519d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * permission in an {@code <uses-permission>} element of the application's manifest. 15209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 15287e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 1543227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 15522c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15547e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 1555617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1556617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1557617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 1558617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1559617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1560617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1561617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1562617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 15639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 15649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 15669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 15729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 15749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 15759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 15769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 15779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 15799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 15809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 15819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1587617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1588617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1589617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 16049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 16059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 16069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 16179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 16199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 16219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16267e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 16277e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 16287e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 16297e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 16307e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16317e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 16327e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 16337e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 16347e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else if (mWorkSource == null) { 16357e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource != null; 16367e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = new WorkSource(ws); 16377e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 16387e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource.diff(ws); 16397e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed) { 16407e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource.set(ws); 16417e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16427e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16437e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 16447e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 16457e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 16467e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 16477e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16487e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16497e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16507e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 16517e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 16529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 16539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 16549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 16559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 16569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 16579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 16589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 16599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 16609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 16619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 16639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 16679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 16689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 16699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 16709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 16719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 16729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1673617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1674617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1675617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 16769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 16779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 16859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16865876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 1687652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 1688652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 1689652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 1690652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 16919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 16929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 16939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 16959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 16979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 16999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 17009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1701652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 17029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 17039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 17049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 17069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 17079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 17089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 17099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 17119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 17129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 17139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 17149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 17159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 17169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 17175347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 1718fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 17195347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1720fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 17215347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1722fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 172341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 172441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 172541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 172641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 17275347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1728fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 1729fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1730fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 17315347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1732fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 1733fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 17345347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 17355347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 17365347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1737fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 1738fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 1739fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 1740fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 1741fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 174241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 17435347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1744fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 1745fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 1746fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 174741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 174841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 1749fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 1750fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1751fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 1752fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 1753fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 175441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 175541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 1756fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 1757fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1758fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1759fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1760fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 1761fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 176241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 176341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 176441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 176541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 176641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 176741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 176841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 176941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 177041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 177141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 1772fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1773fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 1774fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 1775fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1776fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 1777fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 1778fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1779fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 1780fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 17812c02da2bc62c4dfef684ea381be02a4e568b73d0Irfan Sheriff if (mRefCounted ? (++mRefCount == 1) : (!mHeld)) { 1782fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1783fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 1784617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1785617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1786617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 1787617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1788617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1789617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1790617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1791617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1792fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1793fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 179441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 1795fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1796fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1797fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1798fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1799fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1800fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 1801fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 1802fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 180341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 180441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 180541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 180641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 180741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 180841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 180941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 181041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 181141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 18124a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 181341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 181441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 1815fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 1816fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 1817fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 1818fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 1819fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1820fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 1821fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 1822fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1823fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 1824fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 182541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 1826fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1827fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 1828617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1829617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1830617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1831fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1832fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 183341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 183441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 183541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 183641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 183741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 1838fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1839fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1840fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1841fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1842fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 184341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 184441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 184541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 184641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 184741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 184841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 184941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 185041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 185141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 185241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 185341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 185441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 185541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 185641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 185741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 185841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 185941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 186041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 186141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 1862fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 1863fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1864fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 1865fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1866fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 1867fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1868fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 1869fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1870fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1871fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1872fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 187341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 1874fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1875fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 1876fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 187741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 187841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 187941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 188041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 188141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 188241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 1883fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1884fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1885fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1886fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 1887fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 1888fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 188941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 1890fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 18915347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 18925347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 18935347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 18945347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1895fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 18965347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1897fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 18985347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 18995347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 19005347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1901fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 19025347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 1903fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 19045347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 19055347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 19065347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 19075347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 1908e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 1909e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 1910e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 1911e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 1912e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 1913e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 1914e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 1915e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 1916e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 1917e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 1918e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 1919e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1920e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1921651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 1922