3 Broadcom B43 wireless driver
5 Transmission (TX/RX) related functions.
7 Copyright (C) 2005 Martin Langer <martin-langer@gmx.de>
8 Copyright (C) 2005 Stefano Brivio <stefano.brivio@polimi.it>
9 Copyright (C) 2005, 2006 Michael Buesch <mb@bu3sch.de>
10 Copyright (C) 2005 Danny van Dyk <kugelfang@gentoo.org>
11 Copyright (C) 2005 Andreas Jaggi <andreas.jaggi@waterwave.ch>
13 This program is free software; you can redistribute it and/or modify
14 it under the terms of the GNU General Public License as published by
15 the Free Software Foundation; either version 2 of the License, or
16 (at your option) any later version.
18 This program is distributed in the hope that it will be useful,
19 but WITHOUT ANY WARRANTY; without even the implied warranty of
20 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
21 GNU General Public License for more details.
23 You should have received a copy of the GNU General Public License
24 along with this program; see the file COPYING. If not, write to
25 the Free Software Foundation, Inc., 51 Franklin Steet, Fifth Floor,
26 Boston, MA 02110-1301, USA.
36 /* Extract the bitrate index out of a CCK PLCP header. */
37 static int b43_plcp_get_bitrate_idx_cck(struct b43_plcp_hdr6 *plcp)
39 switch (plcp->raw[0]) {
53 /* Extract the bitrate index out of an OFDM PLCP header. */
54 static u8 b43_plcp_get_bitrate_idx_ofdm(struct b43_plcp_hdr6 *plcp, bool aphy)
56 int base = aphy ? 0 : 4;
58 switch (plcp->raw[0] & 0xF) {
80 u8 b43_plcp_get_ratecode_cck(const u8 bitrate)
83 case B43_CCK_RATE_1MB:
85 case B43_CCK_RATE_2MB:
87 case B43_CCK_RATE_5MB:
89 case B43_CCK_RATE_11MB:
96 u8 b43_plcp_get_ratecode_ofdm(const u8 bitrate)
99 case B43_OFDM_RATE_6MB:
101 case B43_OFDM_RATE_9MB:
103 case B43_OFDM_RATE_12MB:
105 case B43_OFDM_RATE_18MB:
107 case B43_OFDM_RATE_24MB:
109 case B43_OFDM_RATE_36MB:
111 case B43_OFDM_RATE_48MB:
113 case B43_OFDM_RATE_54MB:
120 void b43_generate_plcp_hdr(struct b43_plcp_hdr4 *plcp,
121 const u16 octets, const u8 bitrate)
123 __le32 *data = &(plcp->data);
124 __u8 *raw = plcp->raw;
126 if (b43_is_ofdm_rate(bitrate)) {
129 d = b43_plcp_get_ratecode_ofdm(bitrate);
130 B43_WARN_ON(octets & 0xF000);
132 *data = cpu_to_le32(d);
136 plen = octets * 16 / bitrate;
137 if ((octets * 16 % bitrate) > 0) {
139 if ((bitrate == B43_CCK_RATE_11MB)
140 && ((octets * 8 % 11) < 4)) {
146 *data |= cpu_to_le32(plen << 16);
147 raw[0] = b43_plcp_get_ratecode_cck(bitrate);
151 static u8 b43_calc_fallback_rate(u8 bitrate)
154 case B43_CCK_RATE_1MB:
155 return B43_CCK_RATE_1MB;
156 case B43_CCK_RATE_2MB:
157 return B43_CCK_RATE_1MB;
158 case B43_CCK_RATE_5MB:
159 return B43_CCK_RATE_2MB;
160 case B43_CCK_RATE_11MB:
161 return B43_CCK_RATE_5MB;
162 case B43_OFDM_RATE_6MB:
163 return B43_CCK_RATE_5MB;
164 case B43_OFDM_RATE_9MB:
165 return B43_OFDM_RATE_6MB;
166 case B43_OFDM_RATE_12MB:
167 return B43_OFDM_RATE_9MB;
168 case B43_OFDM_RATE_18MB:
169 return B43_OFDM_RATE_12MB;
170 case B43_OFDM_RATE_24MB:
171 return B43_OFDM_RATE_18MB;
172 case B43_OFDM_RATE_36MB:
173 return B43_OFDM_RATE_24MB;
174 case B43_OFDM_RATE_48MB:
175 return B43_OFDM_RATE_36MB;
176 case B43_OFDM_RATE_54MB:
177 return B43_OFDM_RATE_48MB;
183 /* Generate a TX data header. */
184 int b43_generate_txhdr(struct b43_wldev *dev,
186 const unsigned char *fragment_data,
187 unsigned int fragment_len,
188 const struct ieee80211_tx_info *info,
191 struct b43_txhdr *txhdr = (struct b43_txhdr *)_txhdr;
192 const struct b43_phy *phy = &dev->phy;
193 const struct ieee80211_hdr *wlhdr =
194 (const struct ieee80211_hdr *)fragment_data;
195 int use_encryption = !!info->control.hw_key;
196 __le16 fctl = wlhdr->frame_control;
197 struct ieee80211_rate *fbrate;
199 int rate_ofdm, rate_fb_ofdm;
200 unsigned int plcp_fragment_len;
204 struct ieee80211_rate *txrate;
206 memset(txhdr, 0, sizeof(*txhdr));
208 txrate = ieee80211_get_tx_rate(dev->wl->hw, info);
209 rate = txrate ? txrate->hw_value : B43_CCK_RATE_1MB;
210 rate_ofdm = b43_is_ofdm_rate(rate);
211 fbrate = ieee80211_get_alt_retry_rate(dev->wl->hw, info) ? : txrate;
212 rate_fb = fbrate->hw_value;
213 rate_fb_ofdm = b43_is_ofdm_rate(rate_fb);
216 txhdr->phy_rate = b43_plcp_get_ratecode_ofdm(rate);
218 txhdr->phy_rate = b43_plcp_get_ratecode_cck(rate);
219 txhdr->mac_frame_ctl = wlhdr->frame_control;
220 memcpy(txhdr->tx_receiver, wlhdr->addr1, 6);
222 /* Calculate duration for fallback rate */
223 if ((rate_fb == rate) ||
224 (wlhdr->duration_id & cpu_to_le16(0x8000)) ||
225 (wlhdr->duration_id == cpu_to_le16(0))) {
226 /* If the fallback rate equals the normal rate or the
227 * dur_id field contains an AID, CFP magic or 0,
228 * use the original dur_id field. */
229 txhdr->dur_fb = wlhdr->duration_id;
231 txhdr->dur_fb = ieee80211_generic_frame_duration(
232 dev->wl->hw, info->control.vif, fragment_len, fbrate);
235 plcp_fragment_len = fragment_len + FCS_LEN;
236 if (use_encryption) {
237 u8 key_idx = info->control.hw_key->hw_key_idx;
242 B43_WARN_ON(key_idx >= dev->max_nr_keys);
243 key = &(dev->key[key_idx]);
245 if (unlikely(!key->keyconf)) {
246 /* This key is invalid. This might only happen
247 * in a short timeframe after machine resume before
248 * we were able to reconfigure keys.
249 * Drop this packet completely. Do not transmit it
250 * unencrypted to avoid leaking information. */
254 /* Hardware appends ICV. */
255 plcp_fragment_len += info->control.icv_len;
257 key_idx = b43_kidx_to_fw(dev, key_idx);
258 mac_ctl |= (key_idx << B43_TXH_MAC_KEYIDX_SHIFT) &
260 mac_ctl |= (key->algorithm << B43_TXH_MAC_KEYALG_SHIFT) &
262 wlhdr_len = ieee80211_hdrlen(fctl);
263 iv_len = min((size_t) info->control.iv_len,
264 ARRAY_SIZE(txhdr->iv));
265 memcpy(txhdr->iv, ((u8 *) wlhdr) + wlhdr_len, iv_len);
267 if (b43_is_old_txhdr_format(dev)) {
268 b43_generate_plcp_hdr((struct b43_plcp_hdr4 *)(&txhdr->old_format.plcp),
269 plcp_fragment_len, rate);
271 b43_generate_plcp_hdr((struct b43_plcp_hdr4 *)(&txhdr->new_format.plcp),
272 plcp_fragment_len, rate);
274 b43_generate_plcp_hdr((struct b43_plcp_hdr4 *)(&txhdr->plcp_fb),
275 plcp_fragment_len, rate_fb);
277 /* Extra Frame Types */
279 extra_ft |= B43_TXH_EFT_FB_OFDM;
281 extra_ft |= B43_TXH_EFT_FB_CCK;
283 /* Set channel radio code. Note that the micrcode ORs 0x100 to
284 * this value before comparing it to the value in SHM, if this
287 txhdr->chan_radio_code = phy->channel;
289 /* PHY TX Control word */
291 phy_ctl |= B43_TXH_PHY_ENC_OFDM;
293 phy_ctl |= B43_TXH_PHY_ENC_CCK;
294 if (info->flags & IEEE80211_TX_CTL_SHORT_PREAMBLE)
295 phy_ctl |= B43_TXH_PHY_SHORTPRMBL;
297 switch (b43_ieee80211_antenna_sanitize(dev, info->antenna_sel_tx)) {
298 case 0: /* Default */
299 phy_ctl |= B43_TXH_PHY_ANT01AUTO;
301 case 1: /* Antenna 0 */
302 phy_ctl |= B43_TXH_PHY_ANT0;
304 case 2: /* Antenna 1 */
305 phy_ctl |= B43_TXH_PHY_ANT1;
307 case 3: /* Antenna 2 */
308 phy_ctl |= B43_TXH_PHY_ANT2;
310 case 4: /* Antenna 3 */
311 phy_ctl |= B43_TXH_PHY_ANT3;
318 if (!(info->flags & IEEE80211_TX_CTL_NO_ACK))
319 mac_ctl |= B43_TXH_MAC_ACK;
320 /* use hardware sequence counter as the non-TID counter */
321 if (info->flags & IEEE80211_TX_CTL_ASSIGN_SEQ)
322 mac_ctl |= B43_TXH_MAC_HWSEQ;
323 if (info->flags & IEEE80211_TX_CTL_FIRST_FRAGMENT)
324 mac_ctl |= B43_TXH_MAC_STMSDU;
325 if (phy->type == B43_PHYTYPE_A)
326 mac_ctl |= B43_TXH_MAC_5GHZ;
327 if (info->flags & IEEE80211_TX_CTL_LONG_RETRY_LIMIT)
328 mac_ctl |= B43_TXH_MAC_LONGFRAME;
330 /* Generate the RTS or CTS-to-self frame */
331 if ((info->flags & IEEE80211_TX_CTL_USE_RTS_CTS) ||
332 (info->flags & IEEE80211_TX_CTL_USE_CTS_PROTECT)) {
334 struct ieee80211_hdr *hdr;
335 int rts_rate, rts_rate_fb;
336 int rts_rate_ofdm, rts_rate_fb_ofdm;
337 struct b43_plcp_hdr6 *plcp;
338 struct ieee80211_rate *rts_cts_rate;
340 rts_cts_rate = ieee80211_get_rts_cts_rate(dev->wl->hw, info);
342 rts_rate = rts_cts_rate ? rts_cts_rate->hw_value : B43_CCK_RATE_1MB;
343 rts_rate_ofdm = b43_is_ofdm_rate(rts_rate);
344 rts_rate_fb = b43_calc_fallback_rate(rts_rate);
345 rts_rate_fb_ofdm = b43_is_ofdm_rate(rts_rate_fb);
347 if (info->flags & IEEE80211_TX_CTL_USE_CTS_PROTECT) {
348 struct ieee80211_cts *cts;
350 if (b43_is_old_txhdr_format(dev)) {
351 cts = (struct ieee80211_cts *)
352 (txhdr->old_format.rts_frame);
354 cts = (struct ieee80211_cts *)
355 (txhdr->new_format.rts_frame);
357 ieee80211_ctstoself_get(dev->wl->hw, info->control.vif,
358 fragment_data, fragment_len,
360 mac_ctl |= B43_TXH_MAC_SENDCTS;
361 len = sizeof(struct ieee80211_cts);
363 struct ieee80211_rts *rts;
365 if (b43_is_old_txhdr_format(dev)) {
366 rts = (struct ieee80211_rts *)
367 (txhdr->old_format.rts_frame);
369 rts = (struct ieee80211_rts *)
370 (txhdr->new_format.rts_frame);
372 ieee80211_rts_get(dev->wl->hw, info->control.vif,
373 fragment_data, fragment_len,
375 mac_ctl |= B43_TXH_MAC_SENDRTS;
376 len = sizeof(struct ieee80211_rts);
380 /* Generate the PLCP headers for the RTS/CTS frame */
381 if (b43_is_old_txhdr_format(dev))
382 plcp = &txhdr->old_format.rts_plcp;
384 plcp = &txhdr->new_format.rts_plcp;
385 b43_generate_plcp_hdr((struct b43_plcp_hdr4 *)plcp,
387 plcp = &txhdr->rts_plcp_fb;
388 b43_generate_plcp_hdr((struct b43_plcp_hdr4 *)plcp,
391 if (b43_is_old_txhdr_format(dev)) {
392 hdr = (struct ieee80211_hdr *)
393 (&txhdr->old_format.rts_frame);
395 hdr = (struct ieee80211_hdr *)
396 (&txhdr->new_format.rts_frame);
398 txhdr->rts_dur_fb = hdr->duration_id;
401 extra_ft |= B43_TXH_EFT_RTS_OFDM;
402 txhdr->phy_rate_rts =
403 b43_plcp_get_ratecode_ofdm(rts_rate);
405 extra_ft |= B43_TXH_EFT_RTS_CCK;
406 txhdr->phy_rate_rts =
407 b43_plcp_get_ratecode_cck(rts_rate);
409 if (rts_rate_fb_ofdm)
410 extra_ft |= B43_TXH_EFT_RTSFB_OFDM;
412 extra_ft |= B43_TXH_EFT_RTSFB_CCK;
416 if (b43_is_old_txhdr_format(dev))
417 txhdr->old_format.cookie = cpu_to_le16(cookie);
419 txhdr->new_format.cookie = cpu_to_le16(cookie);
421 /* Apply the bitfields */
422 txhdr->mac_ctl = cpu_to_le32(mac_ctl);
423 txhdr->phy_ctl = cpu_to_le16(phy_ctl);
424 txhdr->extra_ft = extra_ft;
429 static s8 b43_rssi_postprocess(struct b43_wldev *dev,
430 u8 in_rssi, int ofdm,
431 int adjust_2053, int adjust_2050)
433 struct b43_phy *phy = &dev->phy;
436 switch (phy->radio_ver) {
449 if (dev->dev->bus->sprom.
450 boardflags_lo & B43_BFL_RSSI) {
453 tmp = phy->nrssi_lt[in_rssi];
465 if (phy->type == B43_PHYTYPE_G && adjust_2050)
491 static s8 b43_rssinoise_postprocess(struct b43_wldev *dev, u8 in_rssi)
493 struct b43_phy *phy = &dev->phy;
496 if (phy->type == B43_PHYTYPE_A) {
497 //TODO: Incomplete specs.
500 ret = b43_rssi_postprocess(dev, in_rssi, 0, 1, 1);
506 void b43_rx(struct b43_wldev *dev, struct sk_buff *skb, const void *_rxhdr)
508 struct ieee80211_rx_status status;
509 struct b43_plcp_hdr6 *plcp;
510 struct ieee80211_hdr *wlhdr;
511 const struct b43_rxhdr_fw4 *rxhdr = _rxhdr;
513 u16 phystat0, phystat3, chanstat, mactime;
519 memset(&status, 0, sizeof(status));
521 /* Get metadata about the frame from the header. */
522 phystat0 = le16_to_cpu(rxhdr->phy_status0);
523 phystat3 = le16_to_cpu(rxhdr->phy_status3);
524 macstat = le32_to_cpu(rxhdr->mac_status);
525 mactime = le16_to_cpu(rxhdr->mac_time);
526 chanstat = le16_to_cpu(rxhdr->channel);
527 phytype = chanstat & B43_RX_CHAN_PHYTYPE;
529 if (macstat & B43_RX_MAC_FCSERR)
530 dev->wl->ieee_stats.dot11FCSErrorCount++;
531 if (macstat & B43_RX_MAC_DECERR) {
532 /* Decryption with the given key failed.
533 * Drop the packet. We also won't be able to decrypt it with
534 * the key in software. */
538 /* Skip PLCP and padding */
539 padding = (macstat & B43_RX_MAC_PADDING) ? 2 : 0;
540 if (unlikely(skb->len < (sizeof(struct b43_plcp_hdr6) + padding))) {
541 b43dbg(dev->wl, "RX: Packet size underrun (1)\n");
544 plcp = (struct b43_plcp_hdr6 *)(skb->data + padding);
545 skb_pull(skb, sizeof(struct b43_plcp_hdr6) + padding);
546 /* The skb contains the Wireless Header + payload data now */
547 if (unlikely(skb->len < (2 + 2 + 6 /*minimum hdr */ + FCS_LEN))) {
548 b43dbg(dev->wl, "RX: Packet size underrun (2)\n");
551 wlhdr = (struct ieee80211_hdr *)(skb->data);
552 fctl = wlhdr->frame_control;
554 if (macstat & B43_RX_MAC_DEC) {
558 keyidx = ((macstat & B43_RX_MAC_KEYIDX)
559 >> B43_RX_MAC_KEYIDX_SHIFT);
560 /* We must adjust the key index here. We want the "physical"
561 * key index, but the ucode passed it slightly different.
563 keyidx = b43_kidx_to_raw(dev, keyidx);
564 B43_WARN_ON(keyidx >= dev->max_nr_keys);
566 if (dev->key[keyidx].algorithm != B43_SEC_ALGO_NONE) {
567 wlhdr_len = ieee80211_hdrlen(fctl);
568 if (unlikely(skb->len < (wlhdr_len + 3))) {
570 "RX: Packet size underrun (3)\n");
573 status.flag |= RX_FLAG_DECRYPTED;
577 /* Link quality statistics */
578 status.noise = dev->stats.link_noise;
579 if ((chanstat & B43_RX_CHAN_PHYTYPE) == B43_PHYTYPE_N) {
580 // s8 rssi = max(rxhdr->power0, rxhdr->power1);
581 //TODO: Find out what the rssi value is (dBm or percentage?)
582 // and also find out what the maximum possible value is.
583 // Fill status.ssi and status.signal fields.
585 status.signal = b43_rssi_postprocess(dev, rxhdr->jssi,
586 (phystat0 & B43_RX_PHYST0_OFDM),
587 (phystat0 & B43_RX_PHYST0_GAINCTL),
588 (phystat3 & B43_RX_PHYST3_TRSTATE));
589 status.qual = (rxhdr->jssi * 100) / B43_RX_MAX_SSI;
592 if (phystat0 & B43_RX_PHYST0_OFDM)
593 status.rate_idx = b43_plcp_get_bitrate_idx_ofdm(plcp,
594 phytype == B43_PHYTYPE_A);
596 status.rate_idx = b43_plcp_get_bitrate_idx_cck(plcp);
597 status.antenna = !!(phystat0 & B43_RX_PHYST0_ANT);
600 * All frames on monitor interfaces and beacons always need a full
601 * 64-bit timestamp. Monitor interfaces need it for diagnostic
602 * purposes and beacons for IBSS merging.
603 * This code assumes we get to process the packet within 16 bits
604 * of timestamp, i.e. about 65 milliseconds after the PHY received
607 if (ieee80211_is_beacon(fctl) || dev->wl->radiotap_enabled) {
610 b43_tsf_read(dev, &status.mactime);
611 low_mactime_now = status.mactime;
612 status.mactime = status.mactime & ~0xFFFFULL;
613 status.mactime += mactime;
614 if (low_mactime_now <= mactime)
615 status.mactime -= 0x10000;
616 status.flag |= RX_FLAG_TSFT;
619 chanid = (chanstat & B43_RX_CHAN_ID) >> B43_RX_CHAN_ID_SHIFT;
620 switch (chanstat & B43_RX_CHAN_PHYTYPE) {
622 status.band = IEEE80211_BAND_5GHZ;
624 /* FIXME: We don't really know which value the "chanid" contains.
625 * So the following assignment might be wrong. */
626 status.freq = b43_channel_to_freq_5ghz(chanid);
629 status.band = IEEE80211_BAND_2GHZ;
630 /* chanid is the radio channel cookie value as used
631 * to tune the radio. */
632 status.freq = chanid + 2400;
635 /* chanid is the SHM channel cookie. Which is the plain
636 * channel number in b43. */
637 if (chanstat & B43_RX_CHAN_5GHZ) {
638 status.band = IEEE80211_BAND_5GHZ;
639 status.freq = b43_freq_to_channel_5ghz(chanid);
641 status.band = IEEE80211_BAND_2GHZ;
642 status.freq = b43_freq_to_channel_2ghz(chanid);
650 dev->stats.last_rx = jiffies;
651 ieee80211_rx_irqsafe(dev->wl->hw, skb, &status);
655 b43dbg(dev->wl, "RX: Packet dropped\n");
656 dev_kfree_skb_any(skb);
659 void b43_handle_txstatus(struct b43_wldev *dev,
660 const struct b43_txstatus *status)
662 b43_debugfs_log_txstat(dev, status);
664 if (status->intermediate)
666 if (status->for_ampdu)
669 dev->wl->ieee_stats.dot11ACKFailureCount++;
670 if (status->rts_count) {
671 if (status->rts_count == 0xF) //FIXME
672 dev->wl->ieee_stats.dot11RTSFailureCount++;
674 dev->wl->ieee_stats.dot11RTSSuccessCount++;
677 if (b43_using_pio_transfers(dev))
678 b43_pio_handle_txstatus(dev, status);
680 b43_dma_handle_txstatus(dev, status);
683 /* Fill out the mac80211 TXstatus report based on the b43-specific
684 * txstatus report data. This returns a boolean whether the frame was
685 * successfully transmitted. */
686 bool b43_fill_txstatus_report(struct ieee80211_tx_info *report,
687 const struct b43_txstatus *status)
689 bool frame_success = 1;
692 /* The frame was ACKed. */
693 report->flags |= IEEE80211_TX_STAT_ACK;
695 /* The frame was not ACKed... */
696 if (!(report->flags & IEEE80211_TX_CTL_NO_ACK)) {
697 /* ...but we expected an ACK. */
699 report->status.excessive_retries = 1;
702 if (status->frame_count == 0) {
703 /* The frame was not transmitted at all. */
704 report->status.retry_count = 0;
706 report->status.retry_count = status->frame_count - 1;
708 return frame_success;
711 /* Stop any TX operation on the device (suspend the hardware queues) */
712 void b43_tx_suspend(struct b43_wldev *dev)
714 if (b43_using_pio_transfers(dev))
715 b43_pio_tx_suspend(dev);
717 b43_dma_tx_suspend(dev);
720 /* Resume any TX operation on the device (resume the hardware queues) */
721 void b43_tx_resume(struct b43_wldev *dev)
723 if (b43_using_pio_transfers(dev))
724 b43_pio_tx_resume(dev);
726 b43_dma_tx_resume(dev);