drivers/net/wireless/rt2x00/rt2x00lib.h

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