2 * Copyright (c) 2001 Atsushi Onoe
3 * Copyright (c) 2002-2008 Sam Leffler, Errno Consulting
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
16 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
17 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
18 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
19 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
20 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
21 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
22 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
24 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
31 * IEEE 802.11 protocol support.
37 #include <sys/param.h>
38 #include <sys/kernel.h>
39 #include <sys/systm.h>
40 #include <sys/taskqueue.h>
42 #include <sys/socket.h>
43 #include <sys/sockio.h>
46 #include <net/if_media.h>
47 #include <net/ethernet.h> /* XXX for ether_sprintf */
49 #include <net80211/ieee80211_var.h>
50 #include <net80211/ieee80211_adhoc.h>
51 #include <net80211/ieee80211_sta.h>
52 #include <net80211/ieee80211_hostap.h>
53 #include <net80211/ieee80211_wds.h>
54 #include <net80211/ieee80211_monitor.h>
55 #include <net80211/ieee80211_input.h>
58 #define AGGRESSIVE_MODE_SWITCH_HYSTERESIS 3 /* pkts / 100ms */
59 #define HIGH_PRI_SWITCH_THRESH 10 /* pkts / 100ms */
61 const char *ieee80211_mgt_subtype_name[] = {
62 "assoc_req", "assoc_resp", "reassoc_req", "reassoc_resp",
63 "probe_req", "probe_resp", "reserved#6", "reserved#7",
64 "beacon", "atim", "disassoc", "auth",
65 "deauth", "action", "reserved#14", "reserved#15"
67 const char *ieee80211_ctl_subtype_name[] = {
68 "reserved#0", "reserved#1", "reserved#2", "reserved#3",
69 "reserved#3", "reserved#5", "reserved#6", "reserved#7",
70 "reserved#8", "reserved#9", "ps_poll", "rts",
71 "cts", "ack", "cf_end", "cf_end_ack"
73 const char *ieee80211_opmode_name[IEEE80211_OPMODE_MAX] = {
74 "IBSS", /* IEEE80211_M_IBSS */
75 "STA", /* IEEE80211_M_STA */
76 "WDS", /* IEEE80211_M_WDS */
77 "AHDEMO", /* IEEE80211_M_AHDEMO */
78 "HOSTAP", /* IEEE80211_M_HOSTAP */
79 "MONITOR" /* IEEE80211_M_MONITOR */
81 const char *ieee80211_state_name[IEEE80211_S_MAX] = {
82 "INIT", /* IEEE80211_S_INIT */
83 "SCAN", /* IEEE80211_S_SCAN */
84 "AUTH", /* IEEE80211_S_AUTH */
85 "ASSOC", /* IEEE80211_S_ASSOC */
86 "CAC", /* IEEE80211_S_CAC */
87 "RUN", /* IEEE80211_S_RUN */
88 "CSA", /* IEEE80211_S_CSA */
89 "SLEEP", /* IEEE80211_S_SLEEP */
91 const char *ieee80211_wme_acnames[] = {
99 static void parent_updown(void *, int);
100 static int ieee80211_new_state_locked(struct ieee80211vap *,
101 enum ieee80211_state, int);
104 null_raw_xmit(struct ieee80211_node *ni, struct mbuf *m,
105 const struct ieee80211_bpf_params *params)
107 struct ifnet *ifp = ni->ni_ic->ic_ifp;
109 if_printf(ifp, "missing ic_raw_xmit callback, drop frame\n");
115 ieee80211_proto_attach(struct ieee80211com *ic)
117 struct ifnet *ifp = ic->ic_ifp;
119 /* override the 802.3 setting */
120 ifp->if_hdrlen = ic->ic_headroom
121 + sizeof(struct ieee80211_qosframe_addr4)
122 + IEEE80211_WEP_IVLEN + IEEE80211_WEP_KIDLEN
123 + IEEE80211_WEP_EXTIVLEN;
124 /* XXX no way to recalculate on ifdetach */
125 if (ALIGN(ifp->if_hdrlen) > max_linkhdr) {
126 /* XXX sanity check... */
127 max_linkhdr = ALIGN(ifp->if_hdrlen);
128 max_hdr = max_linkhdr + max_protohdr;
129 max_datalen = MHLEN - max_hdr;
131 ic->ic_protmode = IEEE80211_PROT_CTSONLY;
133 TASK_INIT(&ic->ic_parent_task, 0, parent_updown, ifp);
135 ic->ic_wme.wme_hipri_switch_hysteresis =
136 AGGRESSIVE_MODE_SWITCH_HYSTERESIS;
138 /* initialize management frame handlers */
139 ic->ic_send_mgmt = ieee80211_send_mgmt;
140 ic->ic_raw_xmit = null_raw_xmit;
142 ieee80211_adhoc_attach(ic);
143 ieee80211_sta_attach(ic);
144 ieee80211_wds_attach(ic);
145 ieee80211_hostap_attach(ic);
146 ieee80211_monitor_attach(ic);
150 ieee80211_proto_detach(struct ieee80211com *ic)
152 ieee80211_monitor_detach(ic);
153 ieee80211_hostap_detach(ic);
154 ieee80211_wds_detach(ic);
155 ieee80211_adhoc_detach(ic);
156 ieee80211_sta_detach(ic);
160 null_update_beacon(struct ieee80211vap *vap, int item)
165 ieee80211_proto_vattach(struct ieee80211vap *vap)
167 struct ieee80211com *ic = vap->iv_ic;
168 struct ifnet *ifp = vap->iv_ifp;
171 /* override the 802.3 setting */
172 ifp->if_hdrlen = ic->ic_ifp->if_hdrlen;
174 vap->iv_rtsthreshold = IEEE80211_RTS_DEFAULT;
175 vap->iv_fragthreshold = IEEE80211_FRAG_DEFAULT;
176 vap->iv_bmiss_max = IEEE80211_BMISS_MAX;
177 callout_init(&vap->iv_swbmiss, CALLOUT_MPSAFE);
178 callout_init(&vap->iv_mgtsend, CALLOUT_MPSAFE);
180 * Install default tx rate handling: no fixed rate, lowest
181 * supported rate for mgmt and multicast frames. Default
182 * max retry count. These settings can be changed by the
183 * driver and/or user applications.
185 for (i = IEEE80211_MODE_11A; i < IEEE80211_MODE_11NA; i++) {
186 const struct ieee80211_rateset *rs = &ic->ic_sup_rates[i];
188 vap->iv_txparms[i].ucastrate = IEEE80211_FIXED_RATE_NONE;
189 /* NB: we default to min supported rate for channel */
190 vap->iv_txparms[i].mgmtrate =
191 rs->rs_rates[0] & IEEE80211_RATE_VAL;
192 vap->iv_txparms[i].mcastrate =
193 rs->rs_rates[0] & IEEE80211_RATE_VAL;
194 vap->iv_txparms[i].maxretry = IEEE80211_TXMAX_DEFAULT;
196 for (; i < IEEE80211_MODE_MAX; i++) {
197 vap->iv_txparms[i].ucastrate = IEEE80211_FIXED_RATE_NONE;
198 /* NB: default to MCS 0 */
199 vap->iv_txparms[i].mgmtrate = 0 | 0x80;
200 vap->iv_txparms[i].mcastrate = 0 | 0x80;
201 vap->iv_txparms[i].maxretry = IEEE80211_TXMAX_DEFAULT;
203 vap->iv_roaming = IEEE80211_ROAMING_AUTO;
205 vap->iv_update_beacon = null_update_beacon;
206 vap->iv_deliver_data = ieee80211_deliver_data;
208 /* attach support for operating mode */
209 ic->ic_vattach[vap->iv_opmode](vap);
213 ieee80211_proto_vdetach(struct ieee80211vap *vap)
215 #define FREEAPPIE(ie) do { \
217 FREE(ie, M_80211_NODE_IE); \
220 * Detach operating mode module.
222 if (vap->iv_opdetach != NULL)
223 vap->iv_opdetach(vap);
225 * This should not be needed as we detach when reseting
226 * the state but be conservative here since the
227 * authenticator may do things like spawn kernel threads.
229 if (vap->iv_auth->ia_detach != NULL)
230 vap->iv_auth->ia_detach(vap);
232 * Detach any ACL'ator.
234 if (vap->iv_acl != NULL)
235 vap->iv_acl->iac_detach(vap);
237 FREEAPPIE(vap->iv_appie_beacon);
238 FREEAPPIE(vap->iv_appie_probereq);
239 FREEAPPIE(vap->iv_appie_proberesp);
240 FREEAPPIE(vap->iv_appie_assocreq);
241 FREEAPPIE(vap->iv_appie_assocresp);
242 FREEAPPIE(vap->iv_appie_wpa);
247 * Simple-minded authenticator module support.
250 #define IEEE80211_AUTH_MAX (IEEE80211_AUTH_WPA+1)
251 /* XXX well-known names */
252 static const char *auth_modnames[IEEE80211_AUTH_MAX] = {
253 "wlan_internal", /* IEEE80211_AUTH_NONE */
254 "wlan_internal", /* IEEE80211_AUTH_OPEN */
255 "wlan_internal", /* IEEE80211_AUTH_SHARED */
256 "wlan_xauth", /* IEEE80211_AUTH_8021X */
257 "wlan_internal", /* IEEE80211_AUTH_AUTO */
258 "wlan_xauth", /* IEEE80211_AUTH_WPA */
260 static const struct ieee80211_authenticator *authenticators[IEEE80211_AUTH_MAX];
262 static const struct ieee80211_authenticator auth_internal = {
263 .ia_name = "wlan_internal",
266 .ia_node_join = NULL,
267 .ia_node_leave = NULL,
271 * Setup internal authenticators once; they are never unregistered.
274 ieee80211_auth_setup(void)
276 ieee80211_authenticator_register(IEEE80211_AUTH_OPEN, &auth_internal);
277 ieee80211_authenticator_register(IEEE80211_AUTH_SHARED, &auth_internal);
278 ieee80211_authenticator_register(IEEE80211_AUTH_AUTO, &auth_internal);
280 SYSINIT(wlan_auth, SI_SUB_DRIVERS, SI_ORDER_FIRST, ieee80211_auth_setup, NULL);
282 const struct ieee80211_authenticator *
283 ieee80211_authenticator_get(int auth)
285 if (auth >= IEEE80211_AUTH_MAX)
287 if (authenticators[auth] == NULL)
288 ieee80211_load_module(auth_modnames[auth]);
289 return authenticators[auth];
293 ieee80211_authenticator_register(int type,
294 const struct ieee80211_authenticator *auth)
296 if (type >= IEEE80211_AUTH_MAX)
298 authenticators[type] = auth;
302 ieee80211_authenticator_unregister(int type)
305 if (type >= IEEE80211_AUTH_MAX)
307 authenticators[type] = NULL;
311 * Very simple-minded ACL module support.
313 /* XXX just one for now */
314 static const struct ieee80211_aclator *acl = NULL;
317 ieee80211_aclator_register(const struct ieee80211_aclator *iac)
319 printf("wlan: %s acl policy registered\n", iac->iac_name);
324 ieee80211_aclator_unregister(const struct ieee80211_aclator *iac)
328 printf("wlan: %s acl policy unregistered\n", iac->iac_name);
331 const struct ieee80211_aclator *
332 ieee80211_aclator_get(const char *name)
335 ieee80211_load_module("wlan_acl");
336 return acl != NULL && strcmp(acl->iac_name, name) == 0 ? acl : NULL;
340 ieee80211_print_essid(const uint8_t *essid, int len)
345 if (len > IEEE80211_NWID_LEN)
346 len = IEEE80211_NWID_LEN;
347 /* determine printable or not */
348 for (i = 0, p = essid; i < len; i++, p++) {
349 if (*p < ' ' || *p > 0x7e)
354 for (i = 0, p = essid; i < len; i++, p++)
359 for (i = 0, p = essid; i < len; i++, p++)
365 ieee80211_dump_pkt(struct ieee80211com *ic,
366 const uint8_t *buf, int len, int rate, int rssi)
368 const struct ieee80211_frame *wh;
371 wh = (const struct ieee80211_frame *)buf;
372 switch (wh->i_fc[1] & IEEE80211_FC1_DIR_MASK) {
373 case IEEE80211_FC1_DIR_NODS:
374 printf("NODS %s", ether_sprintf(wh->i_addr2));
375 printf("->%s", ether_sprintf(wh->i_addr1));
376 printf("(%s)", ether_sprintf(wh->i_addr3));
378 case IEEE80211_FC1_DIR_TODS:
379 printf("TODS %s", ether_sprintf(wh->i_addr2));
380 printf("->%s", ether_sprintf(wh->i_addr3));
381 printf("(%s)", ether_sprintf(wh->i_addr1));
383 case IEEE80211_FC1_DIR_FROMDS:
384 printf("FRDS %s", ether_sprintf(wh->i_addr3));
385 printf("->%s", ether_sprintf(wh->i_addr1));
386 printf("(%s)", ether_sprintf(wh->i_addr2));
388 case IEEE80211_FC1_DIR_DSTODS:
389 printf("DSDS %s", ether_sprintf((const uint8_t *)&wh[1]));
390 printf("->%s", ether_sprintf(wh->i_addr3));
391 printf("(%s", ether_sprintf(wh->i_addr2));
392 printf("->%s)", ether_sprintf(wh->i_addr1));
395 switch (wh->i_fc[0] & IEEE80211_FC0_TYPE_MASK) {
396 case IEEE80211_FC0_TYPE_DATA:
399 case IEEE80211_FC0_TYPE_MGT:
400 printf(" %s", ieee80211_mgt_subtype_name[
401 (wh->i_fc[0] & IEEE80211_FC0_SUBTYPE_MASK)
402 >> IEEE80211_FC0_SUBTYPE_SHIFT]);
405 printf(" type#%d", wh->i_fc[0] & IEEE80211_FC0_TYPE_MASK);
408 if (IEEE80211_QOS_HAS_SEQ(wh)) {
409 const struct ieee80211_qosframe *qwh =
410 (const struct ieee80211_qosframe *)buf;
411 printf(" QoS [TID %u%s]", qwh->i_qos[0] & IEEE80211_QOS_TID,
412 qwh->i_qos[0] & IEEE80211_QOS_ACKPOLICY ? " ACM" : "");
414 if (wh->i_fc[1] & IEEE80211_FC1_WEP) {
417 off = ieee80211_anyhdrspace(ic, wh);
418 printf(" WEP [IV %.02x %.02x %.02x",
419 buf[off+0], buf[off+1], buf[off+2]);
420 if (buf[off+IEEE80211_WEP_IVLEN] & IEEE80211_WEP_EXTIV)
421 printf(" %.02x %.02x %.02x",
422 buf[off+4], buf[off+5], buf[off+6]);
423 printf(" KID %u]", buf[off+IEEE80211_WEP_IVLEN] >> 6);
426 printf(" %dM", rate / 2);
428 printf(" +%d", rssi);
431 for (i = 0; i < len; i++) {
434 printf("%02x", buf[i]);
441 findrix(const struct ieee80211_rateset *rs, int r)
445 for (i = 0; i < rs->rs_nrates; i++)
446 if ((rs->rs_rates[i] & IEEE80211_RATE_VAL) == r)
452 ieee80211_fix_rate(struct ieee80211_node *ni,
453 struct ieee80211_rateset *nrs, int flags)
455 #define RV(v) ((v) & IEEE80211_RATE_VAL)
456 struct ieee80211vap *vap = ni->ni_vap;
457 struct ieee80211com *ic = ni->ni_ic;
458 int i, j, rix, error;
459 int okrate, badrate, fixedrate, ucastrate;
460 const struct ieee80211_rateset *srs;
464 okrate = badrate = 0;
465 ucastrate = vap->iv_txparms[ieee80211_chan2mode(ni->ni_chan)].ucastrate;
466 if (ucastrate != IEEE80211_FIXED_RATE_NONE) {
468 * Workaround awkwardness with fixed rate. We are called
469 * to check both the legacy rate set and the HT rate set
470 * but we must apply any legacy fixed rate check only to the
471 * legacy rate set and vice versa. We cannot tell what type
472 * of rate set we've been given (legacy or HT) but we can
473 * distinguish the fixed rate type (MCS have 0x80 set).
474 * So to deal with this the caller communicates whether to
475 * check MCS or legacy rate using the flags and we use the
476 * type of any fixed rate to avoid applying an MCS to a
477 * legacy rate and vice versa.
479 if (ucastrate & 0x80) {
480 if (flags & IEEE80211_F_DOFRATE)
481 flags &= ~IEEE80211_F_DOFRATE;
482 } else if ((ucastrate & 0x80) == 0) {
483 if (flags & IEEE80211_F_DOFMCS)
484 flags &= ~IEEE80211_F_DOFMCS;
486 /* NB: required to make MCS match below work */
487 ucastrate &= IEEE80211_RATE_VAL;
489 fixedrate = IEEE80211_FIXED_RATE_NONE;
491 * XXX we are called to process both MCS and legacy rates;
492 * we must use the appropriate basic rate set or chaos will
493 * ensue; for now callers that want MCS must supply
494 * IEEE80211_F_DOBRS; at some point we'll need to split this
495 * function so there are two variants, one for MCS and one
498 if (flags & IEEE80211_F_DOBRS)
499 srs = (const struct ieee80211_rateset *)
500 ieee80211_get_suphtrates(ic, ni->ni_chan);
502 srs = ieee80211_get_suprates(ic, ni->ni_chan);
503 for (i = 0; i < nrs->rs_nrates; ) {
504 if (flags & IEEE80211_F_DOSORT) {
508 for (j = i + 1; j < nrs->rs_nrates; j++) {
509 if (RV(nrs->rs_rates[i]) > RV(nrs->rs_rates[j])) {
510 r = nrs->rs_rates[i];
511 nrs->rs_rates[i] = nrs->rs_rates[j];
512 nrs->rs_rates[j] = r;
516 r = nrs->rs_rates[i] & IEEE80211_RATE_VAL;
519 * Check for fixed rate.
524 * Check against supported rates.
526 rix = findrix(srs, r);
527 if (flags & IEEE80211_F_DONEGO) {
530 * A rate in the node's rate set is not
531 * supported. If this is a basic rate and we
532 * are operating as a STA then this is an error.
533 * Otherwise we just discard/ignore the rate.
535 if ((flags & IEEE80211_F_JOIN) &&
536 (nrs->rs_rates[i] & IEEE80211_RATE_BASIC))
538 } else if ((flags & IEEE80211_F_JOIN) == 0) {
540 * Overwrite with the supported rate
541 * value so any basic rate bit is set.
543 nrs->rs_rates[i] = srs->rs_rates[rix];
546 if ((flags & IEEE80211_F_DODEL) && rix < 0) {
548 * Delete unacceptable rates.
551 for (j = i; j < nrs->rs_nrates; j++)
552 nrs->rs_rates[j] = nrs->rs_rates[j + 1];
553 nrs->rs_rates[j] = 0;
557 okrate = nrs->rs_rates[i];
560 if (okrate == 0 || error != 0 ||
561 ((flags & (IEEE80211_F_DOFRATE|IEEE80211_F_DOFMCS)) &&
562 fixedrate != ucastrate)) {
563 IEEE80211_NOTE(vap, IEEE80211_MSG_XRATE | IEEE80211_MSG_11N, ni,
564 "%s: flags 0x%x okrate %d error %d fixedrate 0x%x "
565 "ucastrate %x\n", __func__, fixedrate, ucastrate, flags);
566 return badrate | IEEE80211_RATE_BASIC;
573 * Reset 11g-related state.
576 ieee80211_reset_erp(struct ieee80211com *ic)
578 ic->ic_flags &= ~IEEE80211_F_USEPROT;
579 ic->ic_nonerpsta = 0;
580 ic->ic_longslotsta = 0;
582 * Short slot time is enabled only when operating in 11g
583 * and not in an IBSS. We must also honor whether or not
584 * the driver is capable of doing it.
586 ieee80211_set_shortslottime(ic,
587 IEEE80211_IS_CHAN_A(ic->ic_curchan) ||
588 IEEE80211_IS_CHAN_HT(ic->ic_curchan) ||
589 (IEEE80211_IS_CHAN_ANYG(ic->ic_curchan) &&
590 ic->ic_opmode == IEEE80211_M_HOSTAP &&
591 (ic->ic_caps & IEEE80211_C_SHSLOT)));
593 * Set short preamble and ERP barker-preamble flags.
595 if (IEEE80211_IS_CHAN_A(ic->ic_curchan) ||
596 (ic->ic_caps & IEEE80211_C_SHPREAMBLE)) {
597 ic->ic_flags |= IEEE80211_F_SHPREAMBLE;
598 ic->ic_flags &= ~IEEE80211_F_USEBARKER;
600 ic->ic_flags &= ~IEEE80211_F_SHPREAMBLE;
601 ic->ic_flags |= IEEE80211_F_USEBARKER;
606 * Set the short slot time state and notify the driver.
609 ieee80211_set_shortslottime(struct ieee80211com *ic, int onoff)
612 ic->ic_flags |= IEEE80211_F_SHSLOT;
614 ic->ic_flags &= ~IEEE80211_F_SHSLOT;
616 if (ic->ic_updateslot != NULL)
617 ic->ic_updateslot(ic->ic_ifp);
621 * Check if the specified rate set supports ERP.
622 * NB: the rate set is assumed to be sorted.
625 ieee80211_iserp_rateset(const struct ieee80211_rateset *rs)
627 #define N(a) (sizeof(a) / sizeof(a[0]))
628 static const int rates[] = { 2, 4, 11, 22, 12, 24, 48 };
631 if (rs->rs_nrates < N(rates))
633 for (i = 0; i < N(rates); i++) {
634 for (j = 0; j < rs->rs_nrates; j++) {
635 int r = rs->rs_rates[j] & IEEE80211_RATE_VAL;
650 * Mark the basic rates for the rate table based on the
651 * operating mode. For real 11g we mark all the 11b rates
652 * and 6, 12, and 24 OFDM. For 11b compatibility we mark only
653 * 11b rates. There's also a pseudo 11a-mode used to mark only
654 * the basic OFDM rates.
657 setbasicrates(struct ieee80211_rateset *rs,
658 enum ieee80211_phymode mode, int add)
660 static const struct ieee80211_rateset basic[IEEE80211_MODE_MAX] = {
661 { .rs_nrates = 0 }, /* IEEE80211_MODE_AUTO */
662 { 3, { 12, 24, 48 } }, /* IEEE80211_MODE_11A */
663 { 2, { 2, 4 } }, /* IEEE80211_MODE_11B */
664 { 4, { 2, 4, 11, 22 } }, /* IEEE80211_MODE_11G (mixed b/g) */
665 { .rs_nrates = 0 }, /* IEEE80211_MODE_FH */
666 { 3, { 12, 24, 48 } }, /* IEEE80211_MODE_TURBO_A */
667 { 4, { 2, 4, 11, 22 } }, /* IEEE80211_MODE_TURBO_G (mixed b/g) */
668 { 3, { 12, 24, 48 } }, /* IEEE80211_MODE_STURBO_A */
669 { 3, { 12, 24, 48 } }, /* IEEE80211_MODE_11NA */
670 { 4, { 2, 4, 11, 22 } }, /* IEEE80211_MODE_11NG (mixed b/g) */
674 for (i = 0; i < rs->rs_nrates; i++) {
676 rs->rs_rates[i] &= IEEE80211_RATE_VAL;
677 for (j = 0; j < basic[mode].rs_nrates; j++)
678 if (basic[mode].rs_rates[j] == rs->rs_rates[i]) {
679 rs->rs_rates[i] |= IEEE80211_RATE_BASIC;
686 * Set the basic rates in a rate set.
689 ieee80211_setbasicrates(struct ieee80211_rateset *rs,
690 enum ieee80211_phymode mode)
692 setbasicrates(rs, mode, 0);
696 * Add basic rates to a rate set.
699 ieee80211_addbasicrates(struct ieee80211_rateset *rs,
700 enum ieee80211_phymode mode)
702 setbasicrates(rs, mode, 1);
706 * WME protocol support.
708 * The default 11a/b/g/n parameters come from the WiFi Alliance WMM
709 * System Interopability Test Plan (v1.4, Appendix F) and the 802.11n
710 * Draft 2.0 Test Plan (Appendix D).
712 * Static/Dynamic Turbo mode settings come from Atheros.
714 typedef struct phyParamType {
722 static const struct phyParamType phyParamForAC_BE[IEEE80211_MODE_MAX] = {
723 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_AUTO */
724 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_11A */
725 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_11B */
726 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_11G */
727 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_FH */
728 { 2, 3, 5, 0, 0 }, /* IEEE80211_MODE_TURBO_A */
729 { 2, 3, 5, 0, 0 }, /* IEEE80211_MODE_TURBO_G */
730 { 2, 3, 5, 0, 0 }, /* IEEE80211_MODE_STURBO_A */
731 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_11NA */
732 { 3, 4, 6, 0, 0 }, /* IEEE80211_MODE_11NG */
734 static const struct phyParamType phyParamForAC_BK[IEEE80211_MODE_MAX] = {
735 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_AUTO */
736 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_11A */
737 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_11B */
738 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_11G */
739 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_FH */
740 { 7, 3, 10, 0, 0 }, /* IEEE80211_MODE_TURBO_A */
741 { 7, 3, 10, 0, 0 }, /* IEEE80211_MODE_TURBO_G */
742 { 7, 3, 10, 0, 0 }, /* IEEE80211_MODE_STURBO_A */
743 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_11NA */
744 { 7, 4, 10, 0, 0 }, /* IEEE80211_MODE_11NG */
746 static const struct phyParamType phyParamForAC_VI[IEEE80211_MODE_MAX] = {
747 { 1, 3, 4, 94, 0 }, /* IEEE80211_MODE_AUTO */
748 { 1, 3, 4, 94, 0 }, /* IEEE80211_MODE_11A */
749 { 1, 3, 4, 188, 0 }, /* IEEE80211_MODE_11B */
750 { 1, 3, 4, 94, 0 }, /* IEEE80211_MODE_11G */
751 { 1, 3, 4, 188, 0 }, /* IEEE80211_MODE_FH */
752 { 1, 2, 3, 94, 0 }, /* IEEE80211_MODE_TURBO_A */
753 { 1, 2, 3, 94, 0 }, /* IEEE80211_MODE_TURBO_G */
754 { 1, 2, 3, 94, 0 }, /* IEEE80211_MODE_STURBO_A */
755 { 1, 3, 4, 94, 0 }, /* IEEE80211_MODE_11NA */
756 { 1, 3, 4, 94, 0 }, /* IEEE80211_MODE_11NG */
758 static const struct phyParamType phyParamForAC_VO[IEEE80211_MODE_MAX] = {
759 { 1, 2, 3, 47, 0 }, /* IEEE80211_MODE_AUTO */
760 { 1, 2, 3, 47, 0 }, /* IEEE80211_MODE_11A */
761 { 1, 2, 3, 102, 0 }, /* IEEE80211_MODE_11B */
762 { 1, 2, 3, 47, 0 }, /* IEEE80211_MODE_11G */
763 { 1, 2, 3, 102, 0 }, /* IEEE80211_MODE_FH */
764 { 1, 2, 2, 47, 0 }, /* IEEE80211_MODE_TURBO_A */
765 { 1, 2, 2, 47, 0 }, /* IEEE80211_MODE_TURBO_G */
766 { 1, 2, 2, 47, 0 }, /* IEEE80211_MODE_STURBO_A */
767 { 1, 2, 3, 47, 0 }, /* IEEE80211_MODE_11NA */
768 { 1, 2, 3, 47, 0 }, /* IEEE80211_MODE_11NG */
771 static const struct phyParamType bssPhyParamForAC_BE[IEEE80211_MODE_MAX] = {
772 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_AUTO */
773 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_11A */
774 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_11B */
775 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_11G */
776 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_FH */
777 { 2, 3, 10, 0, 0 }, /* IEEE80211_MODE_TURBO_A */
778 { 2, 3, 10, 0, 0 }, /* IEEE80211_MODE_TURBO_G */
779 { 2, 3, 10, 0, 0 }, /* IEEE80211_MODE_STURBO_A */
780 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_11NA */
781 { 3, 4, 10, 0, 0 }, /* IEEE80211_MODE_11NG */
783 static const struct phyParamType bssPhyParamForAC_VI[IEEE80211_MODE_MAX] = {
784 { 2, 3, 4, 94, 0 }, /* IEEE80211_MODE_AUTO */
785 { 2, 3, 4, 94, 0 }, /* IEEE80211_MODE_11A */
786 { 2, 3, 4, 188, 0 }, /* IEEE80211_MODE_11B */
787 { 2, 3, 4, 94, 0 }, /* IEEE80211_MODE_11G */
788 { 2, 3, 4, 188, 0 }, /* IEEE80211_MODE_FH */
789 { 2, 2, 3, 94, 0 }, /* IEEE80211_MODE_TURBO_A */
790 { 2, 2, 3, 94, 0 }, /* IEEE80211_MODE_TURBO_G */
791 { 2, 2, 3, 94, 0 }, /* IEEE80211_MODE_STURBO_A */
792 { 2, 3, 4, 94, 0 }, /* IEEE80211_MODE_11NA */
793 { 2, 3, 4, 94, 0 }, /* IEEE80211_MODE_11NG */
795 static const struct phyParamType bssPhyParamForAC_VO[IEEE80211_MODE_MAX] = {
796 { 2, 2, 3, 47, 0 }, /* IEEE80211_MODE_AUTO */
797 { 2, 2, 3, 47, 0 }, /* IEEE80211_MODE_11A */
798 { 2, 2, 3, 102, 0 }, /* IEEE80211_MODE_11B */
799 { 2, 2, 3, 47, 0 }, /* IEEE80211_MODE_11G */
800 { 2, 2, 3, 102, 0 }, /* IEEE80211_MODE_FH */
801 { 1, 2, 2, 47, 0 }, /* IEEE80211_MODE_TURBO_A */
802 { 1, 2, 2, 47, 0 }, /* IEEE80211_MODE_TURBO_G */
803 { 1, 2, 2, 47, 0 }, /* IEEE80211_MODE_STURBO_A */
804 { 2, 2, 3, 47, 0 }, /* IEEE80211_MODE_11NA */
805 { 2, 2, 3, 47, 0 }, /* IEEE80211_MODE_11NG */
809 ieee80211_wme_initparams_locked(struct ieee80211vap *vap)
811 struct ieee80211com *ic = vap->iv_ic;
812 struct ieee80211_wme_state *wme = &ic->ic_wme;
813 const paramType *pPhyParam, *pBssPhyParam;
814 struct wmeParams *wmep;
815 enum ieee80211_phymode mode;
818 IEEE80211_LOCK_ASSERT(ic);
820 if ((ic->ic_caps & IEEE80211_C_WME) == 0)
824 * Select mode; we can be called early in which case we
825 * always use auto mode. We know we'll be called when
826 * entering the RUN state with bsschan setup properly
827 * so state will eventually get set correctly
829 if (ic->ic_bsschan != IEEE80211_CHAN_ANYC)
830 mode = ieee80211_chan2mode(ic->ic_bsschan);
832 mode = IEEE80211_MODE_AUTO;
833 for (i = 0; i < WME_NUM_AC; i++) {
836 pPhyParam = &phyParamForAC_BK[mode];
837 pBssPhyParam = &phyParamForAC_BK[mode];
840 pPhyParam = &phyParamForAC_VI[mode];
841 pBssPhyParam = &bssPhyParamForAC_VI[mode];
844 pPhyParam = &phyParamForAC_VO[mode];
845 pBssPhyParam = &bssPhyParamForAC_VO[mode];
849 pPhyParam = &phyParamForAC_BE[mode];
850 pBssPhyParam = &bssPhyParamForAC_BE[mode];
854 wmep = &wme->wme_wmeChanParams.cap_wmeParams[i];
855 if (ic->ic_opmode == IEEE80211_M_HOSTAP) {
856 wmep->wmep_acm = pPhyParam->acm;
857 wmep->wmep_aifsn = pPhyParam->aifsn;
858 wmep->wmep_logcwmin = pPhyParam->logcwmin;
859 wmep->wmep_logcwmax = pPhyParam->logcwmax;
860 wmep->wmep_txopLimit = pPhyParam->txopLimit;
862 wmep->wmep_acm = pBssPhyParam->acm;
863 wmep->wmep_aifsn = pBssPhyParam->aifsn;
864 wmep->wmep_logcwmin = pBssPhyParam->logcwmin;
865 wmep->wmep_logcwmax = pBssPhyParam->logcwmax;
866 wmep->wmep_txopLimit = pBssPhyParam->txopLimit;
869 IEEE80211_DPRINTF(vap, IEEE80211_MSG_WME,
870 "%s: %s chan [acm %u aifsn %u log2(cwmin) %u "
871 "log2(cwmax) %u txpoLimit %u]\n", __func__
872 , ieee80211_wme_acnames[i]
875 , wmep->wmep_logcwmin
876 , wmep->wmep_logcwmax
877 , wmep->wmep_txopLimit
880 wmep = &wme->wme_wmeBssChanParams.cap_wmeParams[i];
881 wmep->wmep_acm = pBssPhyParam->acm;
882 wmep->wmep_aifsn = pBssPhyParam->aifsn;
883 wmep->wmep_logcwmin = pBssPhyParam->logcwmin;
884 wmep->wmep_logcwmax = pBssPhyParam->logcwmax;
885 wmep->wmep_txopLimit = pBssPhyParam->txopLimit;
886 IEEE80211_DPRINTF(vap, IEEE80211_MSG_WME,
887 "%s: %s bss [acm %u aifsn %u log2(cwmin) %u "
888 "log2(cwmax) %u txpoLimit %u]\n", __func__
889 , ieee80211_wme_acnames[i]
892 , wmep->wmep_logcwmin
893 , wmep->wmep_logcwmax
894 , wmep->wmep_txopLimit
897 /* NB: check ic_bss to avoid NULL deref on initial attach */
898 if (vap->iv_bss != NULL) {
900 * Calculate agressive mode switching threshold based
901 * on beacon interval. This doesn't need locking since
902 * we're only called before entering the RUN state at
903 * which point we start sending beacon frames.
905 wme->wme_hipri_switch_thresh =
906 (HIGH_PRI_SWITCH_THRESH * vap->iv_bss->ni_intval) / 100;
907 ieee80211_wme_updateparams(vap);
912 ieee80211_wme_initparams(struct ieee80211vap *vap)
914 struct ieee80211com *ic = vap->iv_ic;
917 ieee80211_wme_initparams_locked(vap);
918 IEEE80211_UNLOCK(ic);
922 * Update WME parameters for ourself and the BSS.
925 ieee80211_wme_updateparams_locked(struct ieee80211vap *vap)
927 static const paramType phyParam[IEEE80211_MODE_MAX] = {
928 { 2, 4, 10, 64, 0 }, /* IEEE80211_MODE_AUTO */
929 { 2, 4, 10, 64, 0 }, /* IEEE80211_MODE_11A */
930 { 2, 5, 10, 64, 0 }, /* IEEE80211_MODE_11B */
931 { 2, 4, 10, 64, 0 }, /* IEEE80211_MODE_11G */
932 { 2, 5, 10, 64, 0 }, /* IEEE80211_MODE_FH */
933 { 1, 3, 10, 64, 0 }, /* IEEE80211_MODE_TURBO_A */
934 { 1, 3, 10, 64, 0 }, /* IEEE80211_MODE_TURBO_G */
935 { 1, 3, 10, 64, 0 }, /* IEEE80211_MODE_STURBO_A */
936 { 2, 4, 10, 64, 0 }, /* IEEE80211_MODE_11NA */ /*XXXcheck*/
937 { 2, 4, 10, 64, 0 }, /* IEEE80211_MODE_11NG */ /*XXXcheck*/
939 struct ieee80211com *ic = vap->iv_ic;
940 struct ieee80211_wme_state *wme = &ic->ic_wme;
941 const struct wmeParams *wmep;
942 struct wmeParams *chanp, *bssp;
943 enum ieee80211_phymode mode;
946 /* set up the channel access parameters for the physical device */
947 for (i = 0; i < WME_NUM_AC; i++) {
948 chanp = &wme->wme_chanParams.cap_wmeParams[i];
949 wmep = &wme->wme_wmeChanParams.cap_wmeParams[i];
950 chanp->wmep_aifsn = wmep->wmep_aifsn;
951 chanp->wmep_logcwmin = wmep->wmep_logcwmin;
952 chanp->wmep_logcwmax = wmep->wmep_logcwmax;
953 chanp->wmep_txopLimit = wmep->wmep_txopLimit;
955 chanp = &wme->wme_bssChanParams.cap_wmeParams[i];
956 wmep = &wme->wme_wmeBssChanParams.cap_wmeParams[i];
957 chanp->wmep_aifsn = wmep->wmep_aifsn;
958 chanp->wmep_logcwmin = wmep->wmep_logcwmin;
959 chanp->wmep_logcwmax = wmep->wmep_logcwmax;
960 chanp->wmep_txopLimit = wmep->wmep_txopLimit;
964 * Select mode; we can be called early in which case we
965 * always use auto mode. We know we'll be called when
966 * entering the RUN state with bsschan setup properly
967 * so state will eventually get set correctly
969 if (ic->ic_bsschan != IEEE80211_CHAN_ANYC)
970 mode = ieee80211_chan2mode(ic->ic_bsschan);
972 mode = IEEE80211_MODE_AUTO;
975 * This implements agressive mode as found in certain
976 * vendors' AP's. When there is significant high
977 * priority (VI/VO) traffic in the BSS throttle back BE
978 * traffic by using conservative parameters. Otherwise
979 * BE uses agressive params to optimize performance of
980 * legacy/non-QoS traffic.
982 if ((vap->iv_opmode == IEEE80211_M_HOSTAP &&
983 (wme->wme_flags & WME_F_AGGRMODE) != 0) ||
984 (vap->iv_opmode == IEEE80211_M_STA &&
985 (vap->iv_bss->ni_flags & IEEE80211_NODE_QOS) == 0) ||
986 (vap->iv_flags & IEEE80211_F_WME) == 0) {
987 chanp = &wme->wme_chanParams.cap_wmeParams[WME_AC_BE];
988 bssp = &wme->wme_bssChanParams.cap_wmeParams[WME_AC_BE];
990 chanp->wmep_aifsn = bssp->wmep_aifsn = phyParam[mode].aifsn;
991 chanp->wmep_logcwmin = bssp->wmep_logcwmin =
992 phyParam[mode].logcwmin;
993 chanp->wmep_logcwmax = bssp->wmep_logcwmax =
994 phyParam[mode].logcwmax;
995 chanp->wmep_txopLimit = bssp->wmep_txopLimit =
996 (vap->iv_flags & IEEE80211_F_BURST) ?
997 phyParam[mode].txopLimit : 0;
998 IEEE80211_DPRINTF(vap, IEEE80211_MSG_WME,
999 "%s: %s [acm %u aifsn %u log2(cwmin) %u "
1000 "log2(cwmax) %u txpoLimit %u]\n", __func__
1001 , ieee80211_wme_acnames[WME_AC_BE]
1004 , chanp->wmep_logcwmin
1005 , chanp->wmep_logcwmax
1006 , chanp->wmep_txopLimit
1011 if (vap->iv_opmode == IEEE80211_M_HOSTAP &&
1012 ic->ic_sta_assoc < 2 && (wme->wme_flags & WME_F_AGGRMODE) != 0) {
1013 static const uint8_t logCwMin[IEEE80211_MODE_MAX] = {
1014 3, /* IEEE80211_MODE_AUTO */
1015 3, /* IEEE80211_MODE_11A */
1016 4, /* IEEE80211_MODE_11B */
1017 3, /* IEEE80211_MODE_11G */
1018 4, /* IEEE80211_MODE_FH */
1019 3, /* IEEE80211_MODE_TURBO_A */
1020 3, /* IEEE80211_MODE_TURBO_G */
1021 3, /* IEEE80211_MODE_STURBO_A */
1022 3, /* IEEE80211_MODE_11NA */
1023 3, /* IEEE80211_MODE_11NG */
1025 chanp = &wme->wme_chanParams.cap_wmeParams[WME_AC_BE];
1026 bssp = &wme->wme_bssChanParams.cap_wmeParams[WME_AC_BE];
1028 chanp->wmep_logcwmin = bssp->wmep_logcwmin = logCwMin[mode];
1029 IEEE80211_DPRINTF(vap, IEEE80211_MSG_WME,
1030 "%s: %s log2(cwmin) %u\n", __func__
1031 , ieee80211_wme_acnames[WME_AC_BE]
1032 , chanp->wmep_logcwmin
1035 if (vap->iv_opmode == IEEE80211_M_HOSTAP) { /* XXX ibss? */
1037 * Arrange for a beacon update and bump the parameter
1038 * set number so associated stations load the new values.
1040 wme->wme_bssChanParams.cap_info =
1041 (wme->wme_bssChanParams.cap_info+1) & WME_QOSINFO_COUNT;
1042 ieee80211_beacon_notify(vap, IEEE80211_BEACON_WME);
1045 wme->wme_update(ic);
1047 IEEE80211_DPRINTF(vap, IEEE80211_MSG_WME,
1048 "%s: WME params updated, cap_info 0x%x\n", __func__,
1049 vap->iv_opmode == IEEE80211_M_STA ?
1050 wme->wme_wmeChanParams.cap_info :
1051 wme->wme_bssChanParams.cap_info);
1055 ieee80211_wme_updateparams(struct ieee80211vap *vap)
1057 struct ieee80211com *ic = vap->iv_ic;
1059 if (ic->ic_caps & IEEE80211_C_WME) {
1061 ieee80211_wme_updateparams_locked(vap);
1062 IEEE80211_UNLOCK(ic);
1067 parent_updown(void *arg, int npending)
1069 struct ifnet *parent = arg;
1071 parent->if_ioctl(parent, SIOCSIFFLAGS, NULL);
1075 * Start a vap running. If this is the first vap to be
1076 * set running on the underlying device then we
1077 * automatically bring the device up.
1080 ieee80211_start_locked(struct ieee80211vap *vap)
1082 struct ifnet *ifp = vap->iv_ifp;
1083 struct ieee80211com *ic = vap->iv_ic;
1084 struct ifnet *parent = ic->ic_ifp;
1086 IEEE80211_LOCK_ASSERT(ic);
1088 IEEE80211_DPRINTF(vap,
1089 IEEE80211_MSG_STATE | IEEE80211_MSG_DEBUG,
1090 "start running, %d vaps running\n", ic->ic_nrunning);
1092 if ((ifp->if_drv_flags & IFF_DRV_RUNNING) == 0) {
1094 * Mark us running. Note that it's ok to do this first;
1095 * if we need to bring the parent device up we defer that
1096 * to avoid dropping the com lock. We expect the device
1097 * to respond to being marked up by calling back into us
1098 * through ieee80211_start_all at which point we'll come
1099 * back in here and complete the work.
1101 ifp->if_drv_flags |= IFF_DRV_RUNNING;
1103 * We are not running; if this we are the first vap
1104 * to be brought up auto-up the parent if necessary.
1106 if (ic->ic_nrunning++ == 0 &&
1107 (parent->if_drv_flags & IFF_DRV_RUNNING) == 0) {
1108 IEEE80211_DPRINTF(vap,
1109 IEEE80211_MSG_STATE | IEEE80211_MSG_DEBUG,
1110 "%s: up parent %s\n", __func__, parent->if_xname);
1111 parent->if_flags |= IFF_UP;
1112 taskqueue_enqueue(taskqueue_thread, &ic->ic_parent_task);
1117 * If the parent is up and running, then kick the
1118 * 802.11 state machine as appropriate.
1120 if ((parent->if_drv_flags & IFF_DRV_RUNNING) &&
1121 vap->iv_roaming != IEEE80211_ROAMING_MANUAL) {
1122 if (vap->iv_opmode == IEEE80211_M_STA) {
1124 /* XXX bypasses scan too easily; disable for now */
1126 * Try to be intelligent about clocking the state
1127 * machine. If we're currently in RUN state then
1128 * we should be able to apply any new state/parameters
1129 * simply by re-associating. Otherwise we need to
1130 * re-scan to select an appropriate ap.
1132 if (vap->iv_state >= IEEE80211_S_RUN)
1133 ieee80211_new_state_locked(vap,
1134 IEEE80211_S_ASSOC, 1);
1137 ieee80211_new_state_locked(vap,
1138 IEEE80211_S_SCAN, 0);
1141 * For monitor+wds mode there's nothing to do but
1142 * start running. Otherwise if this is the first
1143 * vap to be brought up, start a scan which may be
1144 * preempted if the station is locked to a particular
1148 ieee80211_new_state_locked(vap, IEEE80211_S_INIT, 0);
1149 if (vap->iv_opmode == IEEE80211_M_MONITOR ||
1150 vap->iv_opmode == IEEE80211_M_WDS)
1151 ieee80211_new_state_locked(vap,
1152 IEEE80211_S_RUN, -1);
1154 ieee80211_new_state_locked(vap,
1155 IEEE80211_S_SCAN, 0);
1161 * Start a single vap.
1164 ieee80211_init(void *arg)
1166 struct ieee80211vap *vap = arg;
1169 * This routine is publicly accessible through the vap's
1170 * if_init method so guard against calls during detach.
1171 * ieee80211_vap_detach null's the backpointer before
1172 * tearing down state to signal any callback should be
1176 IEEE80211_DPRINTF(vap,
1177 IEEE80211_MSG_STATE | IEEE80211_MSG_DEBUG,
1180 IEEE80211_LOCK(vap->iv_ic);
1181 ieee80211_start_locked(vap);
1182 IEEE80211_UNLOCK(vap->iv_ic);
1187 * Start all runnable vap's on a device.
1190 ieee80211_start_all(struct ieee80211com *ic)
1192 struct ieee80211vap *vap;
1195 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1196 struct ifnet *ifp = vap->iv_ifp;
1197 if (IFNET_IS_UP_RUNNING(ifp)) /* NB: avoid recursion */
1198 ieee80211_start_locked(vap);
1200 IEEE80211_UNLOCK(ic);
1204 * Stop a vap. We force it down using the state machine
1205 * then mark it's ifnet not running. If this is the last
1206 * vap running on the underlying device then we close it
1207 * too to insure it will be properly initialized when the
1208 * next vap is brought up.
1211 ieee80211_stop_locked(struct ieee80211vap *vap)
1213 struct ieee80211com *ic = vap->iv_ic;
1214 struct ifnet *ifp = vap->iv_ifp;
1215 struct ifnet *parent = ic->ic_ifp;
1217 IEEE80211_LOCK_ASSERT(ic);
1219 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE | IEEE80211_MSG_DEBUG,
1220 "stop running, %d vaps running\n", ic->ic_nrunning);
1222 ieee80211_new_state_locked(vap, IEEE80211_S_INIT, -1);
1223 if (ifp->if_drv_flags & IFF_DRV_RUNNING) {
1224 ifp->if_drv_flags &= ~IFF_DRV_RUNNING; /* mark us stopped */
1225 if (--ic->ic_nrunning == 0 &&
1226 (parent->if_drv_flags & IFF_DRV_RUNNING)) {
1227 IEEE80211_DPRINTF(vap,
1228 IEEE80211_MSG_STATE | IEEE80211_MSG_DEBUG,
1229 "down parent %s\n", parent->if_xname);
1230 parent->if_flags &= ~IFF_UP;
1231 taskqueue_enqueue(taskqueue_thread, &ic->ic_parent_task);
1237 ieee80211_stop(struct ieee80211vap *vap)
1239 struct ieee80211com *ic = vap->iv_ic;
1242 ieee80211_stop_locked(vap);
1243 IEEE80211_UNLOCK(ic);
1247 * Stop all vap's running on a device.
1250 ieee80211_stop_all(struct ieee80211com *ic)
1252 struct ieee80211vap *vap;
1255 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1256 struct ifnet *ifp = vap->iv_ifp;
1257 if (IFNET_IS_UP_RUNNING(ifp)) /* NB: avoid recursion */
1258 ieee80211_stop_locked(vap);
1260 IEEE80211_UNLOCK(ic);
1264 * Stop all vap's running on a device and arrange
1265 * for those that were running to be resumed.
1268 ieee80211_suspend_all(struct ieee80211com *ic)
1270 struct ieee80211vap *vap;
1273 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1274 struct ifnet *ifp = vap->iv_ifp;
1275 if (IFNET_IS_UP_RUNNING(ifp)) { /* NB: avoid recursion */
1276 vap->iv_flags_ext |= IEEE80211_FEXT_RESUME;
1277 ieee80211_stop_locked(vap);
1280 IEEE80211_UNLOCK(ic);
1284 * Start all vap's marked for resume.
1287 ieee80211_resume_all(struct ieee80211com *ic)
1289 struct ieee80211vap *vap;
1292 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1293 struct ifnet *ifp = vap->iv_ifp;
1294 if (!IFNET_IS_UP_RUNNING(ifp) &&
1295 (vap->iv_flags_ext & IEEE80211_FEXT_RESUME)) {
1296 vap->iv_flags_ext &= ~IEEE80211_FEXT_RESUME;
1297 ieee80211_start_locked(vap);
1300 IEEE80211_UNLOCK(ic);
1304 * Switch between turbo and non-turbo operating modes.
1305 * Use the specified channel flags to locate the new
1306 * channel, update 802.11 state, and then call back into
1307 * the driver to effect the change.
1310 ieee80211_dturbo_switch(struct ieee80211vap *vap, int newflags)
1312 struct ieee80211com *ic = vap->iv_ic;
1313 struct ieee80211_channel *chan;
1315 chan = ieee80211_find_channel(ic, ic->ic_bsschan->ic_freq, newflags);
1316 if (chan == NULL) { /* XXX should not happen */
1317 IEEE80211_DPRINTF(vap, IEEE80211_MSG_SUPERG,
1318 "%s: no channel with freq %u flags 0x%x\n",
1319 __func__, ic->ic_bsschan->ic_freq, newflags);
1323 IEEE80211_DPRINTF(vap, IEEE80211_MSG_SUPERG,
1324 "%s: %s -> %s (freq %u flags 0x%x)\n", __func__,
1325 ieee80211_phymode_name[ieee80211_chan2mode(ic->ic_bsschan)],
1326 ieee80211_phymode_name[ieee80211_chan2mode(chan)],
1327 chan->ic_freq, chan->ic_flags);
1329 ic->ic_bsschan = chan;
1330 ic->ic_prevchan = ic->ic_curchan;
1331 ic->ic_curchan = chan;
1332 ic->ic_set_channel(ic);
1333 /* NB: do not need to reset ERP state 'cuz we're in sta mode */
1337 ieee80211_beacon_miss(struct ieee80211com *ic)
1339 struct ieee80211vap *vap;
1341 if (ic->ic_flags & IEEE80211_F_SCAN)
1344 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1346 * We only pass events through for sta vap's in RUN state;
1347 * may be too restrictive but for now this saves all the
1348 * handlers duplicating these checks.
1350 if (vap->iv_opmode == IEEE80211_M_STA &&
1351 vap->iv_state == IEEE80211_S_RUN &&
1352 vap->iv_bmiss != NULL)
1358 * Software beacon miss handling. Check if any beacons
1359 * were received in the last period. If not post a
1360 * beacon miss; otherwise reset the counter.
1363 ieee80211_swbmiss(void *arg)
1365 struct ieee80211vap *vap = arg;
1366 struct ieee80211com *ic = vap->iv_ic;
1368 /* XXX sleep state? */
1369 KASSERT(vap->iv_state == IEEE80211_S_RUN,
1370 ("wrong state %d", vap->iv_state));
1372 if (ic->ic_flags & IEEE80211_F_SCAN) {
1374 * If scanning just ignore and reset state. If we get a
1375 * bmiss after coming out of scan because we haven't had
1376 * time to receive a beacon then we should probe the AP
1377 * before posting a real bmiss (unless iv_bmiss_max has
1378 * been artifiically lowered). A cleaner solution might
1379 * be to disable the timer on scan start/end but to handle
1380 * case of multiple sta vap's we'd need to disable the
1381 * timers of all affected vap's.
1383 vap->iv_swbmiss_count = 0;
1384 } else if (vap->iv_swbmiss_count == 0) {
1385 if (vap->iv_bmiss != NULL)
1387 if (vap->iv_bmiss_count == 0) /* don't re-arm timer */
1390 vap->iv_swbmiss_count = 0;
1391 callout_reset(&vap->iv_swbmiss, vap->iv_swbmiss_period,
1392 ieee80211_swbmiss, vap);
1396 * Start an 802.11h channel switch. We record the parameters,
1397 * mark the operation pending, notify each vap through the
1398 * beacon update mechanism so it can update the beacon frame
1399 * contents, and then switch vap's to CSA state to block outbound
1400 * traffic. Devices that handle CSA directly can use the state
1401 * switch to do the right thing so long as they call
1402 * ieee80211_csa_completeswitch when it's time to complete the
1403 * channel change. Devices that depend on the net80211 layer can
1404 * use ieee80211_beacon_update to handle the countdown and the
1408 ieee80211_csa_startswitch(struct ieee80211com *ic,
1409 struct ieee80211_channel *c, int mode, int count)
1411 struct ieee80211vap *vap;
1413 IEEE80211_LOCK_ASSERT(ic);
1415 ic->ic_csa_newchan = c;
1416 ic->ic_csa_count = count;
1417 /* XXX record mode? */
1418 ic->ic_flags |= IEEE80211_F_CSAPENDING;
1419 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1420 if (vap->iv_opmode == IEEE80211_M_HOSTAP ||
1421 vap->iv_opmode == IEEE80211_M_IBSS)
1422 ieee80211_beacon_notify(vap, IEEE80211_BEACON_CSA);
1423 /* switch to CSA state to block outbound traffic */
1424 if (vap->iv_state == IEEE80211_S_RUN)
1425 ieee80211_new_state_locked(vap, IEEE80211_S_CSA, 0);
1427 ieee80211_notify_csa(ic, c, mode, count);
1431 * Complete an 802.11h channel switch started by ieee80211_csa_startswitch.
1432 * We clear state and move all vap's in CSA state to RUN state
1433 * so they can again transmit.
1436 ieee80211_csa_completeswitch(struct ieee80211com *ic)
1438 struct ieee80211vap *vap;
1440 IEEE80211_LOCK_ASSERT(ic);
1442 KASSERT(ic->ic_flags & IEEE80211_F_CSAPENDING, ("csa not pending"));
1444 ieee80211_setcurchan(ic, ic->ic_csa_newchan);
1445 ic->ic_csa_newchan = NULL;
1446 ic->ic_flags &= ~IEEE80211_F_CSAPENDING;
1448 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next)
1449 if (vap->iv_state == IEEE80211_S_CSA)
1450 ieee80211_new_state_locked(vap, IEEE80211_S_RUN, 0);
1454 * Complete a DFS CAC started by ieee80211_dfs_cac_start.
1455 * We clear state and move all vap's in CAC state to RUN state.
1458 ieee80211_cac_completeswitch(struct ieee80211vap *vap0)
1460 struct ieee80211com *ic = vap0->iv_ic;
1461 struct ieee80211vap *vap;
1465 * Complete CAC state change for lead vap first; then
1466 * clock all the other vap's waiting.
1468 KASSERT(vap0->iv_state == IEEE80211_S_CAC,
1469 ("wrong state %d", vap0->iv_state));
1470 ieee80211_new_state_locked(vap0, IEEE80211_S_RUN, 0);
1472 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next)
1473 if (vap->iv_state == IEEE80211_S_CAC)
1474 ieee80211_new_state_locked(vap, IEEE80211_S_RUN, 0);
1475 IEEE80211_UNLOCK(ic);
1479 * Force all vap's other than the specified vap to the INIT state
1480 * and mark them as waiting for a scan to complete. These vaps
1481 * will be brought up when the scan completes and the scanning vap
1482 * reaches RUN state by wakeupwaiting.
1483 * XXX if we do this in threads we can use sleep/wakeup.
1486 markwaiting(struct ieee80211vap *vap0)
1488 struct ieee80211com *ic = vap0->iv_ic;
1489 struct ieee80211vap *vap;
1491 IEEE80211_LOCK_ASSERT(ic);
1493 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1496 if (vap->iv_state != IEEE80211_S_INIT) {
1497 vap->iv_newstate(vap, IEEE80211_S_INIT, 0);
1498 vap->iv_flags_ext |= IEEE80211_FEXT_SCANWAIT;
1504 * Wakeup all vap's waiting for a scan to complete. This is the
1505 * companion to markwaiting (above) and is used to coordinate
1506 * multiple vaps scanning.
1509 wakeupwaiting(struct ieee80211vap *vap0)
1511 struct ieee80211com *ic = vap0->iv_ic;
1512 struct ieee80211vap *vap;
1514 IEEE80211_LOCK_ASSERT(ic);
1516 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1519 if (vap->iv_flags_ext & IEEE80211_FEXT_SCANWAIT) {
1520 vap->iv_flags_ext &= ~IEEE80211_FEXT_SCANWAIT;
1521 /* NB: sta's cannot go INIT->RUN */
1522 vap->iv_newstate(vap,
1523 vap->iv_opmode == IEEE80211_M_STA ?
1524 IEEE80211_S_SCAN : IEEE80211_S_RUN, 0);
1530 * Handle post state change work common to all operating modes.
1533 ieee80211_newstate_cb(struct ieee80211vap *vap,
1534 enum ieee80211_state nstate, int arg)
1536 struct ieee80211com *ic = vap->iv_ic;
1538 IEEE80211_LOCK_ASSERT(ic);
1540 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE,
1541 "%s: %s arg %d\n", __func__, ieee80211_state_name[nstate], arg);
1543 if (nstate == IEEE80211_S_RUN) {
1545 * OACTIVE may be set on the vap if the upper layer
1546 * tried to transmit (e.g. IPv6 NDP) before we reach
1547 * RUN state. Clear it and restart xmit.
1549 * Note this can also happen as a result of SLEEP->RUN
1550 * (i.e. coming out of power save mode).
1552 vap->iv_ifp->if_drv_flags &= ~IFF_DRV_OACTIVE;
1553 if_start(vap->iv_ifp);
1555 /* bring up any vaps waiting on us */
1557 } else if (nstate == IEEE80211_S_INIT) {
1559 * Flush the scan cache if we did the last scan (XXX?)
1560 * and flush any frames on send queues from this vap.
1561 * Note the mgt q is used only for legacy drivers and
1562 * will go away shortly.
1564 ieee80211_scan_flush(vap);
1566 /* XXX NB: cast for altq */
1567 ieee80211_flush_ifq((struct ifqueue *)&ic->ic_ifp->if_snd, vap);
1569 vap->iv_newstate_cb = NULL;
1573 * Public interface for initiating a state machine change.
1574 * This routine single-threads the request and coordinates
1575 * the scheduling of multiple vaps for the purpose of selecting
1576 * an operating channel. Specifically the following scenarios
1578 * o only one vap can be selecting a channel so on transition to
1579 * SCAN state if another vap is already scanning then
1580 * mark the caller for later processing and return without
1581 * doing anything (XXX? expectations by caller of synchronous operation)
1582 * o only one vap can be doing CAC of a channel so on transition to
1583 * CAC state if another vap is already scanning for radar then
1584 * mark the caller for later processing and return without
1585 * doing anything (XXX? expectations by caller of synchronous operation)
1586 * o if another vap is already running when a request is made
1587 * to SCAN then an operating channel has been chosen; bypass
1588 * the scan and just join the channel
1590 * Note that the state change call is done through the iv_newstate
1591 * method pointer so any driver routine gets invoked. The driver
1592 * will normally call back into operating mode-specific
1593 * ieee80211_newstate routines (below) unless it needs to completely
1594 * bypass the state machine (e.g. because the firmware has it's
1595 * own idea how things should work). Bypassing the net80211 layer
1596 * is usually a mistake and indicates lack of proper integration
1597 * with the net80211 layer.
1600 ieee80211_new_state_locked(struct ieee80211vap *vap,
1601 enum ieee80211_state nstate, int arg)
1603 struct ieee80211com *ic = vap->iv_ic;
1604 struct ieee80211vap *vp;
1605 enum ieee80211_state ostate;
1606 int nrunning, nscanning, rc;
1608 IEEE80211_LOCK_ASSERT(ic);
1610 nrunning = nscanning = 0;
1611 /* XXX can track this state instead of calculating */
1612 TAILQ_FOREACH(vp, &ic->ic_vaps, iv_next) {
1614 if (vp->iv_state >= IEEE80211_S_RUN)
1616 /* XXX doesn't handle bg scan */
1617 /* NB: CAC+AUTH+ASSOC treated like SCAN */
1618 else if (vp->iv_state > IEEE80211_S_INIT)
1622 ostate = vap->iv_state;
1623 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE,
1624 "%s: %s -> %s (nrunning %d nscanning %d)\n", __func__,
1625 ieee80211_state_name[ostate], ieee80211_state_name[nstate],
1626 nrunning, nscanning);
1628 case IEEE80211_S_SCAN:
1629 if (ostate == IEEE80211_S_INIT) {
1631 * INIT -> SCAN happens on initial bringup.
1633 KASSERT(!(nscanning && nrunning),
1634 ("%d scanning and %d running", nscanning, nrunning));
1637 * Someone is scanning, defer our state
1638 * change until the work has completed.
1640 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE,
1641 "%s: defer %s -> %s\n",
1642 __func__, ieee80211_state_name[ostate],
1643 ieee80211_state_name[nstate]);
1644 vap->iv_flags_ext |= IEEE80211_FEXT_SCANWAIT;
1650 * Someone is operating; just join the channel
1654 /* XXX check each opmode, adhoc? */
1655 if (vap->iv_opmode == IEEE80211_M_STA)
1656 nstate = IEEE80211_S_SCAN;
1658 nstate = IEEE80211_S_RUN;
1659 #ifdef IEEE80211_DEBUG
1660 if (nstate != IEEE80211_S_SCAN) {
1661 IEEE80211_DPRINTF(vap,
1662 IEEE80211_MSG_STATE,
1663 "%s: override, now %s -> %s\n",
1665 ieee80211_state_name[ostate],
1666 ieee80211_state_name[nstate]);
1672 * SCAN was forced; e.g. on beacon miss. Force
1673 * other running vap's to INIT state and mark
1674 * them as waiting for the scan to complete. This
1675 * insures they don't interfere with our scanning.
1677 * XXX not always right, assumes ap follows sta
1682 case IEEE80211_S_RUN:
1683 if (vap->iv_opmode == IEEE80211_M_WDS &&
1684 (vap->iv_flags_ext & IEEE80211_FEXT_WDSLEGACY) &&
1687 * Legacy WDS with someone else scanning; don't
1688 * go online until that completes as we should
1689 * follow the other vap to the channel they choose.
1691 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE,
1692 "%s: defer %s -> %s (legacy WDS)\n", __func__,
1693 ieee80211_state_name[ostate],
1694 ieee80211_state_name[nstate]);
1695 vap->iv_flags_ext |= IEEE80211_FEXT_SCANWAIT;
1699 if (vap->iv_opmode == IEEE80211_M_HOSTAP &&
1700 IEEE80211_IS_CHAN_DFS(ic->ic_bsschan) &&
1701 (vap->iv_flags_ext & IEEE80211_FEXT_DFS) &&
1702 !IEEE80211_IS_CHAN_CACDONE(ic->ic_bsschan)) {
1704 * This is a DFS channel, transition to CAC state
1705 * instead of RUN. This allows us to initiate
1706 * Channel Availability Check (CAC) as specified
1709 nstate = IEEE80211_S_CAC;
1710 IEEE80211_DPRINTF(vap, IEEE80211_MSG_STATE,
1711 "%s: override %s -> %s (DFS)\n", __func__,
1712 ieee80211_state_name[ostate],
1713 ieee80211_state_name[nstate]);
1716 case IEEE80211_S_INIT:
1717 if (ostate == IEEE80211_S_INIT ) {
1718 /* XXX don't believe this */
1719 /* INIT -> INIT. nothing to do */
1720 vap->iv_flags_ext &= ~IEEE80211_FEXT_SCANWAIT;
1726 /* XXX on transition RUN->CAC do we need to set nstate = iv_state? */
1727 if (ostate != nstate) {
1729 * Arrange for work to happen after state change completes.
1730 * If this happens asynchronously the caller must arrange
1731 * for the com lock to be held.
1733 vap->iv_newstate_cb = ieee80211_newstate_cb;
1735 rc = vap->iv_newstate(vap, nstate, arg);
1736 if (rc == 0 && vap->iv_newstate_cb != NULL)
1737 vap->iv_newstate_cb(vap, nstate, arg);
1743 ieee80211_new_state(struct ieee80211vap *vap,
1744 enum ieee80211_state nstate, int arg)
1746 struct ieee80211com *ic = vap->iv_ic;
1750 rc = ieee80211_new_state_locked(vap, nstate, arg);
1751 IEEE80211_UNLOCK(ic);