738803fee6
Create new (hidden) APIs to scan a specified channel set. This is mainly for location service for now, as doing frequent full scans (including DFS channel) kills battery. This set of new APIs contains: - API to query available channel list for scanning, and DFS channels are marked - API to scan a specified channel set Selective scan results are returned in the same way as normal full scan ones. In order not to intrude full scan results, BSS_FLUSH is NOT performed before a selective scan. Therefore, selective scan results may contain results that's not in the given channel set, and post-filtering may be required for location service use. Bug: 12610436 Change-Id: Icced18dd9b54f6dd92c0c2874d31518d56af8163
88 lines
2.6 KiB
Java
88 lines
2.6 KiB
Java
/*
|
|
* Copyright (c) 2014, 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;
|
|
|
|
import java.util.ArrayList;
|
|
import java.util.Collection;
|
|
|
|
/**
|
|
* Bundle of customized scan settings
|
|
*
|
|
* @see WifiManager#startCustomizedScan
|
|
*
|
|
* @hide
|
|
*/
|
|
public class ScanSettings implements Parcelable {
|
|
|
|
/** channel set to scan. this can be null or empty, indicating a full scan */
|
|
public Collection<WifiChannel> channelSet;
|
|
|
|
/** public constructor */
|
|
public ScanSettings() { }
|
|
|
|
/** copy constructor */
|
|
public ScanSettings(ScanSettings source) {
|
|
if (source.channelSet != null)
|
|
channelSet = new ArrayList<WifiChannel>(source.channelSet);
|
|
}
|
|
|
|
/** check for validity */
|
|
public boolean isValid() {
|
|
for (WifiChannel channel : channelSet)
|
|
if (!channel.isValid()) return false;
|
|
return true;
|
|
}
|
|
|
|
/** implement Parcelable interface */
|
|
@Override
|
|
public int describeContents() {
|
|
return 0;
|
|
}
|
|
|
|
/** implement Parcelable interface */
|
|
@Override
|
|
public void writeToParcel(Parcel out, int flags) {
|
|
out.writeInt(channelSet == null ? 0 : channelSet.size());
|
|
if (channelSet != null)
|
|
for (WifiChannel channel : channelSet) channel.writeToParcel(out, flags);
|
|
}
|
|
|
|
/** implement Parcelable interface */
|
|
public static final Parcelable.Creator<ScanSettings> CREATOR =
|
|
new Parcelable.Creator<ScanSettings>() {
|
|
@Override
|
|
public ScanSettings createFromParcel(Parcel in) {
|
|
ScanSettings settings = new ScanSettings();
|
|
int size = in.readInt();
|
|
if (size > 0) {
|
|
settings.channelSet = new ArrayList<WifiChannel>(size);
|
|
while (size-- > 0)
|
|
settings.channelSet.add(WifiChannel.CREATOR.createFromParcel(in));
|
|
}
|
|
return settings;
|
|
}
|
|
|
|
@Override
|
|
public ScanSettings[] newArray(int size) {
|
|
return new ScanSettings[size];
|
|
}
|
|
};
|
|
}
|