net/mac80211/ht.c

   1 /*
   2  * HT handling
   3  *
   4  * Copyright 2003, Jouni Malinen <jkmaline@cc.hut.fi>
   5  * Copyright 2002-2005, Instant802 Networks, Inc.
   6  * Copyright 2005-2006, Devicescape Software, Inc.
   7  * Copyright 2006-2007  Jiri Benc <jbenc@suse.cz>
   8  * Copyright 2007, Michael Wu <flamingice@sourmilk.net>
   9  * Copyright 2007-2010, Intel Corporation
  10  *
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License version 2 as
  13  * published by the Free Software Foundation.
  14  */
  15
  16 #include <linux/ieee80211.h>
  17 #include <linux/export.h>
  18 #include <net/mac80211.h>
  19 #include "ieee80211_i.h"
  20 #include "rate.h"
  21
  22 static void __check_htcap_disable(struct ieee80211_sub_if_data *sdata,
  23                                   struct ieee80211_sta_ht_cap *ht_cap,
  24                                   u16 flag)
  25 {
  26         __le16 le_flag = cpu_to_le16(flag);
  27         if (sdata->u.mgd.ht_capa_mask.cap_info & le_flag) {
  28                 if (!(sdata->u.mgd.ht_capa.cap_info & le_flag))
  29                         ht_cap->cap &= ~flag;
  30         }
  31 }
  32
  33 void ieee80211_apply_htcap_overrides(struct ieee80211_sub_if_data *sdata,
  34                                      struct ieee80211_sta_ht_cap *ht_cap)
  35 {
  36         u8 *scaps = (u8 *)(&sdata->u.mgd.ht_capa.mcs.rx_mask);
  37         u8 *smask = (u8 *)(&sdata->u.mgd.ht_capa_mask.mcs.rx_mask);
  38         int i;
  39
  40         if (!ht_cap->ht_supported)
  41                 return;
  42
  43         if (sdata->vif.type != NL80211_IFTYPE_STATION) {
  44                 /* AP interfaces call this code when adding new stations,
  45                  * so just silently ignore non station interfaces.
  46                  */
  47                 return;
  48         }
  49
  50         /* NOTE:  If you add more over-rides here, update register_hw
  51          * ht_capa_mod_msk logic in main.c as well.
  52          * And, if this method can ever change ht_cap.ht_supported, fix
  53          * the check in ieee80211_add_ht_ie.
  54          */
  55
  56         /* check for HT over-rides, MCS rates first. */
  57         for (i = 0; i < IEEE80211_HT_MCS_MASK_LEN; i++) {
  58                 u8 m = smask[i];
  59                 ht_cap->mcs.rx_mask[i] &= ~m; /* turn off all masked bits */
  60                 /* Add back rates that are supported */
  61                 ht_cap->mcs.rx_mask[i] |= (m & scaps[i]);
  62         }
  63
  64         /* Force removal of HT-40 capabilities? */
  65         __check_htcap_disable(sdata, ht_cap, IEEE80211_HT_CAP_SUP_WIDTH_20_40);
  66         __check_htcap_disable(sdata, ht_cap, IEEE80211_HT_CAP_SGI_40);
  67
  68         /* Allow user to disable SGI-20 (SGI-40 is handled above) */
  69         __check_htcap_disable(sdata, ht_cap, IEEE80211_HT_CAP_SGI_20);
  70
  71         /* Allow user to disable the max-AMSDU bit. */
  72         __check_htcap_disable(sdata, ht_cap, IEEE80211_HT_CAP_MAX_AMSDU);
  73
  74         /* Allow user to decrease AMPDU factor */
  75         if (sdata->u.mgd.ht_capa_mask.ampdu_params_info &
  76             IEEE80211_HT_AMPDU_PARM_FACTOR) {
  77                 u8 n = sdata->u.mgd.ht_capa.ampdu_params_info
  78                         & IEEE80211_HT_AMPDU_PARM_FACTOR;
  79                 if (n < ht_cap->ampdu_factor)
  80                         ht_cap->ampdu_factor = n;
  81         }
  82
  83         /* Allow the user to increase AMPDU density. */
  84         if (sdata->u.mgd.ht_capa_mask.ampdu_params_info &
  85             IEEE80211_HT_AMPDU_PARM_DENSITY) {
  86                 u8 n = (sdata->u.mgd.ht_capa.ampdu_params_info &
  87                         IEEE80211_HT_AMPDU_PARM_DENSITY)
  88                         >> IEEE80211_HT_AMPDU_PARM_DENSITY_SHIFT;
  89                 if (n > ht_cap->ampdu_density)
  90                         ht_cap->ampdu_density = n;
  91         }
  92 }
  93
  94
  95 bool ieee80211_ht_cap_ie_to_sta_ht_cap(struct ieee80211_sub_if_data *sdata,
  96                                        struct ieee80211_supported_band *sband,
  97                                        const struct ieee80211_ht_cap *ht_cap_ie,
  98                                        struct sta_info *sta)
  99 {
 100         struct ieee80211_sta_ht_cap ht_cap;
 101         u8 ampdu_info, tx_mcs_set_cap;
 102         int i, max_tx_streams;
 103         bool changed;
 104         enum ieee80211_sta_rx_bandwidth bw;
 105         enum ieee80211_smps_mode smps_mode;
 106
 107         memset(&ht_cap, 0, sizeof(ht_cap));
 108
 109         if (!ht_cap_ie || !sband->ht_cap.ht_supported)
 110                 goto apply;
 111
 112         ht_cap.ht_supported = true;
 113
 114         /*
 115          * The bits listed in this expression should be
 116          * the same for the peer and us, if the station
 117          * advertises more then we can't use those thus
 118          * we mask them out.
 119          */
 120         ht_cap.cap = le16_to_cpu(ht_cap_ie->cap_info) &
 121                 (sband->ht_cap.cap |
 122                  ~(IEEE80211_HT_CAP_LDPC_CODING |
 123                    IEEE80211_HT_CAP_SUP_WIDTH_20_40 |
 124                    IEEE80211_HT_CAP_GRN_FLD |
 125                    IEEE80211_HT_CAP_SGI_20 |
 126                    IEEE80211_HT_CAP_SGI_40 |
 127                    IEEE80211_HT_CAP_DSSSCCK40));
 128
 129         /*
 130          * The STBC bits are asymmetric -- if we don't have
 131          * TX then mask out the peer's RX and vice versa.
 132          */
 133         if (!(sband->ht_cap.cap & IEEE80211_HT_CAP_TX_STBC))
 134                 ht_cap.cap &= ~IEEE80211_HT_CAP_RX_STBC;
 135         if (!(sband->ht_cap.cap & IEEE80211_HT_CAP_RX_STBC))
 136                 ht_cap.cap &= ~IEEE80211_HT_CAP_TX_STBC;
 137
 138         ampdu_info = ht_cap_ie->ampdu_params_info;
 139         ht_cap.ampdu_factor =
 140                 ampdu_info & IEEE80211_HT_AMPDU_PARM_FACTOR;
 141         ht_cap.ampdu_density =
 142                 (ampdu_info & IEEE80211_HT_AMPDU_PARM_DENSITY) >> 2;
 143
 144         /* own MCS TX capabilities */
 145         tx_mcs_set_cap = sband->ht_cap.mcs.tx_params;
 146
 147         /* Copy peer MCS TX capabilities, the driver might need them. */
 148         ht_cap.mcs.tx_params = ht_cap_ie->mcs.tx_params;
 149
 150         /* can we TX with MCS rates? */
 151         if (!(tx_mcs_set_cap & IEEE80211_HT_MCS_TX_DEFINED))
 152                 goto apply;
 153
 154         /* Counting from 0, therefore +1 */
 155         if (tx_mcs_set_cap & IEEE80211_HT_MCS_TX_RX_DIFF)
 156                 max_tx_streams =
 157                         ((tx_mcs_set_cap & IEEE80211_HT_MCS_TX_MAX_STREAMS_MASK)
 158                                 >> IEEE80211_HT_MCS_TX_MAX_STREAMS_SHIFT) + 1;
 159         else
 160                 max_tx_streams = IEEE80211_HT_MCS_TX_MAX_STREAMS;
 161
 162         /*
 163          * 802.11n-2009 20.3.5 / 20.6 says:
 164          * - indices 0 to 7 and 32 are single spatial stream
 165          * - 8 to 31 are multiple spatial streams using equal modulation
 166          *   [8..15 for two streams, 16..23 for three and 24..31 for four]
 167          * - remainder are multiple spatial streams using unequal modulation
 168          */
 169         for (i = 0; i < max_tx_streams; i++)
 170                 ht_cap.mcs.rx_mask[i] =
 171                         sband->ht_cap.mcs.rx_mask[i] & ht_cap_ie->mcs.rx_mask[i];
 172
 173         if (tx_mcs_set_cap & IEEE80211_HT_MCS_TX_UNEQUAL_MODULATION)
 174                 for (i = IEEE80211_HT_MCS_UNEQUAL_MODULATION_START_BYTE;
 175                      i < IEEE80211_HT_MCS_MASK_LEN; i++)
 176                         ht_cap.mcs.rx_mask[i] =
 177                                 sband->ht_cap.mcs.rx_mask[i] &
 178                                         ht_cap_ie->mcs.rx_mask[i];
 179
 180         /* handle MCS rate 32 too */
 181         if (sband->ht_cap.mcs.rx_mask[32/8] & ht_cap_ie->mcs.rx_mask[32/8] & 1)
 182                 ht_cap.mcs.rx_mask[32/8] |= 1;
 183
 184  apply:
 185         /*
 186          * If user has specified capability over-rides, take care
 187          * of that here.
 188          */
 189         ieee80211_apply_htcap_overrides(sdata, &ht_cap);
 190
 191         changed = memcmp(&sta->sta.ht_cap, &ht_cap, sizeof(ht_cap));
 192
 193         memcpy(&sta->sta.ht_cap, &ht_cap, sizeof(ht_cap));
 194
 195         switch (sdata->vif.bss_conf.chandef.width) {
 196         default:
 197                 WARN_ON_ONCE(1);
 198                 /* fall through */
 199         case NL80211_CHAN_WIDTH_20_NOHT:
 200         case NL80211_CHAN_WIDTH_20:
 201                 bw = IEEE80211_STA_RX_BW_20;
 202                 break;
 203         case NL80211_CHAN_WIDTH_40:
 204         case NL80211_CHAN_WIDTH_80:
 205         case NL80211_CHAN_WIDTH_80P80:
 206         case NL80211_CHAN_WIDTH_160:
 207                 bw = ht_cap.cap & IEEE80211_HT_CAP_SUP_WIDTH_20_40 ?
 208                                 IEEE80211_STA_RX_BW_40 : IEEE80211_STA_RX_BW_20;
 209                 break;
 210         }
 211
 212         if (bw != sta->sta.bandwidth)
 213                 changed = true;
 214         sta->sta.bandwidth = bw;
 215
 216         sta->cur_max_bandwidth =
 217                 ht_cap.cap & IEEE80211_HT_CAP_SUP_WIDTH_20_40 ?
 218                                 IEEE80211_STA_RX_BW_40 : IEEE80211_STA_RX_BW_20;
 219
 220         switch ((ht_cap.cap & IEEE80211_HT_CAP_SM_PS)
 221                         >> IEEE80211_HT_CAP_SM_PS_SHIFT) {
 222         case WLAN_HT_CAP_SM_PS_INVALID:
 223         case WLAN_HT_CAP_SM_PS_STATIC:
 224                 smps_mode = IEEE80211_SMPS_STATIC;
 225                 break;
 226         case WLAN_HT_CAP_SM_PS_DYNAMIC:
 227                 smps_mode = IEEE80211_SMPS_DYNAMIC;
 228                 break;
 229         case WLAN_HT_CAP_SM_PS_DISABLED:
 230                 smps_mode = IEEE80211_SMPS_OFF;
 231                 break;
 232         }
 233
 234         if (smps_mode != sta->sta.smps_mode)
 235                 changed = true;
 236         sta->sta.smps_mode = smps_mode;
 237
 238         return changed;
 239 }
 240
 241 void ieee80211_sta_tear_down_BA_sessions(struct sta_info *sta,
 242                                          enum ieee80211_agg_stop_reason reason)
 243 {
 244         int i;
 245
 246         cancel_work_sync(&sta->ampdu_mlme.work);
 247
 248         for (i = 0; i <  IEEE80211_NUM_TIDS; i++) {
 249                 __ieee80211_stop_tx_ba_session(sta, i, reason);
 250                 __ieee80211_stop_rx_ba_session(sta, i, WLAN_BACK_RECIPIENT,
 251                                                WLAN_REASON_QSTA_LEAVE_QBSS,
 252                                                reason != AGG_STOP_DESTROY_STA &&
 253                                                reason != AGG_STOP_PEER_REQUEST);
 254         }
 255 }
 256
 257 void ieee80211_ba_session_work(struct work_struct *work)
 258 {
 259         struct sta_info *sta =
 260                 container_of(work, struct sta_info, ampdu_mlme.work);
 261         struct tid_ampdu_tx *tid_tx;
 262         int tid;
 263
 264         /*
 265          * When this flag is set, new sessions should be
 266          * blocked, and existing sessions will be torn
 267          * down by the code that set the flag, so this
 268          * need not run.
 269          */
 270         if (test_sta_flag(sta, WLAN_STA_BLOCK_BA))
 271                 return;
 272
 273         mutex_lock(&sta->ampdu_mlme.mtx);
 274         for (tid = 0; tid < IEEE80211_NUM_TIDS; tid++) {
 275                 if (test_and_clear_bit(tid, sta->ampdu_mlme.tid_rx_timer_expired))
 276                         ___ieee80211_stop_rx_ba_session(
 277                                 sta, tid, WLAN_BACK_RECIPIENT,
 278                                 WLAN_REASON_QSTA_TIMEOUT, true);
 279
 280                 if (test_and_clear_bit(tid,
 281                                        sta->ampdu_mlme.tid_rx_stop_requested))
 282                         ___ieee80211_stop_rx_ba_session(
 283                                 sta, tid, WLAN_BACK_RECIPIENT,
 284                                 WLAN_REASON_UNSPECIFIED, true);
 285
 286                 tid_tx = sta->ampdu_mlme.tid_start_tx[tid];
 287                 if (tid_tx) {
 288                         /*
 289                          * Assign it over to the normal tid_tx array
 290                          * where it "goes live".
 291                          */
 292                         spin_lock_bh(&sta->lock);
 293
 294                         sta->ampdu_mlme.tid_start_tx[tid] = NULL;
 295                         /* could there be a race? */
 296                         if (sta->ampdu_mlme.tid_tx[tid])
 297                                 kfree(tid_tx);
 298                         else
 299                                 ieee80211_assign_tid_tx(sta, tid, tid_tx);
 300                         spin_unlock_bh(&sta->lock);
 301
 302                         ieee80211_tx_ba_session_handle_start(sta, tid);
 303                         continue;
 304                 }
 305
 306                 tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 307                 if (tid_tx && test_and_clear_bit(HT_AGG_STATE_WANT_STOP,
 308                                                  &tid_tx->state))
 309                         ___ieee80211_stop_tx_ba_session(sta, tid,
 310                                                         AGG_STOP_LOCAL_REQUEST);
 311         }
 312         mutex_unlock(&sta->ampdu_mlme.mtx);
 313 }
 314
 315 void ieee80211_send_delba(struct ieee80211_sub_if_data *sdata,
 316                           const u8 *da, u16 tid,
 317                           u16 initiator, u16 reason_code)
 318 {
 319         struct ieee80211_local *local = sdata->local;
 320         struct sk_buff *skb;
 321         struct ieee80211_mgmt *mgmt;
 322         u16 params;
 323
 324         skb = dev_alloc_skb(sizeof(*mgmt) + local->hw.extra_tx_headroom);
 325         if (!skb)
 326                 return;
 327
 328         skb_reserve(skb, local->hw.extra_tx_headroom);
 329         mgmt = (struct ieee80211_mgmt *) skb_put(skb, 24);
 330         memset(mgmt, 0, 24);
 331         memcpy(mgmt->da, da, ETH_ALEN);
 332         memcpy(mgmt->sa, sdata->vif.addr, ETH_ALEN);
 333         if (sdata->vif.type == NL80211_IFTYPE_AP ||
 334             sdata->vif.type == NL80211_IFTYPE_AP_VLAN ||
 335             sdata->vif.type == NL80211_IFTYPE_MESH_POINT)
 336                 memcpy(mgmt->bssid, sdata->vif.addr, ETH_ALEN);
 337         else if (sdata->vif.type == NL80211_IFTYPE_STATION)
 338                 memcpy(mgmt->bssid, sdata->u.mgd.bssid, ETH_ALEN);
 339         else if (sdata->vif.type == NL80211_IFTYPE_ADHOC)
 340                 memcpy(mgmt->bssid, sdata->u.ibss.bssid, ETH_ALEN);
 341
 342         mgmt->frame_control = cpu_to_le16(IEEE80211_FTYPE_MGMT |
 343                                           IEEE80211_STYPE_ACTION);
 344
 345         skb_put(skb, 1 + sizeof(mgmt->u.action.u.delba));
 346
 347         mgmt->u.action.category = WLAN_CATEGORY_BACK;
 348         mgmt->u.action.u.delba.action_code = WLAN_ACTION_DELBA;
 349         params = (u16)(initiator << 11);        /* bit 11 initiator */
 350         params |= (u16)(tid << 12);             /* bit 15:12 TID number */
 351
 352         mgmt->u.action.u.delba.params = cpu_to_le16(params);
 353         mgmt->u.action.u.delba.reason_code = cpu_to_le16(reason_code);
 354
 355         ieee80211_tx_skb_tid(sdata, skb, tid);
 356 }
 357
 358 void ieee80211_process_delba(struct ieee80211_sub_if_data *sdata,
 359                              struct sta_info *sta,
 360                              struct ieee80211_mgmt *mgmt, size_t len)
 361 {
 362         u16 tid, params;
 363         u16 initiator;
 364
 365         params = le16_to_cpu(mgmt->u.action.u.delba.params);
 366         tid = (params & IEEE80211_DELBA_PARAM_TID_MASK) >> 12;
 367         initiator = (params & IEEE80211_DELBA_PARAM_INITIATOR_MASK) >> 11;
 368
 369         ht_dbg_ratelimited(sdata, "delba from %pM (%s) tid %d reason code %d\n",
 370                            mgmt->sa, initiator ? "initiator" : "recipient",
 371                            tid,
 372                            le16_to_cpu(mgmt->u.action.u.delba.reason_code));
 373
 374         if (initiator == WLAN_BACK_INITIATOR)
 375                 __ieee80211_stop_rx_ba_session(sta, tid, WLAN_BACK_INITIATOR, 0,
 376                                                true);
 377         else
 378                 __ieee80211_stop_tx_ba_session(sta, tid, AGG_STOP_PEER_REQUEST);
 379 }
 380
 381 int ieee80211_send_smps_action(struct ieee80211_sub_if_data *sdata,
 382                                enum ieee80211_smps_mode smps, const u8 *da,
 383                                const u8 *bssid)
 384 {
 385         struct ieee80211_local *local = sdata->local;
 386         struct sk_buff *skb;
 387         struct ieee80211_mgmt *action_frame;
 388
 389         /* 27 = header + category + action + smps mode */
 390         skb = dev_alloc_skb(27 + local->hw.extra_tx_headroom);
 391         if (!skb)
 392                 return -ENOMEM;
 393
 394         skb_reserve(skb, local->hw.extra_tx_headroom);
 395         action_frame = (void *)skb_put(skb, 27);
 396         memcpy(action_frame->da, da, ETH_ALEN);
 397         memcpy(action_frame->sa, sdata->dev->dev_addr, ETH_ALEN);
 398         memcpy(action_frame->bssid, bssid, ETH_ALEN);
 399         action_frame->frame_control = cpu_to_le16(IEEE80211_FTYPE_MGMT |
 400                                                   IEEE80211_STYPE_ACTION);
 401         action_frame->u.action.category = WLAN_CATEGORY_HT;
 402         action_frame->u.action.u.ht_smps.action = WLAN_HT_ACTION_SMPS;
 403         switch (smps) {
 404         case IEEE80211_SMPS_AUTOMATIC:
 405         case IEEE80211_SMPS_NUM_MODES:
 406                 WARN_ON(1);
 407         case IEEE80211_SMPS_OFF:
 408                 action_frame->u.action.u.ht_smps.smps_control =
 409                                 WLAN_HT_SMPS_CONTROL_DISABLED;
 410                 break;
 411         case IEEE80211_SMPS_STATIC:
 412                 action_frame->u.action.u.ht_smps.smps_control =
 413                                 WLAN_HT_SMPS_CONTROL_STATIC;
 414                 break;
 415         case IEEE80211_SMPS_DYNAMIC:
 416                 action_frame->u.action.u.ht_smps.smps_control =
 417                                 WLAN_HT_SMPS_CONTROL_DYNAMIC;
 418                 break;
 419         }
 420
 421         /* we'll do more on status of this frame */
 422         IEEE80211_SKB_CB(skb)->flags |= IEEE80211_TX_CTL_REQ_TX_STATUS;
 423         ieee80211_tx_skb(sdata, skb);
 424
 425         return 0;
 426 }
 427
 428 void ieee80211_request_smps_work(struct work_struct *work)
 429 {
 430         struct ieee80211_sub_if_data *sdata =
 431                 container_of(work, struct ieee80211_sub_if_data,
 432                              u.mgd.request_smps_work);
 433
 434         mutex_lock(&sdata->u.mgd.mtx);
 435         __ieee80211_request_smps(sdata, sdata->u.mgd.driver_smps_mode);
 436         mutex_unlock(&sdata->u.mgd.mtx);
 437 }
 438
 439 void ieee80211_request_smps(struct ieee80211_vif *vif,
 440                             enum ieee80211_smps_mode smps_mode)
 441 {
 442         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 443
 444         if (WARN_ON(vif->type != NL80211_IFTYPE_STATION))
 445                 return;
 446
 447         if (WARN_ON(smps_mode == IEEE80211_SMPS_OFF))
 448                 smps_mode = IEEE80211_SMPS_AUTOMATIC;
 449
 450         if (sdata->u.mgd.driver_smps_mode == smps_mode)
 451                 return;
 452
 453         sdata->u.mgd.driver_smps_mode = smps_mode;
 454
 455         ieee80211_queue_work(&sdata->local->hw,
 456                              &sdata->u.mgd.request_smps_work);
 457 }
 458 /* this might change ... don't want non-open drivers using it */
 459 EXPORT_SYMBOL_GPL(ieee80211_request_smps);