git.oblomov.eu Git - linux-2.6/blob - drivers/net/wireless/iwlwifi/iwl-helpers.h

   1 /******************************************************************************
   2  *
   3  * Copyright(c) 2003 - 2008 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  * James P. Ketrenos <ipw2100-admin@linux.intel.com>
  26  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  27  *
  28  *****************************************************************************/
  29
  30 #ifndef __iwl_helpers_h__
  31 #define __iwl_helpers_h__
  32
  33 #include <linux/ctype.h>
  34
  35 /*
  36  * The structures defined by the hardware/uCode interface
  37  * have bit-wise operations.  For each bit-field there is
  38  * a data symbol in the structure, the start bit position
  39  * and the length of the bit-field.
  40  *
  41  * iwl_get_bits and iwl_set_bits will return or set the
  42  * appropriate bits on a 32-bit value.
  43  *
  44  * IWL_GET_BITS and IWL_SET_BITS use symbol expansion to
  45  * expand out to the appropriate call to iwl_get_bits
  46  * and iwl_set_bits without having to reference all of the
  47  * numerical constants and defines provided in the hardware
  48  * definition
  49  */
  50
  51 /**
  52  * iwl_get_bits - Extract a hardware bit-field value
  53  * @src: source hardware value (__le32)
  54  * @pos: bit-position (0-based) of first bit of value
  55  * @len: length of bit-field
  56  *
  57  * iwl_get_bits will return the bit-field in cpu endian ordering.
  58  *
  59  * NOTE:  If used from IWL_GET_BITS then pos and len are compile-constants and
  60  *        will collapse to minimal code by the compiler.
  61  */
  62 static inline u32 iwl_get_bits(__le32 src, u8 pos, u8 len)
  63 {
  64         u32 tmp = le32_to_cpu(src);
  65
  66         tmp >>= pos;
  67         tmp &= (1UL << len) - 1;
  68         return tmp;
  69 }
  70
  71 /**
  72  * iwl_set_bits - Set a hardware bit-field value
  73  * @dst: Address of __le32 hardware value
  74  * @pos: bit-position (0-based) of first bit of value
  75  * @len: length of bit-field
  76  * @val: cpu endian value to encode into the bit-field
  77  *
  78  * iwl_set_bits will encode val into dst, masked to be len bits long at bit
  79  * position pos.
  80  *
  81  * NOTE:  If used IWL_SET_BITS pos and len will be compile-constants and
  82  *        will collapse to minimal code by the compiler.
  83  */
  84 static inline void iwl_set_bits(__le32 *dst, u8 pos, u8 len, int val)
  85 {
  86         u32 tmp = le32_to_cpu(*dst);
  87
  88         tmp &= ~(((1UL << len) - 1) << pos);
  89         tmp |= (val & ((1UL << len) - 1)) << pos;
  90         *dst = cpu_to_le32(tmp);
  91 }
  92
  93 static inline void iwl_set_bits16(__le16 *dst, u8 pos, u8 len, int val)
  94 {
  95         u16 tmp = le16_to_cpu(*dst);
  96
  97         tmp &= ~((1UL << (pos + len)) - (1UL << pos));
  98         tmp |= (val & ((1UL << len) - 1)) << pos;
  99         *dst = cpu_to_le16(tmp);
 100 }
 101
 102 /*
 103  * The bit-field definitions in iwl-xxxx-hw.h are in the form of:
 104  *
 105  * struct example {
 106  *         __le32 val1;
 107  * #define IWL_name_POS 8
 108  * #define IWL_name_LEN 4
 109  * #define IWL_name_SYM val1
 110  * };
 111  *
 112  * The IWL_SET_BITS and IWL_GET_BITS macros are provided to allow the driver
 113  * to call:
 114  *
 115  * struct example bar;
 116  * u32 val = IWL_GET_BITS(bar, name);
 117  * val = val * 2;
 118  * IWL_SET_BITS(bar, name, val);
 119  *
 120  * All cpu / host ordering, masking, and shifts are performed by the macros
 121  * and iwl_{get,set}_bits.
 122  *
 123  */
 124 #define IWL_SET_BITS(s, sym, v) \
 125         iwl_set_bits(&(s).IWL_ ## sym ## _SYM, IWL_ ## sym ## _POS, \
 126                      IWL_ ## sym ## _LEN, (v))
 127
 128 #define IWL_SET_BITS16(s, sym, v) \
 129         iwl_set_bits16(&(s).IWL_ ## sym ## _SYM, IWL_ ## sym ## _POS, \
 130                        IWL_ ## sym ## _LEN, (v))
 131
 132 #define IWL_GET_BITS(s, sym) \
 133         iwl_get_bits((s).IWL_ ## sym ## _SYM, IWL_ ## sym ## _POS, \
 134                       IWL_ ## sym ## _LEN)
 135
 136
 137 #define KELVIN_TO_CELSIUS(x) ((x)-273)
 138 #define CELSIUS_TO_KELVIN(x) ((x)+273)
 139 #define IWL_MASK(lo, hi) ((1 << (hi)) | ((1 << (hi)) - (1 << (lo))))
 140
 141
 142 #define IEEE80211_CHAN_W_RADAR_DETECT 0x00000010
 143
 144 static inline struct ieee80211_conf *ieee80211_get_hw_conf(
 145         struct ieee80211_hw *hw)
 146 {
 147         return &hw->conf;
 148 }
 149
 150 #define QOS_CONTROL_LEN 2
 151
 152
 153 static inline int ieee80211_is_management(u16 fc)
 154 {
 155         return (fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT;
 156 }
 157
 158 static inline int ieee80211_is_control(u16 fc)
 159 {
 160         return (fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_CTL;
 161 }
 162
 163 static inline int ieee80211_is_data(u16 fc)
 164 {
 165         return (fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_DATA;
 166 }
 167
 168 static inline int ieee80211_is_back_request(u16 fc)
 169 {
 170         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_CTL) &&
 171                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_BACK_REQ);
 172 }
 173
 174 static inline int ieee80211_is_probe_response(u16 fc)
 175 {
 176         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 177                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_PROBE_RESP);
 178 }
 179
 180 static inline int ieee80211_is_probe_request(u16 fc)
 181 {
 182         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 183                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_PROBE_REQ);
 184 }
 185
 186 static inline int ieee80211_is_beacon(u16 fc)
 187 {
 188         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 189                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_BEACON);
 190 }
 191
 192 static inline int ieee80211_is_atim(u16 fc)
 193 {
 194         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 195                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_ATIM);
 196 }
 197
 198 static inline int ieee80211_is_assoc_request(u16 fc)
 199 {
 200         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 201                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_ASSOC_REQ);
 202 }
 203
 204 static inline int ieee80211_is_assoc_response(u16 fc)
 205 {
 206         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 207                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_ASSOC_RESP);
 208 }
 209
 210 static inline int ieee80211_is_auth(u16 fc)
 211 {
 212         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 213                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_ASSOC_REQ);
 214 }
 215
 216 static inline int ieee80211_is_deauth(u16 fc)
 217 {
 218         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 219                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_ASSOC_REQ);
 220 }
 221
 222 static inline int ieee80211_is_disassoc(u16 fc)
 223 {
 224         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 225                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_ASSOC_REQ);
 226 }
 227
 228 static inline int ieee80211_is_reassoc_request(u16 fc)
 229 {
 230         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 231                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_REASSOC_REQ);
 232 }
 233
 234 static inline int ieee80211_is_reassoc_response(u16 fc)
 235 {
 236         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_MGMT) &&
 237                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_REASSOC_RESP);
 238 }
 239
 240 static inline int ieee80211_is_qos_data(u16 fc)
 241 {
 242         return ((fc & IEEE80211_FCTL_FTYPE) == IEEE80211_FTYPE_DATA) &&
 243                ((fc & IEEE80211_FCTL_STYPE) == IEEE80211_STYPE_QOS_DATA);
 244 }
 245 /**
 246  * ieee80211_get_qos_ctrl - get pointer to the QoS control field
 247  *
 248  * This function returns the pointer to 802.11 header QoS field (2 bytes)
 249  * This function doesn't check whether hdr is a QoS hdr, use with care
 250  * @hdr: struct ieee80211_hdr *hdr
 251  * @hdr_len: header length
 252  */
 253
 254 static inline u8 *ieee80211_get_qos_ctrl(struct ieee80211_hdr *hdr, int hdr_len)
 255 {
 256         return  ((u8 *) hdr + hdr_len - QOS_CONTROL_LEN);
 257 }
 258
 259 static inline int iwl_check_bits(unsigned long field, unsigned long mask)
 260 {
 261         return ((field & mask) == mask) ? 1 : 0;
 262 }
 263
 264 static inline unsigned long elapsed_jiffies(unsigned long start,
 265                                             unsigned long end)
 266 {
 267         if (end >= start)
 268                 return end - start;
 269
 270         return end + (MAX_JIFFY_OFFSET - start) + 1;
 271 }
 272
 273 static inline u8 iwl_get_dma_hi_address(dma_addr_t addr)
 274 {
 275         return sizeof(addr) > sizeof(u32) ? (addr >> 16) >> 16 : 0;
 276 }
 277
 278 /**
 279  * iwl_queue_inc_wrap - increment queue index, wrap back to beginning
 280  * @index -- current index
 281  * @n_bd -- total number of entries in queue (must be power of 2)
 282  */
 283 static inline int iwl_queue_inc_wrap(int index, int n_bd)
 284 {
 285         return ++index & (n_bd - 1);
 286 }
 287
 288 /**
 289  * iwl_queue_dec_wrap - decrement queue index, wrap back to end
 290  * @index -- current index
 291  * @n_bd -- total number of entries in queue (must be power of 2)
 292  */
 293 static inline int iwl_queue_dec_wrap(int index, int n_bd)
 294 {
 295         return --index & (n_bd - 1);
 296 }
 297
 298 /* TODO: Move fw_desc functions to iwl-pci.ko */
 299 static inline void iwl_free_fw_desc(struct pci_dev *pci_dev,
 300                                     struct fw_desc *desc)
 301 {
 302         if (desc->v_addr)
 303                 pci_free_consistent(pci_dev, desc->len,
 304                                     desc->v_addr, desc->p_addr);
 305         desc->v_addr = NULL;
 306         desc->len = 0;
 307 }
 308
 309 static inline int iwl_alloc_fw_desc(struct pci_dev *pci_dev,
 310                                     struct fw_desc *desc)
 311 {
 312         desc->v_addr = pci_alloc_consistent(pci_dev, desc->len, &desc->p_addr);
 313         return (desc->v_addr != NULL) ? 0 : -ENOMEM;
 314 }
 315
 316 #endif                          /* __iwl_helpers_h__ */