ScanResult.java revision 9066cfe9886ac131c34d59ed0e2d287b0e3c0087
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.os.Parcelable; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport android.os.Parcel; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Describes information about a detected access point. In addition 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * to the attributes described here, the supplicant keeps track of 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@code quality}, {@code noise}, and {@code maxbitrate} attributes, 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but does not currently report them to external clients. 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class ScanResult implements Parcelable { 299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The network name. */ 309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String SSID; 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** The address of the access point. */ 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String BSSID; 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Describes the authentication, key management, and encryption schemes 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * supported by the access point. 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String capabilities; 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The detected signal level in dBm. At least those are the units used by 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the TI driver. 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int level; 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * The frequency in MHz of the channel over which the client is communicating 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with the access point. 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int frequency; 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * We'd like to obtain the following attributes, 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * but they are not reported via the socket 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interface, even though they are known 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * internally by wpa_supplicant. 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ScanResult(String SSID, String BSSID, String caps, int level, int frequency) { 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.SSID = SSID; 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.BSSID = BSSID; 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.capabilities = caps; 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.level = level; 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project this.frequency = frequency; 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project //networkConfig = null; 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project @Override 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public String toString() { 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project StringBuffer sb = new StringBuffer(); 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String none = "<none>"; 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project sb.append("SSID: "). 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(SSID == null ? none : SSID). 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(", BSSID: "). 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(BSSID == null ? none : BSSID). 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(", capabilities: "). 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(capabilities == null ? none : capabilities). 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(", level: "). 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(level). 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(", frequency: "). 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project append(frequency); 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return sb.toString(); 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Implement the Parcelable interface {@hide} */ 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public int describeContents() { 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return 0; 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Implement the Parcelable interface {@hide} */ 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public void writeToParcel(Parcel dest, int flags) { 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeString(SSID); 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeString(BSSID); 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeString(capabilities); 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(level); 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project dest.writeInt(frequency); 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Implement the Parcelable interface {@hide} */ 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static final Creator<ScanResult> CREATOR = 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project new Creator<ScanResult>() { 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ScanResult createFromParcel(Parcel in) { 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new ScanResult( 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project in.readString(), 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project in.readString(), 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project in.readString(), 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project in.readInt(), 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project in.readInt() 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ); 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public ScanResult[] newArray(int size) { 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return new ScanResult[size]; 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project }; 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 117