drivers/net/wireless/libertas/defs.h

   1 /**
   2   * This header file contains global constant/enum definitions,
   3   * global variable declaration.
   4   */
   5 #ifndef _WLAN_DEFS_H_
   6 #define _WLAN_DEFS_H_
   7
   8 #include <linux/spinlock.h>
   9
  10 #ifdef CONFIG_LIBERTAS_DEBUG
  11 #define DEBUG
  12 #define PROC_DEBUG
  13 #endif
  14
  15 #define DRV_NAME "usb8xxx"
  16
  17
  18 #define LBS_DEB_ENTER   0x00000001
  19 #define LBS_DEB_LEAVE   0x00000002
  20 #define LBS_DEB_MAIN    0x00000004
  21 #define LBS_DEB_NET     0x00000008
  22 #define LBS_DEB_MESH    0x00000010
  23 #define LBS_DEB_WEXT    0x00000020
  24 #define LBS_DEB_IOCTL   0x00000040
  25 #define LBS_DEB_SCAN    0x00000080
  26 #define LBS_DEB_ASSOC   0x00000100
  27 #define LBS_DEB_JOIN    0x00000200
  28 #define LBS_DEB_11D     0x00000400
  29 #define LBS_DEB_DEBUGFS 0x00000800
  30 #define LBS_DEB_ETHTOOL 0x00001000
  31 #define LBS_DEB_HOST    0x00002000
  32 #define LBS_DEB_CMD     0x00004000
  33 #define LBS_DEB_RX      0x00008000
  34 #define LBS_DEB_TX      0x00010000
  35 #define LBS_DEB_USB     0x00020000
  36 #define LBS_DEB_CS      0x00040000
  37 #define LBS_DEB_FW      0x00080000
  38 #define LBS_DEB_THREAD  0x00100000
  39 #define LBS_DEB_HEX     0x00200000
  40
  41 extern unsigned int libertas_debug;
  42
  43 #ifdef DEBUG
  44 #define LBS_DEB_LL(grp, fmt, args...) \
  45 do { if ((libertas_debug & (grp)) == (grp)) \
  46   printk(KERN_DEBUG DRV_NAME "%s: " fmt, \
  47          in_interrupt() ? " (INT)" : "", ## args); } while (0)
  48 #else
  49 #define LBS_DEB_LL(grp, fmt, args...) do {} while (0)
  50 #endif
  51
  52 #define lbs_deb_enter(grp) \
  53   LBS_DEB_LL(grp | LBS_DEB_ENTER, "%s():%d enter\n", __FUNCTION__, __LINE__);
  54 #define lbs_deb_enter_args(grp, fmt, args...) \
  55   LBS_DEB_LL(grp | LBS_DEB_ENTER, "%s(" fmt "):%d\n", __FUNCTION__, ## args, __LINE__);
  56 #define lbs_deb_leave(grp) \
  57   LBS_DEB_LL(grp | LBS_DEB_LEAVE, "%s():%d leave\n", __FUNCTION__, __LINE__);
  58 #define lbs_deb_leave_args(grp, fmt, args...) \
  59   LBS_DEB_LL(grp | LBS_DEB_LEAVE, "%s():%d leave, " fmt "\n", \
  60   __FUNCTION__, __LINE__, ##args);
  61 #define lbs_deb_main(fmt, args...)      LBS_DEB_LL(LBS_DEB_MAIN, fmt, ##args)
  62 #define lbs_deb_net(fmt, args...)       LBS_DEB_LL(LBS_DEB_NET, fmt, ##args)
  63 #define lbs_deb_mesh(fmt, args...)      LBS_DEB_LL(LBS_DEB_MESH, fmt, ##args)
  64 #define lbs_deb_wext(fmt, args...)      LBS_DEB_LL(LBS_DEB_WEXT, fmt, ##args)
  65 #define lbs_deb_ioctl(fmt, args...)     LBS_DEB_LL(LBS_DEB_IOCTL, fmt, ##args)
  66 #define lbs_deb_scan(fmt, args...)      LBS_DEB_LL(LBS_DEB_SCAN, fmt, ##args)
  67 #define lbs_deb_assoc(fmt, args...)     LBS_DEB_LL(LBS_DEB_ASSOC, fmt, ##args)
  68 #define lbs_deb_join(fmt, args...)      LBS_DEB_LL(LBS_DEB_JOIN, fmt, ##args)
  69 #define lbs_deb_11d(fmt, args...)       LBS_DEB_LL(LBS_DEB_11D, fmt, ##args)
  70 #define lbs_deb_debugfs(fmt, args...)   LBS_DEB_LL(LBS_DEB_DEBUGFS, fmt, ##args)
  71 #define lbs_deb_ethtool(fmt, args...)   LBS_DEB_LL(LBS_DEB_ETHTOOL, fmt, ##args)
  72 #define lbs_deb_host(fmt, args...)      LBS_DEB_LL(LBS_DEB_HOST, fmt, ##args)
  73 #define lbs_deb_cmd(fmt, args...)       LBS_DEB_LL(LBS_DEB_CMD, fmt, ##args)
  74 #define lbs_deb_rx(fmt, args...)        LBS_DEB_LL(LBS_DEB_RX, fmt, ##args)
  75 #define lbs_deb_tx(fmt, args...)        LBS_DEB_LL(LBS_DEB_TX, fmt, ##args)
  76 #define lbs_deb_fw(fmt, args...)        LBS_DEB_LL(LBS_DEB_FW, fmt, ##args)
  77 #define lbs_deb_usb(fmt, args...)       LBS_DEB_LL(LBS_DEB_USB, fmt, ##args)
  78 #define lbs_deb_usbd(dev, fmt, args...) LBS_DEB_LL(LBS_DEB_USB, "%s:" fmt, (dev)->bus_id, ##args)
  79 #define lbs_deb_cs(fmt, args...)        LBS_DEB_LL(LBS_DEB_CS, fmt, ##args)
  80 #define lbs_deb_thread(fmt, args...)    LBS_DEB_LL(LBS_DEB_THREAD, fmt, ##args)
  81
  82 #define lbs_pr_info(format, args...) \
  83         printk(KERN_INFO DRV_NAME": " format, ## args)
  84 #define lbs_pr_err(format, args...) \
  85         printk(KERN_ERR DRV_NAME": " format, ## args)
  86 #define lbs_pr_alert(format, args...) \
  87         printk(KERN_ALERT DRV_NAME": " format, ## args)
  88
  89 #ifdef DEBUG
  90 static inline void lbs_dbg_hex(char *prompt, u8 * buf, int len)
  91 {
  92         int i = 0;
  93
  94         if (!(libertas_debug & LBS_DEB_HEX))
  95                 return;
  96
  97         printk(KERN_DEBUG "%s: ", prompt);
  98         for (i = 1; i <= len; i++) {
  99                 printk("%02x ", (u8) * buf);
 100                 buf++;
 101         }
 102         printk("\n");
 103 }
 104 #else
 105 #define lbs_dbg_hex(x,y,z)                              do {} while (0)
 106 #endif
 107
 108
 109
 110 /** Buffer Constants */
 111
 112 /*      The size of SQ memory PPA, DPA are 8 DWORDs, that keep the physical
 113 *       addresses of TxPD buffers. Station has only 8 TxPD available, Whereas
 114 *       driver has more local TxPDs. Each TxPD on the host memory is associated
 115 *       with a Tx control node. The driver maintains 8 RxPD descriptors for
 116 *       station firmware to store Rx packet information.
 117 *
 118 *       Current version of MAC has a 32x6 multicast address buffer.
 119 *
 120 *       802.11b can have up to  14 channels, the driver keeps the
 121 *       BSSID(MAC address) of each APs or Ad hoc stations it has sensed.
 122 */
 123
 124 #define MRVDRV_MAX_MULTICAST_LIST_SIZE  32
 125 #define MRVDRV_NUM_OF_CMD_BUFFER        10
 126 #define MRVDRV_SIZE_OF_CMD_BUFFER       (2 * 1024)
 127 #define MRVDRV_MAX_CHANNEL_SIZE         14
 128 #define MRVDRV_MAX_BSSID_LIST           64
 129 #define MRVDRV_ASSOCIATION_TIME_OUT     255
 130 #define MRVDRV_SNAP_HEADER_LEN          8
 131
 132 #define WLAN_UPLD_SIZE                  2312
 133 #define DEV_NAME_LEN                    32
 134
 135 /** Misc constants */
 136 /* This section defines 802.11 specific contants */
 137
 138 #define MRVDRV_MAX_BSS_DESCRIPTS                16
 139 #define MRVDRV_MAX_REGION_CODE                  6
 140
 141 #define MRVDRV_IGNORE_MULTIPLE_DTIM             0xfffe
 142 #define MRVDRV_MIN_MULTIPLE_DTIM                1
 143 #define MRVDRV_MAX_MULTIPLE_DTIM                5
 144 #define MRVDRV_DEFAULT_MULTIPLE_DTIM            1
 145
 146 #define MRVDRV_DEFAULT_LISTEN_INTERVAL          10
 147
 148 #define MRVDRV_CHANNELS_PER_SCAN                4
 149 #define MRVDRV_MAX_CHANNELS_PER_SCAN            14
 150
 151 #define MRVDRV_DEBUG_RX_PATH            0x00000001
 152 #define MRVDRV_DEBUG_TX_PATH            0x00000002
 153
 154 #define MRVDRV_MIN_BEACON_INTERVAL              20
 155 #define MRVDRV_MAX_BEACON_INTERVAL              1000
 156 #define MRVDRV_BEACON_INTERVAL                  100
 157
 158 /** TxPD status */
 159
 160 /*      Station firmware use TxPD status field to report final Tx transmit
 161 *       result, Bit masks are used to present combined situations.
 162 */
 163
 164 #define MRVDRV_TxPD_POWER_MGMT_NULL_PACKET 0x01
 165 #define MRVDRV_TxPD_POWER_MGMT_LAST_PACKET 0x08
 166
 167 /** Tx mesh flag */
 168 /* Currently we are using normal WDS flag as mesh flag.
 169  * TODO: change to proper mesh flag when MAC understands it.
 170  */
 171 #define TxPD_CONTROL_WDS_FRAME (1<<17)
 172 #define TxPD_MESH_FRAME TxPD_CONTROL_WDS_FRAME
 173
 174 /** RxPD status */
 175
 176 #define MRVDRV_RXPD_STATUS_OK                0x0001
 177
 178 /** RxPD status - Received packet types */
 179 /** Rx mesh flag */
 180 /* Currently we are using normal WDS flag as mesh flag.
 181  * TODO: change to proper mesh flag when MAC understands it.
 182  */
 183 #define RxPD_CONTROL_WDS_FRAME (0x40)
 184 #define RxPD_MESH_FRAME RxPD_CONTROL_WDS_FRAME
 185
 186 /** RSSI-related defines */
 187 /*      RSSI constants are used to implement 802.11 RSSI threshold
 188 *       indication. if the Rx packet signal got too weak for 5 consecutive
 189 *       times, miniport driver (driver) will report this event to wrapper
 190 */
 191
 192 #define MRVDRV_NF_DEFAULT_SCAN_VALUE            (-96)
 193
 194 /** RTS/FRAG related defines */
 195 #define MRVDRV_RTS_MIN_VALUE            0
 196 #define MRVDRV_RTS_MAX_VALUE            2347
 197 #define MRVDRV_FRAG_MIN_VALUE           256
 198 #define MRVDRV_FRAG_MAX_VALUE           2346
 199
 200 /* This is for firmware specific length */
 201 #define EXTRA_LEN       36
 202
 203 #define MRVDRV_ETH_TX_PACKET_BUFFER_SIZE \
 204         (ETH_FRAME_LEN + sizeof(struct txpd) + EXTRA_LEN)
 205
 206 #define MRVDRV_ETH_RX_PACKET_BUFFER_SIZE \
 207         (ETH_FRAME_LEN + sizeof(struct rxpd) \
 208          + MRVDRV_SNAP_HEADER_LEN + EXTRA_LEN)
 209
 210 #define CMD_F_HOSTCMD           (1 << 0)
 211 #define FW_CAPINFO_WPA          (1 << 0)
 212
 213 /** WPA key LENGTH*/
 214 #define MRVL_MAX_KEY_WPA_KEY_LENGTH     32
 215
 216 #define KEY_LEN_WPA_AES                 16
 217 #define KEY_LEN_WPA_TKIP                32
 218 #define KEY_LEN_WEP_104                 13
 219 #define KEY_LEN_WEP_40                  5
 220
 221 #define RF_ANTENNA_1            0x1
 222 #define RF_ANTENNA_2            0x2
 223 #define RF_ANTENNA_AUTO         0xFFFF
 224
 225 #define BAND_B                  (0x01)
 226 #define BAND_G                  (0x02)
 227 #define ALL_802_11_BANDS        (BAND_B | BAND_G)
 228
 229 /** MACRO DEFINITIONS */
 230 #define CAL_NF(NF)                      ((s32)(-(s32)(NF)))
 231 #define CAL_RSSI(SNR, NF)               ((s32)((s32)(SNR) + CAL_NF(NF)))
 232 #define SCAN_RSSI(RSSI)                 (0x100 - ((u8)(RSSI)))
 233
 234 #define DEFAULT_BCN_AVG_FACTOR          8
 235 #define DEFAULT_DATA_AVG_FACTOR         8
 236 #define AVG_SCALE                       100
 237 #define CAL_AVG_SNR_NF(AVG, SNRNF, N)         \
 238                         (((AVG) == 0) ? ((u16)(SNRNF) * AVG_SCALE) : \
 239                         ((((int)(AVG) * (N -1)) + ((u16)(SNRNF) * \
 240                         AVG_SCALE))  / N))
 241
 242 #define B_SUPPORTED_RATES               8
 243 #define G_SUPPORTED_RATES               14
 244
 245 #define WLAN_SUPPORTED_RATES            14
 246
 247 #define MAX_LEDS                        8
 248
 249 #define IS_MESH_FRAME(x) (x->cb[6])
 250 #define SET_MESH_FRAME(x) (x->cb[6]=1)
 251 #define UNSET_MESH_FRAME(x) (x->cb[6]=0)
 252
 253 /** Global Variable Declaration */
 254 typedef struct _wlan_private wlan_private;
 255 typedef struct _wlan_adapter wlan_adapter;
 256 extern const char libertas_driver_version[];
 257 extern u16 libertas_region_code_to_index[MRVDRV_MAX_REGION_CODE];
 258
 259 extern u8 libertas_supported_rates[G_SUPPORTED_RATES];
 260
 261 extern u8 libertas_adhoc_rates_g[G_SUPPORTED_RATES];
 262
 263 extern u8 libertas_adhoc_rates_b[4];
 264
 265 /** ENUM definition*/
 266 /** SNRNF_TYPE */
 267 enum SNRNF_TYPE {
 268         TYPE_BEACON = 0,
 269         TYPE_RXPD,
 270         MAX_TYPE_B
 271 };
 272
 273 /** SNRNF_DATA*/
 274 enum SNRNF_DATA {
 275         TYPE_NOAVG = 0,
 276         TYPE_AVG,
 277         MAX_TYPE_AVG
 278 };
 279
 280 /** WLAN_802_11_POWER_MODE */
 281 enum WLAN_802_11_POWER_MODE {
 282         wlan802_11powermodecam,
 283         wlan802_11powermodemax_psp,
 284         wlan802_11Powermodefast_psp,
 285         /*not a real mode, defined as an upper bound */
 286         wlan802_11powemodemax
 287 };
 288
 289 /** PS_STATE */
 290 enum PS_STATE {
 291         PS_STATE_FULL_POWER,
 292         PS_STATE_AWAKE,
 293         PS_STATE_PRE_SLEEP,
 294         PS_STATE_SLEEP
 295 };
 296
 297 /** DNLD_STATE */
 298 enum DNLD_STATE {
 299         DNLD_RES_RECEIVED,
 300         DNLD_DATA_SENT,
 301         DNLD_CMD_SENT
 302 };
 303
 304 /** WLAN_MEDIA_STATE */
 305 enum WLAN_MEDIA_STATE {
 306         libertas_connected,
 307         libertas_disconnected
 308 };
 309
 310 /** WLAN_802_11_PRIVACY_FILTER */
 311 enum WLAN_802_11_PRIVACY_FILTER {
 312         wlan802_11privfilteracceptall,
 313         wlan802_11privfilter8021xWEP
 314 };
 315
 316 /** mv_ms_type */
 317 enum mv_ms_type {
 318         MVMS_DAT = 0,
 319         MVMS_CMD = 1,
 320         MVMS_TXDONE = 2,
 321         MVMS_EVENT
 322 };
 323
 324 /** SNMP_MIB_INDEX_e */
 325 enum SNMP_MIB_INDEX_e {
 326         desired_bsstype_i = 0,
 327         op_rateset_i,
 328         bcnperiod_i,
 329         dtimperiod_i,
 330         assocrsp_timeout_i,
 331         rtsthresh_i,
 332         short_retrylim_i,
 333         long_retrylim_i,
 334         fragthresh_i,
 335         dot11d_i,
 336         dot11h_i,
 337         manufid_i,
 338         prodID_i,
 339         manuf_oui_i,
 340         manuf_name_i,
 341         manuf_prodname_i,
 342         manuf_prodver_i,
 343 };
 344
 345 /** KEY_TYPE_ID */
 346 enum KEY_TYPE_ID {
 347         KEY_TYPE_ID_WEP = 0,
 348         KEY_TYPE_ID_TKIP,
 349         KEY_TYPE_ID_AES
 350 };
 351
 352 /** KEY_INFO_WPA (applies to both TKIP and AES/CCMP) */
 353 enum KEY_INFO_WPA {
 354         KEY_INFO_WPA_MCAST = 0x01,
 355         KEY_INFO_WPA_UNICAST = 0x02,
 356         KEY_INFO_WPA_ENABLED = 0x04
 357 };
 358
 359 /** SNMP_MIB_VALUE_e */
 360 enum SNMP_MIB_VALUE_e {
 361         SNMP_MIB_VALUE_INFRA = 1,
 362         SNMP_MIB_VALUE_ADHOC
 363 };
 364
 365 /* Default values for fwt commands. */
 366 #define FWT_DEFAULT_METRIC 0
 367 #define FWT_DEFAULT_DIR 1
 368 #define FWT_DEFAULT_SSN 0xffffffff
 369 #define FWT_DEFAULT_DSN 0
 370 #define FWT_DEFAULT_HOPCOUNT 0
 371 #define FWT_DEFAULT_TTL 0
 372 #define FWT_DEFAULT_EXPIRATION 0
 373 #define FWT_DEFAULT_SLEEPMODE 0
 374 #define FWT_DEFAULT_SNR 0
 375
 376 #endif                          /* _WLAN_DEFS_H_ */