drivers/staging/brcm80211/brcmfmac/wl_cfg80211.h

   1 /*
   2  * Copyright (c) 2010 Broadcom Corporation
   3  *
   4  * Permission to use, copy, modify, and/or distribute this software for any
   5  * purpose with or without fee is hereby granted, provided that the above
   6  * copyright notice and this permission notice appear in all copies.
   7  *
   8  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
   9  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
  10  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
  11  * SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  12  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
  13  * OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
  14  * CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  15  */
  16
  17 #ifndef _wl_cfg80211_h_
  18 #define _wl_cfg80211_h_
  19
  20 struct brcmf_cfg80211_conf;
  21 struct brcmf_cfg80211_iface;
  22 struct brcmf_cfg80211_priv;
  23 struct brcmf_cfg80211_security;
  24 struct brcmf_cfg80211_ibss;
  25
  26 #define WL_DBG_NONE             0
  27 #define WL_DBG_CONN             (1 << 5)
  28 #define WL_DBG_SCAN             (1 << 4)
  29 #define WL_DBG_TRACE            (1 << 3)
  30 #define WL_DBG_INFO             (1 << 1)
  31 #define WL_DBG_ERR              (1 << 0)
  32 #define WL_DBG_MASK             ((WL_DBG_INFO | WL_DBG_ERR | WL_DBG_TRACE) | \
  33                                 (WL_DBG_SCAN) | (WL_DBG_CONN))
  34
  35 #define WL_ERR(fmt, args...)                                    \
  36 do {                                                            \
  37         if (brcmf_dbg_level & WL_DBG_ERR) {                     \
  38                 if (net_ratelimit()) {                          \
  39                         printk(KERN_ERR "ERROR @%s : " fmt,     \
  40                                 __func__, ##args);              \
  41                 }                                               \
  42         }                                                       \
  43 } while (0)
  44
  45 #if (defined BCMDBG)
  46 #define WL_INFO(fmt, args...)                                   \
  47 do {                                                            \
  48         if (brcmf_dbg_level & WL_DBG_INFO) {                    \
  49                 if (net_ratelimit()) {                          \
  50                         printk(KERN_ERR "INFO @%s : " fmt,      \
  51                                 __func__, ##args);              \
  52                 }                                               \
  53         }                                                       \
  54 } while (0)
  55
  56 #define WL_TRACE(fmt, args...)                                  \
  57 do {                                                            \
  58         if (brcmf_dbg_level & WL_DBG_TRACE) {                   \
  59                 if (net_ratelimit()) {                          \
  60                         printk(KERN_ERR "TRACE @%s : " fmt,     \
  61                                 __func__, ##args);              \
  62                 }                                               \
  63         }                                                       \
  64 } while (0)
  65
  66 #define WL_SCAN(fmt, args...)                                   \
  67 do {                                                            \
  68         if (brcmf_dbg_level & WL_DBG_SCAN) {                    \
  69                 if (net_ratelimit()) {                          \
  70                         printk(KERN_ERR "SCAN @%s : " fmt,      \
  71                                 __func__, ##args);              \
  72                 }                                               \
  73         }                                                       \
  74 } while (0)
  75
  76 #define WL_CONN(fmt, args...)                                   \
  77 do {                                                            \
  78         if (brcmf_dbg_level & WL_DBG_CONN) {                    \
  79                 if (net_ratelimit()) {                          \
  80                         printk(KERN_ERR "CONN @%s : " fmt,      \
  81                                 __func__, ##args);              \
  82                 }                                               \
  83         }                                                       \
  84 } while (0)
  85
  86 #else /* (defined BCMDBG) */
  87 #define WL_INFO(fmt, args...)
  88 #define WL_TRACE(fmt, args...)
  89 #define WL_SCAN(fmt, args...)
  90 #define WL_CONN(fmt, args...)
  91 #endif /* (defined BCMDBG) */
  92
  93 #define WL_NUM_SCAN_MAX         1
  94 #define WL_NUM_PMKIDS_MAX       MAXPMKID        /* will be used
  95                                                  * for 2.6.33 kernel
  96                                                  * or later
  97                                                  */
  98 #define WL_SCAN_BUF_MAX                 (1024 * 8)
  99 #define WL_TLV_INFO_MAX                 1024
 100 #define WL_BSS_INFO_MAX                 2048
 101 #define WL_ASSOC_INFO_MAX       512     /*
 102                                  * needs to grab assoc info from dongle to
 103                                  * report it to cfg80211 through "connect"
 104                                  * event
 105                                  */
 106 #define WL_IOCTL_LEN_MAX        1024
 107 #define WL_EXTRA_BUF_MAX        2048
 108 #define WL_ISCAN_BUF_MAX        2048    /*
 109                                  * the buf length can be BRCMF_C_IOCTL_MAXLEN
 110                                  * to reduce iteration
 111                                  */
 112 #define WL_ISCAN_TIMER_INTERVAL_MS      3000
 113 #define WL_SCAN_ERSULTS_LAST    (BRCMF_SCAN_RESULTS_NO_MEM+1)
 114 #define WL_AP_MAX       256     /* virtually unlimitted as long
 115                                  * as kernel memory allows
 116                                  */
 117
 118 #define WL_ROAM_TRIGGER_LEVEL           -75
 119 #define WL_ROAM_DELTA                   20
 120 #define WL_BEACON_TIMEOUT               3
 121
 122 #define WL_SCAN_CHANNEL_TIME            40
 123 #define WL_SCAN_UNASSOC_TIME            40
 124 #define WL_SCAN_PASSIVE_TIME            120
 125
 126 /* dongle status */
 127 enum wl_status {
 128         WL_STATUS_READY,
 129         WL_STATUS_SCANNING,
 130         WL_STATUS_SCAN_ABORTING,
 131         WL_STATUS_CONNECTING,
 132         WL_STATUS_CONNECTED
 133 };
 134
 135 /* wi-fi mode */
 136 enum wl_mode {
 137         WL_MODE_BSS,
 138         WL_MODE_IBSS,
 139         WL_MODE_AP
 140 };
 141
 142 /* dongle profile list */
 143 enum wl_prof_list {
 144         WL_PROF_MODE,
 145         WL_PROF_SSID,
 146         WL_PROF_SEC,
 147         WL_PROF_IBSS,
 148         WL_PROF_BAND,
 149         WL_PROF_BSSID,
 150         WL_PROF_ACT,
 151         WL_PROF_BEACONINT,
 152         WL_PROF_DTIMPERIOD
 153 };
 154
 155 /* dongle iscan state */
 156 enum wl_iscan_state {
 157         WL_ISCAN_STATE_IDLE,
 158         WL_ISCAN_STATE_SCANING
 159 };
 160
 161 /* dongle configuration */
 162 struct brcmf_cfg80211_conf {
 163         u32 mode;               /* adhoc , infrastructure or ap */
 164         u32 frag_threshold;
 165         u32 rts_threshold;
 166         u32 retry_short;
 167         u32 retry_long;
 168         s32 tx_power;
 169         struct ieee80211_channel channel;
 170 };
 171
 172 /* cfg80211 main event loop */
 173 struct brcmf_cfg80211_event_loop {
 174         s32(*handler[BRCMF_E_LAST]) (struct brcmf_cfg80211_priv *cfg_priv,
 175                                      struct net_device *ndev,
 176                                      const struct brcmf_event_msg *e,
 177                                      void *data);
 178 };
 179
 180 /* representing interface of cfg80211 plane */
 181 struct brcmf_cfg80211_iface {
 182         struct brcmf_cfg80211_priv *cfg_priv;
 183 };
 184
 185 struct brcmf_cfg80211_dev {
 186         void *driver_data;      /* to store cfg80211 object information */
 187 };
 188
 189 /* basic structure of scan request */
 190 struct brcmf_cfg80211_scan_req {
 191         struct brcmf_ssid ssid;
 192 };
 193
 194 /* basic structure of information element */
 195 struct brcmf_cfg80211_ie {
 196         u16 offset;
 197         u8 buf[WL_TLV_INFO_MAX];
 198 };
 199
 200 /* event queue for cfg80211 main event */
 201 struct brcmf_cfg80211_event_q {
 202         struct list_head eq_list;
 203         u32 etype;
 204         struct brcmf_event_msg emsg;
 205         s8 edata[1];
 206 };
 207
 208 /* security information with currently associated ap */
 209 struct brcmf_cfg80211_security {
 210         u32 wpa_versions;
 211         u32 auth_type;
 212         u32 cipher_pairwise;
 213         u32 cipher_group;
 214         u32 wpa_auth;
 215 };
 216
 217 /* ibss information for currently joined ibss network */
 218 struct brcmf_cfg80211_ibss {
 219         u8 beacon_interval;     /* in millisecond */
 220         u8 atim;                /* in millisecond */
 221         s8 join_only;
 222         u8 band;
 223         u8 channel;
 224 };
 225
 226 /* dongle profile */
 227 struct brcmf_cfg80211_profile {
 228         u32 mode;
 229         struct brcmf_ssid ssid;
 230         u8 bssid[ETH_ALEN];
 231         u16 beacon_interval;
 232         u8 dtim_period;
 233         struct brcmf_cfg80211_security sec;
 234         struct brcmf_cfg80211_ibss ibss;
 235         s32 band;
 236 };
 237
 238 /* dongle iscan event loop */
 239 struct brcmf_cfg80211_iscan_eloop {
 240         s32 (*handler[WL_SCAN_ERSULTS_LAST])
 241                 (struct brcmf_cfg80211_priv *cfg_priv);
 242 };
 243
 244 /* dongle iscan controller */
 245 struct brcmf_cfg80211_iscan_ctrl {
 246         struct net_device *dev;
 247         struct timer_list timer;
 248         u32 timer_ms;
 249         u32 timer_on;
 250         s32 state;
 251         struct task_struct *tsk;
 252         struct semaphore sync;
 253         struct brcmf_cfg80211_iscan_eloop el;
 254         void *data;
 255         s8 ioctl_buf[BRCMF_C_IOCTL_SMLEN];
 256         s8 scan_buf[WL_ISCAN_BUF_MAX];
 257 };
 258
 259 /* association inform */
 260 struct brcmf_cfg80211_connect_info {
 261         u8 *req_ie;
 262         s32 req_ie_len;
 263         u8 *resp_ie;
 264         s32 resp_ie_len;
 265 };
 266
 267 /* assoc ie length */
 268 struct brcmf_cfg80211_assoc_ielen {
 269         u32 req_len;
 270         u32 resp_len;
 271 };
 272
 273 /* wpa2 pmk list */
 274 struct brcmf_cfg80211_pmk_list {
 275         pmkid_list_t pmkids;
 276         pmkid_t foo[MAXPMKID - 1];
 277 };
 278
 279 /* dongle private data of cfg80211 interface */
 280 struct brcmf_cfg80211_priv {
 281         struct wireless_dev *wdev;      /* representing wl cfg80211 device */
 282         struct brcmf_cfg80211_conf *conf;       /* dongle configuration */
 283         struct cfg80211_scan_request *scan_request;     /* scan request
 284                                                          object */
 285         struct brcmf_cfg80211_event_loop el;    /* main event loop */
 286         struct list_head eq_list;       /* used for event queue */
 287         spinlock_t eq_lock;     /* for event queue synchronization */
 288         struct mutex usr_sync;  /* maily for dongle up/down synchronization */
 289         struct brcmf_scan_results *bss_list;    /* bss_list holding scanned
 290                                                  ap information */
 291         struct brcmf_scan_results *scan_results;
 292         struct brcmf_cfg80211_scan_req *scan_req_int;   /* scan request object
 293                                                  for internal purpose */
 294         struct wl_cfg80211_bss_info *bss_info;  /* bss information for
 295                                                  cfg80211 layer */
 296         struct brcmf_cfg80211_ie ie;    /* information element object for
 297                                          internal purpose */
 298         struct semaphore event_sync;    /* for synchronization of main event
 299                                          thread */
 300         struct brcmf_cfg80211_profile *profile; /* holding dongle profile */
 301         struct brcmf_cfg80211_iscan_ctrl *iscan;        /* iscan controller */
 302         struct brcmf_cfg80211_connect_info conn_info; /* association info */
 303         struct brcmf_cfg80211_pmk_list *pmk_list;       /* wpa2 pmk list */
 304         struct task_struct *event_tsk;  /* task of main event handler thread */
 305         unsigned long status;           /* current dongle status */
 306         void *pub;
 307         u32 channel;            /* current channel */
 308         bool iscan_on;          /* iscan on/off switch */
 309         bool iscan_kickstart;   /* indicate iscan already started */
 310         bool active_scan;       /* current scan mode */
 311         bool ibss_starter;      /* indicates this sta is ibss starter */
 312         bool link_up;           /* link/connection up flag */
 313         bool pwr_save;          /* indicate whether dongle to support
 314                                          power save mode */
 315         bool dongle_up;         /* indicate whether dongle up or not */
 316         bool roam_on;           /* on/off switch for dongle self-roaming */
 317         bool scan_tried;        /* indicates if first scan attempted */
 318         u8 *ioctl_buf;  /* ioctl buffer */
 319         u8 *extra_buf;  /* maily to grab assoc information */
 320         struct dentry *debugfsdir;
 321         u8 ci[0] __attribute__ ((__aligned__(NETDEV_ALIGN)));
 322 };
 323
 324 #define cfg_to_wiphy(w) (w->wdev->wiphy)
 325 #define wiphy_to_cfg(w) ((struct brcmf_cfg80211_priv *)(wiphy_priv(w)))
 326 #define cfg_to_wdev(w) (w->wdev)
 327 #define wdev_to_cfg(w) ((struct brcmf_cfg80211_priv *)(wdev_priv(w)))
 328 #define cfg_to_ndev(w) (w->wdev->netdev)
 329 #define ndev_to_cfg(n) (wdev_to_cfg(n->ieee80211_ptr))
 330 #define iscan_to_cfg(i) ((struct brcmf_cfg80211_priv *)(i->data))
 331 #define cfg_to_iscan(w) (w->iscan)
 332 #define cfg_to_conn(w) (&w->conn_info)
 333
 334 static inline struct brcmf_bss_info *next_bss(struct brcmf_scan_results *list,
 335                                            struct brcmf_bss_info *bss)
 336 {
 337         return bss = bss ?
 338                 (struct brcmf_bss_info *)((unsigned long)bss +
 339                                        le32_to_cpu(bss->length)) :
 340                 list->bss_info;
 341 }
 342
 343 #define for_each_bss(list, bss, __i)    \
 344         for (__i = 0; __i < list->count && __i < WL_AP_MAX; __i++, bss = next_bss(list, bss))
 345
 346 extern s32 brcmf_cfg80211_attach(struct net_device *ndev, void *data);
 347 extern void brcmf_cfg80211_detach(void);
 348 /* event handler from dongle */
 349 extern void brcmf_cfg80211_event(struct net_device *ndev,
 350                                  const struct brcmf_event_msg *e, void *data);
 351 extern void brcmf_cfg80211_sdio_func(void *func); /* set sdio function info */
 352 extern struct sdio_func *brcmf_cfg80211_get_sdio_func(void);
 353 extern s32 brcmf_cfg80211_up(void);     /* dongle up */
 354 extern s32 brcmf_cfg80211_down(void);   /* dongle down */
 355
 356 #endif                          /* _wl_cfg80211_h_ */