WifiManager.java revision ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bd
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; 26d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.os.Looper; 27d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.os.Message; 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 297e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackbornimport android.os.WorkSource; 30227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriffimport android.os.Messenger; 31d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport android.util.SparseArray; 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 33ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport com.android.internal.util.AsyncChannel; 34d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriffimport com.android.internal.util.Protocol; 35ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 71227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 82227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 92227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 96227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 100227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 107227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 115227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 122227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 130227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_UNKNOWN = 4; 1355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 1515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 1525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 1535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 1545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 1555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 1595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 1615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 1635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 1675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 1695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 1705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 176a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 1775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 1795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1815321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 1825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 185a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 1885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 195a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 204a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2135321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 214a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 2373550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 2383550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 2393550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 2433550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2613550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 2623550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 2633550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 2643550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 2653550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 2663550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 2673550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 294fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 295fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 296be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 297e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This can be as a result of adding/updating/deleting a network 298e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 299e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 300be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 301be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 3049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call {@link #getScanResults()} to obtain the results. 3059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 3089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 3109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 3119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 3149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 320be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 3210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 3220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 324be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 325be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 326f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 3270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 32837e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 3290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 3300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 3310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 33337e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 3340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 3350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 336f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * The lookup key for a {@link android.net.LinkCapabilities} object associated with the 337f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 338f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 339f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 340f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 341f61101f6266be243c481d163b95e65d67b8d1669Wink Saville public static final String EXTRA_LINK_CAPABILITIES = "linkCapabilities"; 342f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 343f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 3449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 3459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 34837e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 3499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 3519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 3529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 35899001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 36699001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 375652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 376652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 377652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 378652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 379652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 380652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 381652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 382652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 383652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 384652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 385652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 386652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 387652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 388652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 389652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 390652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 391652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 392652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 393652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 3949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 397652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 3989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 3999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 40036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 40136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 402ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 403ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 404ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 405ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 406ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 407ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 408ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 40936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 41036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 41136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 41236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 41336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 41436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 41536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 41636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 41736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 41836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 41936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 42036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 42136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 42236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 42336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 42436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 42536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 42636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 427227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 428227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 429227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 430227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 431227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 432227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 433227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 434227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 435227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 436227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 437227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 438227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 439227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 440227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 441227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 442227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IWifiManager mService; 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Handler mHandler; 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 446617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 447617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 448617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 449617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 450617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 451617750604c69e6068f68266d0e30324273aa990eMike Lockwood 452617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 453617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 454617750604c69e6068f68266d0e30324273aa990eMike Lockwood 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler target for messages 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiManager(IWifiManager service, Handler handler) { 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of {@link WifiConfiguration} objects. 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 503227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 543227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.enableNetwork(netId, disableOthers); 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 614e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 615e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 6289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 629e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 630e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 6439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 644e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 645e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 672a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 674e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(false); 675e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 676a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } catch (RemoteException e) { 677a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood return false; 678a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 679a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 680a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood 681a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood /** 682a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * Request a scan for access points. Returns immediately. The availability 683a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * of the results is made known later by means of an asynchronous event sent 684a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * on completion of the scan. 685a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * This is a variant of startScan that forces an active scan, even if passive 686a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * scans are the current default 687a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @return {@code true} if the operation succeeded, i.e., the scan was initiated 688a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * 689a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @hide 690a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood */ 691a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScanActive() { 692a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood try { 693e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(true); 694e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 7029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 7039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 7079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the results of the latest access point scan. 7149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the list of access points found in the most recent scan. 7159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 7179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getScanResults(); 7199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 730227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 742ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 743ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 744ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 746ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 748ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 750ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 751ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 75536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 75636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 75736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 75836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 75936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 76036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 76136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 76236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 76336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 76436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 76536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 76636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 76736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 76836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 76936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 77036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 77136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 77236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 77336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 77436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 77536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 77636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 77736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 77836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 77936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 78036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 78136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 78236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 78336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 78436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 78536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 78636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 78736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 78836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 78936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 79036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 79136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 79236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 79336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 79436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 79536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 79636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 79736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 79836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 79936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 8209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 841227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 843227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 850227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 854227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8674c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 8684c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 8694c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 872227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 875227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 8789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 8885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 8895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 8905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 8915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 8925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 8935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 8945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 8955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 8965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 8975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 8985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 8995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 900ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff mService.setWifiApEnabled(wifiConfig, enabled); 901ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff return true; 9025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 9045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 9095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 9105321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 9115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 9125321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 9135321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9145321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 9155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 9175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 9185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 9195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 9215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 9265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 9275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 9285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 9305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 9325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 9335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9369ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 9379ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 9389ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 9399ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 9409ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 9419ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 9429ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 9439ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 9449ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 9459ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 9469ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 9479ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 9489ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 9499ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 95017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 95117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 95217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 95317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 95417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 95517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 95617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 95717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 95817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 95917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 96017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 96117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 96217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 96317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 9640d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9650d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Start the driver and connect to network. 9660d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9670d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. For example, 9680d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * even if the device is idle or there is only a scan-only lock held, 9690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a start wifi would mean that wifi connection is kept active until 9700d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a stopWifi() is sent. 9710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 9730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9740d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 9750d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 9760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 9770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean startWifi() { 9780d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 9790d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.startWifi(); 9800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 9810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 9820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 9830d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9840d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9850d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 9860d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9870d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Disconnect from a network (if any) and stop the driver. 9880d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. Wi-Fi 9900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * stays inactive until a startWifi() is issued. 9910d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9920d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 9930d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9940d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 9950d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 9960d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 9970d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean stopWifi() { 9980d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 9990d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.stopWifi(); 10000d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10010d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10020d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10030d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10040d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10050d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10060d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10070d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 10080d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10090d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 10100d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10110d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10120d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10130d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10140d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 10150d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10160d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 10170d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10180d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10190d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10200d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 10250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 10270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 10320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 10340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 1040e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1041ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1042d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private static final int BASE = Protocol.BASE_WIFI_MANAGER; 1043d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1044ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1045ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1046d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK = BASE + 1; 1047d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1048d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_FAILED = BASE + 2; 1049d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1050d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int CONNECT_NETWORK_SUCCEEDED = BASE + 3; 1051d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1052d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1053d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK = BASE + 4; 1054d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1055d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_FAILED = BASE + 5; 1056ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1057d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int FORGET_NETWORK_SUCCEEDED = BASE + 6; 1058d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1059ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1060d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK = BASE + 7; 1061ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1062d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_FAILED = BASE + 8; 10638dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 1064d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int SAVE_NETWORK_SUCCEEDED = BASE + 9; 1065ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1066ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1067d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS = BASE + 10; 1068d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1069d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int START_WPS_SUCCEEDED = BASE + 11; 1070d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1071d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_FAILED = BASE + 12; 1072d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1073d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_COMPLETED = BASE + 13; 1074d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1075d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1076d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int DISABLE_NETWORK = BASE + 14; 1077d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1078d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int DISABLE_NETWORK_FAILED = BASE + 15; 1079d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** @hide */ 1080d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int DISABLE_NETWORK_SUCCEEDED = BASE + 16; 1081ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1082ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* For system use only */ 1083ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1084d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int ENABLE_TRAFFIC_STATS_POLL = BASE + 21; 1085ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1086d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int TRAFFIC_STATS_POLL = BASE + 22; 1087d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1088d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1089d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1090d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1091d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed due to an internal error. 1092d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1093d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1094d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int ERROR = 0; 1095d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1096d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1097d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1098d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation is already in progress 1099d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1100d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1101d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int IN_PROGRESS = 1; 1102d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1103d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1104d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Passed with {@link ActionListener#onFailure}. 1105d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Indicates that the operation failed because the framework is busy and 1106d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * unable to service the request 1107d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1108d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1109d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int BUSY = 2; 1110d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1111d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* WPS specific errors */ 1112d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS overlap detected {@hide} */ 1113d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static final int WPS_OVERLAP_ERROR = 3; 1114d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1115d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation when framework channel is lost {@hide} */ 1116d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ChannelListener { 1117d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1118d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The channel to the framework has been disconnected. 1119d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Application could try re-initializing using {@link #initialize} 1120d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1121d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onChannelDisconnected(); 1122d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1123d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1124d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on an application action {@hide} */ 1125d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface ActionListener { 1126d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** The operation succeeded */ 1127d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onSuccess(); 1128d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1129d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * The operation failed 1130d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1131d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #ERROR}, {@link #IN_PROGRESS} or {@link #BUSY} 1132d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1133d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1134d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1135d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1136d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** Interface for callback invocation on a start WPS action {@hide} */ 1137d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public interface WpsListener { 1138d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS start succeeded */ 1139d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onStartSuccess(String pin); 1140d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1141d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** WPS operation completed succesfully */ 1142d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onCompletion(); 1143d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1144d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1145d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * WPS operation failed 1146d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param reason The reason for failure could be one of 1147d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * {@link #IN_PROGRESS}, {@link #WPS_OVERLAP_ERROR},{@link #ERROR} or {@link #BUSY} 1148d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1149d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void onFailure(int reason); 1150d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1151d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1152d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1153d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * A channel that connects the application to the Wifi framework. 1154d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Most operations require a Channel as an argument. An instance of Channel is obtained 1155d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * by doing a call on {@link #initialize} 1156d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1157d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1158d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public static class Channel { 1159d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff Channel(Looper looper, ChannelListener l) { 1160d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mAsyncChannel = new AsyncChannel(); 1161d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mHandler = new WifiHandler(looper); 1162d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mChannelListener = l; 1163d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1164d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private ChannelListener mChannelListener; 1165d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private SparseArray<Object> mListenerMap = new SparseArray<Object>(); 1166d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private Object mListenerMapLock = new Object(); 1167d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff private int mListenerKey = 0; 1168d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1169d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff AsyncChannel mAsyncChannel; 1170d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff WifiHandler mHandler; 1171d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff class WifiHandler extends Handler { 1172d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff WifiHandler(Looper looper) { 1173d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff super(looper); 1174d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1175d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1176d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff @Override 1177d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void handleMessage(Message message) { 1178d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff Object listener = removeListener(message.arg2); 1179d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff switch (message.what) { 1180d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case AsyncChannel.CMD_CHANNEL_DISCONNECTED: 1181d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (mChannelListener != null) { 1182d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mChannelListener.onChannelDisconnected(); 1183d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mChannelListener = null; 1184d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1185d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1186d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* ActionListeners grouped together */ 1187d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.CONNECT_NETWORK_FAILED: 1188d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.FORGET_NETWORK_FAILED: 1189d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.SAVE_NETWORK_FAILED: 1190d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.DISABLE_NETWORK_FAILED: 1191d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (listener != null) { 1192d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff ((ActionListener) listener).onFailure(message.arg1); 1193d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1194d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1195d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /* ActionListeners grouped together */ 1196d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.CONNECT_NETWORK_SUCCEEDED: 1197d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.FORGET_NETWORK_SUCCEEDED: 1198d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.SAVE_NETWORK_SUCCEEDED: 1199d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.DISABLE_NETWORK_SUCCEEDED: 1200d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (listener != null) { 1201d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff ((ActionListener) listener).onSuccess(); 1202d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1203d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1204d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.START_WPS_SUCCEEDED: 1205d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (listener != null) { 1206d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff WpsResult result = (WpsResult) message.obj; 1207d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff ((WpsListener) listener).onStartSuccess(result.pin); 1208d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff //Listener needs to stay until completion or failure 1209d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff synchronized(mListenerMapLock) { 1210d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mListenerMap.put(message.arg2, listener); 1211d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1212d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1213d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1214d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.WPS_COMPLETED: 1215d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (listener != null) { 1216d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff ((WpsListener) listener).onCompletion(); 1217d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1218d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1219d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff case WifiManager.WPS_FAILED: 1220d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (listener != null) { 1221d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff ((WpsListener) listener).onFailure(message.arg1); 1222d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1223d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1224d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff default: 1225d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff //ignore 1226d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff break; 1227d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1228d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1229d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1230d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1231d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff int putListener(Object listener) { 1232d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (listener == null) return 0; 1233d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff int key; 1234d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff synchronized (mListenerMapLock) { 1235d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff key = mListenerKey++; 1236d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mListenerMap.put(key, listener); 1237d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1238d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff return key; 1239d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1240d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1241d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff Object removeListener(int key) { 1242d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff synchronized (mListenerMapLock) { 1243d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff Object listener = mListenerMap.get(key); 1244d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff mListenerMap.remove(key); 1245d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff return listener; 1246d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1247d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1248d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1249ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1250ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** 1251d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Registers the application with the Wi-Fi framework. This function 1252d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * must be the first to be called before any Wi-Fi operations are performed. 1253d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 1254ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff * @param srcContext is the context of the source 1255d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param srcLooper is the Looper on which the callbacks are receivied 1256d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callback at loss of framework communication. Can be null. 1257d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @return Channel instance that is necessary for performing any further Wi-Fi operations. 1258d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * A null is returned upon failure to initialize. 1259ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff * @hide 1260ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff */ 1261d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public Channel initialize(Context srcContext, Looper srcLooper, ChannelListener listener) { 1262d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff Messenger messenger = getWifiServiceMessenger(); 1263d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (messenger == null) return null; 1264d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1265d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff Channel c = new Channel(srcLooper, listener); 1266d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c.mAsyncChannel.connectSync(srcContext, c.mHandler, messenger) 1267d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff == AsyncChannel.STATUS_SUCCESSFUL) { 1268d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff return c; 1269d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } else { 1270d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff return null; 1271d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1272d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1273ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1274e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1275e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 1276e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 1277e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1278e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1279e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 1280e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1281e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1282d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param c is the channel created at {@link #initialize} 1283e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1284e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1285d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 1286e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1287e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1288d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void connect(Channel c, WifiConfiguration config, ActionListener listener) { 1289d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c == null) throw new IllegalArgumentException("Channel needs to be initialized"); 1290d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 1291d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1292ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // Use INVALID_NETWORK_ID for arg1 when passing a config object 1293ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff // arg1 is used to pass network id when the network already exists 1294ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff c.mAsyncChannel.sendMessage(CONNECT_NETWORK, WifiConfiguration.INVALID_NETWORK_ID, 1295ab26407124cf861eacfe7bf0f2a1ef25f4b3a7bdIrfan Sheriff c.putListener(listener), config); 1296e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1297e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1298e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1299e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 1300e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1301e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 1302e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1303e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1304d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param c is the channel created at {@link #initialize} 1305e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 1306e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 1307d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 1308e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1309e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1310d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void connect(Channel c, int networkId, ActionListener listener) { 1311d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c == null) throw new IllegalArgumentException("Channel needs to be initialized"); 1312d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (networkId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 1313d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1314d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff c.mAsyncChannel.sendMessage(CONNECT_NETWORK, networkId, c.putListener(listener)); 1315e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1316e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1317e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1318e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 1319e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 1320e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 1321e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1322e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1323e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 1324e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1325e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 1326e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 1327e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1328d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param c is the channel created at {@link #initialize} 1329e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1330e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1331d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 1332e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1333e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1334d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void save(Channel c, WifiConfiguration config, ActionListener listener) { 1335d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c == null) throw new IllegalArgumentException("Channel needs to be initialized"); 1336d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 1337ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1338d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff c.mAsyncChannel.sendMessage(SAVE_NETWORK, 0, c.putListener(listener), config); 1339e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1340e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1341e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1342e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 1343e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1344e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 1345e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 1346e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1347d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param c is the channel created at {@link #initialize} 1348e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1349e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1350d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 1351e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1352e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1353d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void forget(Channel c, int netId, ActionListener listener) { 1354d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c == null) throw new IllegalArgumentException("Channel needs to be initialized"); 1355d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 1356ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1357d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff c.mAsyncChannel.sendMessage(FORGET_NETWORK, netId, c.putListener(listener)); 1358d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff } 1359d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1360d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff /** 1361d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * Disable network 1362d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * 1363d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param c is the channel created at {@link #initialize} 1364d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param netId is the network Id 1365d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 1366d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @hide 1367d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff */ 1368d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void disable(Channel c, int netId, ActionListener listener) { 1369d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c == null) throw new IllegalArgumentException("Channel needs to be initialized"); 1370d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (netId < 0) throw new IllegalArgumentException("Network id cannot be negative"); 1371d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff 1372d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff c.mAsyncChannel.sendMessage(DISABLE_NETWORK, netId, c.putListener(listener)); 1373e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1374e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 137517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 137602fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 13775ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 1378d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param c is the channel created at {@link #initialize} 137902fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * @param config WPS configuration 1380d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff * @param listener for callbacks on success or failure. Can be null. 13815ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 13825ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 1383d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff public void startWps(Channel c, WpsInfo config, WpsListener listener) { 1384d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (c == null) throw new IllegalArgumentException("Channel needs to be initialized"); 1385d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff if (config == null) throw new IllegalArgumentException("config cannot be null"); 1386ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1387d3975a917799b85cacaf382b65c5832813066b51Irfan Sheriff c.mAsyncChannel.sendMessage(START_WPS, 0, c.putListener(listener), config); 1388f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1389f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 1390f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 1391227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 1392227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 1393227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1394227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 1395227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 1396227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 139707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiServiceMessenger() { 1398227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 139907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiServiceMessenger(); 1400227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 1401227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 1402227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1403227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1404227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1405227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** 140607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * Get a reference to WifiStateMachine handler. 140707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @return Messenger pointing to the WifiService handler 140807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff * @hide 140907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff */ 141007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff public Messenger getWifiStateMachineMessenger() { 141107573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff try { 141207573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return mService.getWifiStateMachineMessenger(); 141307573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } catch (RemoteException e) { 141407573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff return null; 141507573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 141607573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff } 141707573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 141807573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 141907573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff 142007573b32494acbabd21979d8b9584c1ed3f7a6adIrfan Sheriff /** 14214aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 14224aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 14234aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 14244aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 14254aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 14264aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 14274aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 14284aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 14294aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 14304aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 14314aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 14324aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 1435227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 14369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 14379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 1438d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 14399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 14409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 14419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 14429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 14439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 1444d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 14459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 14469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 14479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 1448d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 1449d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 1450d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * permission in an {@code <uses-permission>} element of the application's manifest. 14519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 14539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 14549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 14559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 14569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 14579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 14589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 14597e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 14609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 14629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 14639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 14649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 14659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 14669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 14679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 14689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 14729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 1474227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 14759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 14769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 14789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 14799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 14809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 14829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 14839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (++mRefCount > 0) : (!mHeld)) { 14849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 14857e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 1486617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1487617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1488617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 1489617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1490617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1491617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1492617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1493617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 14949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 14959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 14979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 15039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 15059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 15069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 15079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 15089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 15109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 15119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 15129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 15149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 15159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 15169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 15179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1518617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1519617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1520617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 15219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 15229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 15249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 15269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 15279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 15339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 15359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 15369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 15379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 15389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 15399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 15419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 15439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 15449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 15479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 15489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 15499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 15509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 15519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 15529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 15539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 15549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15577e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 15587e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 15597e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 15607e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 15617e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15627e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 15637e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 15647e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 15657e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else if (mWorkSource == null) { 15667e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource != null; 15677e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = new WorkSource(ws); 15687e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 15697e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource.diff(ws); 15707e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed) { 15717e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource.set(ws); 15727e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15737e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15747e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 15757e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 15767e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 15777e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 15787e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15797e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15807e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15817e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 15827e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 15839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 15849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 15859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 15869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 15879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 15889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 15899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 15909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 15919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 15929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 15949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 15969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 15979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 15989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 15999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 16009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 16019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 16029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 16039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1604617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1605617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1606617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 16079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 16089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 16149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 16169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16175876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 1618652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 1619652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 1620652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 1621652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 16229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 16239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 16249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 16269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 16289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 16309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 16319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1632652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 16339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 16349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 16359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 16379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 16389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 16399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 16409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 16429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 16439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 16449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 16459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 16469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 16479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 16485347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 1649fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 16505347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1651fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 16525347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1653fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 165441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 165541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 165641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 165741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 16585347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1659fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 1660fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1661fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 16625347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1663fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 1664fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 16655347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 16665347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 16675347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1668fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 1669fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 1670fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 1671fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 1672fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 167341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 16745347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1675fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 1676fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 1677fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 167841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 167941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 1680fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 1681fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1682fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 1683fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 1684fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 168541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 168641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 1687fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 1688fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1689fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1690fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1691fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 1692fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 169341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 169441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 169541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 169641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 169741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 169841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 169941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 170041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 170141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 170241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 1703fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1704fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 1705fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 1706fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1707fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 1708fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 1709fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1710fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 1711fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 171241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (++mRefCount > 0) : (!mHeld)) { 1713fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1714fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 1715617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1716617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1717617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 1718617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1719617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1720617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1721617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1722617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1723fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1724fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 172541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 1726fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1727fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1728fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1729fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1730fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1731fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 1732fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 1733fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 173441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 173541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 173641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 173741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 173841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 173941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 174041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 174141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 174241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 17434a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 174441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 174541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 1746fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 1747fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 1748fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 1749fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 1750fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1751fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 1752fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 1753fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1754fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 1755fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 175641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 1757fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1758fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 1759617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1760617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1761617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1762fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1763fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 176441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 176541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 176641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 176741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 176841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 1769fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1770fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1771fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1772fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1773fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 177441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 177541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 177641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 177741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 177841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 177941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 178041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 178141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 178241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 178341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 178441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 178541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 178641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 178741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 178841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 178941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 179041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 179141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 179241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 1793fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 1794fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1795fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 1796fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1797fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 1798fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1799fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 1800fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1801fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1802fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1803fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 180441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 1805fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1806fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 1807fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 180841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 180941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 181041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 181141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 181241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 181341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 1814fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1815fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1816fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1817fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 1818fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 1819fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 182041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 1821fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 18225347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 18235347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 18245347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 18255347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1826fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 18275347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1828fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 18295347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 18305347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 18315347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1832fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 18335347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 1834fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 18355347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 18365347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 18375347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 18385347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 1839e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 1840e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 1841e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 1842e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 1843e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 1844e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 1845e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 1846e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 1847e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 1848e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 1849e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 1850e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1851e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1852651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 1853