WifiManager.java revision ea933cb3fddbf5971dd4c62090edabbed295c3a7
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; 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 277e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackbornimport android.os.WorkSource; 28227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriffimport android.os.Messenger; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 30ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriffimport com.android.internal.util.AsyncChannel; 31ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 67227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 78227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 88227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 92227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 96227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 103227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 111227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 118227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 126227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_UNKNOWN = 4; 1315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 1475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 1485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 1495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 1505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 1515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 1555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 1575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 1595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 1635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 1655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 1665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 172a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 1735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 1755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 1785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 181a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 1825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 1855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1885321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 191a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1975321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 200a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2075321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2095321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 210a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2115321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 2333550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * in the form of a {@link android.net.NetworkInfo} object. If the new 2343550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * state is CONNECTED, additional extras may provide the BSSID and WifiInfo of 2353550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * the access point. 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 2393550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * @see #EXTRA_WIFI_INFO 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2573550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * The lookup key for a {@link android.net.wifi.WifiInfo} object giving the 2583550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * information about the access point to which we are connected. Only present 2593550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * when the new state is CONNECTED. Retrieve with 2603550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy * {@link android.content.Intent#getParcelableExtra(String)}. 2613550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy */ 2623550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy public static final String EXTRA_WIFI_INFO = "wifiInfo"; 2633550ac919c492f3fbaebbf868f4df0d1ea7ee784Isaac Levy /** 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 2819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 2849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 2859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 290fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 291fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 292fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff * Broadcast intent action for reporting errors 293fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff * @hide 294fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff */ 295fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 296fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff public static final String ERROR_ACTION = "android.net.wifi.ERROR"; 297fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 298fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff * The type of error being reported 299fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff * @hide 300fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff */ 301fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff public static final String EXTRA_ERROR_CODE = "errorCode"; 302fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 303fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff /** 304fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff * Valid error codes 305fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff * @hide 306fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff */ 307fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff public static final int WPS_OVERLAP_ERROR = 1; 308fcb659b66756ac02bd1491ae1365b27e8509a890Irfan Sheriff 309e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 310be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the configured networks changed. 311e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This can be as a result of adding/updating/deleting a network 312e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 313e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 314be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String CONFIGURED_NETWORKS_CHANGED_ACTION = 315be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.CONFIGURED_NETWORKS_CHANGE"; 3169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 3189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call {@link #getScanResults()} to obtain the results. 3199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 3229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 3249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 3259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 3329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 334be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff * Broadcast intent action indicating that the link configuration 3350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 3360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 338be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff public static final String LINK_CONFIGURATION_CHANGED_ACTION = 339be9ee6a498afc08df1ca6d796b703b703b25c9a9Irfan Sheriff "android.net.wifi.LINK_CONFIGURATION_CHANGED"; 340f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 3410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 34237e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 3430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 3440d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 3450d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3460d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 34737e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 3480d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 3490d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 350f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * The lookup key for a {@link android.net.LinkCapabilities} object associated with the 351f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 352f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 353f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 354f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 355f61101f6266be243c481d163b95e65d67b8d1669Wink Saville public static final String EXTRA_LINK_CAPABILITIES = "linkCapabilities"; 356f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 357f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 36237e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 37299001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 3759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 3769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 3779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 3799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 38099001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 3819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 3829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 3839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 3849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 3859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 3869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 3879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 389652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff /** 390652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will be kept active as in mode 391652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 392652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * with minimum packet loss and low packet latency even when 393652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * the device screen is off. This mode will consume more power 394652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * and hence should be used only when there is a need for such 395652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * an active connection. 396652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 397652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * An example use case is when a voice connection needs to be 398652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * kept active even after the device screen goes off. Holding the 399652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * regular {@link #WIFI_MODE_FULL} lock will keep the wifi 400652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * connection active, but the connection can be lossy. 401652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * Holding a {@link #WIFI_MODE_FULL_HIGH_PERF} lock for the 402652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * duration of the voice call will improve the call quality. 403652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * <p> 404652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * When there is no support from the hardware, this lock mode 405652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * will have the same behavior as {@link #WIFI_MODE_FULL} 406652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff */ 407652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 411652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 41436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 41536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 416ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * Number of RSSI levels used in the framework to initiate 417ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * {@link #RSSI_CHANGED_ACTION} broadcast 418ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff * @hide 419ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff */ 420ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff public static final int RSSI_LEVELS = 5; 421ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff 422ea933cb3fddbf5971dd4c62090edabbed295c3a7Irfan Sheriff /** 42336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 42436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 42536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 42636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 42736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 42836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 42936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 43036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 43136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 43236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 43336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 43436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 43536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 43636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 43736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 43836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 43936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 44036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 441227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** List of asyncronous notifications 442227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 443227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 444227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NOTIFICATION = 1; 445227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 446227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //Lowest bit indicates data reception and the second lowest 447227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff //bit indicates data transmitted 448227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 449227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_NONE = 0x00; 450227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 451227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_IN = 0x01; 452227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 453227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_OUT = 0x02; 454227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** @hide */ 455227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public static final int DATA_ACTIVITY_INOUT = 0x03; 456227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IWifiManager mService; 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Handler mHandler; 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 460617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 461617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 462617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 463617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 464617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 465617750604c69e6068f68266d0e30324273aa990eMike Lockwood 466617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 467617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 468617750604c69e6068f68266d0e30324273aa990eMike Lockwood 469ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* For communication with WifiService */ 470ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff private AsyncChannel mAsyncChannel = new AsyncChannel(); 471ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler target for messages 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiManager(IWifiManager service, Handler handler) { 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of {@link WifiConfiguration} objects. 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 520227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 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. 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 560227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 5669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 5829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 5969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 5979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.enableNetwork(netId, disableOthers); 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6258dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy * Disable a configured network asynchronously. This call is for abnormal network 6268dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy * events, and the user may be notified of network change, if they recently attempted 6278dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy * to connect to the specified network. 6288dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy * @param netId the ID of the network as returned by {@link #addNetwork}. 6298dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy * @hide 6308dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy */ 6318dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy public void disableNetwork(int netId, int reason) { 6328dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy mAsyncChannel.sendMessage(CMD_DISABLE_NETWORK, netId, reason); 6338dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy } 6348dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy 6358dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** 6369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 6379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 6389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 6419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 642e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 643e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, if we are currently 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 657e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 658e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 672e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 673e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 6969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 6989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 700a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 702e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(false); 703e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 704a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } catch (RemoteException e) { 705a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood return false; 706a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 707a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 708a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood 709a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood /** 710a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * Request a scan for access points. Returns immediately. The availability 711a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * of the results is made known later by means of an asynchronous event sent 712a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * on completion of the scan. 713a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * This is a variant of startScan that forces an active scan, even if passive 714a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * scans are the current default 715a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @return {@code true} if the operation succeeded, i.e., the scan was initiated 716a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * 717a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @hide 718a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood */ 719a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScanActive() { 720a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood try { 721e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(true); 722e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 7239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 7309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 7319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 7339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 7359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the results of the latest access point scan. 7429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the list of access points found in the most recent scan. 7439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 7459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getScanResults(); 7479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 758227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 770ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 771ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 772ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 774ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 776ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 778ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 779ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 78336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 78436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 78536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 78636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 78736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 78836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 78936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 79036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 79136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 79236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 79336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 79436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 79536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 79636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 79736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 79836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 79936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 80036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 80136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 80236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 80336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 80436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 80536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 80636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 80736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 80836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 80936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 81036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 81136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 81236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 81336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 81436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 81536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 81636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 81736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 81836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 81936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 82036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 82136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 82236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 82336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 82436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 82536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 82636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 82736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 8439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 8449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 8459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 8469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 8489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 8509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 8529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 8579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 8589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 8599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 8609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 8619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 8639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 8649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 8659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 8669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 8679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 869227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 8709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 871227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Return whether Wi-Fi is enabled or disabled. 8729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 8739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 8749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 8769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 8779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 878227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 8799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 8819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 882227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 8839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 8849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 8859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 8869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 8879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 8889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 8909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 8919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 8939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 8949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8954c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 8964c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 8974c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 8989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 900227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 9019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 903227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 9049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 9059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 9069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 9079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 9089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 9099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 9109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 9119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 9129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 9139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 9149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 9155321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 9165321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 9175321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 9185321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 9195321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 9205321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 9215321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 9225321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 9235321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9245321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 9255321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9265321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 9275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 928ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff mService.setWifiApEnabled(wifiConfig, enabled); 929ffcea7ae7316ab748a49f5e8f6c6798356f35719Irfan Sheriff return true; 9305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 9325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 9375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 9385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 9395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 9405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 9415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 9435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 9455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 9465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 9475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 9485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 9495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 9545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 9555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 9565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 9575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 9585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 9595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 9605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 9615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 9625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 9635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 9649ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 9659ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 9669ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 9679ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 9689ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 9699ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 9709ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 9719ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 9729ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 9739ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 9749ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 9759ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 9769ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 9779ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 97817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 97917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 98017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 98117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 98217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 98317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 98417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 98517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 98617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 98717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 98817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 98917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 99017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 99117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 9920d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9930d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Start the driver and connect to network. 9940d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9950d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. For example, 9960d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * even if the device is idle or there is only a scan-only lock held, 9970d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a start wifi would mean that wifi connection is kept active until 9980d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a stopWifi() is sent. 9990d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10000d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 10010d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10020d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10030d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10040d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10050d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean startWifi() { 10060d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10070d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.startWifi(); 10080d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10090d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10100d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10110d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10120d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10130d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10140d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10150d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Disconnect from a network (if any) and stop the driver. 10160d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10170d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. Wi-Fi 10180d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * stays inactive until a startWifi() is issued. 10190d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10200d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 10210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean stopWifi() { 10260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.stopWifi(); 10280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 10360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 10380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10400d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10420d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 10430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10440d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 10450d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10460d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10470d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10480d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10490d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10500d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 10510d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 10520d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 10530d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10540d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 10550d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 10560d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 10570d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 10580d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 10590d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 10600d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 10610d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 10620d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 10630d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 10640d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 10650d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10660d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 10670d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 1068e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 1069ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1070ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Commands to WifiService */ 1071ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1072ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_CONNECT_NETWORK = 1; 1073ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1074ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_FORGET_NETWORK = 2; 1075ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1076ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_SAVE_NETWORK = 3; 1077ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1078ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_START_WPS = 4; 10798dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy /** @hide */ 10808dc6a1b2823f374a176fb21b8a174664a5f825faIsaac Levy public static final int CMD_DISABLE_NETWORK = 5; 1081ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1082ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* Events from WifiService */ 1083ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1084ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_WPS_COMPLETED = 11; 1085ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1086ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /* For system use only */ 1087ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1088ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_ENABLE_TRAFFIC_STATS_POLL = 21; 1089ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** @hide */ 1090ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public static final int CMD_TRAFFIC_STATS_POLL = 22; 1091ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1092ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff /** 1093ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff * Initiate an asynchronous channel connection setup 1094ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff * @param srcContext is the context of the source 1095ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff * @param srcHandler is the handler on which the source receives messages 1096ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff * @hide 1097ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff */ 1098ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff public void asyncConnect(Context srcContext, Handler srcHandler) { 1099ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff mAsyncChannel.connect(srcContext, srcHandler, getMessenger()); 1100ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff } 1101ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1102e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1103e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 1104e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 1105e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1106e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1107e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 1108e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1109e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1110e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1111e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1112e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1113e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1114e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void connectNetwork(WifiConfiguration config) { 1115e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (config == null) { 1116e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1117e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1118ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff mAsyncChannel.sendMessage(CMD_CONNECT_NETWORK, config); 1119e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1120e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1121e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1122e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 1123e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1124e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 1125e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1126e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1127e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 1128e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 1129e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1130e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1131e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void connectNetwork(int networkId) { 1132e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (networkId < 0) { 1133e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1134e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1135ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff mAsyncChannel.sendMessage(CMD_CONNECT_NETWORK, networkId); 1136e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1137e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1138e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1139e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 1140e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 1141e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 1142e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1143e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1144e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 1145e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1146e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 1147e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 1148e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1149e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1150e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1151e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1152e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1153e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void saveNetwork(WifiConfiguration config) { 1154e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (config == null) { 1155e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1156e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1157ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1158ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff mAsyncChannel.sendMessage(CMD_SAVE_NETWORK, config); 1159e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1160e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1161e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1162e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 1163e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1164e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 1165e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 1166e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1167e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1168e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1169e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1170e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1171e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void forgetNetwork(int netId) { 1172e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (netId < 0) { 1173e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1174e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1175ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1176ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff mAsyncChannel.sendMessage(CMD_FORGET_NETWORK, netId); 1177e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1178e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 117917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 118002fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * Start Wi-fi Protected Setup 11815ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 118202fb46a297c4f645f2a30b574151401dd0978521Irfan Sheriff * @param config WPS configuration 11835ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 11845ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 1185651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff public void startWps(WpsInfo config) { 1186ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff if (config == null) { 1187ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff return; 1188f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1189ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff 1190ebe606fccd9293674273d5f73246e0e8e6e6ddcfIrfan Sheriff mAsyncChannel.sendMessage(CMD_START_WPS, config); 1191f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1192f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 1193f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 1194227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Get a reference to WifiService handler. This is used by a client to establish 1195227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * an AsyncChannel communication with WifiService 1196227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * 1197227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @return Messenger pointing to the WifiService handler 1198227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * @hide 1199227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff */ 1200227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff public Messenger getMessenger() { 1201227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff try { 1202227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return mService.getMessenger(); 1203227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } catch (RemoteException e) { 1204227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff return null; 1205227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1206227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff } 1207227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff 1208227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff /** 12094aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * Returns the file in which IP and proxy configuration data is stored 12104aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff * @hide 12114aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff */ 12124aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff public String getConfigFile() { 12134aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff try { 12144aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return mService.getConfigFile(); 12154aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } catch (RemoteException e) { 12164aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff return null; 12174aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 12184aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff } 12194aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff 12204aeca7c5908387bc7efb0785830aea1053264062Irfan Sheriff /** 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 1223227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 1226d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 1232d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 1236d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * <p> 1237d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * Any application using a WifiLock must request the {@code android.permission.WAKE_LOCK} 1238d710fb500c121b3f9563ccfbe488f7c9d3ec4985Kenny Root * permission in an {@code <uses-permission>} element of the application's manifest. 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 12419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 12429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 12439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 12449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 12459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 12469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 12477e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 12489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 12509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 12519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 12529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 12539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 12549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 12559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 12569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 12609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 1262227bec49157bc496f7c9e8e8f63c12728a448922Irfan Sheriff * reference count, and the radio will remain locked as long as the reference count is 12639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 12649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (++mRefCount > 0) : (!mHeld)) { 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12737e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 1274617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1275617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1276617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 1277617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1278617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1279617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1280617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1281617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 13009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1306617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1307617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1308617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 13319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 13329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 13369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 13389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 13409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 13419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 13429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13457e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 13467e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 13477e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 13487e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 13497e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13507e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 13517e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 13527e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 13537e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else if (mWorkSource == null) { 13547e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource != null; 13557e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = new WorkSource(ws); 13567e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 13577e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource.diff(ws); 13587e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed) { 13597e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource.set(ws); 13607e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13617e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13627e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 13637e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 13647e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 13657e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 13667e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13677e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13687e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13697e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 13707e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 13719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 13729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 13739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 13749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 13759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 13769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 13779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 13789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 13799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 13809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 13829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 13869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 13879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 13889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 13899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 13909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 13919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1392617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1393617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1394617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 13959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 13969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 14029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 14049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14055876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 1406652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * {@link #WIFI_MODE_FULL_HIGH_PERF} and {@link #WIFI_MODE_SCAN_ONLY} for 1407652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * descriptions of the types of Wi-Fi locks. 1408652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 1409652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff * never shown to the user under normal conditions, but should be descriptive 14109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 14119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 14129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 14149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 14169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 14189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 14199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1420652bc96444b0a82d34e6c3766b7862effac11adbIrfan Sheriff 14219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 14229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 14239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 14259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 14269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 14279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 14289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 14309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 14319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 14329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 14339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 14349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 14359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 14365347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 1437fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 14385347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1439fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 14405347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1441fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 144241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 144341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 144441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 144541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 14465347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1447fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 1448fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1449fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 14505347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1451fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 1452fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 14535347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 14545347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 14555347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1456fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 1457fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 1458fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 1459fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 1460fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 146141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 14625347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1463fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 1464fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 1465fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 146641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 146741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 1468fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 1469fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1470fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 1471fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 1472fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 147341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 147441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 1475fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 1476fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1477fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1478fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1479fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 1480fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 148141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 148241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 148341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 148441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 148541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 148641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 148741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 148841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 148941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 149041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 1491fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1492fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 1493fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 1494fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1495fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 1496fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 1497fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1498fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 1499fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 150041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (++mRefCount > 0) : (!mHeld)) { 1501fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1502fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 1503617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1504617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1505617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 1506617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1507617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1508617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1509617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1510617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1511fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1512fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 151341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 1514fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1515fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1516fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1517fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1518fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1519fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 1520fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 1521fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 152241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 152341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 152441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 152541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 152641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 152741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 152841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 152941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 153041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 15314a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 153241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 153341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 1534fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 1535fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 1536fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 1537fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 1538fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1539fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 1540fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 1541fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1542fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 1543fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 154441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 1545fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1546fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 1547617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1548617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1549617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1550fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1551fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 155241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 155341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 155441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 155541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 155641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 1557fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1558fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1559fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1560fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1561fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 156241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 156341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 156441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 156541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 156641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 156741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 156841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 156941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 157041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 157141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 157241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 157341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 157441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 157541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 157641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 157741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 157841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 157941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 158041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 1581fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 1582fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1583fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 1584fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1585fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 1586fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1587fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 1588fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1589fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1590fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1591fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 159241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 1593fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1594fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 1595fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 159641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 159741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 159841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 159941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 160041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 160141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 1602fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1603fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1604fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1605fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 1606fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 1607fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 160841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 1609fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 16105347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 16115347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 16125347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 16135347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1614fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 16155347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1616fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 16175347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 16185347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 16195347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1620fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 16215347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 1622fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 16235347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 16245347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 16255347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 16265347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 1627e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 1628e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 1629e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 1630e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 1631e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 1632e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 1633e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 1634e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 1635e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 1636e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 1637e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 1638e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1639e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1640651cdfcbac6245f570475991588ddc2d30265e8dIrfan Sheriff} 1641