WifiManager.java revision 36f7413dabfab50699135019ba55151e9227f59d
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; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.net.DhcpInfo; 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Binder; 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.IBinder; 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Handler; 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.RemoteException; 267e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackbornimport android.os.WorkSource; 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.util.List; 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This class provides the primary API for managing all aspects of Wi-Fi 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connectivity. Get an instance of this class by calling 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService(String) Context.getSystemService(Context.WIFI_SERVICE)}. 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * It deals with several categories of items: 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The list of configured networks. The list can be viewed and updated, 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and attributes of individual entries can be modified.</li> 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>The currently active Wi-Fi network, if any. Connectivity can be 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * established or torn down, and dynamic information about the state of 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the network can be queried.</li> 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>Results of access point scans, containing enough information to 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * make decisions about what access point to connect to.</li> 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>It defines the names of various Intent actions that are broadcast 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * upon any sort of change in Wi-Fi state. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This is the API to use when performing Wi-Fi specific operations. To 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * perform operations that pertain to network connectivity at an abstract 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level, use {@link android.net.ConnectivityManager}. 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class WifiManager { 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project // Supplicant error codes: 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The error code if there was a problem authenticating. 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int ERROR_AUTHENTICATING = 1; 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that Wi-Fi has been enabled, disabled, 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enabling, disabling, or unknown. One extra provides this state as an int. 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Another extra provides the previous state, if available. 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_PREVIOUS_WIFI_STATE 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String WIFI_STATE_CHANGED_ACTION = 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.WIFI_STATE_CHANGED"; 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an int that indicates whether Wi-Fi is enabled, 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disabled, enabling, disabling, or unknown. Retrieve it with 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String,int)}. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLED 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_DISABLING 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLED 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_ENABLING 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_UNKNOWN 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_WIFI_STATE = "wifi_state"; 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The previous Wi-Fi state. 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_WIFI_STATE 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_PREVIOUS_WIFI_STATE = "previous_wifi_state"; 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being disabled. The state will change to {@link #WIFI_STATE_DISABLED} if 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLING = 0; 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is disabled. 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_DISABLED = 1; 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is currently being enabled. The state will change to {@link #WIFI_STATE_ENABLED} if 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it finishes successfully. 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLING = 2; 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is enabled. 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_ENABLED = 3; 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi is in an unknown state. This state will occur when an error happens while enabling 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or disabling. 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #WIFI_STATE_CHANGED_ACTION 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_STATE_UNKNOWN = 4; 1275321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1285321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1295321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Broadcast intent action indicating that Wi-Fi AP has been enabled, disabled, 1305321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling, disabling, or failed. 1315321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1325321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1335321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1345321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 1355321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String WIFI_AP_STATE_CHANGED_ACTION = 1365321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff "android.net.wifi.WIFI_AP_STATE_CHANGED"; 1375321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 1385321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The lookup key for an int that indicates whether Wi-Fi AP is enabled, 1405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * disabled, enabling, disabling, or failed. Retrieve it with 1415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link android.content.Intent#getIntExtra(String,int)}. 1425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLED 1445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_DISABLING 1455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLED 1465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_ENABLING 1475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_FAILED 1485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_WIFI_AP_STATE = "wifi_state"; 1525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * The previous Wi-Fi state. 1545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #EXTRA_WIFI_AP_STATE 1565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 1595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public static final String EXTRA_PREVIOUS_WIFI_AP_STATE = "previous_wifi_state"; 1605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being disabled. The state will change to 1625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLED} if it finishes successfully. 1635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 169a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLING = 10; 1705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is disabled. 1725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiState() 1755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 178a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_DISABLED = 11; 1795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is currently being enabled. The state will change to 1815321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLED} if it finishes successfully. 1825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1875321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 188a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLING = 12; 1895321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1905321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is enabled. 1915321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1925321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 1935321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 1945321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 1955321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 1965321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 197a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_ENABLED = 13; 1985321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 1995321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Wi-Fi AP is in a failed state. This state will occur when an error occurs during 2005321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * enabling or disabling 2015321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2025321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #WIFI_AP_STATE_CHANGED_ACTION 2035321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 2045321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 2055321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide 2065321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 207a2a1b911a31dd94ee75e94845f762b91f1db1368Irfan Sheriff public static final int WIFI_AP_STATE_FAILED = 14; 2085321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 2099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that a connection to the supplicant has 2119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * been established (and it is now possible 2129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to perform Wi-Fi operations) or the connection to the supplicant has been 2139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lost. One extra provides the connection state as a boolean, where {@code true} 2149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * means CONNECTED. 2159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_CONNECTED 2169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_CONNECTION_CHANGE_ACTION = 2199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.CONNECTION_CHANGE"; 2209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a boolean that indicates whether a connection to 2229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the supplicant daemon has been gained or lost. {@code true} means 2239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a connection now exists. 2249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve it with {@link android.content.Intent#getBooleanExtra(String,boolean)}. 2259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_CONNECTED = "connected"; 2279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of Wi-Fi connectivity 2299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has changed. One extra provides the new state 2309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the form of a {@link android.net.NetworkInfo} object. If the new state is 2319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * CONNECTED, a second extra may provide the BSSID of the access point, 2329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * as a {@code String}. 2339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NETWORK_INFO 2349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_BSSID 2359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_STATE_CHANGED_ACTION = "android.net.wifi.STATE_CHANGE"; 2389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link android.net.NetworkInfo} object associated with the 2409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Wi-Fi network. Retrieve with 2419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NETWORK_INFO = "networkInfo"; 2449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a String giving the BSSID of the access point to which 2469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * we are connected. Only present when the new state is CONNECTED. 2479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getStringExtra(String)}. 2499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_BSSID = "bssid"; 2519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Broadcast intent action indicating that the state of establishing a connection to 2539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an access point has changed.One extra provides the new 2549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link SupplicantState}. Note that the supplicant state is Wi-Fi specific, and 2559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is not generally the most useful thing to look at if you are just interested in 2569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the overall state of connectivity. 2579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_STATE 2589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_SUPPLICANT_ERROR 2599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SUPPLICANT_STATE_CHANGED_ACTION = 2629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project "android.net.wifi.supplicant.STATE_CHANGE"; 2639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the new state 2659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getParcelableExtra(String)}. 2679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_STATE = "newState"; 2699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 2709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for a {@link SupplicantState} describing the supplicant 2729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * error code if any 2739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Retrieve with 2749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Intent#getIntExtra(String, int)}. 2759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #ERROR_AUTHENTICATING 2769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_SUPPLICANT_ERROR = "supplicantError"; 278e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 279e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Broadcast intent action indicating that the supplicant configuration changed. 280e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This can be as a result of adding/updating/deleting a network 281e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 282e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 283e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 284e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public static final String SUPPLICANT_CONFIG_CHANGED_ACTION = 285e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff "android.net.wifi.supplicant.CONFIG_CHANGE"; 2869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * An access point scan has completed, and results are available from the supplicant. 2889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Call {@link #getScanResults()} to obtain the results. 2899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String SCAN_RESULTS_AVAILABLE_ACTION = "android.net.wifi.SCAN_RESULTS"; 2929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The RSSI (signal strength) has changed. 2949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #EXTRA_NEW_RSSI 2959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 2969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 2979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String RSSI_CHANGED_ACTION = "android.net.wifi.RSSI_CHANGED"; 2989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 2999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The lookup key for an {@code int} giving the new RSSI in dBm. 3009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String EXTRA_NEW_RSSI = "newRssi"; 3029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3040d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Broadcast intent action indicating that the IP configuration 3050d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * changed on wifi. 3060d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3070d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 3080d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3090d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public static final String CONFIG_CHANGED_ACTION = "android.net.wifi.CONFIG_CHANGED"; 310f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 3110d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 31237e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt * The lookup key for a {@link android.net.LinkProperties} object associated with the 3130d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Wi-Fi network. Retrieve with 3140d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * {@link android.content.Intent#getParcelableExtra(String)}. 3150d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 3160d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 31737e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt public static final String EXTRA_LINK_PROPERTIES = "linkProperties"; 3180d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 3190d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 320f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * The lookup key for a {@link android.net.LinkCapabilities} object associated with the 321f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * Wi-Fi network. Retrieve with 322f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * {@link android.content.Intent#getParcelableExtra(String)}. 323f61101f6266be243c481d163b95e65d67b8d1669Wink Saville * @hide 324f61101f6266be243c481d163b95e65d67b8d1669Wink Saville */ 325f61101f6266be243c481d163b95e65d67b8d1669Wink Saville public static final String EXTRA_LINK_CAPABILITIES = "linkCapabilities"; 326f61101f6266be243c481d163b95e65d67b8d1669Wink Saville 327f61101f6266be243c481d163b95e65d67b8d1669Wink Saville /** 3289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The network IDs of the configured networks could have changed. 3299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) 3319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String NETWORK_IDS_CHANGED_ACTION = "android.net.wifi.NETWORK_IDS_CHANGED"; 33237e65ebb7eb932e1a144b1cab262e11ca5fd109bRobert Greenwalt 3339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Activity Action: Pick a Wi-Fi network to connect to. 3359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Input: Nothing. 3369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p>Output: Nothing. 3379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION) 3399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final String ACTION_PICK_WIFI_NETWORK = "android.net.wifi.PICK_WIFI_NETWORK"; 3409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 3425876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * In this Wi-Fi lock mode, Wi-Fi will behave as in the mode 3435876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * {@link #WIFI_MODE_FULL} but it operates at high performance 3445876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * at the expense of power. This mode should be used 3455876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * only when the wifi connection needs to have minimum loss and low 3465876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * latency as it can impact the battery life. 3475876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @hide 3485876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff */ 3495876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff public static final int WIFI_MODE_FULL_HIGH_PERF = 3; 3505876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff 3515876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff /** 35299001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 3539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * and will behave normally, i.e., it will attempt to automatically 3549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * establish a connection to a remembered access point that is 3559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * within range, and will do periodic scans if there are remembered 3569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * access points but none are in range. 3579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_FULL = 1; 3599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 36099001278289036a3c645e599ed832943ff1b6e15Eric Shienbrood * In this Wi-Fi lock mode, Wi-Fi will be kept active, 3619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but the only operation that will be supported is initiation of 3629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * scans, and the subsequent reporting of scan results. No attempts 3639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be made to automatically connect to remembered access points, 3649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * nor will periodic scans be automatically performed looking for 3659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * remembered access points. Scans must be explicitly requested by 3669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * an application in this mode. 3679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 3689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final int WIFI_MODE_SCAN_ONLY = 2; 3699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything worse than or equal to this will show 0 bars. */ 3719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MIN_RSSI = -100; 3729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 3739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Anything better than or equal to this will show the max bars. */ 3749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private static final int MAX_RSSI = -55; 37536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 37636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 37736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Auto settings in the driver. The driver could choose to operate on both 37836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * 2.4 GHz and 5 GHz or make a dynamic decision on selecting the band. 37936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 38036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 38136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_AUTO = 0; 38236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 38336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 38436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 5 GHz alone 38536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 38636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 38736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_5GHZ = 1; 38836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 38936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 39036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Operation on 2.4 GHz alone 39136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 39236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 39336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public static final int WIFI_FREQUENCY_BAND_2GHZ = 2; 39436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 3959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project IWifiManager mService; 3969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project Handler mHandler; 3979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 398617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Maximum number of active locks we allow. 399617750604c69e6068f68266d0e30324273aa990eMike Lockwood * This limit was added to prevent apps from creating a ridiculous number 400617750604c69e6068f68266d0e30324273aa990eMike Lockwood * of locks and crashing the system by overflowing the global ref table. 401617750604c69e6068f68266d0e30324273aa990eMike Lockwood */ 402617750604c69e6068f68266d0e30324273aa990eMike Lockwood private static final int MAX_ACTIVE_LOCKS = 50; 403617750604c69e6068f68266d0e30324273aa990eMike Lockwood 404617750604c69e6068f68266d0e30324273aa990eMike Lockwood /* Number of currently active WifiLocks and MulticastLocks */ 405617750604c69e6068f68266d0e30324273aa990eMike Lockwood private int mActiveLockCount; 406617750604c69e6068f68266d0e30324273aa990eMike Lockwood 4079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Create a new WifiManager instance. 4099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Applications will almost always want to use 4109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link android.content.Context#getSystemService Context.getSystemService()} to retrieve 4119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the standard {@link android.content.Context#WIFI_SERVICE Context.WIFI_SERVICE}. 4129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param service the Binder interface 4139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param handler target for messages 4149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @hide - hide this because it takes in a parameter of type IWifiManager, which 4159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is a system private class. 4169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiManager(IWifiManager service, Handler handler) { 4189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService = service; 4199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHandler = handler; 4209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return a list of all the networks configured in the supplicant. 4249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Not all fields of WifiConfiguration are returned. Only the following 4259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * fields are filled in: 4269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <ul> 4279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>networkId</li> 4289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>SSID</li> 4299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>BSSID</li> 4309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>priority</li> 4319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedProtocols</li> 4329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedKeyManagement</li> 4339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedAuthAlgorithms</li> 4349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedPairwiseCiphers</li> 4359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <li>allowedGroupCiphers</li> 4369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * </ul> 4379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a list of network configurations in the form of a list 4389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of {@link WifiConfiguration} objects. 4399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<WifiConfiguration> getConfiguredNetworks() { 4419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 4429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConfiguredNetworks(); 4439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 4449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 4459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Add a new network description to the set of configured networks. 4509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The {@code networkId} field of the supplied configuration object 4519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is ignored. 4529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/> 4539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The new network will be marked DISABLED by default. To enable it, 4549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * called {@link #enableNetwork}. 4559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 4579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. 4589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the newly created network description. This is used in 4599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * other operations to specified the network to be acted upon. 4609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure. 4619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int addNetwork(WifiConfiguration config) { 4639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null) { 4649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 4659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project config.networkId = -1; 4679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 4689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Update the network description of an existing configured network. 4729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config the set of variables that describe the configuration, 4749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * contained in a {@link WifiConfiguration} object. It may 4759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be sparse, so that only the items that are being changed 4769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are non-<code>null</code>. The {@code networkId} field 4779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * must be set to the ID of the existing network being updated. 4789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns the {@code networkId} of the supplied 4799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code WifiConfiguration} on success. 4809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <br/> 4819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Returns {@code -1} on failure, including when the {@code networkId} 4829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * field of the {@code WifiConfiguration} does not refer to an 4839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing network. 4849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 4859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int updateNetwork(WifiConfiguration config) { 4869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (config == null || config.networkId < 0) { 4879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 4889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addOrUpdateNetwork(config); 4909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 4919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 4929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 4939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Internal method for doing the RPC that creates a new network description 4949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or updates an existing one. 4959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 4969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param config The possibly sparse object containing the variables that 4979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * are to set or updated in the network description. 4989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the ID of the network on success, {@code -1} on failure. 4999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int addOrUpdateNetwork(WifiConfiguration config) { 5019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.addOrUpdateNetwork(config); 5039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 5059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Remove the specified network from the list of configured networks. 5109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * This may result in the asynchronous delivery of state change 5119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * events. 5129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the integer that identifies the network configuration 5139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the supplicant 5149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean removeNetwork(int netId) { 5179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.removeNetwork(netId); 5199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allow a previously configured network to be associated with. If 5269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <code>disableOthers</code> is true, then all other configured 5279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * networks are disabled, and an attempt to connect to the selected 5289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network is initiated. This may result in the asynchronous delivery 5299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of state change events. 5309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network in the list of configured networks 5319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param disableOthers if true, disable all other networks. The way to 5329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * select a particular network to connect to is specify {@code true} 5339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for this parameter. 5349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean enableNetwork(int netId, boolean disableOthers) { 5379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.enableNetwork(netId, disableOthers); 5399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disable a configured network. The specified network will not be 5469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a candidate for associating. This may result in the asynchronous 5479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * delivery of state change events. 5489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param netId the ID of the network as returned by {@link #addNetwork}. 5499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disableNetwork(int netId) { 5529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 5539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.disableNetwork(netId); 5549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Disassociate from the currently active access point. This may result 5619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * in the asynchronous delivery of state change events. 5629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean disconnect() { 5659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 566e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.disconnect(); 567e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 5689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 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 * Reconnect to the currently active access point, if we are currently 5759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * disconnected. This may result in the asynchronous delivery of state 5769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 5779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reconnect() { 5809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 581e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reconnect(); 582e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 5839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 5859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 5879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 5889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 5899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reconnect to the currently active access point, even if we are already 5909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * connected. This may result in the asynchronous delivery of state 5919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * change events. 5929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 5939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 5949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean reassociate() { 5959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 596e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.reassociate(); 597e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 5989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 5999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Check that the supplicant daemon is responding to requests. 6059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if we were able to communicate with the supplicant and 6069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * it returned the expected response to the PING message. 6079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean pingSupplicant() { 6099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mService == null) 6109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.pingSupplicant(); 6139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Request a scan for access points. Returns immediately. The availability 6209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * of the results is made known later by means of an asynchronous event sent 6219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * on completion of the scan. 6229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded, i.e., the scan was initiated 6239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 624a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScan() { 6259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 626e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(false); 627e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 628a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } catch (RemoteException e) { 629a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood return false; 630a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 631a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood } 632a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood 633a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood /** 634a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * Request a scan for access points. Returns immediately. The availability 635a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * of the results is made known later by means of an asynchronous event sent 636a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * on completion of the scan. 637a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * This is a variant of startScan that forces an active scan, even if passive 638a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * scans are the current default 639a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @return {@code true} if the operation succeeded, i.e., the scan was initiated 640a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * 641a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood * @hide 642a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood */ 643a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood public boolean startScanActive() { 644a5ec95cdb1a7d2024249277dff1f99d0046c9b56Mike Lockwood try { 645e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff mService.startScan(true); 646e498475b187277309c81b38240c7e71ec049e369Irfan Sheriff return true; 6479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return dynamic information about the current Wi-Fi connection, if any is active. 6549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the Wi-Fi information, contained in {@link WifiInfo}. 6559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiInfo getConnectionInfo() { 6579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getConnectionInfo(); 6599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 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 * Return the results of the latest access point scan. 6669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the list of access points found in the most recent scan. 6679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public List<ScanResult> getScanResults() { 6699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getScanResults(); 6719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 6739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 6779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Tell the supplicant to persist the current list of configured networks. 6789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p> 6799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note: It is possible for this method to change the network IDs of 6809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * existing networks. You should assume the network IDs can be different 6819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * after calling this method. 6829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 6839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeded 6849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 6859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean saveConfiguration() { 6869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 6879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.saveConfiguration(); 6889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 6899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 6909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 6929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 6939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 694ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * Set the country code. 695ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param countryCode country code in ISO 3166 format. 696ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @param persist {@code true} if this needs to be remembered 6979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 698ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff * @hide 6999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 700ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff public void setCountryCode(String country, boolean persist) { 7019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 702ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff mService.setCountryCode(country, persist); 703ed4f28b492da3ff140bbaabbbda798a08c40ea5bIrfan Sheriff } catch (RemoteException e) { } 7049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 70736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Set the operational frequency band. 70836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param band One of 70936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 71036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 71136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ}, 71236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @param persist {@code true} if this needs to be remembered 71336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 71436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 71536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public void setFrequencyBand(int band, boolean persist) { 71636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 71736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff mService.setFrequencyBand(band, persist); 71836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { } 71936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 72036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 72136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 72236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Get the operational frequency band. 72336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return One of 72436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_AUTO}, 72536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_5GHZ}, 72636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@link #WIFI_FREQUENCY_BAND_2GHZ} or 72736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * {@code -1} on failure. 72836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 72936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 73036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public int getFrequencyBand() { 73136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 73236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.getFrequencyBand(); 73336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 73436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return -1; 73536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 73636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 73736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 73836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 73936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * Check if the chipset supports dual frequency band (2.4 GHz and 5 GHz) 74036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @return {@code true} if supported, {@code false} otherwise. 74136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff * @hide 74236f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff */ 74336f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff public boolean isDualBandSupported() { 74436f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff try { 74536f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return mService.isDualBandSupported(); 74636f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } catch (RemoteException e) { 74736f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff return false; 74836f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 74936f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff } 75036f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff 75136f7413dabfab50699135019ba55151e9227f59dIrfan Sheriff /** 7529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the DHCP-assigned addresses from the last successful DHCP request, 7539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * if any. 7549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the DHCP information 7559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public DhcpInfo getDhcpInfo() { 7579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getDhcpInfo(); 7599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return null; 7619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Enable or disable Wi-Fi. 7679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param enabled {@code true} to enable, {@code false} to disable. 7689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if the operation succeeds (or if the existing state 7699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is the same as the requested state). 7709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean setWifiEnabled(boolean enabled) { 7729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.setWifiEnabled(enabled); 7749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return false; 7769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Gets the Wi-Fi enabled state. 7819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return One of {@link #WIFI_STATE_DISABLED}, 7829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_DISABLING}, {@link #WIFI_STATE_ENABLED}, 7839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #WIFI_STATE_ENABLING}, {@link #WIFI_STATE_UNKNOWN} 7849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #isWifiEnabled() 7859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int getWifiState() { 7879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 7889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mService.getWifiEnabledState(); 7899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException e) { 7909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return WIFI_STATE_UNKNOWN; 7919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 7939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 7949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 7959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return whether Wi-Fi is enabled or disabled. 7969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} if Wi-Fi is enabled 7979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see #getWifiState() 7989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 7999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isWifiEnabled() { 8009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return getWifiState() == WIFI_STATE_ENABLED; 8019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Calculates the level of the signal. This should be used any time a signal 8059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is being shown. 8069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssi The power of the signal measured in RSSI. 8089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param numLevels The number of levels to consider in the calculated 8099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * level. 8109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return A level of the signal, given in the range of 0 to numLevels-1 8119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * (both inclusive). 8129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int calculateSignalLevel(int rssi, int numLevels) { 8149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (rssi <= MIN_RSSI) { 8159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 8169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else if (rssi >= MAX_RSSI) { 8179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return numLevels - 1; 8189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 8194c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float inputRange = (MAX_RSSI - MIN_RSSI); 8204c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler float outputRange = (numLevels - 1); 8214c0d81b8add0372cc7194b17cc6d2bfc58baacd1Daniel Sandler return (int)((float)(rssi - MIN_RSSI) * outputRange / inputRange); 8229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Compares two signal strengths. 8279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 8289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiA The power of the first signal measured in RSSI. 8299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param rssiB The power of the second signal measured in RSSI. 8309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return Returns <0 if the first signal is weaker than the second signal, 8319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 0 if the two signals have the same strength, and >0 if the first 8329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * signal is stronger than the second signal. 8339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 8349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int compareSignalLevel(int rssiA, int rssiB) { 8359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return rssiA - rssiB; 8369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 8379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 8389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 8395321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Start AccessPoint mode with the specified 8405321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * configuration. If the radio is already running in 8415321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * AP mode, update the new configuration 8425321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Note that starting in access point mode disables station 8435321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * mode operation 8445321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @param wifiConfig SSID, security and channel details as 8455321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * part of WifiConfiguration 8465321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if the operation succeeds, {@code false} otherwise 8475321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 8485321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open up yet 8495321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 8505321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean setWifiApEnabled(WifiConfiguration wifiConfig, boolean enabled) { 8515321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 8525321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.setWifiApEnabled(wifiConfig, enabled); 8535321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 8545321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return false; 8555321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 8565321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 8575321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 8585321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 8595321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Gets the Wi-Fi enabled state. 8605321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return One of {@link #WIFI_AP_STATE_DISABLED}, 8615321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_DISABLING}, {@link #WIFI_AP_STATE_ENABLED}, 8625321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * {@link #WIFI_AP_STATE_ENABLING}, {@link #WIFI_AP_STATE_FAILED} 8635321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #isWifiApEnabled() 8645321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 8655321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 8665321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 8675321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public int getWifiApState() { 8685321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff try { 8695321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return mService.getWifiApEnabledState(); 8705321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } catch (RemoteException e) { 8715321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return WIFI_AP_STATE_FAILED; 8725321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 8735321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 8745321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 8755321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 8765321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * Return whether Wi-Fi AP is enabled or disabled. 8775321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @return {@code true} if Wi-Fi AP is enabled 8785321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @see #getWifiApState() 8795321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * 8805321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff * @hide Dont open yet 8815321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff */ 8825321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff public boolean isWifiApEnabled() { 8835321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff return getWifiApState() == WIFI_AP_STATE_ENABLED; 8845321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff } 8855321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff 8865321aef4a22daef6ed01ed48d936cdd82f2e38b7Irfan Sheriff /** 8879ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * Gets the Wi-Fi AP Configuration. 8889ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @return AP details in WifiConfiguration 8899ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * 8909ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff * @hide Dont open yet 8919ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff */ 8929ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff public WifiConfiguration getWifiApConfiguration() { 8939ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff try { 8949ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return mService.getWifiApConfiguration(); 8959ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } catch (RemoteException e) { 8969ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff return null; 8979ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 8989ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff } 8999ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff 9009ab518ad793385f8405edf19363fe825fb64f5f8Irfan Sheriff /** 90117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * Sets the Wi-Fi AP Configuration. 90217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @return {@code true} if the operation succeeded, {@code false} otherwise 90317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * 90417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff * @hide Dont open yet 90517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff */ 90617b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff public boolean setWifiApConfiguration(WifiConfiguration wifiConfig) { 90717b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff try { 90817b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff mService.setWifiApConfiguration(wifiConfig); 90917b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return true; 91017b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } catch (RemoteException e) { 91117b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff return false; 91217b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 91317b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff } 91417b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff 9150d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9160d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Start the driver and connect to network. 9170d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9180d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. For example, 9190d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * even if the device is idle or there is only a scan-only lock held, 9200d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a start wifi would mean that wifi connection is kept active until 9210d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * a stopWifi() is sent. 9220d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9230d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 9240d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9250d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 9260d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 9270d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 9280d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean startWifi() { 9290d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 9300d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.startWifi(); 9310d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 9320d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 9330d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 9340d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9350d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9360d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 9370d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9380d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Disconnect from a network (if any) and stop the driver. 9390d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9400d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This function will over-ride WifiLock and device idle status. Wi-Fi 9410d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * stays inactive until a startWifi() is issued. 9420d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9430d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiStateTracker 9440d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9450d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 9460d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 9470d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 9480d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean stopWifi() { 9490d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 9500d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.stopWifi(); 9510d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 9520d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 9530d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 9540d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9550d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9560d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 9570d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9580d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Add a bssid to the supplicant blacklist 9590d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9600d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 9610d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9620d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 9630d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 9640d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 9650d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean addToBlacklist(String bssid) { 9660d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 9670d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.addToBlacklist(bssid); 9680d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 9690d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 9700d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 9710d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9720d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9730d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 9740d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff /** 9750d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * Clear the supplicant blacklist 9760d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9770d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * This API is used by WifiWatchdogService 9780d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * 9790d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @return {@code true} if the operation succeeds else {@code false} 9800d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff * @hide 9810d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff */ 9820d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff public boolean clearBlacklist() { 9830d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff try { 9840d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff mService.clearBlacklist(); 9850d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return true; 9860d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } catch (RemoteException e) { 9870d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff return false; 9880d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9890d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff } 9900d25534fed91f636def5776ddc4605005bd7471cIrfan Sheriff 991e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /* TODO: deprecate synchronous API and open up the following API */ 992e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 993e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given configuration. The network also 994e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * gets added to the supplicant configuration. 995e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 996e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 997e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork(), saveConfiguration() and 998e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 999e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1000e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1001e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1002e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1003e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1004e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void connectNetwork(WifiConfiguration config) { 1005e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (config == null) { 1006e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1007e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1008e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff try { 1009e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff mService.connectNetworkWithConfig(config); 1010e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } catch (RemoteException e) { } 1011e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1012e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1013e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1014e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Connect to a network with the given networkId. 1015e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1016e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a enableNetwork(), saveConfiguration() and 1017e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * reconnect() 1018e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1019e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param networkId the network id identifiying the network in the 1020e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * supplicant configuration list 1021e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1022e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1023e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void connectNetwork(int networkId) { 1024e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (networkId < 0) { 1025e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1026e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1027e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff try { 1028e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff mService.connectNetworkWithId(networkId); 1029e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } catch (RemoteException e) { } 1030e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1031e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1032e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1033e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Save the given network in the supplicant config. If the network already 1034e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * exists, the configuration is updated. A new network is enabled 1035e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * by default. 1036e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1037e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For a new network, this function is used instead of a 1038e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * sequence of addNetwork(), enableNetwork() and saveConfiguration(). 1039e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1040e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * For an existing network, it accomplishes the task of updateNetwork() 1041e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration() 1042e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1043e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1044e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1045e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1046e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1047e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void saveNetwork(WifiConfiguration config) { 1048e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (config == null) { 1049e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1050e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1051e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff try { 1052e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff mService.saveNetwork(config); 1053e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } catch (RemoteException e) { } 1054e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1055e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 1056e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff /** 1057e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * Delete the network in the supplicant config. 1058e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1059e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * This function is used instead of a sequence of removeNetwork() 1060e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * and saveConfiguration(). 1061e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * 1062e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @param config the set of variables that describe the configuration, 1063e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * contained in a {@link WifiConfiguration} object. 1064e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff * @hide 1065e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff */ 1066e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff public void forgetNetwork(int netId) { 1067e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff if (netId < 0) { 1068e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff return; 1069e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1070e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff try { 1071e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff mService.forgetNetwork(netId); 1072e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } catch (RemoteException e) { } 1073e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff } 1074e04653cbd0e8303eba92088344312b827e6b0babIrfan Sheriff 107517b232b5b59ab91ab543b87e849583678a000f9bIrfan Sheriff /** 10765ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * Start Wi-fi protected setup push button Configuration 10775ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 10785ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @param bssid BSSID of the access point 10795ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 10805ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 10815ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff public void startWpsPbc(String bssid) { 10825ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff try { 10835ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff mService.startWpsPbc(bssid); 10845ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff } catch (RemoteException e) { } 10855ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff } 10865ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff 10875ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff /** 10885ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * Start Wi-fi Protected Setup pin method configuration 1089f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * with pin obtained from the access point 10905ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 10915ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @param bssid BSSID of the access point 10925ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @param apPin PIN issued by the access point 10935ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * 10945ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff * @hide 10955ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff */ 1096f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff public void startWpsWithPinFromAccessPoint(String bssid, int apPin) { 10975ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff try { 1098f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff mService.startWpsWithPinFromAccessPoint(bssid, apPin); 10995ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff } catch (RemoteException e) { } 11005ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff } 11015ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff 11025ee89800bee7c6c755778795a536e0e2f12b85ffIrfan Sheriff /** 1103f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * Start Wi-fi Protected Setup pin method configuration 1104f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * with pin obtained from the device 1105f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * 1106f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * @param bssid BSSID of the access point 1107f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * @return pin generated by device 1108f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff * @hide 1109f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff */ 1110f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff public int startWpsWithPinFromDevice(String bssid) { 1111f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff try { 1112f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff return mService.startWpsWithPinFromDevice(bssid); 1113f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } catch (RemoteException e) { 1114f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff return -1; 1115f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1116f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff } 1117f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff 1118f235c5ab91b040b88ceb61beb819e15f1b19e9e4Irfan Sheriff /** 11199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Allows an application to keep the Wi-Fi radio awake. 11209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Normally the Wi-Fi radio may turn off when the user has not used the device in a while. 11219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Acquiring a WifiLock will keep the radio on until the lock is released. Multiple 11229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * applications may hold WifiLocks, and the radio will only be allowed to turn off when no 11239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WifiLocks are held in any application. 11249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Before using a WifiLock, consider carefully if your application requires Wi-Fi access, or 11269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * could function over a mobile network, if available. A program that needs to download large 11279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * files should hold a WifiLock to ensure that the download will complete, but a program whose 11289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * network usage is occasional or low-bandwidth should not hold a WifiLock to avoid adversely 11299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * affecting battery life. 11309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Note that WifiLocks cannot override the user-level "Wi-Fi Enabled" setting, nor Airplane 11329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Mode. They simply keep the radio from turning off when Wi-Fi is already on but the device 11339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is idle. 11349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public class WifiLock { 11369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private String mTag; 11379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private final IBinder mBinder; 11389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private int mRefCount; 11399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int mLockType; 11409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mRefCounted; 11419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private boolean mHeld; 11427e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn private WorkSource mWorkSource; 11439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private WifiLock(int lockType, String tag) { 11459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mTag = tag; 11469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mLockType = lockType; 11479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mBinder = new Binder(); 11489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCount = 0; 11499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = true; 11509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 11519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Locks the Wi-Fi radio on until {@link #release} is called. 11559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code acquire} will increment the 11579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will remain locked as long as the reference count is 11589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * above zero. 11599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code acquire} will lock 11619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio, but subsequent calls will be ignored. Only one call to {@link #release} 11629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * will be required, regardless of the number of times that {@code acquire} is called. 11639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void acquire() { 11659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 11669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (++mRefCount > 0) : (!mHeld)) { 11679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 11687e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.acquireWifiLock(mBinder, mLockType, mTag, mWorkSource); 1169617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1170617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1171617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseWifiLock(mBinder); 1172617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1173617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1174617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1175617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1176617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 11779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 11789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = true; 11809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 11839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 11849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 11859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unlocks the Wi-Fi radio, allowing it to turn off when the device is idle. 11869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is reference-counted, each call to {@code release} will decrement the 11889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * reference count, and the radio will be unlocked only when the reference count reaches 11899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * zero. If the reference count goes below zero (that is, if {@code release} is called 11909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * a greater number of times than {@link #acquire}), an exception is thrown. 11919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 11929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * If this WifiLock is not reference-counted, the first call to {@code release} (after 11939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the radio was locked using {@link #acquire}) will unlock the radio, and subsequent 11949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * calls will be ignored. 11959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 11969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void release() { 11979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 11989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 11999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1201617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1202617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1203617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 12049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 12059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mHeld = false; 12079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCount < 0) { 12099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project throw new RuntimeException("WifiLock under-locked " + mTag); 12109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Controls whether this is a reference-counted or non-reference-counted WifiLock. 12169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Reference-counted WifiLocks keep track of the number of calls to {@link #acquire} and 12189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@link #release}, and only allow the radio to sleep when every call to {@link #acquire} 12199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * has been balanced with a call to {@link #release}. Non-reference-counted WifiLocks 12209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * lock the radio whenever {@link #acquire} is called and it is unlocked, and unlock the 12219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * radio whenever {@link #release} is called and it is locked. 12229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param refCounted true if this WifiLock should keep a reference count 12249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void setReferenceCounted(boolean refCounted) { 12269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mRefCounted = refCounted; 12279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Checks whether this WifiLock is currently held. 12319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 12329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return true if this WifiLock is held, false otherwise 12339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 12349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public boolean isHeld() { 12359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 12369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return mHeld; 12379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12407e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn public void setWorkSource(WorkSource ws) { 12417e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn synchronized (mBinder) { 12427e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws != null && ws.size() == 0) { 12437e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn ws = null; 12447e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12457e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn boolean changed = true; 12467e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (ws == null) { 12477e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = null; 12487e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else if (mWorkSource == null) { 12497e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource != null; 12507e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource = new WorkSource(ws); 12517e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } else { 12527e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn changed = mWorkSource.diff(ws); 12537e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed) { 12547e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mWorkSource.set(ws); 12557e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12567e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12577e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn if (changed && mHeld) { 12587e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn try { 12597e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn mService.updateWifiLockWorkSource(mBinder, mWorkSource); 12607e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } catch (RemoteException e) { 12617e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12627e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12637e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12647e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn } 12657e9f4eb2608148436cef36c9969bf8a599b39e72Dianne Hackborn 12669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 12679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String s1, s2, s3; 12689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 12699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s1 = Integer.toHexString(System.identityHashCode(this)); 12709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s2 = mHeld ? "held; " : ""; 12719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mRefCounted) { 12729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "refcounted: refcount = " + mRefCount; 12739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } else { 12749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project s3 = "not refcounted"; 12759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return "WifiLock{ " + s1 + "; " + s2 + s3 + " }"; 12779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 12819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project protected void finalize() throws Throwable { 12829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project super.finalize(); 12839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project synchronized (mBinder) { 12849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project if (mHeld) { 12859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 12869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project mService.releaseWifiLock(mBinder); 1287617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1288617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1289617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 12909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (RemoteException ignore) { 12919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 12969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 12979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 12989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 12999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13005876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * @param lockType the type of lock to create. See {@link #WIFI_MODE_FULL}, 13015876a4273e67271f0eca607af9520f7e5abbe4f3Irfan Sheriff * and {@link #WIFI_MODE_SCAN_ONLY} for descriptions of the types of Wi-Fi locks. 13029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 13039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 13049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 13059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 13069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 13089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 13109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(int lockType, String tag) { 13129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(lockType, tag); 13139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 13159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 13169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Creates a new WifiLock. 13179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param tag a tag for the WifiLock to identify it in debugging messages. This string is 13199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * never shown to the user under normal conditions, but should be descriptive 13209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * enough to identify your application and the specific WifiLock within it, if it 13219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * holds multiple WifiLocks. 13229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return a new, unacquired WifiLock with the given tag. 13249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 13259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @see WifiLock 13269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 13279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public WifiLock createWifiLock(String tag) { 13289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new WifiLock(WIFI_MODE_FULL, tag); 13299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 13305347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 1331fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 13325347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1333fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Create a new MulticastLock 13345347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1335fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @param tag a tag for the MulticastLock to identify it in debugging 133641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * messages. This string is never shown to the user under 133741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * normal conditions, but should be descriptive enough to 133841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * identify your application and the specific MulticastLock 133941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * within it, if it holds multiple MulticastLocks. 13405347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1341fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return a new, unacquired MulticastLock with the given tag. 1342fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1343fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @see MulticastLock 13445347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1345fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public MulticastLock createMulticastLock(String tag) { 1346fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return new MulticastLock(tag); 13475347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 13485347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 13495347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1350fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Allows an application to receive Wifi Multicast packets. 1351fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Normally the Wifi stack filters out packets not explicitly 1352fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addressed to this device. Acquring a MulticastLock will 1353fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * cause the stack to receive packets addressed to multicast 1354fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * addresses. Processing these extra packets can cause a noticable 135541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * battery drain and should be disabled when not needed. 13565347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1357fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public class MulticastLock { 1358fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private String mTag; 1359fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private final IBinder mBinder; 136041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private int mRefCount; 136141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt private boolean mRefCounted; 1362fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private boolean mHeld; 1363fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1364fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt private MulticastLock(String tag) { 1365fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mTag = tag; 1366fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mBinder = new Binder(); 136741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCount = 0; 136841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = true; 1369fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mHeld = false; 1370fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1371fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1372fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1373fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks Wifi Multicast on until {@link #release} is called. 1374fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 137541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted each call to 137641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will increment the reference count, and the 137741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * wifi interface will receive multicast packets as long as the 137841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reference count is above zero. 137941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 138041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 138141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code acquire} will turn on the multicast packets, but subsequent 138241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * calls will be ignored. Only one call to {@link #release} will 138341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * be required, regardless of the number of times that {@code acquire} 138441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is called. 1385fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1386fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that other applications may also lock Wifi Multicast on. 1387fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Only they can relinquish their lock. 1388fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1389fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that applications cannot leave Multicast locked on. 1390fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * When an app exits or crashes, any Multicast locks will be released. 1391fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1392fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void acquire() { 1393fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 139441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (++mRefCount > 0) : (!mHeld)) { 1395fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1396fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.acquireMulticastLock(mBinder, mTag); 1397617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1398617750604c69e6068f68266d0e30324273aa990eMike Lockwood if (mActiveLockCount >= MAX_ACTIVE_LOCKS) { 1399617750604c69e6068f68266d0e30324273aa990eMike Lockwood mService.releaseMulticastLock(); 1400617750604c69e6068f68266d0e30324273aa990eMike Lockwood throw new UnsupportedOperationException( 1401617750604c69e6068f68266d0e30324273aa990eMike Lockwood "Exceeded maximum number of wifi locks"); 1402617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1403617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount++; 1404617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1405fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1406fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 140741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = true; 1408fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1409fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1410fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1411fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1412fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 1413fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Unlocks Wifi Multicast, restoring the filter of packets 1414fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * not addressed specifically to this device and saving power. 1415fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 141641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is reference-counted, each call to 141741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} will decrement the reference count, and the 141841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * multicast packets will only stop being received when the reference 141941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count reaches zero. If the reference count goes below zero (that 142041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * is, if {@code release} is called a greater number of times than 142141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@link #acquire}), an exception is thrown. 142241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 142341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * If this MulticastLock is not reference-counted, the first call to 142441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * {@code release} (after the radio was multicast locked using 14254a51c20ce607c74914f90fd897f04080121ac13bDianne Hackborn * {@link #acquire}) will unlock the multicast, and subsequent calls 142641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * will be ignored. 142741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 1428fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Note that if any other Wifi Multicast Locks are still outstanding 1429fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * this {@code release} call will not have an immediate effect. Only 1430fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * when all applications have released all their Multicast Locks will 1431fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * the Multicast filter be turned back on. 1432fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1433fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Also note that when an app exits or crashes all of its Multicast 1434fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Locks will be automatically released. 1435fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1436fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public void release() { 1437fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 143841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted ? (--mRefCount == 0) : (mHeld)) { 1439fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt try { 1440fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt mService.releaseMulticastLock(); 1441617750604c69e6068f68266d0e30324273aa990eMike Lockwood synchronized (WifiManager.this) { 1442617750604c69e6068f68266d0e30324273aa990eMike Lockwood mActiveLockCount--; 1443617750604c69e6068f68266d0e30324273aa990eMike Lockwood } 1444fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } catch (RemoteException ignore) { 1445fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 144641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mHeld = false; 144741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 144841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCount < 0) { 144941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt throw new RuntimeException("MulticastLock under-locked " 145041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt + mTag); 1451fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1452fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1453fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1454fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1455fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt /** 145641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Controls whether this is a reference-counted or non-reference- 145741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLock. 145841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 145941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * Reference-counted MulticastLocks keep track of the number of calls 146041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * to {@link #acquire} and {@link #release}, and only stop the 146141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * reception of multicast packets when every call to {@link #acquire} 146241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * has been balanced with a call to {@link #release}. Non-reference- 146341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * counted MulticastLocks allow the reception of multicast packets 146441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * whenever {@link #acquire} is called and stop accepting multicast 146541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * packets whenever {@link #release} is called. 146641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * 146741c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * @param refCounted true if this MulticastLock should keep a reference 146841c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt * count 146941c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt */ 147041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt public void setReferenceCounted(boolean refCounted) { 147141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt mRefCounted = refCounted; 147241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 147341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt 147441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt /** 1475fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Checks whether this MulticastLock is currently held. 1476fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * 1477fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if this MulticastLock is held, false otherwise 1478fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt */ 1479fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isHeld() { 1480fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1481fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mHeld; 1482fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1483fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1484fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1485fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public String toString() { 148641c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt String s1, s2, s3; 1487fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt synchronized (mBinder) { 1488fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s1 = Integer.toHexString(System.identityHashCode(this)); 1489fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt s2 = mHeld ? "held; " : ""; 149041c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt if (mRefCounted) { 149141c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "refcounted: refcount = " + mRefCount; 149241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } else { 149341c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt s3 = "not refcounted"; 149441c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt } 149541c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt return "MulticastLock{ " + s1 + "; " + s2 + s3 + " }"; 1496fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1497fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt } 1498fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt 1499fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt @Override 1500fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt protected void finalize() throws Throwable { 1501fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt super.finalize(); 150241c104339951e0e5e78240e1f48455c21b3ba5fdRobert Greenwalt setReferenceCounted(false); 1503fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt release(); 15045347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 15055347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 15065347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt 15075347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt /** 1508fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * Check multicast filter status. 15095347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 1510fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt * @return true if multicast packets are allowed. 15115347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * 15125347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt * @hide pending API council approval 15135347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt */ 1514fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt public boolean isMulticastEnabled() { 15155347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt try { 1516fc1b15cfbfc5f69235ec1f367abd7a909381cd05Robert Greenwalt return mService.isMulticastEnabled(); 15175347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } catch (RemoteException e) { 15185347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt return false; 15195347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 15205347bd4cda2b6afc18f8acab48e52131f35ed13cRobert Greenwalt } 1521e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt 1522e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt /** 1523e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * Initialize the multicast filtering to 'on' 1524e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt * @hide no intent to publish 1525e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt */ 1526e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt public boolean initializeMulticastFiltering() { 1527e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt try { 1528e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt mService.initializeMulticastFiltering(); 1529e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return true; 1530e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } catch (RemoteException e) { 1531e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt return false; 1532e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 1533e2d155a51e68694e17fa6e27d05c928215a5dbcfRobert Greenwalt } 15349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 1535