2 * This file contains helper code to handle channel
3 * settings and keeping track of what is possible at
9 #include <linux/export.h>
10 #include <net/cfg80211.h>
14 void cfg80211_chandef_create(struct cfg80211_chan_def *chandef,
15 struct ieee80211_channel *chan,
16 enum nl80211_channel_type chan_type)
22 chandef->center_freq2 = 0;
25 case NL80211_CHAN_NO_HT:
26 chandef->width = NL80211_CHAN_WIDTH_20_NOHT;
27 chandef->center_freq1 = chan->center_freq;
29 case NL80211_CHAN_HT20:
30 chandef->width = NL80211_CHAN_WIDTH_20;
31 chandef->center_freq1 = chan->center_freq;
33 case NL80211_CHAN_HT40PLUS:
34 chandef->width = NL80211_CHAN_WIDTH_40;
35 chandef->center_freq1 = chan->center_freq + 10;
37 case NL80211_CHAN_HT40MINUS:
38 chandef->width = NL80211_CHAN_WIDTH_40;
39 chandef->center_freq1 = chan->center_freq - 10;
45 EXPORT_SYMBOL(cfg80211_chandef_create);
47 bool cfg80211_chandef_valid(const struct cfg80211_chan_def *chandef)
54 control_freq = chandef->chan->center_freq;
56 switch (chandef->width) {
57 case NL80211_CHAN_WIDTH_5:
58 case NL80211_CHAN_WIDTH_10:
59 case NL80211_CHAN_WIDTH_20:
60 case NL80211_CHAN_WIDTH_20_NOHT:
61 if (chandef->center_freq1 != control_freq)
63 if (chandef->center_freq2)
66 case NL80211_CHAN_WIDTH_40:
67 if (chandef->center_freq1 != control_freq + 10 &&
68 chandef->center_freq1 != control_freq - 10)
70 if (chandef->center_freq2)
73 case NL80211_CHAN_WIDTH_80P80:
74 if (chandef->center_freq1 != control_freq + 30 &&
75 chandef->center_freq1 != control_freq + 10 &&
76 chandef->center_freq1 != control_freq - 10 &&
77 chandef->center_freq1 != control_freq - 30)
79 if (!chandef->center_freq2)
81 /* adjacent is not allowed -- that's a 160 MHz channel */
82 if (chandef->center_freq1 - chandef->center_freq2 == 80 ||
83 chandef->center_freq2 - chandef->center_freq1 == 80)
86 case NL80211_CHAN_WIDTH_80:
87 if (chandef->center_freq1 != control_freq + 30 &&
88 chandef->center_freq1 != control_freq + 10 &&
89 chandef->center_freq1 != control_freq - 10 &&
90 chandef->center_freq1 != control_freq - 30)
92 if (chandef->center_freq2)
95 case NL80211_CHAN_WIDTH_160:
96 if (chandef->center_freq1 != control_freq + 70 &&
97 chandef->center_freq1 != control_freq + 50 &&
98 chandef->center_freq1 != control_freq + 30 &&
99 chandef->center_freq1 != control_freq + 10 &&
100 chandef->center_freq1 != control_freq - 10 &&
101 chandef->center_freq1 != control_freq - 30 &&
102 chandef->center_freq1 != control_freq - 50 &&
103 chandef->center_freq1 != control_freq - 70)
105 if (chandef->center_freq2)
114 EXPORT_SYMBOL(cfg80211_chandef_valid);
116 static void chandef_primary_freqs(const struct cfg80211_chan_def *c,
117 int *pri40, int *pri80)
122 case NL80211_CHAN_WIDTH_40:
123 *pri40 = c->center_freq1;
126 case NL80211_CHAN_WIDTH_80:
127 case NL80211_CHAN_WIDTH_80P80:
128 *pri80 = c->center_freq1;
130 tmp = (30 + c->chan->center_freq - c->center_freq1)/20;
134 *pri40 = c->center_freq1 - 20 + 40 * tmp;
136 case NL80211_CHAN_WIDTH_160:
138 tmp = (70 + c->chan->center_freq - c->center_freq1)/20;
142 *pri40 = c->center_freq1 - 60 + 40 * tmp;
145 *pri80 = c->center_freq1 - 40 + 80 * tmp;
152 static int cfg80211_chandef_get_width(const struct cfg80211_chan_def *c)
157 case NL80211_CHAN_WIDTH_5:
160 case NL80211_CHAN_WIDTH_10:
163 case NL80211_CHAN_WIDTH_20:
164 case NL80211_CHAN_WIDTH_20_NOHT:
167 case NL80211_CHAN_WIDTH_40:
170 case NL80211_CHAN_WIDTH_80P80:
171 case NL80211_CHAN_WIDTH_80:
174 case NL80211_CHAN_WIDTH_160:
184 const struct cfg80211_chan_def *
185 cfg80211_chandef_compatible(const struct cfg80211_chan_def *c1,
186 const struct cfg80211_chan_def *c2)
188 u32 c1_pri40, c1_pri80, c2_pri40, c2_pri80;
190 /* If they are identical, return */
191 if (cfg80211_chandef_identical(c1, c2))
194 /* otherwise, must have same control channel */
195 if (c1->chan != c2->chan)
199 * If they have the same width, but aren't identical,
200 * then they can't be compatible.
202 if (c1->width == c2->width)
206 * can't be compatible if one of them is 5 or 10 MHz,
207 * but they don't have the same width.
209 if (c1->width == NL80211_CHAN_WIDTH_5 ||
210 c1->width == NL80211_CHAN_WIDTH_10 ||
211 c2->width == NL80211_CHAN_WIDTH_5 ||
212 c2->width == NL80211_CHAN_WIDTH_10)
215 if (c1->width == NL80211_CHAN_WIDTH_20_NOHT ||
216 c1->width == NL80211_CHAN_WIDTH_20)
219 if (c2->width == NL80211_CHAN_WIDTH_20_NOHT ||
220 c2->width == NL80211_CHAN_WIDTH_20)
223 chandef_primary_freqs(c1, &c1_pri40, &c1_pri80);
224 chandef_primary_freqs(c2, &c2_pri40, &c2_pri80);
226 if (c1_pri40 != c2_pri40)
229 WARN_ON(!c1_pri80 && !c2_pri80);
230 if (c1_pri80 && c2_pri80 && c1_pri80 != c2_pri80)
233 if (c1->width > c2->width)
237 EXPORT_SYMBOL(cfg80211_chandef_compatible);
239 static void cfg80211_set_chans_dfs_state(struct wiphy *wiphy, u32 center_freq,
241 enum nl80211_dfs_state dfs_state)
243 struct ieee80211_channel *c;
246 for (freq = center_freq - bandwidth/2 + 10;
247 freq <= center_freq + bandwidth/2 - 10;
249 c = ieee80211_get_channel(wiphy, freq);
250 if (!c || !(c->flags & IEEE80211_CHAN_RADAR))
253 c->dfs_state = dfs_state;
254 c->dfs_state_entered = jiffies;
258 void cfg80211_set_dfs_state(struct wiphy *wiphy,
259 const struct cfg80211_chan_def *chandef,
260 enum nl80211_dfs_state dfs_state)
264 if (WARN_ON(!cfg80211_chandef_valid(chandef)))
267 width = cfg80211_chandef_get_width(chandef);
271 cfg80211_set_chans_dfs_state(wiphy, chandef->center_freq1,
274 if (!chandef->center_freq2)
276 cfg80211_set_chans_dfs_state(wiphy, chandef->center_freq2,
280 static u32 cfg80211_get_start_freq(u32 center_freq,
286 start_freq = center_freq;
288 start_freq = center_freq - bandwidth/2 + 10;
293 static u32 cfg80211_get_end_freq(u32 center_freq,
299 end_freq = center_freq;
301 end_freq = center_freq + bandwidth/2 - 10;
306 static int cfg80211_get_chans_dfs_required(struct wiphy *wiphy,
310 struct ieee80211_channel *c;
311 u32 freq, start_freq, end_freq;
313 start_freq = cfg80211_get_start_freq(center_freq, bandwidth);
314 end_freq = cfg80211_get_end_freq(center_freq, bandwidth);
316 for (freq = start_freq; freq <= end_freq; freq += 20) {
317 c = ieee80211_get_channel(wiphy, freq);
321 if (c->flags & IEEE80211_CHAN_RADAR)
328 int cfg80211_chandef_dfs_required(struct wiphy *wiphy,
329 const struct cfg80211_chan_def *chandef)
334 if (WARN_ON(!cfg80211_chandef_valid(chandef)))
337 width = cfg80211_chandef_get_width(chandef);
341 r = cfg80211_get_chans_dfs_required(wiphy, chandef->center_freq1,
346 if (!chandef->center_freq2)
349 return cfg80211_get_chans_dfs_required(wiphy, chandef->center_freq2,
352 EXPORT_SYMBOL(cfg80211_chandef_dfs_required);
354 static int cfg80211_get_chans_dfs_usable(struct wiphy *wiphy,
358 struct ieee80211_channel *c;
359 u32 freq, start_freq, end_freq;
362 start_freq = cfg80211_get_start_freq(center_freq, bandwidth);
363 end_freq = cfg80211_get_end_freq(center_freq, bandwidth);
366 * Check entire range of channels for the bandwidth.
367 * Check all channels are DFS channels (DFS_USABLE or
368 * DFS_AVAILABLE). Return number of usable channels
369 * (require CAC). Allow DFS and non-DFS channel mix.
371 for (freq = start_freq; freq <= end_freq; freq += 20) {
372 c = ieee80211_get_channel(wiphy, freq);
376 if (c->flags & IEEE80211_CHAN_DISABLED)
379 if (c->flags & IEEE80211_CHAN_RADAR) {
380 if (c->dfs_state == NL80211_DFS_UNAVAILABLE)
383 if (c->dfs_state == NL80211_DFS_USABLE)
391 bool cfg80211_chandef_dfs_usable(struct wiphy *wiphy,
392 const struct cfg80211_chan_def *chandef)
397 if (WARN_ON(!cfg80211_chandef_valid(chandef)))
400 width = cfg80211_chandef_get_width(chandef);
404 r1 = cfg80211_get_chans_dfs_usable(wiphy, chandef->center_freq1,
410 switch (chandef->width) {
411 case NL80211_CHAN_WIDTH_80P80:
412 WARN_ON(!chandef->center_freq2);
413 r2 = cfg80211_get_chans_dfs_usable(wiphy,
414 chandef->center_freq2,
420 WARN_ON(chandef->center_freq2);
424 return (r1 + r2 > 0);
428 static bool cfg80211_get_chans_dfs_available(struct wiphy *wiphy,
432 struct ieee80211_channel *c;
433 u32 freq, start_freq, end_freq;
435 start_freq = cfg80211_get_start_freq(center_freq, bandwidth);
436 end_freq = cfg80211_get_end_freq(center_freq, bandwidth);
439 * Check entire range of channels for the bandwidth.
440 * If any channel in between is disabled or has not
441 * had gone through CAC return false
443 for (freq = start_freq; freq <= end_freq; freq += 20) {
444 c = ieee80211_get_channel(wiphy, freq);
448 if (c->flags & IEEE80211_CHAN_DISABLED)
451 if ((c->flags & IEEE80211_CHAN_RADAR) &&
452 (c->dfs_state != NL80211_DFS_AVAILABLE))
459 static bool cfg80211_chandef_dfs_available(struct wiphy *wiphy,
460 const struct cfg80211_chan_def *chandef)
465 if (WARN_ON(!cfg80211_chandef_valid(chandef)))
468 width = cfg80211_chandef_get_width(chandef);
472 r = cfg80211_get_chans_dfs_available(wiphy, chandef->center_freq1,
475 /* If any of channels unavailable for cf1 just return */
479 switch (chandef->width) {
480 case NL80211_CHAN_WIDTH_80P80:
481 WARN_ON(!chandef->center_freq2);
482 r = cfg80211_get_chans_dfs_available(wiphy,
483 chandef->center_freq2,
486 WARN_ON(chandef->center_freq2);
494 static bool cfg80211_secondary_chans_ok(struct wiphy *wiphy,
495 u32 center_freq, u32 bandwidth,
496 u32 prohibited_flags)
498 struct ieee80211_channel *c;
499 u32 freq, start_freq, end_freq;
501 start_freq = cfg80211_get_start_freq(center_freq, bandwidth);
502 end_freq = cfg80211_get_end_freq(center_freq, bandwidth);
504 for (freq = start_freq; freq <= end_freq; freq += 20) {
505 c = ieee80211_get_channel(wiphy, freq);
506 if (!c || c->flags & prohibited_flags)
513 bool cfg80211_chandef_usable(struct wiphy *wiphy,
514 const struct cfg80211_chan_def *chandef,
515 u32 prohibited_flags)
517 struct ieee80211_sta_ht_cap *ht_cap;
518 struct ieee80211_sta_vht_cap *vht_cap;
519 u32 width, control_freq;
521 if (WARN_ON(!cfg80211_chandef_valid(chandef)))
524 ht_cap = &wiphy->bands[chandef->chan->band]->ht_cap;
525 vht_cap = &wiphy->bands[chandef->chan->band]->vht_cap;
527 control_freq = chandef->chan->center_freq;
529 switch (chandef->width) {
530 case NL80211_CHAN_WIDTH_5:
533 case NL80211_CHAN_WIDTH_10:
536 case NL80211_CHAN_WIDTH_20:
537 if (!ht_cap->ht_supported)
539 case NL80211_CHAN_WIDTH_20_NOHT:
542 case NL80211_CHAN_WIDTH_40:
544 if (!ht_cap->ht_supported)
546 if (!(ht_cap->cap & IEEE80211_HT_CAP_SUP_WIDTH_20_40) ||
547 ht_cap->cap & IEEE80211_HT_CAP_40MHZ_INTOLERANT)
549 if (chandef->center_freq1 < control_freq &&
550 chandef->chan->flags & IEEE80211_CHAN_NO_HT40MINUS)
552 if (chandef->center_freq1 > control_freq &&
553 chandef->chan->flags & IEEE80211_CHAN_NO_HT40PLUS)
556 case NL80211_CHAN_WIDTH_80P80:
557 if (!(vht_cap->cap & IEEE80211_VHT_CAP_SUPP_CHAN_WIDTH_160_80PLUS80MHZ))
559 case NL80211_CHAN_WIDTH_80:
560 if (!vht_cap->vht_supported)
562 prohibited_flags |= IEEE80211_CHAN_NO_80MHZ;
565 case NL80211_CHAN_WIDTH_160:
566 if (!vht_cap->vht_supported)
568 if (!(vht_cap->cap & IEEE80211_VHT_CAP_SUPP_CHAN_WIDTH_160MHZ))
570 prohibited_flags |= IEEE80211_CHAN_NO_160MHZ;
579 * TODO: What if there are only certain 80/160/80+80 MHz channels
580 * allowed by the driver, or only certain combinations?
581 * For 40 MHz the driver can set the NO_HT40 flags, but for
582 * 80/160 MHz and in particular 80+80 MHz this isn't really
583 * feasible and we only have NO_80MHZ/NO_160MHZ so far but
584 * no way to cover 80+80 MHz or more complex restrictions.
585 * Note that such restrictions also need to be advertised to
586 * userspace, for example for P2P channel selection.
590 prohibited_flags |= IEEE80211_CHAN_NO_OFDM;
592 /* 5 and 10 MHz are only defined for the OFDM PHY */
594 prohibited_flags |= IEEE80211_CHAN_NO_OFDM;
597 if (!cfg80211_secondary_chans_ok(wiphy, chandef->center_freq1,
598 width, prohibited_flags))
601 if (!chandef->center_freq2)
603 return cfg80211_secondary_chans_ok(wiphy, chandef->center_freq2,
604 width, prohibited_flags);
606 EXPORT_SYMBOL(cfg80211_chandef_usable);
608 bool cfg80211_reg_can_beacon(struct wiphy *wiphy,
609 struct cfg80211_chan_def *chandef)
612 u32 prohibited_flags = IEEE80211_CHAN_DISABLED |
613 IEEE80211_CHAN_NO_IR |
614 IEEE80211_CHAN_RADAR;
616 trace_cfg80211_reg_can_beacon(wiphy, chandef);
618 if (cfg80211_chandef_dfs_required(wiphy, chandef) > 0 &&
619 cfg80211_chandef_dfs_available(wiphy, chandef)) {
620 /* We can skip IEEE80211_CHAN_NO_IR if chandef dfs available */
621 prohibited_flags = IEEE80211_CHAN_DISABLED;
624 res = cfg80211_chandef_usable(wiphy, chandef, prohibited_flags);
626 trace_cfg80211_return_bool(res);
629 EXPORT_SYMBOL(cfg80211_reg_can_beacon);
631 int cfg80211_set_monitor_channel(struct cfg80211_registered_device *rdev,
632 struct cfg80211_chan_def *chandef)
634 if (!rdev->ops->set_monitor_channel)
636 if (!cfg80211_has_monitors_only(rdev))
639 return rdev_set_monitor_channel(rdev, chandef);
643 cfg80211_get_chan_state(struct wireless_dev *wdev,
644 struct ieee80211_channel **chan,
645 enum cfg80211_chan_mode *chanmode)
648 *chanmode = CHAN_MODE_UNDEFINED;
650 ASSERT_WDEV_LOCK(wdev);
652 if (wdev->netdev && !netif_running(wdev->netdev))
655 switch (wdev->iftype) {
656 case NL80211_IFTYPE_ADHOC:
657 if (wdev->current_bss) {
658 *chan = wdev->current_bss->pub.channel;
659 *chanmode = (wdev->ibss_fixed &&
660 !wdev->ibss_dfs_possible)
662 : CHAN_MODE_EXCLUSIVE;
666 case NL80211_IFTYPE_STATION:
667 case NL80211_IFTYPE_P2P_CLIENT:
668 if (wdev->current_bss) {
669 *chan = wdev->current_bss->pub.channel;
670 *chanmode = CHAN_MODE_SHARED;
674 case NL80211_IFTYPE_AP:
675 case NL80211_IFTYPE_P2P_GO:
676 if (wdev->cac_started) {
677 *chan = wdev->channel;
678 *chanmode = CHAN_MODE_SHARED;
679 } else if (wdev->beacon_interval) {
680 *chan = wdev->channel;
681 *chanmode = CHAN_MODE_SHARED;
684 case NL80211_IFTYPE_MESH_POINT:
685 if (wdev->mesh_id_len) {
686 *chan = wdev->channel;
687 *chanmode = CHAN_MODE_SHARED;
690 case NL80211_IFTYPE_MONITOR:
691 case NL80211_IFTYPE_AP_VLAN:
692 case NL80211_IFTYPE_WDS:
693 /* these interface types don't really have a channel */
695 case NL80211_IFTYPE_P2P_DEVICE:
696 if (wdev->wiphy->features &
697 NL80211_FEATURE_P2P_DEVICE_NEEDS_CHANNEL)
698 *chanmode = CHAN_MODE_EXCLUSIVE;
700 case NL80211_IFTYPE_UNSPECIFIED:
701 case NUM_NL80211_IFTYPES: