blob: da13d48f5ed82c98ea78054c77dc60b13075c569 [file] [log] [blame]
b.liue9582032025-04-17 19:18:16 +08001/*
2 * ACS - Automatic Channel Selection module
3 * Copyright (c) 2011, Atheros Communications
4 * Copyright (c) 2013, Qualcomm Atheros, Inc.
5 *
6 * This software may be distributed under the terms of the BSD license.
7 * See README for more details.
8 */
9
10#include "utils/includes.h"
11#include <math.h>
12
13#include "utils/common.h"
14#include "utils/list.h"
15#include "common/ieee802_11_defs.h"
16#include "common/hw_features_common.h"
17#include "common/wpa_ctrl.h"
18#include "drivers/driver.h"
19#include "hostapd.h"
20#include "ap_drv_ops.h"
21#include "ap_config.h"
22#include "hw_features.h"
23#include "acs.h"
24
25/*
26 * Automatic Channel Selection
27 * ===========================
28 *
29 * More info at
30 * ------------
31 * http://wireless.kernel.org/en/users/Documentation/acs
32 *
33 * How to use
34 * ----------
35 * - make sure you have CONFIG_ACS=y in hostapd's .config
36 * - use channel=0 or channel=acs to enable ACS
37 *
38 * How does it work
39 * ----------------
40 * 1. passive scans are used to collect survey data
41 * (it is assumed that scan trigger collection of survey data in driver)
42 * 2. interference factor is calculated for each channel
43 * 3. ideal channel is picked depending on channel width by using adjacent
44 * channel interference factors
45 *
46 * Known limitations
47 * -----------------
48 * - Current implementation depends heavily on the amount of time willing to
49 * spend gathering survey data during hostapd startup. Short traffic bursts
50 * may be missed and a suboptimal channel may be picked.
51 * - Ideal channel may end up overlapping a channel with 40 MHz intolerant BSS
52 *
53 * Todo / Ideas
54 * ------------
55 * - implement other interference computation methods
56 * - BSS/RSSI based
57 * - spectral scan based
58 * (should be possibly to hook this up with current ACS scans)
59 * - add wpa_supplicant support (for P2P)
60 * - collect a histogram of interference over time allowing more educated
61 * guess about an ideal channel (perhaps CSA could be used to migrate AP to a
62 * new "better" channel while running)
63 * - include neighboring BSS scan to avoid conflicts with 40 MHz intolerant BSSs
64 * when choosing the ideal channel
65 *
66 * Survey interference factor implementation details
67 * -------------------------------------------------
68 * Generic interference_factor in struct hostapd_channel_data is used.
69 *
70 * The survey interference factor is defined as the ratio of the
71 * observed busy time over the time we spent on the channel,
72 * this value is then amplified by the observed noise floor on
73 * the channel in comparison to the lowest noise floor observed
74 * on the entire band.
75 *
76 * This corresponds to:
77 * ---
78 * (busy time - tx time) / (active time - tx time) * 2^(chan_nf + band_min_nf)
79 * ---
80 *
81 * The coefficient of 2 reflects the way power in "far-field"
82 * radiation decreases as the square of distance from the antenna [1].
83 * What this does is it decreases the observed busy time ratio if the
84 * noise observed was low but increases it if the noise was high,
85 * proportionally to the way "far field" radiation changes over
86 * distance.
87 *
88 * If channel busy time is not available the fallback is to use channel RX time.
89 *
90 * Since noise floor is in dBm it is necessary to convert it into Watts so that
91 * combined channel interference (e.g., HT40, which uses two channels) can be
92 * calculated easily.
93 * ---
94 * (busy time - tx time) / (active time - tx time) *
95 * 2^(10^(chan_nf/10) + 10^(band_min_nf/10))
96 * ---
97 *
98 * However to account for cases where busy/rx time is 0 (channel load is then
99 * 0%) channel noise floor signal power is combined into the equation so a
100 * channel with lower noise floor is preferred. The equation becomes:
101 * ---
102 * 10^(chan_nf/5) + (busy time - tx time) / (active time - tx time) *
103 * 2^(10^(chan_nf/10) + 10^(band_min_nf/10))
104 * ---
105 *
106 * All this "interference factor" is purely subjective and only time
107 * will tell how usable this is. By using the minimum noise floor we
108 * remove any possible issues due to card calibration. The computation
109 * of the interference factor then is dependent on what the card itself
110 * picks up as the minimum noise, not an actual real possible card
111 * noise value.
112 *
113 * Total interference computation details
114 * --------------------------------------
115 * The above channel interference factor is calculated with no respect to
116 * target operational bandwidth.
117 *
118 * To find an ideal channel the above data is combined by taking into account
119 * the target operational bandwidth and selected band. E.g., on 2.4 GHz channels
120 * overlap with 20 MHz bandwidth, but there is no overlap for 20 MHz bandwidth
121 * on 5 GHz.
122 *
123 * Each valid and possible channel spec (i.e., channel + width) is taken and its
124 * interference factor is computed by summing up interferences of each channel
125 * it overlaps. The one with least total interference is picked up.
126 *
127 * Note: This implies base channel interference factor must be non-negative
128 * allowing easy summing up.
129 *
130 * Example ACS analysis printout
131 * -----------------------------
132 *
133 * ACS: Trying survey-based ACS
134 * ACS: Survey analysis for channel 1 (2412 MHz)
135 * ACS: 1: min_nf=-113 interference_factor=0.0802469 nf=-113 time=162 busy=0 rx=13
136 * ACS: 2: min_nf=-113 interference_factor=0.0745342 nf=-113 time=161 busy=0 rx=12
137 * ACS: 3: min_nf=-113 interference_factor=0.0679012 nf=-113 time=162 busy=0 rx=11
138 * ACS: 4: min_nf=-113 interference_factor=0.0310559 nf=-113 time=161 busy=0 rx=5
139 * ACS: 5: min_nf=-113 interference_factor=0.0248447 nf=-113 time=161 busy=0 rx=4
140 * ACS: * interference factor average: 0.0557166
141 * ACS: Survey analysis for channel 2 (2417 MHz)
142 * ACS: 1: min_nf=-113 interference_factor=0.0185185 nf=-113 time=162 busy=0 rx=3
143 * ACS: 2: min_nf=-113 interference_factor=0.0246914 nf=-113 time=162 busy=0 rx=4
144 * ACS: 3: min_nf=-113 interference_factor=0.037037 nf=-113 time=162 busy=0 rx=6
145 * ACS: 4: min_nf=-113 interference_factor=0.149068 nf=-113 time=161 busy=0 rx=24
146 * ACS: 5: min_nf=-113 interference_factor=0.0248447 nf=-113 time=161 busy=0 rx=4
147 * ACS: * interference factor average: 0.050832
148 * ACS: Survey analysis for channel 3 (2422 MHz)
149 * ACS: 1: min_nf=-113 interference_factor=2.51189e-23 nf=-113 time=162 busy=0 rx=0
150 * ACS: 2: min_nf=-113 interference_factor=0.0185185 nf=-113 time=162 busy=0 rx=3
151 * ACS: 3: min_nf=-113 interference_factor=0.0186335 nf=-113 time=161 busy=0 rx=3
152 * ACS: 4: min_nf=-113 interference_factor=0.0186335 nf=-113 time=161 busy=0 rx=3
153 * ACS: 5: min_nf=-113 interference_factor=0.0186335 nf=-113 time=161 busy=0 rx=3
154 * ACS: * interference factor average: 0.0148838
155 * ACS: Survey analysis for channel 4 (2427 MHz)
156 * ACS: 1: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=162 busy=0 rx=0
157 * ACS: 2: min_nf=-114 interference_factor=0.0555556 nf=-114 time=162 busy=0 rx=9
158 * ACS: 3: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=161 busy=0 rx=0
159 * ACS: 4: min_nf=-114 interference_factor=0.0186335 nf=-114 time=161 busy=0 rx=3
160 * ACS: 5: min_nf=-114 interference_factor=0.00621118 nf=-114 time=161 busy=0 rx=1
161 * ACS: * interference factor average: 0.0160801
162 * ACS: Survey analysis for channel 5 (2432 MHz)
163 * ACS: 1: min_nf=-114 interference_factor=0.409938 nf=-113 time=161 busy=0 rx=66
164 * ACS: 2: min_nf=-114 interference_factor=0.0432099 nf=-113 time=162 busy=0 rx=7
165 * ACS: 3: min_nf=-114 interference_factor=0.0124224 nf=-113 time=161 busy=0 rx=2
166 * ACS: 4: min_nf=-114 interference_factor=0.677019 nf=-113 time=161 busy=0 rx=109
167 * ACS: 5: min_nf=-114 interference_factor=0.0186335 nf=-114 time=161 busy=0 rx=3
168 * ACS: * interference factor average: 0.232244
169 * ACS: Survey analysis for channel 6 (2437 MHz)
170 * ACS: 1: min_nf=-113 interference_factor=0.552795 nf=-113 time=161 busy=0 rx=89
171 * ACS: 2: min_nf=-113 interference_factor=0.0807453 nf=-112 time=161 busy=0 rx=13
172 * ACS: 3: min_nf=-113 interference_factor=0.0310559 nf=-113 time=161 busy=0 rx=5
173 * ACS: 4: min_nf=-113 interference_factor=0.434783 nf=-112 time=161 busy=0 rx=70
174 * ACS: 5: min_nf=-113 interference_factor=0.0621118 nf=-113 time=161 busy=0 rx=10
175 * ACS: * interference factor average: 0.232298
176 * ACS: Survey analysis for channel 7 (2442 MHz)
177 * ACS: 1: min_nf=-113 interference_factor=0.440994 nf=-112 time=161 busy=0 rx=71
178 * ACS: 2: min_nf=-113 interference_factor=0.385093 nf=-113 time=161 busy=0 rx=62
179 * ACS: 3: min_nf=-113 interference_factor=0.0372671 nf=-113 time=161 busy=0 rx=6
180 * ACS: 4: min_nf=-113 interference_factor=0.0372671 nf=-113 time=161 busy=0 rx=6
181 * ACS: 5: min_nf=-113 interference_factor=0.0745342 nf=-113 time=161 busy=0 rx=12
182 * ACS: * interference factor average: 0.195031
183 * ACS: Survey analysis for channel 8 (2447 MHz)
184 * ACS: 1: min_nf=-114 interference_factor=0.0496894 nf=-112 time=161 busy=0 rx=8
185 * ACS: 2: min_nf=-114 interference_factor=0.0496894 nf=-114 time=161 busy=0 rx=8
186 * ACS: 3: min_nf=-114 interference_factor=0.0372671 nf=-113 time=161 busy=0 rx=6
187 * ACS: 4: min_nf=-114 interference_factor=0.12963 nf=-113 time=162 busy=0 rx=21
188 * ACS: 5: min_nf=-114 interference_factor=0.166667 nf=-114 time=162 busy=0 rx=27
189 * ACS: * interference factor average: 0.0865885
190 * ACS: Survey analysis for channel 9 (2452 MHz)
191 * ACS: 1: min_nf=-114 interference_factor=0.0124224 nf=-114 time=161 busy=0 rx=2
192 * ACS: 2: min_nf=-114 interference_factor=0.0310559 nf=-114 time=161 busy=0 rx=5
193 * ACS: 3: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=161 busy=0 rx=0
194 * ACS: 4: min_nf=-114 interference_factor=0.00617284 nf=-114 time=162 busy=0 rx=1
195 * ACS: 5: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=162 busy=0 rx=0
196 * ACS: * interference factor average: 0.00993022
197 * ACS: Survey analysis for channel 10 (2457 MHz)
198 * ACS: 1: min_nf=-114 interference_factor=0.00621118 nf=-114 time=161 busy=0 rx=1
199 * ACS: 2: min_nf=-114 interference_factor=0.00621118 nf=-114 time=161 busy=0 rx=1
200 * ACS: 3: min_nf=-114 interference_factor=0.00621118 nf=-114 time=161 busy=0 rx=1
201 * ACS: 4: min_nf=-114 interference_factor=0.0493827 nf=-114 time=162 busy=0 rx=8
202 * ACS: 5: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=162 busy=0 rx=0
203 * ACS: * interference factor average: 0.0136033
204 * ACS: Survey analysis for channel 11 (2462 MHz)
205 * ACS: 1: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=161 busy=0 rx=0
206 * ACS: 2: min_nf=-114 interference_factor=2.51189e-23 nf=-113 time=161 busy=0 rx=0
207 * ACS: 3: min_nf=-114 interference_factor=2.51189e-23 nf=-113 time=161 busy=0 rx=0
208 * ACS: 4: min_nf=-114 interference_factor=0.0432099 nf=-114 time=162 busy=0 rx=7
209 * ACS: 5: min_nf=-114 interference_factor=0.0925926 nf=-114 time=162 busy=0 rx=15
210 * ACS: * interference factor average: 0.0271605
211 * ACS: Survey analysis for channel 12 (2467 MHz)
212 * ACS: 1: min_nf=-114 interference_factor=0.0621118 nf=-113 time=161 busy=0 rx=10
213 * ACS: 2: min_nf=-114 interference_factor=0.00621118 nf=-114 time=161 busy=0 rx=1
214 * ACS: 3: min_nf=-114 interference_factor=2.51189e-23 nf=-113 time=162 busy=0 rx=0
215 * ACS: 4: min_nf=-114 interference_factor=2.51189e-23 nf=-113 time=162 busy=0 rx=0
216 * ACS: 5: min_nf=-114 interference_factor=0.00617284 nf=-113 time=162 busy=0 rx=1
217 * ACS: * interference factor average: 0.0148992
218 * ACS: Survey analysis for channel 13 (2472 MHz)
219 * ACS: 1: min_nf=-114 interference_factor=0.0745342 nf=-114 time=161 busy=0 rx=12
220 * ACS: 2: min_nf=-114 interference_factor=0.0555556 nf=-114 time=162 busy=0 rx=9
221 * ACS: 3: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=162 busy=0 rx=0
222 * ACS: 4: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=162 busy=0 rx=0
223 * ACS: 5: min_nf=-114 interference_factor=1.58489e-23 nf=-114 time=162 busy=0 rx=0
224 * ACS: * interference factor average: 0.0260179
225 * ACS: Survey analysis for selected bandwidth 20MHz
226 * ACS: * channel 1: total interference = 0.121432
227 * ACS: * channel 2: total interference = 0.137512
228 * ACS: * channel 3: total interference = 0.369757
229 * ACS: * channel 4: total interference = 0.546338
230 * ACS: * channel 5: total interference = 0.690538
231 * ACS: * channel 6: total interference = 0.762242
232 * ACS: * channel 7: total interference = 0.756092
233 * ACS: * channel 8: total interference = 0.537451
234 * ACS: * channel 9: total interference = 0.332313
235 * ACS: * channel 10: total interference = 0.152182
236 * ACS: * channel 11: total interference = 0.0916111
237 * ACS: * channel 12: total interference = 0.0816809
238 * ACS: * channel 13: total interference = 0.0680776
239 * ACS: Ideal channel is 13 (2472 MHz) with total interference factor of 0.0680776
240 *
241 * [1] http://en.wikipedia.org/wiki/Near_and_far_field
242 */
243
244enum bw_type {
245 ACS_BW40,
246 ACS_BW80,
247 ACS_BW160,
248};
249
250struct bw_item {
251 int first;
252 int last;
253 int center_chan;
254};
255
256static const struct bw_item bw_40[] = {
257 { 5180, 5200, 38 }, { 5220, 5240, 46 }, { 5260, 5280, 54 },
258 { 5300, 5320, 62 }, { 5500, 5520, 102 }, { 5540, 5560, 110 },
259 { 5580, 5600, 110 }, { 5620, 5640, 126}, { 5660, 5680, 134 },
260 { 5700, 5720, 142 }, { 5745, 5765, 151 }, { 5785, 5805, 159 },
261 { 5825, 5845, 167 }, { 5865, 5885, 175 },
262 { 5955, 5975, 3 }, { 5995, 6015, 11 }, { 6035, 6055, 19 },
263 { 6075, 6095, 27 }, { 6115, 6135, 35 }, { 6155, 6175, 43 },
264 { 6195, 6215, 51 }, { 6235, 6255, 59 }, { 6275, 6295, 67 },
265 { 6315, 6335, 75 }, { 6355, 6375, 83 }, { 6395, 6415, 91 },
266 { 6435, 6455, 99 }, { 6475, 6495, 107 }, { 6515, 6535, 115 },
267 { 6555, 6575, 123 }, { 6595, 6615, 131 }, { 6635, 6655, 139 },
268 { 6675, 6695, 147 }, { 6715, 6735, 155 }, { 6755, 6775, 163 },
269 { 6795, 6815, 171 }, { 6835, 6855, 179 }, { 6875, 6895, 187 },
270 { 6915, 6935, 195 }, { 6955, 6975, 203 }, { 6995, 7015, 211 },
271 { 7035, 7055, 219 }, { 7075, 7095, 227}, { -1, -1, -1 }
272};
273static const struct bw_item bw_80[] = {
274 { 5180, 5240, 42 }, { 5260, 5320, 58 }, { 5500, 5560, 106 },
275 { 5580, 5640, 122 }, { 5660, 5720, 138 }, { 5745, 5805, 155 },
276 { 5825, 5885, 171},
277 { 5955, 6015, 7 }, { 6035, 6095, 23 }, { 6115, 6175, 39 },
278 { 6195, 6255, 55 }, { 6275, 6335, 71 }, { 6355, 6415, 87 },
279 { 6435, 6495, 103 }, { 6515, 6575, 119 }, { 6595, 6655, 135 },
280 { 6675, 6735, 151 }, { 6755, 6815, 167 }, { 6835, 6895, 183 },
281 { 6915, 6975, 199 }, { 6995, 7055, 215 }, { -1, -1, -1 }
282};
283static const struct bw_item bw_160[] = {
284 { 5180, 5320, 50 }, { 5500, 5640, 114 }, { 5745, 5885, 163 },
285 { 5955, 6095, 15 }, { 6115, 6255, 47 }, { 6275, 6415, 79 },
286 { 6435, 6575, 111 }, { 6595, 6735, 143 },
287 { 6755, 6895, 175 }, { 6915, 7055, 207 }, { -1, -1, -1 }
288};
289static const struct bw_item *bw_desc[] = {
290 [ACS_BW40] = bw_40,
291 [ACS_BW80] = bw_80,
292 [ACS_BW160] = bw_160,
293};
294
295
296static int acs_request_scan(struct hostapd_iface *iface);
297static int acs_survey_is_sufficient(struct freq_survey *survey);
298
299
300static void acs_clean_chan_surveys(struct hostapd_channel_data *chan)
301{
302 struct freq_survey *survey, *tmp;
303
304 if (dl_list_empty(&chan->survey_list))
305 return;
306
307 dl_list_for_each_safe(survey, tmp, &chan->survey_list,
308 struct freq_survey, list) {
309 dl_list_del(&survey->list);
310 os_free(survey);
311 }
312}
313
314
315static void acs_cleanup_mode(struct hostapd_hw_modes *mode)
316{
317 int i;
318 struct hostapd_channel_data *chan;
319
320 for (i = 0; i < mode->num_channels; i++) {
321 chan = &mode->channels[i];
322
323 if (chan->flag & HOSTAPD_CHAN_SURVEY_LIST_INITIALIZED)
324 acs_clean_chan_surveys(chan);
325
326 dl_list_init(&chan->survey_list);
327 chan->flag |= HOSTAPD_CHAN_SURVEY_LIST_INITIALIZED;
328 chan->min_nf = 0;
329 chan->punct_bitmap = 0;
330 }
331}
332
333
334void acs_cleanup(struct hostapd_iface *iface)
335{
336 int i;
337
338 for (i = 0; i < iface->num_hw_features; i++)
339 acs_cleanup_mode(&iface->hw_features[i]);
340
341 iface->chans_surveyed = 0;
342 iface->acs_num_completed_scans = 0;
343}
344
345
346static void acs_fail(struct hostapd_iface *iface)
347{
348 wpa_printf(MSG_ERROR, "ACS: Failed to start");
349 acs_cleanup(iface);
350 hostapd_disable_iface(iface);
351}
352
353
354static long double
355acs_survey_interference_factor(struct freq_survey *survey, s8 min_nf)
356{
357 long double factor, busy, total;
358
359 if (survey->filled & SURVEY_HAS_CHAN_TIME_BUSY)
360 busy = survey->channel_time_busy;
361 else if (survey->filled & SURVEY_HAS_CHAN_TIME_RX)
362 busy = survey->channel_time_rx;
363 else {
364 wpa_printf(MSG_ERROR, "ACS: Survey data missing");
365 return 0;
366 }
367
368 total = survey->channel_time;
369
370 if (survey->filled & SURVEY_HAS_CHAN_TIME_TX) {
371 busy -= survey->channel_time_tx;
372 total -= survey->channel_time_tx;
373 }
374
375 /* TODO: figure out the best multiplier for noise floor base */
376 factor = pow(10, survey->nf / 5.0L) +
377 (total ? (busy / total) : 0) *
378 pow(2, pow(10, (long double) survey->nf / 10.0L) -
379 pow(10, (long double) min_nf / 10.0L));
380
381 return factor;
382}
383
384
385static void
386acs_survey_chan_interference_factor(struct hostapd_iface *iface,
387 struct hostapd_channel_data *chan)
388{
389 struct freq_survey *survey;
390 unsigned int i = 0;
391 long double int_factor = 0;
392 unsigned count = 0;
393
394 if (dl_list_empty(&chan->survey_list) ||
395 (chan->flag & HOSTAPD_CHAN_DISABLED))
396 return;
397
398 chan->interference_factor = 0;
399
400 dl_list_for_each(survey, &chan->survey_list, struct freq_survey, list)
401 {
402 i++;
403
404 if (!acs_survey_is_sufficient(survey)) {
405 wpa_printf(MSG_DEBUG, "ACS: %d: insufficient data", i);
406 continue;
407 }
408
409 count++;
410 int_factor = acs_survey_interference_factor(survey,
411 iface->lowest_nf);
412 chan->interference_factor += int_factor;
413 wpa_printf(MSG_DEBUG, "ACS: %d: min_nf=%d interference_factor=%Lg nf=%d time=%lu busy=%lu rx=%lu",
414 i, chan->min_nf, int_factor,
415 survey->nf, (unsigned long) survey->channel_time,
416 (unsigned long) survey->channel_time_busy,
417 (unsigned long) survey->channel_time_rx);
418 }
419
420 if (count)
421 chan->interference_factor /= count;
422}
423
424
425static bool acs_usable_bw_chan(const struct hostapd_channel_data *chan,
426 enum bw_type bw)
427{
428 unsigned int i = 0;
429
430 while (bw_desc[bw][i].first != -1) {
431 if (chan->freq == bw_desc[bw][i].first)
432 return true;
433 i++;
434 }
435
436 return false;
437}
438
439
440static int acs_get_bw_center_chan(int freq, enum bw_type bw)
441{
442 unsigned int i = 0;
443
444 while (bw_desc[bw][i].first != -1) {
445 if (freq >= bw_desc[bw][i].first &&
446 freq <= bw_desc[bw][i].last)
447 return bw_desc[bw][i].center_chan;
448 i++;
449 }
450
451 return 0;
452}
453
454
455static int acs_survey_is_sufficient(struct freq_survey *survey)
456{
457 if (!(survey->filled & SURVEY_HAS_NF)) {
458 survey->nf = -95;
459 wpa_printf(MSG_INFO,
460 "ACS: Survey for freq %d is missing noise floor",
461 survey->freq);
462 }
463
464 if (!(survey->filled & SURVEY_HAS_CHAN_TIME)) {
465 survey->channel_time = 0;
466 wpa_printf(MSG_INFO,
467 "ACS: Survey for freq %d is missing channel time",
468 survey->freq);
469 }
470
471 if (!(survey->filled & SURVEY_HAS_CHAN_TIME_BUSY) &&
472 !(survey->filled & SURVEY_HAS_CHAN_TIME_RX)) {
473 wpa_printf(MSG_INFO,
474 "ACS: Survey for freq %d is missing RX and busy time (at least one is required)",
475 survey->freq);
476 }
477
478 return 1;
479}
480
481
482static int acs_survey_list_is_sufficient(struct hostapd_channel_data *chan)
483{
484 struct freq_survey *survey;
485 int ret = -1;
486
487 dl_list_for_each(survey, &chan->survey_list, struct freq_survey, list)
488 {
489 if (acs_survey_is_sufficient(survey)) {
490 ret = 1;
491 break;
492 }
493 ret = 0;
494 }
495
496 if (ret == -1)
497 ret = 1; /* no survey list entries */
498
499 if (!ret) {
500 wpa_printf(MSG_INFO,
501 "ACS: Channel %d has insufficient survey data",
502 chan->chan);
503 }
504
505 return ret;
506}
507
508
509static int acs_surveys_are_sufficient_mode(struct hostapd_hw_modes *mode)
510{
511 int i;
512 struct hostapd_channel_data *chan;
513
514 for (i = 0; i < mode->num_channels; i++) {
515 chan = &mode->channels[i];
516 if (!(chan->flag & HOSTAPD_CHAN_DISABLED) &&
517 acs_survey_list_is_sufficient(chan))
518 return 1;
519 }
520
521 return 0;
522}
523
524
525static int acs_surveys_are_sufficient(struct hostapd_iface *iface)
526{
527 int i;
528 struct hostapd_hw_modes *mode;
529
530 for (i = 0; i < iface->num_hw_features; i++) {
531 mode = &iface->hw_features[i];
532 if (!hostapd_hw_skip_mode(iface, mode) &&
533 acs_surveys_are_sufficient_mode(mode))
534 return 1;
535 }
536
537 return 0;
538}
539
540
541static int acs_usable_chan(struct hostapd_channel_data *chan)
542{
543 return !dl_list_empty(&chan->survey_list) &&
544 !(chan->flag & HOSTAPD_CHAN_DISABLED) &&
545 acs_survey_list_is_sufficient(chan);
546}
547
548
549static int is_in_chanlist(struct hostapd_iface *iface,
550 struct hostapd_channel_data *chan)
551{
552 if (!iface->conf->acs_ch_list.num)
553 return 1;
554
555 return freq_range_list_includes(&iface->conf->acs_ch_list, chan->chan);
556}
557
558
559static int is_in_freqlist(struct hostapd_iface *iface,
560 struct hostapd_channel_data *chan)
561{
562 if (!iface->conf->acs_freq_list.num)
563 return 1;
564
565 return freq_range_list_includes(&iface->conf->acs_freq_list,
566 chan->freq);
567}
568
569
570static void acs_survey_mode_interference_factor(
571 struct hostapd_iface *iface, struct hostapd_hw_modes *mode)
572{
573 int i;
574 struct hostapd_channel_data *chan;
575
576 for (i = 0; i < mode->num_channels; i++) {
577 chan = &mode->channels[i];
578
579 if (!acs_usable_chan(chan))
580 continue;
581
582 if ((chan->flag & HOSTAPD_CHAN_RADAR) &&
583 iface->conf->acs_exclude_dfs)
584 continue;
585
586 if (!is_in_chanlist(iface, chan))
587 continue;
588
589 if (!is_in_freqlist(iface, chan))
590 continue;
591
592 if (chan->max_tx_power < iface->conf->min_tx_power)
593 continue;
594
595 if ((chan->flag & HOSTAPD_CHAN_INDOOR_ONLY) &&
596 iface->conf->country[2] == 0x4f)
597 continue;
598
599 wpa_printf(MSG_DEBUG, "ACS: Survey analysis for channel %d (%d MHz)",
600 chan->chan, chan->freq);
601
602 acs_survey_chan_interference_factor(iface, chan);
603
604 wpa_printf(MSG_DEBUG, "ACS: * interference factor average: %Lg",
605 chan->interference_factor);
606 }
607}
608
609
610static void acs_survey_all_chans_interference_factor(
611 struct hostapd_iface *iface)
612{
613 int i;
614 struct hostapd_hw_modes *mode;
615
616 for (i = 0; i < iface->num_hw_features; i++) {
617 mode = &iface->hw_features[i];
618 if (!hostapd_hw_skip_mode(iface, mode))
619 acs_survey_mode_interference_factor(iface, mode);
620 }
621}
622
623
624static struct hostapd_channel_data *
625acs_find_chan_mode(struct hostapd_hw_modes *mode, int freq)
626{
627 struct hostapd_channel_data *chan;
628 int i;
629
630 for (i = 0; i < mode->num_channels; i++) {
631 chan = &mode->channels[i];
632
633 if (chan->flag & HOSTAPD_CHAN_DISABLED)
634 continue;
635
636 if (chan->freq == freq)
637 return chan;
638 }
639
640 return NULL;
641}
642
643
644static enum hostapd_hw_mode
645acs_find_mode(struct hostapd_iface *iface, int freq)
646{
647 int i;
648 struct hostapd_hw_modes *mode;
649 struct hostapd_channel_data *chan;
650
651 for (i = 0; i < iface->num_hw_features; i++) {
652 mode = &iface->hw_features[i];
653 if (!hostapd_hw_skip_mode(iface, mode)) {
654 chan = acs_find_chan_mode(mode, freq);
655 if (chan)
656 return mode->mode;
657 }
658 }
659
660 return HOSTAPD_MODE_IEEE80211ANY;
661}
662
663
664static struct hostapd_channel_data *
665acs_find_chan(struct hostapd_iface *iface, int freq)
666{
667 int i;
668 struct hostapd_hw_modes *mode;
669 struct hostapd_channel_data *chan;
670
671 for (i = 0; i < iface->num_hw_features; i++) {
672 mode = &iface->hw_features[i];
673 if (!hostapd_hw_skip_mode(iface, mode)) {
674 chan = acs_find_chan_mode(mode, freq);
675 if (chan)
676 return chan;
677 }
678 }
679
680 return NULL;
681}
682
683
684static int is_24ghz_mode(enum hostapd_hw_mode mode)
685{
686 return mode == HOSTAPD_MODE_IEEE80211B ||
687 mode == HOSTAPD_MODE_IEEE80211G;
688}
689
690
691static int is_common_24ghz_chan(int chan)
692{
693 return chan == 1 || chan == 6 || chan == 11;
694}
695
696
697#ifndef ACS_ADJ_WEIGHT
698#define ACS_ADJ_WEIGHT 0.85
699#endif /* ACS_ADJ_WEIGHT */
700
701#ifndef ACS_NEXT_ADJ_WEIGHT
702#define ACS_NEXT_ADJ_WEIGHT 0.55
703#endif /* ACS_NEXT_ADJ_WEIGHT */
704
705#ifndef ACS_24GHZ_PREFER_1_6_11
706/*
707 * Select commonly used channels 1, 6, 11 by default even if a neighboring
708 * channel has a smaller interference factor as long as it is not better by more
709 * than this multiplier.
710 */
711#define ACS_24GHZ_PREFER_1_6_11 0.8
712#endif /* ACS_24GHZ_PREFER_1_6_11 */
713
714
715#ifdef CONFIG_IEEE80211BE
716static void acs_update_puncturing_bitmap(struct hostapd_iface *iface,
717 struct hostapd_hw_modes *mode, u32 bw,
718 int n_chans,
719 struct hostapd_channel_data *chan,
720 long double factor,
721 int index_primary)
722{
723 struct hostapd_config *conf = iface->conf;
724 struct hostapd_channel_data *adj_chan = NULL, *first_chan = chan;
725 int i;
726 long double threshold;
727
728 /*
729 * If threshold is 0 or user configured puncturing pattern is
730 * available then don't add additional puncturing.
731 */
732 if (!conf->punct_acs_threshold || conf->punct_bitmap)
733 return;
734
735 if (is_24ghz_mode(mode->mode) || bw < 80)
736 return;
737
738 threshold = factor * conf->punct_acs_threshold / 100;
739 for (i = 0; i < n_chans; i++) {
740 int adj_freq;
741
742 if (i == index_primary)
743 continue; /* Cannot puncture primary channel */
744
745 if (i > index_primary)
746 adj_freq = chan->freq + (i - index_primary) * 20;
747 else
748 adj_freq = chan->freq - (index_primary - i) * 20;
749
750 adj_chan = acs_find_chan(iface, adj_freq);
751 if (!adj_chan) {
752 chan->punct_bitmap = 0;
753 return;
754 }
755
756 if (i == 0)
757 first_chan = adj_chan;
758
759 if (adj_chan->interference_factor > threshold)
760 chan->punct_bitmap |= BIT(i);
761 }
762
763 if (!is_punct_bitmap_valid(bw, (chan->freq - first_chan->freq) / 20,
764 chan->punct_bitmap))
765 chan->punct_bitmap = 0;
766}
767#endif /* CONFIG_IEEE80211BE */
768
769
770static void
771acs_find_ideal_chan_mode(struct hostapd_iface *iface,
772 struct hostapd_hw_modes *mode,
773 int n_chans, u32 bw,
774 struct hostapd_channel_data **rand_chan,
775 struct hostapd_channel_data **ideal_chan,
776 long double *ideal_factor)
777{
778 struct hostapd_channel_data *chan, *adj_chan = NULL, *best;
779 long double factor;
780 int i, j;
781 unsigned int k;
782
783 for (i = 0; i < mode->num_channels; i++) {
784 double total_weight;
785 struct acs_bias *bias, tmp_bias;
786 bool update_best = true;
787
788 best = chan = &mode->channels[i];
789
790 /* Since in the current ACS implementation the first channel is
791 * always a primary channel, skip channels not available as
792 * primary until more sophisticated channel selection is
793 * implemented.
794 *
795 * If this implementation is changed to allow any channel in
796 * the bandwidth to be the primary one, the last parameter to
797 * acs_update_puncturing_bitmap() should be changed to the index
798 * of the primary channel
799 */
800 if (!chan_pri_allowed(chan))
801 continue;
802
803 if ((chan->flag & HOSTAPD_CHAN_RADAR) &&
804 iface->conf->acs_exclude_dfs)
805 continue;
806
807 if (!is_in_chanlist(iface, chan))
808 continue;
809
810 if (!is_in_freqlist(iface, chan))
811 continue;
812
813 if (chan->max_tx_power < iface->conf->min_tx_power)
814 continue;
815
816 if ((chan->flag & HOSTAPD_CHAN_INDOOR_ONLY) &&
817 iface->conf->country[2] == 0x4f)
818 continue;
819
820 if (!chan_bw_allowed(chan, bw, 1, 1)) {
821 wpa_printf(MSG_DEBUG,
822 "ACS: Channel %d: BW %u is not supported",
823 chan->chan, bw);
824 continue;
825 }
826
827 /* HT40 on 5 GHz has a limited set of primary channels as per
828 * 11n Annex J */
829 if (mode->mode == HOSTAPD_MODE_IEEE80211A &&
830 ((iface->conf->ieee80211n &&
831 iface->conf->secondary_channel) ||
832 is_6ghz_freq(chan->freq)) &&
833 !acs_usable_bw_chan(chan, ACS_BW40)) {
834 wpa_printf(MSG_DEBUG,
835 "ACS: Channel %d: not allowed as primary channel for 40 MHz bandwidth",
836 chan->chan);
837 continue;
838 }
839
840 if (mode->mode == HOSTAPD_MODE_IEEE80211A &&
841 (iface->conf->ieee80211ac || iface->conf->ieee80211ax)) {
842 if (hostapd_get_oper_chwidth(iface->conf) ==
843 CONF_OPER_CHWIDTH_80MHZ &&
844 !acs_usable_bw_chan(chan, ACS_BW80)) {
845 wpa_printf(MSG_DEBUG,
846 "ACS: Channel %d: not allowed as primary channel for 80 MHz bandwidth",
847 chan->chan);
848 continue;
849 }
850
851 if (hostapd_get_oper_chwidth(iface->conf) ==
852 CONF_OPER_CHWIDTH_160MHZ &&
853 !acs_usable_bw_chan(chan, ACS_BW160)) {
854 wpa_printf(MSG_DEBUG,
855 "ACS: Channel %d: not allowed as primary channel for 160 MHz bandwidth",
856 chan->chan);
857 continue;
858 }
859 }
860
861 factor = 0;
862 if (acs_usable_chan(chan))
863 factor = chan->interference_factor;
864 total_weight = 1;
865
866 for (j = 1; j < n_chans; j++) {
867 adj_chan = acs_find_chan(iface, chan->freq + (j * 20));
868 if (!adj_chan)
869 break;
870
871 if (!chan_bw_allowed(adj_chan, bw, 1, 0)) {
872 wpa_printf(MSG_DEBUG,
873 "ACS: PRI Channel %d: secondary channel %d BW %u is not supported",
874 chan->chan, adj_chan->chan, bw);
875 break;
876 }
877
878 if (acs_usable_chan(adj_chan)) {
879 factor += adj_chan->interference_factor;
880 total_weight += 1;
881 } else {
882 update_best = false;
883 }
884
885 /* find the best channel in this segment */
886 if (update_best &&
887 adj_chan->interference_factor <
888 best->interference_factor)
889 best = adj_chan;
890 }
891
892 if (j != n_chans) {
893 wpa_printf(MSG_DEBUG, "ACS: Channel %d: not enough bandwidth",
894 chan->chan);
895 continue;
896 }
897
898 /* If the AP is in the 5 GHz or 6 GHz band, lets prefer a less
899 * crowded primary channel if one was found in the segment */
900 if (iface->current_mode->mode == HOSTAPD_MODE_IEEE80211A &&
901 chan != best) {
902 wpa_printf(MSG_DEBUG,
903 "ACS: promoting channel %d over %d (less interference %Lg/%Lg)",
904 best->chan, chan->chan,
905 chan->interference_factor,
906 best->interference_factor);
907 chan = best;
908 }
909
910 /* 2.4 GHz has overlapping 20 MHz channels. Include adjacent
911 * channel interference factor. */
912 if (is_24ghz_mode(mode->mode)) {
913 for (j = 0; j < n_chans; j++) {
914 adj_chan = acs_find_chan(iface, chan->freq +
915 (j * 20) - 5);
916 if (adj_chan && acs_usable_chan(adj_chan)) {
917 factor += ACS_ADJ_WEIGHT *
918 adj_chan->interference_factor;
919 total_weight += ACS_ADJ_WEIGHT;
920 }
921
922 adj_chan = acs_find_chan(iface, chan->freq +
923 (j * 20) - 10);
924 if (adj_chan && acs_usable_chan(adj_chan)) {
925 factor += ACS_NEXT_ADJ_WEIGHT *
926 adj_chan->interference_factor;
927 total_weight += ACS_NEXT_ADJ_WEIGHT;
928 }
929
930 adj_chan = acs_find_chan(iface, chan->freq +
931 (j * 20) + 5);
932 if (adj_chan && acs_usable_chan(adj_chan)) {
933 factor += ACS_ADJ_WEIGHT *
934 adj_chan->interference_factor;
935 total_weight += ACS_ADJ_WEIGHT;
936 }
937
938 adj_chan = acs_find_chan(iface, chan->freq +
939 (j * 20) + 10);
940 if (adj_chan && acs_usable_chan(adj_chan)) {
941 factor += ACS_NEXT_ADJ_WEIGHT *
942 adj_chan->interference_factor;
943 total_weight += ACS_NEXT_ADJ_WEIGHT;
944 }
945 }
946 }
947
948 factor /= total_weight;
949
950 bias = NULL;
951 if (iface->conf->acs_chan_bias) {
952 for (k = 0; k < iface->conf->num_acs_chan_bias; k++) {
953 bias = &iface->conf->acs_chan_bias[k];
954 if (bias->channel == chan->chan)
955 break;
956 bias = NULL;
957 }
958 } else if (is_24ghz_mode(mode->mode) &&
959 is_common_24ghz_chan(chan->chan)) {
960 tmp_bias.channel = chan->chan;
961 tmp_bias.bias = ACS_24GHZ_PREFER_1_6_11;
962 bias = &tmp_bias;
963 }
964
965 if (bias) {
966 factor *= bias->bias;
967 wpa_printf(MSG_DEBUG,
968 "ACS: * channel %d: total interference = %Lg (%f bias)",
969 chan->chan, factor, bias->bias);
970 } else {
971 wpa_printf(MSG_DEBUG,
972 "ACS: * channel %d: total interference = %Lg",
973 chan->chan, factor);
974 }
975
976 if (acs_usable_chan(chan) &&
977 (!*ideal_chan || factor < *ideal_factor)) {
978 /* Reset puncturing bitmap for the previous ideal
979 * channel */
980 if (*ideal_chan)
981 (*ideal_chan)->punct_bitmap = 0;
982
983 *ideal_factor = factor;
984 *ideal_chan = chan;
985
986#ifdef CONFIG_IEEE80211BE
987 if (iface->conf->ieee80211be)
988 acs_update_puncturing_bitmap(iface, mode, bw,
989 n_chans, chan,
990 factor, 0);
991#endif /* CONFIG_IEEE80211BE */
992 }
993
994 /* This channel would at least be usable */
995 if (!(*rand_chan))
996 *rand_chan = chan;
997 }
998}
999
1000
1001/*
1002 * At this point it's assumed chan->interference_factor has been computed.
1003 * This function should be reusable regardless of interference computation
1004 * option (survey, BSS, spectral, ...). chan->interference factor must be
1005 * summable (i.e., must be always greater than zero).
1006 */
1007static struct hostapd_channel_data *
1008acs_find_ideal_chan(struct hostapd_iface *iface)
1009{
1010 struct hostapd_channel_data *ideal_chan = NULL,
1011 *rand_chan = NULL;
1012 long double ideal_factor = 0;
1013 int i;
1014 int n_chans = 1;
1015 u32 bw;
1016 struct hostapd_hw_modes *mode;
1017
1018 if (is_6ghz_op_class(iface->conf->op_class)) {
1019 bw = op_class_to_bandwidth(iface->conf->op_class);
1020 n_chans = bw / 20;
1021 goto bw_selected;
1022 }
1023
1024 /* TODO: HT40- support */
1025
1026 if (iface->conf->ieee80211n &&
1027 iface->conf->secondary_channel == -1) {
1028 wpa_printf(MSG_ERROR, "ACS: HT40- is not supported yet. Please try HT40+");
1029 return NULL;
1030 }
1031
1032 if (iface->conf->ieee80211n &&
1033 iface->conf->secondary_channel)
1034 n_chans = 2;
1035
1036 if (iface->conf->ieee80211ac || iface->conf->ieee80211ax) {
1037 switch (hostapd_get_oper_chwidth(iface->conf)) {
1038 case CONF_OPER_CHWIDTH_80MHZ:
1039 n_chans = 4;
1040 break;
1041 case CONF_OPER_CHWIDTH_160MHZ:
1042 n_chans = 8;
1043 break;
1044 default:
1045 break;
1046 }
1047 }
1048
1049 bw = num_chan_to_bw(n_chans);
1050
1051bw_selected:
1052 /* TODO: VHT/HE80+80. Update acs_adjust_center_freq() too. */
1053
1054 wpa_printf(MSG_DEBUG,
1055 "ACS: Survey analysis for selected bandwidth %d MHz", bw);
1056
1057 for (i = 0; i < iface->num_hw_features; i++) {
1058 mode = &iface->hw_features[i];
1059 if (!hostapd_hw_skip_mode(iface, mode))
1060 acs_find_ideal_chan_mode(iface, mode, n_chans, bw,
1061 &rand_chan, &ideal_chan,
1062 &ideal_factor);
1063 }
1064
1065 if (ideal_chan) {
1066 wpa_printf(MSG_DEBUG, "ACS: Ideal channel is %d (%d MHz) with total interference factor of %Lg",
1067 ideal_chan->chan, ideal_chan->freq, ideal_factor);
1068
1069#ifdef CONFIG_IEEE80211BE
1070 if (iface->conf->punct_acs_threshold)
1071 wpa_printf(MSG_DEBUG, "ACS: RU puncturing bitmap 0x%x",
1072 ideal_chan->punct_bitmap);
1073#endif /* CONFIG_IEEE80211BE */
1074
1075 return ideal_chan;
1076 }
1077
1078#ifdef CONFIG_IEEE80211BE
1079 if (iface->conf->punct_acs_threshold)
1080 wpa_printf(MSG_DEBUG, "ACS: RU puncturing bitmap 0x%x",
1081 ideal_chan->punct_bitmap);
1082#endif /* CONFIG_IEEE80211BE */
1083
1084 return rand_chan;
1085}
1086
1087
1088static void acs_adjust_secondary(struct hostapd_iface *iface)
1089{
1090 unsigned int i;
1091
1092 /* When working with bandwidth over 20 MHz on the 5 GHz or 6 GHz band,
1093 * ACS can return a secondary channel which is not the first channel of
1094 * the segment and we need to adjust. */
1095 if (!iface->conf->secondary_channel ||
1096 acs_find_mode(iface, iface->freq) != HOSTAPD_MODE_IEEE80211A)
1097 return;
1098
1099 wpa_printf(MSG_DEBUG, "ACS: Adjusting HT/VHT/HE secondary frequency");
1100
1101 for (i = 0; bw_desc[ACS_BW40][i].first != -1; i++) {
1102 if (iface->freq == bw_desc[ACS_BW40][i].first)
1103 iface->conf->secondary_channel = 1;
1104 else if (iface->freq == bw_desc[ACS_BW40][i].last)
1105 iface->conf->secondary_channel = -1;
1106 }
1107}
1108
1109
1110static void acs_adjust_center_freq(struct hostapd_iface *iface)
1111{
1112 int center;
1113
1114 wpa_printf(MSG_DEBUG, "ACS: Adjusting VHT center frequency");
1115
1116 switch (hostapd_get_oper_chwidth(iface->conf)) {
1117 case CONF_OPER_CHWIDTH_USE_HT:
1118 if (iface->conf->secondary_channel &&
1119 iface->freq >= 2400 && iface->freq < 2500)
1120 center = iface->conf->channel +
1121 2 * iface->conf->secondary_channel;
1122 else if (iface->conf->secondary_channel)
1123 center = acs_get_bw_center_chan(iface->freq, ACS_BW40);
1124 else
1125 center = iface->conf->channel;
1126 break;
1127 case CONF_OPER_CHWIDTH_80MHZ:
1128 center = acs_get_bw_center_chan(iface->freq, ACS_BW80);
1129 break;
1130 case CONF_OPER_CHWIDTH_160MHZ:
1131 center = acs_get_bw_center_chan(iface->freq, ACS_BW160);
1132 break;
1133 default:
1134 /* TODO: How can this be calculated? Adjust
1135 * acs_find_ideal_chan() */
1136 wpa_printf(MSG_INFO,
1137 "ACS: Only VHT20/40/80/160 is supported now");
1138 return;
1139 }
1140
1141 hostapd_set_oper_centr_freq_seg0_idx(iface->conf, center);
1142}
1143
1144
1145static int acs_study_survey_based(struct hostapd_iface *iface)
1146{
1147 wpa_printf(MSG_DEBUG, "ACS: Trying survey-based ACS");
1148
1149 if (!iface->chans_surveyed) {
1150 wpa_printf(MSG_ERROR, "ACS: Unable to collect survey data");
1151 return -1;
1152 }
1153
1154 if (!acs_surveys_are_sufficient(iface)) {
1155 wpa_printf(MSG_ERROR, "ACS: Surveys have insufficient data");
1156 return -1;
1157 }
1158
1159 acs_survey_all_chans_interference_factor(iface);
1160 return 0;
1161}
1162
1163
1164static int acs_study_options(struct hostapd_iface *iface)
1165{
1166 if (acs_study_survey_based(iface) == 0)
1167 return 0;
1168
1169 /* TODO: If no surveys are available/sufficient this is a good
1170 * place to fallback to BSS-based ACS */
1171
1172 return -1;
1173}
1174
1175
1176static void acs_study(struct hostapd_iface *iface)
1177{
1178 struct hostapd_channel_data *ideal_chan;
1179 int err;
1180
1181 err = acs_study_options(iface);
1182 if (err < 0) {
1183 wpa_printf(MSG_ERROR, "ACS: All study options have failed");
1184 goto fail;
1185 }
1186
1187 ideal_chan = acs_find_ideal_chan(iface);
1188 if (!ideal_chan) {
1189 wpa_printf(MSG_ERROR, "ACS: Failed to compute ideal channel");
1190 err = -1;
1191 goto fail;
1192 }
1193
1194 iface->conf->channel = ideal_chan->chan;
1195 iface->freq = ideal_chan->freq;
1196#ifdef CONFIG_IEEE80211BE
1197 iface->conf->punct_bitmap = ideal_chan->punct_bitmap;
1198#endif /* CONFIG_IEEE80211BE */
1199
1200 if (iface->conf->ieee80211ac || iface->conf->ieee80211ax) {
1201 acs_adjust_secondary(iface);
1202 acs_adjust_center_freq(iface);
1203 }
1204
1205 err = hostapd_select_hw_mode(iface);
1206 if (err) {
1207 wpa_printf(MSG_ERROR,
1208 "ACS: Could not (err: %d) select hw_mode for freq=%d channel=%d",
1209 err, iface->freq, iface->conf->channel);
1210 err = -1;
1211 goto fail;
1212 }
1213
1214 err = 0;
1215fail:
1216 /*
1217 * hostapd_setup_interface_complete() will return -1 on failure,
1218 * 0 on success and 0 is HOSTAPD_CHAN_VALID :)
1219 */
1220 if (hostapd_acs_completed(iface, err) == HOSTAPD_CHAN_VALID) {
1221 acs_cleanup(iface);
1222 return;
1223 }
1224
1225 /* This can possibly happen if channel parameters (secondary
1226 * channel, center frequencies) are misconfigured */
1227 wpa_printf(MSG_ERROR, "ACS: Possibly channel configuration is invalid, please report this along with your config file.");
1228 acs_fail(iface);
1229}
1230
1231
1232static void acs_scan_complete(struct hostapd_iface *iface)
1233{
1234 int err;
1235
1236 iface->scan_cb = NULL;
1237
1238 wpa_printf(MSG_DEBUG, "ACS: Using survey based algorithm (acs_num_scans=%d)",
1239 iface->conf->acs_num_scans);
1240
1241 err = hostapd_drv_get_survey(iface->bss[0], 0);
1242 if (err) {
1243 wpa_printf(MSG_ERROR, "ACS: Failed to get survey data");
1244 goto fail;
1245 }
1246
1247 if (++iface->acs_num_completed_scans < iface->conf->acs_num_scans) {
1248 err = acs_request_scan(iface);
1249 if (err) {
1250 wpa_printf(MSG_ERROR, "ACS: Failed to request scan");
1251 goto fail;
1252 }
1253
1254 return;
1255 }
1256
1257 acs_study(iface);
1258 return;
1259fail:
1260 hostapd_acs_completed(iface, 1);
1261 acs_fail(iface);
1262}
1263
1264
1265static int * acs_request_scan_add_freqs(struct hostapd_iface *iface,
1266 struct hostapd_hw_modes *mode,
1267 int *freq)
1268{
1269 struct hostapd_channel_data *chan;
1270 int i;
1271
1272 for (i = 0; i < mode->num_channels; i++) {
1273 chan = &mode->channels[i];
1274 if ((chan->flag & HOSTAPD_CHAN_DISABLED) ||
1275 ((chan->flag & HOSTAPD_CHAN_RADAR) &&
1276 iface->conf->acs_exclude_dfs))
1277 continue;
1278
1279 if (!is_in_chanlist(iface, chan))
1280 continue;
1281
1282 if (!is_in_freqlist(iface, chan))
1283 continue;
1284
1285 if (chan->max_tx_power < iface->conf->min_tx_power)
1286 continue;
1287
1288 if ((chan->flag & HOSTAPD_CHAN_INDOOR_ONLY) &&
1289 iface->conf->country[2] == 0x4f)
1290 continue;
1291
1292 *freq++ = chan->freq;
1293 }
1294
1295 return freq;
1296}
1297
1298
1299static int acs_request_scan(struct hostapd_iface *iface)
1300{
1301 struct wpa_driver_scan_params params;
1302 int i, *freq;
1303 int num_channels;
1304 struct hostapd_hw_modes *mode;
1305
1306 os_memset(&params, 0, sizeof(params));
1307
1308 num_channels = 0;
1309 for (i = 0; i < iface->num_hw_features; i++) {
1310 mode = &iface->hw_features[i];
1311 if (!hostapd_hw_skip_mode(iface, mode))
1312 num_channels += mode->num_channels;
1313 }
1314
1315 params.freqs = os_calloc(num_channels + 1, sizeof(params.freqs[0]));
1316 if (params.freqs == NULL)
1317 return -1;
1318
1319 freq = params.freqs;
1320
1321 for (i = 0; i < iface->num_hw_features; i++) {
1322 mode = &iface->hw_features[i];
1323 if (!hostapd_hw_skip_mode(iface, mode))
1324 freq = acs_request_scan_add_freqs(iface, mode, freq);
1325 }
1326
1327 *freq = 0;
1328
1329 if (params.freqs == freq) {
1330 wpa_printf(MSG_ERROR, "ACS: No available channels found");
1331 os_free(params.freqs);
1332 return -1;
1333 }
1334
1335 iface->scan_cb = acs_scan_complete;
1336
1337 wpa_printf(MSG_DEBUG, "ACS: Scanning %d / %d",
1338 iface->acs_num_completed_scans + 1,
1339 iface->conf->acs_num_scans);
1340
1341 if (hostapd_driver_scan(iface->bss[0], &params) < 0) {
1342 wpa_printf(MSG_ERROR, "ACS: Failed to request initial scan");
1343 acs_cleanup(iface);
1344 os_free(params.freqs);
1345 return -1;
1346 }
1347
1348 os_free(params.freqs);
1349 return 0;
1350}
1351
1352
1353enum hostapd_chan_status acs_init(struct hostapd_iface *iface)
1354{
1355 int err;
1356
1357 wpa_printf(MSG_INFO, "ACS: Automatic channel selection started, this may take a bit");
1358
1359 if (iface->drv_flags & WPA_DRIVER_FLAGS_ACS_OFFLOAD) {
1360 wpa_printf(MSG_INFO, "ACS: Offloading to driver");
1361
1362 err = hostapd_drv_do_acs(iface->bss[0]);
1363 if (err) {
1364 if (err == 1)
1365 return HOSTAPD_CHAN_INVALID_NO_IR;
1366 return HOSTAPD_CHAN_INVALID;
1367 }
1368
1369 return HOSTAPD_CHAN_ACS;
1370 }
1371
1372 if (!iface->current_mode &&
1373 iface->conf->hw_mode != HOSTAPD_MODE_IEEE80211ANY)
1374 return HOSTAPD_CHAN_INVALID;
1375
1376 acs_cleanup(iface);
1377
1378 if (acs_request_scan(iface) < 0)
1379 return HOSTAPD_CHAN_INVALID;
1380
1381 hostapd_set_state(iface, HAPD_IFACE_ACS);
1382 wpa_msg(iface->bss[0]->msg_ctx, MSG_INFO, ACS_EVENT_STARTED);
1383
1384 return HOSTAPD_CHAN_ACS;
1385}