]> bbs.cooldavid.org Git - net-next-2.6.git/blame - drivers/net/wireless/rt2x00/rt2x00lib.h
Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/penberg...
[net-next-2.6.git] / drivers / net / wireless / rt2x00 / rt2x00lib.h
CommitLineData
95ea3627 1/*
811aa9ca 2 Copyright (C) 2004 - 2008 rt2x00 SourceForge Project
95ea3627
ID
3 <http://rt2x00.serialmonkey.com>
4
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program; if not, write to the
17 Free Software Foundation, Inc.,
18 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
19 */
20
21/*
22 Module: rt2x00lib
23 Abstract: Data structures and definitions for the rt2x00lib module.
24 */
25
26#ifndef RT2X00LIB_H
27#define RT2X00LIB_H
28
5a6e5999
ID
29#include "rt2x00dump.h"
30
95ea3627
ID
31/*
32 * Interval defines
81873e9c 33 * Both the link tuner as the rfkill will be called once per second.
95ea3627 34 */
b239bd75 35#define LINK_TUNE_INTERVAL ( round_jiffies_relative(HZ) )
50db7875 36#define RFKILL_POLL_INTERVAL ( round_jiffies_relative(HZ) )
95ea3627 37
70e2fed4
ID
38/*
39 * rt2x00_rate: Per rate device information
40 */
41struct rt2x00_rate {
42 unsigned short flags;
31562e80
ID
43#define DEV_RATE_CCK 0x0001
44#define DEV_RATE_OFDM 0x0002
45#define DEV_RATE_SHORT_PREAMBLE 0x0004
70e2fed4
ID
46
47 unsigned short bitrate; /* In 100kbit/s */
70e2fed4 48 unsigned short ratemask;
70e2fed4
ID
49
50 unsigned short plcp;
51};
52
53extern const struct rt2x00_rate rt2x00_supported_rates[12];
54
70e2fed4
ID
55static inline const struct rt2x00_rate *rt2x00_get_rate(const u16 hw_value)
56{
57 return &rt2x00_supported_rates[hw_value & 0xff];
58}
59
95ea3627
ID
60/*
61 * Radio control handlers.
62 */
63int rt2x00lib_enable_radio(struct rt2x00_dev *rt2x00dev);
64void rt2x00lib_disable_radio(struct rt2x00_dev *rt2x00dev);
5cbf830e 65void rt2x00lib_toggle_rx(struct rt2x00_dev *rt2x00dev, enum dev_state state);
95ea3627
ID
66void rt2x00lib_reset_link_tuner(struct rt2x00_dev *rt2x00dev);
67
68/*
69 * Initialization handlers.
70 */
e37ea213
ID
71int rt2x00lib_start(struct rt2x00_dev *rt2x00dev);
72void rt2x00lib_stop(struct rt2x00_dev *rt2x00dev);
95ea3627
ID
73
74/*
75 * Configuration handlers.
76 */
6bb40dd1
ID
77void rt2x00lib_config_intf(struct rt2x00_dev *rt2x00dev,
78 struct rt2x00_intf *intf,
05c914fe 79 enum nl80211_iftype type,
6bb40dd1 80 u8 *mac, u8 *bssid);
72810379
ID
81void rt2x00lib_config_erp(struct rt2x00_dev *rt2x00dev,
82 struct rt2x00_intf *intf,
83 struct ieee80211_bss_conf *conf);
69f81a2c 84void rt2x00lib_config_antenna(struct rt2x00_dev *rt2x00dev,
6d64360a 85 struct antenna_setup *ant);
066cb637 86void rt2x00lib_config(struct rt2x00_dev *rt2x00dev,
e4ea1c40
ID
87 struct ieee80211_conf *conf,
88 const unsigned int changed_flags);
95ea3627 89
d74f5ba4
ID
90/**
91 * DOC: Queue handlers
92 */
93
94/**
95 * rt2x00queue_alloc_rxskb - allocate a skb for RX purposes.
96 * @rt2x00dev: Pointer to &struct rt2x00_dev.
97 * @queue: The queue for which the skb will be applicable.
98 */
99struct sk_buff *rt2x00queue_alloc_rxskb(struct rt2x00_dev *rt2x00dev,
100 struct queue_entry *entry);
101
102/**
103 * rt2x00queue_unmap_skb - Unmap a skb from DMA.
104 * @rt2x00dev: Pointer to &struct rt2x00_dev.
105 * @skb: The skb to unmap.
106 */
107void rt2x00queue_unmap_skb(struct rt2x00_dev *rt2x00dev, struct sk_buff *skb);
108
109/**
110 * rt2x00queue_free_skb - free a skb
111 * @rt2x00dev: Pointer to &struct rt2x00_dev.
112 * @skb: The skb to free.
113 */
114void rt2x00queue_free_skb(struct rt2x00_dev *rt2x00dev, struct sk_buff *skb);
115
d74f5ba4
ID
116/**
117 * rt2x00queue_write_tx_frame - Write TX frame to hardware
118 * @queue: Queue over which the frame should be send
119 * @skb: The skb to send
181d6902 120 */
6db3786a 121int rt2x00queue_write_tx_frame(struct data_queue *queue, struct sk_buff *skb);
d74f5ba4 122
bd88a781
ID
123/**
124 * rt2x00queue_update_beacon - Send new beacon from mac80211 to hardware
125 * @rt2x00dev: Pointer to &struct rt2x00_dev.
126 * @vif: Interface for which the beacon should be updated.
127 */
128int rt2x00queue_update_beacon(struct rt2x00_dev *rt2x00dev,
129 struct ieee80211_vif *vif);
130
d74f5ba4
ID
131/**
132 * rt2x00queue_index_inc - Index incrementation function
133 * @queue: Queue (&struct data_queue) to perform the action on.
134 * @index: Index type (&enum queue_index) to perform the action on.
135 *
136 * This function will increase the requested index on the queue,
137 * it will grab the appropriate locks and handle queue overflow events by
138 * resetting the index to the start of the queue.
139 */
140void rt2x00queue_index_inc(struct data_queue *queue, enum queue_index index);
141
798b7adb
ID
142/**
143 * rt2x00queue_init_queues - Initialize all data queues
144 * @rt2x00dev: Pointer to &struct rt2x00_dev.
145 *
146 * This function will loop through all available queues to clear all
147 * index numbers and set the queue entry to the correct initialization
148 * state.
149 */
150void rt2x00queue_init_queues(struct rt2x00_dev *rt2x00dev);
151
181d6902
ID
152int rt2x00queue_initialize(struct rt2x00_dev *rt2x00dev);
153void rt2x00queue_uninitialize(struct rt2x00_dev *rt2x00dev);
154int rt2x00queue_allocate(struct rt2x00_dev *rt2x00dev);
155void rt2x00queue_free(struct rt2x00_dev *rt2x00dev);
156
95ea3627
ID
157/*
158 * Firmware handlers.
159 */
160#ifdef CONFIG_RT2X00_LIB_FIRMWARE
161int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev);
162void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev);
163#else
164static inline int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
165{
166 return 0;
167}
168static inline void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev)
169{
170}
171#endif /* CONFIG_RT2X00_LIB_FIRMWARE */
172
173/*
174 * Debugfs handlers.
175 */
176#ifdef CONFIG_RT2X00_LIB_DEBUGFS
177void rt2x00debug_register(struct rt2x00_dev *rt2x00dev);
178void rt2x00debug_deregister(struct rt2x00_dev *rt2x00dev);
5a6e5999
ID
179void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev,
180 enum rt2x00_dump_type type, struct sk_buff *skb);
2bb057d0
ID
181void rt2x00debug_update_crypto(struct rt2x00_dev *rt2x00dev,
182 enum cipher cipher, enum rx_crypto status);
95ea3627
ID
183#else
184static inline void rt2x00debug_register(struct rt2x00_dev *rt2x00dev)
185{
186}
187
188static inline void rt2x00debug_deregister(struct rt2x00_dev *rt2x00dev)
189{
190}
4d8dd66c
ID
191
192static inline void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev,
5a6e5999 193 enum rt2x00_dump_type type,
2b1ea591 194 struct sk_buff *skb)
4d8dd66c
ID
195{
196}
2bb057d0
ID
197
198static inline void rt2x00debug_update_crypto(struct rt2x00_dev *rt2x00dev,
199 enum cipher cipher,
200 enum rx_crypto status)
201{
202}
95ea3627
ID
203#endif /* CONFIG_RT2X00_LIB_DEBUGFS */
204
2bb057d0
ID
205/*
206 * Crypto handlers.
207 */
208#ifdef CONFIG_RT2X00_LIB_CRYPTO
209enum cipher rt2x00crypto_key_to_cipher(struct ieee80211_key_conf *key);
9c3444d3
ID
210void rt2x00crypto_create_tx_descriptor(struct queue_entry *entry,
211 struct txentry_desc *txdesc);
2bb057d0 212unsigned int rt2x00crypto_tx_overhead(struct ieee80211_tx_info *tx_info);
dddfb478 213void rt2x00crypto_tx_copy_iv(struct sk_buff *skb, unsigned int iv_len);
2bb057d0
ID
214void rt2x00crypto_tx_remove_iv(struct sk_buff *skb, unsigned int iv_len);
215void rt2x00crypto_tx_insert_iv(struct sk_buff *skb);
216void rt2x00crypto_rx_insert_iv(struct sk_buff *skb, unsigned int align,
217 unsigned int header_length,
218 struct rxdone_entry_desc *rxdesc);
219#else
220static inline enum cipher rt2x00crypto_key_to_cipher(struct ieee80211_key_conf *key)
221{
222 return CIPHER_NONE;
223}
224
9c3444d3
ID
225static inline void rt2x00crypto_create_tx_descriptor(struct queue_entry *entry,
226 struct txentry_desc *txdesc)
227{
228}
229
2bb057d0
ID
230static inline unsigned int rt2x00crypto_tx_overhead(struct ieee80211_tx_info *tx_info)
231{
232 return 0;
233}
234
dddfb478
ID
235static inline void rt2x00crypto_tx_copy_iv(struct sk_buff *skb,
236 unsigned int iv_len)
237{
238}
239
2bb057d0
ID
240static inline void rt2x00crypto_tx_remove_iv(struct sk_buff *skb,
241 unsigned int iv_len)
242{
243}
244
245static inline void rt2x00crypto_tx_insert_iv(struct sk_buff *skb)
246{
247}
248
249static inline void rt2x00crypto_rx_insert_iv(struct sk_buff *skb,
250 unsigned int align,
251 unsigned int header_length,
252 struct rxdone_entry_desc *rxdesc)
253{
254}
9c3444d3 255#endif /* CONFIG_RT2X00_LIB_CRYPTO */
2bb057d0 256
95ea3627
ID
257/*
258 * RFkill handlers.
259 */
260#ifdef CONFIG_RT2X00_LIB_RFKILL
1682fe6d 261void rt2x00rfkill_register(struct rt2x00_dev *rt2x00dev);
95ea3627 262void rt2x00rfkill_unregister(struct rt2x00_dev *rt2x00dev);
1682fe6d 263void rt2x00rfkill_allocate(struct rt2x00_dev *rt2x00dev);
95ea3627
ID
264void rt2x00rfkill_free(struct rt2x00_dev *rt2x00dev);
265#else
1682fe6d 266static inline void rt2x00rfkill_register(struct rt2x00_dev *rt2x00dev)
95ea3627 267{
95ea3627
ID
268}
269
270static inline void rt2x00rfkill_unregister(struct rt2x00_dev *rt2x00dev)
271{
272}
273
1682fe6d 274static inline void rt2x00rfkill_allocate(struct rt2x00_dev *rt2x00dev)
95ea3627 275{
95ea3627
ID
276}
277
278static inline void rt2x00rfkill_free(struct rt2x00_dev *rt2x00dev)
279{
280}
281#endif /* CONFIG_RT2X00_LIB_RFKILL */
282
a9450b70
ID
283/*
284 * LED handlers
285 */
286#ifdef CONFIG_RT2X00_LIB_LEDS
287void rt2x00leds_led_quality(struct rt2x00_dev *rt2x00dev, int rssi);
61c2b682 288void rt2x00led_led_activity(struct rt2x00_dev *rt2x00dev, bool enabled);
a2e1d52a
ID
289void rt2x00leds_led_assoc(struct rt2x00_dev *rt2x00dev, bool enabled);
290void rt2x00leds_led_radio(struct rt2x00_dev *rt2x00dev, bool enabled);
72fa559b 291void rt2x00leds_register(struct rt2x00_dev *rt2x00dev);
a9450b70
ID
292void rt2x00leds_unregister(struct rt2x00_dev *rt2x00dev);
293void rt2x00leds_suspend(struct rt2x00_dev *rt2x00dev);
294void rt2x00leds_resume(struct rt2x00_dev *rt2x00dev);
295#else
296static inline void rt2x00leds_led_quality(struct rt2x00_dev *rt2x00dev,
297 int rssi)
298{
299}
300
61c2b682
ID
301static inline void rt2x00led_led_activity(struct rt2x00_dev *rt2x00dev,
302 bool enabled)
303{
304}
305
a2e1d52a
ID
306static inline void rt2x00leds_led_assoc(struct rt2x00_dev *rt2x00dev,
307 bool enabled)
308{
309}
310
311static inline void rt2x00leds_led_radio(struct rt2x00_dev *rt2x00dev,
312 bool enabled)
313{
314}
315
72fa559b 316static inline void rt2x00leds_register(struct rt2x00_dev *rt2x00dev)
a9450b70 317{
a9450b70
ID
318}
319
320static inline void rt2x00leds_unregister(struct rt2x00_dev *rt2x00dev)
321{
322}
323
324static inline void rt2x00leds_suspend(struct rt2x00_dev *rt2x00dev)
325{
326}
327
328static inline void rt2x00leds_resume(struct rt2x00_dev *rt2x00dev)
329{
330}
331#endif /* CONFIG_RT2X00_LIB_LEDS */
332
95ea3627 333#endif /* RT2X00LIB_H */