2 * Copyright (c) 2008 Atheros Communications Inc.
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
20 * Setup and link descriptors.
22 * 11N: we can no longer afford to self link the last descriptor.
23 * MAC acknowledges BA status as long as it copies frames to host
24 * buffer (or rx fifo). This can incorrectly acknowledge packets
25 * to a sender if last desc is self-linked.
27 static void ath_rx_buf_link(struct ath_softc *sc, struct ath_buf *bf)
29 struct ath_hal *ah = sc->sc_ah;
36 ds->ds_link = 0; /* link to null */
37 ds->ds_data = bf->bf_buf_addr;
39 /* virtual addr of the beginning of the buffer. */
42 ds->ds_vdata = skb->data;
44 /* setup rx descriptors. The rx.bufsize here tells the harware
45 * how much data it can DMA to us and that we are prepared
47 ath9k_hw_setuprxdesc(ah, ds,
51 if (sc->rx.rxlink == NULL)
52 ath9k_hw_putrxbuf(ah, bf->bf_daddr);
54 *sc->rx.rxlink = bf->bf_daddr;
56 sc->rx.rxlink = &ds->ds_link;
60 static void ath_setdefantenna(struct ath_softc *sc, u32 antenna)
62 /* XXX block beacon interrupts */
63 ath9k_hw_setantenna(sc->sc_ah, antenna);
64 sc->rx.defant = antenna;
65 sc->rx.rxotherant = 0;
69 * Extend 15-bit time stamp from rx descriptor to
70 * a full 64-bit TSF using the current h/w TSF.
72 static u64 ath_extend_tsf(struct ath_softc *sc, u32 rstamp)
76 tsf = ath9k_hw_gettsf64(sc->sc_ah);
77 if ((tsf & 0x7fff) < rstamp)
79 return (tsf & ~0x7fff) | rstamp;
82 static struct sk_buff *ath_rxbuf_alloc(struct ath_softc *sc, u32 len)
88 * Cache-line-align. This is important (for the
89 * 5210 at least) as not doing so causes bogus data
93 /* Note: the kernel can allocate a value greater than
94 * what we ask it to give us. We really only need 4 KB as that
95 * is this hardware supports and in fact we need at least 3849
96 * as that is the MAX AMSDU size this hardware supports.
97 * Unfortunately this means we may get 8 KB here from the
98 * kernel... and that is actually what is observed on some
100 skb = dev_alloc_skb(len + sc->sc_cachelsz - 1);
102 off = ((unsigned long) skb->data) % sc->sc_cachelsz;
104 skb_reserve(skb, sc->sc_cachelsz - off);
106 DPRINTF(sc, ATH_DBG_FATAL,
107 "skbuff alloc of size %u failed\n", len);
114 static int ath_rate2idx(struct ath_softc *sc, int rate)
116 int i = 0, cur_band, n_rates;
117 struct ieee80211_hw *hw = sc->hw;
119 cur_band = hw->conf.channel->band;
120 n_rates = sc->sbands[cur_band].n_bitrates;
122 for (i = 0; i < n_rates; i++) {
123 if (sc->sbands[cur_band].bitrates[i].bitrate == rate)
128 * NB:mac80211 validates rx rate index against the supported legacy rate
129 * index only (should be done against ht rates also), return the highest
130 * legacy rate index for rx rate which does not match any one of the
131 * supported basic and extended rates to make mac80211 happy.
132 * The following hack will be cleaned up once the issue with
133 * the rx rate index validation in mac80211 is fixed.
142 * For Decrypt or Demic errors, we only mark packet status here and always push
143 * up the frame up to let mac80211 handle the actual error case, be it no
144 * decryption key or real decryption error. This let us keep statistics there.
146 static int ath_rx_prepare(struct sk_buff *skb, struct ath_desc *ds,
147 struct ieee80211_rx_status *rx_status, bool *decrypt_error,
148 struct ath_softc *sc)
150 struct ath_rate_table *rate_table = sc->cur_rate_table;
151 struct ieee80211_hdr *hdr;
156 hdr = (struct ieee80211_hdr *)skb->data;
157 fc = hdr->frame_control;
158 memset(rx_status, 0, sizeof(struct ieee80211_rx_status));
160 if (ds->ds_rxstat.rs_more) {
162 * Frame spans multiple descriptors; this cannot happen yet
163 * as we don't support jumbograms. If not in monitor mode,
164 * discard the frame. Enable this if you want to see
165 * error frames in Monitor mode.
167 if (sc->sc_ah->ah_opmode != NL80211_IFTYPE_MONITOR)
169 } else if (ds->ds_rxstat.rs_status != 0) {
170 if (ds->ds_rxstat.rs_status & ATH9K_RXERR_CRC)
171 rx_status->flag |= RX_FLAG_FAILED_FCS_CRC;
172 if (ds->ds_rxstat.rs_status & ATH9K_RXERR_PHY)
175 if (ds->ds_rxstat.rs_status & ATH9K_RXERR_DECRYPT) {
176 *decrypt_error = true;
177 } else if (ds->ds_rxstat.rs_status & ATH9K_RXERR_MIC) {
178 if (ieee80211_is_ctl(fc))
180 * Sometimes, we get invalid
181 * MIC failures on valid control frames.
182 * Remove these mic errors.
184 ds->ds_rxstat.rs_status &= ~ATH9K_RXERR_MIC;
186 rx_status->flag |= RX_FLAG_MMIC_ERROR;
189 * Reject error frames with the exception of
190 * decryption and MIC failures. For monitor mode,
191 * we also ignore the CRC error.
193 if (sc->sc_ah->ah_opmode == NL80211_IFTYPE_MONITOR) {
194 if (ds->ds_rxstat.rs_status &
195 ~(ATH9K_RXERR_DECRYPT | ATH9K_RXERR_MIC |
199 if (ds->ds_rxstat.rs_status &
200 ~(ATH9K_RXERR_DECRYPT | ATH9K_RXERR_MIC)) {
206 ratecode = ds->ds_rxstat.rs_rate;
207 rix = rate_table->rateCodeToIndex[ratecode];
208 ratekbps = rate_table->info[rix].ratekbps;
211 if (ratecode & 0x80) {
212 if (ds->ds_rxstat.rs_flags & ATH9K_RX_2040)
213 ratekbps = (ratekbps * 27) / 13;
214 if (ds->ds_rxstat.rs_flags & ATH9K_RX_GI)
215 ratekbps = (ratekbps * 10) / 9;
218 rx_status->mactime = ath_extend_tsf(sc, ds->ds_rxstat.rs_tstamp);
219 rx_status->band = sc->hw->conf.channel->band;
220 rx_status->freq = sc->hw->conf.channel->center_freq;
221 rx_status->noise = sc->sc_ani.sc_noise_floor;
222 rx_status->signal = rx_status->noise + ds->ds_rxstat.rs_rssi;
223 rx_status->rate_idx = ath_rate2idx(sc, (ratekbps / 100));
224 rx_status->antenna = ds->ds_rxstat.rs_antenna;
226 /* at 45 you will be able to use MCS 15 reliably. A more elaborate
227 * scheme can be used here but it requires tables of SNR/throughput for
228 * each possible mode used. */
229 rx_status->qual = ds->ds_rxstat.rs_rssi * 100 / 45;
231 /* rssi can be more than 45 though, anything above that
232 * should be considered at 100% */
233 if (rx_status->qual > 100)
234 rx_status->qual = 100;
236 rx_status->flag |= RX_FLAG_TSFT;
243 static void ath_opmode_init(struct ath_softc *sc)
245 struct ath_hal *ah = sc->sc_ah;
248 /* configure rx filter */
249 rfilt = ath_calcrxfilter(sc);
250 ath9k_hw_setrxfilter(ah, rfilt);
252 /* configure bssid mask */
253 if (ah->ah_caps.hw_caps & ATH9K_HW_CAP_BSSIDMASK)
254 ath9k_hw_setbssidmask(ah, sc->sc_bssidmask);
256 /* configure operational mode */
257 ath9k_hw_setopmode(ah);
259 /* Handle any link-level address change. */
260 ath9k_hw_setmac(ah, sc->sc_myaddr);
262 /* calculate and install multicast filter */
263 mfilt[0] = mfilt[1] = ~0;
264 ath9k_hw_setmcastfilter(ah, mfilt[0], mfilt[1]);
267 int ath_rx_init(struct ath_softc *sc, int nbufs)
274 spin_lock_init(&sc->rx.rxflushlock);
275 sc->sc_flags &= ~SC_OP_RXFLUSH;
276 spin_lock_init(&sc->rx.rxbuflock);
278 sc->rx.bufsize = roundup(IEEE80211_MAX_MPDU_LEN,
282 DPRINTF(sc, ATH_DBG_CONFIG, "cachelsz %u rxbufsize %u\n",
283 sc->sc_cachelsz, sc->rx.bufsize);
285 /* Initialize rx descriptors */
287 error = ath_descdma_setup(sc, &sc->rx.rxdma, &sc->rx.rxbuf,
290 DPRINTF(sc, ATH_DBG_FATAL,
291 "failed to allocate rx descriptors: %d\n", error);
295 list_for_each_entry(bf, &sc->rx.rxbuf, list) {
296 skb = ath_rxbuf_alloc(sc, sc->rx.bufsize);
303 bf->bf_buf_addr = pci_map_single(sc->pdev, skb->data,
306 if (unlikely(pci_dma_mapping_error(sc->pdev,
308 dev_kfree_skb_any(skb);
310 DPRINTF(sc, ATH_DBG_CONFIG,
311 "pci_dma_mapping_error() on RX init\n");
315 bf->bf_dmacontext = bf->bf_buf_addr;
317 sc->rx.rxlink = NULL;
327 void ath_rx_cleanup(struct ath_softc *sc)
332 list_for_each_entry(bf, &sc->rx.rxbuf, list) {
338 if (sc->rx.rxdma.dd_desc_len != 0)
339 ath_descdma_cleanup(sc, &sc->rx.rxdma, &sc->rx.rxbuf);
343 * Calculate the receive filter according to the
344 * operating mode and state:
346 * o always accept unicast, broadcast, and multicast traffic
347 * o maintain current state of phy error reception (the hal
348 * may enable phy error frames for noise immunity work)
349 * o probe request frames are accepted only when operating in
350 * hostap, adhoc, or monitor modes
351 * o enable promiscuous mode according to the interface state
353 * - when operating in adhoc mode so the 802.11 layer creates
354 * node table entries for peers,
355 * - when operating in station mode for collecting rssi data when
356 * the station is otherwise quiet, or
357 * - when operating as a repeater so we see repeater-sta beacons
361 u32 ath_calcrxfilter(struct ath_softc *sc)
363 #define RX_FILTER_PRESERVE (ATH9K_RX_FILTER_PHYERR | ATH9K_RX_FILTER_PHYRADAR)
367 rfilt = (ath9k_hw_getrxfilter(sc->sc_ah) & RX_FILTER_PRESERVE)
368 | ATH9K_RX_FILTER_UCAST | ATH9K_RX_FILTER_BCAST
369 | ATH9K_RX_FILTER_MCAST;
371 /* If not a STA, enable processing of Probe Requests */
372 if (sc->sc_ah->ah_opmode != NL80211_IFTYPE_STATION)
373 rfilt |= ATH9K_RX_FILTER_PROBEREQ;
375 /* Can't set HOSTAP into promiscous mode */
376 if (((sc->sc_ah->ah_opmode != NL80211_IFTYPE_AP) &&
377 (sc->rx.rxfilter & FIF_PROMISC_IN_BSS)) ||
378 (sc->sc_ah->ah_opmode == NL80211_IFTYPE_MONITOR)) {
379 rfilt |= ATH9K_RX_FILTER_PROM;
380 /* ??? To prevent from sending ACK */
381 rfilt &= ~ATH9K_RX_FILTER_UCAST;
384 if (sc->sc_ah->ah_opmode == NL80211_IFTYPE_STATION ||
385 sc->sc_ah->ah_opmode == NL80211_IFTYPE_ADHOC)
386 rfilt |= ATH9K_RX_FILTER_BEACON;
388 /* If in HOSTAP mode, want to enable reception of PSPOLL frames
390 if (sc->sc_ah->ah_opmode == NL80211_IFTYPE_AP)
391 rfilt |= (ATH9K_RX_FILTER_BEACON | ATH9K_RX_FILTER_PSPOLL);
395 #undef RX_FILTER_PRESERVE
398 int ath_startrecv(struct ath_softc *sc)
400 struct ath_hal *ah = sc->sc_ah;
401 struct ath_buf *bf, *tbf;
403 spin_lock_bh(&sc->rx.rxbuflock);
404 if (list_empty(&sc->rx.rxbuf))
407 sc->rx.rxlink = NULL;
408 list_for_each_entry_safe(bf, tbf, &sc->rx.rxbuf, list) {
409 ath_rx_buf_link(sc, bf);
412 /* We could have deleted elements so the list may be empty now */
413 if (list_empty(&sc->rx.rxbuf))
416 bf = list_first_entry(&sc->rx.rxbuf, struct ath_buf, list);
417 ath9k_hw_putrxbuf(ah, bf->bf_daddr);
421 spin_unlock_bh(&sc->rx.rxbuflock);
423 ath9k_hw_startpcureceive(ah);
428 bool ath_stoprecv(struct ath_softc *sc)
430 struct ath_hal *ah = sc->sc_ah;
433 ath9k_hw_stoppcurecv(ah);
434 ath9k_hw_setrxfilter(ah, 0);
435 stopped = ath9k_hw_stopdmarecv(ah);
436 mdelay(3); /* 3ms is long enough for 1 frame */
437 sc->rx.rxlink = NULL;
442 void ath_flushrecv(struct ath_softc *sc)
444 spin_lock_bh(&sc->rx.rxflushlock);
445 sc->sc_flags |= SC_OP_RXFLUSH;
446 ath_rx_tasklet(sc, 1);
447 sc->sc_flags &= ~SC_OP_RXFLUSH;
448 spin_unlock_bh(&sc->rx.rxflushlock);
451 int ath_rx_tasklet(struct ath_softc *sc, int flush)
453 #define PA2DESC(_sc, _pa) \
454 ((struct ath_desc *)((caddr_t)(_sc)->rx.rxdma.dd_desc + \
455 ((_pa) - (_sc)->rx.rxdma.dd_desc_paddr)))
459 struct sk_buff *skb = NULL, *requeue_skb;
460 struct ieee80211_rx_status rx_status;
461 struct ath_hal *ah = sc->sc_ah;
462 struct ieee80211_hdr *hdr;
463 int hdrlen, padsize, retval;
464 bool decrypt_error = false;
467 spin_lock_bh(&sc->rx.rxbuflock);
470 /* If handling rx interrupt and flush is in progress => exit */
471 if ((sc->sc_flags & SC_OP_RXFLUSH) && (flush == 0))
474 if (list_empty(&sc->rx.rxbuf)) {
475 sc->rx.rxlink = NULL;
479 bf = list_first_entry(&sc->rx.rxbuf, struct ath_buf, list);
483 * Must provide the virtual address of the current
484 * descriptor, the physical address, and the virtual
485 * address of the next descriptor in the h/w chain.
486 * This allows the HAL to look ahead to see if the
487 * hardware is done with a descriptor by checking the
488 * done bit in the following descriptor and the address
489 * of the current descriptor the DMA engine is working
490 * on. All this is necessary because of our use of
491 * a self-linked list to avoid rx overruns.
493 retval = ath9k_hw_rxprocdesc(ah, ds,
495 PA2DESC(sc, ds->ds_link),
497 if (retval == -EINPROGRESS) {
499 struct ath_desc *tds;
501 if (list_is_last(&bf->list, &sc->rx.rxbuf)) {
502 sc->rx.rxlink = NULL;
506 tbf = list_entry(bf->list.next, struct ath_buf, list);
509 * On some hardware the descriptor status words could
510 * get corrupted, including the done bit. Because of
511 * this, check if the next descriptor's done bit is
514 * If the next descriptor's done bit is set, the current
515 * descriptor has been corrupted. Force s/w to discard
516 * this descriptor and continue...
520 retval = ath9k_hw_rxprocdesc(ah, tds, tbf->bf_daddr,
521 PA2DESC(sc, tds->ds_link), 0);
522 if (retval == -EINPROGRESS) {
532 * If we're asked to flush receive queue, directly
533 * chain it back at the queue without processing it.
538 if (!ds->ds_rxstat.rs_datalen)
541 /* The status portion of the descriptor could get corrupted. */
542 if (sc->rx.bufsize < ds->ds_rxstat.rs_datalen)
545 if (!ath_rx_prepare(skb, ds, &rx_status, &decrypt_error, sc))
548 /* Ensure we always have an skb to requeue once we are done
549 * processing the current buffer's skb */
550 requeue_skb = ath_rxbuf_alloc(sc, sc->rx.bufsize);
552 /* If there is no memory we ignore the current RX'd frame,
553 * tell hardware it can give us a new frame using the old
554 * skb and put it at the tail of the sc->rx.rxbuf list for
559 /* Sync and unmap the frame */
560 pci_dma_sync_single_for_cpu(sc->pdev, bf->bf_buf_addr,
563 pci_unmap_single(sc->pdev, bf->bf_buf_addr,
567 skb_put(skb, ds->ds_rxstat.rs_datalen);
568 skb->protocol = cpu_to_be16(ETH_P_CONTROL);
570 /* see if any padding is done by the hw and remove it */
571 hdr = (struct ieee80211_hdr *)skb->data;
572 hdrlen = ieee80211_get_hdrlen_from_skb(skb);
574 /* The MAC header is padded to have 32-bit boundary if the
575 * packet payload is non-zero. The general calculation for
576 * padsize would take into account odd header lengths:
577 * padsize = (4 - hdrlen % 4) % 4; However, since only
578 * even-length headers are used, padding can only be 0 or 2
579 * bytes and we can optimize this a bit. In addition, we must
580 * not try to remove padding from short control frames that do
581 * not have payload. */
582 padsize = hdrlen & 3;
583 if (padsize && hdrlen >= 24) {
584 memmove(skb->data + padsize, skb->data, hdrlen);
585 skb_pull(skb, padsize);
588 keyix = ds->ds_rxstat.rs_keyix;
590 if (!(keyix == ATH9K_RXKEYIX_INVALID) && !decrypt_error) {
591 rx_status.flag |= RX_FLAG_DECRYPTED;
592 } else if ((le16_to_cpu(hdr->frame_control) & IEEE80211_FCTL_PROTECTED)
593 && !decrypt_error && skb->len >= hdrlen + 4) {
594 keyix = skb->data[hdrlen + 3] >> 6;
596 if (test_bit(keyix, sc->sc_keymap))
597 rx_status.flag |= RX_FLAG_DECRYPTED;
600 /* Send the frame to mac80211 */
601 __ieee80211_rx(sc->hw, skb, &rx_status);
603 /* We will now give hardware our shiny new allocated skb */
604 bf->bf_mpdu = requeue_skb;
605 bf->bf_buf_addr = pci_map_single(sc->pdev, requeue_skb->data,
608 if (unlikely(pci_dma_mapping_error(sc->pdev,
610 dev_kfree_skb_any(requeue_skb);
612 DPRINTF(sc, ATH_DBG_CONFIG,
613 "pci_dma_mapping_error() on RX\n");
616 bf->bf_dmacontext = bf->bf_buf_addr;
619 * change the default rx antenna if rx diversity chooses the
620 * other antenna 3 times in a row.
622 if (sc->rx.defant != ds->ds_rxstat.rs_antenna) {
623 if (++sc->rx.rxotherant >= 3)
624 ath_setdefantenna(sc, ds->ds_rxstat.rs_antenna);
626 sc->rx.rxotherant = 0;
629 list_move_tail(&bf->list, &sc->rx.rxbuf);
630 ath_rx_buf_link(sc, bf);
633 spin_unlock_bh(&sc->rx.rxbuflock);