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