rt2x00lib.h revision 5a6e59991b82580c3ca00115603b85762ec76104
1/*
2	Copyright (C) 2004 - 2008 rt2x00 SourceForge Project
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
29#include "rt2x00dump.h"
30
31/*
32 * Interval defines
33 * Both the link tuner as the rfkill will be called once per second.
34 */
35#define LINK_TUNE_INTERVAL	( round_jiffies_relative(HZ) )
36#define RFKILL_POLL_INTERVAL	( 1000 )
37
38/*
39 * rt2x00_rate: Per rate device information
40 */
41struct rt2x00_rate {
42	unsigned short flags;
43#define DEV_RATE_CCK			0x0001
44#define DEV_RATE_OFDM			0x0002
45#define DEV_RATE_SHORT_PREAMBLE		0x0004
46#define DEV_RATE_BASIC			0x0008
47
48	unsigned short bitrate; /* In 100kbit/s */
49	unsigned short ratemask;
50
51	unsigned short plcp;
52};
53
54extern const struct rt2x00_rate rt2x00_supported_rates[12];
55
56static inline u16 rt2x00_create_rate_hw_value(const u16 index,
57					      const u16 short_preamble)
58{
59	return (short_preamble << 8) | (index & 0xff);
60}
61
62static inline const struct rt2x00_rate *rt2x00_get_rate(const u16 hw_value)
63{
64	return &rt2x00_supported_rates[hw_value & 0xff];
65}
66
67static inline int rt2x00_get_rate_preamble(const u16 hw_value)
68{
69	return (hw_value & 0xff00);
70}
71
72/*
73 * Radio control handlers.
74 */
75int rt2x00lib_enable_radio(struct rt2x00_dev *rt2x00dev);
76void rt2x00lib_disable_radio(struct rt2x00_dev *rt2x00dev);
77void rt2x00lib_toggle_rx(struct rt2x00_dev *rt2x00dev, enum dev_state state);
78void rt2x00lib_reset_link_tuner(struct rt2x00_dev *rt2x00dev);
79
80/*
81 * Initialization handlers.
82 */
83int rt2x00lib_start(struct rt2x00_dev *rt2x00dev);
84void rt2x00lib_stop(struct rt2x00_dev *rt2x00dev);
85
86/*
87 * Configuration handlers.
88 */
89void rt2x00lib_config_intf(struct rt2x00_dev *rt2x00dev,
90			   struct rt2x00_intf *intf,
91			   enum ieee80211_if_types type,
92			   u8 *mac, u8 *bssid);
93void rt2x00lib_config_erp(struct rt2x00_dev *rt2x00dev,
94			  struct rt2x00_intf *intf,
95			  struct ieee80211_bss_conf *conf);
96void rt2x00lib_config_antenna(struct rt2x00_dev *rt2x00dev,
97			      enum antenna rx, enum antenna tx);
98void rt2x00lib_config(struct rt2x00_dev *rt2x00dev,
99		      struct ieee80211_conf *conf, const int force_config);
100
101/*
102 * Queue handlers.
103 */
104void rt2x00queue_init_rx(struct rt2x00_dev *rt2x00dev);
105void rt2x00queue_init_tx(struct rt2x00_dev *rt2x00dev);
106int rt2x00queue_initialize(struct rt2x00_dev *rt2x00dev);
107void rt2x00queue_uninitialize(struct rt2x00_dev *rt2x00dev);
108int rt2x00queue_allocate(struct rt2x00_dev *rt2x00dev);
109void rt2x00queue_free(struct rt2x00_dev *rt2x00dev);
110
111/*
112 * Firmware handlers.
113 */
114#ifdef CONFIG_RT2X00_LIB_FIRMWARE
115int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev);
116void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev);
117#else
118static inline int rt2x00lib_load_firmware(struct rt2x00_dev *rt2x00dev)
119{
120	return 0;
121}
122static inline void rt2x00lib_free_firmware(struct rt2x00_dev *rt2x00dev)
123{
124}
125#endif /* CONFIG_RT2X00_LIB_FIRMWARE */
126
127/*
128 * Debugfs handlers.
129 */
130#ifdef CONFIG_RT2X00_LIB_DEBUGFS
131void rt2x00debug_register(struct rt2x00_dev *rt2x00dev);
132void rt2x00debug_deregister(struct rt2x00_dev *rt2x00dev);
133void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev,
134			    enum rt2x00_dump_type type, struct sk_buff *skb);
135#else
136static inline void rt2x00debug_register(struct rt2x00_dev *rt2x00dev)
137{
138}
139
140static inline void rt2x00debug_deregister(struct rt2x00_dev *rt2x00dev)
141{
142}
143
144static inline void rt2x00debug_dump_frame(struct rt2x00_dev *rt2x00dev,
145					  enum rt2x00_dump_type type,
146					  struct sk_buff *skb)
147{
148}
149#endif /* CONFIG_RT2X00_LIB_DEBUGFS */
150
151/*
152 * RFkill handlers.
153 */
154#ifdef CONFIG_RT2X00_LIB_RFKILL
155void rt2x00rfkill_register(struct rt2x00_dev *rt2x00dev);
156void rt2x00rfkill_unregister(struct rt2x00_dev *rt2x00dev);
157void rt2x00rfkill_allocate(struct rt2x00_dev *rt2x00dev);
158void rt2x00rfkill_free(struct rt2x00_dev *rt2x00dev);
159void rt2x00rfkill_suspend(struct rt2x00_dev *rt2x00dev);
160void rt2x00rfkill_resume(struct rt2x00_dev *rt2x00dev);
161#else
162static inline void rt2x00rfkill_register(struct rt2x00_dev *rt2x00dev)
163{
164}
165
166static inline void rt2x00rfkill_unregister(struct rt2x00_dev *rt2x00dev)
167{
168}
169
170static inline void rt2x00rfkill_allocate(struct rt2x00_dev *rt2x00dev)
171{
172}
173
174static inline void rt2x00rfkill_free(struct rt2x00_dev *rt2x00dev)
175{
176}
177
178static inline void rt2x00rfkill_suspend(struct rt2x00_dev *rt2x00dev)
179{
180}
181
182static inline void rt2x00rfkill_resume(struct rt2x00_dev *rt2x00dev)
183{
184}
185#endif /* CONFIG_RT2X00_LIB_RFKILL */
186
187/*
188 * LED handlers
189 */
190#ifdef CONFIG_RT2X00_LIB_LEDS
191void rt2x00leds_led_quality(struct rt2x00_dev *rt2x00dev, int rssi);
192void rt2x00led_led_activity(struct rt2x00_dev *rt2x00dev, bool enabled);
193void rt2x00leds_led_assoc(struct rt2x00_dev *rt2x00dev, bool enabled);
194void rt2x00leds_led_radio(struct rt2x00_dev *rt2x00dev, bool enabled);
195void rt2x00leds_register(struct rt2x00_dev *rt2x00dev);
196void rt2x00leds_unregister(struct rt2x00_dev *rt2x00dev);
197void rt2x00leds_suspend(struct rt2x00_dev *rt2x00dev);
198void rt2x00leds_resume(struct rt2x00_dev *rt2x00dev);
199#else
200static inline void rt2x00leds_led_quality(struct rt2x00_dev *rt2x00dev,
201					  int rssi)
202{
203}
204
205static inline void rt2x00led_led_activity(struct rt2x00_dev *rt2x00dev,
206					  bool enabled)
207{
208}
209
210static inline void rt2x00leds_led_assoc(struct rt2x00_dev *rt2x00dev,
211					bool enabled)
212{
213}
214
215static inline void rt2x00leds_led_radio(struct rt2x00_dev *rt2x00dev,
216					bool enabled)
217{
218}
219
220static inline void rt2x00leds_register(struct rt2x00_dev *rt2x00dev)
221{
222}
223
224static inline void rt2x00leds_unregister(struct rt2x00_dev *rt2x00dev)
225{
226}
227
228static inline void rt2x00leds_suspend(struct rt2x00_dev *rt2x00dev)
229{
230}
231
232static inline void rt2x00leds_resume(struct rt2x00_dev *rt2x00dev)
233{
234}
235#endif /* CONFIG_RT2X00_LIB_LEDS */
236
237#endif /* RT2X00LIB_H */
238