err.no Git - linux-2.6/blob - drivers/net/wireless/libertas/scan.h

   1 /**
   2   * Interface for the wlan network scan routines
   3   *
   4   * Driver interface functions and type declarations for the scan module
   5   * implemented in scan.c.
   6   */
   7 #ifndef _LBS_SCAN_H
   8 #define _LBS_SCAN_H
   9
  10 #include <net/ieee80211.h>
  11 #include "hostcmd.h"
  12
  13 struct lbs_adapter;
  14
  15 /**
  16  *  @brief Maximum number of channels that can be sent in a setuserscan ioctl
  17  *
  18  *  @sa lbs_ioctl_user_scan_cfg
  19  */
  20 #define LBS_IOCTL_USER_SCAN_CHAN_MAX  50
  21
  22 //! Infrastructure BSS scan type in lbs_scan_cmd_config
  23 #define LBS_SCAN_BSS_TYPE_BSS         1
  24
  25 //! Adhoc BSS scan type in lbs_scan_cmd_config
  26 #define LBS_SCAN_BSS_TYPE_IBSS        2
  27
  28 //! Adhoc or Infrastructure BSS scan type in lbs_scan_cmd_config, no filter
  29 #define LBS_SCAN_BSS_TYPE_ANY         3
  30
  31 /**
  32  * @brief Structure used internally in the wlan driver to configure a scan.
  33  *
  34  * Sent to the command processing module to configure the firmware
  35  *   scan command prepared by lbs_cmd_80211_scan.
  36  *
  37  * @sa lbs_scan_networks
  38  *
  39  */
  40 struct lbs_scan_cmd_config {
  41     /**
  42      *  @brief BSS type to be sent in the firmware command
  43      *
  44      *  Field can be used to restrict the types of networks returned in the
  45      *    scan.  valid settings are:
  46      *
  47      *   - LBS_SCAN_BSS_TYPE_BSS  (infrastructure)
  48      *   - LBS_SCAN_BSS_TYPE_IBSS (adhoc)
  49      *   - LBS_SCAN_BSS_TYPE_ANY  (unrestricted, adhoc and infrastructure)
  50      */
  51         u8 bsstype;
  52
  53     /**
  54      *  @brief Specific BSSID used to filter scan results in the firmware
  55      */
  56         u8 bssid[ETH_ALEN];
  57
  58     /**
  59      *  @brief length of TLVs sent in command starting at tlvBuffer
  60      */
  61         int tlvbufferlen;
  62
  63     /**
  64      *  @brief SSID TLV(s) and ChanList TLVs to be sent in the firmware command
  65      *
  66      *  @sa TLV_TYPE_CHANLIST, mrvlietypes_chanlistparamset_t
  67      *  @sa TLV_TYPE_SSID, mrvlietypes_ssidparamset_t
  68      */
  69         u8 tlvbuffer[1];        //!< SSID TLV(s) and ChanList TLVs are stored here
  70 };
  71
  72 /**
  73  *  @brief IOCTL channel sub-structure sent in lbs_ioctl_user_scan_cfg
  74  *
  75  *  Multiple instances of this structure are included in the IOCTL command
  76  *   to configure a instance of a scan on the specific channel.
  77  */
  78 struct lbs_ioctl_user_scan_chan {
  79         u8 channumber;          //!< channel Number to scan
  80         u8 radiotype;           //!< Radio type: 'B/G' band = 0, 'A' band = 1
  81         u8 scantype;            //!< Scan type: Active = 0, Passive = 1
  82         u16 scantime;           //!< Scan duration in milliseconds; if 0 default used
  83 };
  84
  85 /**
  86  *  @brief IOCTL input structure to configure an immediate scan cmd to firmware
  87  *
  88  *  Used in the setuserscan (LBS_SET_USER_SCAN) private ioctl.  Specifies
  89  *   a number of parameters to be used in general for the scan as well
  90  *   as a channel list (lbs_ioctl_user_scan_chan) for each scan period
  91  *   desired.
  92  *
  93  *  @sa lbs_set_user_scan_ioctl
  94  */
  95 struct lbs_ioctl_user_scan_cfg {
  96     /**
  97      *  @brief BSS type to be sent in the firmware command
  98      *
  99      *  Field can be used to restrict the types of networks returned in the
 100      *    scan.  valid settings are:
 101      *
 102      *   - LBS_SCAN_BSS_TYPE_BSS  (infrastructure)
 103      *   - LBS_SCAN_BSS_TYPE_IBSS (adhoc)
 104      *   - LBS_SCAN_BSS_TYPE_ANY  (unrestricted, adhoc and infrastructure)
 105      */
 106         u8 bsstype;
 107
 108         /**
 109          *  @brief BSSID filter sent in the firmware command to limit the results
 110          */
 111         u8 bssid[ETH_ALEN];
 112
 113         /* Clear existing scan results matching this BSSID */
 114         u8 clear_bssid;
 115
 116         /**
 117          *  @brief SSID filter sent in the firmware command to limit the results
 118          */
 119         char ssid[IW_ESSID_MAX_SIZE];
 120         u8 ssid_len;
 121
 122         /* Clear existing scan results matching this SSID */
 123         u8 clear_ssid;
 124 };
 125
 126 /**
 127  *  @brief Structure used to store information for each beacon/probe response
 128  */
 129 struct bss_descriptor {
 130         u8 bssid[ETH_ALEN];
 131
 132         u8 ssid[IW_ESSID_MAX_SIZE + 1];
 133         u8 ssid_len;
 134
 135         u16 capability;
 136
 137         /* receive signal strength in dBm */
 138         long rssi;
 139
 140         u32 channel;
 141
 142         u16 beaconperiod;
 143
 144         u32 atimwindow;
 145
 146         /* IW_MODE_AUTO, IW_MODE_ADHOC, IW_MODE_INFRA */
 147         u8 mode;
 148
 149         /* zero-terminated array of supported data rates */
 150         u8 rates[MAX_RATES + 1];
 151
 152         unsigned long last_scanned;
 153
 154         union ieeetypes_phyparamset phyparamset;
 155         union IEEEtypes_ssparamset ssparamset;
 156
 157         struct ieeetypes_countryinfofullset countryinfo;
 158
 159         u8 wpa_ie[MAX_WPA_IE_LEN];
 160         size_t wpa_ie_len;
 161         u8 rsn_ie[MAX_WPA_IE_LEN];
 162         size_t rsn_ie_len;
 163
 164         u8 mesh;
 165
 166         struct list_head list;
 167 };
 168
 169 int lbs_ssid_cmp(u8 *ssid1, u8 ssid1_len, u8 *ssid2, u8 ssid2_len);
 170
 171 struct bss_descriptor *lbs_find_ssid_in_list(struct lbs_adapter *adapter,
 172                 u8 *ssid, u8 ssid_len, u8 *bssid, u8 mode,
 173                 int channel);
 174
 175 struct bss_descriptor *lbs_find_bssid_in_list(struct lbs_adapter *adapter,
 176         u8 *bssid, u8 mode);
 177
 178 int lbs_find_best_network_ssid(struct lbs_private *priv, u8 *out_ssid,
 179                         u8 *out_ssid_len, u8 preferred_mode, u8 *out_mode);
 180
 181 int lbs_send_specific_ssid_scan(struct lbs_private *priv, u8 *ssid,
 182                                 u8 ssid_len, u8 clear_ssid);
 183
 184 int lbs_cmd_80211_scan(struct lbs_private *priv,
 185                                 struct cmd_ds_command *cmd,
 186                                 void *pdata_buf);
 187
 188 int lbs_ret_80211_scan(struct lbs_private *priv,
 189                                 struct cmd_ds_command *resp);
 190
 191 int lbs_scan_networks(struct lbs_private *priv,
 192         const struct lbs_ioctl_user_scan_cfg *puserscanin,
 193                 int full_scan);
 194
 195 struct ifreq;
 196
 197 struct iw_point;
 198 struct iw_param;
 199 struct iw_request_info;
 200 int lbs_get_scan(struct net_device *dev, struct iw_request_info *info,
 201                          struct iw_point *dwrq, char *extra);
 202 int lbs_set_scan(struct net_device *dev, struct iw_request_info *info,
 203                          struct iw_param *vwrq, char *extra);
 204
 205 void lbs_scan_worker(struct work_struct *work);
 206
 207 #endif