blob: 7f10239f56a8171ab31ad5120f6bc4593ed6f123 [file] [log] [blame]
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001/*
Ivo van Doorn7e613e12010-08-06 20:45:38 +02002 Copyright (C) 2010 Willow Garage <http://www.willowgarage.com>
3 Copyright (C) 2004 - 2010 Ivo van Doorn <IvDoorn@gmail.com>
Gertjan van Wingerde9c9a0d12009-11-08 16:39:55 +01004 Copyright (C) 2004 - 2009 Gertjan van Wingerde <gwingerde@gmail.com>
Ivo van Doorn95ea3622007-09-25 17:57:13 -07005 <http://rt2x00.serialmonkey.com>
6
7 This program is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
11
12 This program is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
16
17 You should have received a copy of the GNU General Public License
18 along with this program; if not, write to the
19 Free Software Foundation, Inc.,
20 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
21 */
22
23/*
24 Module: rt2x00
25 Abstract: rt2x00 global information.
26 */
27
28#ifndef RT2X00_H
29#define RT2X00_H
30
31#include <linux/bitops.h>
Ivo van Doorn95ea3622007-09-25 17:57:13 -070032#include <linux/skbuff.h>
33#include <linux/workqueue.h>
34#include <linux/firmware.h>
Ivo van Doorna9450b72008-02-03 15:53:40 +010035#include <linux/leds.h>
Adam Baker3d823462007-10-27 13:43:29 +020036#include <linux/mutex.h>
Mattias Nissler61af43c2007-11-27 21:50:26 +010037#include <linux/etherdevice.h>
Ivo van Doorncca3e992009-01-03 19:56:02 +010038#include <linux/input-polldev.h>
Helmut Schaa96c3da72010-10-02 11:27:35 +020039#include <linux/kfifo.h>
Ivo van Doorn95ea3622007-09-25 17:57:13 -070040
41#include <net/mac80211.h>
42
43#include "rt2x00debug.h"
Gertjan van Wingerdeb4df4702010-05-13 13:16:36 +020044#include "rt2x00dump.h"
Ivo van Doorna9450b72008-02-03 15:53:40 +010045#include "rt2x00leds.h"
Ivo van Doorn95ea3622007-09-25 17:57:13 -070046#include "rt2x00reg.h"
Ivo van Doorn181d6902008-02-05 16:42:23 -050047#include "rt2x00queue.h"
Ivo van Doorn95ea3622007-09-25 17:57:13 -070048
49/*
50 * Module information.
Ivo van Doorn95ea3622007-09-25 17:57:13 -070051 */
Ivo van Doorn754be302008-12-20 11:00:49 +010052#define DRV_VERSION "2.3.0"
Ivo van Doorn95ea3622007-09-25 17:57:13 -070053#define DRV_PROJECT "http://rt2x00.serialmonkey.com"
54
55/*
56 * Debug definitions.
57 * Debug output has to be enabled during compile time.
58 */
59#define DEBUG_PRINTK_MSG(__dev, __kernlvl, __lvl, __msg, __args...) \
60 printk(__kernlvl "%s -> %s: %s - " __msg, \
Harvey Harrisonc94c93d2008-07-28 23:01:34 -070061 wiphy_name((__dev)->hw->wiphy), __func__, __lvl, ##__args)
Ivo van Doorn95ea3622007-09-25 17:57:13 -070062
63#define DEBUG_PRINTK_PROBE(__kernlvl, __lvl, __msg, __args...) \
64 printk(__kernlvl "%s -> %s: %s - " __msg, \
Harvey Harrisonc94c93d2008-07-28 23:01:34 -070065 KBUILD_MODNAME, __func__, __lvl, ##__args)
Ivo van Doorn95ea3622007-09-25 17:57:13 -070066
67#ifdef CONFIG_RT2X00_DEBUG
68#define DEBUG_PRINTK(__dev, __kernlvl, __lvl, __msg, __args...) \
Johannes Stezenbache85b4c02010-12-13 12:38:49 +010069 DEBUG_PRINTK_MSG(__dev, __kernlvl, __lvl, __msg, ##__args)
Ivo van Doorn95ea3622007-09-25 17:57:13 -070070#else
71#define DEBUG_PRINTK(__dev, __kernlvl, __lvl, __msg, __args...) \
72 do { } while (0)
73#endif /* CONFIG_RT2X00_DEBUG */
74
75/*
76 * Various debug levels.
77 * The debug levels PANIC and ERROR both indicate serious problems,
78 * for this reason they should never be ignored.
79 * The special ERROR_PROBE message is for messages that are generated
80 * when the rt2x00_dev is not yet initialized.
81 */
82#define PANIC(__dev, __msg, __args...) \
83 DEBUG_PRINTK_MSG(__dev, KERN_CRIT, "Panic", __msg, ##__args)
84#define ERROR(__dev, __msg, __args...) \
85 DEBUG_PRINTK_MSG(__dev, KERN_ERR, "Error", __msg, ##__args)
86#define ERROR_PROBE(__msg, __args...) \
87 DEBUG_PRINTK_PROBE(KERN_ERR, "Error", __msg, ##__args)
88#define WARNING(__dev, __msg, __args...) \
89 DEBUG_PRINTK(__dev, KERN_WARNING, "Warning", __msg, ##__args)
90#define NOTICE(__dev, __msg, __args...) \
91 DEBUG_PRINTK(__dev, KERN_NOTICE, "Notice", __msg, ##__args)
92#define INFO(__dev, __msg, __args...) \
93 DEBUG_PRINTK(__dev, KERN_INFO, "Info", __msg, ##__args)
94#define DEBUG(__dev, __msg, __args...) \
95 DEBUG_PRINTK(__dev, KERN_DEBUG, "Debug", __msg, ##__args)
96#define EEPROM(__dev, __msg, __args...) \
97 DEBUG_PRINTK(__dev, KERN_DEBUG, "EEPROM recovery", __msg, ##__args)
98
99/*
Ivo van Doornbad13632008-11-09 20:47:00 +0100100 * Duration calculations
101 * The rate variable passed is: 100kbs.
102 * To convert from bytes to bits we multiply size with 8,
103 * then the size is multiplied with 10 to make the
104 * real rate -> rate argument correction.
105 */
106#define GET_DURATION(__size, __rate) (((__size) * 8 * 10) / (__rate))
107#define GET_DURATION_RES(__size, __rate)(((__size) * 8 * 10) % (__rate))
108
109/*
Gertjan van Wingerde77e73d12009-12-04 23:47:01 +0100110 * Determine the number of L2 padding bytes required between the header and
111 * the payload.
112 */
113#define L2PAD_SIZE(__hdrlen) (-(__hdrlen) & 3)
114
115/*
Ivo van Doorn9f166172009-04-26 16:08:50 +0200116 * Determine the alignment requirement,
117 * to make sure the 802.11 payload is padded to a 4-byte boundrary
118 * we must determine the address of the payload and calculate the
119 * amount of bytes needed to move the data.
120 */
121#define ALIGN_SIZE(__skb, __header) \
122 ( ((unsigned long)((__skb)->data + (__header))) & 3 )
123
124/*
Gertjan van Wingerde7a4a77b2009-12-30 11:36:30 +0100125 * Constants for extra TX headroom for alignment purposes.
126 */
127#define RT2X00_ALIGN_SIZE 4 /* Only whole frame needs alignment */
128#define RT2X00_L2PAD_SIZE 8 /* Both header & payload need alignment */
129
130/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700131 * Standard timing and size defines.
132 * These values should follow the ieee80211 specifications.
133 */
134#define ACK_SIZE 14
135#define IEEE80211_HEADER 24
136#define PLCP 48
137#define BEACON 100
138#define PREAMBLE 144
139#define SHORT_PREAMBLE 72
140#define SLOT_TIME 20
141#define SHORT_SLOT_TIME 9
142#define SIFS 10
143#define PIFS ( SIFS + SLOT_TIME )
144#define SHORT_PIFS ( SIFS + SHORT_SLOT_TIME )
145#define DIFS ( PIFS + SLOT_TIME )
146#define SHORT_DIFS ( SHORT_PIFS + SHORT_SLOT_TIME )
Ivo van Doornf2fdbc42008-07-19 16:16:12 +0200147#define EIFS ( SIFS + DIFS + \
Ivo van Doornbad13632008-11-09 20:47:00 +0100148 GET_DURATION(IEEE80211_HEADER + ACK_SIZE, 10) )
Ivo van Doornf2fdbc42008-07-19 16:16:12 +0200149#define SHORT_EIFS ( SIFS + SHORT_DIFS + \
Ivo van Doornbad13632008-11-09 20:47:00 +0100150 GET_DURATION(IEEE80211_HEADER + ACK_SIZE, 10) )
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700151
152/*
Lars Ericsson66679a62009-08-08 23:54:51 +0200153 * Structure for average calculation
154 * The avg field contains the actual average value,
155 * but avg_weight is internally used during calculations
156 * to prevent rounding errors.
157 */
158struct avg_val {
159 int avg;
160 int avg_weight;
161};
162
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +0100163enum rt2x00_chip_intf {
164 RT2X00_CHIP_INTF_PCI,
Gertjan van Wingerde6e1fdd12010-06-03 10:52:00 +0200165 RT2X00_CHIP_INTF_PCIE,
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +0100166 RT2X00_CHIP_INTF_USB,
Gertjan van Wingerdecea90e52010-02-13 20:55:47 +0100167 RT2X00_CHIP_INTF_SOC,
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +0100168};
169
Lars Ericsson66679a62009-08-08 23:54:51 +0200170/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700171 * Chipset identification
172 * The chipset on the device is composed of a RT and RF chip.
173 * The chipset combination is important for determining device capabilities.
174 */
175struct rt2x00_chip {
176 u16 rt;
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100177#define RT2460 0x2460
178#define RT2560 0x2560
179#define RT2570 0x2570
180#define RT2661 0x2661
181#define RT2573 0x2573
Gertjan van Wingerde5ed8f452010-06-03 10:51:57 +0200182#define RT2860 0x2860 /* 2.4GHz */
Gertjan van Wingerdee148b4c2010-04-11 14:31:09 +0200183#define RT2872 0x2872 /* WSOC */
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100184#define RT2883 0x2883 /* WSOC */
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100185#define RT3070 0x3070
186#define RT3071 0x3071
Ivo van Doorna9b3a9f2009-10-15 22:04:14 +0200187#define RT3090 0x3090 /* 2.4GHz PCIe */
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100188#define RT3390 0x3390
189#define RT3572 0x3572
Gertjan van Wingerdee148b4c2010-04-11 14:31:09 +0200190#define RT3593 0x3593 /* PCIe */
191#define RT3883 0x3883 /* WSOC */
RA-Shiang Tu60687ba2011-02-20 13:57:46 +0100192#define RT5390 0x5390 /* 2.4GHz */
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700193
194 u16 rf;
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100195 u16 rev;
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +0100196
197 enum rt2x00_chip_intf intf;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700198};
199
200/*
201 * RF register values that belong to a particular channel.
202 */
203struct rf_channel {
204 int channel;
205 u32 rf1;
206 u32 rf2;
207 u32 rf3;
208 u32 rf4;
209};
210
211/*
Ivo van Doorn8c5e7a52008-08-04 16:38:47 +0200212 * Channel information structure
213 */
214struct channel_info {
215 unsigned int flags;
216#define GEOGRAPHY_ALLOWED 0x00000001
217
Ivo van Doorn8d1331b2010-08-23 19:56:07 +0200218 short max_power;
219 short default_power1;
220 short default_power2;
Ivo van Doorn8c5e7a52008-08-04 16:38:47 +0200221};
222
223/*
Ivo van Doornaddc81bd2007-10-13 16:26:23 +0200224 * Antenna setup values.
225 */
226struct antenna_setup {
227 enum antenna rx;
228 enum antenna tx;
RA-Jay Hungd96aa642011-02-20 13:54:52 +0100229 u8 rx_chain_num;
230 u8 tx_chain_num;
Ivo van Doornaddc81bd2007-10-13 16:26:23 +0200231};
232
233/*
Ivo van Doornebcf26d2007-10-13 16:26:12 +0200234 * Quality statistics about the currently active link.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700235 */
Ivo van Doornebcf26d2007-10-13 16:26:12 +0200236struct link_qual {
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700237 /*
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100238 * Statistics required for Link tuning by driver
239 * The rssi value is provided by rt2x00lib during the
240 * link_tuner() callback function.
241 * The false_cca field is filled during the link_stats()
242 * callback function and could be used during the
243 * link_tuner() callback function.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700244 */
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100245 int rssi;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700246 int false_cca;
247
248 /*
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100249 * VGC levels
250 * Hardware driver will tune the VGC level during each call
251 * to the link_tuner() callback function. This vgc_level is
252 * is determined based on the link quality statistics like
253 * average RSSI and the false CCA count.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700254 *
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100255 * In some cases the drivers need to differentiate between
256 * the currently "desired" VGC level and the level configured
257 * in the hardware. The latter is important to reduce the
258 * number of BBP register reads to reduce register access
259 * overhead. For this reason we store both values here.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700260 */
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100261 u8 vgc_level;
262 u8 vgc_level_reg;
263
264 /*
265 * Statistics required for Signal quality calculation.
266 * These fields might be changed during the link_stats()
267 * callback function.
268 */
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700269 int rx_success;
270 int rx_failed;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700271 int tx_success;
272 int tx_failed;
Ivo van Doornebcf26d2007-10-13 16:26:12 +0200273};
274
275/*
Ivo van Doorn69f81a22007-10-13 16:26:36 +0200276 * Antenna settings about the currently active link.
277 */
278struct link_ant {
279 /*
280 * Antenna flags
281 */
282 unsigned int flags;
283#define ANTENNA_RX_DIVERSITY 0x00000001
284#define ANTENNA_TX_DIVERSITY 0x00000002
285#define ANTENNA_MODE_SAMPLE 0x00000004
286
287 /*
288 * Currently active TX/RX antenna setup.
289 * When software diversity is used, this will indicate
290 * which antenna is actually used at this time.
291 */
292 struct antenna_setup active;
293
294 /*
Lars Ericsson193df182009-08-08 23:54:24 +0200295 * RSSI history information for the antenna.
296 * Used to determine when to switch antenna
297 * when using software diversity.
Ivo van Doorn69f81a22007-10-13 16:26:36 +0200298 */
Lars Ericsson193df182009-08-08 23:54:24 +0200299 int rssi_history;
Ivo van Doorn69f81a22007-10-13 16:26:36 +0200300
301 /*
302 * Current RSSI average of the currently active antenna.
303 * Similar to the avg_rssi in the link_qual structure
304 * this value is updated by using the walking average.
305 */
Lars Ericsson66679a62009-08-08 23:54:51 +0200306 struct avg_val rssi_ant;
Ivo van Doorn69f81a22007-10-13 16:26:36 +0200307};
308
309/*
Ivo van Doornebcf26d2007-10-13 16:26:12 +0200310 * To optimize the quality of the link we need to store
311 * the quality of received frames and periodically
312 * optimize the link.
313 */
314struct link {
315 /*
316 * Link tuner counter
317 * The number of times the link has been tuned
318 * since the radio has been switched on.
319 */
320 u32 count;
321
322 /*
323 * Quality measurement values.
324 */
325 struct link_qual qual;
326
327 /*
Ivo van Doorn69f81a22007-10-13 16:26:36 +0200328 * TX/RX antenna setup.
Ivo van Doornaddc81bd2007-10-13 16:26:23 +0200329 */
Ivo van Doorn69f81a22007-10-13 16:26:36 +0200330 struct link_ant ant;
Ivo van Doornaddc81bd2007-10-13 16:26:23 +0200331
332 /*
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100333 * Currently active average RSSI value
Ivo van Doornebcf26d2007-10-13 16:26:12 +0200334 */
Lars Ericsson66679a62009-08-08 23:54:51 +0200335 struct avg_val avg_rssi;
Ivo van Doorneb20b4e2008-12-20 10:54:22 +0100336
337 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700338 * Work structure for scheduling periodic link tuning.
339 */
340 struct delayed_work work;
Ivo van Doornc965c742010-07-11 12:25:46 +0200341
342 /*
343 * Work structure for scheduling periodic watchdog monitoring.
Ivo van Doorncdfd2c5c2010-10-11 15:37:47 +0200344 * This work must be scheduled on the kernel workqueue, while
345 * all other work structures must be queued on the mac80211
346 * workqueue. This guarantees that the watchdog can schedule
347 * other work structures and wait for their completion in order
348 * to bring the device/driver back into the desired state.
Ivo van Doornc965c742010-07-11 12:25:46 +0200349 */
350 struct delayed_work watchdog_work;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700351};
352
Helmut Schaabfe6a152010-12-27 15:06:57 +0100353enum rt2x00_delayed_flags {
354 DELAYED_UPDATE_BEACON,
355};
356
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700357/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700358 * Interface structure
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100359 * Per interface configuration details, this structure
360 * is allocated as the private data for ieee80211_vif.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700361 */
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100362struct rt2x00_intf {
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700363 /*
Igor Perminov17512dc2009-08-08 23:55:18 +0200364 * beacon->skb must be protected with the mutex.
365 */
366 struct mutex beacon_skb_mutex;
367
368 /*
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100369 * Entry in the beacon queue which belongs to
370 * this interface. Each interface has its own
371 * dedicated beacon entry.
372 */
373 struct queue_entry *beacon;
Helmut Schaa69cf36a2011-01-30 13:16:03 +0100374 bool enable_beacon;
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100375
376 /*
377 * Actions that needed rescheduling.
378 */
Helmut Schaabfe6a152010-12-27 15:06:57 +0100379 unsigned long delayed_flags;
Johannes Bergf591fa52008-07-10 11:21:26 +0200380
Ivo van Doornd4764b22008-07-28 10:21:16 +0200381 /*
382 * Software sequence counter, this is only required
383 * for hardware which doesn't support hardware
384 * sequence counting.
385 */
386 spinlock_t seqlock;
Johannes Bergf591fa52008-07-10 11:21:26 +0200387 u16 seqno;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700388};
389
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100390static inline struct rt2x00_intf* vif_to_intf(struct ieee80211_vif *vif)
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700391{
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100392 return (struct rt2x00_intf *)vif->drv_priv;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700393}
394
Ivo van Doorn31562e82008-02-17 17:35:05 +0100395/**
396 * struct hw_mode_spec: Hardware specifications structure
397 *
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700398 * Details about the supported modes, rates and channels
399 * of a particular chipset. This is used by rt2x00lib
400 * to build the ieee80211_hw_mode array for mac80211.
Ivo van Doorn31562e82008-02-17 17:35:05 +0100401 *
402 * @supported_bands: Bitmask contained the supported bands (2.4GHz, 5.2GHz).
403 * @supported_rates: Rate types which are supported (CCK, OFDM).
404 * @num_channels: Number of supported channels. This is used as array size
405 * for @tx_power_a, @tx_power_bg and @channels.
Ivo van Doorn9a46d442008-04-21 19:02:17 +0200406 * @channels: Device/chipset specific channel values (See &struct rf_channel).
Ivo van Doorn8c5e7a52008-08-04 16:38:47 +0200407 * @channels_info: Additional information for channels (See &struct channel_info).
Ivo van Doorn35f00cf2009-04-26 16:09:32 +0200408 * @ht: Driver HT Capabilities (See &ieee80211_sta_ht_cap).
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700409 */
410struct hw_mode_spec {
Ivo van Doorn31562e82008-02-17 17:35:05 +0100411 unsigned int supported_bands;
412#define SUPPORT_BAND_2GHZ 0x00000001
413#define SUPPORT_BAND_5GHZ 0x00000002
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700414
Ivo van Doorn31562e82008-02-17 17:35:05 +0100415 unsigned int supported_rates;
416#define SUPPORT_RATE_CCK 0x00000001
417#define SUPPORT_RATE_OFDM 0x00000002
418
419 unsigned int num_channels;
420 const struct rf_channel *channels;
Ivo van Doorn8c5e7a52008-08-04 16:38:47 +0200421 const struct channel_info *channels_info;
Ivo van Doorn35f00cf2009-04-26 16:09:32 +0200422
423 struct ieee80211_sta_ht_cap ht;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700424};
425
426/*
Ivo van Doorn5c58ee52007-10-06 13:34:52 +0200427 * Configuration structure wrapper around the
428 * mac80211 configuration structure.
429 * When mac80211 configures the driver, rt2x00lib
430 * can precalculate values which are equal for all
431 * rt2x00 drivers. Those values can be stored in here.
432 */
433struct rt2x00lib_conf {
434 struct ieee80211_conf *conf;
Ivo van Doorn8c5e7a52008-08-04 16:38:47 +0200435
Ivo van Doorn5c58ee52007-10-06 13:34:52 +0200436 struct rf_channel rf;
Ivo van Doorn8c5e7a52008-08-04 16:38:47 +0200437 struct channel_info channel;
Ivo van Doorn5c58ee52007-10-06 13:34:52 +0200438};
439
440/*
Ivo van Doorn72810372008-03-09 22:46:18 +0100441 * Configuration structure for erp settings.
442 */
443struct rt2x00lib_erp {
444 int short_preamble;
Ivo van Doorne360c4c2008-07-09 15:12:06 +0200445 int cts_protection;
Ivo van Doorn72810372008-03-09 22:46:18 +0100446
Johannes Berg881d9482009-01-21 15:13:48 +0100447 u32 basic_rates;
Ivo van Doorne4ea1c42008-10-29 17:17:57 +0100448
449 int slot_time;
450
451 short sifs;
452 short pifs;
453 short difs;
454 short eifs;
Ivo van Doorn8a566af2009-05-21 19:16:46 +0200455
456 u16 beacon_int;
Helmut Schaa87c19152010-10-02 11:28:34 +0200457 u16 ht_opmode;
Ivo van Doorn72810372008-03-09 22:46:18 +0100458};
459
460/*
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200461 * Configuration structure for hardware encryption.
462 */
463struct rt2x00lib_crypto {
464 enum cipher cipher;
465
466 enum set_key_cmd cmd;
467 const u8 *address;
468
469 u32 bssidx;
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200470
471 u8 key[16];
472 u8 tx_mic[8];
473 u8 rx_mic[8];
474};
475
476/*
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100477 * Configuration structure wrapper around the
478 * rt2x00 interface configuration handler.
479 */
480struct rt2x00intf_conf {
481 /*
482 * Interface type
483 */
Johannes Berg05c914f2008-09-11 00:01:58 +0200484 enum nl80211_iftype type;
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100485
486 /*
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300487 * TSF sync value, this is dependent on the operation type.
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100488 */
489 enum tsf_sync sync;
490
491 /*
Lucas De Marchi25985ed2011-03-30 22:57:33 -0300492 * The MAC and BSSID addresses are simple array of bytes,
493 * these arrays are little endian, so when sending the addresses
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100494 * to the drivers, copy the it into a endian-signed variable.
495 *
496 * Note that all devices (except rt2500usb) have 32 bits
497 * register word sizes. This means that whatever variable we
498 * pass _must_ be a multiple of 32 bits. Otherwise the device
499 * might not accept what we are sending to it.
500 * This will also make it easier for the driver to write
501 * the data to the device.
502 */
503 __le32 mac[2];
504 __le32 bssid[2];
505};
506
507/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700508 * rt2x00lib callback functions.
509 */
510struct rt2x00lib_ops {
511 /*
512 * Interrupt handlers.
513 */
514 irq_handler_t irq_handler;
515
516 /*
Helmut Schaa96c3da72010-10-02 11:27:35 +0200517 * TX status tasklet handler.
518 */
519 void (*txstatus_tasklet) (unsigned long data);
Helmut Schaac5c65762011-01-30 13:17:52 +0100520 void (*pretbtt_tasklet) (unsigned long data);
521 void (*tbtt_tasklet) (unsigned long data);
522 void (*rxdone_tasklet) (unsigned long data);
523 void (*autowake_tasklet) (unsigned long data);
Helmut Schaa96c3da72010-10-02 11:27:35 +0200524
525 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700526 * Device init handlers.
527 */
528 int (*probe_hw) (struct rt2x00_dev *rt2x00dev);
529 char *(*get_firmware_name) (struct rt2x00_dev *rt2x00dev);
Ivo van Doorn0cbe0062009-01-28 00:33:47 +0100530 int (*check_firmware) (struct rt2x00_dev *rt2x00dev,
531 const u8 *data, const size_t len);
532 int (*load_firmware) (struct rt2x00_dev *rt2x00dev,
533 const u8 *data, const size_t len);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700534
535 /*
536 * Device initialization/deinitialization handlers.
537 */
538 int (*initialize) (struct rt2x00_dev *rt2x00dev);
539 void (*uninitialize) (struct rt2x00_dev *rt2x00dev);
540
541 /*
Ivo van Doorn181d6902008-02-05 16:42:23 -0500542 * queue initialization handlers
Ivo van Doorn837e7f22008-01-06 23:41:45 +0100543 */
Ivo van Doorn798b7ad2008-11-08 15:25:33 +0100544 bool (*get_entry_state) (struct queue_entry *entry);
545 void (*clear_entry) (struct queue_entry *entry);
Ivo van Doorn837e7f22008-01-06 23:41:45 +0100546
547 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700548 * Radio control handlers.
549 */
550 int (*set_device_state) (struct rt2x00_dev *rt2x00dev,
551 enum dev_state state);
552 int (*rfkill_poll) (struct rt2x00_dev *rt2x00dev);
Ivo van Doornebcf26d2007-10-13 16:26:12 +0200553 void (*link_stats) (struct rt2x00_dev *rt2x00dev,
554 struct link_qual *qual);
Ivo van Doorn5352ff62008-12-20 10:54:54 +0100555 void (*reset_tuner) (struct rt2x00_dev *rt2x00dev,
556 struct link_qual *qual);
557 void (*link_tuner) (struct rt2x00_dev *rt2x00dev,
558 struct link_qual *qual, const u32 count);
Ivo van Doorndbba3062010-12-13 12:34:54 +0100559
560 /*
561 * Data queue handlers.
562 */
Ivo van Doornc965c742010-07-11 12:25:46 +0200563 void (*watchdog) (struct rt2x00_dev *rt2x00dev);
Ivo van Doorndbba3062010-12-13 12:34:54 +0100564 void (*start_queue) (struct data_queue *queue);
565 void (*kick_queue) (struct data_queue *queue);
566 void (*stop_queue) (struct data_queue *queue);
Ivo van Doorn5be65602010-12-13 12:35:40 +0100567 void (*flush_queue) (struct data_queue *queue);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700568
569 /*
570 * TX control handlers
571 */
Ivo van Doorn93331452010-08-23 19:53:39 +0200572 void (*write_tx_desc) (struct queue_entry *entry,
Ivo van Doorn61486e02008-05-10 13:42:31 +0200573 struct txentry_desc *txdesc);
Gertjan van Wingerde76dd5dd2010-06-29 21:42:23 +0200574 void (*write_tx_data) (struct queue_entry *entry,
575 struct txentry_desc *txdesc);
Gertjan van Wingerdef224f4e2010-05-08 23:40:25 +0200576 void (*write_beacon) (struct queue_entry *entry,
577 struct txentry_desc *txdesc);
Helmut Schaa69cf36a2011-01-30 13:16:03 +0100578 void (*clear_beacon) (struct queue_entry *entry);
Ivo van Doornf1ca2162008-11-13 23:07:33 +0100579 int (*get_tx_data_len) (struct queue_entry *entry);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700580
581 /*
582 * RX control handlers
583 */
Ivo van Doorn181d6902008-02-05 16:42:23 -0500584 void (*fill_rxdone) (struct queue_entry *entry,
585 struct rxdone_entry_desc *rxdesc);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700586
587 /*
588 * Configuration handlers.
589 */
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200590 int (*config_shared_key) (struct rt2x00_dev *rt2x00dev,
591 struct rt2x00lib_crypto *crypto,
592 struct ieee80211_key_conf *key);
593 int (*config_pairwise_key) (struct rt2x00_dev *rt2x00dev,
594 struct rt2x00lib_crypto *crypto,
595 struct ieee80211_key_conf *key);
Ivo van Doorn3a643d22008-03-25 14:13:18 +0100596 void (*config_filter) (struct rt2x00_dev *rt2x00dev,
597 const unsigned int filter_flags);
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100598 void (*config_intf) (struct rt2x00_dev *rt2x00dev,
599 struct rt2x00_intf *intf,
600 struct rt2x00intf_conf *conf,
601 const unsigned int flags);
602#define CONFIG_UPDATE_TYPE ( 1 << 1 )
603#define CONFIG_UPDATE_MAC ( 1 << 2 )
604#define CONFIG_UPDATE_BSSID ( 1 << 3 )
605
Ivo van Doorn3a643d22008-03-25 14:13:18 +0100606 void (*config_erp) (struct rt2x00_dev *rt2x00dev,
Helmut Schaa02044642010-09-08 20:56:32 +0200607 struct rt2x00lib_erp *erp,
608 u32 changed);
Ivo van Doorne4ea1c42008-10-29 17:17:57 +0100609 void (*config_ant) (struct rt2x00_dev *rt2x00dev,
610 struct antenna_setup *ant);
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100611 void (*config) (struct rt2x00_dev *rt2x00dev,
612 struct rt2x00lib_conf *libconf,
Ivo van Doorne4ea1c42008-10-29 17:17:57 +0100613 const unsigned int changed_flags);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700614};
615
616/*
617 * rt2x00 driver callback operation structure.
618 */
619struct rt2x00_ops {
620 const char *name;
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100621 const unsigned int max_sta_intf;
622 const unsigned int max_ap_intf;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700623 const unsigned int eeprom_size;
624 const unsigned int rf_size;
Gertjan van Wingerde61448f82008-05-10 13:43:33 +0200625 const unsigned int tx_queues;
Gertjan van Wingerdee6218cc2009-11-23 22:44:52 +0100626 const unsigned int extra_tx_headroom;
Ivo van Doorn181d6902008-02-05 16:42:23 -0500627 const struct data_queue_desc *rx;
628 const struct data_queue_desc *tx;
629 const struct data_queue_desc *bcn;
630 const struct data_queue_desc *atim;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700631 const struct rt2x00lib_ops *lib;
Ivo van Doorne7966432010-07-11 12:31:23 +0200632 const void *drv;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700633 const struct ieee80211_ops *hw;
634#ifdef CONFIG_RT2X00_LIB_DEBUGFS
635 const struct rt2x00debug *debugfs;
636#endif /* CONFIG_RT2X00_LIB_DEBUGFS */
637};
638
639/*
Ivo van Doorn483272f2007-10-06 14:13:06 +0200640 * rt2x00 device flags
641 */
642enum rt2x00_flags {
643 /*
644 * Device state flags
645 */
Ivo van Doorn0262ab02008-08-29 21:04:26 +0200646 DEVICE_STATE_PRESENT,
647 DEVICE_STATE_REGISTERED_HW,
648 DEVICE_STATE_INITIALIZED,
649 DEVICE_STATE_STARTED,
Ivo van Doorn0262ab02008-08-29 21:04:26 +0200650 DEVICE_STATE_ENABLED_RADIO,
Ivo van Doornd8147f92010-07-11 12:24:47 +0200651 DEVICE_STATE_SCANNING,
Ivo van Doorn483272f2007-10-06 14:13:06 +0200652
653 /*
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200654 * Driver requirements
Ivo van Doorn483272f2007-10-06 14:13:06 +0200655 */
656 DRIVER_REQUIRE_FIRMWARE,
Ivo van Doorn181d6902008-02-05 16:42:23 -0500657 DRIVER_REQUIRE_BEACON_GUARD,
658 DRIVER_REQUIRE_ATIM_QUEUE,
Gertjan van Wingerdec4da0042008-06-16 19:56:31 +0200659 DRIVER_REQUIRE_DMA,
Ivo van Doorn3f787bd2008-12-20 10:56:36 +0100660 DRIVER_REQUIRE_COPY_IV,
Ivo van Doorn9f166172009-04-26 16:08:50 +0200661 DRIVER_REQUIRE_L2PAD,
Helmut Schaa96c3da72010-10-02 11:27:35 +0200662 DRIVER_REQUIRE_TXSTATUS_FIFO,
Johannes Stezenbach20ed3162010-11-30 16:49:23 +0100663 DRIVER_REQUIRE_TASKLET_CONTEXT,
Helmut Schaa7fe7ee72011-03-03 19:42:01 +0100664 DRIVER_REQUIRE_SW_SEQNO,
Helmut Schaa26a1d072011-03-03 19:42:35 +0100665 DRIVER_REQUIRE_HT_TX_DESC,
Ivo van Doorn483272f2007-10-06 14:13:06 +0200666
667 /*
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200668 * Driver features
Ivo van Doorn483272f2007-10-06 14:13:06 +0200669 */
670 CONFIG_SUPPORT_HW_BUTTON,
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200671 CONFIG_SUPPORT_HW_CRYPTO,
RA-Jay Hunge90c54b2011-02-20 13:55:25 +0100672 CONFIG_SUPPORT_POWER_LIMIT,
Igor Perminov1afcfd542009-08-08 23:55:55 +0200673 DRIVER_SUPPORT_CONTROL_FILTERS,
674 DRIVER_SUPPORT_CONTROL_FILTER_PSPOLL,
Helmut Schaa9f926fb2010-07-11 12:28:23 +0200675 DRIVER_SUPPORT_PRE_TBTT_INTERRUPT,
Ivo van Doorn27df2a92010-07-11 12:24:22 +0200676 DRIVER_SUPPORT_LINK_TUNING,
Ivo van Doornc965c742010-07-11 12:25:46 +0200677 DRIVER_SUPPORT_WATCHDOG,
Ivo van Doorn2bb057d2008-08-04 16:37:44 +0200678
679 /*
680 * Driver configuration
681 */
Ivo van Doorn483272f2007-10-06 14:13:06 +0200682 CONFIG_FRAME_TYPE,
683 CONFIG_RF_SEQUENCE,
684 CONFIG_EXTERNAL_LNA_A,
685 CONFIG_EXTERNAL_LNA_BG,
686 CONFIG_DOUBLE_ANTENNA,
Ivo van Doorn35f00cf2009-04-26 16:09:32 +0200687 CONFIG_CHANNEL_HT40,
Ivo van Doorn483272f2007-10-06 14:13:06 +0200688};
689
690/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700691 * rt2x00 device structure.
692 */
693struct rt2x00_dev {
694 /*
695 * Device structure.
696 * The structure stored in here depends on the
697 * system bus (PCI or USB).
698 * When accessing this variable, the rt2x00dev_{pci,usb}
Luis Correia49513482009-07-17 21:39:19 +0200699 * macros should be used for correct typecasting.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700700 */
Gertjan van Wingerde14a3bf82008-06-16 19:55:43 +0200701 struct device *dev;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700702
703 /*
704 * Callback functions.
705 */
706 const struct rt2x00_ops *ops;
707
708 /*
709 * IEEE80211 control structure.
710 */
711 struct ieee80211_hw *hw;
Johannes Berg8318d782008-01-24 19:38:38 +0100712 struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
713 enum ieee80211_band curr_band;
Ivo van Doorne5ef5ba2010-08-06 20:49:27 +0200714 int curr_freq;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700715
716 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700717 * If enabled, the debugfs interface structures
718 * required for deregistration of debugfs.
719 */
720#ifdef CONFIG_RT2X00_LIB_DEBUGFS
Ivo van Doorn4d8dd662007-11-27 21:49:29 +0100721 struct rt2x00debug_intf *debugfs_intf;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700722#endif /* CONFIG_RT2X00_LIB_DEBUGFS */
723
724 /*
Ivo van Doorna9450b72008-02-03 15:53:40 +0100725 * LED structure for changing the LED status
726 * by mac8011 or the kernel.
727 */
728#ifdef CONFIG_RT2X00_LIB_LEDS
Ivo van Doorna9450b72008-02-03 15:53:40 +0100729 struct rt2x00_led led_radio;
730 struct rt2x00_led led_assoc;
731 struct rt2x00_led led_qual;
732 u16 led_mcu_reg;
733#endif /* CONFIG_RT2X00_LIB_LEDS */
734
735 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700736 * Device flags.
737 * In these flags the current status and some
738 * of the device capabilities are stored.
739 */
740 unsigned long flags;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700741
742 /*
Ivo van Doorn440ddada2009-03-28 20:51:24 +0100743 * Device information, Bus IRQ and name (PCI, SoC)
744 */
745 int irq;
746 const char *name;
747
748 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700749 * Chipset identification.
750 */
751 struct rt2x00_chip chip;
752
753 /*
754 * hw capability specifications.
755 */
756 struct hw_mode_spec spec;
757
758 /*
Ivo van Doornaddc81bd2007-10-13 16:26:23 +0200759 * This is the default TX/RX antenna setup as indicated
Ivo van Doorn6d643602008-11-02 00:38:10 +0100760 * by the device's EEPROM.
Ivo van Doornaddc81bd2007-10-13 16:26:23 +0200761 */
762 struct antenna_setup default_ant;
763
764 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700765 * Register pointers
Ivo van Doorn21795092008-02-10 22:49:13 +0100766 * csr.base: CSR base register address. (PCI)
767 * csr.cache: CSR cache for usb_control_msg. (USB)
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700768 */
Ivo van Doorn21795092008-02-10 22:49:13 +0100769 union csr {
770 void __iomem *base;
771 void *cache;
772 } csr;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700773
774 /*
Ivo van Doorn8ff48a82008-11-09 23:40:46 +0100775 * Mutex to protect register accesses.
776 * For PCI and USB devices it protects against concurrent indirect
777 * register access (BBP, RF, MCU) since accessing those
778 * registers require multiple calls to the CSR registers.
779 * For USB devices it also protects the csr_cache since that
780 * field is used for normal CSR access and it cannot support
781 * multiple callers simultaneously.
Adam Baker3d823462007-10-27 13:43:29 +0200782 */
Ivo van Doorn8ff48a82008-11-09 23:40:46 +0100783 struct mutex csr_mutex;
Adam Baker3d823462007-10-27 13:43:29 +0200784
785 /*
Ivo van Doorn3c4f2082008-01-06 23:40:49 +0100786 * Current packet filter configuration for the device.
787 * This contains all currently active FIF_* flags send
788 * to us by mac80211 during configure_filter().
789 */
790 unsigned int packet_filter;
791
792 /*
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100793 * Interface details:
794 * - Open ap interface count.
795 * - Open sta interface count.
796 * - Association count.
Helmut Schaa69cf36a2011-01-30 13:16:03 +0100797 * - Beaconing enabled count.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700798 */
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100799 unsigned int intf_ap_count;
800 unsigned int intf_sta_count;
801 unsigned int intf_associated;
Helmut Schaa69cf36a2011-01-30 13:16:03 +0100802 unsigned int intf_beaconing;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700803
804 /*
805 * Link quality
806 */
807 struct link link;
808
809 /*
810 * EEPROM data.
811 */
812 __le16 *eeprom;
813
814 /*
815 * Active RF register values.
816 * These are stored here so we don't need
817 * to read the rf registers and can directly
818 * use this value instead.
819 * This field should be accessed by using
820 * rt2x00_rf_read() and rt2x00_rf_write().
821 */
822 u32 *rf;
823
824 /*
Ivo van Doornba2ab472008-08-06 16:22:17 +0200825 * LNA gain
826 */
827 short lna_gain;
828
829 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700830 * Current TX power value.
831 */
832 u16 tx_power;
833
834 /*
Ivo van Doorn42c82852008-12-02 18:20:04 +0100835 * Current retry values.
836 */
837 u8 short_retry;
838 u8 long_retry;
839
840 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700841 * Rssi <-> Dbm offset
842 */
843 u8 rssi_offset;
844
845 /*
846 * Frequency offset (for rt61pci & rt73usb).
847 */
848 u8 freq_offset;
849
850 /*
Ivo van Doorn35f00cf2009-04-26 16:09:32 +0200851 * Calibration information (for rt2800usb & rt2800pci).
852 * [0] -> BW20
853 * [1] -> BW40
854 */
855 u8 calibration[2];
856
857 /*
Ivo van Doorn6b347bf2009-05-23 21:09:28 +0200858 * Beacon interval.
859 */
860 u16 beacon_int;
861
862 /*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700863 * Low level statistics which will have
864 * to be kept up to date while device is running.
865 */
866 struct ieee80211_low_level_stats low_level_stats;
867
Ivo van Doorn0439f532011-01-30 13:24:05 +0100868 /**
869 * Work queue for all work which should not be placed
870 * on the mac80211 workqueue (because of dependencies
871 * between various work structures).
872 */
873 struct workqueue_struct *workqueue;
874
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700875 /*
Johannes Berg4150c572007-09-17 01:29:23 -0400876 * Scheduled work.
Ivo van Doorn8e260c22008-07-04 13:41:31 +0200877 * NOTE: intf_work will use ieee80211_iterate_active_interfaces()
878 * which means it cannot be placed on the hw->workqueue
879 * due to RTNL locking requirements.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700880 */
Ivo van Doorn6bb40dd2008-02-03 15:49:59 +0100881 struct work_struct intf_work;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700882
Ivo van Doorn7e613e12010-08-06 20:45:38 +0200883 /**
884 * Scheduled work for TX/RX done handling (USB devices)
885 */
886 struct work_struct rxdone_work;
887 struct work_struct txdone_work;
888
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700889 /*
Gertjan van Wingerdee74df4a2011-03-03 19:46:09 +0100890 * Data queue arrays for RX, TX, Beacon and ATIM.
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700891 */
Ivo van Doornb8697672008-06-06 22:53:14 +0200892 unsigned int data_queues;
Ivo van Doorn181d6902008-02-05 16:42:23 -0500893 struct data_queue *rx;
894 struct data_queue *tx;
895 struct data_queue *bcn;
Gertjan van Wingerdee74df4a2011-03-03 19:46:09 +0100896 struct data_queue *atim;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700897
898 /*
899 * Firmware image.
900 */
901 const struct firmware *fw;
Bartlomiej Zolnierkiewiczee134fc2009-11-04 18:34:46 +0100902
903 /*
Helmut Schaa96c3da72010-10-02 11:27:35 +0200904 * FIFO for storing tx status reports between isr and tasklet.
905 */
Johannes Stezenbachc4d63242010-12-27 15:04:29 +0100906 DECLARE_KFIFO_PTR(txstatus_fifo, u32);
Helmut Schaa96c3da72010-10-02 11:27:35 +0200907
908 /*
909 * Tasklet for processing tx status reports (rt2800pci).
910 */
911 struct tasklet_struct txstatus_tasklet;
Helmut Schaac5c65762011-01-30 13:17:52 +0100912 struct tasklet_struct pretbtt_tasklet;
913 struct tasklet_struct tbtt_tasklet;
914 struct tasklet_struct rxdone_tasklet;
915 struct tasklet_struct autowake_tasklet;
916
917 /*
918 * Protect the interrupt mask register.
919 */
920 spinlock_t irqmask_lock;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700921};
922
923/*
Bartlomiej Zolnierkiewicz1f285f12009-11-04 18:36:50 +0100924 * Register defines.
925 * Some registers require multiple attempts before success,
926 * in those cases REGISTER_BUSY_COUNT attempts should be
927 * taken with a REGISTER_BUSY_DELAY interval.
928 */
Ivo van Doornae4ecb92010-11-13 19:08:14 +0100929#define REGISTER_BUSY_COUNT 100
Bartlomiej Zolnierkiewicz1f285f12009-11-04 18:36:50 +0100930#define REGISTER_BUSY_DELAY 100
931
932/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700933 * Generic RF access.
934 * The RF is being accessed by word index.
935 */
Adam Baker0e14f6d2007-10-27 13:41:25 +0200936static inline void rt2x00_rf_read(struct rt2x00_dev *rt2x00dev,
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700937 const unsigned int word, u32 *data)
938{
Pavel Roskin6b26dea2009-08-04 17:48:16 -0400939 BUG_ON(word < 1 || word > rt2x00dev->ops->rf_size / sizeof(u32));
940 *data = rt2x00dev->rf[word - 1];
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700941}
942
Adam Baker0e14f6d2007-10-27 13:41:25 +0200943static inline void rt2x00_rf_write(struct rt2x00_dev *rt2x00dev,
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700944 const unsigned int word, u32 data)
945{
Pavel Roskin6b26dea2009-08-04 17:48:16 -0400946 BUG_ON(word < 1 || word > rt2x00dev->ops->rf_size / sizeof(u32));
947 rt2x00dev->rf[word - 1] = data;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700948}
949
950/*
951 * Generic EEPROM access.
952 * The EEPROM is being accessed by word index.
953 */
Adam Baker0e14f6d2007-10-27 13:41:25 +0200954static inline void *rt2x00_eeprom_addr(struct rt2x00_dev *rt2x00dev,
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700955 const unsigned int word)
956{
957 return (void *)&rt2x00dev->eeprom[word];
958}
959
Adam Baker0e14f6d2007-10-27 13:41:25 +0200960static inline void rt2x00_eeprom_read(struct rt2x00_dev *rt2x00dev,
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700961 const unsigned int word, u16 *data)
962{
963 *data = le16_to_cpu(rt2x00dev->eeprom[word]);
964}
965
Adam Baker0e14f6d2007-10-27 13:41:25 +0200966static inline void rt2x00_eeprom_write(struct rt2x00_dev *rt2x00dev,
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700967 const unsigned int word, u16 data)
968{
969 rt2x00dev->eeprom[word] = cpu_to_le16(data);
970}
971
972/*
973 * Chipset handlers
974 */
975static inline void rt2x00_set_chip(struct rt2x00_dev *rt2x00dev,
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100976 const u16 rt, const u16 rf, const u16 rev)
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700977{
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700978 rt2x00dev->chip.rt = rt;
979 rt2x00dev->chip.rf = rf;
980 rt2x00dev->chip.rev = rev;
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700981
Gertjan van Wingerde16475b02009-11-14 20:20:35 +0100982 INFO(rt2x00dev,
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100983 "Chipset detected - rt: %04x, rf: %04x, rev: %04x.\n",
Gertjan van Wingerde16475b02009-11-14 20:20:35 +0100984 rt2x00dev->chip.rt, rt2x00dev->chip.rf, rt2x00dev->chip.rev);
985}
986
Gertjan van Wingerde8d0c9b62010-04-11 14:31:10 +0200987static inline bool rt2x00_rt(struct rt2x00_dev *rt2x00dev, const u16 rt)
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700988{
Gertjan van Wingerde5122d892009-12-23 00:03:25 +0100989 return (rt2x00dev->chip.rt == rt);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700990}
991
Gertjan van Wingerde8d0c9b62010-04-11 14:31:10 +0200992static inline bool rt2x00_rf(struct rt2x00_dev *rt2x00dev, const u16 rf)
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700993{
Gertjan van Wingerde5122d892009-12-23 00:03:25 +0100994 return (rt2x00dev->chip.rf == rf);
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700995}
996
Gertjan van Wingerde49e721e2010-02-13 20:55:49 +0100997static inline u16 rt2x00_rev(struct rt2x00_dev *rt2x00dev)
Ivo van Doorn95ea3622007-09-25 17:57:13 -0700998{
Gertjan van Wingerde5122d892009-12-23 00:03:25 +0100999 return rt2x00dev->chip.rev;
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001000}
1001
Gertjan van Wingerde8d0c9b62010-04-11 14:31:10 +02001002static inline bool rt2x00_rt_rev(struct rt2x00_dev *rt2x00dev,
1003 const u16 rt, const u16 rev)
1004{
1005 return (rt2x00_rt(rt2x00dev, rt) && rt2x00_rev(rt2x00dev) == rev);
1006}
1007
1008static inline bool rt2x00_rt_rev_lt(struct rt2x00_dev *rt2x00dev,
1009 const u16 rt, const u16 rev)
1010{
1011 return (rt2x00_rt(rt2x00dev, rt) && rt2x00_rev(rt2x00dev) < rev);
1012}
1013
1014static inline bool rt2x00_rt_rev_gte(struct rt2x00_dev *rt2x00dev,
1015 const u16 rt, const u16 rev)
1016{
1017 return (rt2x00_rt(rt2x00dev, rt) && rt2x00_rev(rt2x00dev) >= rev);
1018}
1019
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001020static inline void rt2x00_set_chip_intf(struct rt2x00_dev *rt2x00dev,
1021 enum rt2x00_chip_intf intf)
1022{
1023 rt2x00dev->chip.intf = intf;
1024}
1025
Gertjan van Wingerde5122d892009-12-23 00:03:25 +01001026static inline bool rt2x00_intf(struct rt2x00_dev *rt2x00dev,
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001027 enum rt2x00_chip_intf intf)
1028{
Gertjan van Wingerde5122d892009-12-23 00:03:25 +01001029 return (rt2x00dev->chip.intf == intf);
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001030}
1031
Gertjan van Wingerdecea90e52010-02-13 20:55:47 +01001032static inline bool rt2x00_is_pci(struct rt2x00_dev *rt2x00dev)
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001033{
Gertjan van Wingerde6e1fdd12010-06-03 10:52:00 +02001034 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_PCI) ||
1035 rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_PCIE);
1036}
1037
1038static inline bool rt2x00_is_pcie(struct rt2x00_dev *rt2x00dev)
1039{
1040 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_PCIE);
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001041}
1042
Gertjan van Wingerdecea90e52010-02-13 20:55:47 +01001043static inline bool rt2x00_is_usb(struct rt2x00_dev *rt2x00dev)
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001044{
Gertjan van Wingerde5122d892009-12-23 00:03:25 +01001045 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_USB);
Bartlomiej Zolnierkiewicz5822e072009-11-04 18:36:10 +01001046}
1047
Gertjan van Wingerdecea90e52010-02-13 20:55:47 +01001048static inline bool rt2x00_is_soc(struct rt2x00_dev *rt2x00dev)
1049{
1050 return rt2x00_intf(rt2x00dev, RT2X00_CHIP_INTF_SOC);
1051}
1052
Ivo van Doorn181d6902008-02-05 16:42:23 -05001053/**
Gertjan van Wingerdec4da0042008-06-16 19:56:31 +02001054 * rt2x00queue_map_txskb - Map a skb into DMA for TX purposes.
Ivo van Doornfa695602010-10-11 15:37:25 +02001055 * @entry: Pointer to &struct queue_entry
Gertjan van Wingerde239c2492008-06-06 22:54:12 +02001056 */
Ivo van Doornfa695602010-10-11 15:37:25 +02001057void rt2x00queue_map_txskb(struct queue_entry *entry);
Gertjan van Wingerde239c2492008-06-06 22:54:12 +02001058
1059/**
Gertjan van Wingerde0b8004a2010-06-03 10:51:45 +02001060 * rt2x00queue_unmap_skb - Unmap a skb from DMA.
Ivo van Doornfa695602010-10-11 15:37:25 +02001061 * @entry: Pointer to &struct queue_entry
Gertjan van Wingerde0b8004a2010-06-03 10:51:45 +02001062 */
Ivo van Doornfa695602010-10-11 15:37:25 +02001063void rt2x00queue_unmap_skb(struct queue_entry *entry);
Gertjan van Wingerde0b8004a2010-06-03 10:51:45 +02001064
1065/**
Helmut Schaa11f818e2011-03-03 19:38:55 +01001066 * rt2x00queue_get_tx_queue - Convert tx queue index to queue pointer
1067 * @rt2x00dev: Pointer to &struct rt2x00_dev.
1068 * @queue: rt2x00 queue index (see &enum data_queue_qid).
1069 *
1070 * Returns NULL for non tx queues.
1071 */
1072static inline struct data_queue *
1073rt2x00queue_get_tx_queue(struct rt2x00_dev *rt2x00dev,
1074 const enum data_queue_qid queue)
1075{
1076 if (queue < rt2x00dev->ops->tx_queues && rt2x00dev->tx)
1077 return &rt2x00dev->tx[queue];
1078
Gertjan van Wingerde61c6e482011-03-03 19:46:29 +01001079 if (queue == QID_ATIM)
1080 return rt2x00dev->atim;
1081
Helmut Schaa11f818e2011-03-03 19:38:55 +01001082 return NULL;
1083}
1084
1085/**
Ivo van Doorn181d6902008-02-05 16:42:23 -05001086 * rt2x00queue_get_entry - Get queue entry where the given index points to.
Ivo van Doorn9a46d442008-04-21 19:02:17 +02001087 * @queue: Pointer to &struct data_queue from where we obtain the entry.
Ivo van Doorn181d6902008-02-05 16:42:23 -05001088 * @index: Index identifier for obtaining the correct index.
1089 */
1090struct queue_entry *rt2x00queue_get_entry(struct data_queue *queue,
1091 enum queue_index index);
1092
Ivo van Doorn0b7fde52010-12-13 12:35:17 +01001093/**
1094 * rt2x00queue_pause_queue - Pause a data queue
1095 * @queue: Pointer to &struct data_queue.
1096 *
1097 * This function will pause the data queue locally, preventing
1098 * new frames to be added to the queue (while the hardware is
1099 * still allowed to run).
1100 */
1101void rt2x00queue_pause_queue(struct data_queue *queue);
1102
1103/**
1104 * rt2x00queue_unpause_queue - unpause a data queue
1105 * @queue: Pointer to &struct data_queue.
1106 *
1107 * This function will unpause the data queue locally, allowing
1108 * new frames to be added to the queue again.
1109 */
1110void rt2x00queue_unpause_queue(struct data_queue *queue);
1111
1112/**
1113 * rt2x00queue_start_queue - Start a data queue
1114 * @queue: Pointer to &struct data_queue.
1115 *
1116 * This function will start handling all pending frames in the queue.
1117 */
1118void rt2x00queue_start_queue(struct data_queue *queue);
1119
1120/**
1121 * rt2x00queue_stop_queue - Halt a data queue
1122 * @queue: Pointer to &struct data_queue.
1123 *
1124 * This function will stop all pending frames in the queue.
1125 */
1126void rt2x00queue_stop_queue(struct data_queue *queue);
1127
1128/**
Ivo van Doorn5be65602010-12-13 12:35:40 +01001129 * rt2x00queue_flush_queue - Flush a data queue
1130 * @queue: Pointer to &struct data_queue.
1131 * @drop: True to drop all pending frames.
1132 *
1133 * This function will flush the queue. After this call
Lucas De Marchi25985ed2011-03-30 22:57:33 -03001134 * the queue is guaranteed to be empty.
Ivo van Doorn5be65602010-12-13 12:35:40 +01001135 */
1136void rt2x00queue_flush_queue(struct data_queue *queue, bool drop);
1137
1138/**
Ivo van Doorn0b7fde52010-12-13 12:35:17 +01001139 * rt2x00queue_start_queues - Start all data queues
1140 * @rt2x00dev: Pointer to &struct rt2x00_dev.
1141 *
1142 * This function will loop through all available queues to start them
1143 */
1144void rt2x00queue_start_queues(struct rt2x00_dev *rt2x00dev);
1145
1146/**
1147 * rt2x00queue_stop_queues - Halt all data queues
1148 * @rt2x00dev: Pointer to &struct rt2x00_dev.
1149 *
1150 * This function will loop through all available queues to stop
1151 * any pending frames.
1152 */
1153void rt2x00queue_stop_queues(struct rt2x00_dev *rt2x00dev);
1154
Ivo van Doorn5be65602010-12-13 12:35:40 +01001155/**
1156 * rt2x00queue_flush_queues - Flush all data queues
1157 * @rt2x00dev: Pointer to &struct rt2x00_dev.
1158 * @drop: True to drop all pending frames.
1159 *
1160 * This function will loop through all available queues to flush
1161 * any pending frames.
1162 */
1163void rt2x00queue_flush_queues(struct rt2x00_dev *rt2x00dev, bool drop);
1164
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001165/*
Gertjan van Wingerdeb4df4702010-05-13 13:16:36 +02001166 * Debugfs handlers.
1167 */
1168/**
1169 * rt2x00debug_dump_frame - Dump a frame to userspace through debugfs.
1170 * @rt2x00dev: Pointer to &struct rt2x00_dev.
1171 * @type: The type of frame that is being dumped.
1172 * @skb: The skb containing the frame to be dumped.
1173 */
1174#ifdef CONFIG_RT2X00_LIB_DEBUGFS
1175void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev,
1176 enum rt2x00_dump_type type, struct sk_buff *skb);
1177#else
1178static inline void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev,
1179 enum rt2x00_dump_type type,
1180 struct sk_buff *skb)
1181{
1182}
1183#endif /* CONFIG_RT2X00_LIB_DEBUGFS */
1184
1185/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001186 * Interrupt context handlers.
1187 */
1188void rt2x00lib_beacondone(struct rt2x00_dev *rt2x00dev);
Helmut Schaa9f926fb2010-07-11 12:28:23 +02001189void rt2x00lib_pretbtt(struct rt2x00_dev *rt2x00dev);
Ivo van Doorn64e7d722010-12-13 12:36:00 +01001190void rt2x00lib_dmastart(struct queue_entry *entry);
Ivo van Doorn652a9dd2010-08-30 21:15:19 +02001191void rt2x00lib_dmadone(struct queue_entry *entry);
Ivo van Doorn181d6902008-02-05 16:42:23 -05001192void rt2x00lib_txdone(struct queue_entry *entry,
1193 struct txdone_entry_desc *txdesc);
Ivo van Doorn3392bec2010-08-06 20:46:53 +02001194void rt2x00lib_txdone_noinfo(struct queue_entry *entry, u32 status);
Ivo van Doornfa695602010-10-11 15:37:25 +02001195void rt2x00lib_rxdone(struct queue_entry *entry);
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001196
1197/*
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001198 * mac80211 handlers.
1199 */
Johannes Berg7bb45682011-02-24 14:42:06 +01001200void rt2x00mac_tx(struct ieee80211_hw *hw, struct sk_buff *skb);
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001201int rt2x00mac_start(struct ieee80211_hw *hw);
1202void rt2x00mac_stop(struct ieee80211_hw *hw);
1203int rt2x00mac_add_interface(struct ieee80211_hw *hw,
Johannes Berg1ed32e42009-12-23 13:15:45 +01001204 struct ieee80211_vif *vif);
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001205void rt2x00mac_remove_interface(struct ieee80211_hw *hw,
Johannes Berg1ed32e42009-12-23 13:15:45 +01001206 struct ieee80211_vif *vif);
Johannes Berge8975582008-10-09 12:18:51 +02001207int rt2x00mac_config(struct ieee80211_hw *hw, u32 changed);
Ivo van Doorn3a643d22008-03-25 14:13:18 +01001208void rt2x00mac_configure_filter(struct ieee80211_hw *hw,
1209 unsigned int changed_flags,
1210 unsigned int *total_flags,
Johannes Berg3ac64be2009-08-17 16:16:53 +02001211 u64 multicast);
Stefan Steuerwald930c06f2009-07-10 20:42:55 +02001212int rt2x00mac_set_tim(struct ieee80211_hw *hw, struct ieee80211_sta *sta,
1213 bool set);
Ivo van Doorn2bb057d2008-08-04 16:37:44 +02001214#ifdef CONFIG_RT2X00_LIB_CRYPTO
1215int rt2x00mac_set_key(struct ieee80211_hw *hw, enum set_key_cmd cmd,
Johannes Bergdc822b52008-12-29 12:55:09 +01001216 struct ieee80211_vif *vif, struct ieee80211_sta *sta,
Ivo van Doorn2bb057d2008-08-04 16:37:44 +02001217 struct ieee80211_key_conf *key);
1218#else
1219#define rt2x00mac_set_key NULL
1220#endif /* CONFIG_RT2X00_LIB_CRYPTO */
Ivo van Doornd8147f92010-07-11 12:24:47 +02001221void rt2x00mac_sw_scan_start(struct ieee80211_hw *hw);
1222void rt2x00mac_sw_scan_complete(struct ieee80211_hw *hw);
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001223int rt2x00mac_get_stats(struct ieee80211_hw *hw,
1224 struct ieee80211_low_level_stats *stats);
Johannes Berg471b3ef2007-12-28 14:32:58 +01001225void rt2x00mac_bss_info_changed(struct ieee80211_hw *hw,
1226 struct ieee80211_vif *vif,
1227 struct ieee80211_bss_conf *bss_conf,
1228 u32 changes);
Johannes Berge100bb62008-04-30 18:51:21 +02001229int rt2x00mac_conf_tx(struct ieee80211_hw *hw, u16 queue,
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001230 const struct ieee80211_tx_queue_params *params);
Ivo van Doorne47a5cd2009-07-01 15:17:35 +02001231void rt2x00mac_rfkill_poll(struct ieee80211_hw *hw);
Ivo van Doornf44df182010-11-04 20:40:11 +01001232void rt2x00mac_flush(struct ieee80211_hw *hw, bool drop);
Ivo van Doorn95ea3622007-09-25 17:57:13 -07001233
1234/*
1235 * Driver allocation handlers.
1236 */
1237int rt2x00lib_probe_dev(struct rt2x00_dev *rt2x00dev);
1238void rt2x00lib_remove_dev(struct rt2x00_dev *rt2x00dev);
1239#ifdef CONFIG_PM
1240int rt2x00lib_suspend(struct rt2x00_dev *rt2x00dev, pm_message_t state);
1241int rt2x00lib_resume(struct rt2x00_dev *rt2x00dev);
1242#endif /* CONFIG_PM */
1243
1244#endif /* RT2X00_H */