drivers/net/wireless/iwlwifi/iwl-sta.h

   1 /******************************************************************************
   2  *
   3  * Copyright(c) 2003 - 2010 Intel Corporation. All rights reserved.
   4  *
   5  * Portions of this file are derived from the ipw3945 project, as well
   6  * as portions of the ieee80211 subsystem header files.
   7  *
   8  * This program is free software; you can redistribute it and/or modify it
   9  * under the terms of version 2 of the GNU General Public License as
  10  * published by the Free Software Foundation.
  11  *
  12  * This program is distributed in the hope that it will be useful, but WITHOUT
  13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  15  * more details.
  16  *
  17  * You should have received a copy of the GNU General Public License along with
  18  * this program; if not, write to the Free Software Foundation, Inc.,
  19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
  20  *
  21  * The full GNU General Public License is included in this distribution in the
  22  * file called LICENSE.
  23  *
  24  * Contact Information:
  25  *  Intel Linux Wireless <ilw@linux.intel.com>
  26  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  27  *
  28  *****************************************************************************/
  29 #ifndef __iwl_sta_h__
  30 #define __iwl_sta_h__
  31
  32 #include "iwl-dev.h"
  33
  34 #define HW_KEY_DYNAMIC 0
  35 #define HW_KEY_DEFAULT 1
  36
  37 #define IWL_STA_DRIVER_ACTIVE BIT(0) /* driver entry is active */
  38 #define IWL_STA_UCODE_ACTIVE  BIT(1) /* ucode entry is active */
  39 #define IWL_STA_UCODE_INPROGRESS  BIT(2) /* ucode entry is in process of
  40                                             being activated */
  41 #define IWL_STA_LOCAL BIT(3) /* station state not directed by mac80211;
  42                                 (this is for the IBSS BSSID stations) */
  43 #define IWL_STA_BCAST BIT(4) /* this station is the special bcast station */
  44
  45
  46 void iwl_restore_stations(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  47 void iwl_clear_ucode_stations(struct iwl_priv *priv,
  48                               struct iwl_rxon_context *ctx);
  49 void iwl_dealloc_bcast_stations(struct iwl_priv *priv);
  50 int iwl_get_free_ucode_key_index(struct iwl_priv *priv);
  51 int iwl_send_add_sta(struct iwl_priv *priv,
  52                      struct iwl_addsta_cmd *sta, u8 flags);
  53 int iwl_add_station_common(struct iwl_priv *priv, struct iwl_rxon_context *ctx,
  54                            const u8 *addr, bool is_ap,
  55                            struct ieee80211_sta *sta, u8 *sta_id_r);
  56 int iwl_remove_station(struct iwl_priv *priv, const u8 sta_id,
  57                        const u8 *addr);
  58 int iwl_mac_sta_remove(struct ieee80211_hw *hw, struct ieee80211_vif *vif,
  59                        struct ieee80211_sta *sta);
  60
  61 u8 iwl_prep_station(struct iwl_priv *priv, struct iwl_rxon_context *ctx,
  62                     const u8 *addr, bool is_ap, struct ieee80211_sta *sta);
  63
  64 int iwl_send_lq_cmd(struct iwl_priv *priv, struct iwl_rxon_context *ctx,
  65                     struct iwl_link_quality_cmd *lq, u8 flags, bool init);
  66 void iwl_reprogram_ap_sta(struct iwl_priv *priv, struct iwl_rxon_context *ctx);
  67
  68 /**
  69  * iwl_clear_driver_stations - clear knowledge of all stations from driver
  70  * @priv: iwl priv struct
  71  *
  72  * This is called during iwl_down() to make sure that in the case
  73  * we're coming there from a hardware restart mac80211 will be
  74  * able to reconfigure stations -- if we're getting there in the
  75  * normal down flow then the stations will already be cleared.
  76  */
  77 static inline void iwl_clear_driver_stations(struct iwl_priv *priv)
  78 {
  79         unsigned long flags;
  80         struct iwl_rxon_context *ctx;
  81
  82         spin_lock_irqsave(&priv->sta_lock, flags);
  83         memset(priv->stations, 0, sizeof(priv->stations));
  84         priv->num_stations = 0;
  85
  86         priv->ucode_key_table = 0;
  87
  88         for_each_context(priv, ctx) {
  89                 /*
  90                  * Remove all key information that is not stored as part
  91                  * of station information since mac80211 may not have had
  92                  * a chance to remove all the keys. When device is
  93                  * reconfigured by mac80211 after an error all keys will
  94                  * be reconfigured.
  95                  */
  96                 memset(ctx->wep_keys, 0, sizeof(ctx->wep_keys));
  97                 ctx->key_mapping_keys = 0;
  98         }
  99
 100         spin_unlock_irqrestore(&priv->sta_lock, flags);
 101 }
 102
 103 static inline int iwl_sta_id(struct ieee80211_sta *sta)
 104 {
 105         if (WARN_ON(!sta))
 106                 return IWL_INVALID_STATION;
 107
 108         return ((struct iwl_station_priv_common *)sta->drv_priv)->sta_id;
 109 }
 110
 111 /**
 112  * iwl_sta_id_or_broadcast - return sta_id or broadcast sta
 113  * @priv: iwl priv
 114  * @context: the current context
 115  * @sta: mac80211 station
 116  *
 117  * In certain circumstances mac80211 passes a station pointer
 118  * that may be %NULL, for example during TX or key setup. In
 119  * that case, we need to use the broadcast station, so this
 120  * inline wraps that pattern.
 121  */
 122 static inline int iwl_sta_id_or_broadcast(struct iwl_priv *priv,
 123                                           struct iwl_rxon_context *context,
 124                                           struct ieee80211_sta *sta)
 125 {
 126         int sta_id;
 127
 128         if (!sta)
 129                 return context->bcast_sta_id;
 130
 131         sta_id = iwl_sta_id(sta);
 132
 133         /*
 134          * mac80211 should not be passing a partially
 135          * initialised station!
 136          */
 137         WARN_ON(sta_id == IWL_INVALID_STATION);
 138
 139         return sta_id;
 140 }
 141 #endif /* __iwl_sta_h__ */