2 * SPDX-License-Identifier: BSD-2-Clause-FreeBSD
4 * Copyright (c) 2001 Atsushi Onoe
5 * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
11 * 1. Redistributions of source code must retain the above copyright
12 * notice, this list of conditions and the following disclaimer.
13 * 2. Redistributions in binary form must reproduce the above copyright
14 * notice, this list of conditions and the following disclaimer in the
15 * documentation and/or other materials provided with the distribution.
17 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
29 #include <sys/cdefs.h>
30 __FBSDID("$FreeBSD$");
33 * IEEE 802.11 generic handler
37 #include <sys/param.h>
38 #include <sys/systm.h>
39 #include <sys/kernel.h>
40 #include <sys/malloc.h>
41 #include <sys/socket.h>
44 #include <machine/stdarg.h>
47 #include <net/if_var.h>
48 #include <net/if_dl.h>
49 #include <net/if_media.h>
50 #include <net/if_types.h>
51 #include <net/ethernet.h>
53 #include <net80211/ieee80211_var.h>
54 #include <net80211/ieee80211_regdomain.h>
55 #ifdef IEEE80211_SUPPORT_SUPERG
56 #include <net80211/ieee80211_superg.h>
58 #include <net80211/ieee80211_ratectl.h>
59 #include <net80211/ieee80211_vht.h>
63 const char *ieee80211_phymode_name[IEEE80211_MODE_MAX] = {
64 [IEEE80211_MODE_AUTO] = "auto",
65 [IEEE80211_MODE_11A] = "11a",
66 [IEEE80211_MODE_11B] = "11b",
67 [IEEE80211_MODE_11G] = "11g",
68 [IEEE80211_MODE_FH] = "FH",
69 [IEEE80211_MODE_TURBO_A] = "turboA",
70 [IEEE80211_MODE_TURBO_G] = "turboG",
71 [IEEE80211_MODE_STURBO_A] = "sturboA",
72 [IEEE80211_MODE_HALF] = "half",
73 [IEEE80211_MODE_QUARTER] = "quarter",
74 [IEEE80211_MODE_11NA] = "11na",
75 [IEEE80211_MODE_11NG] = "11ng",
76 [IEEE80211_MODE_VHT_2GHZ] = "11acg",
77 [IEEE80211_MODE_VHT_5GHZ] = "11ac",
79 /* map ieee80211_opmode to the corresponding capability bit */
80 const int ieee80211_opcap[IEEE80211_OPMODE_MAX] = {
81 [IEEE80211_M_IBSS] = IEEE80211_C_IBSS,
82 [IEEE80211_M_WDS] = IEEE80211_C_WDS,
83 [IEEE80211_M_STA] = IEEE80211_C_STA,
84 [IEEE80211_M_AHDEMO] = IEEE80211_C_AHDEMO,
85 [IEEE80211_M_HOSTAP] = IEEE80211_C_HOSTAP,
86 [IEEE80211_M_MONITOR] = IEEE80211_C_MONITOR,
87 #ifdef IEEE80211_SUPPORT_MESH
88 [IEEE80211_M_MBSS] = IEEE80211_C_MBSS,
92 const uint8_t ieee80211broadcastaddr[IEEE80211_ADDR_LEN] =
93 { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff };
95 static void ieee80211_syncflag_locked(struct ieee80211com *ic, int flag);
96 static void ieee80211_syncflag_ht_locked(struct ieee80211com *ic, int flag);
97 static void ieee80211_syncflag_ext_locked(struct ieee80211com *ic, int flag);
98 static void ieee80211_syncflag_vht_locked(struct ieee80211com *ic, int flag);
99 static int ieee80211_media_setup(struct ieee80211com *ic,
100 struct ifmedia *media, int caps, int addsta,
101 ifm_change_cb_t media_change, ifm_stat_cb_t media_stat);
102 static int media_status(enum ieee80211_opmode,
103 const struct ieee80211_channel *);
104 static uint64_t ieee80211_get_counter(struct ifnet *, ift_counter);
106 MALLOC_DEFINE(M_80211_VAP, "80211vap", "802.11 vap state");
109 * Default supported rates for 802.11 operation (in IEEE .5Mb units).
111 #define B(r) ((r) | IEEE80211_RATE_BASIC)
112 static const struct ieee80211_rateset ieee80211_rateset_11a =
113 { 8, { B(12), 18, B(24), 36, B(48), 72, 96, 108 } };
114 static const struct ieee80211_rateset ieee80211_rateset_half =
115 { 8, { B(6), 9, B(12), 18, B(24), 36, 48, 54 } };
116 static const struct ieee80211_rateset ieee80211_rateset_quarter =
117 { 8, { B(3), 4, B(6), 9, B(12), 18, 24, 27 } };
118 static const struct ieee80211_rateset ieee80211_rateset_11b =
119 { 4, { B(2), B(4), B(11), B(22) } };
120 /* NB: OFDM rates are handled specially based on mode */
121 static const struct ieee80211_rateset ieee80211_rateset_11g =
122 { 12, { B(2), B(4), B(11), B(22), 12, 18, 24, 36, 48, 72, 96, 108 } };
125 static int set_vht_extchan(struct ieee80211_channel *c);
128 * Fill in 802.11 available channel set, mark
129 * all available channels as active, and pick
130 * a default channel if not already specified.
133 ieee80211_chan_init(struct ieee80211com *ic)
135 #define DEFAULTRATES(m, def) do { \
136 if (ic->ic_sup_rates[m].rs_nrates == 0) \
137 ic->ic_sup_rates[m] = def; \
139 struct ieee80211_channel *c;
142 KASSERT(0 < ic->ic_nchans && ic->ic_nchans <= IEEE80211_CHAN_MAX,
143 ("invalid number of channels specified: %u", ic->ic_nchans));
144 memset(ic->ic_chan_avail, 0, sizeof(ic->ic_chan_avail));
145 memset(ic->ic_modecaps, 0, sizeof(ic->ic_modecaps));
146 setbit(ic->ic_modecaps, IEEE80211_MODE_AUTO);
147 for (i = 0; i < ic->ic_nchans; i++) {
148 c = &ic->ic_channels[i];
149 KASSERT(c->ic_flags != 0, ("channel with no flags"));
151 * Help drivers that work only with frequencies by filling
152 * in IEEE channel #'s if not already calculated. Note this
153 * mimics similar work done in ieee80211_setregdomain when
154 * changing regulatory state.
157 c->ic_ieee = ieee80211_mhz2ieee(c->ic_freq,c->ic_flags);
160 * Setup the HT40/VHT40 upper/lower bits.
161 * The VHT80/... math is done elsewhere.
163 if (IEEE80211_IS_CHAN_HT40(c) && c->ic_extieee == 0)
164 c->ic_extieee = ieee80211_mhz2ieee(c->ic_freq +
165 (IEEE80211_IS_CHAN_HT40U(c) ? 20 : -20),
168 /* Update VHT math */
170 * XXX VHT again, note that this assumes VHT80/... channels
175 /* default max tx power to max regulatory */
176 if (c->ic_maxpower == 0)
177 c->ic_maxpower = 2*c->ic_maxregpower;
178 setbit(ic->ic_chan_avail, c->ic_ieee);
180 * Identify mode capabilities.
182 if (IEEE80211_IS_CHAN_A(c))
183 setbit(ic->ic_modecaps, IEEE80211_MODE_11A);
184 if (IEEE80211_IS_CHAN_B(c))
185 setbit(ic->ic_modecaps, IEEE80211_MODE_11B);
186 if (IEEE80211_IS_CHAN_ANYG(c))
187 setbit(ic->ic_modecaps, IEEE80211_MODE_11G);
188 if (IEEE80211_IS_CHAN_FHSS(c))
189 setbit(ic->ic_modecaps, IEEE80211_MODE_FH);
190 if (IEEE80211_IS_CHAN_108A(c))
191 setbit(ic->ic_modecaps, IEEE80211_MODE_TURBO_A);
192 if (IEEE80211_IS_CHAN_108G(c))
193 setbit(ic->ic_modecaps, IEEE80211_MODE_TURBO_G);
194 if (IEEE80211_IS_CHAN_ST(c))
195 setbit(ic->ic_modecaps, IEEE80211_MODE_STURBO_A);
196 if (IEEE80211_IS_CHAN_HALF(c))
197 setbit(ic->ic_modecaps, IEEE80211_MODE_HALF);
198 if (IEEE80211_IS_CHAN_QUARTER(c))
199 setbit(ic->ic_modecaps, IEEE80211_MODE_QUARTER);
200 if (IEEE80211_IS_CHAN_HTA(c))
201 setbit(ic->ic_modecaps, IEEE80211_MODE_11NA);
202 if (IEEE80211_IS_CHAN_HTG(c))
203 setbit(ic->ic_modecaps, IEEE80211_MODE_11NG);
204 if (IEEE80211_IS_CHAN_VHTA(c))
205 setbit(ic->ic_modecaps, IEEE80211_MODE_VHT_5GHZ);
206 if (IEEE80211_IS_CHAN_VHTG(c))
207 setbit(ic->ic_modecaps, IEEE80211_MODE_VHT_2GHZ);
209 /* initialize candidate channels to all available */
210 memcpy(ic->ic_chan_active, ic->ic_chan_avail,
211 sizeof(ic->ic_chan_avail));
213 /* sort channel table to allow lookup optimizations */
214 ieee80211_sort_channels(ic->ic_channels, ic->ic_nchans);
216 /* invalidate any previous state */
217 ic->ic_bsschan = IEEE80211_CHAN_ANYC;
218 ic->ic_prevchan = NULL;
219 ic->ic_csa_newchan = NULL;
220 /* arbitrarily pick the first channel */
221 ic->ic_curchan = &ic->ic_channels[0];
222 ic->ic_rt = ieee80211_get_ratetable(ic->ic_curchan);
224 /* fillin well-known rate sets if driver has not specified */
225 DEFAULTRATES(IEEE80211_MODE_11B, ieee80211_rateset_11b);
226 DEFAULTRATES(IEEE80211_MODE_11G, ieee80211_rateset_11g);
227 DEFAULTRATES(IEEE80211_MODE_11A, ieee80211_rateset_11a);
228 DEFAULTRATES(IEEE80211_MODE_TURBO_A, ieee80211_rateset_11a);
229 DEFAULTRATES(IEEE80211_MODE_TURBO_G, ieee80211_rateset_11g);
230 DEFAULTRATES(IEEE80211_MODE_STURBO_A, ieee80211_rateset_11a);
231 DEFAULTRATES(IEEE80211_MODE_HALF, ieee80211_rateset_half);
232 DEFAULTRATES(IEEE80211_MODE_QUARTER, ieee80211_rateset_quarter);
233 DEFAULTRATES(IEEE80211_MODE_11NA, ieee80211_rateset_11a);
234 DEFAULTRATES(IEEE80211_MODE_11NG, ieee80211_rateset_11g);
235 DEFAULTRATES(IEEE80211_MODE_VHT_2GHZ, ieee80211_rateset_11g);
236 DEFAULTRATES(IEEE80211_MODE_VHT_5GHZ, ieee80211_rateset_11a);
239 * Setup required information to fill the mcsset field, if driver did
240 * not. Assume a 2T2R setup for historic reasons.
242 if (ic->ic_rxstream == 0)
244 if (ic->ic_txstream == 0)
247 ieee80211_init_suphtrates(ic);
250 * Set auto mode to reset active channel state and any desired channel.
252 (void) ieee80211_setmode(ic, IEEE80211_MODE_AUTO);
257 null_update_mcast(struct ieee80211com *ic)
260 ic_printf(ic, "need multicast update callback\n");
264 null_update_promisc(struct ieee80211com *ic)
267 ic_printf(ic, "need promiscuous mode update callback\n");
271 null_update_chw(struct ieee80211com *ic)
274 ic_printf(ic, "%s: need callback\n", __func__);
278 ic_printf(struct ieee80211com *ic, const char * fmt, ...)
283 retval = printf("%s: ", ic->ic_name);
285 retval += vprintf(fmt, ap);
290 static LIST_HEAD(, ieee80211com) ic_head = LIST_HEAD_INITIALIZER(ic_head);
291 static struct mtx ic_list_mtx;
292 MTX_SYSINIT(ic_list, &ic_list_mtx, "ieee80211com list", MTX_DEF);
295 sysctl_ieee80211coms(SYSCTL_HANDLER_ARGS)
297 struct ieee80211com *ic;
302 error = sysctl_wire_old_buffer(req, 0);
305 sbuf_new_for_sysctl(&sb, NULL, 8, req);
306 sbuf_clear_flags(&sb, SBUF_INCLUDENUL);
308 mtx_lock(&ic_list_mtx);
309 LIST_FOREACH(ic, &ic_head, ic_next) {
310 sbuf_printf(&sb, "%s%s", sp, ic->ic_name);
313 mtx_unlock(&ic_list_mtx);
314 error = sbuf_finish(&sb);
319 SYSCTL_PROC(_net_wlan, OID_AUTO, devices,
320 CTLTYPE_STRING | CTLFLAG_RD | CTLFLAG_MPSAFE, NULL, 0,
321 sysctl_ieee80211coms, "A", "names of available 802.11 devices");
324 * Attach/setup the common net80211 state. Called by
325 * the driver on attach to prior to creating any vap's.
328 ieee80211_ifattach(struct ieee80211com *ic)
331 IEEE80211_LOCK_INIT(ic, ic->ic_name);
332 IEEE80211_TX_LOCK_INIT(ic, ic->ic_name);
333 TAILQ_INIT(&ic->ic_vaps);
335 /* Create a taskqueue for all state changes */
336 ic->ic_tq = taskqueue_create("ic_taskq",
337 IEEE80211_M_WAITOK | IEEE80211_M_ZERO,
338 taskqueue_thread_enqueue, &ic->ic_tq);
339 taskqueue_start_threads(&ic->ic_tq, 1, PI_NET, "%s net80211 taskq",
341 ic->ic_ierrors = counter_u64_alloc(IEEE80211_M_WAITOK);
342 ic->ic_oerrors = counter_u64_alloc(IEEE80211_M_WAITOK);
344 * Fill in 802.11 available channel set, mark all
345 * available channels as active, and pick a default
346 * channel if not already specified.
348 ieee80211_chan_init(ic);
350 ic->ic_update_mcast = null_update_mcast;
351 ic->ic_update_promisc = null_update_promisc;
352 ic->ic_update_chw = null_update_chw;
354 ic->ic_hash_key = arc4random();
355 ic->ic_bintval = IEEE80211_BINTVAL_DEFAULT;
356 ic->ic_lintval = ic->ic_bintval;
357 ic->ic_txpowlimit = IEEE80211_TXPOWER_MAX;
359 ieee80211_crypto_attach(ic);
360 ieee80211_node_attach(ic);
361 ieee80211_power_attach(ic);
362 ieee80211_proto_attach(ic);
363 #ifdef IEEE80211_SUPPORT_SUPERG
364 ieee80211_superg_attach(ic);
366 ieee80211_ht_attach(ic);
367 ieee80211_vht_attach(ic);
368 ieee80211_scan_attach(ic);
369 ieee80211_regdomain_attach(ic);
370 ieee80211_dfs_attach(ic);
372 ieee80211_sysctl_attach(ic);
374 mtx_lock(&ic_list_mtx);
375 LIST_INSERT_HEAD(&ic_head, ic, ic_next);
376 mtx_unlock(&ic_list_mtx);
380 * Detach net80211 state on device detach. Tear down
381 * all vap's and reclaim all common state prior to the
382 * device state going away. Note we may call back into
383 * driver; it must be prepared for this.
386 ieee80211_ifdetach(struct ieee80211com *ic)
388 struct ieee80211vap *vap;
391 * We use this as an indicator that ifattach never had a chance to be
392 * called, e.g. early driver attach failed and ifdetach was called
393 * during subsequent detach. Never fear, for we have nothing to do
396 if (ic->ic_tq == NULL)
399 mtx_lock(&ic_list_mtx);
400 LIST_REMOVE(ic, ic_next);
401 mtx_unlock(&ic_list_mtx);
403 taskqueue_drain(taskqueue_thread, &ic->ic_restart_task);
406 * The VAP is responsible for setting and clearing
407 * the VIMAGE context.
409 while ((vap = TAILQ_FIRST(&ic->ic_vaps)) != NULL) {
410 ieee80211_com_vdetach(vap);
411 ieee80211_vap_destroy(vap);
413 ieee80211_waitfor_parent(ic);
415 ieee80211_sysctl_detach(ic);
416 ieee80211_dfs_detach(ic);
417 ieee80211_regdomain_detach(ic);
418 ieee80211_scan_detach(ic);
419 #ifdef IEEE80211_SUPPORT_SUPERG
420 ieee80211_superg_detach(ic);
422 ieee80211_vht_detach(ic);
423 ieee80211_ht_detach(ic);
424 /* NB: must be called before ieee80211_node_detach */
425 ieee80211_proto_detach(ic);
426 ieee80211_crypto_detach(ic);
427 ieee80211_power_detach(ic);
428 ieee80211_node_detach(ic);
430 counter_u64_free(ic->ic_ierrors);
431 counter_u64_free(ic->ic_oerrors);
433 taskqueue_free(ic->ic_tq);
434 IEEE80211_TX_LOCK_DESTROY(ic);
435 IEEE80211_LOCK_DESTROY(ic);
438 struct ieee80211com *
439 ieee80211_find_com(const char *name)
441 struct ieee80211com *ic;
443 mtx_lock(&ic_list_mtx);
444 LIST_FOREACH(ic, &ic_head, ic_next)
445 if (strcmp(ic->ic_name, name) == 0)
447 mtx_unlock(&ic_list_mtx);
453 ieee80211_iterate_coms(ieee80211_com_iter_func *f, void *arg)
455 struct ieee80211com *ic;
457 mtx_lock(&ic_list_mtx);
458 LIST_FOREACH(ic, &ic_head, ic_next)
460 mtx_unlock(&ic_list_mtx);
464 * Default reset method for use with the ioctl support. This
465 * method is invoked after any state change in the 802.11
466 * layer that should be propagated to the hardware but not
467 * require re-initialization of the 802.11 state machine (e.g
468 * rescanning for an ap). We always return ENETRESET which
469 * should cause the driver to re-initialize the device. Drivers
470 * can override this method to implement more optimized support.
473 default_reset(struct ieee80211vap *vap, u_long cmd)
479 * Default for updating the VAP default TX key index.
481 * Drivers that support TX offload as well as hardware encryption offload
482 * may need to be informed of key index changes separate from the key
486 default_update_deftxkey(struct ieee80211vap *vap, ieee80211_keyix kid)
489 /* XXX assert validity */
490 /* XXX assert we're in a key update block */
491 vap->iv_def_txkey = kid;
495 * Add underlying device errors to vap errors.
498 ieee80211_get_counter(struct ifnet *ifp, ift_counter cnt)
500 struct ieee80211vap *vap = ifp->if_softc;
501 struct ieee80211com *ic = vap->iv_ic;
504 rv = if_get_counter_default(ifp, cnt);
506 case IFCOUNTER_OERRORS:
507 rv += counter_u64_fetch(ic->ic_oerrors);
509 case IFCOUNTER_IERRORS:
510 rv += counter_u64_fetch(ic->ic_ierrors);
520 * Prepare a vap for use. Drivers use this call to
521 * setup net80211 state in new vap's prior attaching
522 * them with ieee80211_vap_attach (below).
525 ieee80211_vap_setup(struct ieee80211com *ic, struct ieee80211vap *vap,
526 const char name[IFNAMSIZ], int unit, enum ieee80211_opmode opmode,
527 int flags, const uint8_t bssid[IEEE80211_ADDR_LEN])
531 ifp = if_alloc(IFT_ETHER);
533 ic_printf(ic, "%s: unable to allocate ifnet\n", __func__);
536 if_initname(ifp, name, unit);
537 ifp->if_softc = vap; /* back pointer */
538 ifp->if_flags = IFF_SIMPLEX | IFF_BROADCAST | IFF_MULTICAST;
539 ifp->if_transmit = ieee80211_vap_transmit;
540 ifp->if_qflush = ieee80211_vap_qflush;
541 ifp->if_ioctl = ieee80211_ioctl;
542 ifp->if_init = ieee80211_init;
543 ifp->if_get_counter = ieee80211_get_counter;
547 vap->iv_flags = ic->ic_flags; /* propagate common flags */
548 vap->iv_flags_ext = ic->ic_flags_ext;
549 vap->iv_flags_ven = ic->ic_flags_ven;
550 vap->iv_caps = ic->ic_caps &~ IEEE80211_C_OPMODE;
552 /* 11n capabilities - XXX methodize */
553 vap->iv_htcaps = ic->ic_htcaps;
554 vap->iv_htextcaps = ic->ic_htextcaps;
556 /* 11ac capabilities - XXX methodize */
557 vap->iv_vhtcaps = ic->ic_vhtcaps;
558 vap->iv_vhtextcaps = ic->ic_vhtextcaps;
560 vap->iv_opmode = opmode;
561 vap->iv_caps |= ieee80211_opcap[opmode];
562 IEEE80211_ADDR_COPY(vap->iv_myaddr, ic->ic_macaddr);
564 case IEEE80211_M_WDS:
566 * WDS links must specify the bssid of the far end.
567 * For legacy operation this is a static relationship.
568 * For non-legacy operation the station must associate
569 * and be authorized to pass traffic. Plumbing the
570 * vap to the proper node happens when the vap
571 * transitions to RUN state.
573 IEEE80211_ADDR_COPY(vap->iv_des_bssid, bssid);
574 vap->iv_flags |= IEEE80211_F_DESBSSID;
575 if (flags & IEEE80211_CLONE_WDSLEGACY)
576 vap->iv_flags_ext |= IEEE80211_FEXT_WDSLEGACY;
578 #ifdef IEEE80211_SUPPORT_TDMA
579 case IEEE80211_M_AHDEMO:
580 if (flags & IEEE80211_CLONE_TDMA) {
581 /* NB: checked before clone operation allowed */
582 KASSERT(ic->ic_caps & IEEE80211_C_TDMA,
583 ("not TDMA capable, ic_caps 0x%x", ic->ic_caps));
585 * Propagate TDMA capability to mark vap; this
586 * cannot be removed and is used to distinguish
587 * regular ahdemo operation from ahdemo+tdma.
589 vap->iv_caps |= IEEE80211_C_TDMA;
596 /* auto-enable s/w beacon miss support */
597 if (flags & IEEE80211_CLONE_NOBEACONS)
598 vap->iv_flags_ext |= IEEE80211_FEXT_SWBMISS;
599 /* auto-generated or user supplied MAC address */
600 if (flags & (IEEE80211_CLONE_BSSID|IEEE80211_CLONE_MACADDR))
601 vap->iv_flags_ext |= IEEE80211_FEXT_UNIQMAC;
603 * Enable various functionality by default if we're
604 * capable; the driver can override us if it knows better.
606 if (vap->iv_caps & IEEE80211_C_WME)
607 vap->iv_flags |= IEEE80211_F_WME;
608 if (vap->iv_caps & IEEE80211_C_BURST)
609 vap->iv_flags |= IEEE80211_F_BURST;
610 /* NB: bg scanning only makes sense for station mode right now */
611 if (vap->iv_opmode == IEEE80211_M_STA &&
612 (vap->iv_caps & IEEE80211_C_BGSCAN))
613 vap->iv_flags |= IEEE80211_F_BGSCAN;
614 vap->iv_flags |= IEEE80211_F_DOTH; /* XXX no cap, just ena */
615 /* NB: DFS support only makes sense for ap mode right now */
616 if (vap->iv_opmode == IEEE80211_M_HOSTAP &&
617 (vap->iv_caps & IEEE80211_C_DFS))
618 vap->iv_flags_ext |= IEEE80211_FEXT_DFS;
619 /* NB: only flip on U-APSD for hostap/sta for now */
620 if ((vap->iv_opmode == IEEE80211_M_STA)
621 || (vap->iv_opmode == IEEE80211_M_HOSTAP)) {
622 if (vap->iv_caps & IEEE80211_C_UAPSD)
623 vap->iv_flags_ext |= IEEE80211_FEXT_UAPSD;
626 vap->iv_des_chan = IEEE80211_CHAN_ANYC; /* any channel is ok */
627 vap->iv_bmissthreshold = IEEE80211_HWBMISS_DEFAULT;
628 vap->iv_dtim_period = IEEE80211_DTIM_DEFAULT;
630 * Install a default reset method for the ioctl support;
631 * the driver can override this.
633 vap->iv_reset = default_reset;
636 * Install a default crypto key update method, the driver
639 vap->iv_update_deftxkey = default_update_deftxkey;
641 ieee80211_sysctl_vattach(vap);
642 ieee80211_crypto_vattach(vap);
643 ieee80211_node_vattach(vap);
644 ieee80211_power_vattach(vap);
645 ieee80211_proto_vattach(vap);
646 #ifdef IEEE80211_SUPPORT_SUPERG
647 ieee80211_superg_vattach(vap);
649 ieee80211_ht_vattach(vap);
650 ieee80211_vht_vattach(vap);
651 ieee80211_scan_vattach(vap);
652 ieee80211_regdomain_vattach(vap);
653 ieee80211_radiotap_vattach(vap);
654 ieee80211_vap_reset_erp(vap);
655 ieee80211_ratectl_set(vap, IEEE80211_RATECTL_NONE);
661 * Activate a vap. State should have been prepared with a
662 * call to ieee80211_vap_setup and by the driver. On return
663 * from this call the vap is ready for use.
666 ieee80211_vap_attach(struct ieee80211vap *vap, ifm_change_cb_t media_change,
667 ifm_stat_cb_t media_stat, const uint8_t macaddr[IEEE80211_ADDR_LEN])
669 struct ifnet *ifp = vap->iv_ifp;
670 struct ieee80211com *ic = vap->iv_ic;
671 struct ifmediareq imr;
674 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE,
675 "%s: %s parent %s flags 0x%x flags_ext 0x%x\n",
676 __func__, ieee80211_opmode_name[vap->iv_opmode],
677 ic->ic_name, vap->iv_flags, vap->iv_flags_ext);
680 * Do late attach work that cannot happen until after
681 * the driver has had a chance to override defaults.
683 ieee80211_node_latevattach(vap);
684 ieee80211_power_latevattach(vap);
686 maxrate = ieee80211_media_setup(ic, &vap->iv_media, vap->iv_caps,
687 vap->iv_opmode == IEEE80211_M_STA, media_change, media_stat);
688 ieee80211_media_status(ifp, &imr);
689 /* NB: strip explicit mode; we're actually in autoselect */
690 ifmedia_set(&vap->iv_media,
691 imr.ifm_active &~ (IFM_MMASK | IFM_IEEE80211_TURBO));
693 ifp->if_baudrate = IF_Mbps(maxrate);
695 ether_ifattach(ifp, macaddr);
696 IEEE80211_ADDR_COPY(vap->iv_myaddr, IF_LLADDR(ifp));
697 /* hook output method setup by ether_ifattach */
698 vap->iv_output = ifp->if_output;
699 ifp->if_output = ieee80211_output;
700 /* NB: if_mtu set by ether_ifattach to ETHERMTU */
703 TAILQ_INSERT_TAIL(&ic->ic_vaps, vap, iv_next);
704 ieee80211_syncflag_locked(ic, IEEE80211_F_WME);
705 #ifdef IEEE80211_SUPPORT_SUPERG
706 ieee80211_syncflag_locked(ic, IEEE80211_F_TURBOP);
708 ieee80211_syncflag_locked(ic, IEEE80211_F_PCF);
709 ieee80211_syncflag_locked(ic, IEEE80211_F_BURST);
710 ieee80211_syncflag_ht_locked(ic, IEEE80211_FHT_HT);
711 ieee80211_syncflag_ht_locked(ic, IEEE80211_FHT_USEHT40);
713 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_VHT);
714 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT40);
715 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT80);
716 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT160);
717 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT80P80);
718 IEEE80211_UNLOCK(ic);
724 * Tear down vap state and reclaim the ifnet.
725 * The driver is assumed to have prepared for
726 * this; e.g. by turning off interrupts for the
730 ieee80211_vap_detach(struct ieee80211vap *vap)
732 struct ieee80211com *ic = vap->iv_ic;
733 struct ifnet *ifp = vap->iv_ifp;
735 CURVNET_SET(ifp->if_vnet);
737 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE, "%s: %s parent %s\n",
738 __func__, ieee80211_opmode_name[vap->iv_opmode], ic->ic_name);
740 /* NB: bpfdetach is called by ether_ifdetach and claims all taps */
746 * Flush any deferred vap tasks.
748 ieee80211_draintask(ic, &vap->iv_nstate_task);
749 ieee80211_draintask(ic, &vap->iv_swbmiss_task);
750 ieee80211_draintask(ic, &vap->iv_wme_task);
751 ieee80211_draintask(ic, &ic->ic_parent_task);
753 /* XXX band-aid until ifnet handles this for us */
754 taskqueue_drain(taskqueue_swi, &ifp->if_linktask);
757 KASSERT(vap->iv_state == IEEE80211_S_INIT , ("vap still running"));
758 TAILQ_REMOVE(&ic->ic_vaps, vap, iv_next);
759 ieee80211_syncflag_locked(ic, IEEE80211_F_WME);
760 #ifdef IEEE80211_SUPPORT_SUPERG
761 ieee80211_syncflag_locked(ic, IEEE80211_F_TURBOP);
763 ieee80211_syncflag_locked(ic, IEEE80211_F_PCF);
764 ieee80211_syncflag_locked(ic, IEEE80211_F_BURST);
765 ieee80211_syncflag_ht_locked(ic, IEEE80211_FHT_HT);
766 ieee80211_syncflag_ht_locked(ic, IEEE80211_FHT_USEHT40);
768 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_VHT);
769 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT40);
770 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT80);
771 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT160);
772 ieee80211_syncflag_vht_locked(ic, IEEE80211_FVHT_USEVHT80P80);
774 /* NB: this handles the bpfdetach done below */
775 ieee80211_syncflag_ext_locked(ic, IEEE80211_FEXT_BPF);
776 if (vap->iv_ifflags & IFF_PROMISC)
777 ieee80211_promisc(vap, false);
778 if (vap->iv_ifflags & IFF_ALLMULTI)
779 ieee80211_allmulti(vap, false);
780 IEEE80211_UNLOCK(ic);
782 ifmedia_removeall(&vap->iv_media);
784 ieee80211_radiotap_vdetach(vap);
785 ieee80211_regdomain_vdetach(vap);
786 ieee80211_scan_vdetach(vap);
787 #ifdef IEEE80211_SUPPORT_SUPERG
788 ieee80211_superg_vdetach(vap);
790 ieee80211_vht_vdetach(vap);
791 ieee80211_ht_vdetach(vap);
792 /* NB: must be before ieee80211_node_vdetach */
793 ieee80211_proto_vdetach(vap);
794 ieee80211_crypto_vdetach(vap);
795 ieee80211_power_vdetach(vap);
796 ieee80211_node_vdetach(vap);
797 ieee80211_sysctl_vdetach(vap);
805 * Count number of vaps in promisc, and issue promisc on
806 * parent respectively.
809 ieee80211_promisc(struct ieee80211vap *vap, bool on)
811 struct ieee80211com *ic = vap->iv_ic;
813 IEEE80211_LOCK_ASSERT(ic);
816 if (++ic->ic_promisc == 1)
817 ieee80211_runtask(ic, &ic->ic_promisc_task);
819 KASSERT(ic->ic_promisc > 0, ("%s: ic %p not promisc",
821 if (--ic->ic_promisc == 0)
822 ieee80211_runtask(ic, &ic->ic_promisc_task);
827 * Count number of vaps in allmulti, and issue allmulti on
828 * parent respectively.
831 ieee80211_allmulti(struct ieee80211vap *vap, bool on)
833 struct ieee80211com *ic = vap->iv_ic;
835 IEEE80211_LOCK_ASSERT(ic);
838 if (++ic->ic_allmulti == 1)
839 ieee80211_runtask(ic, &ic->ic_mcast_task);
841 KASSERT(ic->ic_allmulti > 0, ("%s: ic %p not allmulti",
843 if (--ic->ic_allmulti == 0)
844 ieee80211_runtask(ic, &ic->ic_mcast_task);
849 * Synchronize flag bit state in the com structure
850 * according to the state of all vap's. This is used,
851 * for example, to handle state changes via ioctls.
854 ieee80211_syncflag_locked(struct ieee80211com *ic, int flag)
856 struct ieee80211vap *vap;
859 IEEE80211_LOCK_ASSERT(ic);
862 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next)
863 if (vap->iv_flags & flag) {
868 ic->ic_flags |= flag;
870 ic->ic_flags &= ~flag;
874 ieee80211_syncflag(struct ieee80211vap *vap, int flag)
876 struct ieee80211com *ic = vap->iv_ic;
881 vap->iv_flags &= ~flag;
883 vap->iv_flags |= flag;
884 ieee80211_syncflag_locked(ic, flag);
885 IEEE80211_UNLOCK(ic);
889 * Synchronize flags_ht bit state in the com structure
890 * according to the state of all vap's. This is used,
891 * for example, to handle state changes via ioctls.
894 ieee80211_syncflag_ht_locked(struct ieee80211com *ic, int flag)
896 struct ieee80211vap *vap;
899 IEEE80211_LOCK_ASSERT(ic);
902 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next)
903 if (vap->iv_flags_ht & flag) {
908 ic->ic_flags_ht |= flag;
910 ic->ic_flags_ht &= ~flag;
914 ieee80211_syncflag_ht(struct ieee80211vap *vap, int flag)
916 struct ieee80211com *ic = vap->iv_ic;
921 vap->iv_flags_ht &= ~flag;
923 vap->iv_flags_ht |= flag;
924 ieee80211_syncflag_ht_locked(ic, flag);
925 IEEE80211_UNLOCK(ic);
929 * Synchronize flags_vht bit state in the com structure
930 * according to the state of all vap's. This is used,
931 * for example, to handle state changes via ioctls.
934 ieee80211_syncflag_vht_locked(struct ieee80211com *ic, int flag)
936 struct ieee80211vap *vap;
939 IEEE80211_LOCK_ASSERT(ic);
942 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next)
943 if (vap->iv_flags_vht & flag) {
948 ic->ic_flags_vht |= flag;
950 ic->ic_flags_vht &= ~flag;
954 ieee80211_syncflag_vht(struct ieee80211vap *vap, int flag)
956 struct ieee80211com *ic = vap->iv_ic;
961 vap->iv_flags_vht &= ~flag;
963 vap->iv_flags_vht |= flag;
964 ieee80211_syncflag_vht_locked(ic, flag);
965 IEEE80211_UNLOCK(ic);
969 * Synchronize flags_ext bit state in the com structure
970 * according to the state of all vap's. This is used,
971 * for example, to handle state changes via ioctls.
974 ieee80211_syncflag_ext_locked(struct ieee80211com *ic, int flag)
976 struct ieee80211vap *vap;
979 IEEE80211_LOCK_ASSERT(ic);
982 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next)
983 if (vap->iv_flags_ext & flag) {
988 ic->ic_flags_ext |= flag;
990 ic->ic_flags_ext &= ~flag;
994 ieee80211_syncflag_ext(struct ieee80211vap *vap, int flag)
996 struct ieee80211com *ic = vap->iv_ic;
1001 vap->iv_flags_ext &= ~flag;
1003 vap->iv_flags_ext |= flag;
1004 ieee80211_syncflag_ext_locked(ic, flag);
1005 IEEE80211_UNLOCK(ic);
1009 mapgsm(u_int freq, u_int flags)
1012 if (flags & IEEE80211_CHAN_QUARTER)
1014 else if (flags & IEEE80211_CHAN_HALF)
1018 /* NB: there is no 907/20 wide but leave room */
1019 return (freq - 906*10) / 5;
1023 mappsb(u_int freq, u_int flags)
1025 return 37 + ((freq * 10) + ((freq % 5) == 2 ? 5 : 0) - 49400) / 5;
1029 * Convert MHz frequency to IEEE channel number.
1032 ieee80211_mhz2ieee(u_int freq, u_int flags)
1034 #define IS_FREQ_IN_PSB(_freq) ((_freq) > 4940 && (_freq) < 4990)
1035 if (flags & IEEE80211_CHAN_GSM)
1036 return mapgsm(freq, flags);
1037 if (flags & IEEE80211_CHAN_2GHZ) { /* 2GHz band */
1041 return ((int) freq - 2407) / 5;
1043 return 15 + ((freq - 2512) / 20);
1044 } else if (flags & IEEE80211_CHAN_5GHZ) { /* 5Ghz band */
1046 /* XXX check regdomain? */
1047 if (IS_FREQ_IN_PSB(freq))
1048 return mappsb(freq, flags);
1049 return (freq - 4000) / 5;
1051 return (freq - 5000) / 5;
1052 } else { /* either, guess */
1056 if (907 <= freq && freq <= 922)
1057 return mapgsm(freq, flags);
1058 return ((int) freq - 2407) / 5;
1061 if (IS_FREQ_IN_PSB(freq))
1062 return mappsb(freq, flags);
1063 else if (freq > 4900)
1064 return (freq - 4000) / 5;
1066 return 15 + ((freq - 2512) / 20);
1068 return (freq - 5000) / 5;
1070 #undef IS_FREQ_IN_PSB
1074 * Convert channel to IEEE channel number.
1077 ieee80211_chan2ieee(struct ieee80211com *ic, const struct ieee80211_channel *c)
1080 ic_printf(ic, "invalid channel (NULL)\n");
1083 return (c == IEEE80211_CHAN_ANYC ? IEEE80211_CHAN_ANY : c->ic_ieee);
1087 * Convert IEEE channel number to MHz frequency.
1090 ieee80211_ieee2mhz(u_int chan, u_int flags)
1092 if (flags & IEEE80211_CHAN_GSM)
1093 return 907 + 5 * (chan / 10);
1094 if (flags & IEEE80211_CHAN_2GHZ) { /* 2GHz band */
1098 return 2407 + chan*5;
1100 return 2512 + ((chan-15)*20);
1101 } else if (flags & IEEE80211_CHAN_5GHZ) {/* 5Ghz band */
1102 if (flags & (IEEE80211_CHAN_HALF|IEEE80211_CHAN_QUARTER)) {
1104 return 4940 + chan*5 + (chan % 5 ? 2 : 0);
1106 return 5000 + (chan*5);
1107 } else { /* either, guess */
1108 /* XXX can't distinguish PSB+GSM channels */
1111 if (chan < 14) /* 0-13 */
1112 return 2407 + chan*5;
1113 if (chan < 27) /* 15-26 */
1114 return 2512 + ((chan-15)*20);
1115 return 5000 + (chan*5);
1119 static __inline void
1120 set_extchan(struct ieee80211_channel *c)
1124 * IEEE Std 802.11-2012, page 1738, subclause 20.3.15.4:
1125 * "the secondary channel number shall be 'N + [1,-1] * 4'
1127 if (c->ic_flags & IEEE80211_CHAN_HT40U)
1128 c->ic_extieee = c->ic_ieee + 4;
1129 else if (c->ic_flags & IEEE80211_CHAN_HT40D)
1130 c->ic_extieee = c->ic_ieee - 4;
1136 * Populate the freq1/freq2 fields as appropriate for VHT channels.
1138 * This for now uses a hard-coded list of 80MHz wide channels.
1140 * For HT20/HT40, freq1 just is the centre frequency of the 40MHz
1141 * wide channel we've already decided upon.
1143 * For VHT80 and VHT160, there are only a small number of fixed
1144 * 80/160MHz wide channels, so we just use those.
1146 * This is all likely very very wrong - both the regulatory code
1147 * and this code needs to ensure that all four channels are
1148 * available and valid before the VHT80 (and eight for VHT160) channel
1152 struct vht_chan_range {
1153 uint16_t freq_start;
1157 struct vht_chan_range vht80_chan_ranges[] = {
1167 struct vht_chan_range vht160_chan_ranges[] = {
1174 set_vht_extchan(struct ieee80211_channel *c)
1178 if (! IEEE80211_IS_CHAN_VHT(c))
1181 if (IEEE80211_IS_CHAN_VHT80P80(c)) {
1182 printf("%s: TODO VHT80+80 channel (ieee=%d, flags=0x%08x)\n",
1183 __func__, c->ic_ieee, c->ic_flags);
1186 if (IEEE80211_IS_CHAN_VHT160(c)) {
1187 for (i = 0; vht160_chan_ranges[i].freq_start != 0; i++) {
1188 if (c->ic_freq >= vht160_chan_ranges[i].freq_start &&
1189 c->ic_freq < vht160_chan_ranges[i].freq_end) {
1192 midpoint = vht160_chan_ranges[i].freq_start + 80;
1193 c->ic_vht_ch_freq1 =
1194 ieee80211_mhz2ieee(midpoint, c->ic_flags);
1195 c->ic_vht_ch_freq2 = 0;
1197 printf("%s: %d, freq=%d, midpoint=%d, freq1=%d, freq2=%d\n",
1198 __func__, c->ic_ieee, c->ic_freq, midpoint,
1199 c->ic_vht_ch_freq1, c->ic_vht_ch_freq2);
1207 if (IEEE80211_IS_CHAN_VHT80(c)) {
1208 for (i = 0; vht80_chan_ranges[i].freq_start != 0; i++) {
1209 if (c->ic_freq >= vht80_chan_ranges[i].freq_start &&
1210 c->ic_freq < vht80_chan_ranges[i].freq_end) {
1213 midpoint = vht80_chan_ranges[i].freq_start + 40;
1214 c->ic_vht_ch_freq1 =
1215 ieee80211_mhz2ieee(midpoint, c->ic_flags);
1216 c->ic_vht_ch_freq2 = 0;
1218 printf("%s: %d, freq=%d, midpoint=%d, freq1=%d, freq2=%d\n",
1219 __func__, c->ic_ieee, c->ic_freq, midpoint,
1220 c->ic_vht_ch_freq1, c->ic_vht_ch_freq2);
1228 if (IEEE80211_IS_CHAN_VHT40(c)) {
1229 if (IEEE80211_IS_CHAN_HT40U(c))
1230 c->ic_vht_ch_freq1 = c->ic_ieee + 2;
1231 else if (IEEE80211_IS_CHAN_HT40D(c))
1232 c->ic_vht_ch_freq1 = c->ic_ieee - 2;
1238 if (IEEE80211_IS_CHAN_VHT20(c)) {
1239 c->ic_vht_ch_freq1 = c->ic_ieee;
1243 printf("%s: unknown VHT channel type (ieee=%d, flags=0x%08x)\n",
1244 __func__, c->ic_ieee, c->ic_flags);
1250 * Return whether the current channel could possibly be a part of
1251 * a VHT80/VHT160 channel.
1253 * This doesn't check that the whole range is in the allowed list
1254 * according to regulatory.
1257 is_vht160_valid_freq(uint16_t freq)
1261 for (i = 0; vht160_chan_ranges[i].freq_start != 0; i++) {
1262 if (freq >= vht160_chan_ranges[i].freq_start &&
1263 freq < vht160_chan_ranges[i].freq_end)
1270 is_vht80_valid_freq(uint16_t freq)
1273 for (i = 0; vht80_chan_ranges[i].freq_start != 0; i++) {
1274 if (freq >= vht80_chan_ranges[i].freq_start &&
1275 freq < vht80_chan_ranges[i].freq_end)
1282 addchan(struct ieee80211_channel chans[], int maxchans, int *nchans,
1283 uint8_t ieee, uint16_t freq, int8_t maxregpower, uint32_t flags)
1285 struct ieee80211_channel *c;
1287 if (*nchans >= maxchans)
1291 printf("%s: %d of %d: ieee=%d, freq=%d, flags=0x%08x\n",
1292 __func__, *nchans, maxchans, ieee, freq, flags);
1295 c = &chans[(*nchans)++];
1297 c->ic_freq = freq != 0 ? freq : ieee80211_ieee2mhz(ieee, flags);
1298 c->ic_maxregpower = maxregpower;
1299 c->ic_maxpower = 2 * maxregpower;
1300 c->ic_flags = flags;
1301 c->ic_vht_ch_freq1 = 0;
1302 c->ic_vht_ch_freq2 = 0;
1310 copychan_prev(struct ieee80211_channel chans[], int maxchans, int *nchans,
1313 struct ieee80211_channel *c;
1315 KASSERT(*nchans > 0, ("channel list is empty\n"));
1317 if (*nchans >= maxchans)
1321 printf("%s: %d of %d: flags=0x%08x\n",
1322 __func__, *nchans, maxchans, flags);
1325 c = &chans[(*nchans)++];
1327 c->ic_flags = flags;
1328 c->ic_vht_ch_freq1 = 0;
1329 c->ic_vht_ch_freq2 = 0;
1340 getflags_2ghz(const uint8_t bands[], uint32_t flags[], int cbw_flags)
1345 if (isset(bands, IEEE80211_MODE_11B))
1346 flags[nmodes++] = IEEE80211_CHAN_B;
1347 if (isset(bands, IEEE80211_MODE_11G))
1348 flags[nmodes++] = IEEE80211_CHAN_G;
1349 if (isset(bands, IEEE80211_MODE_11NG))
1350 flags[nmodes++] = IEEE80211_CHAN_G | IEEE80211_CHAN_HT20;
1351 if (cbw_flags & NET80211_CBW_FLAG_HT40) {
1352 flags[nmodes++] = IEEE80211_CHAN_G | IEEE80211_CHAN_HT40U;
1353 flags[nmodes++] = IEEE80211_CHAN_G | IEEE80211_CHAN_HT40D;
1359 getflags_5ghz(const uint8_t bands[], uint32_t flags[], int cbw_flags)
1364 * The addchan_list() function seems to expect the flags array to
1365 * be in channel width order, so the VHT bits are interspersed
1366 * as appropriate to maintain said order.
1368 * It also assumes HT40U is before HT40D.
1373 if (isset(bands, IEEE80211_MODE_11A))
1374 flags[nmodes++] = IEEE80211_CHAN_A;
1375 if (isset(bands, IEEE80211_MODE_11NA))
1376 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT20;
1377 if (isset(bands, IEEE80211_MODE_VHT_5GHZ)) {
1378 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT20 |
1379 IEEE80211_CHAN_VHT20;
1383 if (cbw_flags & NET80211_CBW_FLAG_HT40)
1384 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40U;
1385 if ((cbw_flags & NET80211_CBW_FLAG_HT40) &&
1386 isset(bands, IEEE80211_MODE_VHT_5GHZ))
1387 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40U |
1388 IEEE80211_CHAN_VHT40U;
1389 if (cbw_flags & NET80211_CBW_FLAG_HT40)
1390 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40D;
1391 if ((cbw_flags & NET80211_CBW_FLAG_HT40) &&
1392 isset(bands, IEEE80211_MODE_VHT_5GHZ))
1393 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40D |
1394 IEEE80211_CHAN_VHT40D;
1397 if ((cbw_flags & NET80211_CBW_FLAG_VHT80) &&
1398 isset(bands, IEEE80211_MODE_VHT_5GHZ)) {
1399 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40U |
1400 IEEE80211_CHAN_VHT80;
1401 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40D |
1402 IEEE80211_CHAN_VHT80;
1406 if ((cbw_flags & NET80211_CBW_FLAG_VHT160) &&
1407 isset(bands, IEEE80211_MODE_VHT_5GHZ)) {
1408 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40U |
1409 IEEE80211_CHAN_VHT160;
1410 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40D |
1411 IEEE80211_CHAN_VHT160;
1415 if ((cbw_flags & NET80211_CBW_FLAG_VHT80P80) &&
1416 isset(bands, IEEE80211_MODE_VHT_5GHZ)) {
1417 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40U |
1418 IEEE80211_CHAN_VHT80P80;
1419 flags[nmodes++] = IEEE80211_CHAN_A | IEEE80211_CHAN_HT40D |
1420 IEEE80211_CHAN_VHT80P80;
1427 getflags(const uint8_t bands[], uint32_t flags[], int cbw_flags)
1431 if (isset(bands, IEEE80211_MODE_11A) ||
1432 isset(bands, IEEE80211_MODE_11NA) ||
1433 isset(bands, IEEE80211_MODE_VHT_5GHZ)) {
1434 if (isset(bands, IEEE80211_MODE_11B) ||
1435 isset(bands, IEEE80211_MODE_11G) ||
1436 isset(bands, IEEE80211_MODE_11NG) ||
1437 isset(bands, IEEE80211_MODE_VHT_2GHZ))
1440 getflags_5ghz(bands, flags, cbw_flags);
1442 getflags_2ghz(bands, flags, cbw_flags);
1446 * Add one 20 MHz channel into specified channel list.
1447 * You MUST NOT mix bands when calling this. It will not add 5ghz
1448 * channels if you have any B/G/N band bit set.
1449 * The _cbw() variant does also support HT40/VHT80/160/80+80.
1452 ieee80211_add_channel_cbw(struct ieee80211_channel chans[], int maxchans,
1453 int *nchans, uint8_t ieee, uint16_t freq, int8_t maxregpower,
1454 uint32_t chan_flags, const uint8_t bands[], int cbw_flags)
1456 uint32_t flags[IEEE80211_MODE_MAX];
1459 getflags(bands, flags, cbw_flags);
1460 KASSERT(flags[0] != 0, ("%s: no correct mode provided\n", __func__));
1462 error = addchan(chans, maxchans, nchans, ieee, freq, maxregpower,
1463 flags[0] | chan_flags);
1464 for (i = 1; flags[i] != 0 && error == 0; i++) {
1465 error = copychan_prev(chans, maxchans, nchans,
1466 flags[i] | chan_flags);
1473 ieee80211_add_channel(struct ieee80211_channel chans[], int maxchans,
1474 int *nchans, uint8_t ieee, uint16_t freq, int8_t maxregpower,
1475 uint32_t chan_flags, const uint8_t bands[])
1478 return (ieee80211_add_channel_cbw(chans, maxchans, nchans, ieee, freq,
1479 maxregpower, chan_flags, bands, 0));
1482 static struct ieee80211_channel *
1483 findchannel(struct ieee80211_channel chans[], int nchans, uint16_t freq,
1486 struct ieee80211_channel *c;
1489 flags &= IEEE80211_CHAN_ALLTURBO;
1490 /* brute force search */
1491 for (i = 0; i < nchans; i++) {
1493 if (c->ic_freq == freq &&
1494 (c->ic_flags & IEEE80211_CHAN_ALLTURBO) == flags)
1501 * Add 40 MHz channel pair into specified channel list.
1505 ieee80211_add_channel_ht40(struct ieee80211_channel chans[], int maxchans,
1506 int *nchans, uint8_t ieee, int8_t maxregpower, uint32_t flags)
1508 struct ieee80211_channel *cent, *extc;
1512 freq = ieee80211_ieee2mhz(ieee, flags);
1515 * Each entry defines an HT40 channel pair; find the
1516 * center channel, then the extension channel above.
1518 flags |= IEEE80211_CHAN_HT20;
1519 cent = findchannel(chans, *nchans, freq, flags);
1523 extc = findchannel(chans, *nchans, freq + 20, flags);
1527 flags &= ~IEEE80211_CHAN_HT;
1528 error = addchan(chans, maxchans, nchans, cent->ic_ieee, cent->ic_freq,
1529 maxregpower, flags | IEEE80211_CHAN_HT40U);
1533 error = addchan(chans, maxchans, nchans, extc->ic_ieee, extc->ic_freq,
1534 maxregpower, flags | IEEE80211_CHAN_HT40D);
1540 * Fetch the center frequency for the primary channel.
1543 ieee80211_get_channel_center_freq(const struct ieee80211_channel *c)
1546 return (c->ic_freq);
1550 * Fetch the center frequency for the primary BAND channel.
1552 * For 5, 10, 20MHz channels it'll be the normally configured channel
1555 * For 40MHz, 80MHz, 160MHz channels it will be the centre of the
1556 * wide channel, not the centre of the primary channel (that's ic_freq).
1558 * For 80+80MHz channels this will be the centre of the primary
1559 * 80MHz channel; the secondary 80MHz channel will be center_freq2().
1562 ieee80211_get_channel_center_freq1(const struct ieee80211_channel *c)
1566 * VHT - use the pre-calculated centre frequency
1567 * of the given channel.
1569 if (IEEE80211_IS_CHAN_VHT(c))
1570 return (ieee80211_ieee2mhz(c->ic_vht_ch_freq1, c->ic_flags));
1572 if (IEEE80211_IS_CHAN_HT40U(c)) {
1573 return (c->ic_freq + 10);
1575 if (IEEE80211_IS_CHAN_HT40D(c)) {
1576 return (c->ic_freq - 10);
1579 return (c->ic_freq);
1583 * For now, no 80+80 support; it will likely always return 0.
1586 ieee80211_get_channel_center_freq2(const struct ieee80211_channel *c)
1589 if (IEEE80211_IS_CHAN_VHT(c) && (c->ic_vht_ch_freq2 != 0))
1590 return (ieee80211_ieee2mhz(c->ic_vht_ch_freq2, c->ic_flags));
1596 * Adds channels into specified channel list (ieee[] array must be sorted).
1597 * Channels are already sorted.
1600 add_chanlist(struct ieee80211_channel chans[], int maxchans, int *nchans,
1601 const uint8_t ieee[], int nieee, uint32_t flags[])
1607 for (i = 0; i < nieee; i++) {
1608 freq = ieee80211_ieee2mhz(ieee[i], flags[0]);
1609 for (j = 0; flags[j] != 0; j++) {
1612 * + HT40 and VHT40 channels occur together, so
1613 * we need to be careful that we actually allow that.
1614 * + VHT80, VHT160 will coexist with HT40/VHT40, so
1615 * make sure it's not skipped because of the overlap
1616 * check used for (V)HT40.
1618 is_vht = !! (flags[j] & IEEE80211_CHAN_VHT);
1620 /* XXX TODO FIXME VHT80P80. */
1622 /* Test for VHT160 analogue to the VHT80 below. */
1623 if (is_vht && flags[j] & IEEE80211_CHAN_VHT160)
1624 if (! is_vht160_valid_freq(freq))
1629 * XXX This is all very broken right now.
1630 * What we /should/ do is:
1632 * + check that the frequency is in the list of
1633 * allowed VHT80 ranges; and
1634 * + the other 3 channels in the list are actually
1637 if (is_vht && flags[j] & IEEE80211_CHAN_VHT80)
1638 if (! is_vht80_valid_freq(freq))
1644 * This is also a fall through from VHT80; as we only
1645 * allow a VHT80 channel if the VHT40 combination is
1646 * also valid. If the VHT40 form is not valid then
1647 * we certainly can't do VHT80..
1649 if (flags[j] & IEEE80211_CHAN_HT40D)
1651 * Can't have a "lower" channel if we are the
1654 * Can't have a "lower" channel if it's below/
1655 * within 20MHz of the first channel.
1657 * Can't have a "lower" channel if the channel
1658 * below it is not 20MHz away.
1660 if (i == 0 || ieee[i] < ieee[0] + 4 ||
1662 ieee80211_ieee2mhz(ieee[i] - 4, flags[j]))
1664 if (flags[j] & IEEE80211_CHAN_HT40U)
1666 * Can't have an "upper" channel if we are
1669 * Can't have an "upper" channel be above the
1670 * last channel in the list.
1672 * Can't have an "upper" channel if the next
1673 * channel according to the math isn't 20MHz
1674 * away. (Likely for channel 13/14.)
1676 if (i == nieee - 1 ||
1677 ieee[i] + 4 > ieee[nieee - 1] ||
1679 ieee80211_ieee2mhz(ieee[i] + 4, flags[j]))
1683 error = addchan(chans, maxchans, nchans,
1684 ieee[i], freq, 0, flags[j]);
1686 error = copychan_prev(chans, maxchans, nchans,
1698 ieee80211_add_channel_list_2ghz(struct ieee80211_channel chans[], int maxchans,
1699 int *nchans, const uint8_t ieee[], int nieee, const uint8_t bands[],
1702 uint32_t flags[IEEE80211_MODE_MAX];
1704 /* XXX no VHT for now */
1705 getflags_2ghz(bands, flags, cbw_flags);
1706 KASSERT(flags[0] != 0, ("%s: no correct mode provided\n", __func__));
1708 return (add_chanlist(chans, maxchans, nchans, ieee, nieee, flags));
1712 ieee80211_add_channels_default_2ghz(struct ieee80211_channel chans[],
1713 int maxchans, int *nchans, const uint8_t bands[], int cbw_flags)
1715 const uint8_t default_chan_list[] =
1716 { 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14 };
1718 return (ieee80211_add_channel_list_2ghz(chans, maxchans, nchans,
1719 default_chan_list, nitems(default_chan_list), bands, cbw_flags));
1723 ieee80211_add_channel_list_5ghz(struct ieee80211_channel chans[], int maxchans,
1724 int *nchans, const uint8_t ieee[], int nieee, const uint8_t bands[],
1728 * XXX-BZ with HT and VHT there is no 1:1 mapping anymore. Review all
1729 * uses of IEEE80211_MODE_MAX and add a new #define name for array size.
1731 uint32_t flags[2 * IEEE80211_MODE_MAX];
1733 getflags_5ghz(bands, flags, cbw_flags);
1734 KASSERT(flags[0] != 0, ("%s: no correct mode provided\n", __func__));
1736 return (add_chanlist(chans, maxchans, nchans, ieee, nieee, flags));
1740 * Locate a channel given a frequency+flags. We cache
1741 * the previous lookup to optimize switching between two
1742 * channels--as happens with dynamic turbo.
1744 struct ieee80211_channel *
1745 ieee80211_find_channel(struct ieee80211com *ic, int freq, int flags)
1747 struct ieee80211_channel *c;
1749 flags &= IEEE80211_CHAN_ALLTURBO;
1750 c = ic->ic_prevchan;
1751 if (c != NULL && c->ic_freq == freq &&
1752 (c->ic_flags & IEEE80211_CHAN_ALLTURBO) == flags)
1754 /* brute force search */
1755 return (findchannel(ic->ic_channels, ic->ic_nchans, freq, flags));
1759 * Locate a channel given a channel number+flags. We cache
1760 * the previous lookup to optimize switching between two
1761 * channels--as happens with dynamic turbo.
1763 struct ieee80211_channel *
1764 ieee80211_find_channel_byieee(struct ieee80211com *ic, int ieee, int flags)
1766 struct ieee80211_channel *c;
1769 flags &= IEEE80211_CHAN_ALLTURBO;
1770 c = ic->ic_prevchan;
1771 if (c != NULL && c->ic_ieee == ieee &&
1772 (c->ic_flags & IEEE80211_CHAN_ALLTURBO) == flags)
1774 /* brute force search */
1775 for (i = 0; i < ic->ic_nchans; i++) {
1776 c = &ic->ic_channels[i];
1777 if (c->ic_ieee == ieee &&
1778 (c->ic_flags & IEEE80211_CHAN_ALLTURBO) == flags)
1785 * Lookup a channel suitable for the given rx status.
1787 * This is used to find a channel for a frame (eg beacon, probe
1788 * response) based purely on the received PHY information.
1790 * For now it tries to do it based on R_FREQ / R_IEEE.
1791 * This is enough for 11bg and 11a (and thus 11ng/11na)
1792 * but it will not be enough for GSM, PSB channels and the
1793 * like. It also doesn't know about legacy-turbog and
1794 * legacy-turbo modes, which some offload NICs actually
1795 * support in weird ways.
1797 * Takes the ic and rxstatus; returns the channel or NULL
1800 * XXX TODO: Add support for that when the need arises.
1802 struct ieee80211_channel *
1803 ieee80211_lookup_channel_rxstatus(struct ieee80211vap *vap,
1804 const struct ieee80211_rx_stats *rxs)
1806 struct ieee80211com *ic = vap->iv_ic;
1808 struct ieee80211_channel *c;
1814 * Strictly speaking we only use freq for now,
1815 * however later on we may wish to just store
1816 * the ieee for verification.
1818 if ((rxs->r_flags & IEEE80211_R_FREQ) == 0)
1820 if ((rxs->r_flags & IEEE80211_R_IEEE) == 0)
1822 if ((rxs->r_flags & IEEE80211_R_BAND) == 0)
1826 * If the rx status contains a valid ieee/freq, then
1827 * ensure we populate the correct channel information
1828 * in rxchan before passing it up to the scan infrastructure.
1829 * Offload NICs will pass up beacons from all channels
1830 * during background scans.
1833 /* Determine a band */
1834 switch (rxs->c_band) {
1835 case IEEE80211_CHAN_2GHZ:
1836 flags = IEEE80211_CHAN_G;
1838 case IEEE80211_CHAN_5GHZ:
1839 flags = IEEE80211_CHAN_A;
1842 if (rxs->c_freq < 3000) {
1843 flags = IEEE80211_CHAN_G;
1845 flags = IEEE80211_CHAN_A;
1850 /* Channel lookup */
1851 c = ieee80211_find_channel(ic, rxs->c_freq, flags);
1853 IEEE80211_DPRINTF(vap, IEEE80211_MSG_INPUT,
1854 "%s: freq=%d, ieee=%d, flags=0x%08x; c=%p\n",
1855 __func__, (int) rxs->c_freq, (int) rxs->c_ieee, flags, c);
1861 addmedia(struct ifmedia *media, int caps, int addsta, int mode, int mword)
1863 #define ADD(_ic, _s, _o) \
1864 ifmedia_add(media, \
1865 IFM_MAKEWORD(IFM_IEEE80211, (_s), (_o), 0), 0, NULL)
1866 static const u_int mopts[IEEE80211_MODE_MAX] = {
1867 [IEEE80211_MODE_AUTO] = IFM_AUTO,
1868 [IEEE80211_MODE_11A] = IFM_IEEE80211_11A,
1869 [IEEE80211_MODE_11B] = IFM_IEEE80211_11B,
1870 [IEEE80211_MODE_11G] = IFM_IEEE80211_11G,
1871 [IEEE80211_MODE_FH] = IFM_IEEE80211_FH,
1872 [IEEE80211_MODE_TURBO_A] = IFM_IEEE80211_11A|IFM_IEEE80211_TURBO,
1873 [IEEE80211_MODE_TURBO_G] = IFM_IEEE80211_11G|IFM_IEEE80211_TURBO,
1874 [IEEE80211_MODE_STURBO_A] = IFM_IEEE80211_11A|IFM_IEEE80211_TURBO,
1875 [IEEE80211_MODE_HALF] = IFM_IEEE80211_11A, /* XXX */
1876 [IEEE80211_MODE_QUARTER] = IFM_IEEE80211_11A, /* XXX */
1877 [IEEE80211_MODE_11NA] = IFM_IEEE80211_11NA,
1878 [IEEE80211_MODE_11NG] = IFM_IEEE80211_11NG,
1879 [IEEE80211_MODE_VHT_2GHZ] = IFM_IEEE80211_VHT2G,
1880 [IEEE80211_MODE_VHT_5GHZ] = IFM_IEEE80211_VHT5G,
1886 ADD(ic, mword, mopt); /* STA mode has no cap */
1887 if (caps & IEEE80211_C_IBSS)
1888 ADD(media, mword, mopt | IFM_IEEE80211_ADHOC);
1889 if (caps & IEEE80211_C_HOSTAP)
1890 ADD(media, mword, mopt | IFM_IEEE80211_HOSTAP);
1891 if (caps & IEEE80211_C_AHDEMO)
1892 ADD(media, mword, mopt | IFM_IEEE80211_ADHOC | IFM_FLAG0);
1893 if (caps & IEEE80211_C_MONITOR)
1894 ADD(media, mword, mopt | IFM_IEEE80211_MONITOR);
1895 if (caps & IEEE80211_C_WDS)
1896 ADD(media, mword, mopt | IFM_IEEE80211_WDS);
1897 if (caps & IEEE80211_C_MBSS)
1898 ADD(media, mword, mopt | IFM_IEEE80211_MBSS);
1903 * Setup the media data structures according to the channel and
1907 ieee80211_media_setup(struct ieee80211com *ic,
1908 struct ifmedia *media, int caps, int addsta,
1909 ifm_change_cb_t media_change, ifm_stat_cb_t media_stat)
1911 int i, j, rate, maxrate, mword, r;
1912 enum ieee80211_phymode mode;
1913 const struct ieee80211_rateset *rs;
1914 struct ieee80211_rateset allrates;
1917 * Fill in media characteristics.
1919 ifmedia_init(media, 0, media_change, media_stat);
1922 * Add media for legacy operating modes.
1924 memset(&allrates, 0, sizeof(allrates));
1925 for (mode = IEEE80211_MODE_AUTO; mode < IEEE80211_MODE_11NA; mode++) {
1926 if (isclr(ic->ic_modecaps, mode))
1928 addmedia(media, caps, addsta, mode, IFM_AUTO);
1929 if (mode == IEEE80211_MODE_AUTO)
1931 rs = &ic->ic_sup_rates[mode];
1932 for (i = 0; i < rs->rs_nrates; i++) {
1933 rate = rs->rs_rates[i];
1934 mword = ieee80211_rate2media(ic, rate, mode);
1937 addmedia(media, caps, addsta, mode, mword);
1939 * Add legacy rate to the collection of all rates.
1941 r = rate & IEEE80211_RATE_VAL;
1942 for (j = 0; j < allrates.rs_nrates; j++)
1943 if (allrates.rs_rates[j] == r)
1945 if (j == allrates.rs_nrates) {
1946 /* unique, add to the set */
1947 allrates.rs_rates[j] = r;
1948 allrates.rs_nrates++;
1950 rate = (rate & IEEE80211_RATE_VAL) / 2;
1955 for (i = 0; i < allrates.rs_nrates; i++) {
1956 mword = ieee80211_rate2media(ic, allrates.rs_rates[i],
1957 IEEE80211_MODE_AUTO);
1960 /* NB: remove media options from mword */
1961 addmedia(media, caps, addsta,
1962 IEEE80211_MODE_AUTO, IFM_SUBTYPE(mword));
1965 * Add HT/11n media. Note that we do not have enough
1966 * bits in the media subtype to express the MCS so we
1967 * use a "placeholder" media subtype and any fixed MCS
1968 * must be specified with a different mechanism.
1970 for (; mode <= IEEE80211_MODE_11NG; mode++) {
1971 if (isclr(ic->ic_modecaps, mode))
1973 addmedia(media, caps, addsta, mode, IFM_AUTO);
1974 addmedia(media, caps, addsta, mode, IFM_IEEE80211_MCS);
1976 if (isset(ic->ic_modecaps, IEEE80211_MODE_11NA) ||
1977 isset(ic->ic_modecaps, IEEE80211_MODE_11NG)) {
1978 addmedia(media, caps, addsta,
1979 IEEE80211_MODE_AUTO, IFM_IEEE80211_MCS);
1980 i = ic->ic_txstream * 8 - 1;
1981 if ((ic->ic_htcaps & IEEE80211_HTCAP_CHWIDTH40) &&
1982 (ic->ic_htcaps & IEEE80211_HTCAP_SHORTGI40))
1983 rate = ieee80211_htrates[i].ht40_rate_400ns;
1984 else if ((ic->ic_htcaps & IEEE80211_HTCAP_CHWIDTH40))
1985 rate = ieee80211_htrates[i].ht40_rate_800ns;
1986 else if ((ic->ic_htcaps & IEEE80211_HTCAP_SHORTGI20))
1987 rate = ieee80211_htrates[i].ht20_rate_400ns;
1989 rate = ieee80211_htrates[i].ht20_rate_800ns;
1996 * XXX-BZ skip "VHT_2GHZ" for now.
1998 for (mode = IEEE80211_MODE_VHT_5GHZ; mode <= IEEE80211_MODE_VHT_5GHZ;
2000 if (isclr(ic->ic_modecaps, mode))
2002 addmedia(media, caps, addsta, mode, IFM_AUTO);
2003 addmedia(media, caps, addsta, mode, IFM_IEEE80211_VHT);
2005 if (isset(ic->ic_modecaps, IEEE80211_MODE_VHT_5GHZ)) {
2006 addmedia(media, caps, addsta,
2007 IEEE80211_MODE_AUTO, IFM_IEEE80211_VHT);
2009 /* XXX TODO: VHT maxrate */
2015 /* XXX inline or eliminate? */
2016 const struct ieee80211_rateset *
2017 ieee80211_get_suprates(struct ieee80211com *ic, const struct ieee80211_channel *c)
2019 /* XXX does this work for 11ng basic rates? */
2020 return &ic->ic_sup_rates[ieee80211_chan2mode(c)];
2023 /* XXX inline or eliminate? */
2024 const struct ieee80211_htrateset *
2025 ieee80211_get_suphtrates(struct ieee80211com *ic,
2026 const struct ieee80211_channel *c)
2028 return &ic->ic_sup_htrates;
2032 ieee80211_announce(struct ieee80211com *ic)
2035 enum ieee80211_phymode mode;
2036 const struct ieee80211_rateset *rs;
2038 /* NB: skip AUTO since it has no rates */
2039 for (mode = IEEE80211_MODE_AUTO+1; mode < IEEE80211_MODE_11NA; mode++) {
2040 if (isclr(ic->ic_modecaps, mode))
2042 ic_printf(ic, "%s rates: ", ieee80211_phymode_name[mode]);
2043 rs = &ic->ic_sup_rates[mode];
2044 for (i = 0; i < rs->rs_nrates; i++) {
2045 mword = ieee80211_rate2media(ic, rs->rs_rates[i], mode);
2048 rate = ieee80211_media2rate(mword);
2049 printf("%s%d%sMbps", (i != 0 ? " " : ""),
2050 rate / 2, ((rate & 0x1) != 0 ? ".5" : ""));
2054 ieee80211_ht_announce(ic);
2055 ieee80211_vht_announce(ic);
2059 ieee80211_announce_channels(struct ieee80211com *ic)
2061 const struct ieee80211_channel *c;
2065 printf("Chan Freq CW RegPwr MinPwr MaxPwr\n");
2066 for (i = 0; i < ic->ic_nchans; i++) {
2067 c = &ic->ic_channels[i];
2068 if (IEEE80211_IS_CHAN_ST(c))
2070 else if (IEEE80211_IS_CHAN_108A(c))
2072 else if (IEEE80211_IS_CHAN_108G(c))
2074 else if (IEEE80211_IS_CHAN_HT(c))
2076 else if (IEEE80211_IS_CHAN_A(c))
2078 else if (IEEE80211_IS_CHAN_ANYG(c))
2080 else if (IEEE80211_IS_CHAN_B(c))
2084 if (IEEE80211_IS_CHAN_HT40(c) || IEEE80211_IS_CHAN_TURBO(c))
2086 else if (IEEE80211_IS_CHAN_HALF(c))
2088 else if (IEEE80211_IS_CHAN_QUARTER(c))
2092 printf("%4d %4d%c %2d%c %6d %4d.%d %4d.%d\n"
2093 , c->ic_ieee, c->ic_freq, type
2095 , IEEE80211_IS_CHAN_HT40U(c) ? '+' :
2096 IEEE80211_IS_CHAN_HT40D(c) ? '-' : ' '
2098 , c->ic_minpower / 2, c->ic_minpower & 1 ? 5 : 0
2099 , c->ic_maxpower / 2, c->ic_maxpower & 1 ? 5 : 0
2105 media2mode(const struct ifmedia_entry *ime, uint32_t flags, uint16_t *mode)
2107 switch (IFM_MODE(ime->ifm_media)) {
2108 case IFM_IEEE80211_11A:
2109 *mode = IEEE80211_MODE_11A;
2111 case IFM_IEEE80211_11B:
2112 *mode = IEEE80211_MODE_11B;
2114 case IFM_IEEE80211_11G:
2115 *mode = IEEE80211_MODE_11G;
2117 case IFM_IEEE80211_FH:
2118 *mode = IEEE80211_MODE_FH;
2120 case IFM_IEEE80211_11NA:
2121 *mode = IEEE80211_MODE_11NA;
2123 case IFM_IEEE80211_11NG:
2124 *mode = IEEE80211_MODE_11NG;
2126 case IFM_IEEE80211_VHT2G:
2127 *mode = IEEE80211_MODE_VHT_2GHZ;
2129 case IFM_IEEE80211_VHT5G:
2130 *mode = IEEE80211_MODE_VHT_5GHZ;
2133 *mode = IEEE80211_MODE_AUTO;
2139 * Turbo mode is an ``option''.
2140 * XXX does not apply to AUTO
2142 if (ime->ifm_media & IFM_IEEE80211_TURBO) {
2143 if (*mode == IEEE80211_MODE_11A) {
2144 if (flags & IEEE80211_F_TURBOP)
2145 *mode = IEEE80211_MODE_TURBO_A;
2147 *mode = IEEE80211_MODE_STURBO_A;
2148 } else if (*mode == IEEE80211_MODE_11G)
2149 *mode = IEEE80211_MODE_TURBO_G;
2158 * Handle a media change request on the vap interface.
2161 ieee80211_media_change(struct ifnet *ifp)
2163 struct ieee80211vap *vap = ifp->if_softc;
2164 struct ifmedia_entry *ime = vap->iv_media.ifm_cur;
2167 if (!media2mode(ime, vap->iv_flags, &newmode))
2169 if (vap->iv_des_mode != newmode) {
2170 vap->iv_des_mode = newmode;
2171 /* XXX kick state machine if up+running */
2177 * Common code to calculate the media status word
2178 * from the operating mode and channel state.
2181 media_status(enum ieee80211_opmode opmode, const struct ieee80211_channel *chan)
2185 status = IFM_IEEE80211;
2187 case IEEE80211_M_STA:
2189 case IEEE80211_M_IBSS:
2190 status |= IFM_IEEE80211_ADHOC;
2192 case IEEE80211_M_HOSTAP:
2193 status |= IFM_IEEE80211_HOSTAP;
2195 case IEEE80211_M_MONITOR:
2196 status |= IFM_IEEE80211_MONITOR;
2198 case IEEE80211_M_AHDEMO:
2199 status |= IFM_IEEE80211_ADHOC | IFM_FLAG0;
2201 case IEEE80211_M_WDS:
2202 status |= IFM_IEEE80211_WDS;
2204 case IEEE80211_M_MBSS:
2205 status |= IFM_IEEE80211_MBSS;
2208 if (IEEE80211_IS_CHAN_VHT_5GHZ(chan)) {
2209 status |= IFM_IEEE80211_VHT5G;
2210 } else if (IEEE80211_IS_CHAN_VHT_2GHZ(chan)) {
2211 status |= IFM_IEEE80211_VHT2G;
2212 } else if (IEEE80211_IS_CHAN_HTA(chan)) {
2213 status |= IFM_IEEE80211_11NA;
2214 } else if (IEEE80211_IS_CHAN_HTG(chan)) {
2215 status |= IFM_IEEE80211_11NG;
2216 } else if (IEEE80211_IS_CHAN_A(chan)) {
2217 status |= IFM_IEEE80211_11A;
2218 } else if (IEEE80211_IS_CHAN_B(chan)) {
2219 status |= IFM_IEEE80211_11B;
2220 } else if (IEEE80211_IS_CHAN_ANYG(chan)) {
2221 status |= IFM_IEEE80211_11G;
2222 } else if (IEEE80211_IS_CHAN_FHSS(chan)) {
2223 status |= IFM_IEEE80211_FH;
2225 /* XXX else complain? */
2227 if (IEEE80211_IS_CHAN_TURBO(chan))
2228 status |= IFM_IEEE80211_TURBO;
2230 if (IEEE80211_IS_CHAN_HT20(chan))
2231 status |= IFM_IEEE80211_HT20;
2232 if (IEEE80211_IS_CHAN_HT40(chan))
2233 status |= IFM_IEEE80211_HT40;
2239 ieee80211_media_status(struct ifnet *ifp, struct ifmediareq *imr)
2241 struct ieee80211vap *vap = ifp->if_softc;
2242 struct ieee80211com *ic = vap->iv_ic;
2243 enum ieee80211_phymode mode;
2245 imr->ifm_status = IFM_AVALID;
2247 * NB: use the current channel's mode to lock down a xmit
2248 * rate only when running; otherwise we may have a mismatch
2249 * in which case the rate will not be convertible.
2251 if (vap->iv_state == IEEE80211_S_RUN ||
2252 vap->iv_state == IEEE80211_S_SLEEP) {
2253 imr->ifm_status |= IFM_ACTIVE;
2254 mode = ieee80211_chan2mode(ic->ic_curchan);
2256 mode = IEEE80211_MODE_AUTO;
2257 imr->ifm_active = media_status(vap->iv_opmode, ic->ic_curchan);
2259 * Calculate a current rate if possible.
2261 if (vap->iv_txparms[mode].ucastrate != IEEE80211_FIXED_RATE_NONE) {
2263 * A fixed rate is set, report that.
2265 imr->ifm_active |= ieee80211_rate2media(ic,
2266 vap->iv_txparms[mode].ucastrate, mode);
2267 } else if (vap->iv_opmode == IEEE80211_M_STA) {
2269 * In station mode report the current transmit rate.
2271 imr->ifm_active |= ieee80211_rate2media(ic,
2272 vap->iv_bss->ni_txrate, mode);
2274 imr->ifm_active |= IFM_AUTO;
2275 if (imr->ifm_status & IFM_ACTIVE)
2276 imr->ifm_current = imr->ifm_active;
2280 * Set the current phy mode and recalculate the active channel
2281 * set based on the available channels for this mode. Also
2282 * select a new default/current channel if the current one is
2283 * inappropriate for this mode.
2286 ieee80211_setmode(struct ieee80211com *ic, enum ieee80211_phymode mode)
2289 * Adjust basic rates in 11b/11g supported rate set.
2290 * Note that if operating on a hal/quarter rate channel
2291 * this is a noop as those rates sets are different
2294 if (mode == IEEE80211_MODE_11G || mode == IEEE80211_MODE_11B)
2295 ieee80211_setbasicrates(&ic->ic_sup_rates[mode], mode);
2297 ic->ic_curmode = mode;
2298 ieee80211_reset_erp(ic); /* reset global ERP state */
2304 * Return the phy mode for with the specified channel.
2306 enum ieee80211_phymode
2307 ieee80211_chan2mode(const struct ieee80211_channel *chan)
2310 if (IEEE80211_IS_CHAN_VHT_2GHZ(chan))
2311 return IEEE80211_MODE_VHT_2GHZ;
2312 else if (IEEE80211_IS_CHAN_VHT_5GHZ(chan))
2313 return IEEE80211_MODE_VHT_5GHZ;
2314 else if (IEEE80211_IS_CHAN_HTA(chan))
2315 return IEEE80211_MODE_11NA;
2316 else if (IEEE80211_IS_CHAN_HTG(chan))
2317 return IEEE80211_MODE_11NG;
2318 else if (IEEE80211_IS_CHAN_108G(chan))
2319 return IEEE80211_MODE_TURBO_G;
2320 else if (IEEE80211_IS_CHAN_ST(chan))
2321 return IEEE80211_MODE_STURBO_A;
2322 else if (IEEE80211_IS_CHAN_TURBO(chan))
2323 return IEEE80211_MODE_TURBO_A;
2324 else if (IEEE80211_IS_CHAN_HALF(chan))
2325 return IEEE80211_MODE_HALF;
2326 else if (IEEE80211_IS_CHAN_QUARTER(chan))
2327 return IEEE80211_MODE_QUARTER;
2328 else if (IEEE80211_IS_CHAN_A(chan))
2329 return IEEE80211_MODE_11A;
2330 else if (IEEE80211_IS_CHAN_ANYG(chan))
2331 return IEEE80211_MODE_11G;
2332 else if (IEEE80211_IS_CHAN_B(chan))
2333 return IEEE80211_MODE_11B;
2334 else if (IEEE80211_IS_CHAN_FHSS(chan))
2335 return IEEE80211_MODE_FH;
2337 /* NB: should not get here */
2338 printf("%s: cannot map channel to mode; freq %u flags 0x%x\n",
2339 __func__, chan->ic_freq, chan->ic_flags);
2340 return IEEE80211_MODE_11B;
2344 u_int match; /* rate + mode */
2345 u_int media; /* if_media rate */
2349 findmedia(const struct ratemedia rates[], int n, u_int match)
2353 for (i = 0; i < n; i++)
2354 if (rates[i].match == match)
2355 return rates[i].media;
2360 * Convert IEEE80211 rate value to ifmedia subtype.
2361 * Rate is either a legacy rate in units of 0.5Mbps
2365 ieee80211_rate2media(struct ieee80211com *ic, int rate, enum ieee80211_phymode mode)
2367 static const struct ratemedia rates[] = {
2368 { 2 | IFM_IEEE80211_FH, IFM_IEEE80211_FH1 },
2369 { 4 | IFM_IEEE80211_FH, IFM_IEEE80211_FH2 },
2370 { 2 | IFM_IEEE80211_11B, IFM_IEEE80211_DS1 },
2371 { 4 | IFM_IEEE80211_11B, IFM_IEEE80211_DS2 },
2372 { 11 | IFM_IEEE80211_11B, IFM_IEEE80211_DS5 },
2373 { 22 | IFM_IEEE80211_11B, IFM_IEEE80211_DS11 },
2374 { 44 | IFM_IEEE80211_11B, IFM_IEEE80211_DS22 },
2375 { 12 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM6 },
2376 { 18 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM9 },
2377 { 24 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM12 },
2378 { 36 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM18 },
2379 { 48 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM24 },
2380 { 72 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM36 },
2381 { 96 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM48 },
2382 { 108 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM54 },
2383 { 2 | IFM_IEEE80211_11G, IFM_IEEE80211_DS1 },
2384 { 4 | IFM_IEEE80211_11G, IFM_IEEE80211_DS2 },
2385 { 11 | IFM_IEEE80211_11G, IFM_IEEE80211_DS5 },
2386 { 22 | IFM_IEEE80211_11G, IFM_IEEE80211_DS11 },
2387 { 12 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM6 },
2388 { 18 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM9 },
2389 { 24 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM12 },
2390 { 36 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM18 },
2391 { 48 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM24 },
2392 { 72 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM36 },
2393 { 96 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM48 },
2394 { 108 | IFM_IEEE80211_11G, IFM_IEEE80211_OFDM54 },
2395 { 6 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM3 },
2396 { 9 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM4 },
2397 { 54 | IFM_IEEE80211_11A, IFM_IEEE80211_OFDM27 },
2398 /* NB: OFDM72 doesn't really exist so we don't handle it */
2400 static const struct ratemedia htrates[] = {
2401 { 0, IFM_IEEE80211_MCS },
2402 { 1, IFM_IEEE80211_MCS },
2403 { 2, IFM_IEEE80211_MCS },
2404 { 3, IFM_IEEE80211_MCS },
2405 { 4, IFM_IEEE80211_MCS },
2406 { 5, IFM_IEEE80211_MCS },
2407 { 6, IFM_IEEE80211_MCS },
2408 { 7, IFM_IEEE80211_MCS },
2409 { 8, IFM_IEEE80211_MCS },
2410 { 9, IFM_IEEE80211_MCS },
2411 { 10, IFM_IEEE80211_MCS },
2412 { 11, IFM_IEEE80211_MCS },
2413 { 12, IFM_IEEE80211_MCS },
2414 { 13, IFM_IEEE80211_MCS },
2415 { 14, IFM_IEEE80211_MCS },
2416 { 15, IFM_IEEE80211_MCS },
2417 { 16, IFM_IEEE80211_MCS },
2418 { 17, IFM_IEEE80211_MCS },
2419 { 18, IFM_IEEE80211_MCS },
2420 { 19, IFM_IEEE80211_MCS },
2421 { 20, IFM_IEEE80211_MCS },
2422 { 21, IFM_IEEE80211_MCS },
2423 { 22, IFM_IEEE80211_MCS },
2424 { 23, IFM_IEEE80211_MCS },
2425 { 24, IFM_IEEE80211_MCS },
2426 { 25, IFM_IEEE80211_MCS },
2427 { 26, IFM_IEEE80211_MCS },
2428 { 27, IFM_IEEE80211_MCS },
2429 { 28, IFM_IEEE80211_MCS },
2430 { 29, IFM_IEEE80211_MCS },
2431 { 30, IFM_IEEE80211_MCS },
2432 { 31, IFM_IEEE80211_MCS },
2433 { 32, IFM_IEEE80211_MCS },
2434 { 33, IFM_IEEE80211_MCS },
2435 { 34, IFM_IEEE80211_MCS },
2436 { 35, IFM_IEEE80211_MCS },
2437 { 36, IFM_IEEE80211_MCS },
2438 { 37, IFM_IEEE80211_MCS },
2439 { 38, IFM_IEEE80211_MCS },
2440 { 39, IFM_IEEE80211_MCS },
2441 { 40, IFM_IEEE80211_MCS },
2442 { 41, IFM_IEEE80211_MCS },
2443 { 42, IFM_IEEE80211_MCS },
2444 { 43, IFM_IEEE80211_MCS },
2445 { 44, IFM_IEEE80211_MCS },
2446 { 45, IFM_IEEE80211_MCS },
2447 { 46, IFM_IEEE80211_MCS },
2448 { 47, IFM_IEEE80211_MCS },
2449 { 48, IFM_IEEE80211_MCS },
2450 { 49, IFM_IEEE80211_MCS },
2451 { 50, IFM_IEEE80211_MCS },
2452 { 51, IFM_IEEE80211_MCS },
2453 { 52, IFM_IEEE80211_MCS },
2454 { 53, IFM_IEEE80211_MCS },
2455 { 54, IFM_IEEE80211_MCS },
2456 { 55, IFM_IEEE80211_MCS },
2457 { 56, IFM_IEEE80211_MCS },
2458 { 57, IFM_IEEE80211_MCS },
2459 { 58, IFM_IEEE80211_MCS },
2460 { 59, IFM_IEEE80211_MCS },
2461 { 60, IFM_IEEE80211_MCS },
2462 { 61, IFM_IEEE80211_MCS },
2463 { 62, IFM_IEEE80211_MCS },
2464 { 63, IFM_IEEE80211_MCS },
2465 { 64, IFM_IEEE80211_MCS },
2466 { 65, IFM_IEEE80211_MCS },
2467 { 66, IFM_IEEE80211_MCS },
2468 { 67, IFM_IEEE80211_MCS },
2469 { 68, IFM_IEEE80211_MCS },
2470 { 69, IFM_IEEE80211_MCS },
2471 { 70, IFM_IEEE80211_MCS },
2472 { 71, IFM_IEEE80211_MCS },
2473 { 72, IFM_IEEE80211_MCS },
2474 { 73, IFM_IEEE80211_MCS },
2475 { 74, IFM_IEEE80211_MCS },
2476 { 75, IFM_IEEE80211_MCS },
2477 { 76, IFM_IEEE80211_MCS },
2479 static const struct ratemedia vhtrates[] = {
2480 { 0, IFM_IEEE80211_VHT },
2481 { 1, IFM_IEEE80211_VHT },
2482 { 2, IFM_IEEE80211_VHT },
2483 { 3, IFM_IEEE80211_VHT },
2484 { 4, IFM_IEEE80211_VHT },
2485 { 5, IFM_IEEE80211_VHT },
2486 { 6, IFM_IEEE80211_VHT },
2487 { 7, IFM_IEEE80211_VHT },
2488 { 8, IFM_IEEE80211_VHT }, /* Optional. */
2489 { 9, IFM_IEEE80211_VHT }, /* Optional. */
2491 /* Some QCA and BRCM seem to support this; offspec. */
2492 { 10, IFM_IEEE80211_VHT },
2493 { 11, IFM_IEEE80211_VHT },
2499 * Check 11ac/11n rates first for match as an MCS.
2501 if (mode == IEEE80211_MODE_VHT_5GHZ) {
2502 if (rate & IFM_IEEE80211_VHT) {
2503 rate &= ~IFM_IEEE80211_VHT;
2504 m = findmedia(vhtrates, nitems(vhtrates), rate);
2506 return (m | IFM_IEEE80211_VHT);
2508 } else if (mode == IEEE80211_MODE_11NA) {
2509 if (rate & IEEE80211_RATE_MCS) {
2510 rate &= ~IEEE80211_RATE_MCS;
2511 m = findmedia(htrates, nitems(htrates), rate);
2513 return m | IFM_IEEE80211_11NA;
2515 } else if (mode == IEEE80211_MODE_11NG) {
2516 /* NB: 12 is ambiguous, it will be treated as an MCS */
2517 if (rate & IEEE80211_RATE_MCS) {
2518 rate &= ~IEEE80211_RATE_MCS;
2519 m = findmedia(htrates, nitems(htrates), rate);
2521 return m | IFM_IEEE80211_11NG;
2524 rate &= IEEE80211_RATE_VAL;
2526 case IEEE80211_MODE_11A:
2527 case IEEE80211_MODE_HALF: /* XXX good 'nuf */
2528 case IEEE80211_MODE_QUARTER:
2529 case IEEE80211_MODE_11NA:
2530 case IEEE80211_MODE_TURBO_A:
2531 case IEEE80211_MODE_STURBO_A:
2532 return findmedia(rates, nitems(rates),
2533 rate | IFM_IEEE80211_11A);
2534 case IEEE80211_MODE_11B:
2535 return findmedia(rates, nitems(rates),
2536 rate | IFM_IEEE80211_11B);
2537 case IEEE80211_MODE_FH:
2538 return findmedia(rates, nitems(rates),
2539 rate | IFM_IEEE80211_FH);
2540 case IEEE80211_MODE_AUTO:
2541 /* NB: ic may be NULL for some drivers */
2542 if (ic != NULL && ic->ic_phytype == IEEE80211_T_FH)
2543 return findmedia(rates, nitems(rates),
2544 rate | IFM_IEEE80211_FH);
2545 /* NB: hack, 11g matches both 11b+11a rates */
2547 case IEEE80211_MODE_11G:
2548 case IEEE80211_MODE_11NG:
2549 case IEEE80211_MODE_TURBO_G:
2550 return findmedia(rates, nitems(rates), rate | IFM_IEEE80211_11G);
2551 case IEEE80211_MODE_VHT_2GHZ:
2552 case IEEE80211_MODE_VHT_5GHZ:
2553 /* XXX TODO: need to figure out mapping for VHT rates */
2560 ieee80211_media2rate(int mword)
2562 static const int ieeerates[] = {
2566 2, /* IFM_IEEE80211_FH1 */
2567 4, /* IFM_IEEE80211_FH2 */
2568 2, /* IFM_IEEE80211_DS1 */
2569 4, /* IFM_IEEE80211_DS2 */
2570 11, /* IFM_IEEE80211_DS5 */
2571 22, /* IFM_IEEE80211_DS11 */
2572 44, /* IFM_IEEE80211_DS22 */
2573 12, /* IFM_IEEE80211_OFDM6 */
2574 18, /* IFM_IEEE80211_OFDM9 */
2575 24, /* IFM_IEEE80211_OFDM12 */
2576 36, /* IFM_IEEE80211_OFDM18 */
2577 48, /* IFM_IEEE80211_OFDM24 */
2578 72, /* IFM_IEEE80211_OFDM36 */
2579 96, /* IFM_IEEE80211_OFDM48 */
2580 108, /* IFM_IEEE80211_OFDM54 */
2581 144, /* IFM_IEEE80211_OFDM72 */
2582 0, /* IFM_IEEE80211_DS354k */
2583 0, /* IFM_IEEE80211_DS512k */
2584 6, /* IFM_IEEE80211_OFDM3 */
2585 9, /* IFM_IEEE80211_OFDM4 */
2586 54, /* IFM_IEEE80211_OFDM27 */
2587 -1, /* IFM_IEEE80211_MCS */
2588 -1, /* IFM_IEEE80211_VHT */
2590 return IFM_SUBTYPE(mword) < nitems(ieeerates) ?
2591 ieeerates[IFM_SUBTYPE(mword)] : 0;
2595 * The following hash function is adapted from "Hash Functions" by Bob Jenkins
2596 * ("Algorithm Alley", Dr. Dobbs Journal, September 1997).
2598 #define mix(a, b, c) \
2600 a -= b; a -= c; a ^= (c >> 13); \
2601 b -= c; b -= a; b ^= (a << 8); \
2602 c -= a; c -= b; c ^= (b >> 13); \
2603 a -= b; a -= c; a ^= (c >> 12); \
2604 b -= c; b -= a; b ^= (a << 16); \
2605 c -= a; c -= b; c ^= (b >> 5); \
2606 a -= b; a -= c; a ^= (c >> 3); \
2607 b -= c; b -= a; b ^= (a << 10); \
2608 c -= a; c -= b; c ^= (b >> 15); \
2609 } while (/*CONSTCOND*/0)
2612 ieee80211_mac_hash(const struct ieee80211com *ic,
2613 const uint8_t addr[IEEE80211_ADDR_LEN])
2615 uint32_t a = 0x9e3779b9, b = 0x9e3779b9, c = ic->ic_hash_key;
2631 ieee80211_channel_type_char(const struct ieee80211_channel *c)
2633 if (IEEE80211_IS_CHAN_ST(c))
2635 if (IEEE80211_IS_CHAN_108A(c))
2637 if (IEEE80211_IS_CHAN_108G(c))
2639 if (IEEE80211_IS_CHAN_VHT(c))
2641 if (IEEE80211_IS_CHAN_HT(c))
2643 if (IEEE80211_IS_CHAN_A(c))
2645 if (IEEE80211_IS_CHAN_ANYG(c))
2647 if (IEEE80211_IS_CHAN_B(c))