2 * Copyright (c) 2007-2008 Sam Leffler, Errno Consulting
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
14 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
15 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
16 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
17 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
18 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
19 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
20 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
21 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
23 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 #include <sys/cdefs.h>
28 __FBSDID("$FreeBSD$");
32 * IEEE 802.11n protocol support.
38 #include <sys/param.h>
39 #include <sys/kernel.h>
40 #include <sys/systm.h>
41 #include <sys/endian.h>
43 #include <sys/socket.h>
46 #include <net/if_media.h>
47 #include <net/ethernet.h>
49 #include <net80211/ieee80211_var.h>
50 #include <net80211/ieee80211_action.h>
51 #include <net80211/ieee80211_input.h>
53 /* define here, used throughout file */
54 #define MS(_v, _f) (((_v) & _f) >> _f##_S)
55 #define SM(_v, _f) (((_v) << _f##_S) & _f)
57 const struct ieee80211_mcs_rates ieee80211_htrates[IEEE80211_HTRATE_MAXSIZE] = {
58 { 13, 14, 27, 30 }, /* MCS 0 */
59 { 26, 29, 54, 60 }, /* MCS 1 */
60 { 39, 43, 81, 90 }, /* MCS 2 */
61 { 52, 58, 108, 120 }, /* MCS 3 */
62 { 78, 87, 162, 180 }, /* MCS 4 */
63 { 104, 116, 216, 240 }, /* MCS 5 */
64 { 117, 130, 243, 270 }, /* MCS 6 */
65 { 130, 144, 270, 300 }, /* MCS 7 */
66 { 26, 29, 54, 60 }, /* MCS 8 */
67 { 52, 58, 108, 120 }, /* MCS 9 */
68 { 78, 87, 162, 180 }, /* MCS 10 */
69 { 104, 116, 216, 240 }, /* MCS 11 */
70 { 156, 173, 324, 360 }, /* MCS 12 */
71 { 208, 231, 432, 480 }, /* MCS 13 */
72 { 234, 260, 486, 540 }, /* MCS 14 */
73 { 260, 289, 540, 600 }, /* MCS 15 */
74 { 39, 43, 81, 90 }, /* MCS 16 */
75 { 78, 87, 162, 180 }, /* MCS 17 */
76 { 117, 130, 243, 270 }, /* MCS 18 */
77 { 156, 173, 324, 360 }, /* MCS 19 */
78 { 234, 260, 486, 540 }, /* MCS 20 */
79 { 312, 347, 648, 720 }, /* MCS 21 */
80 { 351, 390, 729, 810 }, /* MCS 22 */
81 { 390, 433, 810, 900 }, /* MCS 23 */
82 { 52, 58, 108, 120 }, /* MCS 24 */
83 { 104, 116, 216, 240 }, /* MCS 25 */
84 { 156, 173, 324, 360 }, /* MCS 26 */
85 { 208, 231, 432, 480 }, /* MCS 27 */
86 { 312, 347, 648, 720 }, /* MCS 28 */
87 { 416, 462, 864, 960 }, /* MCS 29 */
88 { 468, 520, 972, 1080 }, /* MCS 30 */
89 { 520, 578, 1080, 1200 }, /* MCS 31 */
90 { 0, 0, 12, 13 }, /* MCS 32 */
91 { 78, 87, 162, 180 }, /* MCS 33 */
92 { 104, 116, 216, 240 }, /* MCS 34 */
93 { 130, 144, 270, 300 }, /* MCS 35 */
94 { 117, 130, 243, 270 }, /* MCS 36 */
95 { 156, 173, 324, 360 }, /* MCS 37 */
96 { 195, 217, 405, 450 }, /* MCS 38 */
97 { 104, 116, 216, 240 }, /* MCS 39 */
98 { 130, 144, 270, 300 }, /* MCS 40 */
99 { 130, 144, 270, 300 }, /* MCS 41 */
100 { 156, 173, 324, 360 }, /* MCS 42 */
101 { 182, 202, 378, 420 }, /* MCS 43 */
102 { 182, 202, 378, 420 }, /* MCS 44 */
103 { 208, 231, 432, 480 }, /* MCS 45 */
104 { 156, 173, 324, 360 }, /* MCS 46 */
105 { 195, 217, 405, 450 }, /* MCS 47 */
106 { 195, 217, 405, 450 }, /* MCS 48 */
107 { 234, 260, 486, 540 }, /* MCS 49 */
108 { 273, 303, 567, 630 }, /* MCS 50 */
109 { 273, 303, 567, 630 }, /* MCS 51 */
110 { 312, 347, 648, 720 }, /* MCS 52 */
111 { 130, 144, 270, 300 }, /* MCS 53 */
112 { 156, 173, 324, 360 }, /* MCS 54 */
113 { 182, 202, 378, 420 }, /* MCS 55 */
114 { 156, 173, 324, 360 }, /* MCS 56 */
115 { 182, 202, 378, 420 }, /* MCS 57 */
116 { 208, 231, 432, 480 }, /* MCS 58 */
117 { 234, 260, 486, 540 }, /* MCS 59 */
118 { 208, 231, 432, 480 }, /* MCS 60 */
119 { 234, 260, 486, 540 }, /* MCS 61 */
120 { 260, 289, 540, 600 }, /* MCS 62 */
121 { 260, 289, 540, 600 }, /* MCS 63 */
122 { 286, 318, 594, 660 }, /* MCS 64 */
123 { 195, 217, 405, 450 }, /* MCS 65 */
124 { 234, 260, 486, 540 }, /* MCS 66 */
125 { 273, 303, 567, 630 }, /* MCS 67 */
126 { 234, 260, 486, 540 }, /* MCS 68 */
127 { 273, 303, 567, 630 }, /* MCS 69 */
128 { 312, 347, 648, 720 }, /* MCS 70 */
129 { 351, 390, 729, 810 }, /* MCS 71 */
130 { 312, 347, 648, 720 }, /* MCS 72 */
131 { 351, 390, 729, 810 }, /* MCS 73 */
132 { 390, 433, 810, 900 }, /* MCS 74 */
133 { 390, 433, 810, 900 }, /* MCS 75 */
134 { 429, 477, 891, 990 }, /* MCS 76 */
137 #ifdef IEEE80211_AMPDU_AGE
138 static int ieee80211_ampdu_age = -1; /* threshold for ampdu reorder q (ms) */
139 SYSCTL_PROC(_net_wlan, OID_AUTO, ampdu_age, CTLTYPE_INT | CTLFLAG_RW,
140 &ieee80211_ampdu_age, 0, ieee80211_sysctl_msecs_ticks, "I",
141 "AMPDU max reorder age (ms)");
144 static int ieee80211_recv_bar_ena = 1;
145 SYSCTL_INT(_net_wlan, OID_AUTO, recv_bar, CTLFLAG_RW, &ieee80211_recv_bar_ena,
146 0, "BAR frame processing (ena/dis)");
148 static int ieee80211_addba_timeout = -1;/* timeout for ADDBA response */
149 SYSCTL_PROC(_net_wlan, OID_AUTO, addba_timeout, CTLTYPE_INT | CTLFLAG_RW,
150 &ieee80211_addba_timeout, 0, ieee80211_sysctl_msecs_ticks, "I",
151 "ADDBA request timeout (ms)");
152 static int ieee80211_addba_backoff = -1;/* backoff after max ADDBA requests */
153 SYSCTL_PROC(_net_wlan, OID_AUTO, addba_backoff, CTLTYPE_INT | CTLFLAG_RW,
154 &ieee80211_addba_backoff, 0, ieee80211_sysctl_msecs_ticks, "I",
155 "ADDBA request backoff (ms)");
156 static int ieee80211_addba_maxtries = 3;/* max ADDBA requests before backoff */
157 SYSCTL_INT(_net_wlan, OID_AUTO, addba_maxtries, CTLTYPE_INT | CTLFLAG_RW,
158 &ieee80211_addba_maxtries, 0, "max ADDBA requests sent before backoff");
160 static int ieee80211_bar_timeout = -1; /* timeout waiting for BAR response */
161 static int ieee80211_bar_maxtries = 50;/* max BAR requests before DELBA */
163 static ieee80211_recv_action_func ht_recv_action_ba_addba_request;
164 static ieee80211_recv_action_func ht_recv_action_ba_addba_response;
165 static ieee80211_recv_action_func ht_recv_action_ba_delba;
166 static ieee80211_recv_action_func ht_recv_action_ht_mimopwrsave;
167 static ieee80211_recv_action_func ht_recv_action_ht_txchwidth;
169 static ieee80211_send_action_func ht_send_action_ba_addba;
170 static ieee80211_send_action_func ht_send_action_ba_delba;
171 static ieee80211_send_action_func ht_send_action_ht_txchwidth;
174 ieee80211_ht_init(void)
177 * Setup HT parameters that depends on the clock frequency.
179 #ifdef IEEE80211_AMPDU_AGE
180 ieee80211_ampdu_age = msecs_to_ticks(500);
182 ieee80211_addba_timeout = msecs_to_ticks(250);
183 ieee80211_addba_backoff = msecs_to_ticks(10*1000);
184 ieee80211_bar_timeout = msecs_to_ticks(250);
186 * Register action frame handlers.
188 ieee80211_recv_action_register(IEEE80211_ACTION_CAT_BA,
189 IEEE80211_ACTION_BA_ADDBA_REQUEST, ht_recv_action_ba_addba_request);
190 ieee80211_recv_action_register(IEEE80211_ACTION_CAT_BA,
191 IEEE80211_ACTION_BA_ADDBA_RESPONSE, ht_recv_action_ba_addba_response);
192 ieee80211_recv_action_register(IEEE80211_ACTION_CAT_BA,
193 IEEE80211_ACTION_BA_DELBA, ht_recv_action_ba_delba);
194 ieee80211_recv_action_register(IEEE80211_ACTION_CAT_HT,
195 IEEE80211_ACTION_HT_MIMOPWRSAVE, ht_recv_action_ht_mimopwrsave);
196 ieee80211_recv_action_register(IEEE80211_ACTION_CAT_HT,
197 IEEE80211_ACTION_HT_TXCHWIDTH, ht_recv_action_ht_txchwidth);
199 ieee80211_send_action_register(IEEE80211_ACTION_CAT_BA,
200 IEEE80211_ACTION_BA_ADDBA_REQUEST, ht_send_action_ba_addba);
201 ieee80211_send_action_register(IEEE80211_ACTION_CAT_BA,
202 IEEE80211_ACTION_BA_ADDBA_RESPONSE, ht_send_action_ba_addba);
203 ieee80211_send_action_register(IEEE80211_ACTION_CAT_BA,
204 IEEE80211_ACTION_BA_DELBA, ht_send_action_ba_delba);
205 ieee80211_send_action_register(IEEE80211_ACTION_CAT_HT,
206 IEEE80211_ACTION_HT_TXCHWIDTH, ht_send_action_ht_txchwidth);
208 SYSINIT(wlan_ht, SI_SUB_DRIVERS, SI_ORDER_FIRST, ieee80211_ht_init, NULL);
210 static int ieee80211_ampdu_enable(struct ieee80211_node *ni,
211 struct ieee80211_tx_ampdu *tap);
212 static int ieee80211_addba_request(struct ieee80211_node *ni,
213 struct ieee80211_tx_ampdu *tap,
214 int dialogtoken, int baparamset, int batimeout);
215 static int ieee80211_addba_response(struct ieee80211_node *ni,
216 struct ieee80211_tx_ampdu *tap,
217 int code, int baparamset, int batimeout);
218 static void ieee80211_addba_stop(struct ieee80211_node *ni,
219 struct ieee80211_tx_ampdu *tap);
220 static void null_addba_response_timeout(struct ieee80211_node *ni,
221 struct ieee80211_tx_ampdu *tap);
223 static void ieee80211_bar_response(struct ieee80211_node *ni,
224 struct ieee80211_tx_ampdu *tap, int status);
225 static void ampdu_tx_stop(struct ieee80211_tx_ampdu *tap);
226 static void bar_stop_timer(struct ieee80211_tx_ampdu *tap);
227 static int ampdu_rx_start(struct ieee80211_node *, struct ieee80211_rx_ampdu *,
228 int baparamset, int batimeout, int baseqctl);
229 static void ampdu_rx_stop(struct ieee80211_node *, struct ieee80211_rx_ampdu *);
232 ieee80211_ht_attach(struct ieee80211com *ic)
234 /* setup default aggregation policy */
235 ic->ic_recv_action = ieee80211_recv_action;
236 ic->ic_send_action = ieee80211_send_action;
237 ic->ic_ampdu_enable = ieee80211_ampdu_enable;
238 ic->ic_addba_request = ieee80211_addba_request;
239 ic->ic_addba_response = ieee80211_addba_response;
240 ic->ic_addba_response_timeout = null_addba_response_timeout;
241 ic->ic_addba_stop = ieee80211_addba_stop;
242 ic->ic_bar_response = ieee80211_bar_response;
243 ic->ic_ampdu_rx_start = ampdu_rx_start;
244 ic->ic_ampdu_rx_stop = ampdu_rx_stop;
246 ic->ic_htprotmode = IEEE80211_PROT_RTSCTS;
247 ic->ic_curhtprotmode = IEEE80211_HTINFO_OPMODE_PURE;
251 ieee80211_ht_detach(struct ieee80211com *ic)
256 ieee80211_ht_vattach(struct ieee80211vap *vap)
259 /* driver can override defaults */
260 vap->iv_ampdu_rxmax = IEEE80211_HTCAP_MAXRXAMPDU_8K;
261 vap->iv_ampdu_density = IEEE80211_HTCAP_MPDUDENSITY_NA;
262 vap->iv_ampdu_limit = vap->iv_ampdu_rxmax;
263 vap->iv_amsdu_limit = vap->iv_htcaps & IEEE80211_HTCAP_MAXAMSDU;
264 /* tx aggregation traffic thresholds */
265 vap->iv_ampdu_mintraffic[WME_AC_BK] = 128;
266 vap->iv_ampdu_mintraffic[WME_AC_BE] = 64;
267 vap->iv_ampdu_mintraffic[WME_AC_VO] = 32;
268 vap->iv_ampdu_mintraffic[WME_AC_VI] = 32;
270 if (vap->iv_htcaps & IEEE80211_HTC_HT) {
272 * Device is HT capable; enable all HT-related
273 * facilities by default.
274 * XXX these choices may be too aggressive.
276 vap->iv_flags_ht |= IEEE80211_FHT_HT
277 | IEEE80211_FHT_HTCOMPAT
279 if (vap->iv_htcaps & IEEE80211_HTCAP_SHORTGI20)
280 vap->iv_flags_ht |= IEEE80211_FHT_SHORTGI20;
281 /* XXX infer from channel list? */
282 if (vap->iv_htcaps & IEEE80211_HTCAP_CHWIDTH40) {
283 vap->iv_flags_ht |= IEEE80211_FHT_USEHT40;
284 if (vap->iv_htcaps & IEEE80211_HTCAP_SHORTGI40)
285 vap->iv_flags_ht |= IEEE80211_FHT_SHORTGI40;
287 /* enable RIFS if capable */
288 if (vap->iv_htcaps & IEEE80211_HTC_RIFS)
289 vap->iv_flags_ht |= IEEE80211_FHT_RIFS;
291 /* NB: A-MPDU and A-MSDU rx are mandated, these are tx only */
292 vap->iv_flags_ht |= IEEE80211_FHT_AMPDU_RX;
293 if (vap->iv_htcaps & IEEE80211_HTC_AMPDU)
294 vap->iv_flags_ht |= IEEE80211_FHT_AMPDU_TX;
295 vap->iv_flags_ht |= IEEE80211_FHT_AMSDU_RX;
296 if (vap->iv_htcaps & IEEE80211_HTC_AMSDU)
297 vap->iv_flags_ht |= IEEE80211_FHT_AMSDU_TX;
299 /* NB: disable default legacy WDS, too many issues right now */
300 if (vap->iv_flags_ext & IEEE80211_FEXT_WDSLEGACY)
301 vap->iv_flags_ht &= ~IEEE80211_FHT_HT;
305 ieee80211_ht_vdetach(struct ieee80211vap *vap)
310 ht_getrate(struct ieee80211com *ic, int index, enum ieee80211_phymode mode,
315 mword = ieee80211_rate2media(ic, index | IEEE80211_RATE_MCS, mode);
316 if (IFM_SUBTYPE(mword) != IFM_IEEE80211_MCS)
320 rate = ieee80211_htrates[index].ht20_rate_800ns;
323 rate = ieee80211_htrates[index].ht20_rate_400ns;
326 rate = ieee80211_htrates[index].ht40_rate_800ns;
329 rate = ieee80211_htrates[index].ht40_rate_400ns;
335 static struct printranges {
346 { 32, 0, 1, 2, IEEE80211_HTC_TXMCS32 },
347 { 33, 38, 2, 0, IEEE80211_HTC_TXUNEQUAL },
348 { 39, 52, 3, 0, IEEE80211_HTC_TXUNEQUAL },
349 { 53, 76, 4, 0, IEEE80211_HTC_TXUNEQUAL },
354 ht_rateprint(struct ieee80211com *ic, enum ieee80211_phymode mode, int ratetype)
356 struct ifnet *ifp = ic->ic_ifp;
357 int minrate, maxrate;
358 struct printranges *range;
360 for (range = ranges; range->txstream != 0; range++) {
361 if (ic->ic_txstream < range->txstream)
363 if (range->htcapflags &&
364 (ic->ic_htcaps & range->htcapflags) == 0)
366 if (ratetype < range->ratetype)
368 minrate = ht_getrate(ic, range->minmcs, mode, ratetype);
369 maxrate = ht_getrate(ic, range->maxmcs, mode, ratetype);
371 if_printf(ifp, "MCS %d-%d: %d%sMbps - %d%sMbps\n",
372 range->minmcs, range->maxmcs,
373 minrate/2, ((minrate & 0x1) != 0 ? ".5" : ""),
374 maxrate/2, ((maxrate & 0x1) != 0 ? ".5" : ""));
376 if_printf(ifp, "MCS %d: %d%sMbps\n", range->minmcs,
377 minrate/2, ((minrate & 0x1) != 0 ? ".5" : ""));
383 ht_announce(struct ieee80211com *ic, enum ieee80211_phymode mode)
385 struct ifnet *ifp = ic->ic_ifp;
386 const char *modestr = ieee80211_phymode_name[mode];
388 if_printf(ifp, "%s MCS 20MHz\n", modestr);
389 ht_rateprint(ic, mode, 0);
390 if (ic->ic_htcaps & IEEE80211_HTCAP_SHORTGI20) {
391 if_printf(ifp, "%s MCS 20MHz SGI\n", modestr);
392 ht_rateprint(ic, mode, 1);
394 if (ic->ic_htcaps & IEEE80211_HTCAP_CHWIDTH40) {
395 if_printf(ifp, "%s MCS 40MHz:\n", modestr);
396 ht_rateprint(ic, mode, 2);
398 if ((ic->ic_htcaps & IEEE80211_HTCAP_CHWIDTH40) &&
399 (ic->ic_htcaps & IEEE80211_HTCAP_SHORTGI40)) {
400 if_printf(ifp, "%s MCS 40MHz SGI:\n", modestr);
401 ht_rateprint(ic, mode, 3);
406 ieee80211_ht_announce(struct ieee80211com *ic)
408 struct ifnet *ifp = ic->ic_ifp;
410 if (isset(ic->ic_modecaps, IEEE80211_MODE_11NA) ||
411 isset(ic->ic_modecaps, IEEE80211_MODE_11NG))
412 if_printf(ifp, "%dT%dR\n", ic->ic_txstream, ic->ic_rxstream);
413 if (isset(ic->ic_modecaps, IEEE80211_MODE_11NA))
414 ht_announce(ic, IEEE80211_MODE_11NA);
415 if (isset(ic->ic_modecaps, IEEE80211_MODE_11NG))
416 ht_announce(ic, IEEE80211_MODE_11NG);
419 static struct ieee80211_htrateset htrateset;
421 const struct ieee80211_htrateset *
422 ieee80211_get_suphtrates(struct ieee80211com *ic,
423 const struct ieee80211_channel *c)
425 #define ADDRATE(x) do { \
426 htrateset.rs_rates[htrateset.rs_nrates] = x; \
427 htrateset.rs_nrates++; \
431 memset(&htrateset, 0, sizeof(struct ieee80211_htrateset));
432 for (i = 0; i < ic->ic_txstream * 8; i++)
434 if ((ic->ic_htcaps & IEEE80211_HTCAP_CHWIDTH40) &&
435 (ic->ic_htcaps & IEEE80211_HTC_TXMCS32))
437 if (ic->ic_htcaps & IEEE80211_HTC_TXUNEQUAL) {
438 if (ic->ic_txstream >= 2) {
439 for (i = 33; i <= 38; i++)
442 if (ic->ic_txstream >= 3) {
443 for (i = 39; i <= 52; i++)
446 if (ic->ic_txstream == 4) {
447 for (i = 53; i <= 76; i++)
456 * Receive processing.
460 * Decap the encapsulated A-MSDU frames and dispatch all but
461 * the last for delivery. The last frame is returned for
462 * delivery via the normal path.
465 ieee80211_decap_amsdu(struct ieee80211_node *ni, struct mbuf *m)
467 struct ieee80211vap *vap = ni->ni_vap;
471 /* discard 802.3 header inserted by ieee80211_decap */
472 m_adj(m, sizeof(struct ether_header));
474 vap->iv_stats.is_amsdu_decap++;
478 * Decap the first frame, bust it apart from the
479 * remainder and deliver. We leave the last frame
480 * delivery to the caller (for consistency with other
481 * code paths, could also do it here).
483 m = ieee80211_decap1(m, &framelen);
485 IEEE80211_DISCARD_MAC(vap, IEEE80211_MSG_ANY,
486 ni->ni_macaddr, "a-msdu", "%s", "decap failed");
487 vap->iv_stats.is_amsdu_tooshort++;
490 if (m->m_pkthdr.len == framelen)
492 n = m_split(m, framelen, M_NOWAIT);
494 IEEE80211_DISCARD_MAC(vap, IEEE80211_MSG_ANY,
495 ni->ni_macaddr, "a-msdu",
496 "%s", "unable to split encapsulated frames");
497 vap->iv_stats.is_amsdu_split++;
498 m_freem(m); /* NB: must reclaim */
501 vap->iv_deliver_data(vap, ni, m);
504 * Remove frame contents; each intermediate frame
505 * is required to be aligned to a 4-byte boundary.
508 m_adj(m, roundup2(framelen, 4) - framelen); /* padding */
510 return m; /* last delivered by caller */
514 * Purge all frames in the A-MPDU re-order queue.
517 ampdu_rx_purge(struct ieee80211_rx_ampdu *rap)
522 for (i = 0; i < rap->rxa_wnd; i++) {
525 rap->rxa_m[i] = NULL;
526 rap->rxa_qbytes -= m->m_pkthdr.len;
528 if (--rap->rxa_qframes == 0)
532 KASSERT(rap->rxa_qbytes == 0 && rap->rxa_qframes == 0,
533 ("lost %u data, %u frames on ampdu rx q",
534 rap->rxa_qbytes, rap->rxa_qframes));
538 * Start A-MPDU rx/re-order processing for the specified TID.
541 ampdu_rx_start(struct ieee80211_node *ni, struct ieee80211_rx_ampdu *rap,
542 int baparamset, int batimeout, int baseqctl)
544 int bufsiz = MS(baparamset, IEEE80211_BAPS_BUFSIZ);
546 if (rap->rxa_flags & IEEE80211_AGGR_RUNNING) {
548 * AMPDU previously setup and not terminated with a DELBA,
549 * flush the reorder q's in case anything remains.
553 memset(rap, 0, sizeof(*rap));
554 rap->rxa_wnd = (bufsiz == 0) ?
555 IEEE80211_AGGR_BAWMAX : min(bufsiz, IEEE80211_AGGR_BAWMAX);
556 rap->rxa_start = MS(baseqctl, IEEE80211_BASEQ_START);
557 rap->rxa_flags |= IEEE80211_AGGR_RUNNING | IEEE80211_AGGR_XCHGPEND;
563 * Stop A-MPDU rx processing for the specified TID.
566 ampdu_rx_stop(struct ieee80211_node *ni, struct ieee80211_rx_ampdu *rap)
570 rap->rxa_flags &= ~(IEEE80211_AGGR_RUNNING | IEEE80211_AGGR_XCHGPEND);
574 * Dispatch a frame from the A-MPDU reorder queue. The
575 * frame is fed back into ieee80211_input marked with an
576 * M_AMPDU_MPDU flag so it doesn't come back to us (it also
577 * permits ieee80211_input to optimize re-processing).
580 ampdu_dispatch(struct ieee80211_node *ni, struct mbuf *m)
582 m->m_flags |= M_AMPDU_MPDU; /* bypass normal processing */
583 /* NB: rssi and noise are ignored w/ M_AMPDU_MPDU set */
584 (void) ieee80211_input(ni, m, 0, 0);
588 * Dispatch as many frames as possible from the re-order queue.
589 * Frames will always be "at the front"; we process all frames
590 * up to the first empty slot in the window. On completion we
591 * cleanup state if there are still pending frames in the current
592 * BA window. We assume the frame at slot 0 is already handled
593 * by the caller; we always start at slot 1.
596 ampdu_rx_dispatch(struct ieee80211_rx_ampdu *rap, struct ieee80211_node *ni)
598 struct ieee80211vap *vap = ni->ni_vap;
602 /* flush run of frames */
603 for (i = 1; i < rap->rxa_wnd; i++) {
607 rap->rxa_m[i] = NULL;
608 rap->rxa_qbytes -= m->m_pkthdr.len;
611 ampdu_dispatch(ni, m);
614 * If frames remain, copy the mbuf pointers down so
615 * they correspond to the offsets in the new window.
617 if (rap->rxa_qframes != 0) {
618 int n = rap->rxa_qframes, j;
619 for (j = i+1; j < rap->rxa_wnd; j++) {
620 if (rap->rxa_m[j] != NULL) {
621 rap->rxa_m[j-i] = rap->rxa_m[j];
622 rap->rxa_m[j] = NULL;
627 KASSERT(n == 0, ("lost %d frames", n));
628 vap->iv_stats.is_ampdu_rx_copy += rap->rxa_qframes;
631 * Adjust the start of the BA window to
632 * reflect the frames just dispatched.
634 rap->rxa_start = IEEE80211_SEQ_ADD(rap->rxa_start, i);
635 vap->iv_stats.is_ampdu_rx_oor += i;
638 #ifdef IEEE80211_AMPDU_AGE
640 * Dispatch all frames in the A-MPDU re-order queue.
643 ampdu_rx_flush(struct ieee80211_node *ni, struct ieee80211_rx_ampdu *rap)
645 struct ieee80211vap *vap = ni->ni_vap;
649 for (i = 0; i < rap->rxa_wnd; i++) {
653 rap->rxa_m[i] = NULL;
654 rap->rxa_qbytes -= m->m_pkthdr.len;
656 vap->iv_stats.is_ampdu_rx_oor++;
658 ampdu_dispatch(ni, m);
659 if (rap->rxa_qframes == 0)
663 #endif /* IEEE80211_AMPDU_AGE */
666 * Dispatch all frames in the A-MPDU re-order queue
667 * preceding the specified sequence number. This logic
668 * handles window moves due to a received MSDU or BAR.
671 ampdu_rx_flush_upto(struct ieee80211_node *ni,
672 struct ieee80211_rx_ampdu *rap, ieee80211_seq winstart)
674 struct ieee80211vap *vap = ni->ni_vap;
680 * Flush any complete MSDU's with a sequence number lower
681 * than winstart. Gaps may exist. Note that we may actually
682 * dispatch frames past winstart if a run continues; this is
683 * an optimization that avoids having to do a separate pass
684 * to dispatch frames after moving the BA window start.
686 seqno = rap->rxa_start;
687 for (i = 0; i < rap->rxa_wnd; i++) {
690 rap->rxa_m[i] = NULL;
691 rap->rxa_qbytes -= m->m_pkthdr.len;
693 vap->iv_stats.is_ampdu_rx_oor++;
695 ampdu_dispatch(ni, m);
697 if (!IEEE80211_SEQ_BA_BEFORE(seqno, winstart))
700 seqno = IEEE80211_SEQ_INC(seqno);
703 * If frames remain, copy the mbuf pointers down so
704 * they correspond to the offsets in the new window.
706 if (rap->rxa_qframes != 0) {
707 int n = rap->rxa_qframes, j;
709 /* NB: this loop assumes i > 0 and/or rxa_m[0] is NULL */
710 KASSERT(rap->rxa_m[0] == NULL,
711 ("%s: BA window slot 0 occupied", __func__));
712 for (j = i+1; j < rap->rxa_wnd; j++) {
713 if (rap->rxa_m[j] != NULL) {
714 rap->rxa_m[j-i] = rap->rxa_m[j];
715 rap->rxa_m[j] = NULL;
720 KASSERT(n == 0, ("%s: lost %d frames, qframes %d off %d "
721 "BA win <%d:%d> winstart %d",
722 __func__, n, rap->rxa_qframes, i, rap->rxa_start,
723 IEEE80211_SEQ_ADD(rap->rxa_start, rap->rxa_wnd-1),
725 vap->iv_stats.is_ampdu_rx_copy += rap->rxa_qframes;
728 * Move the start of the BA window; we use the
729 * sequence number of the last MSDU that was
730 * passed up the stack+1 or winstart if stopped on
731 * a gap in the reorder buffer.
733 rap->rxa_start = seqno;
737 * Process a received QoS data frame for an HT station. Handle
738 * A-MPDU reordering: if this frame is received out of order
739 * and falls within the BA window hold onto it. Otherwise if
740 * this frame completes a run, flush any pending frames. We
741 * return 1 if the frame is consumed. A 0 is returned if
742 * the frame should be processed normally by the caller.
745 ieee80211_ampdu_reorder(struct ieee80211_node *ni, struct mbuf *m)
747 #define IEEE80211_FC0_QOSDATA \
748 (IEEE80211_FC0_TYPE_DATA|IEEE80211_FC0_SUBTYPE_QOS|IEEE80211_FC0_VERSION_0)
749 #define PROCESS 0 /* caller should process frame */
750 #define CONSUMED 1 /* frame consumed, caller does nothing */
751 struct ieee80211vap *vap = ni->ni_vap;
752 struct ieee80211_qosframe *wh;
753 struct ieee80211_rx_ampdu *rap;
758 KASSERT((m->m_flags & (M_AMPDU | M_AMPDU_MPDU)) == M_AMPDU,
759 ("!a-mpdu or already re-ordered, flags 0x%x", m->m_flags));
760 KASSERT(ni->ni_flags & IEEE80211_NODE_HT, ("not an HT sta"));
762 /* NB: m_len known to be sufficient */
763 wh = mtod(m, struct ieee80211_qosframe *);
764 if (wh->i_fc[0] != IEEE80211_FC0_QOSDATA) {
766 * Not QoS data, shouldn't get here but just
767 * return it to the caller for processing.
771 if (IEEE80211_IS_DSTODS(wh))
772 tid = ((struct ieee80211_qosframe_addr4 *)wh)->i_qos[0];
775 tid &= IEEE80211_QOS_TID;
776 rap = &ni->ni_rx_ampdu[tid];
777 if ((rap->rxa_flags & IEEE80211_AGGR_XCHGPEND) == 0) {
779 * No ADDBA request yet, don't touch.
783 rxseq = le16toh(*(uint16_t *)wh->i_seq);
784 if ((rxseq & IEEE80211_SEQ_FRAG_MASK) != 0) {
786 * Fragments are not allowed; toss.
788 IEEE80211_DISCARD_MAC(vap,
789 IEEE80211_MSG_INPUT | IEEE80211_MSG_11N, ni->ni_macaddr,
790 "A-MPDU", "fragment, rxseq 0x%x tid %u%s", rxseq, tid,
791 wh->i_fc[1] & IEEE80211_FC1_RETRY ? " (retransmit)" : "");
792 vap->iv_stats.is_ampdu_rx_drop++;
793 IEEE80211_NODE_STAT(ni, rx_drop);
797 rxseq >>= IEEE80211_SEQ_SEQ_SHIFT;
800 if (rxseq == rap->rxa_start) {
802 * First frame in window.
804 if (rap->rxa_qframes != 0) {
806 * Dispatch as many packets as we can.
808 KASSERT(rap->rxa_m[0] == NULL, ("unexpected dup"));
809 ampdu_dispatch(ni, m);
810 ampdu_rx_dispatch(rap, ni);
814 * In order; advance window and notify
815 * caller to dispatch directly.
817 rap->rxa_start = IEEE80211_SEQ_INC(rxseq);
822 * Frame is out of order; store if in the BA window.
824 /* calculate offset in BA window */
825 off = IEEE80211_SEQ_SUB(rxseq, rap->rxa_start);
826 if (off < rap->rxa_wnd) {
828 * Common case (hopefully): in the BA window.
829 * Sec 9.10.7.6.2 a) (p.137)
831 #ifdef IEEE80211_AMPDU_AGE
833 * Check for frames sitting too long in the reorder queue.
834 * This should only ever happen if frames are not delivered
835 * without the sender otherwise notifying us (e.g. with a
836 * BAR to move the window). Typically this happens because
837 * of vendor bugs that cause the sequence number to jump.
838 * When this happens we get a gap in the reorder queue that
839 * leaves frame sitting on the queue until they get pushed
840 * out due to window moves. When the vendor does not send
841 * BAR this move only happens due to explicit packet sends
843 * NB: we only track the time of the oldest frame in the
844 * reorder q; this means that if we flush we might push
845 * frames that still "new"; if this happens then subsequent
846 * frames will result in BA window moves which cost something
847 * but is still better than a big throughput dip.
849 if (rap->rxa_qframes != 0) {
850 /* XXX honor batimeout? */
851 if (ticks - rap->rxa_age > ieee80211_ampdu_age) {
853 * Too long since we received the first
854 * frame; flush the reorder buffer.
856 if (rap->rxa_qframes != 0) {
857 vap->iv_stats.is_ampdu_rx_age +=
859 ampdu_rx_flush(ni, rap);
861 rap->rxa_start = IEEE80211_SEQ_INC(rxseq);
866 * First frame, start aging timer.
868 rap->rxa_age = ticks;
870 #endif /* IEEE80211_AMPDU_AGE */
872 if (rap->rxa_m[off] == NULL) {
875 rap->rxa_qbytes += m->m_pkthdr.len;
876 vap->iv_stats.is_ampdu_rx_reorder++;
878 IEEE80211_DISCARD_MAC(vap,
879 IEEE80211_MSG_INPUT | IEEE80211_MSG_11N,
880 ni->ni_macaddr, "a-mpdu duplicate",
881 "seqno %u tid %u BA win <%u:%u>",
882 rxseq, tid, rap->rxa_start,
883 IEEE80211_SEQ_ADD(rap->rxa_start, rap->rxa_wnd-1));
884 vap->iv_stats.is_rx_dup++;
885 IEEE80211_NODE_STAT(ni, rx_dup);
890 if (off < IEEE80211_SEQ_BA_RANGE) {
892 * Outside the BA window, but within range;
893 * flush the reorder q and move the window.
894 * Sec 9.10.7.6.2 b) (p.138)
896 IEEE80211_NOTE(vap, IEEE80211_MSG_11N, ni,
897 "move BA win <%u:%u> (%u frames) rxseq %u tid %u",
899 IEEE80211_SEQ_ADD(rap->rxa_start, rap->rxa_wnd-1),
900 rap->rxa_qframes, rxseq, tid);
901 vap->iv_stats.is_ampdu_rx_move++;
904 * The spec says to flush frames up to but not including:
905 * WinStart_B = rxseq - rap->rxa_wnd + 1
906 * Then insert the frame or notify the caller to process
907 * it immediately. We can safely do this by just starting
908 * over again because we know the frame will now be within
911 /* NB: rxa_wnd known to be >0 */
912 ampdu_rx_flush_upto(ni, rap,
913 IEEE80211_SEQ_SUB(rxseq, rap->rxa_wnd-1));
917 * Outside the BA window and out of range; toss.
918 * Sec 9.10.7.6.2 c) (p.138)
920 IEEE80211_DISCARD_MAC(vap,
921 IEEE80211_MSG_INPUT | IEEE80211_MSG_11N, ni->ni_macaddr,
922 "MPDU", "BA win <%u:%u> (%u frames) rxseq %u tid %u%s",
924 IEEE80211_SEQ_ADD(rap->rxa_start, rap->rxa_wnd-1),
925 rap->rxa_qframes, rxseq, tid,
926 wh->i_fc[1] & IEEE80211_FC1_RETRY ? " (retransmit)" : "");
927 vap->iv_stats.is_ampdu_rx_drop++;
928 IEEE80211_NODE_STAT(ni, rx_drop);
934 #undef IEEE80211_FC0_QOSDATA
938 * Process a BAR ctl frame. Dispatch all frames up to
939 * the sequence number of the frame. If this frame is
940 * out of range it's discarded.
943 ieee80211_recv_bar(struct ieee80211_node *ni, struct mbuf *m0)
945 struct ieee80211vap *vap = ni->ni_vap;
946 struct ieee80211_frame_bar *wh;
947 struct ieee80211_rx_ampdu *rap;
951 if (!ieee80211_recv_bar_ena) {
953 IEEE80211_DISCARD_MAC(vap, IEEE80211_MSG_11N,
954 ni->ni_macaddr, "BAR", "%s", "processing disabled");
956 vap->iv_stats.is_ampdu_bar_bad++;
959 wh = mtod(m0, struct ieee80211_frame_bar *);
960 /* XXX check basic BAR */
961 tid = MS(le16toh(wh->i_ctl), IEEE80211_BAR_TID);
962 rap = &ni->ni_rx_ampdu[tid];
963 if ((rap->rxa_flags & IEEE80211_AGGR_XCHGPEND) == 0) {
965 * No ADDBA request yet, don't touch.
967 IEEE80211_DISCARD_MAC(vap,
968 IEEE80211_MSG_INPUT | IEEE80211_MSG_11N,
969 ni->ni_macaddr, "BAR", "no BA stream, tid %u", tid);
970 vap->iv_stats.is_ampdu_bar_bad++;
973 vap->iv_stats.is_ampdu_bar_rx++;
974 rxseq = le16toh(wh->i_seq) >> IEEE80211_SEQ_SEQ_SHIFT;
975 if (rxseq == rap->rxa_start)
977 /* calculate offset in BA window */
978 off = IEEE80211_SEQ_SUB(rxseq, rap->rxa_start);
979 if (off < IEEE80211_SEQ_BA_RANGE) {
981 * Flush the reorder q up to rxseq and move the window.
982 * Sec 9.10.7.6.3 a) (p.138)
984 IEEE80211_NOTE(vap, IEEE80211_MSG_11N, ni,
985 "BAR moves BA win <%u:%u> (%u frames) rxseq %u tid %u",
987 IEEE80211_SEQ_ADD(rap->rxa_start, rap->rxa_wnd-1),
988 rap->rxa_qframes, rxseq, tid);
989 vap->iv_stats.is_ampdu_bar_move++;
991 ampdu_rx_flush_upto(ni, rap, rxseq);
992 if (off >= rap->rxa_wnd) {
994 * BAR specifies a window start to the right of BA
995 * window; we must move it explicitly since
996 * ampdu_rx_flush_upto will not.
998 rap->rxa_start = rxseq;
1002 * Out of range; toss.
1003 * Sec 9.10.7.6.3 b) (p.138)
1005 IEEE80211_DISCARD_MAC(vap,
1006 IEEE80211_MSG_INPUT | IEEE80211_MSG_11N, ni->ni_macaddr,
1007 "BAR", "BA win <%u:%u> (%u frames) rxseq %u tid %u%s",
1009 IEEE80211_SEQ_ADD(rap->rxa_start, rap->rxa_wnd-1),
1010 rap->rxa_qframes, rxseq, tid,
1011 wh->i_fc[1] & IEEE80211_FC1_RETRY ? " (retransmit)" : "");
1012 vap->iv_stats.is_ampdu_bar_oow++;
1013 IEEE80211_NODE_STAT(ni, rx_drop);
1018 * Setup HT-specific state in a node. Called only
1019 * when HT use is negotiated so we don't do extra
1020 * work for temporary and/or legacy sta's.
1023 ieee80211_ht_node_init(struct ieee80211_node *ni)
1025 struct ieee80211_tx_ampdu *tap;
1028 if (ni->ni_flags & IEEE80211_NODE_HT) {
1030 * Clean AMPDU state on re-associate. This handles the case
1031 * where a station leaves w/o notifying us and then returns
1032 * before node is reaped for inactivity.
1034 ieee80211_ht_node_cleanup(ni);
1036 for (tid = 0; tid < WME_NUM_TID; tid++) {
1037 tap = &ni->ni_tx_ampdu[tid];
1040 /* NB: further initialization deferred */
1042 ni->ni_flags |= IEEE80211_NODE_HT | IEEE80211_NODE_AMPDU;
1046 * Cleanup HT-specific state in a node. Called only
1047 * when HT use has been marked.
1050 ieee80211_ht_node_cleanup(struct ieee80211_node *ni)
1052 struct ieee80211com *ic = ni->ni_ic;
1055 KASSERT(ni->ni_flags & IEEE80211_NODE_HT, ("not an HT node"));
1057 /* XXX optimize this */
1058 for (i = 0; i < WME_NUM_TID; i++) {
1059 struct ieee80211_tx_ampdu *tap = &ni->ni_tx_ampdu[i];
1060 if (tap->txa_flags & IEEE80211_AGGR_SETUP)
1063 for (i = 0; i < WME_NUM_TID; i++)
1064 ic->ic_ampdu_rx_stop(ni, &ni->ni_rx_ampdu[i]);
1067 ni->ni_flags &= ~IEEE80211_NODE_HT_ALL;
1071 * Age out HT resources for a station.
1074 ieee80211_ht_node_age(struct ieee80211_node *ni)
1076 #ifdef IEEE80211_AMPDU_AGE
1077 struct ieee80211vap *vap = ni->ni_vap;
1081 KASSERT(ni->ni_flags & IEEE80211_NODE_HT, ("not an HT sta"));
1083 #ifdef IEEE80211_AMPDU_AGE
1084 for (tid = 0; tid < WME_NUM_TID; tid++) {
1085 struct ieee80211_rx_ampdu *rap;
1087 rap = &ni->ni_rx_ampdu[tid];
1088 if ((rap->rxa_flags & IEEE80211_AGGR_XCHGPEND) == 0)
1090 if (rap->rxa_qframes == 0)
1093 * Check for frames sitting too long in the reorder queue.
1094 * See above for more details on what's happening here.
1096 /* XXX honor batimeout? */
1097 if (ticks - rap->rxa_age > ieee80211_ampdu_age) {
1099 * Too long since we received the first
1100 * frame; flush the reorder buffer.
1102 vap->iv_stats.is_ampdu_rx_age += rap->rxa_qframes;
1103 ampdu_rx_flush(ni, rap);
1106 #endif /* IEEE80211_AMPDU_AGE */
1109 static struct ieee80211_channel *
1110 findhtchan(struct ieee80211com *ic, struct ieee80211_channel *c, int htflags)
1112 return ieee80211_find_channel(ic, c->ic_freq,
1113 (c->ic_flags &~ IEEE80211_CHAN_HT) | htflags);
1117 * Adjust a channel to be HT/non-HT according to the vap's configuration.
1119 struct ieee80211_channel *
1120 ieee80211_ht_adjust_channel(struct ieee80211com *ic,
1121 struct ieee80211_channel *chan, int flags)
1123 struct ieee80211_channel *c;
1125 if (flags & IEEE80211_FHT_HT) {
1126 /* promote to HT if possible */
1127 if (flags & IEEE80211_FHT_USEHT40) {
1128 if (!IEEE80211_IS_CHAN_HT40(chan)) {
1129 /* NB: arbitrarily pick ht40+ over ht40- */
1130 c = findhtchan(ic, chan, IEEE80211_CHAN_HT40U);
1132 c = findhtchan(ic, chan,
1133 IEEE80211_CHAN_HT40D);
1135 c = findhtchan(ic, chan,
1136 IEEE80211_CHAN_HT20);
1140 } else if (!IEEE80211_IS_CHAN_HT20(chan)) {
1141 c = findhtchan(ic, chan, IEEE80211_CHAN_HT20);
1145 } else if (IEEE80211_IS_CHAN_HT(chan)) {
1146 /* demote to legacy, HT use is disabled */
1147 c = ieee80211_find_channel(ic, chan->ic_freq,
1148 chan->ic_flags &~ IEEE80211_CHAN_HT);
1156 * Setup HT-specific state for a legacy WDS peer.
1159 ieee80211_ht_wds_init(struct ieee80211_node *ni)
1161 struct ieee80211vap *vap = ni->ni_vap;
1162 struct ieee80211_tx_ampdu *tap;
1165 KASSERT(vap->iv_flags_ht & IEEE80211_FHT_HT, ("no HT requested"));
1167 /* XXX check scan cache in case peer has an ap and we have info */
1169 * If setup with a legacy channel; locate an HT channel.
1170 * Otherwise if the inherited channel (from a companion
1171 * AP) is suitable use it so we use the same location
1172 * for the extension channel).
1174 ni->ni_chan = ieee80211_ht_adjust_channel(ni->ni_ic,
1175 ni->ni_chan, ieee80211_htchanflags(ni->ni_chan));
1178 if (vap->iv_flags_ht & IEEE80211_FHT_SHORTGI20)
1179 ni->ni_htcap |= IEEE80211_HTCAP_SHORTGI20;
1180 if (IEEE80211_IS_CHAN_HT40(ni->ni_chan)) {
1181 ni->ni_htcap |= IEEE80211_HTCAP_CHWIDTH40;
1183 if (IEEE80211_IS_CHAN_HT40U(ni->ni_chan))
1184 ni->ni_ht2ndchan = IEEE80211_HTINFO_2NDCHAN_ABOVE;
1185 else if (IEEE80211_IS_CHAN_HT40D(ni->ni_chan))
1186 ni->ni_ht2ndchan = IEEE80211_HTINFO_2NDCHAN_BELOW;
1187 if (vap->iv_flags_ht & IEEE80211_FHT_SHORTGI40)
1188 ni->ni_htcap |= IEEE80211_HTCAP_SHORTGI40;
1191 ni->ni_ht2ndchan = IEEE80211_HTINFO_2NDCHAN_NONE;
1193 ni->ni_htctlchan = ni->ni_chan->ic_ieee;
1194 if (vap->iv_flags_ht & IEEE80211_FHT_RIFS)
1195 ni->ni_flags |= IEEE80211_NODE_RIFS;
1196 /* XXX does it make sense to enable SMPS? */
1198 ni->ni_htopmode = 0; /* XXX need protection state */
1199 ni->ni_htstbc = 0; /* XXX need info */
1201 for (tid = 0; tid < WME_NUM_TID; tid++) {
1202 tap = &ni->ni_tx_ampdu[tid];
1205 /* NB: AMPDU tx/rx governed by IEEE80211_FHT_AMPDU_{TX,RX} */
1206 ni->ni_flags |= IEEE80211_NODE_HT | IEEE80211_NODE_AMPDU;
1210 * Notify hostap vaps of a change in the HTINFO ie.
1213 htinfo_notify(struct ieee80211com *ic)
1215 struct ieee80211vap *vap;
1218 IEEE80211_LOCK_ASSERT(ic);
1220 TAILQ_FOREACH(vap, &ic->ic_vaps, iv_next) {
1221 if (vap->iv_opmode != IEEE80211_M_HOSTAP)
1223 if (vap->iv_state != IEEE80211_S_RUN ||
1224 !IEEE80211_IS_CHAN_HT(vap->iv_bss->ni_chan))
1228 IEEE80211_MSG_ASSOC | IEEE80211_MSG_11N,
1230 "HT bss occupancy change: %d sta, %d ht, "
1231 "%d ht40%s, HT protmode now 0x%x"
1233 , ic->ic_ht_sta_assoc
1234 , ic->ic_ht40_sta_assoc
1235 , (ic->ic_flags_ht & IEEE80211_FHT_NONHT_PR) ?
1236 ", non-HT sta present" : ""
1237 , ic->ic_curhtprotmode);
1240 ieee80211_beacon_notify(vap, IEEE80211_BEACON_HTINFO);
1245 * Calculate HT protection mode from current
1246 * state and handle updates.
1249 htinfo_update(struct ieee80211com *ic)
1253 if (ic->ic_sta_assoc != ic->ic_ht_sta_assoc) {
1254 protmode = IEEE80211_HTINFO_OPMODE_MIXED
1255 | IEEE80211_HTINFO_NONHT_PRESENT;
1256 } else if (ic->ic_flags_ht & IEEE80211_FHT_NONHT_PR) {
1257 protmode = IEEE80211_HTINFO_OPMODE_PROTOPT
1258 | IEEE80211_HTINFO_NONHT_PRESENT;
1259 } else if (ic->ic_bsschan != IEEE80211_CHAN_ANYC &&
1260 IEEE80211_IS_CHAN_HT40(ic->ic_bsschan) &&
1261 ic->ic_sta_assoc != ic->ic_ht40_sta_assoc) {
1262 protmode = IEEE80211_HTINFO_OPMODE_HT20PR;
1264 protmode = IEEE80211_HTINFO_OPMODE_PURE;
1266 if (protmode != ic->ic_curhtprotmode) {
1267 ic->ic_curhtprotmode = protmode;
1273 * Handle an HT station joining a BSS.
1276 ieee80211_ht_node_join(struct ieee80211_node *ni)
1278 struct ieee80211com *ic = ni->ni_ic;
1280 IEEE80211_LOCK_ASSERT(ic);
1282 if (ni->ni_flags & IEEE80211_NODE_HT) {
1283 ic->ic_ht_sta_assoc++;
1284 if (ni->ni_chw == 40)
1285 ic->ic_ht40_sta_assoc++;
1291 * Handle an HT station leaving a BSS.
1294 ieee80211_ht_node_leave(struct ieee80211_node *ni)
1296 struct ieee80211com *ic = ni->ni_ic;
1298 IEEE80211_LOCK_ASSERT(ic);
1300 if (ni->ni_flags & IEEE80211_NODE_HT) {
1301 ic->ic_ht_sta_assoc--;
1302 if (ni->ni_chw == 40)
1303 ic->ic_ht40_sta_assoc--;
1309 * Public version of htinfo_update; used for processing
1310 * beacon frames from overlapping bss.
1312 * Caller can specify either IEEE80211_HTINFO_OPMODE_MIXED
1313 * (on receipt of a beacon that advertises MIXED) or
1314 * IEEE80211_HTINFO_OPMODE_PROTOPT (on receipt of a beacon
1315 * from an overlapping legacy bss). We treat MIXED with
1316 * a higher precedence than PROTOPT (i.e. we will not change
1317 * change PROTOPT -> MIXED; only MIXED -> PROTOPT). This
1318 * corresponds to how we handle things in htinfo_update.
1321 ieee80211_htprot_update(struct ieee80211com *ic, int protmode)
1323 #define OPMODE(x) SM(x, IEEE80211_HTINFO_OPMODE)
1326 /* track non-HT station presence */
1327 KASSERT(protmode & IEEE80211_HTINFO_NONHT_PRESENT,
1328 ("protmode 0x%x", protmode));
1329 ic->ic_flags_ht |= IEEE80211_FHT_NONHT_PR;
1330 ic->ic_lastnonht = ticks;
1332 if (protmode != ic->ic_curhtprotmode &&
1333 (OPMODE(ic->ic_curhtprotmode) != IEEE80211_HTINFO_OPMODE_MIXED ||
1334 OPMODE(protmode) == IEEE80211_HTINFO_OPMODE_PROTOPT)) {
1335 /* push beacon update */
1336 ic->ic_curhtprotmode = protmode;
1339 IEEE80211_UNLOCK(ic);
1344 * Time out presence of an overlapping bss with non-HT
1345 * stations. When operating in hostap mode we listen for
1346 * beacons from other stations and if we identify a non-HT
1347 * station is present we update the opmode field of the
1348 * HTINFO ie. To identify when all non-HT stations are
1349 * gone we time out this condition.
1352 ieee80211_ht_timeout(struct ieee80211com *ic)
1354 IEEE80211_LOCK_ASSERT(ic);
1356 if ((ic->ic_flags_ht & IEEE80211_FHT_NONHT_PR) &&
1357 time_after(ticks, ic->ic_lastnonht + IEEE80211_NONHT_PRESENT_AGE)) {
1359 IEEE80211_NOTE(vap, IEEE80211_MSG_11N, ni,
1360 "%s", "time out non-HT STA present on channel");
1362 ic->ic_flags_ht &= ~IEEE80211_FHT_NONHT_PR;
1367 /* unalligned little endian access */
1368 #define LE_READ_2(p) \
1370 ((((const uint8_t *)(p))[0] ) | \
1371 (((const uint8_t *)(p))[1] << 8)))
1374 * Process an 802.11n HT capabilities ie.
1377 ieee80211_parse_htcap(struct ieee80211_node *ni, const uint8_t *ie)
1379 if (ie[0] == IEEE80211_ELEMID_VENDOR) {
1381 * Station used Vendor OUI ie to associate;
1382 * mark the node so when we respond we'll use
1383 * the Vendor OUI's and not the standard ie's.
1385 ni->ni_flags |= IEEE80211_NODE_HTCOMPAT;
1388 ni->ni_flags &= ~IEEE80211_NODE_HTCOMPAT;
1390 ni->ni_htcap = LE_READ_2(ie +
1391 __offsetof(struct ieee80211_ie_htcap, hc_cap));
1392 ni->ni_htparam = ie[__offsetof(struct ieee80211_ie_htcap, hc_param)];
1396 htinfo_parse(struct ieee80211_node *ni,
1397 const struct ieee80211_ie_htinfo *htinfo)
1401 ni->ni_htctlchan = htinfo->hi_ctrlchannel;
1402 ni->ni_ht2ndchan = SM(htinfo->hi_byte1, IEEE80211_HTINFO_2NDCHAN);
1403 w = LE_READ_2(&htinfo->hi_byte2);
1404 ni->ni_htopmode = SM(w, IEEE80211_HTINFO_OPMODE);
1405 w = LE_READ_2(&htinfo->hi_byte45);
1406 ni->ni_htstbc = SM(w, IEEE80211_HTINFO_BASIC_STBCMCS);
1410 * Parse an 802.11n HT info ie and save useful information
1411 * to the node state. Note this does not effect any state
1412 * changes such as for channel width change.
1415 ieee80211_parse_htinfo(struct ieee80211_node *ni, const uint8_t *ie)
1417 if (ie[0] == IEEE80211_ELEMID_VENDOR)
1419 htinfo_parse(ni, (const struct ieee80211_ie_htinfo *) ie);
1423 * Handle 11n channel switch. Use the received HT ie's to
1424 * identify the right channel to use. If we cannot locate it
1425 * in the channel table then fallback to legacy operation.
1426 * Note that we use this information to identify the node's
1427 * channel only; the caller is responsible for insuring any
1428 * required channel change is done (e.g. in sta mode when
1429 * parsing the contents of a beacon frame).
1432 htinfo_update_chw(struct ieee80211_node *ni, int htflags)
1434 struct ieee80211com *ic = ni->ni_ic;
1435 struct ieee80211_channel *c;
1439 chanflags = (ni->ni_chan->ic_flags &~ IEEE80211_CHAN_HT) | htflags;
1440 if (chanflags != ni->ni_chan->ic_flags) {
1441 /* XXX not right for ht40- */
1442 c = ieee80211_find_channel(ic, ni->ni_chan->ic_freq, chanflags);
1443 if (c == NULL && (htflags & IEEE80211_CHAN_HT40)) {
1445 * No HT40 channel entry in our table; fall back
1446 * to HT20 operation. This should not happen.
1448 c = findhtchan(ic, ni->ni_chan, IEEE80211_CHAN_HT20);
1450 IEEE80211_NOTE(ni->ni_vap,
1451 IEEE80211_MSG_ASSOC | IEEE80211_MSG_11N, ni,
1452 "no HT40 channel (freq %u), falling back to HT20",
1453 ni->ni_chan->ic_freq);
1457 if (c != NULL && c != ni->ni_chan) {
1458 IEEE80211_NOTE(ni->ni_vap,
1459 IEEE80211_MSG_ASSOC | IEEE80211_MSG_11N, ni,
1460 "switch station to HT%d channel %u/0x%x",
1461 IEEE80211_IS_CHAN_HT40(c) ? 40 : 20,
1462 c->ic_freq, c->ic_flags);
1466 /* NB: caller responsible for forcing any channel change */
1468 /* update node's tx channel width */
1469 ni->ni_chw = IEEE80211_IS_CHAN_HT40(ni->ni_chan)? 40 : 20;
1474 * Update 11n MIMO PS state according to received htcap.
1477 htcap_update_mimo_ps(struct ieee80211_node *ni)
1479 uint16_t oflags = ni->ni_flags;
1481 switch (ni->ni_htcap & IEEE80211_HTCAP_SMPS) {
1482 case IEEE80211_HTCAP_SMPS_DYNAMIC:
1483 ni->ni_flags |= IEEE80211_NODE_MIMO_PS;
1484 ni->ni_flags |= IEEE80211_NODE_MIMO_RTS;
1486 case IEEE80211_HTCAP_SMPS_ENA:
1487 ni->ni_flags |= IEEE80211_NODE_MIMO_PS;
1488 ni->ni_flags &= ~IEEE80211_NODE_MIMO_RTS;
1490 case IEEE80211_HTCAP_SMPS_OFF:
1491 default: /* disable on rx of reserved value */
1492 ni->ni_flags &= ~IEEE80211_NODE_MIMO_PS;
1493 ni->ni_flags &= ~IEEE80211_NODE_MIMO_RTS;
1496 return (oflags ^ ni->ni_flags);
1500 * Update short GI state according to received htcap
1501 * and local settings.
1503 static __inline void
1504 htcap_update_shortgi(struct ieee80211_node *ni)
1506 struct ieee80211vap *vap = ni->ni_vap;
1508 ni->ni_flags &= ~(IEEE80211_NODE_SGI20|IEEE80211_NODE_SGI40);
1509 if ((ni->ni_htcap & IEEE80211_HTCAP_SHORTGI20) &&
1510 (vap->iv_flags_ht & IEEE80211_FHT_SHORTGI20))
1511 ni->ni_flags |= IEEE80211_NODE_SGI20;
1512 if ((ni->ni_htcap & IEEE80211_HTCAP_SHORTGI40) &&
1513 (vap->iv_flags_ht & IEEE80211_FHT_SHORTGI40))
1514 ni->ni_flags |= IEEE80211_NODE_SGI40;
1518 * Parse and update HT-related state extracted from
1519 * the HT cap and info ie's.
1522 ieee80211_ht_updateparams(struct ieee80211_node *ni,
1523 const uint8_t *htcapie, const uint8_t *htinfoie)
1525 struct ieee80211vap *vap = ni->ni_vap;
1526 const struct ieee80211_ie_htinfo *htinfo;
1530 ieee80211_parse_htcap(ni, htcapie);
1531 if (vap->iv_htcaps & IEEE80211_HTCAP_SMPS)
1532 htcap_update_mimo_ps(ni);
1533 htcap_update_shortgi(ni);
1535 if (htinfoie[0] == IEEE80211_ELEMID_VENDOR)
1537 htinfo = (const struct ieee80211_ie_htinfo *) htinfoie;
1538 htinfo_parse(ni, htinfo);
1540 htflags = (vap->iv_flags_ht & IEEE80211_FHT_HT) ?
1541 IEEE80211_CHAN_HT20 : 0;
1542 /* NB: honor operating mode constraint */
1543 if ((htinfo->hi_byte1 & IEEE80211_HTINFO_TXWIDTH_2040) &&
1544 (vap->iv_flags_ht & IEEE80211_FHT_USEHT40)) {
1545 if (ni->ni_ht2ndchan == IEEE80211_HTINFO_2NDCHAN_ABOVE)
1546 htflags = IEEE80211_CHAN_HT40U;
1547 else if (ni->ni_ht2ndchan == IEEE80211_HTINFO_2NDCHAN_BELOW)
1548 htflags = IEEE80211_CHAN_HT40D;
1550 if (htinfo_update_chw(ni, htflags))
1553 if ((htinfo->hi_byte1 & IEEE80211_HTINFO_RIFSMODE_PERM) &&
1554 (vap->iv_flags_ht & IEEE80211_FHT_RIFS))
1555 ni->ni_flags |= IEEE80211_NODE_RIFS;
1557 ni->ni_flags &= ~IEEE80211_NODE_RIFS;
1563 * Parse and update HT-related state extracted from the HT cap ie
1564 * for a station joining an HT BSS.
1567 ieee80211_ht_updatehtcap(struct ieee80211_node *ni, const uint8_t *htcapie)
1569 struct ieee80211vap *vap = ni->ni_vap;
1572 ieee80211_parse_htcap(ni, htcapie);
1573 if (vap->iv_htcaps & IEEE80211_HTCAP_SMPS)
1574 htcap_update_mimo_ps(ni);
1575 htcap_update_shortgi(ni);
1577 /* NB: honor operating mode constraint */
1578 /* XXX 40 MHz intolerant */
1579 htflags = (vap->iv_flags_ht & IEEE80211_FHT_HT) ?
1580 IEEE80211_CHAN_HT20 : 0;
1581 if ((ni->ni_htcap & IEEE80211_HTCAP_CHWIDTH40) &&
1582 (vap->iv_flags_ht & IEEE80211_FHT_USEHT40)) {
1583 if (IEEE80211_IS_CHAN_HT40U(vap->iv_bss->ni_chan))
1584 htflags = IEEE80211_CHAN_HT40U;
1585 else if (IEEE80211_IS_CHAN_HT40D(vap->iv_bss->ni_chan))
1586 htflags = IEEE80211_CHAN_HT40D;
1588 (void) htinfo_update_chw(ni, htflags);
1592 * Install received HT rate set by parsing the HT cap ie.
1595 ieee80211_setup_htrates(struct ieee80211_node *ni, const uint8_t *ie, int flags)
1597 struct ieee80211com *ic = ni->ni_ic;
1598 struct ieee80211vap *vap = ni->ni_vap;
1599 const struct ieee80211_ie_htcap *htcap;
1600 struct ieee80211_htrateset *rs;
1601 int i, maxequalmcs, maxunequalmcs;
1603 maxequalmcs = ic->ic_txstream * 8 - 1;
1604 if (ic->ic_htcaps & IEEE80211_HTC_TXUNEQUAL) {
1605 if (ic->ic_txstream >= 2)
1607 if (ic->ic_txstream >= 3)
1609 if (ic->ic_txstream >= 4)
1614 rs = &ni->ni_htrates;
1615 memset(rs, 0, sizeof(*rs));
1617 if (ie[0] == IEEE80211_ELEMID_VENDOR)
1619 htcap = (const struct ieee80211_ie_htcap *) ie;
1620 for (i = 0; i < IEEE80211_HTRATE_MAXSIZE; i++) {
1621 if (isclr(htcap->hc_mcsset, i))
1623 if (rs->rs_nrates == IEEE80211_HTRATE_MAXSIZE) {
1625 IEEE80211_MSG_XRATE | IEEE80211_MSG_11N, ni,
1626 "WARNING, HT rate set too large; only "
1627 "using %u rates", IEEE80211_HTRATE_MAXSIZE);
1628 vap->iv_stats.is_rx_rstoobig++;
1631 if (i <= 31 && i > maxequalmcs)
1634 (ic->ic_htcaps & IEEE80211_HTC_TXMCS32) == 0)
1636 if (i > 32 && i > maxunequalmcs)
1638 rs->rs_rates[rs->rs_nrates++] = i;
1641 return ieee80211_fix_rate(ni, (struct ieee80211_rateset *) rs, flags);
1645 * Mark rates in a node's HT rate set as basic according
1646 * to the information in the supplied HT info ie.
1649 ieee80211_setup_basic_htrates(struct ieee80211_node *ni, const uint8_t *ie)
1651 const struct ieee80211_ie_htinfo *htinfo;
1652 struct ieee80211_htrateset *rs;
1655 if (ie[0] == IEEE80211_ELEMID_VENDOR)
1657 htinfo = (const struct ieee80211_ie_htinfo *) ie;
1658 rs = &ni->ni_htrates;
1659 if (rs->rs_nrates == 0) {
1660 IEEE80211_NOTE(ni->ni_vap,
1661 IEEE80211_MSG_XRATE | IEEE80211_MSG_11N, ni,
1662 "%s", "WARNING, empty HT rate set");
1665 for (i = 0; i < IEEE80211_HTRATE_MAXSIZE; i++) {
1666 if (isclr(htinfo->hi_basicmcsset, i))
1668 for (j = 0; j < rs->rs_nrates; j++)
1669 if ((rs->rs_rates[j] & IEEE80211_RATE_VAL) == i)
1670 rs->rs_rates[j] |= IEEE80211_RATE_BASIC;
1675 ampdu_tx_setup(struct ieee80211_tx_ampdu *tap)
1677 callout_init(&tap->txa_timer, CALLOUT_MPSAFE);
1678 tap->txa_flags |= IEEE80211_AGGR_SETUP;
1682 ampdu_tx_stop(struct ieee80211_tx_ampdu *tap)
1684 struct ieee80211_node *ni = tap->txa_ni;
1685 struct ieee80211com *ic = ni->ni_ic;
1687 KASSERT(tap->txa_flags & IEEE80211_AGGR_SETUP,
1688 ("txa_flags 0x%x tid %d ac %d", tap->txa_flags, tap->txa_tid,
1689 TID_TO_WME_AC(tap->txa_tid)));
1692 * Stop BA stream if setup so driver has a chance
1693 * to reclaim any resources it might have allocated.
1695 ic->ic_addba_stop(ni, tap);
1697 * Stop any pending BAR transmit.
1699 bar_stop_timer(tap);
1701 tap->txa_lastsample = 0;
1702 tap->txa_avgpps = 0;
1703 /* NB: clearing NAK means we may re-send ADDBA */
1704 tap->txa_flags &= ~(IEEE80211_AGGR_SETUP | IEEE80211_AGGR_NAK);
1708 * ADDBA response timeout.
1710 * If software aggregation and per-TID queue management was done here,
1711 * that queue would be unpaused after the ADDBA timeout occurs.
1714 addba_timeout(void *arg)
1716 struct ieee80211_tx_ampdu *tap = arg;
1717 struct ieee80211_node *ni = tap->txa_ni;
1718 struct ieee80211com *ic = ni->ni_ic;
1721 tap->txa_flags &= ~IEEE80211_AGGR_XCHGPEND;
1722 tap->txa_attempts++;
1723 ic->ic_addba_response_timeout(ni, tap);
1727 addba_start_timeout(struct ieee80211_tx_ampdu *tap)
1729 /* XXX use CALLOUT_PENDING instead? */
1730 callout_reset(&tap->txa_timer, ieee80211_addba_timeout,
1731 addba_timeout, tap);
1732 tap->txa_flags |= IEEE80211_AGGR_XCHGPEND;
1733 tap->txa_nextrequest = ticks + ieee80211_addba_timeout;
1737 addba_stop_timeout(struct ieee80211_tx_ampdu *tap)
1739 /* XXX use CALLOUT_PENDING instead? */
1740 if (tap->txa_flags & IEEE80211_AGGR_XCHGPEND) {
1741 callout_stop(&tap->txa_timer);
1742 tap->txa_flags &= ~IEEE80211_AGGR_XCHGPEND;
1747 null_addba_response_timeout(struct ieee80211_node *ni,
1748 struct ieee80211_tx_ampdu *tap)
1753 * Default method for requesting A-MPDU tx aggregation.
1754 * We setup the specified state block and start a timer
1755 * to wait for an ADDBA response frame.
1758 ieee80211_addba_request(struct ieee80211_node *ni,
1759 struct ieee80211_tx_ampdu *tap,
1760 int dialogtoken, int baparamset, int batimeout)
1765 tap->txa_token = dialogtoken;
1766 tap->txa_flags |= IEEE80211_AGGR_IMMEDIATE;
1767 bufsiz = MS(baparamset, IEEE80211_BAPS_BUFSIZ);
1768 tap->txa_wnd = (bufsiz == 0) ?
1769 IEEE80211_AGGR_BAWMAX : min(bufsiz, IEEE80211_AGGR_BAWMAX);
1770 addba_start_timeout(tap);
1775 * Default method for processing an A-MPDU tx aggregation
1776 * response. We shutdown any pending timer and update the
1777 * state block according to the reply.
1780 ieee80211_addba_response(struct ieee80211_node *ni,
1781 struct ieee80211_tx_ampdu *tap,
1782 int status, int baparamset, int batimeout)
1787 addba_stop_timeout(tap);
1788 if (status == IEEE80211_STATUS_SUCCESS) {
1789 bufsiz = MS(baparamset, IEEE80211_BAPS_BUFSIZ);
1790 /* XXX override our request? */
1791 tap->txa_wnd = (bufsiz == 0) ?
1792 IEEE80211_AGGR_BAWMAX : min(bufsiz, IEEE80211_AGGR_BAWMAX);
1794 tid = MS(baparamset, IEEE80211_BAPS_TID);
1795 tap->txa_flags |= IEEE80211_AGGR_RUNNING;
1796 tap->txa_attempts = 0;
1798 /* mark tid so we don't try again */
1799 tap->txa_flags |= IEEE80211_AGGR_NAK;
1805 * Default method for stopping A-MPDU tx aggregation.
1806 * Any timer is cleared and we drain any pending frames.
1809 ieee80211_addba_stop(struct ieee80211_node *ni, struct ieee80211_tx_ampdu *tap)
1812 addba_stop_timeout(tap);
1813 if (tap->txa_flags & IEEE80211_AGGR_RUNNING) {
1814 /* XXX clear aggregation queue */
1815 tap->txa_flags &= ~IEEE80211_AGGR_RUNNING;
1817 tap->txa_attempts = 0;
1821 * Process a received action frame using the default aggregation
1822 * policy. We intercept ADDBA-related frames and use them to
1823 * update our aggregation state. All other frames are passed up
1824 * for processing by ieee80211_recv_action.
1827 ht_recv_action_ba_addba_request(struct ieee80211_node *ni,
1828 const struct ieee80211_frame *wh,
1829 const uint8_t *frm, const uint8_t *efrm)
1831 struct ieee80211com *ic = ni->ni_ic;
1832 struct ieee80211vap *vap = ni->ni_vap;
1833 struct ieee80211_rx_ampdu *rap;
1834 uint8_t dialogtoken;
1835 uint16_t baparamset, batimeout, baseqctl;
1839 dialogtoken = frm[2];
1840 baparamset = LE_READ_2(frm+3);
1841 batimeout = LE_READ_2(frm+5);
1842 baseqctl = LE_READ_2(frm+7);
1844 tid = MS(baparamset, IEEE80211_BAPS_TID);
1846 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
1847 "recv ADDBA request: dialogtoken %u baparamset 0x%x "
1848 "(tid %d bufsiz %d) batimeout %d baseqctl %d:%d",
1849 dialogtoken, baparamset,
1850 tid, MS(baparamset, IEEE80211_BAPS_BUFSIZ),
1852 MS(baseqctl, IEEE80211_BASEQ_START),
1853 MS(baseqctl, IEEE80211_BASEQ_FRAG));
1855 rap = &ni->ni_rx_ampdu[tid];
1857 /* Send ADDBA response */
1858 args[0] = dialogtoken;
1860 * NB: We ack only if the sta associated with HT and
1861 * the ap is configured to do AMPDU rx (the latter
1862 * violates the 11n spec and is mostly for testing).
1864 if ((ni->ni_flags & IEEE80211_NODE_AMPDU_RX) &&
1865 (vap->iv_flags_ht & IEEE80211_FHT_AMPDU_RX)) {
1866 /* XXX handle ampdu_rx_start failure */
1867 ic->ic_ampdu_rx_start(ni, rap,
1868 baparamset, batimeout, baseqctl);
1870 args[1] = IEEE80211_STATUS_SUCCESS;
1872 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
1873 ni, "reject ADDBA request: %s",
1874 ni->ni_flags & IEEE80211_NODE_AMPDU_RX ?
1875 "administratively disabled" :
1876 "not negotiated for station");
1877 vap->iv_stats.is_addba_reject++;
1878 args[1] = IEEE80211_STATUS_UNSPECIFIED;
1880 /* XXX honor rap flags? */
1881 args[2] = IEEE80211_BAPS_POLICY_IMMEDIATE
1882 | SM(tid, IEEE80211_BAPS_TID)
1883 | SM(rap->rxa_wnd, IEEE80211_BAPS_BUFSIZ)
1887 ic->ic_send_action(ni, IEEE80211_ACTION_CAT_BA,
1888 IEEE80211_ACTION_BA_ADDBA_RESPONSE, args);
1893 ht_recv_action_ba_addba_response(struct ieee80211_node *ni,
1894 const struct ieee80211_frame *wh,
1895 const uint8_t *frm, const uint8_t *efrm)
1897 struct ieee80211com *ic = ni->ni_ic;
1898 struct ieee80211vap *vap = ni->ni_vap;
1899 struct ieee80211_tx_ampdu *tap;
1900 uint8_t dialogtoken, policy;
1901 uint16_t baparamset, batimeout, code;
1904 dialogtoken = frm[2];
1905 code = LE_READ_2(frm+3);
1906 baparamset = LE_READ_2(frm+5);
1907 tid = MS(baparamset, IEEE80211_BAPS_TID);
1908 bufsiz = MS(baparamset, IEEE80211_BAPS_BUFSIZ);
1909 policy = MS(baparamset, IEEE80211_BAPS_POLICY);
1910 batimeout = LE_READ_2(frm+7);
1912 tap = &ni->ni_tx_ampdu[tid];
1913 if ((tap->txa_flags & IEEE80211_AGGR_XCHGPEND) == 0) {
1914 IEEE80211_DISCARD_MAC(vap,
1915 IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
1916 ni->ni_macaddr, "ADDBA response",
1917 "no pending ADDBA, tid %d dialogtoken %u "
1918 "code %d", tid, dialogtoken, code);
1919 vap->iv_stats.is_addba_norequest++;
1922 if (dialogtoken != tap->txa_token) {
1923 IEEE80211_DISCARD_MAC(vap,
1924 IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
1925 ni->ni_macaddr, "ADDBA response",
1926 "dialogtoken mismatch: waiting for %d, "
1927 "received %d, tid %d code %d",
1928 tap->txa_token, dialogtoken, tid, code);
1929 vap->iv_stats.is_addba_badtoken++;
1932 /* NB: assumes IEEE80211_AGGR_IMMEDIATE is 1 */
1933 if (policy != (tap->txa_flags & IEEE80211_AGGR_IMMEDIATE)) {
1934 IEEE80211_DISCARD_MAC(vap,
1935 IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
1936 ni->ni_macaddr, "ADDBA response",
1937 "policy mismatch: expecting %s, "
1938 "received %s, tid %d code %d",
1939 tap->txa_flags & IEEE80211_AGGR_IMMEDIATE,
1941 vap->iv_stats.is_addba_badpolicy++;
1945 /* XXX we take MIN in ieee80211_addba_response */
1946 if (bufsiz > IEEE80211_AGGR_BAWMAX) {
1947 IEEE80211_DISCARD_MAC(vap,
1948 IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
1949 ni->ni_macaddr, "ADDBA response",
1950 "BA window too large: max %d, "
1951 "received %d, tid %d code %d",
1952 bufsiz, IEEE80211_AGGR_BAWMAX, tid, code);
1953 vap->iv_stats.is_addba_badbawinsize++;
1957 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
1958 "recv ADDBA response: dialogtoken %u code %d "
1959 "baparamset 0x%x (tid %d bufsiz %d) batimeout %d",
1960 dialogtoken, code, baparamset, tid, bufsiz,
1962 ic->ic_addba_response(ni, tap, code, baparamset, batimeout);
1967 ht_recv_action_ba_delba(struct ieee80211_node *ni,
1968 const struct ieee80211_frame *wh,
1969 const uint8_t *frm, const uint8_t *efrm)
1971 struct ieee80211com *ic = ni->ni_ic;
1972 struct ieee80211_rx_ampdu *rap;
1973 struct ieee80211_tx_ampdu *tap;
1974 uint16_t baparamset, code;
1977 baparamset = LE_READ_2(frm+2);
1978 code = LE_READ_2(frm+4);
1980 tid = MS(baparamset, IEEE80211_DELBAPS_TID);
1982 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
1983 "recv DELBA: baparamset 0x%x (tid %d initiator %d) "
1984 "code %d", baparamset, tid,
1985 MS(baparamset, IEEE80211_DELBAPS_INIT), code);
1987 if ((baparamset & IEEE80211_DELBAPS_INIT) == 0) {
1988 tap = &ni->ni_tx_ampdu[tid];
1989 ic->ic_addba_stop(ni, tap);
1991 rap = &ni->ni_rx_ampdu[tid];
1992 ic->ic_ampdu_rx_stop(ni, rap);
1998 ht_recv_action_ht_txchwidth(struct ieee80211_node *ni,
1999 const struct ieee80211_frame *wh,
2000 const uint8_t *frm, const uint8_t *efrm)
2004 chw = (frm[2] == IEEE80211_A_HT_TXCHWIDTH_2040) ? 40 : 20;
2006 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
2007 "%s: HT txchwidth, width %d%s",
2008 __func__, chw, ni->ni_chw != chw ? "*" : "");
2009 if (chw != ni->ni_chw) {
2011 /* XXX notify on change */
2017 ht_recv_action_ht_mimopwrsave(struct ieee80211_node *ni,
2018 const struct ieee80211_frame *wh,
2019 const uint8_t *frm, const uint8_t *efrm)
2021 const struct ieee80211_action_ht_mimopowersave *mps =
2022 (const struct ieee80211_action_ht_mimopowersave *) frm;
2024 /* XXX check iv_htcaps */
2025 if (mps->am_control & IEEE80211_A_HT_MIMOPWRSAVE_ENA)
2026 ni->ni_flags |= IEEE80211_NODE_MIMO_PS;
2028 ni->ni_flags &= ~IEEE80211_NODE_MIMO_PS;
2029 if (mps->am_control & IEEE80211_A_HT_MIMOPWRSAVE_MODE)
2030 ni->ni_flags |= IEEE80211_NODE_MIMO_RTS;
2032 ni->ni_flags &= ~IEEE80211_NODE_MIMO_RTS;
2033 /* XXX notify on change */
2034 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
2035 "%s: HT MIMO PS (%s%s)", __func__,
2036 (ni->ni_flags & IEEE80211_NODE_MIMO_PS) ? "on" : "off",
2037 (ni->ni_flags & IEEE80211_NODE_MIMO_RTS) ? "+rts" : ""
2043 * Transmit processing.
2047 * Check if A-MPDU should be requested/enabled for a stream.
2048 * We require a traffic rate above a per-AC threshold and we
2049 * also handle backoff from previous failed attempts.
2051 * Drivers may override this method to bring in information
2052 * such as link state conditions in making the decision.
2055 ieee80211_ampdu_enable(struct ieee80211_node *ni,
2056 struct ieee80211_tx_ampdu *tap)
2058 struct ieee80211vap *vap = ni->ni_vap;
2060 if (tap->txa_avgpps <
2061 vap->iv_ampdu_mintraffic[TID_TO_WME_AC(tap->txa_tid)])
2063 /* XXX check rssi? */
2064 if (tap->txa_attempts >= ieee80211_addba_maxtries &&
2065 ticks < tap->txa_nextrequest) {
2067 * Don't retry too often; txa_nextrequest is set
2068 * to the minimum interval we'll retry after
2069 * ieee80211_addba_maxtries failed attempts are made.
2073 IEEE80211_NOTE(vap, IEEE80211_MSG_11N, ni,
2074 "enable AMPDU on tid %d (%s), avgpps %d pkts %d",
2075 tap->txa_tid, ieee80211_wme_acnames[TID_TO_WME_AC(tap->txa_tid)],
2076 tap->txa_avgpps, tap->txa_pkts);
2081 * Request A-MPDU tx aggregation. Setup local state and
2082 * issue an ADDBA request. BA use will only happen after
2083 * the other end replies with ADDBA response.
2086 ieee80211_ampdu_request(struct ieee80211_node *ni,
2087 struct ieee80211_tx_ampdu *tap)
2089 struct ieee80211com *ic = ni->ni_ic;
2091 int tid, dialogtoken;
2092 static int tokens = 0; /* XXX */
2095 if ((tap->txa_flags & IEEE80211_AGGR_SETUP) == 0) {
2096 /* do deferred setup of state */
2097 ampdu_tx_setup(tap);
2099 /* XXX hack for not doing proper locking */
2100 tap->txa_flags &= ~IEEE80211_AGGR_NAK;
2102 dialogtoken = (tokens+1) % 63; /* XXX */
2104 tap->txa_start = ni->ni_txseqs[tid];
2106 args[0] = dialogtoken;
2107 args[1] = 0; /* NB: status code not used */
2108 args[2] = IEEE80211_BAPS_POLICY_IMMEDIATE
2109 | SM(tid, IEEE80211_BAPS_TID)
2110 | SM(IEEE80211_AGGR_BAWMAX, IEEE80211_BAPS_BUFSIZ)
2112 args[3] = 0; /* batimeout */
2113 /* NB: do first so there's no race against reply */
2114 if (!ic->ic_addba_request(ni, tap, dialogtoken, args[2], args[3])) {
2115 /* unable to setup state, don't make request */
2116 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_11N,
2117 ni, "%s: could not setup BA stream for TID %d AC %d",
2118 __func__, tap->txa_tid, TID_TO_WME_AC(tap->txa_tid));
2119 /* defer next try so we don't slam the driver with requests */
2120 tap->txa_attempts = ieee80211_addba_maxtries;
2121 /* NB: check in case driver wants to override */
2122 if (tap->txa_nextrequest <= ticks)
2123 tap->txa_nextrequest = ticks + ieee80211_addba_backoff;
2126 tokens = dialogtoken; /* allocate token */
2127 /* NB: after calling ic_addba_request so driver can set txa_start */
2128 args[4] = SM(tap->txa_start, IEEE80211_BASEQ_START)
2129 | SM(0, IEEE80211_BASEQ_FRAG)
2131 return ic->ic_send_action(ni, IEEE80211_ACTION_CAT_BA,
2132 IEEE80211_ACTION_BA_ADDBA_REQUEST, args);
2136 * Terminate an AMPDU tx stream. State is reclaimed
2137 * and the peer notified with a DelBA Action frame.
2140 ieee80211_ampdu_stop(struct ieee80211_node *ni, struct ieee80211_tx_ampdu *tap,
2143 struct ieee80211com *ic = ni->ni_ic;
2144 struct ieee80211vap *vap = ni->ni_vap;
2148 tap->txa_flags &= ~IEEE80211_AGGR_BARPEND;
2149 if (IEEE80211_AMPDU_RUNNING(tap)) {
2150 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
2151 ni, "%s: stop BA stream for TID %d (reason %d)",
2152 __func__, tap->txa_tid, reason);
2153 vap->iv_stats.is_ampdu_stop++;
2155 ic->ic_addba_stop(ni, tap);
2156 args[0] = tap->txa_tid;
2157 args[1] = IEEE80211_DELBAPS_INIT;
2158 args[2] = reason; /* XXX reason code */
2159 ic->ic_send_action(ni, IEEE80211_ACTION_CAT_BA,
2160 IEEE80211_ACTION_BA_DELBA, args);
2162 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N,
2163 ni, "%s: BA stream for TID %d not running (reason %d)",
2164 __func__, tap->txa_tid, reason);
2165 vap->iv_stats.is_ampdu_stop_failed++;
2170 bar_timeout(void *arg)
2172 struct ieee80211_tx_ampdu *tap = arg;
2173 struct ieee80211_node *ni = tap->txa_ni;
2175 KASSERT((tap->txa_flags & IEEE80211_AGGR_XCHGPEND) == 0,
2176 ("bar/addba collision, flags 0x%x", tap->txa_flags));
2178 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_11N,
2179 ni, "%s: tid %u flags 0x%x attempts %d", __func__,
2180 tap->txa_tid, tap->txa_flags, tap->txa_attempts);
2182 /* guard against race with bar_tx_complete */
2183 if ((tap->txa_flags & IEEE80211_AGGR_BARPEND) == 0)
2186 if (tap->txa_attempts >= ieee80211_bar_maxtries) {
2187 ni->ni_vap->iv_stats.is_ampdu_bar_tx_fail++;
2188 ieee80211_ampdu_stop(ni, tap, IEEE80211_REASON_TIMEOUT);
2190 ni->ni_vap->iv_stats.is_ampdu_bar_tx_retry++;
2191 ieee80211_send_bar(ni, tap, tap->txa_seqpending);
2196 bar_start_timer(struct ieee80211_tx_ampdu *tap)
2198 callout_reset(&tap->txa_timer, ieee80211_bar_timeout, bar_timeout, tap);
2202 bar_stop_timer(struct ieee80211_tx_ampdu *tap)
2204 callout_stop(&tap->txa_timer);
2208 bar_tx_complete(struct ieee80211_node *ni, void *arg, int status)
2210 struct ieee80211_tx_ampdu *tap = arg;
2212 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_11N,
2213 ni, "%s: tid %u flags 0x%x pending %d status %d",
2214 __func__, tap->txa_tid, tap->txa_flags,
2215 callout_pending(&tap->txa_timer), status);
2217 ni->ni_vap->iv_stats.is_ampdu_bar_tx++;
2219 if ((tap->txa_flags & IEEE80211_AGGR_BARPEND) &&
2220 callout_pending(&tap->txa_timer)) {
2221 struct ieee80211com *ic = ni->ni_ic;
2223 if (status == 0) /* ACK'd */
2224 bar_stop_timer(tap);
2225 ic->ic_bar_response(ni, tap, status);
2226 /* NB: just let timer expire so we pace requests */
2231 ieee80211_bar_response(struct ieee80211_node *ni,
2232 struct ieee80211_tx_ampdu *tap, int status)
2235 if (status == 0) { /* got ACK */
2236 IEEE80211_NOTE(ni->ni_vap, IEEE80211_MSG_11N,
2237 ni, "BAR moves BA win <%u:%u> (%u frames) txseq %u tid %u",
2239 IEEE80211_SEQ_ADD(tap->txa_start, tap->txa_wnd-1),
2240 tap->txa_qframes, tap->txa_seqpending,
2243 /* NB: timer already stopped in bar_tx_complete */
2244 tap->txa_start = tap->txa_seqpending;
2245 tap->txa_flags &= ~IEEE80211_AGGR_BARPEND;
2250 * Transmit a BAR frame to the specified node. The
2251 * BAR contents are drawn from the supplied aggregation
2252 * state associated with the node.
2254 * NB: we only handle immediate ACK w/ compressed bitmap.
2257 ieee80211_send_bar(struct ieee80211_node *ni,
2258 struct ieee80211_tx_ampdu *tap, ieee80211_seq seq)
2260 #define senderr(_x, _v) do { vap->iv_stats._v++; ret = _x; goto bad; } while (0)
2261 struct ieee80211vap *vap = ni->ni_vap;
2262 struct ieee80211com *ic = ni->ni_ic;
2263 struct ieee80211_frame_bar *bar;
2265 uint16_t barctl, barseqctl;
2269 if ((tap->txa_flags & IEEE80211_AGGR_RUNNING) == 0) {
2270 /* no ADDBA response, should not happen */
2275 bar_stop_timer(tap);
2277 ieee80211_ref_node(ni);
2279 m = ieee80211_getmgtframe(&frm, ic->ic_headroom, sizeof(*bar));
2281 senderr(ENOMEM, is_tx_nobuf);
2283 if (!ieee80211_add_callback(m, bar_tx_complete, tap)) {
2285 senderr(ENOMEM, is_tx_nobuf); /* XXX */
2289 bar = mtod(m, struct ieee80211_frame_bar *);
2290 bar->i_fc[0] = IEEE80211_FC0_VERSION_0 |
2291 IEEE80211_FC0_TYPE_CTL | IEEE80211_FC0_SUBTYPE_BAR;
2293 IEEE80211_ADDR_COPY(bar->i_ra, ni->ni_macaddr);
2294 IEEE80211_ADDR_COPY(bar->i_ta, vap->iv_myaddr);
2297 barctl = (tap->txa_flags & IEEE80211_AGGR_IMMEDIATE ?
2298 0 : IEEE80211_BAR_NOACK)
2299 | IEEE80211_BAR_COMP
2300 | SM(tid, IEEE80211_BAR_TID)
2302 barseqctl = SM(seq, IEEE80211_BAR_SEQ_START);
2303 /* NB: known to have proper alignment */
2304 bar->i_ctl = htole16(barctl);
2305 bar->i_seq = htole16(barseqctl);
2306 m->m_pkthdr.len = m->m_len = sizeof(struct ieee80211_frame_bar);
2308 M_WME_SETAC(m, WME_AC_VO);
2310 IEEE80211_NODE_STAT(ni, tx_mgmt); /* XXX tx_ctl? */
2313 /* init/bump attempts counter */
2314 if ((tap->txa_flags & IEEE80211_AGGR_BARPEND) == 0)
2315 tap->txa_attempts = 1;
2317 tap->txa_attempts++;
2318 tap->txa_seqpending = seq;
2319 tap->txa_flags |= IEEE80211_AGGR_BARPEND;
2321 IEEE80211_NOTE(vap, IEEE80211_MSG_DEBUG | IEEE80211_MSG_11N,
2322 ni, "send BAR: tid %u ctl 0x%x start %u (attempt %d)",
2323 tid, barctl, seq, tap->txa_attempts);
2326 * ic_raw_xmit will free the node reference
2327 * regardless of queue/TX success or failure.
2329 ret = ic->ic_raw_xmit(ni, m, NULL);
2331 /* xmit failed, clear state flag */
2332 tap->txa_flags &= ~IEEE80211_AGGR_BARPEND;
2333 vap->iv_stats.is_ampdu_bar_tx_fail++;
2336 /* XXX hack against tx complete happening before timer is started */
2337 if (tap->txa_flags & IEEE80211_AGGR_BARPEND)
2338 bar_start_timer(tap);
2341 vap->iv_stats.is_ampdu_bar_tx_fail++;
2342 ieee80211_free_node(ni);
2348 ht_action_output(struct ieee80211_node *ni, struct mbuf *m)
2350 struct ieee80211_bpf_params params;
2352 memset(¶ms, 0, sizeof(params));
2353 params.ibp_pri = WME_AC_VO;
2354 params.ibp_rate0 = ni->ni_txparms->mgmtrate;
2355 /* NB: we know all frames are unicast */
2356 params.ibp_try0 = ni->ni_txparms->maxretry;
2357 params.ibp_power = ni->ni_txpower;
2358 return ieee80211_mgmt_output(ni, m, IEEE80211_FC0_SUBTYPE_ACTION,
2362 #define ADDSHORT(frm, v) do { \
2363 frm[0] = (v) & 0xff; \
2364 frm[1] = (v) >> 8; \
2369 * Send an action management frame. The arguments are stuff
2370 * into a frame without inspection; the caller is assumed to
2371 * prepare them carefully (e.g. based on the aggregation state).
2374 ht_send_action_ba_addba(struct ieee80211_node *ni,
2375 int category, int action, void *arg0)
2377 struct ieee80211vap *vap = ni->ni_vap;
2378 struct ieee80211com *ic = ni->ni_ic;
2379 uint16_t *args = arg0;
2383 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
2384 "send ADDBA %s: dialogtoken %d status %d "
2385 "baparamset 0x%x (tid %d) batimeout 0x%x baseqctl 0x%x",
2386 (action == IEEE80211_ACTION_BA_ADDBA_REQUEST) ?
2387 "request" : "response",
2388 args[0], args[1], args[2], MS(args[2], IEEE80211_BAPS_TID),
2391 IEEE80211_DPRINTF(vap, IEEE80211_MSG_NODE,
2392 "ieee80211_ref_node (%s:%u) %p<%s> refcnt %d\n", __func__, __LINE__,
2393 ni, ether_sprintf(ni->ni_macaddr), ieee80211_node_refcnt(ni)+1);
2394 ieee80211_ref_node(ni);
2396 m = ieee80211_getmgtframe(&frm,
2397 ic->ic_headroom + sizeof(struct ieee80211_frame),
2398 sizeof(uint16_t) /* action+category */
2399 /* XXX may action payload */
2400 + sizeof(struct ieee80211_action_ba_addbaresponse)
2405 *frm++ = args[0]; /* dialog token */
2406 if (action == IEEE80211_ACTION_BA_ADDBA_RESPONSE)
2407 ADDSHORT(frm, args[1]); /* status code */
2408 ADDSHORT(frm, args[2]); /* baparamset */
2409 ADDSHORT(frm, args[3]); /* batimeout */
2410 if (action == IEEE80211_ACTION_BA_ADDBA_REQUEST)
2411 ADDSHORT(frm, args[4]); /* baseqctl */
2412 m->m_pkthdr.len = m->m_len = frm - mtod(m, uint8_t *);
2413 return ht_action_output(ni, m);
2415 vap->iv_stats.is_tx_nobuf++;
2416 ieee80211_free_node(ni);
2422 ht_send_action_ba_delba(struct ieee80211_node *ni,
2423 int category, int action, void *arg0)
2425 struct ieee80211vap *vap = ni->ni_vap;
2426 struct ieee80211com *ic = ni->ni_ic;
2427 uint16_t *args = arg0;
2429 uint16_t baparamset;
2432 baparamset = SM(args[0], IEEE80211_DELBAPS_TID)
2435 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
2436 "send DELBA action: tid %d, initiator %d reason %d",
2437 args[0], args[1], args[2]);
2439 IEEE80211_DPRINTF(vap, IEEE80211_MSG_NODE,
2440 "ieee80211_ref_node (%s:%u) %p<%s> refcnt %d\n", __func__, __LINE__,
2441 ni, ether_sprintf(ni->ni_macaddr), ieee80211_node_refcnt(ni)+1);
2442 ieee80211_ref_node(ni);
2444 m = ieee80211_getmgtframe(&frm,
2445 ic->ic_headroom + sizeof(struct ieee80211_frame),
2446 sizeof(uint16_t) /* action+category */
2447 /* XXX may action payload */
2448 + sizeof(struct ieee80211_action_ba_addbaresponse)
2453 ADDSHORT(frm, baparamset);
2454 ADDSHORT(frm, args[2]); /* reason code */
2455 m->m_pkthdr.len = m->m_len = frm - mtod(m, uint8_t *);
2456 return ht_action_output(ni, m);
2458 vap->iv_stats.is_tx_nobuf++;
2459 ieee80211_free_node(ni);
2465 ht_send_action_ht_txchwidth(struct ieee80211_node *ni,
2466 int category, int action, void *arg0)
2468 struct ieee80211vap *vap = ni->ni_vap;
2469 struct ieee80211com *ic = ni->ni_ic;
2473 IEEE80211_NOTE(vap, IEEE80211_MSG_ACTION | IEEE80211_MSG_11N, ni,
2474 "send HT txchwidth: width %d",
2475 IEEE80211_IS_CHAN_HT40(ni->ni_chan) ? 40 : 20);
2477 IEEE80211_DPRINTF(vap, IEEE80211_MSG_NODE,
2478 "ieee80211_ref_node (%s:%u) %p<%s> refcnt %d\n", __func__, __LINE__,
2479 ni, ether_sprintf(ni->ni_macaddr), ieee80211_node_refcnt(ni)+1);
2480 ieee80211_ref_node(ni);
2482 m = ieee80211_getmgtframe(&frm,
2483 ic->ic_headroom + sizeof(struct ieee80211_frame),
2484 sizeof(uint16_t) /* action+category */
2485 /* XXX may action payload */
2486 + sizeof(struct ieee80211_action_ba_addbaresponse)
2491 *frm++ = IEEE80211_IS_CHAN_HT40(ni->ni_chan) ?
2492 IEEE80211_A_HT_TXCHWIDTH_2040 :
2493 IEEE80211_A_HT_TXCHWIDTH_20;
2494 m->m_pkthdr.len = m->m_len = frm - mtod(m, uint8_t *);
2495 return ht_action_output(ni, m);
2497 vap->iv_stats.is_tx_nobuf++;
2498 ieee80211_free_node(ni);
2505 * Construct the MCS bit mask for inclusion in an HT capabilities
2506 * information element.
2509 ieee80211_set_mcsset(struct ieee80211com *ic, uint8_t *frm)
2514 KASSERT((ic->ic_rxstream > 0 && ic->ic_rxstream <= 4),
2515 ("ic_rxstream %d out of range", ic->ic_rxstream));
2516 KASSERT((ic->ic_txstream > 0 && ic->ic_txstream <= 4),
2517 ("ic_txstream %d out of range", ic->ic_txstream));
2519 for (i = 0; i < ic->ic_rxstream * 8; i++)
2521 if ((ic->ic_htcaps & IEEE80211_HTCAP_CHWIDTH40) &&
2522 (ic->ic_htcaps & IEEE80211_HTC_RXMCS32))
2524 if (ic->ic_htcaps & IEEE80211_HTC_RXUNEQUAL) {
2525 if (ic->ic_rxstream >= 2) {
2526 for (i = 33; i <= 38; i++)
2529 if (ic->ic_rxstream >= 3) {
2530 for (i = 39; i <= 52; i++)
2533 if (ic->ic_txstream >= 4) {
2534 for (i = 53; i <= 76; i++)
2539 if (ic->ic_rxstream != ic->ic_txstream) {
2540 txparams = 0x1; /* TX MCS set defined */
2541 txparams |= 0x2; /* TX RX MCS not equal */
2542 txparams |= (ic->ic_txstream - 1) << 2; /* num TX streams */
2543 if (ic->ic_htcaps & IEEE80211_HTC_TXUNEQUAL)
2544 txparams |= 0x16; /* TX unequal modulation sup */
2551 * Add body of an HTCAP information element.
2554 ieee80211_add_htcap_body(uint8_t *frm, struct ieee80211_node *ni)
2556 #define ADDSHORT(frm, v) do { \
2557 frm[0] = (v) & 0xff; \
2558 frm[1] = (v) >> 8; \
2561 struct ieee80211com *ic = ni->ni_ic;
2562 struct ieee80211vap *vap = ni->ni_vap;
2563 uint16_t caps, extcaps;
2566 /* HT capabilities */
2567 caps = vap->iv_htcaps & 0xffff;
2569 * Note channel width depends on whether we are operating as
2570 * a sta or not. When operating as a sta we are generating
2571 * a request based on our desired configuration. Otherwise
2572 * we are operational and the channel attributes identify
2573 * how we've been setup (which might be different if a fixed
2574 * channel is specified).
2576 if (vap->iv_opmode == IEEE80211_M_STA) {
2577 /* override 20/40 use based on config */
2578 if (vap->iv_flags_ht & IEEE80211_FHT_USEHT40)
2579 caps |= IEEE80211_HTCAP_CHWIDTH40;
2581 caps &= ~IEEE80211_HTCAP_CHWIDTH40;
2582 /* use advertised setting (XXX locally constraint) */
2583 rxmax = MS(ni->ni_htparam, IEEE80211_HTCAP_MAXRXAMPDU);
2584 density = MS(ni->ni_htparam, IEEE80211_HTCAP_MPDUDENSITY);
2587 * NB: Hardware might support HT40 on some but not all
2588 * channels. We can't determine this earlier because only
2589 * after association the channel is upgraded to HT based
2590 * on the negotiated capabilities.
2592 if (ni->ni_chan != IEEE80211_CHAN_ANYC &&
2593 findhtchan(ic, ni->ni_chan, IEEE80211_CHAN_HT40U) == NULL &&
2594 findhtchan(ic, ni->ni_chan, IEEE80211_CHAN_HT40D) == NULL)
2595 caps &= ~IEEE80211_HTCAP_CHWIDTH40;
2597 /* override 20/40 use based on current channel */
2598 if (IEEE80211_IS_CHAN_HT40(ni->ni_chan))
2599 caps |= IEEE80211_HTCAP_CHWIDTH40;
2601 caps &= ~IEEE80211_HTCAP_CHWIDTH40;
2602 rxmax = vap->iv_ampdu_rxmax;
2603 density = vap->iv_ampdu_density;
2605 /* adjust short GI based on channel and config */
2606 if ((vap->iv_flags_ht & IEEE80211_FHT_SHORTGI20) == 0)
2607 caps &= ~IEEE80211_HTCAP_SHORTGI20;
2608 if ((vap->iv_flags_ht & IEEE80211_FHT_SHORTGI40) == 0 ||
2609 (caps & IEEE80211_HTCAP_CHWIDTH40) == 0)
2610 caps &= ~IEEE80211_HTCAP_SHORTGI40;
2611 ADDSHORT(frm, caps);
2614 *frm = SM(rxmax, IEEE80211_HTCAP_MAXRXAMPDU)
2615 | SM(density, IEEE80211_HTCAP_MPDUDENSITY)
2619 /* pre-zero remainder of ie */
2620 memset(frm, 0, sizeof(struct ieee80211_ie_htcap) -
2621 __offsetof(struct ieee80211_ie_htcap, hc_mcsset));
2623 /* supported MCS set */
2625 * XXX: For sta mode the rate set should be restricted based
2626 * on the AP's capabilities, but ni_htrates isn't setup when
2627 * we're called to form an AssocReq frame so for now we're
2628 * restricted to the device capabilities.
2630 ieee80211_set_mcsset(ni->ni_ic, frm);
2632 frm += __offsetof(struct ieee80211_ie_htcap, hc_extcap) -
2633 __offsetof(struct ieee80211_ie_htcap, hc_mcsset);
2635 /* HT extended capabilities */
2636 extcaps = vap->iv_htextcaps & 0xffff;
2638 ADDSHORT(frm, extcaps);
2640 frm += sizeof(struct ieee80211_ie_htcap) -
2641 __offsetof(struct ieee80211_ie_htcap, hc_txbf);
2648 * Add 802.11n HT capabilities information element
2651 ieee80211_add_htcap(uint8_t *frm, struct ieee80211_node *ni)
2653 frm[0] = IEEE80211_ELEMID_HTCAP;
2654 frm[1] = sizeof(struct ieee80211_ie_htcap) - 2;
2655 return ieee80211_add_htcap_body(frm + 2, ni);
2659 * Add Broadcom OUI wrapped standard HTCAP ie; this is
2660 * used for compatibility w/ pre-draft implementations.
2663 ieee80211_add_htcap_vendor(uint8_t *frm, struct ieee80211_node *ni)
2665 frm[0] = IEEE80211_ELEMID_VENDOR;
2666 frm[1] = 4 + sizeof(struct ieee80211_ie_htcap) - 2;
2667 frm[2] = (BCM_OUI >> 0) & 0xff;
2668 frm[3] = (BCM_OUI >> 8) & 0xff;
2669 frm[4] = (BCM_OUI >> 16) & 0xff;
2670 frm[5] = BCM_OUI_HTCAP;
2671 return ieee80211_add_htcap_body(frm + 6, ni);
2675 * Construct the MCS bit mask of basic rates
2676 * for inclusion in an HT information element.
2679 ieee80211_set_basic_htrates(uint8_t *frm, const struct ieee80211_htrateset *rs)
2683 for (i = 0; i < rs->rs_nrates; i++) {
2684 int r = rs->rs_rates[i] & IEEE80211_RATE_VAL;
2685 if ((rs->rs_rates[i] & IEEE80211_RATE_BASIC) &&
2686 r < IEEE80211_HTRATE_MAXSIZE) {
2687 /* NB: this assumes a particular implementation */
2694 * Update the HTINFO ie for a beacon frame.
2697 ieee80211_ht_update_beacon(struct ieee80211vap *vap,
2698 struct ieee80211_beacon_offsets *bo)
2700 #define PROTMODE (IEEE80211_HTINFO_OPMODE|IEEE80211_HTINFO_NONHT_PRESENT)
2701 const struct ieee80211_channel *bsschan = vap->iv_bss->ni_chan;
2702 struct ieee80211com *ic = vap->iv_ic;
2703 struct ieee80211_ie_htinfo *ht =
2704 (struct ieee80211_ie_htinfo *) bo->bo_htinfo;
2706 /* XXX only update on channel change */
2707 ht->hi_ctrlchannel = ieee80211_chan2ieee(ic, bsschan);
2708 if (vap->iv_flags_ht & IEEE80211_FHT_RIFS)
2709 ht->hi_byte1 = IEEE80211_HTINFO_RIFSMODE_PERM;
2711 ht->hi_byte1 = IEEE80211_HTINFO_RIFSMODE_PROH;
2712 if (IEEE80211_IS_CHAN_HT40U(bsschan))
2713 ht->hi_byte1 |= IEEE80211_HTINFO_2NDCHAN_ABOVE;
2714 else if (IEEE80211_IS_CHAN_HT40D(bsschan))
2715 ht->hi_byte1 |= IEEE80211_HTINFO_2NDCHAN_BELOW;
2717 ht->hi_byte1 |= IEEE80211_HTINFO_2NDCHAN_NONE;
2718 if (IEEE80211_IS_CHAN_HT40(bsschan))
2719 ht->hi_byte1 |= IEEE80211_HTINFO_TXWIDTH_2040;
2721 /* protection mode */
2722 ht->hi_byte2 = (ht->hi_byte2 &~ PROTMODE) | ic->ic_curhtprotmode;
2724 /* XXX propagate to vendor ie's */
2729 * Add body of an HTINFO information element.
2731 * NB: We don't use struct ieee80211_ie_htinfo because we can
2732 * be called to fillin both a standard ie and a compat ie that
2733 * has a vendor OUI at the front.
2736 ieee80211_add_htinfo_body(uint8_t *frm, struct ieee80211_node *ni)
2738 struct ieee80211vap *vap = ni->ni_vap;
2739 struct ieee80211com *ic = ni->ni_ic;
2741 /* pre-zero remainder of ie */
2742 memset(frm, 0, sizeof(struct ieee80211_ie_htinfo) - 2);
2744 /* primary/control channel center */
2745 *frm++ = ieee80211_chan2ieee(ic, ni->ni_chan);
2747 if (vap->iv_flags_ht & IEEE80211_FHT_RIFS)
2748 frm[0] = IEEE80211_HTINFO_RIFSMODE_PERM;
2750 frm[0] = IEEE80211_HTINFO_RIFSMODE_PROH;
2751 if (IEEE80211_IS_CHAN_HT40U(ni->ni_chan))
2752 frm[0] |= IEEE80211_HTINFO_2NDCHAN_ABOVE;
2753 else if (IEEE80211_IS_CHAN_HT40D(ni->ni_chan))
2754 frm[0] |= IEEE80211_HTINFO_2NDCHAN_BELOW;
2756 frm[0] |= IEEE80211_HTINFO_2NDCHAN_NONE;
2757 if (IEEE80211_IS_CHAN_HT40(ni->ni_chan))
2758 frm[0] |= IEEE80211_HTINFO_TXWIDTH_2040;
2760 frm[1] = ic->ic_curhtprotmode;
2765 ieee80211_set_basic_htrates(frm, &ni->ni_htrates);
2766 frm += sizeof(struct ieee80211_ie_htinfo) -
2767 __offsetof(struct ieee80211_ie_htinfo, hi_basicmcsset);
2772 * Add 802.11n HT information information element.
2775 ieee80211_add_htinfo(uint8_t *frm, struct ieee80211_node *ni)
2777 frm[0] = IEEE80211_ELEMID_HTINFO;
2778 frm[1] = sizeof(struct ieee80211_ie_htinfo) - 2;
2779 return ieee80211_add_htinfo_body(frm + 2, ni);
2783 * Add Broadcom OUI wrapped standard HTINFO ie; this is
2784 * used for compatibility w/ pre-draft implementations.
2787 ieee80211_add_htinfo_vendor(uint8_t *frm, struct ieee80211_node *ni)
2789 frm[0] = IEEE80211_ELEMID_VENDOR;
2790 frm[1] = 4 + sizeof(struct ieee80211_ie_htinfo) - 2;
2791 frm[2] = (BCM_OUI >> 0) & 0xff;
2792 frm[3] = (BCM_OUI >> 8) & 0xff;
2793 frm[4] = (BCM_OUI >> 16) & 0xff;
2794 frm[5] = BCM_OUI_HTINFO;
2795 return ieee80211_add_htinfo_body(frm + 6, ni);