1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
/*
* Copyright (C) 2017 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.telephony;
import android.os.Parcel;
import android.os.Parcelable;
import java.util.Arrays;
/**
* Defines a request to peform a network scan.
*
* This class defines whether the network scan will be performed only once or periodically until
* cancelled, when the scan is performed periodically, the time interval is not controlled by the
* user but defined by the modem vendor.
* @hide
*/
public final class NetworkScanRequest implements Parcelable {
// Below size limits for RAN/Band/Channel are for pre-treble modems and will be removed later.
/** @hide */
public static final int MAX_RADIO_ACCESS_NETWORKS = 8;
/** @hide */
public static final int MAX_BANDS = 8;
/** @hide */
public static final int MAX_CHANNELS = 32;
/** Performs the scan only once */
public static final int SCAN_TYPE_ONE_SHOT = 0;
/**
* Performs the scan periodically until cancelled
*
* The modem will start new scans periodically, and the interval between two scans is usually
* multiple minutes.
* */
public static final int SCAN_TYPE_PERIODIC = 1;
/** Defines the type of the scan. */
public int scanType;
/** Describes the radio access technologies with bands or channels that need to be scanned. */
public RadioAccessSpecifier[] specifiers;
/**
* Creates a new NetworkScanRequest with scanType and network specifiers
*
* @param scanType The type of the scan
* @param specifiers the radio network with bands / channels to be scanned
*/
public NetworkScanRequest(int scanType, RadioAccessSpecifier[] specifiers) {
this.scanType = scanType;
this.specifiers = specifiers;
}
@Override
public int describeContents() {
return 0;
}
@Override
public void writeToParcel(Parcel dest, int flags) {
dest.writeInt(scanType);
dest.writeParcelableArray(specifiers, flags);
}
private NetworkScanRequest(Parcel in) {
scanType = in.readInt();
specifiers = (RadioAccessSpecifier[]) in.readParcelableArray(
Object.class.getClassLoader(),
RadioAccessSpecifier.class);
}
@Override
public boolean equals (Object o) {
NetworkScanRequest nsr;
try {
nsr = (NetworkScanRequest) o;
} catch (ClassCastException ex) {
return false;
}
if (o == null) {
return false;
}
return (scanType == nsr.scanType
&& Arrays.equals(specifiers, nsr.specifiers));
}
@Override
public int hashCode () {
return ((scanType * 31)
+ (Arrays.hashCode(specifiers)) * 37);
}
public static final Creator<NetworkScanRequest> CREATOR =
new Creator<NetworkScanRequest>() {
@Override
public NetworkScanRequest createFromParcel(Parcel in) {
return new NetworkScanRequest(in);
}
@Override
public NetworkScanRequest[] newArray(int size) {
return new NetworkScanRequest[size];
}
};
}
|
