Linux Kernel  3.7.1
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
ath.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2008-2009 Atheros Communications Inc.
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 
17 #ifndef ATH_H
18 #define ATH_H
19 
20 #include <linux/skbuff.h>
21 #include <linux/if_ether.h>
22 #include <linux/spinlock.h>
23 #include <net/mac80211.h>
24 
25 /*
26  * The key cache is used for h/w cipher state and also for
27  * tracking station state such as the current tx antenna.
28  * We also setup a mapping table between key cache slot indices
29  * and station state to short-circuit node lookups on rx.
30  * Different parts have different size key caches. We handle
31  * up to ATH_KEYMAX entries (could dynamically allocate state).
32  */
33 #define ATH_KEYMAX 128 /* max key cache size we handle */
34 
35 static const u8 ath_bcast_mac[ETH_ALEN] = {0xff, 0xff, 0xff, 0xff, 0xff, 0xff};
36 
37 struct ath_ani {
38  bool caldone;
39  unsigned int longcal_timer;
40  unsigned int shortcal_timer;
41  unsigned int resetcal_timer;
42  unsigned int checkani_timer;
43  struct timer_list timer;
44 };
45 
51 };
52 
56 };
57 
62 };
63 
68 };
69 
71  char alpha2[2];
77 };
78 
82 };
83 
84 struct ath_keyval {
88  u8 kv_val[16]; /* TK */
89  u8 kv_mic[8]; /* Michael MIC key */
90  u8 kv_txmic[8]; /* Michael MIC TX key (used only if the hardware
91  * supports both MIC keys in the same key cache entry;
92  * in that case, kv_mic is the RX key) */
93 };
94 
95 enum ath_cipher {
103 };
104 
114 struct ath_ops {
115  unsigned int (*read)(void *, u32 reg_offset);
116  void (*multi_read)(void *, u32 *addr, u32 *val, u16 count);
117  void (*write)(void *, u32 val, u32 reg_offset);
119  void (*write_flush) (void *);
120  u32 (*rmw)(void *, u32 reg_offset, u32 set, u32 clr);
121 };
122 
123 struct ath_common;
124 struct ath_bus_ops;
125 
126 struct ath_common {
127  void *ah;
128  void *priv;
129  struct ieee80211_hw *hw;
132 
133  struct ath_ani ani;
134 
140 
142 
144  DECLARE_BITMAP(keymap, ATH_KEYMAX);
145  DECLARE_BITMAP(tkip_keymap, ATH_KEYMAX);
146  DECLARE_BITMAP(ccmp_keymap, ATH_KEYMAX);
148 
149  unsigned int clockrate;
150 
154 
157  const struct ath_ops *ops;
158  const struct ath_bus_ops *bus_ops;
159 
163 };
164 
165 struct sk_buff *ath_rxbuf_alloc(struct ath_common *common,
166  u32 len,
167  gfp_t gfp_mask);
168 
170 void ath_key_delete(struct ath_common *common, struct ieee80211_key_conf *key);
171 int ath_key_config(struct ath_common *common,
172  struct ieee80211_vif *vif,
173  struct ieee80211_sta *sta,
174  struct ieee80211_key_conf *key);
175 bool ath_hw_keyreset(struct ath_common *common, u16 entry);
178 
179 __printf(3, 4)
181  const char *fmt, ...);
182 
183 #define ath_emerg(common, fmt, ...) \
184  ath_printk(KERN_EMERG, common, fmt, ##__VA_ARGS__)
185 #define ath_alert(common, fmt, ...) \
186  ath_printk(KERN_ALERT, common, fmt, ##__VA_ARGS__)
187 #define ath_crit(common, fmt, ...) \
188  ath_printk(KERN_CRIT, common, fmt, ##__VA_ARGS__)
189 #define ath_err(common, fmt, ...) \
190  ath_printk(KERN_ERR, common, fmt, ##__VA_ARGS__)
191 #define ath_warn(common, fmt, ...) \
192  ath_printk(KERN_WARNING, common, fmt, ##__VA_ARGS__)
193 #define ath_notice(common, fmt, ...) \
194  ath_printk(KERN_NOTICE, common, fmt, ##__VA_ARGS__)
195 #define ath_info(common, fmt, ...) \
196  ath_printk(KERN_INFO, common, fmt, ##__VA_ARGS__)
197 
229 enum ATH_DEBUG {
230  ATH_DBG_RESET = 0x00000001,
231  ATH_DBG_QUEUE = 0x00000002,
232  ATH_DBG_EEPROM = 0x00000004,
233  ATH_DBG_CALIBRATE = 0x00000008,
234  ATH_DBG_INTERRUPT = 0x00000010,
235  ATH_DBG_REGULATORY = 0x00000020,
236  ATH_DBG_ANI = 0x00000040,
237  ATH_DBG_XMIT = 0x00000080,
238  ATH_DBG_BEACON = 0x00000100,
239  ATH_DBG_CONFIG = 0x00000200,
240  ATH_DBG_FATAL = 0x00000400,
241  ATH_DBG_PS = 0x00000800,
242  ATH_DBG_HWTIMER = 0x00001000,
243  ATH_DBG_BTCOEX = 0x00002000,
244  ATH_DBG_WMI = 0x00004000,
245  ATH_DBG_BSTUCK = 0x00008000,
246  ATH_DBG_MCI = 0x00010000,
247  ATH_DBG_DFS = 0x00020000,
248  ATH_DBG_WOW = 0x00040000,
249  ATH_DBG_ANY = 0xffffffff
250 };
251 
252 #define ATH_DBG_DEFAULT (ATH_DBG_FATAL)
253 
254 #ifdef CONFIG_ATH_DEBUG
255 
256 #define ath_dbg(common, dbg_mask, fmt, ...) \
257 do { \
258  if ((common)->debug_mask & ATH_DBG_##dbg_mask) \
259  ath_printk(KERN_DEBUG, common, fmt, ##__VA_ARGS__); \
260 } while (0)
261 
262 #define ATH_DBG_WARN(foo, arg...) WARN(foo, arg)
263 #define ATH_DBG_WARN_ON_ONCE(foo) WARN_ON_ONCE(foo)
264 
265 #else
266 
267 static inline __attribute__ ((format (printf, 3, 4)))
268 void _ath_dbg(struct ath_common *common, enum ATH_DEBUG dbg_mask,
269  const char *fmt, ...)
270 {
271 }
272 #define ath_dbg(common, dbg_mask, fmt, ...) \
273  _ath_dbg(common, ATH_DBG_##dbg_mask, fmt, ##__VA_ARGS__)
274 
275 #define ATH_DBG_WARN(foo, arg...) do {} while (0)
276 #define ATH_DBG_WARN_ON_ONCE(foo) ({ \
277  int __ret_warn_once = !!(foo); \
278  unlikely(__ret_warn_once); \
279 })
280 
281 #endif /* CONFIG_ATH_DEBUG */
282 
284 #ifdef CONFIG_ATH_DEBUG
285 const char *ath_opmode_to_string(enum nl80211_iftype opmode);
286 #else
287 static inline const char *ath_opmode_to_string(enum nl80211_iftype opmode)
288 {
289  return "UNKNOWN";
290 }
291 #endif
292 
293 #endif /* ATH_H */