xref: /freebsd/sys/dev/ath/if_ath_rx.c (revision f2b7bf8afcfd630e0fbd8417f1ce974de79feaf0)
1 /*-
2  * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer,
10  *    without modification.
11  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12  *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13  *    redistribution must be conditioned upon including a substantially
14  *    similar Disclaimer requirement for further binary redistribution.
15  *
16  * NO WARRANTY
17  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19  * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
20  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
21  * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
22  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
23  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
24  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
25  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
26  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
27  * THE POSSIBILITY OF SUCH DAMAGES.
28  */
29 
30 #include <sys/cdefs.h>
31 __FBSDID("$FreeBSD$");
32 
33 /*
34  * Driver for the Atheros Wireless LAN controller.
35  *
36  * This software is derived from work of Atsushi Onoe; his contribution
37  * is greatly appreciated.
38  */
39 
40 #include "opt_inet.h"
41 #include "opt_ath.h"
42 /*
43  * This is needed for register operations which are performed
44  * by the driver - eg, calls to ath_hal_gettsf32().
45  *
46  * It's also required for any AH_DEBUG checks in here, eg the
47  * module dependencies.
48  */
49 #include "opt_ah.h"
50 #include "opt_wlan.h"
51 
52 #include <sys/param.h>
53 #include <sys/systm.h>
54 #include <sys/sysctl.h>
55 #include <sys/mbuf.h>
56 #include <sys/malloc.h>
57 #include <sys/lock.h>
58 #include <sys/mutex.h>
59 #include <sys/kernel.h>
60 #include <sys/socket.h>
61 #include <sys/sockio.h>
62 #include <sys/errno.h>
63 #include <sys/callout.h>
64 #include <sys/bus.h>
65 #include <sys/endian.h>
66 #include <sys/kthread.h>
67 #include <sys/taskqueue.h>
68 #include <sys/priv.h>
69 #include <sys/module.h>
70 #include <sys/ktr.h>
71 #include <sys/smp.h>	/* for mp_ncpus */
72 
73 #include <machine/bus.h>
74 
75 #include <net/if.h>
76 #include <net/if_var.h>
77 #include <net/if_dl.h>
78 #include <net/if_media.h>
79 #include <net/if_types.h>
80 #include <net/if_arp.h>
81 #include <net/ethernet.h>
82 #include <net/if_llc.h>
83 
84 #include <net80211/ieee80211_var.h>
85 #include <net80211/ieee80211_regdomain.h>
86 #ifdef IEEE80211_SUPPORT_SUPERG
87 #include <net80211/ieee80211_superg.h>
88 #endif
89 #ifdef IEEE80211_SUPPORT_TDMA
90 #include <net80211/ieee80211_tdma.h>
91 #endif
92 
93 #include <net/bpf.h>
94 
95 #ifdef INET
96 #include <netinet/in.h>
97 #include <netinet/if_ether.h>
98 #endif
99 
100 #include <dev/ath/if_athvar.h>
101 #include <dev/ath/ath_hal/ah_devid.h>		/* XXX for softled */
102 #include <dev/ath/ath_hal/ah_diagcodes.h>
103 
104 #include <dev/ath/if_ath_debug.h>
105 #include <dev/ath/if_ath_misc.h>
106 #include <dev/ath/if_ath_tsf.h>
107 #include <dev/ath/if_ath_tx.h>
108 #include <dev/ath/if_ath_sysctl.h>
109 #include <dev/ath/if_ath_led.h>
110 #include <dev/ath/if_ath_keycache.h>
111 #include <dev/ath/if_ath_rx.h>
112 #include <dev/ath/if_ath_beacon.h>
113 #include <dev/ath/if_athdfs.h>
114 #include <dev/ath/if_ath_descdma.h>
115 
116 #ifdef ATH_TX99_DIAG
117 #include <dev/ath/ath_tx99/ath_tx99.h>
118 #endif
119 
120 #ifdef	ATH_DEBUG_ALQ
121 #include <dev/ath/if_ath_alq.h>
122 #endif
123 
124 #include <dev/ath/if_ath_lna_div.h>
125 
126 /*
127  * Calculate the receive filter according to the
128  * operating mode and state:
129  *
130  * o always accept unicast, broadcast, and multicast traffic
131  * o accept PHY error frames when hardware doesn't have MIB support
132  *   to count and we need them for ANI (sta mode only until recently)
133  *   and we are not scanning (ANI is disabled)
134  *   NB: older hal's add rx filter bits out of sight and we need to
135  *	 blindly preserve them
136  * o probe request frames are accepted only when operating in
137  *   hostap, adhoc, mesh, or monitor modes
138  * o enable promiscuous mode
139  *   - when in monitor mode
140  *   - if interface marked PROMISC (assumes bridge setting is filtered)
141  * o accept beacons:
142  *   - when operating in station mode for collecting rssi data when
143  *     the station is otherwise quiet, or
144  *   - when operating in adhoc mode so the 802.11 layer creates
145  *     node table entries for peers,
146  *   - when scanning
147  *   - when doing s/w beacon miss (e.g. for ap+sta)
148  *   - when operating in ap mode in 11g to detect overlapping bss that
149  *     require protection
150  *   - when operating in mesh mode to detect neighbors
151  * o accept control frames:
152  *   - when in monitor mode
153  * XXX HT protection for 11n
154  */
155 u_int32_t
156 ath_calcrxfilter(struct ath_softc *sc)
157 {
158 	struct ieee80211com *ic = &sc->sc_ic;
159 	u_int32_t rfilt;
160 
161 	rfilt = HAL_RX_FILTER_UCAST | HAL_RX_FILTER_BCAST | HAL_RX_FILTER_MCAST;
162 	if (!sc->sc_needmib && !sc->sc_scanning)
163 		rfilt |= HAL_RX_FILTER_PHYERR;
164 	if (ic->ic_opmode != IEEE80211_M_STA)
165 		rfilt |= HAL_RX_FILTER_PROBEREQ;
166 	/* XXX ic->ic_monvaps != 0? */
167 	if (ic->ic_opmode == IEEE80211_M_MONITOR || ic->ic_promisc > 0)
168 		rfilt |= HAL_RX_FILTER_PROM;
169 
170 	/*
171 	 * Only listen to all beacons if we're scanning.
172 	 *
173 	 * Otherwise we only really need to hear beacons from
174 	 * our own BSSID.
175 	 *
176 	 * IBSS? software beacon miss? Just receive all beacons.
177 	 * We need to hear beacons/probe requests from everyone so
178 	 * we can merge ibss.
179 	 */
180 	if (ic->ic_opmode == IEEE80211_M_IBSS || sc->sc_swbmiss) {
181 		rfilt |= HAL_RX_FILTER_BEACON;
182 	} else if (ic->ic_opmode == IEEE80211_M_STA) {
183 		if (sc->sc_do_mybeacon && ! sc->sc_scanning) {
184 			rfilt |= HAL_RX_FILTER_MYBEACON;
185 		} else { /* scanning, non-mybeacon chips */
186 			rfilt |= HAL_RX_FILTER_BEACON;
187 		}
188 	}
189 
190 	/*
191 	 * NB: We don't recalculate the rx filter when
192 	 * ic_protmode changes; otherwise we could do
193 	 * this only when ic_protmode != NONE.
194 	 */
195 	if (ic->ic_opmode == IEEE80211_M_HOSTAP &&
196 	    IEEE80211_IS_CHAN_ANYG(ic->ic_curchan))
197 		rfilt |= HAL_RX_FILTER_BEACON;
198 
199 	/*
200 	 * Enable hardware PS-POLL RX only for hostap mode;
201 	 * STA mode sends PS-POLL frames but never
202 	 * receives them.
203 	 */
204 	if (ath_hal_getcapability(sc->sc_ah, HAL_CAP_PSPOLL,
205 	    0, NULL) == HAL_OK &&
206 	    ic->ic_opmode == IEEE80211_M_HOSTAP)
207 		rfilt |= HAL_RX_FILTER_PSPOLL;
208 
209 	if (sc->sc_nmeshvaps) {
210 		rfilt |= HAL_RX_FILTER_BEACON;
211 		if (sc->sc_hasbmatch)
212 			rfilt |= HAL_RX_FILTER_BSSID;
213 		else
214 			rfilt |= HAL_RX_FILTER_PROM;
215 	}
216 	if (ic->ic_opmode == IEEE80211_M_MONITOR)
217 		rfilt |= HAL_RX_FILTER_CONTROL;
218 
219 	/*
220 	 * Enable RX of compressed BAR frames only when doing
221 	 * 802.11n. Required for A-MPDU.
222 	 */
223 	if (IEEE80211_IS_CHAN_HT(ic->ic_curchan))
224 		rfilt |= HAL_RX_FILTER_COMPBAR;
225 
226 	/*
227 	 * Enable radar PHY errors if requested by the
228 	 * DFS module.
229 	 */
230 	if (sc->sc_dodfs)
231 		rfilt |= HAL_RX_FILTER_PHYRADAR;
232 
233 	/*
234 	 * Enable spectral PHY errors if requested by the
235 	 * spectral module.
236 	 */
237 	if (sc->sc_dospectral)
238 		rfilt |= HAL_RX_FILTER_PHYRADAR;
239 
240 	DPRINTF(sc, ATH_DEBUG_MODE, "%s: RX filter 0x%x, %s\n",
241 	    __func__, rfilt, ieee80211_opmode_name[ic->ic_opmode]);
242 	return rfilt;
243 }
244 
245 static int
246 ath_legacy_rxbuf_init(struct ath_softc *sc, struct ath_buf *bf)
247 {
248 	struct ath_hal *ah = sc->sc_ah;
249 	int error;
250 	struct mbuf *m;
251 	struct ath_desc *ds;
252 
253 	/* XXX TODO: ATH_RX_LOCK_ASSERT(sc); */
254 
255 	m = bf->bf_m;
256 	if (m == NULL) {
257 		/*
258 		 * NB: by assigning a page to the rx dma buffer we
259 		 * implicitly satisfy the Atheros requirement that
260 		 * this buffer be cache-line-aligned and sized to be
261 		 * multiple of the cache line size.  Not doing this
262 		 * causes weird stuff to happen (for the 5210 at least).
263 		 */
264 		m = m_getcl(M_NOWAIT, MT_DATA, M_PKTHDR);
265 		if (m == NULL) {
266 			DPRINTF(sc, ATH_DEBUG_ANY,
267 				"%s: no mbuf/cluster\n", __func__);
268 			sc->sc_stats.ast_rx_nombuf++;
269 			return ENOMEM;
270 		}
271 		m->m_pkthdr.len = m->m_len = m->m_ext.ext_size;
272 
273 		error = bus_dmamap_load_mbuf_sg(sc->sc_dmat,
274 					     bf->bf_dmamap, m,
275 					     bf->bf_segs, &bf->bf_nseg,
276 					     BUS_DMA_NOWAIT);
277 		if (error != 0) {
278 			DPRINTF(sc, ATH_DEBUG_ANY,
279 			    "%s: bus_dmamap_load_mbuf_sg failed; error %d\n",
280 			    __func__, error);
281 			sc->sc_stats.ast_rx_busdma++;
282 			m_freem(m);
283 			return error;
284 		}
285 		KASSERT(bf->bf_nseg == 1,
286 			("multi-segment packet; nseg %u", bf->bf_nseg));
287 		bf->bf_m = m;
288 	}
289 	bus_dmamap_sync(sc->sc_dmat, bf->bf_dmamap, BUS_DMASYNC_PREREAD);
290 
291 	/*
292 	 * Setup descriptors.  For receive we always terminate
293 	 * the descriptor list with a self-linked entry so we'll
294 	 * not get overrun under high load (as can happen with a
295 	 * 5212 when ANI processing enables PHY error frames).
296 	 *
297 	 * To insure the last descriptor is self-linked we create
298 	 * each descriptor as self-linked and add it to the end.  As
299 	 * each additional descriptor is added the previous self-linked
300 	 * entry is ``fixed'' naturally.  This should be safe even
301 	 * if DMA is happening.  When processing RX interrupts we
302 	 * never remove/process the last, self-linked, entry on the
303 	 * descriptor list.  This insures the hardware always has
304 	 * someplace to write a new frame.
305 	 */
306 	/*
307 	 * 11N: we can no longer afford to self link the last descriptor.
308 	 * MAC acknowledges BA status as long as it copies frames to host
309 	 * buffer (or rx fifo). This can incorrectly acknowledge packets
310 	 * to a sender if last desc is self-linked.
311 	 */
312 	ds = bf->bf_desc;
313 	if (sc->sc_rxslink)
314 		ds->ds_link = bf->bf_daddr;	/* link to self */
315 	else
316 		ds->ds_link = 0;		/* terminate the list */
317 	ds->ds_data = bf->bf_segs[0].ds_addr;
318 	ath_hal_setuprxdesc(ah, ds
319 		, m->m_len		/* buffer size */
320 		, 0
321 	);
322 
323 	if (sc->sc_rxlink != NULL)
324 		*sc->sc_rxlink = bf->bf_daddr;
325 	sc->sc_rxlink = &ds->ds_link;
326 	return 0;
327 }
328 
329 /*
330  * Intercept management frames to collect beacon rssi data
331  * and to do ibss merges.
332  */
333 void
334 ath_recv_mgmt(struct ieee80211_node *ni, struct mbuf *m,
335 	int subtype, const struct ieee80211_rx_stats *rxs, int rssi, int nf)
336 {
337 	struct ieee80211vap *vap = ni->ni_vap;
338 	struct ath_softc *sc = vap->iv_ic->ic_softc;
339 	uint64_t tsf_beacon_old, tsf_beacon;
340 	uint64_t nexttbtt;
341 	int64_t tsf_delta;
342 	int32_t tsf_delta_bmiss;
343 	int32_t tsf_remainder;
344 	uint64_t tsf_beacon_target;
345 	int tsf_intval;
346 
347 	tsf_beacon_old = ((uint64_t) le32dec(ni->ni_tstamp.data + 4)) << 32;
348 	tsf_beacon_old |= le32dec(ni->ni_tstamp.data);
349 
350 #define	TU_TO_TSF(_tu)	(((u_int64_t)(_tu)) << 10)
351 	tsf_intval = 1;
352 	if (ni->ni_intval > 0) {
353 		tsf_intval = TU_TO_TSF(ni->ni_intval);
354 	}
355 #undef	TU_TO_TSF
356 
357 	/*
358 	 * Call up first so subsequent work can use information
359 	 * potentially stored in the node (e.g. for ibss merge).
360 	 */
361 	ATH_VAP(vap)->av_recv_mgmt(ni, m, subtype, rxs, rssi, nf);
362 	switch (subtype) {
363 	case IEEE80211_FC0_SUBTYPE_BEACON:
364 
365 		/*
366 		 * Only do the following processing if it's for
367 		 * the current BSS.
368 		 *
369 		 * In scan and IBSS mode we receive all beacons,
370 		 * which means we need to filter out stuff
371 		 * that isn't for us or we'll end up constantly
372 		 * trying to sync / merge to BSSes that aren't
373 		 * actually us.
374 		 */
375 		if (IEEE80211_ADDR_EQ(ni->ni_bssid, vap->iv_bss->ni_bssid)) {
376 			/* update rssi statistics for use by the hal */
377 			/* XXX unlocked check against vap->iv_bss? */
378 			ATH_RSSI_LPF(sc->sc_halstats.ns_avgbrssi, rssi);
379 
380 
381 			tsf_beacon = ((uint64_t) le32dec(ni->ni_tstamp.data + 4)) << 32;
382 			tsf_beacon |= le32dec(ni->ni_tstamp.data);
383 
384 			nexttbtt = ath_hal_getnexttbtt(sc->sc_ah);
385 
386 			/*
387 			 * Let's calculate the delta and remainder, so we can see
388 			 * if the beacon timer from the AP is varying by more than
389 			 * a few TU.  (Which would be a huge, huge problem.)
390 			 */
391 			tsf_delta = (long long) tsf_beacon - (long long) tsf_beacon_old;
392 
393 			tsf_delta_bmiss = tsf_delta / tsf_intval;
394 
395 			/*
396 			 * If our delta is greater than half the beacon interval,
397 			 * let's round the bmiss value up to the next beacon
398 			 * interval.  Ie, we're running really, really early
399 			 * on the next beacon.
400 			 */
401 			if (tsf_delta % tsf_intval > (tsf_intval / 2))
402 				tsf_delta_bmiss ++;
403 
404 			tsf_beacon_target = tsf_beacon_old +
405 			    (((unsigned long long) tsf_delta_bmiss) * (long long) tsf_intval);
406 
407 			/*
408 			 * The remainder using '%' is between 0 .. intval-1.
409 			 * If we're actually running too fast, then the remainder
410 			 * will be some large number just under intval-1.
411 			 * So we need to look at whether we're running
412 			 * before or after the target beacon interval
413 			 * and if we are, modify how we do the remainder
414 			 * calculation.
415 			 */
416 			if (tsf_beacon < tsf_beacon_target) {
417 				tsf_remainder =
418 				    -(tsf_intval - ((tsf_beacon - tsf_beacon_old) % tsf_intval));
419 			} else {
420 				tsf_remainder = (tsf_beacon - tsf_beacon_old) % tsf_intval;
421 			}
422 
423 			DPRINTF(sc, ATH_DEBUG_BEACON, "%s: old_tsf=%llu (%u), new_tsf=%llu (%u), target_tsf=%llu (%u), delta=%lld, bmiss=%d, remainder=%d\n",
424 			    __func__,
425 			    (unsigned long long) tsf_beacon_old,
426 			    (unsigned int) (tsf_beacon_old >> 10),
427 			    (unsigned long long) tsf_beacon,
428 			    (unsigned int ) (tsf_beacon >> 10),
429 			    (unsigned long long) tsf_beacon_target,
430 			    (unsigned int) (tsf_beacon_target >> 10),
431 			    (long long) tsf_delta,
432 			    tsf_delta_bmiss,
433 			    tsf_remainder);
434 
435 			DPRINTF(sc, ATH_DEBUG_BEACON, "%s: tsf=%llu (%u), nexttbtt=%llu (%u), delta=%d\n",
436 			    __func__,
437 			    (unsigned long long) tsf_beacon,
438 			    (unsigned int) (tsf_beacon >> 10),
439 			    (unsigned long long) nexttbtt,
440 			    (unsigned int) (nexttbtt >> 10),
441 			    (int32_t) tsf_beacon - (int32_t) nexttbtt + tsf_intval);
442 
443 			/* We only do syncbeacon on STA VAPs; not on IBSS */
444 			if (vap->iv_opmode == IEEE80211_M_STA &&
445 			    sc->sc_syncbeacon &&
446 			    ni == vap->iv_bss &&
447 			    (vap->iv_state == IEEE80211_S_RUN || vap->iv_state == IEEE80211_S_SLEEP)) {
448 				DPRINTF(sc, ATH_DEBUG_BEACON,
449 				    "%s: syncbeacon=1; syncing\n",
450 				    __func__);
451 				/*
452 				 * Resync beacon timers using the tsf of the beacon
453 				 * frame we just received.
454 				 */
455 				ath_beacon_config(sc, vap);
456 				sc->sc_syncbeacon = 0;
457 			}
458 		}
459 
460 		/* fall thru... */
461 	case IEEE80211_FC0_SUBTYPE_PROBE_RESP:
462 		if (vap->iv_opmode == IEEE80211_M_IBSS &&
463 		    vap->iv_state == IEEE80211_S_RUN &&
464 		    ieee80211_ibss_merge_check(ni)) {
465 			uint32_t rstamp = sc->sc_lastrs->rs_tstamp;
466 			uint64_t tsf = ath_extend_tsf(sc, rstamp,
467 				ath_hal_gettsf64(sc->sc_ah));
468 			/*
469 			 * Handle ibss merge as needed; check the tsf on the
470 			 * frame before attempting the merge.  The 802.11 spec
471 			 * says the station should change it's bssid to match
472 			 * the oldest station with the same ssid, where oldest
473 			 * is determined by the tsf.  Note that hardware
474 			 * reconfiguration happens through callback to
475 			 * ath_newstate as the state machine will go from
476 			 * RUN -> RUN when this happens.
477 			 */
478 			if (le64toh(ni->ni_tstamp.tsf) >= tsf) {
479 				DPRINTF(sc, ATH_DEBUG_STATE,
480 				    "ibss merge, rstamp %u tsf %ju "
481 				    "tstamp %ju\n", rstamp, (uintmax_t)tsf,
482 				    (uintmax_t)ni->ni_tstamp.tsf);
483 				(void) ieee80211_ibss_merge(ni);
484 			}
485 		}
486 		break;
487 	}
488 }
489 
490 #ifdef	ATH_ENABLE_RADIOTAP_VENDOR_EXT
491 static void
492 ath_rx_tap_vendor(struct ath_softc *sc, struct mbuf *m,
493     const struct ath_rx_status *rs, u_int64_t tsf, int16_t nf)
494 {
495 
496 	/* Fill in the extension bitmap */
497 	sc->sc_rx_th.wr_ext_bitmap = htole32(1 << ATH_RADIOTAP_VENDOR_HEADER);
498 
499 	/* Fill in the vendor header */
500 	sc->sc_rx_th.wr_vh.vh_oui[0] = 0x7f;
501 	sc->sc_rx_th.wr_vh.vh_oui[1] = 0x03;
502 	sc->sc_rx_th.wr_vh.vh_oui[2] = 0x00;
503 
504 	/* XXX what should this be? */
505 	sc->sc_rx_th.wr_vh.vh_sub_ns = 0;
506 	sc->sc_rx_th.wr_vh.vh_skip_len =
507 	    htole16(sizeof(struct ath_radiotap_vendor_hdr));
508 
509 	/* General version info */
510 	sc->sc_rx_th.wr_v.vh_version = 1;
511 
512 	sc->sc_rx_th.wr_v.vh_rx_chainmask = sc->sc_rxchainmask;
513 
514 	/* rssi */
515 	sc->sc_rx_th.wr_v.rssi_ctl[0] = rs->rs_rssi_ctl[0];
516 	sc->sc_rx_th.wr_v.rssi_ctl[1] = rs->rs_rssi_ctl[1];
517 	sc->sc_rx_th.wr_v.rssi_ctl[2] = rs->rs_rssi_ctl[2];
518 	sc->sc_rx_th.wr_v.rssi_ext[0] = rs->rs_rssi_ext[0];
519 	sc->sc_rx_th.wr_v.rssi_ext[1] = rs->rs_rssi_ext[1];
520 	sc->sc_rx_th.wr_v.rssi_ext[2] = rs->rs_rssi_ext[2];
521 
522 	/* evm */
523 	sc->sc_rx_th.wr_v.evm[0] = rs->rs_evm0;
524 	sc->sc_rx_th.wr_v.evm[1] = rs->rs_evm1;
525 	sc->sc_rx_th.wr_v.evm[2] = rs->rs_evm2;
526 	/* These are only populated from the AR9300 or later */
527 	sc->sc_rx_th.wr_v.evm[3] = rs->rs_evm3;
528 	sc->sc_rx_th.wr_v.evm[4] = rs->rs_evm4;
529 
530 	/* direction */
531 	sc->sc_rx_th.wr_v.vh_flags = ATH_VENDOR_PKT_RX;
532 
533 	/* RX rate */
534 	sc->sc_rx_th.wr_v.vh_rx_hwrate = rs->rs_rate;
535 
536 	/* RX flags */
537 	sc->sc_rx_th.wr_v.vh_rs_flags = rs->rs_flags;
538 
539 	if (rs->rs_isaggr)
540 		sc->sc_rx_th.wr_v.vh_flags |= ATH_VENDOR_PKT_ISAGGR;
541 	if (rs->rs_moreaggr)
542 		sc->sc_rx_th.wr_v.vh_flags |= ATH_VENDOR_PKT_MOREAGGR;
543 
544 	/* phyerr info */
545 	if (rs->rs_status & HAL_RXERR_PHY) {
546 		sc->sc_rx_th.wr_v.vh_phyerr_code = rs->rs_phyerr;
547 		sc->sc_rx_th.wr_v.vh_flags |= ATH_VENDOR_PKT_RXPHYERR;
548 	} else {
549 		sc->sc_rx_th.wr_v.vh_phyerr_code = 0xff;
550 	}
551 	sc->sc_rx_th.wr_v.vh_rs_status = rs->rs_status;
552 	sc->sc_rx_th.wr_v.vh_rssi = rs->rs_rssi;
553 }
554 #endif	/* ATH_ENABLE_RADIOTAP_VENDOR_EXT */
555 
556 static void
557 ath_rx_tap(struct ath_softc *sc, struct mbuf *m,
558 	const struct ath_rx_status *rs, u_int64_t tsf, int16_t nf)
559 {
560 #define	CHAN_HT20	htole32(IEEE80211_CHAN_HT20)
561 #define	CHAN_HT40U	htole32(IEEE80211_CHAN_HT40U)
562 #define	CHAN_HT40D	htole32(IEEE80211_CHAN_HT40D)
563 #define	CHAN_HT		(CHAN_HT20|CHAN_HT40U|CHAN_HT40D)
564 	const HAL_RATE_TABLE *rt;
565 	uint8_t rix;
566 
567 	rt = sc->sc_currates;
568 	KASSERT(rt != NULL, ("no rate table, mode %u", sc->sc_curmode));
569 	rix = rt->rateCodeToIndex[rs->rs_rate];
570 	sc->sc_rx_th.wr_rate = sc->sc_hwmap[rix].ieeerate;
571 	sc->sc_rx_th.wr_flags = sc->sc_hwmap[rix].rxflags;
572 
573 	/* 802.11 specific flags */
574 	sc->sc_rx_th.wr_chan_flags &= ~CHAN_HT;
575 	if (rs->rs_status & HAL_RXERR_PHY) {
576 		/*
577 		 * PHY error - make sure the channel flags
578 		 * reflect the actual channel configuration,
579 		 * not the received frame.
580 		 */
581 		if (IEEE80211_IS_CHAN_HT40U(sc->sc_curchan))
582 			sc->sc_rx_th.wr_chan_flags |= CHAN_HT40U;
583 		else if (IEEE80211_IS_CHAN_HT40D(sc->sc_curchan))
584 			sc->sc_rx_th.wr_chan_flags |= CHAN_HT40D;
585 		else if (IEEE80211_IS_CHAN_HT20(sc->sc_curchan))
586 			sc->sc_rx_th.wr_chan_flags |= CHAN_HT20;
587 	} else if (sc->sc_rx_th.wr_rate & IEEE80211_RATE_MCS) {	/* HT rate */
588 		struct ieee80211com *ic = &sc->sc_ic;
589 
590 		if ((rs->rs_flags & HAL_RX_2040) == 0)
591 			sc->sc_rx_th.wr_chan_flags |= CHAN_HT20;
592 		else if (IEEE80211_IS_CHAN_HT40U(ic->ic_curchan))
593 			sc->sc_rx_th.wr_chan_flags |= CHAN_HT40U;
594 		else
595 			sc->sc_rx_th.wr_chan_flags |= CHAN_HT40D;
596 
597 		if (rs->rs_flags & HAL_RX_GI)
598 			sc->sc_rx_th.wr_flags |= IEEE80211_RADIOTAP_F_SHORTGI;
599 	}
600 
601 	sc->sc_rx_th.wr_tsf = htole64(ath_extend_tsf(sc, rs->rs_tstamp, tsf));
602 	if (rs->rs_status & HAL_RXERR_CRC)
603 		sc->sc_rx_th.wr_flags |= IEEE80211_RADIOTAP_F_BADFCS;
604 	/* XXX propagate other error flags from descriptor */
605 	sc->sc_rx_th.wr_antnoise = nf;
606 	sc->sc_rx_th.wr_antsignal = nf + rs->rs_rssi;
607 	sc->sc_rx_th.wr_antenna = rs->rs_antenna;
608 #undef CHAN_HT
609 #undef CHAN_HT20
610 #undef CHAN_HT40U
611 #undef CHAN_HT40D
612 }
613 
614 static void
615 ath_handle_micerror(struct ieee80211com *ic,
616 	struct ieee80211_frame *wh, int keyix)
617 {
618 	struct ieee80211_node *ni;
619 
620 	/* XXX recheck MIC to deal w/ chips that lie */
621 	/* XXX discard MIC errors on !data frames */
622 	ni = ieee80211_find_rxnode(ic, (const struct ieee80211_frame_min *) wh);
623 	if (ni != NULL) {
624 		ieee80211_notify_michael_failure(ni->ni_vap, wh, keyix);
625 		ieee80211_free_node(ni);
626 	}
627 }
628 
629 /*
630  * Process a single packet.
631  *
632  * The mbuf must already be synced, unmapped and removed from bf->bf_m
633  * by this stage.
634  *
635  * The mbuf must be consumed by this routine - either passed up the
636  * net80211 stack, put on the holding queue, or freed.
637  */
638 int
639 ath_rx_pkt(struct ath_softc *sc, struct ath_rx_status *rs, HAL_STATUS status,
640     uint64_t tsf, int nf, HAL_RX_QUEUE qtype, struct ath_buf *bf,
641     struct mbuf *m)
642 {
643 	uint64_t rstamp;
644 	/* XXX TODO: make this an mbuf tag? */
645 	struct ieee80211_rx_stats rxs;
646 	int len, type, i;
647 	struct ieee80211com *ic = &sc->sc_ic;
648 	struct ieee80211_node *ni;
649 	int is_good = 0;
650 	struct ath_rx_edma *re = &sc->sc_rxedma[qtype];
651 
652 	/*
653 	 * Calculate the correct 64 bit TSF given
654 	 * the TSF64 register value and rs_tstamp.
655 	 */
656 	rstamp = ath_extend_tsf(sc, rs->rs_tstamp, tsf);
657 
658 	/* 802.11 return codes - These aren't specifically errors */
659 	if (rs->rs_flags & HAL_RX_GI)
660 		sc->sc_stats.ast_rx_halfgi++;
661 	if (rs->rs_flags & HAL_RX_2040)
662 		sc->sc_stats.ast_rx_2040++;
663 	if (rs->rs_flags & HAL_RX_DELIM_CRC_PRE)
664 		sc->sc_stats.ast_rx_pre_crc_err++;
665 	if (rs->rs_flags & HAL_RX_DELIM_CRC_POST)
666 		sc->sc_stats.ast_rx_post_crc_err++;
667 	if (rs->rs_flags & HAL_RX_DECRYPT_BUSY)
668 		sc->sc_stats.ast_rx_decrypt_busy_err++;
669 	if (rs->rs_flags & HAL_RX_HI_RX_CHAIN)
670 		sc->sc_stats.ast_rx_hi_rx_chain++;
671 	if (rs->rs_flags & HAL_RX_STBC)
672 		sc->sc_stats.ast_rx_stbc++;
673 
674 	if (rs->rs_status != 0) {
675 		if (rs->rs_status & HAL_RXERR_CRC)
676 			sc->sc_stats.ast_rx_crcerr++;
677 		if (rs->rs_status & HAL_RXERR_FIFO)
678 			sc->sc_stats.ast_rx_fifoerr++;
679 		if (rs->rs_status & HAL_RXERR_PHY) {
680 			sc->sc_stats.ast_rx_phyerr++;
681 			/* Process DFS radar events */
682 			if ((rs->rs_phyerr == HAL_PHYERR_RADAR) ||
683 			    (rs->rs_phyerr == HAL_PHYERR_FALSE_RADAR_EXT)) {
684 				/* Now pass it to the radar processing code */
685 				ath_dfs_process_phy_err(sc, m, rstamp, rs);
686 			}
687 
688 			/* Be suitably paranoid about receiving phy errors out of the stats array bounds */
689 			if (rs->rs_phyerr < 64)
690 				sc->sc_stats.ast_rx_phy[rs->rs_phyerr]++;
691 			goto rx_error;	/* NB: don't count in ierrors */
692 		}
693 		if (rs->rs_status & HAL_RXERR_DECRYPT) {
694 			/*
695 			 * Decrypt error.  If the error occurred
696 			 * because there was no hardware key, then
697 			 * let the frame through so the upper layers
698 			 * can process it.  This is necessary for 5210
699 			 * parts which have no way to setup a ``clear''
700 			 * key cache entry.
701 			 *
702 			 * XXX do key cache faulting
703 			 */
704 			if (rs->rs_keyix == HAL_RXKEYIX_INVALID)
705 				goto rx_accept;
706 			sc->sc_stats.ast_rx_badcrypt++;
707 		}
708 		/*
709 		 * Similar as above - if the failure was a keymiss
710 		 * just punt it up to the upper layers for now.
711 		 */
712 		if (rs->rs_status & HAL_RXERR_KEYMISS) {
713 			sc->sc_stats.ast_rx_keymiss++;
714 			goto rx_accept;
715 		}
716 		if (rs->rs_status & HAL_RXERR_MIC) {
717 			sc->sc_stats.ast_rx_badmic++;
718 			/*
719 			 * Do minimal work required to hand off
720 			 * the 802.11 header for notification.
721 			 */
722 			/* XXX frag's and qos frames */
723 			len = rs->rs_datalen;
724 			if (len >= sizeof (struct ieee80211_frame)) {
725 				ath_handle_micerror(ic,
726 				    mtod(m, struct ieee80211_frame *),
727 				    sc->sc_splitmic ?
728 					rs->rs_keyix-32 : rs->rs_keyix);
729 			}
730 		}
731 		counter_u64_add(ic->ic_ierrors, 1);
732 rx_error:
733 		/*
734 		 * Cleanup any pending partial frame.
735 		 */
736 		if (re->m_rxpending != NULL) {
737 			m_freem(re->m_rxpending);
738 			re->m_rxpending = NULL;
739 		}
740 		/*
741 		 * When a tap is present pass error frames
742 		 * that have been requested.  By default we
743 		 * pass decrypt+mic errors but others may be
744 		 * interesting (e.g. crc).
745 		 */
746 		if (ieee80211_radiotap_active(ic) &&
747 		    (rs->rs_status & sc->sc_monpass)) {
748 			/* NB: bpf needs the mbuf length setup */
749 			len = rs->rs_datalen;
750 			m->m_pkthdr.len = m->m_len = len;
751 			ath_rx_tap(sc, m, rs, rstamp, nf);
752 #ifdef	ATH_ENABLE_RADIOTAP_VENDOR_EXT
753 			ath_rx_tap_vendor(sc, m, rs, rstamp, nf);
754 #endif	/* ATH_ENABLE_RADIOTAP_VENDOR_EXT */
755 			ieee80211_radiotap_rx_all(ic, m);
756 		}
757 		/* XXX pass MIC errors up for s/w reclaculation */
758 		m_freem(m); m = NULL;
759 		goto rx_next;
760 	}
761 rx_accept:
762 	len = rs->rs_datalen;
763 	m->m_len = len;
764 
765 	if (rs->rs_more) {
766 		/*
767 		 * Frame spans multiple descriptors; save
768 		 * it for the next completed descriptor, it
769 		 * will be used to construct a jumbogram.
770 		 */
771 		if (re->m_rxpending != NULL) {
772 			/* NB: max frame size is currently 2 clusters */
773 			sc->sc_stats.ast_rx_toobig++;
774 			m_freem(re->m_rxpending);
775 		}
776 		m->m_pkthdr.len = len;
777 		re->m_rxpending = m;
778 		m = NULL;
779 		goto rx_next;
780 	} else if (re->m_rxpending != NULL) {
781 		/*
782 		 * This is the second part of a jumbogram,
783 		 * chain it to the first mbuf, adjust the
784 		 * frame length, and clear the rxpending state.
785 		 */
786 		re->m_rxpending->m_next = m;
787 		re->m_rxpending->m_pkthdr.len += len;
788 		m = re->m_rxpending;
789 		re->m_rxpending = NULL;
790 	} else {
791 		/*
792 		 * Normal single-descriptor receive; setup packet length.
793 		 */
794 		m->m_pkthdr.len = len;
795 	}
796 
797 	/*
798 	 * Validate rs->rs_antenna.
799 	 *
800 	 * Some users w/ AR9285 NICs have reported crashes
801 	 * here because rs_antenna field is bogusly large.
802 	 * Let's enforce the maximum antenna limit of 8
803 	 * (and it shouldn't be hard coded, but that's a
804 	 * separate problem) and if there's an issue, print
805 	 * out an error and adjust rs_antenna to something
806 	 * sensible.
807 	 *
808 	 * This code should be removed once the actual
809 	 * root cause of the issue has been identified.
810 	 * For example, it may be that the rs_antenna
811 	 * field is only valid for the last frame of
812 	 * an aggregate and it just happens that it is
813 	 * "mostly" right. (This is a general statement -
814 	 * the majority of the statistics are only valid
815 	 * for the last frame in an aggregate.
816 	 */
817 	if (rs->rs_antenna > 7) {
818 		device_printf(sc->sc_dev, "%s: rs_antenna > 7 (%d)\n",
819 		    __func__, rs->rs_antenna);
820 #ifdef	ATH_DEBUG
821 		ath_printrxbuf(sc, bf, 0, status == HAL_OK);
822 #endif /* ATH_DEBUG */
823 		rs->rs_antenna = 0;	/* XXX better than nothing */
824 	}
825 
826 	/*
827 	 * If this is an AR9285/AR9485, then the receive and LNA
828 	 * configuration is stored in RSSI[2] / EXTRSSI[2].
829 	 * We can extract this out to build a much better
830 	 * receive antenna profile.
831 	 *
832 	 * Yes, this just blurts over the above RX antenna field
833 	 * for now.  It's fine, the AR9285 doesn't really use
834 	 * that.
835 	 *
836 	 * Later on we should store away the fine grained LNA
837 	 * information and keep separate counters just for
838 	 * that.  It'll help when debugging the AR9285/AR9485
839 	 * combined diversity code.
840 	 */
841 	if (sc->sc_rx_lnamixer) {
842 		rs->rs_antenna = 0;
843 
844 		/* Bits 0:1 - the LNA configuration used */
845 		rs->rs_antenna |=
846 		    ((rs->rs_rssi_ctl[2] & HAL_RX_LNA_CFG_USED)
847 		      >> HAL_RX_LNA_CFG_USED_S);
848 
849 		/* Bit 2 - the external RX antenna switch */
850 		if (rs->rs_rssi_ctl[2] & HAL_RX_LNA_EXTCFG)
851 			rs->rs_antenna |= 0x4;
852 	}
853 
854 	sc->sc_stats.ast_ant_rx[rs->rs_antenna]++;
855 
856 	/*
857 	 * Populate the rx status block.  When there are bpf
858 	 * listeners we do the additional work to provide
859 	 * complete status.  Otherwise we fill in only the
860 	 * material required by ieee80211_input.  Note that
861 	 * noise setting is filled in above.
862 	 */
863 	if (ieee80211_radiotap_active(ic)) {
864 		ath_rx_tap(sc, m, rs, rstamp, nf);
865 #ifdef	ATH_ENABLE_RADIOTAP_VENDOR_EXT
866 		ath_rx_tap_vendor(sc, m, rs, rstamp, nf);
867 #endif	/* ATH_ENABLE_RADIOTAP_VENDOR_EXT */
868 	}
869 
870 	/*
871 	 * From this point on we assume the frame is at least
872 	 * as large as ieee80211_frame_min; verify that.
873 	 */
874 	if (len < IEEE80211_MIN_LEN) {
875 		if (!ieee80211_radiotap_active(ic)) {
876 			DPRINTF(sc, ATH_DEBUG_RECV,
877 			    "%s: short packet %d\n", __func__, len);
878 			sc->sc_stats.ast_rx_tooshort++;
879 		} else {
880 			/* NB: in particular this captures ack's */
881 			ieee80211_radiotap_rx_all(ic, m);
882 		}
883 		m_freem(m); m = NULL;
884 		goto rx_next;
885 	}
886 
887 	if (IFF_DUMPPKTS(sc, ATH_DEBUG_RECV)) {
888 		const HAL_RATE_TABLE *rt = sc->sc_currates;
889 		uint8_t rix = rt->rateCodeToIndex[rs->rs_rate];
890 
891 		ieee80211_dump_pkt(ic, mtod(m, caddr_t), len,
892 		    sc->sc_hwmap[rix].ieeerate, rs->rs_rssi);
893 	}
894 
895 	m_adj(m, -IEEE80211_CRC_LEN);
896 
897 	/*
898 	 * Locate the node for sender, track state, and then
899 	 * pass the (referenced) node up to the 802.11 layer
900 	 * for its use.
901 	 */
902 	ni = ieee80211_find_rxnode_withkey(ic,
903 		mtod(m, const struct ieee80211_frame_min *),
904 		rs->rs_keyix == HAL_RXKEYIX_INVALID ?
905 			IEEE80211_KEYIX_NONE : rs->rs_keyix);
906 	sc->sc_lastrs = rs;
907 
908 	if (rs->rs_isaggr)
909 		sc->sc_stats.ast_rx_agg++;
910 
911 	/*
912 	 * Populate the per-chain RSSI values where appropriate.
913 	 */
914 	bzero(&rxs, sizeof(rxs));
915 	rxs.r_flags |= IEEE80211_R_NF | IEEE80211_R_RSSI |
916 	    IEEE80211_R_C_CHAIN |
917 	    IEEE80211_R_C_NF |
918 	    IEEE80211_R_C_RSSI |
919 	    IEEE80211_R_TSF64 |
920 	    IEEE80211_R_TSF_START;	/* XXX TODO: validate */
921 	rxs.c_rssi = rs->rs_rssi;
922 	rxs.c_nf = nf;
923 	rxs.c_chain = 3;	/* XXX TODO: check */
924 	rxs.c_rx_tsf = rstamp;
925 
926 	for (i = 0; i < 3; i++) {
927 		rxs.c_rssi_ctl[i] = rs->rs_rssi_ctl[i];
928 		rxs.c_rssi_ext[i] = rs->rs_rssi_ext[i];
929 		/*
930 		 * XXX note: we currently don't track
931 		 * per-chain noisefloor.
932 		 */
933 		rxs.c_nf_ctl[i] = nf;
934 		rxs.c_nf_ext[i] = nf;
935 	}
936 
937 	if (ni != NULL) {
938 		/*
939 		 * Only punt packets for ampdu reorder processing for
940 		 * 11n nodes; net80211 enforces that M_AMPDU is only
941 		 * set for 11n nodes.
942 		 */
943 		if (ni->ni_flags & IEEE80211_NODE_HT)
944 			m->m_flags |= M_AMPDU;
945 
946 		/*
947 		 * Sending station is known, dispatch directly.
948 		 */
949 		(void) ieee80211_add_rx_params(m, &rxs);
950 		type = ieee80211_input_mimo(ni, m);
951 		ieee80211_free_node(ni);
952 		m = NULL;
953 		/*
954 		 * Arrange to update the last rx timestamp only for
955 		 * frames from our ap when operating in station mode.
956 		 * This assumes the rx key is always setup when
957 		 * associated.
958 		 */
959 		if (ic->ic_opmode == IEEE80211_M_STA &&
960 		    rs->rs_keyix != HAL_RXKEYIX_INVALID)
961 			is_good = 1;
962 	} else {
963 		(void) ieee80211_add_rx_params(m, &rxs);
964 		type = ieee80211_input_mimo_all(ic, m);
965 		m = NULL;
966 	}
967 
968 	/*
969 	 * At this point we have passed the frame up the stack; thus
970 	 * the mbuf is no longer ours.
971 	 */
972 
973 	/*
974 	 * Track rx rssi and do any rx antenna management.
975 	 */
976 	ATH_RSSI_LPF(sc->sc_halstats.ns_avgrssi, rs->rs_rssi);
977 	if (sc->sc_diversity) {
978 		/*
979 		 * When using fast diversity, change the default rx
980 		 * antenna if diversity chooses the other antenna 3
981 		 * times in a row.
982 		 */
983 		if (sc->sc_defant != rs->rs_antenna) {
984 			if (++sc->sc_rxotherant >= 3)
985 				ath_setdefantenna(sc, rs->rs_antenna);
986 		} else
987 			sc->sc_rxotherant = 0;
988 	}
989 
990 	/* Handle slow diversity if enabled */
991 	if (sc->sc_dolnadiv) {
992 		ath_lna_rx_comb_scan(sc, rs, ticks, hz);
993 	}
994 
995 	if (sc->sc_softled) {
996 		/*
997 		 * Blink for any data frame.  Otherwise do a
998 		 * heartbeat-style blink when idle.  The latter
999 		 * is mainly for station mode where we depend on
1000 		 * periodic beacon frames to trigger the poll event.
1001 		 */
1002 		if (type == IEEE80211_FC0_TYPE_DATA) {
1003 			const HAL_RATE_TABLE *rt = sc->sc_currates;
1004 			ath_led_event(sc,
1005 			    rt->rateCodeToIndex[rs->rs_rate]);
1006 		} else if (ticks - sc->sc_ledevent >= sc->sc_ledidle)
1007 			ath_led_event(sc, 0);
1008 		}
1009 rx_next:
1010 	/*
1011 	 * Debugging - complain if we didn't NULL the mbuf pointer
1012 	 * here.
1013 	 */
1014 	if (m != NULL) {
1015 		device_printf(sc->sc_dev,
1016 		    "%s: mbuf %p should've been freed!\n",
1017 		    __func__,
1018 		    m);
1019 	}
1020 	return (is_good);
1021 }
1022 
1023 #define	ATH_RX_MAX		128
1024 
1025 /*
1026  * XXX TODO: break out the "get buffers" from "call ath_rx_pkt()" like
1027  * the EDMA code does.
1028  *
1029  * XXX TODO: then, do all of the RX list management stuff inside
1030  * ATH_RX_LOCK() so we don't end up potentially racing.  The EDMA
1031  * code is doing it right.
1032  */
1033 static void
1034 ath_rx_proc(struct ath_softc *sc, int resched)
1035 {
1036 #define	PA2DESC(_sc, _pa) \
1037 	((struct ath_desc *)((caddr_t)(_sc)->sc_rxdma.dd_desc + \
1038 		((_pa) - (_sc)->sc_rxdma.dd_desc_paddr)))
1039 	struct ath_buf *bf;
1040 	struct ath_hal *ah = sc->sc_ah;
1041 #ifdef IEEE80211_SUPPORT_SUPERG
1042 	struct ieee80211com *ic = &sc->sc_ic;
1043 #endif
1044 	struct ath_desc *ds;
1045 	struct ath_rx_status *rs;
1046 	struct mbuf *m;
1047 	int ngood;
1048 	HAL_STATUS status;
1049 	int16_t nf;
1050 	u_int64_t tsf;
1051 	int npkts = 0;
1052 	int kickpcu = 0;
1053 	int ret;
1054 
1055 	/* XXX we must not hold the ATH_LOCK here */
1056 	ATH_UNLOCK_ASSERT(sc);
1057 	ATH_PCU_UNLOCK_ASSERT(sc);
1058 
1059 	ATH_PCU_LOCK(sc);
1060 	sc->sc_rxproc_cnt++;
1061 	kickpcu = sc->sc_kickpcu;
1062 	ATH_PCU_UNLOCK(sc);
1063 
1064 	ATH_LOCK(sc);
1065 	ath_power_set_power_state(sc, HAL_PM_AWAKE);
1066 	ATH_UNLOCK(sc);
1067 
1068 	DPRINTF(sc, ATH_DEBUG_RX_PROC, "%s: called\n", __func__);
1069 	ngood = 0;
1070 	nf = ath_hal_getchannoise(ah, sc->sc_curchan);
1071 	sc->sc_stats.ast_rx_noise = nf;
1072 	tsf = ath_hal_gettsf64(ah);
1073 	do {
1074 		/*
1075 		 * Don't process too many packets at a time; give the
1076 		 * TX thread time to also run - otherwise the TX
1077 		 * latency can jump by quite a bit, causing throughput
1078 		 * degredation.
1079 		 */
1080 		if (!kickpcu && npkts >= ATH_RX_MAX)
1081 			break;
1082 
1083 		bf = TAILQ_FIRST(&sc->sc_rxbuf);
1084 		if (sc->sc_rxslink && bf == NULL) {	/* NB: shouldn't happen */
1085 			device_printf(sc->sc_dev, "%s: no buffer!\n", __func__);
1086 			break;
1087 		} else if (bf == NULL) {
1088 			/*
1089 			 * End of List:
1090 			 * this can happen for non-self-linked RX chains
1091 			 */
1092 			sc->sc_stats.ast_rx_hitqueueend++;
1093 			break;
1094 		}
1095 		m = bf->bf_m;
1096 		if (m == NULL) {		/* NB: shouldn't happen */
1097 			/*
1098 			 * If mbuf allocation failed previously there
1099 			 * will be no mbuf; try again to re-populate it.
1100 			 */
1101 			/* XXX make debug msg */
1102 			device_printf(sc->sc_dev, "%s: no mbuf!\n", __func__);
1103 			TAILQ_REMOVE(&sc->sc_rxbuf, bf, bf_list);
1104 			goto rx_proc_next;
1105 		}
1106 		ds = bf->bf_desc;
1107 		if (ds->ds_link == bf->bf_daddr) {
1108 			/* NB: never process the self-linked entry at the end */
1109 			sc->sc_stats.ast_rx_hitqueueend++;
1110 			break;
1111 		}
1112 		/* XXX sync descriptor memory */
1113 		/*
1114 		 * Must provide the virtual address of the current
1115 		 * descriptor, the physical address, and the virtual
1116 		 * address of the next descriptor in the h/w chain.
1117 		 * This allows the HAL to look ahead to see if the
1118 		 * hardware is done with a descriptor by checking the
1119 		 * done bit in the following descriptor and the address
1120 		 * of the current descriptor the DMA engine is working
1121 		 * on.  All this is necessary because of our use of
1122 		 * a self-linked list to avoid rx overruns.
1123 		 */
1124 		rs = &bf->bf_status.ds_rxstat;
1125 		status = ath_hal_rxprocdesc(ah, ds,
1126 				bf->bf_daddr, PA2DESC(sc, ds->ds_link), rs);
1127 #ifdef ATH_DEBUG
1128 		if (sc->sc_debug & ATH_DEBUG_RECV_DESC)
1129 			ath_printrxbuf(sc, bf, 0, status == HAL_OK);
1130 #endif
1131 
1132 #ifdef	ATH_DEBUG_ALQ
1133 		if (if_ath_alq_checkdebug(&sc->sc_alq, ATH_ALQ_EDMA_RXSTATUS))
1134 		    if_ath_alq_post(&sc->sc_alq, ATH_ALQ_EDMA_RXSTATUS,
1135 		    sc->sc_rx_statuslen, (char *) ds);
1136 #endif	/* ATH_DEBUG_ALQ */
1137 
1138 		if (status == HAL_EINPROGRESS)
1139 			break;
1140 
1141 		TAILQ_REMOVE(&sc->sc_rxbuf, bf, bf_list);
1142 		npkts++;
1143 
1144 		/*
1145 		 * Process a single frame.
1146 		 */
1147 		bus_dmamap_sync(sc->sc_dmat, bf->bf_dmamap, BUS_DMASYNC_POSTREAD);
1148 		bus_dmamap_unload(sc->sc_dmat, bf->bf_dmamap);
1149 		bf->bf_m = NULL;
1150 		if (ath_rx_pkt(sc, rs, status, tsf, nf, HAL_RX_QUEUE_HP, bf, m))
1151 			ngood++;
1152 rx_proc_next:
1153 		/*
1154 		 * If there's a holding buffer, insert that onto
1155 		 * the RX list; the hardware is now definitely not pointing
1156 		 * to it now.
1157 		 */
1158 		ret = 0;
1159 		if (sc->sc_rxedma[HAL_RX_QUEUE_HP].m_holdbf != NULL) {
1160 			TAILQ_INSERT_TAIL(&sc->sc_rxbuf,
1161 			    sc->sc_rxedma[HAL_RX_QUEUE_HP].m_holdbf,
1162 			    bf_list);
1163 			ret = ath_rxbuf_init(sc,
1164 			    sc->sc_rxedma[HAL_RX_QUEUE_HP].m_holdbf);
1165 		}
1166 		/*
1167 		 * Next, throw our buffer into the holding entry.  The hardware
1168 		 * may use the descriptor to read the link pointer before
1169 		 * DMAing the next descriptor in to write out a packet.
1170 		 */
1171 		sc->sc_rxedma[HAL_RX_QUEUE_HP].m_holdbf = bf;
1172 	} while (ret == 0);
1173 
1174 	/* rx signal state monitoring */
1175 	ath_hal_rxmonitor(ah, &sc->sc_halstats, sc->sc_curchan);
1176 	if (ngood)
1177 		sc->sc_lastrx = tsf;
1178 
1179 	ATH_KTR(sc, ATH_KTR_RXPROC, 2, "ath_rx_proc: npkts=%d, ngood=%d", npkts, ngood);
1180 	/* Queue DFS tasklet if needed */
1181 	if (resched && ath_dfs_tasklet_needed(sc, sc->sc_curchan))
1182 		taskqueue_enqueue(sc->sc_tq, &sc->sc_dfstask);
1183 
1184 	/*
1185 	 * Now that all the RX frames were handled that
1186 	 * need to be handled, kick the PCU if there's
1187 	 * been an RXEOL condition.
1188 	 */
1189 	if (resched && kickpcu) {
1190 		ATH_PCU_LOCK(sc);
1191 		ATH_KTR(sc, ATH_KTR_ERROR, 0, "ath_rx_proc: kickpcu");
1192 		device_printf(sc->sc_dev, "%s: kickpcu; handled %d packets\n",
1193 		    __func__, npkts);
1194 
1195 		/*
1196 		 * Go through the process of fully tearing down
1197 		 * the RX buffers and reinitialising them.
1198 		 *
1199 		 * There's a hardware bug that causes the RX FIFO
1200 		 * to get confused under certain conditions and
1201 		 * constantly write over the same frame, leading
1202 		 * the RX driver code here to get heavily confused.
1203 		 */
1204 		/*
1205 		 * XXX Has RX DMA stopped enough here to just call
1206 		 *     ath_startrecv()?
1207 		 * XXX Do we need to use the holding buffer to restart
1208 		 *     RX DMA by appending entries to the final
1209 		 *     descriptor?  Quite likely.
1210 		 */
1211 #if 1
1212 		ath_startrecv(sc);
1213 #else
1214 		/*
1215 		 * Disabled for now - it'd be nice to be able to do
1216 		 * this in order to limit the amount of CPU time spent
1217 		 * reinitialising the RX side (and thus minimise RX
1218 		 * drops) however there's a hardware issue that
1219 		 * causes things to get too far out of whack.
1220 		 */
1221 		/*
1222 		 * XXX can we hold the PCU lock here?
1223 		 * Are there any net80211 buffer calls involved?
1224 		 */
1225 		bf = TAILQ_FIRST(&sc->sc_rxbuf);
1226 		ath_hal_putrxbuf(ah, bf->bf_daddr, HAL_RX_QUEUE_HP);
1227 		ath_hal_rxena(ah);		/* enable recv descriptors */
1228 		ath_mode_init(sc);		/* set filters, etc. */
1229 		ath_hal_startpcurecv(ah);	/* re-enable PCU/DMA engine */
1230 #endif
1231 
1232 		ath_hal_intrset(ah, sc->sc_imask);
1233 		sc->sc_kickpcu = 0;
1234 		ATH_PCU_UNLOCK(sc);
1235 	}
1236 
1237 #ifdef IEEE80211_SUPPORT_SUPERG
1238 	if (resched)
1239 		ieee80211_ff_age_all(ic, 100);
1240 #endif
1241 
1242 	/*
1243 	 * Put the hardware to sleep again if we're done with it.
1244 	 */
1245 	ATH_LOCK(sc);
1246 	ath_power_restore_power_state(sc);
1247 	ATH_UNLOCK(sc);
1248 
1249 	/*
1250 	 * If we hit the maximum number of frames in this round,
1251 	 * reschedule for another immediate pass.  This gives
1252 	 * the TX and TX completion routines time to run, which
1253 	 * will reduce latency.
1254 	 */
1255 	if (npkts >= ATH_RX_MAX)
1256 		sc->sc_rx.recv_sched(sc, resched);
1257 
1258 	ATH_PCU_LOCK(sc);
1259 	sc->sc_rxproc_cnt--;
1260 	ATH_PCU_UNLOCK(sc);
1261 }
1262 #undef	PA2DESC
1263 #undef	ATH_RX_MAX
1264 
1265 /*
1266  * Only run the RX proc if it's not already running.
1267  * Since this may get run as part of the reset/flush path,
1268  * the task can't clash with an existing, running tasklet.
1269  */
1270 static void
1271 ath_legacy_rx_tasklet(void *arg, int npending)
1272 {
1273 	struct ath_softc *sc = arg;
1274 
1275 	ATH_KTR(sc, ATH_KTR_RXPROC, 1, "ath_rx_proc: pending=%d", npending);
1276 	DPRINTF(sc, ATH_DEBUG_RX_PROC, "%s: pending %u\n", __func__, npending);
1277 	ATH_PCU_LOCK(sc);
1278 	if (sc->sc_inreset_cnt > 0) {
1279 		device_printf(sc->sc_dev,
1280 		    "%s: sc_inreset_cnt > 0; skipping\n", __func__);
1281 		ATH_PCU_UNLOCK(sc);
1282 		return;
1283 	}
1284 	ATH_PCU_UNLOCK(sc);
1285 
1286 	ath_rx_proc(sc, 1);
1287 }
1288 
1289 static void
1290 ath_legacy_flushrecv(struct ath_softc *sc)
1291 {
1292 
1293 	ath_rx_proc(sc, 0);
1294 }
1295 
1296 static void
1297 ath_legacy_flush_rxpending(struct ath_softc *sc)
1298 {
1299 
1300 	/* XXX ATH_RX_LOCK_ASSERT(sc); */
1301 
1302 	if (sc->sc_rxedma[HAL_RX_QUEUE_LP].m_rxpending != NULL) {
1303 		m_freem(sc->sc_rxedma[HAL_RX_QUEUE_LP].m_rxpending);
1304 		sc->sc_rxedma[HAL_RX_QUEUE_LP].m_rxpending = NULL;
1305 	}
1306 	if (sc->sc_rxedma[HAL_RX_QUEUE_HP].m_rxpending != NULL) {
1307 		m_freem(sc->sc_rxedma[HAL_RX_QUEUE_HP].m_rxpending);
1308 		sc->sc_rxedma[HAL_RX_QUEUE_HP].m_rxpending = NULL;
1309 	}
1310 }
1311 
1312 static int
1313 ath_legacy_flush_rxholdbf(struct ath_softc *sc)
1314 {
1315 	struct ath_buf *bf;
1316 
1317 	/* XXX ATH_RX_LOCK_ASSERT(sc); */
1318 	/*
1319 	 * If there are RX holding buffers, free them here and return
1320 	 * them to the list.
1321 	 *
1322 	 * XXX should just verify that bf->bf_m is NULL, as it must
1323 	 * be at this point!
1324 	 */
1325 	bf = sc->sc_rxedma[HAL_RX_QUEUE_HP].m_holdbf;
1326 	if (bf != NULL) {
1327 		if (bf->bf_m != NULL)
1328 			m_freem(bf->bf_m);
1329 		bf->bf_m = NULL;
1330 		TAILQ_INSERT_TAIL(&sc->sc_rxbuf, bf, bf_list);
1331 		(void) ath_rxbuf_init(sc, bf);
1332 	}
1333 	sc->sc_rxedma[HAL_RX_QUEUE_HP].m_holdbf = NULL;
1334 
1335 	bf = sc->sc_rxedma[HAL_RX_QUEUE_LP].m_holdbf;
1336 	if (bf != NULL) {
1337 		if (bf->bf_m != NULL)
1338 			m_freem(bf->bf_m);
1339 		bf->bf_m = NULL;
1340 		TAILQ_INSERT_TAIL(&sc->sc_rxbuf, bf, bf_list);
1341 		(void) ath_rxbuf_init(sc, bf);
1342 	}
1343 	sc->sc_rxedma[HAL_RX_QUEUE_LP].m_holdbf = NULL;
1344 
1345 	return (0);
1346 }
1347 
1348 /*
1349  * Disable the receive h/w in preparation for a reset.
1350  */
1351 static void
1352 ath_legacy_stoprecv(struct ath_softc *sc, int dodelay)
1353 {
1354 #define	PA2DESC(_sc, _pa) \
1355 	((struct ath_desc *)((caddr_t)(_sc)->sc_rxdma.dd_desc + \
1356 		((_pa) - (_sc)->sc_rxdma.dd_desc_paddr)))
1357 	struct ath_hal *ah = sc->sc_ah;
1358 
1359 	ATH_RX_LOCK(sc);
1360 
1361 	ath_hal_stoppcurecv(ah);	/* disable PCU */
1362 	ath_hal_setrxfilter(ah, 0);	/* clear recv filter */
1363 	ath_hal_stopdmarecv(ah);	/* disable DMA engine */
1364 	/*
1365 	 * TODO: see if this particular DELAY() is required; it may be
1366 	 * masking some missing FIFO flush or DMA sync.
1367 	 */
1368 #if 0
1369 	if (dodelay)
1370 #endif
1371 		DELAY(3000);		/* 3ms is long enough for 1 frame */
1372 #ifdef ATH_DEBUG
1373 	if (sc->sc_debug & (ATH_DEBUG_RESET | ATH_DEBUG_FATAL)) {
1374 		struct ath_buf *bf;
1375 		u_int ix;
1376 
1377 		device_printf(sc->sc_dev,
1378 		    "%s: rx queue %p, link %p\n",
1379 		    __func__,
1380 		    (caddr_t)(uintptr_t) ath_hal_getrxbuf(ah, HAL_RX_QUEUE_HP),
1381 		    sc->sc_rxlink);
1382 		ix = 0;
1383 		TAILQ_FOREACH(bf, &sc->sc_rxbuf, bf_list) {
1384 			struct ath_desc *ds = bf->bf_desc;
1385 			struct ath_rx_status *rs = &bf->bf_status.ds_rxstat;
1386 			HAL_STATUS status = ath_hal_rxprocdesc(ah, ds,
1387 				bf->bf_daddr, PA2DESC(sc, ds->ds_link), rs);
1388 			if (status == HAL_OK || (sc->sc_debug & ATH_DEBUG_FATAL))
1389 				ath_printrxbuf(sc, bf, ix, status == HAL_OK);
1390 			ix++;
1391 		}
1392 	}
1393 #endif
1394 
1395 	(void) ath_legacy_flush_rxpending(sc);
1396 	(void) ath_legacy_flush_rxholdbf(sc);
1397 
1398 	sc->sc_rxlink = NULL;		/* just in case */
1399 
1400 	ATH_RX_UNLOCK(sc);
1401 #undef PA2DESC
1402 }
1403 
1404 /*
1405  * XXX TODO: something was calling startrecv without calling
1406  * stoprecv.  Let's figure out what/why.  It was showing up
1407  * as a mbuf leak (rxpending) and ath_buf leak (holdbf.)
1408  */
1409 
1410 /*
1411  * Enable the receive h/w following a reset.
1412  */
1413 static int
1414 ath_legacy_startrecv(struct ath_softc *sc)
1415 {
1416 	struct ath_hal *ah = sc->sc_ah;
1417 	struct ath_buf *bf;
1418 
1419 	ATH_RX_LOCK(sc);
1420 
1421 	/*
1422 	 * XXX should verify these are already all NULL!
1423 	 */
1424 	sc->sc_rxlink = NULL;
1425 	(void) ath_legacy_flush_rxpending(sc);
1426 	(void) ath_legacy_flush_rxholdbf(sc);
1427 
1428 	/*
1429 	 * Re-chain all of the buffers in the RX buffer list.
1430 	 */
1431 	TAILQ_FOREACH(bf, &sc->sc_rxbuf, bf_list) {
1432 		int error = ath_rxbuf_init(sc, bf);
1433 		if (error != 0) {
1434 			DPRINTF(sc, ATH_DEBUG_RECV,
1435 				"%s: ath_rxbuf_init failed %d\n",
1436 				__func__, error);
1437 			return error;
1438 		}
1439 	}
1440 
1441 	bf = TAILQ_FIRST(&sc->sc_rxbuf);
1442 	ath_hal_putrxbuf(ah, bf->bf_daddr, HAL_RX_QUEUE_HP);
1443 	ath_hal_rxena(ah);		/* enable recv descriptors */
1444 	ath_mode_init(sc);		/* set filters, etc. */
1445 	ath_hal_startpcurecv(ah);	/* re-enable PCU/DMA engine */
1446 
1447 	ATH_RX_UNLOCK(sc);
1448 	return 0;
1449 }
1450 
1451 static int
1452 ath_legacy_dma_rxsetup(struct ath_softc *sc)
1453 {
1454 	int error;
1455 
1456 	error = ath_descdma_setup(sc, &sc->sc_rxdma, &sc->sc_rxbuf,
1457 	    "rx", sizeof(struct ath_desc), ath_rxbuf, 1);
1458 	if (error != 0)
1459 		return (error);
1460 
1461 	return (0);
1462 }
1463 
1464 static int
1465 ath_legacy_dma_rxteardown(struct ath_softc *sc)
1466 {
1467 
1468 	if (sc->sc_rxdma.dd_desc_len != 0)
1469 		ath_descdma_cleanup(sc, &sc->sc_rxdma, &sc->sc_rxbuf);
1470 	return (0);
1471 }
1472 
1473 static void
1474 ath_legacy_recv_sched(struct ath_softc *sc, int dosched)
1475 {
1476 
1477 	taskqueue_enqueue(sc->sc_tq, &sc->sc_rxtask);
1478 }
1479 
1480 static void
1481 ath_legacy_recv_sched_queue(struct ath_softc *sc, HAL_RX_QUEUE q,
1482     int dosched)
1483 {
1484 
1485 	taskqueue_enqueue(sc->sc_tq, &sc->sc_rxtask);
1486 }
1487 
1488 void
1489 ath_recv_setup_legacy(struct ath_softc *sc)
1490 {
1491 
1492 	/* Sensible legacy defaults */
1493 	/*
1494 	 * XXX this should be changed to properly support the
1495 	 * exact RX descriptor size for each HAL.
1496 	 */
1497 	sc->sc_rx_statuslen = sizeof(struct ath_desc);
1498 
1499 	sc->sc_rx.recv_start = ath_legacy_startrecv;
1500 	sc->sc_rx.recv_stop = ath_legacy_stoprecv;
1501 	sc->sc_rx.recv_flush = ath_legacy_flushrecv;
1502 	sc->sc_rx.recv_tasklet = ath_legacy_rx_tasklet;
1503 	sc->sc_rx.recv_rxbuf_init = ath_legacy_rxbuf_init;
1504 
1505 	sc->sc_rx.recv_setup = ath_legacy_dma_rxsetup;
1506 	sc->sc_rx.recv_teardown = ath_legacy_dma_rxteardown;
1507 	sc->sc_rx.recv_sched = ath_legacy_recv_sched;
1508 	sc->sc_rx.recv_sched_queue = ath_legacy_recv_sched_queue;
1509 }
1510