Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 1 | /* |
Sujith | cee075a | 2009-03-13 09:07:23 +0530 | [diff] [blame] | 2 | * Copyright (c) 2008-2009 Atheros Communications Inc. |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 3 | * |
| 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. |
| 7 | * |
| 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. |
| 15 | */ |
| 16 | |
Sujith | 394cf0a | 2009-02-09 13:26:54 +0530 | [diff] [blame] | 17 | #include "ath9k.h" |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 18 | |
Jouni Malinen | bce048d | 2009-03-03 19:23:28 +0200 | [diff] [blame] | 19 | static struct ieee80211_hw * ath_get_virt_hw(struct ath_softc *sc, |
| 20 | struct ieee80211_hdr *hdr) |
| 21 | { |
Jouni Malinen | c52f33d | 2009-03-03 19:23:29 +0200 | [diff] [blame] | 22 | struct ieee80211_hw *hw = sc->pri_wiphy->hw; |
| 23 | int i; |
| 24 | |
| 25 | spin_lock_bh(&sc->wiphy_lock); |
| 26 | for (i = 0; i < sc->num_sec_wiphy; i++) { |
| 27 | struct ath_wiphy *aphy = sc->sec_wiphy[i]; |
| 28 | if (aphy == NULL) |
| 29 | continue; |
| 30 | if (compare_ether_addr(hdr->addr1, aphy->hw->wiphy->perm_addr) |
| 31 | == 0) { |
| 32 | hw = aphy->hw; |
| 33 | break; |
| 34 | } |
| 35 | } |
| 36 | spin_unlock_bh(&sc->wiphy_lock); |
| 37 | return hw; |
Jouni Malinen | bce048d | 2009-03-03 19:23:28 +0200 | [diff] [blame] | 38 | } |
| 39 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 40 | /* |
| 41 | * Setup and link descriptors. |
| 42 | * |
| 43 | * 11N: we can no longer afford to self link the last descriptor. |
| 44 | * MAC acknowledges BA status as long as it copies frames to host |
| 45 | * buffer (or rx fifo). This can incorrectly acknowledge packets |
| 46 | * to a sender if last desc is self-linked. |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 47 | */ |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 48 | static void ath_rx_buf_link(struct ath_softc *sc, struct ath_buf *bf) |
| 49 | { |
Sujith | cbe61d8 | 2009-02-09 13:27:12 +0530 | [diff] [blame] | 50 | struct ath_hw *ah = sc->sc_ah; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 51 | struct ath_desc *ds; |
| 52 | struct sk_buff *skb; |
| 53 | |
| 54 | ATH_RXBUF_RESET(bf); |
| 55 | |
| 56 | ds = bf->bf_desc; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 57 | ds->ds_link = 0; /* link to null */ |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 58 | ds->ds_data = bf->bf_buf_addr; |
| 59 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 60 | /* virtual addr of the beginning of the buffer. */ |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 61 | skb = bf->bf_mpdu; |
| 62 | ASSERT(skb != NULL); |
| 63 | ds->ds_vdata = skb->data; |
| 64 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 65 | /* setup rx descriptors. The rx.bufsize here tells the harware |
Luis R. Rodriguez | b4b6cda | 2008-11-20 17:15:13 -0800 | [diff] [blame] | 66 | * how much data it can DMA to us and that we are prepared |
| 67 | * to process */ |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 68 | ath9k_hw_setuprxdesc(ah, ds, |
| 69 | sc->rx.bufsize, |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 70 | 0); |
| 71 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 72 | if (sc->rx.rxlink == NULL) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 73 | ath9k_hw_putrxbuf(ah, bf->bf_daddr); |
| 74 | else |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 75 | *sc->rx.rxlink = bf->bf_daddr; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 76 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 77 | sc->rx.rxlink = &ds->ds_link; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 78 | ath9k_hw_rxena(ah); |
| 79 | } |
| 80 | |
Sujith | ff37e33 | 2008-11-24 12:07:55 +0530 | [diff] [blame] | 81 | static void ath_setdefantenna(struct ath_softc *sc, u32 antenna) |
| 82 | { |
| 83 | /* XXX block beacon interrupts */ |
| 84 | ath9k_hw_setantenna(sc->sc_ah, antenna); |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 85 | sc->rx.defant = antenna; |
| 86 | sc->rx.rxotherant = 0; |
Sujith | ff37e33 | 2008-11-24 12:07:55 +0530 | [diff] [blame] | 87 | } |
| 88 | |
| 89 | /* |
| 90 | * Extend 15-bit time stamp from rx descriptor to |
| 91 | * a full 64-bit TSF using the current h/w TSF. |
| 92 | */ |
| 93 | static u64 ath_extend_tsf(struct ath_softc *sc, u32 rstamp) |
| 94 | { |
| 95 | u64 tsf; |
| 96 | |
| 97 | tsf = ath9k_hw_gettsf64(sc->sc_ah); |
| 98 | if ((tsf & 0x7fff) < rstamp) |
| 99 | tsf -= 0x8000; |
| 100 | return (tsf & ~0x7fff) | rstamp; |
| 101 | } |
| 102 | |
Senthil Balasubramanian | f0e6ce1 | 2009-03-06 11:24:08 +0530 | [diff] [blame] | 103 | static struct sk_buff *ath_rxbuf_alloc(struct ath_softc *sc, u32 len, gfp_t gfp_mask) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 104 | { |
| 105 | struct sk_buff *skb; |
| 106 | u32 off; |
| 107 | |
| 108 | /* |
| 109 | * Cache-line-align. This is important (for the |
| 110 | * 5210 at least) as not doing so causes bogus data |
| 111 | * in rx'd frames. |
| 112 | */ |
| 113 | |
Luis R. Rodriguez | b4b6cda | 2008-11-20 17:15:13 -0800 | [diff] [blame] | 114 | /* Note: the kernel can allocate a value greater than |
| 115 | * what we ask it to give us. We really only need 4 KB as that |
| 116 | * is this hardware supports and in fact we need at least 3849 |
| 117 | * as that is the MAX AMSDU size this hardware supports. |
| 118 | * Unfortunately this means we may get 8 KB here from the |
| 119 | * kernel... and that is actually what is observed on some |
| 120 | * systems :( */ |
Senthil Balasubramanian | f0e6ce1 | 2009-03-06 11:24:08 +0530 | [diff] [blame] | 121 | skb = __dev_alloc_skb(len + sc->cachelsz - 1, gfp_mask); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 122 | if (skb != NULL) { |
Sujith | 17d7904 | 2009-02-09 13:27:03 +0530 | [diff] [blame] | 123 | off = ((unsigned long) skb->data) % sc->cachelsz; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 124 | if (off != 0) |
Sujith | 17d7904 | 2009-02-09 13:27:03 +0530 | [diff] [blame] | 125 | skb_reserve(skb, sc->cachelsz - off); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 126 | } else { |
| 127 | DPRINTF(sc, ATH_DBG_FATAL, |
Sujith | 04bd4638 | 2008-11-28 22:18:05 +0530 | [diff] [blame] | 128 | "skbuff alloc of size %u failed\n", len); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 129 | return NULL; |
| 130 | } |
| 131 | |
| 132 | return skb; |
| 133 | } |
| 134 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 135 | /* |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 136 | * For Decrypt or Demic errors, we only mark packet status here and always push |
| 137 | * up the frame up to let mac80211 handle the actual error case, be it no |
| 138 | * decryption key or real decryption error. This let us keep statistics there. |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 139 | */ |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 140 | static int ath_rx_prepare(struct sk_buff *skb, struct ath_desc *ds, |
| 141 | struct ieee80211_rx_status *rx_status, bool *decrypt_error, |
| 142 | struct ath_softc *sc) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 143 | { |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 144 | struct ieee80211_hdr *hdr; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 145 | u8 ratecode; |
| 146 | __le16 fc; |
Jouni Malinen | bce048d | 2009-03-03 19:23:28 +0200 | [diff] [blame] | 147 | struct ieee80211_hw *hw; |
Senthil Balasubramanian | a59b5a5 | 2009-07-14 20:17:07 -0400 | [diff] [blame] | 148 | struct ieee80211_sta *sta; |
| 149 | struct ath_node *an; |
| 150 | int last_rssi = ATH_RSSI_DUMMY_MARKER; |
| 151 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 152 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 153 | hdr = (struct ieee80211_hdr *)skb->data; |
| 154 | fc = hdr->frame_control; |
| 155 | memset(rx_status, 0, sizeof(struct ieee80211_rx_status)); |
Jouni Malinen | bce048d | 2009-03-03 19:23:28 +0200 | [diff] [blame] | 156 | hw = ath_get_virt_hw(sc, hdr); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 157 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 158 | if (ds->ds_rxstat.rs_more) { |
| 159 | /* |
| 160 | * Frame spans multiple descriptors; this cannot happen yet |
| 161 | * as we don't support jumbograms. If not in monitor mode, |
| 162 | * discard the frame. Enable this if you want to see |
| 163 | * error frames in Monitor mode. |
| 164 | */ |
Sujith | 2660b81 | 2009-02-09 13:27:26 +0530 | [diff] [blame] | 165 | if (sc->sc_ah->opmode != NL80211_IFTYPE_MONITOR) |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 166 | goto rx_next; |
| 167 | } else if (ds->ds_rxstat.rs_status != 0) { |
| 168 | if (ds->ds_rxstat.rs_status & ATH9K_RXERR_CRC) |
| 169 | rx_status->flag |= RX_FLAG_FAILED_FCS_CRC; |
| 170 | if (ds->ds_rxstat.rs_status & ATH9K_RXERR_PHY) |
| 171 | goto rx_next; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 172 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 173 | if (ds->ds_rxstat.rs_status & ATH9K_RXERR_DECRYPT) { |
| 174 | *decrypt_error = true; |
| 175 | } else if (ds->ds_rxstat.rs_status & ATH9K_RXERR_MIC) { |
| 176 | if (ieee80211_is_ctl(fc)) |
| 177 | /* |
| 178 | * Sometimes, we get invalid |
| 179 | * MIC failures on valid control frames. |
| 180 | * Remove these mic errors. |
| 181 | */ |
| 182 | ds->ds_rxstat.rs_status &= ~ATH9K_RXERR_MIC; |
| 183 | else |
| 184 | rx_status->flag |= RX_FLAG_MMIC_ERROR; |
| 185 | } |
| 186 | /* |
| 187 | * Reject error frames with the exception of |
| 188 | * decryption and MIC failures. For monitor mode, |
| 189 | * we also ignore the CRC error. |
| 190 | */ |
Sujith | 2660b81 | 2009-02-09 13:27:26 +0530 | [diff] [blame] | 191 | if (sc->sc_ah->opmode == NL80211_IFTYPE_MONITOR) { |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 192 | if (ds->ds_rxstat.rs_status & |
| 193 | ~(ATH9K_RXERR_DECRYPT | ATH9K_RXERR_MIC | |
| 194 | ATH9K_RXERR_CRC)) |
| 195 | goto rx_next; |
| 196 | } else { |
| 197 | if (ds->ds_rxstat.rs_status & |
| 198 | ~(ATH9K_RXERR_DECRYPT | ATH9K_RXERR_MIC)) { |
| 199 | goto rx_next; |
| 200 | } |
| 201 | } |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 202 | } |
| 203 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 204 | ratecode = ds->ds_rxstat.rs_rate; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 205 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 206 | if (ratecode & 0x80) { |
Jouni Malinen | baad1d9 | 2008-12-12 14:38:34 +0200 | [diff] [blame] | 207 | /* HT rate */ |
| 208 | rx_status->flag |= RX_FLAG_HT; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 209 | if (ds->ds_rxstat.rs_flags & ATH9K_RX_2040) |
Jouni Malinen | baad1d9 | 2008-12-12 14:38:34 +0200 | [diff] [blame] | 210 | rx_status->flag |= RX_FLAG_40MHZ; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 211 | if (ds->ds_rxstat.rs_flags & ATH9K_RX_GI) |
Jouni Malinen | baad1d9 | 2008-12-12 14:38:34 +0200 | [diff] [blame] | 212 | rx_status->flag |= RX_FLAG_SHORT_GI; |
| 213 | rx_status->rate_idx = ratecode & 0x7f; |
| 214 | } else { |
| 215 | int i = 0, cur_band, n_rates; |
Jouni Malinen | baad1d9 | 2008-12-12 14:38:34 +0200 | [diff] [blame] | 216 | |
| 217 | cur_band = hw->conf.channel->band; |
| 218 | n_rates = sc->sbands[cur_band].n_bitrates; |
| 219 | |
| 220 | for (i = 0; i < n_rates; i++) { |
| 221 | if (sc->sbands[cur_band].bitrates[i].hw_value == |
| 222 | ratecode) { |
| 223 | rx_status->rate_idx = i; |
| 224 | break; |
| 225 | } |
| 226 | |
| 227 | if (sc->sbands[cur_band].bitrates[i].hw_value_short == |
| 228 | ratecode) { |
| 229 | rx_status->rate_idx = i; |
| 230 | rx_status->flag |= RX_FLAG_SHORTPRE; |
| 231 | break; |
| 232 | } |
| 233 | } |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 234 | } |
| 235 | |
Senthil Balasubramanian | a59b5a5 | 2009-07-14 20:17:07 -0400 | [diff] [blame] | 236 | rcu_read_lock(); |
| 237 | sta = ieee80211_find_sta(sc->hw, hdr->addr2); |
| 238 | if (sta) { |
| 239 | an = (struct ath_node *) sta->drv_priv; |
| 240 | if (ds->ds_rxstat.rs_rssi != ATH9K_RSSI_BAD && |
| 241 | !ds->ds_rxstat.rs_moreaggr) |
| 242 | ATH_RSSI_LPF(an->last_rssi, ds->ds_rxstat.rs_rssi); |
| 243 | last_rssi = an->last_rssi; |
| 244 | } |
| 245 | rcu_read_unlock(); |
| 246 | |
| 247 | if (likely(last_rssi != ATH_RSSI_DUMMY_MARKER)) |
| 248 | ds->ds_rxstat.rs_rssi = ATH_EP_RND(last_rssi, |
| 249 | ATH_RSSI_EP_MULTIPLIER); |
| 250 | if (ds->ds_rxstat.rs_rssi < 0) |
| 251 | ds->ds_rxstat.rs_rssi = 0; |
| 252 | else if (ds->ds_rxstat.rs_rssi > 127) |
| 253 | ds->ds_rxstat.rs_rssi = 127; |
| 254 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 255 | rx_status->mactime = ath_extend_tsf(sc, ds->ds_rxstat.rs_tstamp); |
Jouni Malinen | bce048d | 2009-03-03 19:23:28 +0200 | [diff] [blame] | 256 | rx_status->band = hw->conf.channel->band; |
| 257 | rx_status->freq = hw->conf.channel->center_freq; |
Sujith | 17d7904 | 2009-02-09 13:27:03 +0530 | [diff] [blame] | 258 | rx_status->noise = sc->ani.noise_floor; |
Senthil Balasubramanian | a59b5a5 | 2009-07-14 20:17:07 -0400 | [diff] [blame] | 259 | rx_status->signal = ATH_DEFAULT_NOISE_FLOOR + ds->ds_rxstat.rs_rssi; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 260 | rx_status->antenna = ds->ds_rxstat.rs_antenna; |
| 261 | |
Luis R. Rodriguez | 7d5ca3b | 2009-06-19 11:57:59 -0700 | [diff] [blame] | 262 | /* |
| 263 | * Theory for reporting quality: |
| 264 | * |
| 265 | * At a hardware RSSI of 45 you will be able to use MCS 7 reliably. |
| 266 | * At a hardware RSSI of 45 you will be able to use MCS 15 reliably. |
| 267 | * At a hardware RSSI of 35 you should be able use 54 Mbps reliably. |
| 268 | * |
| 269 | * MCS 7 is the highets MCS index usable by a 1-stream device. |
| 270 | * MCS 15 is the highest MCS index usable by a 2-stream device. |
| 271 | * |
| 272 | * All ath9k devices are either 1-stream or 2-stream. |
| 273 | * |
| 274 | * How many bars you see is derived from the qual reporting. |
| 275 | * |
| 276 | * A more elaborate scheme can be used here but it requires tables |
| 277 | * of SNR/throughput for each possible mode used. For the MCS table |
| 278 | * you can refer to the wireless wiki: |
| 279 | * |
| 280 | * http://wireless.kernel.org/en/developers/Documentation/ieee80211/802.11n |
| 281 | * |
| 282 | */ |
| 283 | if (conf_is_ht(&hw->conf)) |
| 284 | rx_status->qual = ds->ds_rxstat.rs_rssi * 100 / 45; |
| 285 | else |
| 286 | rx_status->qual = ds->ds_rxstat.rs_rssi * 100 / 35; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 287 | |
| 288 | /* rssi can be more than 45 though, anything above that |
| 289 | * should be considered at 100% */ |
| 290 | if (rx_status->qual > 100) |
| 291 | rx_status->qual = 100; |
| 292 | |
| 293 | rx_status->flag |= RX_FLAG_TSFT; |
| 294 | |
| 295 | return 1; |
| 296 | rx_next: |
| 297 | return 0; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 298 | } |
| 299 | |
| 300 | static void ath_opmode_init(struct ath_softc *sc) |
| 301 | { |
Sujith | cbe61d8 | 2009-02-09 13:27:12 +0530 | [diff] [blame] | 302 | struct ath_hw *ah = sc->sc_ah; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 303 | u32 rfilt, mfilt[2]; |
| 304 | |
| 305 | /* configure rx filter */ |
| 306 | rfilt = ath_calcrxfilter(sc); |
| 307 | ath9k_hw_setrxfilter(ah, rfilt); |
| 308 | |
| 309 | /* configure bssid mask */ |
Sujith | 2660b81 | 2009-02-09 13:27:26 +0530 | [diff] [blame] | 310 | if (ah->caps.hw_caps & ATH9K_HW_CAP_BSSIDMASK) |
Sujith | ba52da5 | 2009-02-09 13:27:10 +0530 | [diff] [blame] | 311 | ath9k_hw_setbssidmask(sc); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 312 | |
| 313 | /* configure operational mode */ |
| 314 | ath9k_hw_setopmode(ah); |
| 315 | |
| 316 | /* Handle any link-level address change. */ |
Sujith | ba52da5 | 2009-02-09 13:27:10 +0530 | [diff] [blame] | 317 | ath9k_hw_setmac(ah, sc->sc_ah->macaddr); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 318 | |
| 319 | /* calculate and install multicast filter */ |
| 320 | mfilt[0] = mfilt[1] = ~0; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 321 | ath9k_hw_setmcastfilter(ah, mfilt[0], mfilt[1]); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 322 | } |
| 323 | |
| 324 | int ath_rx_init(struct ath_softc *sc, int nbufs) |
| 325 | { |
| 326 | struct sk_buff *skb; |
| 327 | struct ath_buf *bf; |
| 328 | int error = 0; |
| 329 | |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 330 | spin_lock_init(&sc->rx.rxflushlock); |
| 331 | sc->sc_flags &= ~SC_OP_RXFLUSH; |
| 332 | spin_lock_init(&sc->rx.rxbuflock); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 333 | |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 334 | sc->rx.bufsize = roundup(IEEE80211_MAX_MPDU_LEN, |
| 335 | min(sc->cachelsz, (u16)64)); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 336 | |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 337 | DPRINTF(sc, ATH_DBG_CONFIG, "cachelsz %u rxbufsize %u\n", |
| 338 | sc->cachelsz, sc->rx.bufsize); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 339 | |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 340 | /* Initialize rx descriptors */ |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 341 | |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 342 | error = ath_descdma_setup(sc, &sc->rx.rxdma, &sc->rx.rxbuf, |
| 343 | "rx", nbufs, 1); |
| 344 | if (error != 0) { |
| 345 | DPRINTF(sc, ATH_DBG_FATAL, |
| 346 | "failed to allocate rx descriptors: %d\n", error); |
| 347 | goto err; |
| 348 | } |
| 349 | |
| 350 | list_for_each_entry(bf, &sc->rx.rxbuf, list) { |
| 351 | skb = ath_rxbuf_alloc(sc, sc->rx.bufsize, GFP_KERNEL); |
| 352 | if (skb == NULL) { |
| 353 | error = -ENOMEM; |
| 354 | goto err; |
| 355 | } |
| 356 | |
| 357 | bf->bf_mpdu = skb; |
| 358 | bf->bf_buf_addr = dma_map_single(sc->dev, skb->data, |
| 359 | sc->rx.bufsize, |
| 360 | DMA_FROM_DEVICE); |
| 361 | if (unlikely(dma_mapping_error(sc->dev, |
| 362 | bf->bf_buf_addr))) { |
| 363 | dev_kfree_skb_any(skb); |
| 364 | bf->bf_mpdu = NULL; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 365 | DPRINTF(sc, ATH_DBG_FATAL, |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 366 | "dma_mapping_error() on RX init\n"); |
| 367 | error = -ENOMEM; |
| 368 | goto err; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 369 | } |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 370 | bf->bf_dmacontext = bf->bf_buf_addr; |
| 371 | } |
| 372 | sc->rx.rxlink = NULL; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 373 | |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 374 | err: |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 375 | if (error) |
| 376 | ath_rx_cleanup(sc); |
| 377 | |
| 378 | return error; |
| 379 | } |
| 380 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 381 | void ath_rx_cleanup(struct ath_softc *sc) |
| 382 | { |
| 383 | struct sk_buff *skb; |
| 384 | struct ath_buf *bf; |
| 385 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 386 | list_for_each_entry(bf, &sc->rx.rxbuf, list) { |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 387 | skb = bf->bf_mpdu; |
Luis R. Rodriguez | 051b919 | 2009-03-23 18:25:01 -0400 | [diff] [blame] | 388 | if (skb) { |
Sujith | 797fe5cb | 2009-03-30 15:28:45 +0530 | [diff] [blame] | 389 | dma_unmap_single(sc->dev, bf->bf_buf_addr, |
| 390 | sc->rx.bufsize, DMA_FROM_DEVICE); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 391 | dev_kfree_skb(skb); |
Luis R. Rodriguez | 051b919 | 2009-03-23 18:25:01 -0400 | [diff] [blame] | 392 | } |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 393 | } |
| 394 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 395 | if (sc->rx.rxdma.dd_desc_len != 0) |
| 396 | ath_descdma_cleanup(sc, &sc->rx.rxdma, &sc->rx.rxbuf); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 397 | } |
| 398 | |
| 399 | /* |
| 400 | * Calculate the receive filter according to the |
| 401 | * operating mode and state: |
| 402 | * |
| 403 | * o always accept unicast, broadcast, and multicast traffic |
| 404 | * o maintain current state of phy error reception (the hal |
| 405 | * may enable phy error frames for noise immunity work) |
| 406 | * o probe request frames are accepted only when operating in |
| 407 | * hostap, adhoc, or monitor modes |
| 408 | * o enable promiscuous mode according to the interface state |
| 409 | * o accept beacons: |
| 410 | * - when operating in adhoc mode so the 802.11 layer creates |
| 411 | * node table entries for peers, |
| 412 | * - when operating in station mode for collecting rssi data when |
| 413 | * the station is otherwise quiet, or |
| 414 | * - when operating as a repeater so we see repeater-sta beacons |
| 415 | * - when scanning |
| 416 | */ |
| 417 | |
| 418 | u32 ath_calcrxfilter(struct ath_softc *sc) |
| 419 | { |
| 420 | #define RX_FILTER_PRESERVE (ATH9K_RX_FILTER_PHYERR | ATH9K_RX_FILTER_PHYRADAR) |
Sujith | 7dcfdcd | 2008-08-11 14:03:13 +0530 | [diff] [blame] | 421 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 422 | u32 rfilt; |
| 423 | |
| 424 | rfilt = (ath9k_hw_getrxfilter(sc->sc_ah) & RX_FILTER_PRESERVE) |
| 425 | | ATH9K_RX_FILTER_UCAST | ATH9K_RX_FILTER_BCAST |
| 426 | | ATH9K_RX_FILTER_MCAST; |
| 427 | |
| 428 | /* If not a STA, enable processing of Probe Requests */ |
Sujith | 2660b81 | 2009-02-09 13:27:26 +0530 | [diff] [blame] | 429 | if (sc->sc_ah->opmode != NL80211_IFTYPE_STATION) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 430 | rfilt |= ATH9K_RX_FILTER_PROBEREQ; |
| 431 | |
Jouni Malinen | 217ba9d | 2009-03-10 10:55:50 +0200 | [diff] [blame] | 432 | /* |
| 433 | * Set promiscuous mode when FIF_PROMISC_IN_BSS is enabled for station |
| 434 | * mode interface or when in monitor mode. AP mode does not need this |
| 435 | * since it receives all in-BSS frames anyway. |
| 436 | */ |
Sujith | 2660b81 | 2009-02-09 13:27:26 +0530 | [diff] [blame] | 437 | if (((sc->sc_ah->opmode != NL80211_IFTYPE_AP) && |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 438 | (sc->rx.rxfilter & FIF_PROMISC_IN_BSS)) || |
Jouni Malinen | 217ba9d | 2009-03-10 10:55:50 +0200 | [diff] [blame] | 439 | (sc->sc_ah->opmode == NL80211_IFTYPE_MONITOR)) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 440 | rfilt |= ATH9K_RX_FILTER_PROM; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 441 | |
Sujith | d42c6b7 | 2009-02-04 08:10:22 +0530 | [diff] [blame] | 442 | if (sc->rx.rxfilter & FIF_CONTROL) |
| 443 | rfilt |= ATH9K_RX_FILTER_CONTROL; |
| 444 | |
Vasanthakumar Thiagarajan | dbaaa14 | 2009-02-19 15:41:52 +0530 | [diff] [blame] | 445 | if ((sc->sc_ah->opmode == NL80211_IFTYPE_STATION) && |
| 446 | !(sc->rx.rxfilter & FIF_BCN_PRBRESP_PROMISC)) |
| 447 | rfilt |= ATH9K_RX_FILTER_MYBEACON; |
| 448 | else |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 449 | rfilt |= ATH9K_RX_FILTER_BEACON; |
| 450 | |
Luis R. Rodriguez | 63b08b8 | 2009-08-04 10:05:30 -0700 | [diff] [blame^] | 451 | if (sc->rx.rxfilter & FIF_PSPOLL) |
Vasanthakumar Thiagarajan | dbaaa14 | 2009-02-19 15:41:52 +0530 | [diff] [blame] | 452 | rfilt |= ATH9K_RX_FILTER_PSPOLL; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 453 | |
Jouni Malinen | b93bce2 | 2009-03-03 19:23:30 +0200 | [diff] [blame] | 454 | if (sc->sec_wiphy) { |
| 455 | /* TODO: only needed if more than one BSSID is in use in |
| 456 | * station/adhoc mode */ |
| 457 | /* TODO: for older chips, may need to add ATH9K_RX_FILTER_PROM |
| 458 | */ |
| 459 | rfilt |= ATH9K_RX_FILTER_MCAST_BCAST_ALL; |
| 460 | } |
| 461 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 462 | return rfilt; |
Sujith | 7dcfdcd | 2008-08-11 14:03:13 +0530 | [diff] [blame] | 463 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 464 | #undef RX_FILTER_PRESERVE |
| 465 | } |
| 466 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 467 | int ath_startrecv(struct ath_softc *sc) |
| 468 | { |
Sujith | cbe61d8 | 2009-02-09 13:27:12 +0530 | [diff] [blame] | 469 | struct ath_hw *ah = sc->sc_ah; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 470 | struct ath_buf *bf, *tbf; |
| 471 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 472 | spin_lock_bh(&sc->rx.rxbuflock); |
| 473 | if (list_empty(&sc->rx.rxbuf)) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 474 | goto start_recv; |
| 475 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 476 | sc->rx.rxlink = NULL; |
| 477 | list_for_each_entry_safe(bf, tbf, &sc->rx.rxbuf, list) { |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 478 | ath_rx_buf_link(sc, bf); |
| 479 | } |
| 480 | |
| 481 | /* We could have deleted elements so the list may be empty now */ |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 482 | if (list_empty(&sc->rx.rxbuf)) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 483 | goto start_recv; |
| 484 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 485 | bf = list_first_entry(&sc->rx.rxbuf, struct ath_buf, list); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 486 | ath9k_hw_putrxbuf(ah, bf->bf_daddr); |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 487 | ath9k_hw_rxena(ah); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 488 | |
| 489 | start_recv: |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 490 | spin_unlock_bh(&sc->rx.rxbuflock); |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 491 | ath_opmode_init(sc); |
| 492 | ath9k_hw_startpcureceive(ah); |
| 493 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 494 | return 0; |
| 495 | } |
| 496 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 497 | bool ath_stoprecv(struct ath_softc *sc) |
| 498 | { |
Sujith | cbe61d8 | 2009-02-09 13:27:12 +0530 | [diff] [blame] | 499 | struct ath_hw *ah = sc->sc_ah; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 500 | bool stopped; |
| 501 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 502 | ath9k_hw_stoppcurecv(ah); |
| 503 | ath9k_hw_setrxfilter(ah, 0); |
| 504 | stopped = ath9k_hw_stopdmarecv(ah); |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 505 | sc->rx.rxlink = NULL; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 506 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 507 | return stopped; |
| 508 | } |
| 509 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 510 | void ath_flushrecv(struct ath_softc *sc) |
| 511 | { |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 512 | spin_lock_bh(&sc->rx.rxflushlock); |
Sujith | 98deeea | 2008-08-11 14:05:46 +0530 | [diff] [blame] | 513 | sc->sc_flags |= SC_OP_RXFLUSH; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 514 | ath_rx_tasklet(sc, 1); |
Sujith | 98deeea | 2008-08-11 14:05:46 +0530 | [diff] [blame] | 515 | sc->sc_flags &= ~SC_OP_RXFLUSH; |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 516 | spin_unlock_bh(&sc->rx.rxflushlock); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 517 | } |
| 518 | |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 519 | static bool ath_beacon_dtim_pending_cab(struct sk_buff *skb) |
| 520 | { |
| 521 | /* Check whether the Beacon frame has DTIM indicating buffered bc/mc */ |
| 522 | struct ieee80211_mgmt *mgmt; |
| 523 | u8 *pos, *end, id, elen; |
| 524 | struct ieee80211_tim_ie *tim; |
| 525 | |
| 526 | mgmt = (struct ieee80211_mgmt *)skb->data; |
| 527 | pos = mgmt->u.beacon.variable; |
| 528 | end = skb->data + skb->len; |
| 529 | |
| 530 | while (pos + 2 < end) { |
| 531 | id = *pos++; |
| 532 | elen = *pos++; |
| 533 | if (pos + elen > end) |
| 534 | break; |
| 535 | |
| 536 | if (id == WLAN_EID_TIM) { |
| 537 | if (elen < sizeof(*tim)) |
| 538 | break; |
| 539 | tim = (struct ieee80211_tim_ie *) pos; |
| 540 | if (tim->dtim_count != 0) |
| 541 | break; |
| 542 | return tim->bitmap_ctrl & 0x01; |
| 543 | } |
| 544 | |
| 545 | pos += elen; |
| 546 | } |
| 547 | |
| 548 | return false; |
| 549 | } |
| 550 | |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 551 | static void ath_rx_ps_beacon(struct ath_softc *sc, struct sk_buff *skb) |
| 552 | { |
| 553 | struct ieee80211_mgmt *mgmt; |
| 554 | |
| 555 | if (skb->len < 24 + 8 + 2 + 2) |
| 556 | return; |
| 557 | |
| 558 | mgmt = (struct ieee80211_mgmt *)skb->data; |
| 559 | if (memcmp(sc->curbssid, mgmt->bssid, ETH_ALEN) != 0) |
| 560 | return; /* not from our current AP */ |
| 561 | |
Gabor Juhos | 293dc5d | 2009-06-19 12:17:48 +0200 | [diff] [blame] | 562 | sc->sc_flags &= ~SC_OP_WAIT_FOR_BEACON; |
| 563 | |
Jouni Malinen | ccdfeab | 2009-05-20 21:59:08 +0300 | [diff] [blame] | 564 | if (sc->sc_flags & SC_OP_BEACON_SYNC) { |
| 565 | sc->sc_flags &= ~SC_OP_BEACON_SYNC; |
| 566 | DPRINTF(sc, ATH_DBG_PS, "Reconfigure Beacon timers based on " |
| 567 | "timestamp from the AP\n"); |
| 568 | ath_beacon_config(sc, NULL); |
| 569 | } |
| 570 | |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 571 | if (ath_beacon_dtim_pending_cab(skb)) { |
| 572 | /* |
| 573 | * Remain awake waiting for buffered broadcast/multicast |
Gabor Juhos | 58f5fff | 2009-06-17 20:53:20 +0200 | [diff] [blame] | 574 | * frames. If the last broadcast/multicast frame is not |
| 575 | * received properly, the next beacon frame will work as |
| 576 | * a backup trigger for returning into NETWORK SLEEP state, |
| 577 | * so we are waiting for it as well. |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 578 | */ |
| 579 | DPRINTF(sc, ATH_DBG_PS, "Received DTIM beacon indicating " |
| 580 | "buffered broadcast/multicast frame(s)\n"); |
Gabor Juhos | 58f5fff | 2009-06-17 20:53:20 +0200 | [diff] [blame] | 581 | sc->sc_flags |= SC_OP_WAIT_FOR_CAB | SC_OP_WAIT_FOR_BEACON; |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 582 | return; |
| 583 | } |
| 584 | |
| 585 | if (sc->sc_flags & SC_OP_WAIT_FOR_CAB) { |
| 586 | /* |
| 587 | * This can happen if a broadcast frame is dropped or the AP |
| 588 | * fails to send a frame indicating that all CAB frames have |
| 589 | * been delivered. |
| 590 | */ |
Gabor Juhos | 293dc5d | 2009-06-19 12:17:48 +0200 | [diff] [blame] | 591 | sc->sc_flags &= ~SC_OP_WAIT_FOR_CAB; |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 592 | DPRINTF(sc, ATH_DBG_PS, "PS wait for CAB frames timed out\n"); |
| 593 | } |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 594 | } |
| 595 | |
| 596 | static void ath_rx_ps(struct ath_softc *sc, struct sk_buff *skb) |
| 597 | { |
| 598 | struct ieee80211_hdr *hdr; |
| 599 | |
| 600 | hdr = (struct ieee80211_hdr *)skb->data; |
| 601 | |
| 602 | /* Process Beacon and CAB receive in PS state */ |
Jouni Malinen | 9a23f9c | 2009-05-19 17:01:38 +0300 | [diff] [blame] | 603 | if ((sc->sc_flags & SC_OP_WAIT_FOR_BEACON) && |
| 604 | ieee80211_is_beacon(hdr->frame_control)) |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 605 | ath_rx_ps_beacon(sc, skb); |
| 606 | else if ((sc->sc_flags & SC_OP_WAIT_FOR_CAB) && |
| 607 | (ieee80211_is_data(hdr->frame_control) || |
| 608 | ieee80211_is_action(hdr->frame_control)) && |
| 609 | is_multicast_ether_addr(hdr->addr1) && |
| 610 | !ieee80211_has_moredata(hdr->frame_control)) { |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 611 | /* |
| 612 | * No more broadcast/multicast frames to be received at this |
| 613 | * point. |
| 614 | */ |
Gabor Juhos | 293dc5d | 2009-06-19 12:17:48 +0200 | [diff] [blame] | 615 | sc->sc_flags &= ~SC_OP_WAIT_FOR_CAB; |
| 616 | DPRINTF(sc, ATH_DBG_PS, "All PS CAB frames received, back to " |
| 617 | "sleep\n"); |
Jouni Malinen | 9a23f9c | 2009-05-19 17:01:38 +0300 | [diff] [blame] | 618 | } else if ((sc->sc_flags & SC_OP_WAIT_FOR_PSPOLL_DATA) && |
| 619 | !is_multicast_ether_addr(hdr->addr1) && |
| 620 | !ieee80211_has_morefrags(hdr->frame_control)) { |
| 621 | sc->sc_flags &= ~SC_OP_WAIT_FOR_PSPOLL_DATA; |
| 622 | DPRINTF(sc, ATH_DBG_PS, "Going back to sleep after having " |
| 623 | "received PS-Poll data (0x%x)\n", |
| 624 | sc->sc_flags & (SC_OP_WAIT_FOR_BEACON | |
| 625 | SC_OP_WAIT_FOR_CAB | |
| 626 | SC_OP_WAIT_FOR_PSPOLL_DATA | |
| 627 | SC_OP_WAIT_FOR_TX_ACK)); |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 628 | } |
| 629 | } |
| 630 | |
Jouni Malinen | 9d64a3c | 2009-05-14 21:28:47 +0300 | [diff] [blame] | 631 | static void ath_rx_send_to_mac80211(struct ath_softc *sc, struct sk_buff *skb, |
| 632 | struct ieee80211_rx_status *rx_status) |
| 633 | { |
| 634 | struct ieee80211_hdr *hdr; |
| 635 | |
| 636 | hdr = (struct ieee80211_hdr *)skb->data; |
| 637 | |
| 638 | /* Send the frame to mac80211 */ |
| 639 | if (is_multicast_ether_addr(hdr->addr1)) { |
| 640 | int i; |
| 641 | /* |
| 642 | * Deliver broadcast/multicast frames to all suitable |
| 643 | * virtual wiphys. |
| 644 | */ |
| 645 | /* TODO: filter based on channel configuration */ |
| 646 | for (i = 0; i < sc->num_sec_wiphy; i++) { |
| 647 | struct ath_wiphy *aphy = sc->sec_wiphy[i]; |
| 648 | struct sk_buff *nskb; |
| 649 | if (aphy == NULL) |
| 650 | continue; |
| 651 | nskb = skb_copy(skb, GFP_ATOMIC); |
Johannes Berg | f1d58c2 | 2009-06-17 13:13:00 +0200 | [diff] [blame] | 652 | if (nskb) { |
| 653 | memcpy(IEEE80211_SKB_RXCB(nskb), rx_status, |
| 654 | sizeof(*rx_status)); |
| 655 | ieee80211_rx(aphy->hw, nskb); |
| 656 | } |
Jouni Malinen | 9d64a3c | 2009-05-14 21:28:47 +0300 | [diff] [blame] | 657 | } |
Johannes Berg | f1d58c2 | 2009-06-17 13:13:00 +0200 | [diff] [blame] | 658 | memcpy(IEEE80211_SKB_RXCB(skb), rx_status, sizeof(*rx_status)); |
| 659 | ieee80211_rx(sc->hw, skb); |
Jouni Malinen | 9d64a3c | 2009-05-14 21:28:47 +0300 | [diff] [blame] | 660 | } else { |
| 661 | /* Deliver unicast frames based on receiver address */ |
Johannes Berg | f1d58c2 | 2009-06-17 13:13:00 +0200 | [diff] [blame] | 662 | memcpy(IEEE80211_SKB_RXCB(skb), rx_status, sizeof(*rx_status)); |
| 663 | ieee80211_rx(ath_get_virt_hw(sc, hdr), skb); |
Jouni Malinen | 9d64a3c | 2009-05-14 21:28:47 +0300 | [diff] [blame] | 664 | } |
| 665 | } |
| 666 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 667 | int ath_rx_tasklet(struct ath_softc *sc, int flush) |
| 668 | { |
| 669 | #define PA2DESC(_sc, _pa) \ |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 670 | ((struct ath_desc *)((caddr_t)(_sc)->rx.rxdma.dd_desc + \ |
| 671 | ((_pa) - (_sc)->rx.rxdma.dd_desc_paddr))) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 672 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 673 | struct ath_buf *bf; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 674 | struct ath_desc *ds; |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 675 | struct sk_buff *skb = NULL, *requeue_skb; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 676 | struct ieee80211_rx_status rx_status; |
Sujith | cbe61d8 | 2009-02-09 13:27:12 +0530 | [diff] [blame] | 677 | struct ath_hw *ah = sc->sc_ah; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 678 | struct ieee80211_hdr *hdr; |
| 679 | int hdrlen, padsize, retval; |
| 680 | bool decrypt_error = false; |
| 681 | u8 keyix; |
Pavel Roskin | 853da11 | 2009-04-03 20:10:26 -0400 | [diff] [blame] | 682 | __le16 fc; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 683 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 684 | spin_lock_bh(&sc->rx.rxbuflock); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 685 | |
| 686 | do { |
| 687 | /* If handling rx interrupt and flush is in progress => exit */ |
Sujith | 98deeea | 2008-08-11 14:05:46 +0530 | [diff] [blame] | 688 | if ((sc->sc_flags & SC_OP_RXFLUSH) && (flush == 0)) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 689 | break; |
| 690 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 691 | if (list_empty(&sc->rx.rxbuf)) { |
| 692 | sc->rx.rxlink = NULL; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 693 | break; |
| 694 | } |
| 695 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 696 | bf = list_first_entry(&sc->rx.rxbuf, struct ath_buf, list); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 697 | ds = bf->bf_desc; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 698 | |
| 699 | /* |
| 700 | * Must provide the virtual address of the current |
| 701 | * descriptor, the physical address, and the virtual |
| 702 | * address of the next descriptor in the h/w chain. |
| 703 | * This allows the HAL to look ahead to see if the |
| 704 | * hardware is done with a descriptor by checking the |
| 705 | * done bit in the following descriptor and the address |
| 706 | * of the current descriptor the DMA engine is working |
| 707 | * on. All this is necessary because of our use of |
| 708 | * a self-linked list to avoid rx overruns. |
| 709 | */ |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 710 | retval = ath9k_hw_rxprocdesc(ah, ds, |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 711 | bf->bf_daddr, |
| 712 | PA2DESC(sc, ds->ds_link), |
| 713 | 0); |
| 714 | if (retval == -EINPROGRESS) { |
| 715 | struct ath_buf *tbf; |
| 716 | struct ath_desc *tds; |
| 717 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 718 | if (list_is_last(&bf->list, &sc->rx.rxbuf)) { |
| 719 | sc->rx.rxlink = NULL; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 720 | break; |
| 721 | } |
| 722 | |
| 723 | tbf = list_entry(bf->list.next, struct ath_buf, list); |
| 724 | |
| 725 | /* |
| 726 | * On some hardware the descriptor status words could |
| 727 | * get corrupted, including the done bit. Because of |
| 728 | * this, check if the next descriptor's done bit is |
| 729 | * set or not. |
| 730 | * |
| 731 | * If the next descriptor's done bit is set, the current |
| 732 | * descriptor has been corrupted. Force s/w to discard |
| 733 | * this descriptor and continue... |
| 734 | */ |
| 735 | |
| 736 | tds = tbf->bf_desc; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 737 | retval = ath9k_hw_rxprocdesc(ah, tds, tbf->bf_daddr, |
| 738 | PA2DESC(sc, tds->ds_link), 0); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 739 | if (retval == -EINPROGRESS) { |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 740 | break; |
| 741 | } |
| 742 | } |
| 743 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 744 | skb = bf->bf_mpdu; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 745 | if (!skb) |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 746 | continue; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 747 | |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 748 | /* |
Vasanthakumar Thiagarajan | 9bf9fca | 2008-12-15 20:40:46 +0530 | [diff] [blame] | 749 | * Synchronize the DMA transfer with CPU before |
| 750 | * 1. accessing the frame |
| 751 | * 2. requeueing the same buffer to h/w |
| 752 | */ |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 753 | dma_sync_single_for_cpu(sc->dev, bf->bf_buf_addr, |
Vasanthakumar Thiagarajan | 9bf9fca | 2008-12-15 20:40:46 +0530 | [diff] [blame] | 754 | sc->rx.bufsize, |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 755 | DMA_FROM_DEVICE); |
Vasanthakumar Thiagarajan | 9bf9fca | 2008-12-15 20:40:46 +0530 | [diff] [blame] | 756 | |
| 757 | /* |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 758 | * If we're asked to flush receive queue, directly |
| 759 | * chain it back at the queue without processing it. |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 760 | */ |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 761 | if (flush) |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 762 | goto requeue; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 763 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 764 | if (!ds->ds_rxstat.rs_datalen) |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 765 | goto requeue; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 766 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 767 | /* The status portion of the descriptor could get corrupted. */ |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 768 | if (sc->rx.bufsize < ds->ds_rxstat.rs_datalen) |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 769 | goto requeue; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 770 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 771 | if (!ath_rx_prepare(skb, ds, &rx_status, &decrypt_error, sc)) |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 772 | goto requeue; |
| 773 | |
| 774 | /* Ensure we always have an skb to requeue once we are done |
| 775 | * processing the current buffer's skb */ |
Senthil Balasubramanian | f0e6ce1 | 2009-03-06 11:24:08 +0530 | [diff] [blame] | 776 | requeue_skb = ath_rxbuf_alloc(sc, sc->rx.bufsize, GFP_ATOMIC); |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 777 | |
| 778 | /* If there is no memory we ignore the current RX'd frame, |
| 779 | * tell hardware it can give us a new frame using the old |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 780 | * skb and put it at the tail of the sc->rx.rxbuf list for |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 781 | * processing. */ |
| 782 | if (!requeue_skb) |
| 783 | goto requeue; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 784 | |
Vasanthakumar Thiagarajan | 9bf9fca | 2008-12-15 20:40:46 +0530 | [diff] [blame] | 785 | /* Unmap the frame */ |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 786 | dma_unmap_single(sc->dev, bf->bf_buf_addr, |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 787 | sc->rx.bufsize, |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 788 | DMA_FROM_DEVICE); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 789 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 790 | skb_put(skb, ds->ds_rxstat.rs_datalen); |
| 791 | skb->protocol = cpu_to_be16(ETH_P_CONTROL); |
| 792 | |
| 793 | /* see if any padding is done by the hw and remove it */ |
| 794 | hdr = (struct ieee80211_hdr *)skb->data; |
| 795 | hdrlen = ieee80211_get_hdrlen_from_skb(skb); |
Pavel Roskin | 853da11 | 2009-04-03 20:10:26 -0400 | [diff] [blame] | 796 | fc = hdr->frame_control; |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 797 | |
Jouni Malinen | 9c5f89b | 2008-12-11 18:22:13 +0200 | [diff] [blame] | 798 | /* The MAC header is padded to have 32-bit boundary if the |
| 799 | * packet payload is non-zero. The general calculation for |
| 800 | * padsize would take into account odd header lengths: |
| 801 | * padsize = (4 - hdrlen % 4) % 4; However, since only |
| 802 | * even-length headers are used, padding can only be 0 or 2 |
| 803 | * bytes and we can optimize this a bit. In addition, we must |
| 804 | * not try to remove padding from short control frames that do |
| 805 | * not have payload. */ |
| 806 | padsize = hdrlen & 3; |
| 807 | if (padsize && hdrlen >= 24) { |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 808 | memmove(skb->data + padsize, skb->data, hdrlen); |
| 809 | skb_pull(skb, padsize); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 810 | } |
| 811 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 812 | keyix = ds->ds_rxstat.rs_keyix; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 813 | |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 814 | if (!(keyix == ATH9K_RXKEYIX_INVALID) && !decrypt_error) { |
| 815 | rx_status.flag |= RX_FLAG_DECRYPTED; |
Jouni Malinen | 9d64a3c | 2009-05-14 21:28:47 +0300 | [diff] [blame] | 816 | } else if (ieee80211_has_protected(fc) |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 817 | && !decrypt_error && skb->len >= hdrlen + 4) { |
| 818 | keyix = skb->data[hdrlen + 3] >> 6; |
| 819 | |
Sujith | 17d7904 | 2009-02-09 13:27:03 +0530 | [diff] [blame] | 820 | if (test_bit(keyix, sc->keymap)) |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 821 | rx_status.flag |= RX_FLAG_DECRYPTED; |
| 822 | } |
Jouni Malinen | 0ced0e1 | 2009-01-08 13:32:13 +0200 | [diff] [blame] | 823 | if (ah->sw_mgmt_crypto && |
| 824 | (rx_status.flag & RX_FLAG_DECRYPTED) && |
Jouni Malinen | 9d64a3c | 2009-05-14 21:28:47 +0300 | [diff] [blame] | 825 | ieee80211_is_mgmt(fc)) { |
Jouni Malinen | 0ced0e1 | 2009-01-08 13:32:13 +0200 | [diff] [blame] | 826 | /* Use software decrypt for management frames. */ |
| 827 | rx_status.flag &= ~RX_FLAG_DECRYPTED; |
| 828 | } |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 829 | |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 830 | /* We will now give hardware our shiny new allocated skb */ |
| 831 | bf->bf_mpdu = requeue_skb; |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 832 | bf->bf_buf_addr = dma_map_single(sc->dev, requeue_skb->data, |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 833 | sc->rx.bufsize, |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 834 | DMA_FROM_DEVICE); |
| 835 | if (unlikely(dma_mapping_error(sc->dev, |
Luis R. Rodriguez | f8316df | 2008-12-03 03:35:29 -0800 | [diff] [blame] | 836 | bf->bf_buf_addr))) { |
| 837 | dev_kfree_skb_any(requeue_skb); |
| 838 | bf->bf_mpdu = NULL; |
Sujith | d8baa93 | 2009-03-30 15:28:25 +0530 | [diff] [blame] | 839 | DPRINTF(sc, ATH_DBG_FATAL, |
Gabor Juhos | 7da3c55 | 2009-01-14 20:17:03 +0100 | [diff] [blame] | 840 | "dma_mapping_error() on RX\n"); |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 841 | ath_rx_send_to_mac80211(sc, skb, &rx_status); |
Luis R. Rodriguez | f8316df | 2008-12-03 03:35:29 -0800 | [diff] [blame] | 842 | break; |
| 843 | } |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 844 | bf->bf_dmacontext = bf->bf_buf_addr; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 845 | |
| 846 | /* |
| 847 | * change the default rx antenna if rx diversity chooses the |
| 848 | * other antenna 3 times in a row. |
| 849 | */ |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 850 | if (sc->rx.defant != ds->ds_rxstat.rs_antenna) { |
| 851 | if (++sc->rx.rxotherant >= 3) |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 852 | ath_setdefantenna(sc, ds->ds_rxstat.rs_antenna); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 853 | } else { |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 854 | sc->rx.rxotherant = 0; |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 855 | } |
Vivek Natarajan | 3cbb5dd | 2009-01-20 11:17:08 +0530 | [diff] [blame] | 856 | |
Jouni Malinen | 9a23f9c | 2009-05-19 17:01:38 +0300 | [diff] [blame] | 857 | if (unlikely(sc->sc_flags & (SC_OP_WAIT_FOR_BEACON | |
Gabor Juhos | f0e9a86 | 2009-06-15 17:49:11 +0200 | [diff] [blame] | 858 | SC_OP_WAIT_FOR_CAB | |
Jouni Malinen | 9a23f9c | 2009-05-19 17:01:38 +0300 | [diff] [blame] | 859 | SC_OP_WAIT_FOR_PSPOLL_DATA))) |
Jouni Malinen | cc65965 | 2009-05-14 21:28:48 +0300 | [diff] [blame] | 860 | ath_rx_ps(sc, skb); |
| 861 | |
| 862 | ath_rx_send_to_mac80211(sc, skb, &rx_status); |
| 863 | |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 864 | requeue: |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 865 | list_move_tail(&bf->list, &sc->rx.rxbuf); |
Luis R. Rodriguez | cb71d9b | 2008-11-21 17:41:33 -0800 | [diff] [blame] | 866 | ath_rx_buf_link(sc, bf); |
Sujith | be0418a | 2008-11-18 09:05:55 +0530 | [diff] [blame] | 867 | } while (1); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 868 | |
Sujith | b77f483 | 2008-12-07 21:44:03 +0530 | [diff] [blame] | 869 | spin_unlock_bh(&sc->rx.rxbuflock); |
Luis R. Rodriguez | f078f20 | 2008-08-04 00:16:41 -0700 | [diff] [blame] | 870 | |
| 871 | return 0; |
| 872 | #undef PA2DESC |
| 873 | } |