| /* |
| * Copyright (C) 2008 The Android Open Source Project |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| |
| package android.net.wifi; |
| |
| import android.os.Parcel; |
| import android.os.Parcelable; |
| |
| /** |
| * Describes information about a detected access point. In addition |
| * to the attributes described here, the supplicant keeps track of |
| * {@code quality}, {@code noise}, and {@code maxbitrate} attributes, |
| * but does not currently report them to external clients. |
| */ |
| public class ScanResult implements Parcelable { |
| /** |
| * The network name. |
| */ |
| public String SSID; |
| |
| /** |
| * Ascii encoded SSID. This will replace SSID when we deprecate it. @hide |
| */ |
| public WifiSsid wifiSsid; |
| |
| /** |
| * The address of the access point. |
| */ |
| public String BSSID; |
| /** |
| * Describes the authentication, key management, and encryption schemes |
| * supported by the access point. |
| */ |
| public String capabilities; |
| /** |
| * The detected signal level in dBm, also known as the RSSI. |
| * |
| * <p>Use {@link android.net.wifi.WifiManager#calculateSignalLevel} to convert this number into |
| * an absolute signal level which can be displayed to a user. |
| */ |
| public int level; |
| /** |
| * The primary 20 MHz frequency (in MHz) of the channel over which the client is communicating |
| * with the access point. |
| */ |
| public int frequency; |
| |
| /** |
| * AP Channel bandwidth is 20 MHZ |
| */ |
| public static final int CHANNEL_WIDTH_20MHZ = 0; |
| /** |
| * AP Channel bandwidth is 40 MHZ |
| */ |
| public static final int CHANNEL_WIDTH_40MHZ = 1; |
| /** |
| * AP Channel bandwidth is 80 MHZ |
| */ |
| public static final int CHANNEL_WIDTH_80MHZ = 2; |
| /** |
| * AP Channel bandwidth is 160 MHZ |
| */ |
| public static final int CHANNEL_WIDTH_160MHZ = 3; |
| /** |
| * AP Channel bandwidth is 160 MHZ, but 80MHZ + 80MHZ |
| */ |
| public static final int CHANNEL_WIDTH_80MHZ_PLUS_MHZ = 4; |
| |
| /** |
| * AP Channel bandwidth |
| */ |
| public int channelWidth; |
| |
| /** |
| * Not used if the AP bandwidth is 20 MHz |
| * If the AP use 40, 80 or 160 MHz, this is the center frequency |
| * if the AP use 80 + 80 MHz, this is the center frequency of the first segment |
| */ |
| public int centerFreq0; |
| |
| /** |
| * Only used if the AP bandwidth is 80 + 80 MHz |
| * if the AP use 80 + 80 MHz, this is the center frequency of the second segment |
| */ |
| public int centerFreq1; |
| |
| /** |
| * Whether the AP support 802.11mc Responder |
| */ |
| public boolean is80211McRTTResponder; |
| |
| /** |
| * timestamp in microseconds (since boot) when |
| * this result was last seen. |
| */ |
| public long timestamp; |
| |
| /** |
| * Timestamp representing date when this result was last seen, in milliseconds from 1970 |
| * {@hide} |
| */ |
| public long seen; |
| |
| /** |
| * If the scan result is a valid autojoin candidate |
| * {@hide} |
| */ |
| public int isAutoJoinCandidate; |
| |
| /** |
| * @hide |
| * Update RSSI of the scan result |
| * @param previousRSSI |
| * @param previousSeen |
| * @param maxAge |
| */ |
| public void averageRssi(int previousRssi, long previousSeen, int maxAge) { |
| |
| if (seen == 0) { |
| seen = System.currentTimeMillis(); |
| } |
| long age = seen - previousSeen; |
| |
| if (previousSeen > 0 && age > 0 && age < maxAge/2) { |
| // Average the RSSI with previously seen instances of this scan result |
| double alpha = 0.5 - (double) age / (double) maxAge; |
| level = (int) ((double) level * (1 - alpha) + (double) previousRssi * alpha); |
| } |
| } |
| |
| /** @hide */ |
| public static final int ENABLED = 0; |
| /** @hide */ |
| public static final int AUTO_ROAM_DISABLED = 16; |
| /** @hide */ |
| public static final int AUTO_JOIN_DISABLED = 32; |
| /** @hide */ |
| public static final int AUTHENTICATION_ERROR = 128; |
| |
| /** |
| * Status: indicating join status |
| * @hide |
| */ |
| public int autoJoinStatus; |
| |
| /** |
| * num IP configuration failures |
| * @hide |
| */ |
| public int numIpConfigFailures; |
| |
| /** |
| * @hide |
| * Last time we blacklisted the ScanResult |
| */ |
| public long blackListTimestamp; |
| |
| /** @hide **/ |
| public void setAutoJoinStatus(int status) { |
| if (status < 0) status = 0; |
| if (status == 0) { |
| blackListTimestamp = 0; |
| } else if (status > autoJoinStatus) { |
| blackListTimestamp = System.currentTimeMillis(); |
| } |
| autoJoinStatus = status; |
| } |
| |
| /** |
| * Status: indicating the scan result is not a result |
| * that is part of user's saved configurations |
| * @hide |
| */ |
| public boolean untrusted; |
| |
| /** |
| * Number of time we connected to it |
| * @hide |
| */ |
| public int numConnection; |
| |
| /** |
| * Number of time autojoin used it |
| * @hide |
| */ |
| public int numUsage; |
| |
| /** |
| * The approximate distance to the AP in centimeter, if available. Else |
| * {@link UNSPECIFIED}. |
| * {@hide} |
| */ |
| public int distanceCm; |
| |
| /** |
| * The standard deviation of the distance to the AP, if available. |
| * Else {@link UNSPECIFIED}. |
| * {@hide} |
| */ |
| public int distanceSdCm; |
| |
| /** |
| * Indicates if the scan result represents a passpoint AP |
| */ |
| public boolean passpointNetwork; |
| |
| /** |
| * Indicates if venue name |
| */ |
| public String venueName; |
| |
| /** |
| * Indicates operator name |
| */ |
| public String operatorFriendlyName; |
| |
| /** |
| * {@hide} |
| */ |
| public final static int UNSPECIFIED = -1; |
| /** |
| * @hide |
| */ |
| public boolean is24GHz() { |
| return ScanResult.is24GHz(frequency); |
| } |
| |
| /** |
| * @hide |
| * TODO: makes real freq boundaries |
| */ |
| public static boolean is24GHz(int freq) { |
| return freq > 2400 && freq < 2500; |
| } |
| |
| /** |
| * @hide |
| */ |
| public boolean is5GHz() { |
| return ScanResult.is5GHz(frequency); |
| } |
| |
| /** |
| * @hide |
| * TODO: makes real freq boundaries |
| */ |
| public static boolean is5GHz(int freq) { |
| return freq > 4900 && freq < 5900; |
| } |
| |
| /** information element from beacon |
| * @hide |
| */ |
| public static class InformationElement { |
| public int id; |
| public byte[] bytes; |
| |
| public InformationElement() { |
| } |
| |
| public InformationElement(InformationElement rhs) { |
| this.id = rhs.id; |
| this.bytes = rhs.bytes.clone(); |
| } |
| } |
| |
| /** information elements found in the beacon |
| * @hide |
| */ |
| public InformationElement informationElements[]; |
| |
| /** {@hide} */ |
| public ScanResult(WifiSsid wifiSsid, String BSSID, String caps, int level, int frequency, |
| long tsf) { |
| this.wifiSsid = wifiSsid; |
| this.SSID = (wifiSsid != null) ? wifiSsid.toString() : WifiSsid.NONE; |
| this.BSSID = BSSID; |
| this.capabilities = caps; |
| this.level = level; |
| this.frequency = frequency; |
| this.timestamp = tsf; |
| this.distanceCm = UNSPECIFIED; |
| this.distanceSdCm = UNSPECIFIED; |
| this.channelWidth = UNSPECIFIED; |
| this.centerFreq0 = UNSPECIFIED; |
| this.centerFreq1 = UNSPECIFIED; |
| this.is80211McRTTResponder = false; |
| this.passpointNetwork = false; |
| } |
| |
| /** {@hide} */ |
| public ScanResult(WifiSsid wifiSsid, String BSSID, String caps, int level, int frequency, |
| long tsf, int distCm, int distSdCm) { |
| this.wifiSsid = wifiSsid; |
| this.SSID = (wifiSsid != null) ? wifiSsid.toString() : WifiSsid.NONE; |
| this.BSSID = BSSID; |
| this.capabilities = caps; |
| this.level = level; |
| this.frequency = frequency; |
| this.timestamp = tsf; |
| this.distanceCm = distCm; |
| this.distanceSdCm = distSdCm; |
| this.channelWidth = UNSPECIFIED; |
| this.centerFreq0 = UNSPECIFIED; |
| this.centerFreq1 = UNSPECIFIED; |
| this.is80211McRTTResponder = false; |
| this.passpointNetwork = false; |
| } |
| |
| /** {@hide} */ |
| public ScanResult(WifiSsid wifiSsid, String BSSID, String caps, int level, int frequency, |
| long tsf, int distCm, int distSdCm, int channelWidth, int centerFreq0, int centerFreq1, |
| boolean is80211McRTTResponder) { |
| this.wifiSsid = wifiSsid; |
| this.SSID = (wifiSsid != null) ? wifiSsid.toString() : WifiSsid.NONE; |
| this.BSSID = BSSID; |
| this.capabilities = caps; |
| this.level = level; |
| this.frequency = frequency; |
| this.timestamp = tsf; |
| this.distanceCm = distCm; |
| this.distanceSdCm = distSdCm; |
| this.channelWidth = channelWidth; |
| this.centerFreq0 = centerFreq0; |
| this.centerFreq1 = centerFreq1; |
| this.is80211McRTTResponder = is80211McRTTResponder; |
| this.passpointNetwork = false; |
| } |
| |
| /** copy constructor {@hide} */ |
| public ScanResult(ScanResult source) { |
| if (source != null) { |
| wifiSsid = source.wifiSsid; |
| SSID = source.SSID; |
| BSSID = source.BSSID; |
| capabilities = source.capabilities; |
| level = source.level; |
| frequency = source.frequency; |
| channelWidth = source.channelWidth; |
| centerFreq0 = source.centerFreq0; |
| centerFreq1 = source.centerFreq1; |
| is80211McRTTResponder = source.is80211McRTTResponder; |
| timestamp = source.timestamp; |
| distanceCm = source.distanceCm; |
| distanceSdCm = source.distanceSdCm; |
| seen = source.seen; |
| autoJoinStatus = source.autoJoinStatus; |
| untrusted = source.untrusted; |
| numConnection = source.numConnection; |
| numUsage = source.numUsage; |
| numIpConfigFailures = source.numIpConfigFailures; |
| isAutoJoinCandidate = source.isAutoJoinCandidate; |
| passpointNetwork = source.passpointNetwork; |
| venueName = source.venueName; |
| operatorFriendlyName = source.operatorFriendlyName; |
| } |
| } |
| |
| /** empty scan result |
| * |
| * {@hide} |
| * */ |
| public ScanResult() { |
| } |
| |
| @Override |
| public String toString() { |
| StringBuffer sb = new StringBuffer(); |
| String none = "<none>"; |
| |
| sb.append("SSID: "). |
| append(wifiSsid == null ? WifiSsid.NONE : wifiSsid). |
| append(", BSSID: "). |
| append(BSSID == null ? none : BSSID). |
| append(", capabilities: "). |
| append(capabilities == null ? none : capabilities). |
| append(", level: "). |
| append(level). |
| append(", frequency: "). |
| append(frequency). |
| append(", timestamp: "). |
| append(timestamp); |
| |
| sb.append(", distance: ").append((distanceCm != UNSPECIFIED ? distanceCm : "?")). |
| append("(cm)"); |
| sb.append(", distanceSd: ").append((distanceSdCm != UNSPECIFIED ? distanceSdCm : "?")). |
| append("(cm)"); |
| |
| sb.append(", passpoint: ").append(passpointNetwork ? "yes" : "no"); |
| if (autoJoinStatus != 0) { |
| sb.append(", status: ").append(autoJoinStatus); |
| } |
| sb.append(", ChannelBandwidth: ").append(channelWidth); |
| sb.append(", centerFreq0: ").append(centerFreq0); |
| sb.append(", centerFreq1: ").append(centerFreq1); |
| sb.append(", 80211mcResponder: ").append(is80211McRTTResponder? |
| "is supported":"is not supported"); |
| return sb.toString(); |
| } |
| |
| /** Implement the Parcelable interface {@hide} */ |
| public int describeContents() { |
| return 0; |
| } |
| |
| /** Implement the Parcelable interface {@hide} */ |
| public void writeToParcel(Parcel dest, int flags) { |
| if (wifiSsid != null) { |
| dest.writeInt(1); |
| wifiSsid.writeToParcel(dest, flags); |
| } else { |
| dest.writeInt(0); |
| } |
| dest.writeString(BSSID); |
| dest.writeString(capabilities); |
| dest.writeInt(level); |
| dest.writeInt(frequency); |
| dest.writeLong(timestamp); |
| dest.writeInt(distanceCm); |
| dest.writeInt(distanceSdCm); |
| dest.writeInt(channelWidth); |
| dest.writeInt(centerFreq0); |
| dest.writeInt(centerFreq1); |
| dest.writeInt(is80211McRTTResponder ? 1 : 0); |
| dest.writeLong(seen); |
| dest.writeInt(autoJoinStatus); |
| dest.writeInt(untrusted ? 1 : 0); |
| dest.writeInt(numConnection); |
| dest.writeInt(numUsage); |
| dest.writeInt(numIpConfigFailures); |
| dest.writeInt(isAutoJoinCandidate); |
| dest.writeInt(passpointNetwork ? 1 : 0); |
| dest.writeString(venueName); |
| dest.writeString(operatorFriendlyName); |
| |
| if (informationElements != null) { |
| dest.writeInt(informationElements.length); |
| for (int i = 0; i < informationElements.length; i++) { |
| dest.writeInt(informationElements[i].id); |
| dest.writeInt(informationElements[i].bytes.length); |
| dest.writeByteArray(informationElements[i].bytes); |
| } |
| } else { |
| dest.writeInt(0); |
| } |
| } |
| |
| /** Implement the Parcelable interface {@hide} */ |
| public static final Creator<ScanResult> CREATOR = |
| new Creator<ScanResult>() { |
| public ScanResult createFromParcel(Parcel in) { |
| WifiSsid wifiSsid = null; |
| if (in.readInt() == 1) { |
| wifiSsid = WifiSsid.CREATOR.createFromParcel(in); |
| } |
| ScanResult sr = new ScanResult( |
| wifiSsid, |
| in.readString(), |
| in.readString(), |
| in.readInt(), |
| in.readInt(), |
| in.readLong(), |
| in.readInt(), |
| in.readInt(), |
| in.readInt(), |
| in.readInt(), |
| in.readInt(), |
| in.readInt() == 1 |
| ); |
| sr.seen = in.readLong(); |
| sr.autoJoinStatus = in.readInt(); |
| sr.untrusted = in.readInt() != 0; |
| sr.numConnection = in.readInt(); |
| sr.numUsage = in.readInt(); |
| sr.numIpConfigFailures = in.readInt(); |
| sr.isAutoJoinCandidate = in.readInt(); |
| sr.passpointNetwork = in.readInt() == 1; |
| sr.venueName = in.readString(); |
| sr.operatorFriendlyName = in.readString(); |
| int n = in.readInt(); |
| if (n != 0) { |
| sr.informationElements = new InformationElement[n]; |
| for (int i = 0; i < n; i++) { |
| sr.informationElements[i] = new InformationElement(); |
| sr.informationElements[i].id = in.readInt(); |
| int len = in.readInt(); |
| sr.informationElements[i].bytes = new byte[len]; |
| in.readByteArray(sr.informationElements[i].bytes); |
| } |
| } |
| return sr; |
| } |
| |
| public ScanResult[] newArray(int size) { |
| return new ScanResult[size]; |
| } |
| }; |
| } |