[PATCH] libertas: fixed transmission flow control on the mesh interface
[safe/jmp/linux-2.6] / drivers / net / wireless / libertas / scan.c
1 /**
2   * Functions implementing wlan scan IOCTL and firmware command APIs
3   *
4   * IOCTL handlers as well as command preperation and response routines
5   *  for sending scan commands to the firmware.
6   */
7 #include <linux/ctype.h>
8 #include <linux/if.h>
9 #include <linux/netdevice.h>
10 #include <linux/wireless.h>
11
12 #include <net/ieee80211.h>
13 #include <net/iw_handler.h>
14
15 #include "host.h"
16 #include "decl.h"
17 #include "dev.h"
18 #include "scan.h"
19
20 //! Approximate amount of data needed to pass a scan result back to iwlist
21 #define MAX_SCAN_CELL_SIZE  (IW_EV_ADDR_LEN             \
22                              + IW_ESSID_MAX_SIZE        \
23                              + IW_EV_UINT_LEN           \
24                              + IW_EV_FREQ_LEN           \
25                              + IW_EV_QUAL_LEN           \
26                              + IW_ESSID_MAX_SIZE        \
27                              + IW_EV_PARAM_LEN          \
28                              + 40)      /* 40 for WPAIE */
29
30 //! Memory needed to store a max sized channel List TLV for a firmware scan
31 #define CHAN_TLV_MAX_SIZE  (sizeof(struct mrvlietypesheader)    \
32                             + (MRVDRV_MAX_CHANNELS_PER_SCAN     \
33                                * sizeof(struct chanscanparamset)))
34
35 //! Memory needed to store a max number/size SSID TLV for a firmware scan
36 #define SSID_TLV_MAX_SIZE  (1 * sizeof(struct mrvlietypes_ssidparamset))
37
38 //! Maximum memory needed for a wlan_scan_cmd_config with all TLVs at max
39 #define MAX_SCAN_CFG_ALLOC (sizeof(struct wlan_scan_cmd_config)  \
40                             + sizeof(struct mrvlietypes_numprobes)   \
41                             + CHAN_TLV_MAX_SIZE                 \
42                             + SSID_TLV_MAX_SIZE)
43
44 //! The maximum number of channels the firmware can scan per command
45 #define MRVDRV_MAX_CHANNELS_PER_SCAN   14
46
47 /**
48  * @brief Number of channels to scan per firmware scan command issuance.
49  *
50  *  Number restricted to prevent hitting the limit on the amount of scan data
51  *  returned in a single firmware scan command.
52  */
53 #define MRVDRV_CHANNELS_PER_SCAN_CMD   4
54
55 //! Scan time specified in the channel TLV for each channel for passive scans
56 #define MRVDRV_PASSIVE_SCAN_CHAN_TIME  100
57
58 //! Scan time specified in the channel TLV for each channel for active scans
59 #define MRVDRV_ACTIVE_SCAN_CHAN_TIME   100
60
61 //! Macro to enable/disable SSID checking before storing a scan table
62 #ifdef DISCARD_BAD_SSID
63 #define CHECK_SSID_IS_VALID(x) ssid_valid(&bssidEntry.ssid)
64 #else
65 #define CHECK_SSID_IS_VALID(x) 1
66 #endif
67
68 /**
69  *  @brief Check if a scanned network compatible with the driver settings
70  *
71  *   WEP     WPA     WPA2    ad-hoc  encrypt                      Network
72  * enabled enabled  enabled   AES     mode   privacy  WPA  WPA2  Compatible
73  *    0       0        0       0      NONE      0      0    0   yes No security
74  *    1       0        0       0      NONE      1      0    0   yes Static WEP
75  *    0       1        0       0       x        1x     1    x   yes WPA
76  *    0       0        1       0       x        1x     x    1   yes WPA2
77  *    0       0        0       1      NONE      1      0    0   yes Ad-hoc AES
78  *    0       0        0       0     !=NONE     1      0    0   yes Dynamic WEP
79  *
80  *
81  *  @param adapter A pointer to wlan_adapter
82  *  @param index   Index in scantable to check against current driver settings
83  *  @param mode    Network mode: Infrastructure or IBSS
84  *
85  *  @return        Index in scantable, or error code if negative
86  */
87 static int is_network_compatible(wlan_adapter * adapter, int index, u8 mode)
88 {
89         lbs_deb_enter(LBS_DEB_ASSOC);
90
91         if (adapter->scantable[index].mode == mode) {
92                 if (   !adapter->secinfo.wep_enabled
93                     && !adapter->secinfo.WPAenabled
94                     && !adapter->secinfo.WPA2enabled
95                     && adapter->scantable[index].wpa_ie[0] != WPA_IE
96                     && adapter->scantable[index].rsn_ie[0] != WPA2_IE
97                     && !adapter->scantable[index].privacy) {
98                         /* no security */
99                         goto done;
100                 } else if (   adapter->secinfo.wep_enabled
101                            && !adapter->secinfo.WPAenabled
102                            && !adapter->secinfo.WPA2enabled
103                            && adapter->scantable[index].privacy) {
104                         /* static WEP enabled */
105                         goto done;
106                 } else if (   !adapter->secinfo.wep_enabled
107                            && adapter->secinfo.WPAenabled
108                            && !adapter->secinfo.WPA2enabled
109                            && (adapter->scantable[index].wpa_ie[0] == WPA_IE)
110                            /* privacy bit may NOT be set in some APs like LinkSys WRT54G
111                               && adapter->scantable[index].privacy */
112                     ) {
113                         /* WPA enabled */
114             lbs_deb_scan(
115                                "is_network_compatible() WPA: index=%d wpa_ie=%#x "
116                                "wpa2_ie=%#x WEP=%s WPA=%s WPA2=%s "
117                                "privacy=%#x\n", index,
118                                adapter->scantable[index].wpa_ie[0],
119                                adapter->scantable[index].rsn_ie[0],
120                                adapter->secinfo.wep_enabled ? "e" : "d",
121                                adapter->secinfo.WPAenabled ? "e" : "d",
122                                adapter->secinfo.WPA2enabled ? "e" : "d",
123                                adapter->scantable[index].privacy);
124                         goto done;
125                 } else if (   !adapter->secinfo.wep_enabled
126                            && !adapter->secinfo.WPAenabled
127                            && adapter->secinfo.WPA2enabled
128                            && (adapter->scantable[index].rsn_ie[0] == WPA2_IE)
129                            /* privacy bit may NOT be set in some APs like LinkSys WRT54G
130                               && adapter->scantable[index].privacy */
131                     ) {
132                         /* WPA2 enabled */
133             lbs_deb_scan(
134                                "is_network_compatible() WPA2: index=%d wpa_ie=%#x "
135                                "wpa2_ie=%#x WEP=%s WPA=%s WPA2=%s "
136                                "privacy=%#x\n", index,
137                                adapter->scantable[index].wpa_ie[0],
138                                adapter->scantable[index].rsn_ie[0],
139                                adapter->secinfo.wep_enabled ? "e" : "d",
140                                adapter->secinfo.WPAenabled ? "e" : "d",
141                                adapter->secinfo.WPA2enabled ? "e" : "d",
142                                adapter->scantable[index].privacy);
143                         goto done;
144                 } else if (   !adapter->secinfo.wep_enabled
145                            && !adapter->secinfo.WPAenabled
146                            && !adapter->secinfo.WPA2enabled
147                            && (adapter->scantable[index].wpa_ie[0] != WPA_IE)
148                            && (adapter->scantable[index].rsn_ie[0] != WPA2_IE)
149                            && adapter->scantable[index].privacy) {
150                         /* dynamic WEP enabled */
151             lbs_deb_scan(
152                                "is_network_compatible() dynamic WEP: index=%d "
153                                "wpa_ie=%#x wpa2_ie=%#x privacy=%#x\n",
154                                index,
155                                adapter->scantable[index].wpa_ie[0],
156                                adapter->scantable[index].rsn_ie[0],
157                                adapter->scantable[index].privacy);
158                         goto done;
159                 }
160
161                 /* security doesn't match */
162         lbs_deb_scan(
163                        "is_network_compatible() FAILED: index=%d wpa_ie=%#x "
164                        "wpa2_ie=%#x WEP=%s WPA=%s WPA2=%s privacy=%#x\n",
165                        index,
166                        adapter->scantable[index].wpa_ie[0],
167                        adapter->scantable[index].rsn_ie[0],
168                        adapter->secinfo.wep_enabled ? "e" : "d",
169                        adapter->secinfo.WPAenabled ? "e" : "d",
170                        adapter->secinfo.WPA2enabled ? "e" : "d",
171                        adapter->scantable[index].privacy);
172                 index = -ECONNREFUSED;
173                 goto done;
174         }
175
176         /* mode doesn't match */
177         index = -ENETUNREACH;
178
179 done:
180         lbs_deb_leave_args(LBS_DEB_SCAN, "index %d", index);
181         return index;
182 }
183
184 /**
185  *  @brief This function validates a SSID as being able to be printed
186  *
187  *  @param pssid   SSID structure to validate
188  *
189  *  @return        TRUE or FALSE
190  */
191 static u8 ssid_valid(struct WLAN_802_11_SSID *pssid)
192 {
193         int ssididx;
194
195         for (ssididx = 0; ssididx < pssid->ssidlength; ssididx++) {
196                 if (!isprint(pssid->ssid[ssididx])) {
197                         return 0;
198                 }
199         }
200
201         return 1;
202 }
203
204 /**
205  *  @brief Post process the scan table after a new scan command has completed
206  *
207  *  Inspect each entry of the scan table and try to find an entry that
208  *    matches our current associated/joined network from the scan.  If
209  *    one is found, update the stored copy of the bssdescriptor for our
210  *    current network.
211  *
212  *  Debug dump the current scan table contents if compiled accordingly.
213  *
214  *  @param priv   A pointer to wlan_private structure
215  *
216  *  @return       void
217  */
218 static void wlan_scan_process_results(wlan_private * priv)
219 {
220         wlan_adapter *adapter = priv->adapter;
221         int foundcurrent;
222         int i;
223
224         foundcurrent = 0;
225
226         if (adapter->connect_status == libertas_connected) {
227                 /* try to find the current BSSID in the new scan list */
228                 for (i = 0; i < adapter->numinscantable; i++) {
229                         if (!libertas_SSID_cmp(&adapter->scantable[i].ssid,
230                                      &adapter->curbssparams.ssid) &&
231                             !memcmp(adapter->curbssparams.bssid,
232                                     adapter->scantable[i].macaddress,
233                                     ETH_ALEN)) {
234                                 foundcurrent = 1;
235                         }
236                 }
237
238                 if (foundcurrent) {
239                         /* Make a copy of current BSSID descriptor */
240                         memcpy(&adapter->curbssparams.bssdescriptor,
241                                &adapter->scantable[i],
242                                sizeof(adapter->curbssparams.bssdescriptor));
243                 }
244         }
245
246         for (i = 0; i < adapter->numinscantable; i++) {
247                 lbs_deb_scan("Scan:(%02d) %02x:%02x:%02x:%02x:%02x:%02x, "
248                        "RSSI[%03d], SSID[%s]\n",
249                        i,
250                        adapter->scantable[i].macaddress[0],
251                        adapter->scantable[i].macaddress[1],
252                        adapter->scantable[i].macaddress[2],
253                        adapter->scantable[i].macaddress[3],
254                        adapter->scantable[i].macaddress[4],
255                        adapter->scantable[i].macaddress[5],
256                        (s32) adapter->scantable[i].rssi,
257                        adapter->scantable[i].ssid.ssid);
258         }
259 }
260
261 /**
262  *  @brief Create a channel list for the driver to scan based on region info
263  *
264  *  Use the driver region/band information to construct a comprehensive list
265  *    of channels to scan.  This routine is used for any scan that is not
266  *    provided a specific channel list to scan.
267  *
268  *  @param priv          A pointer to wlan_private structure
269  *  @param scanchanlist  Output parameter: resulting channel list to scan
270  *  @param filteredscan  Flag indicating whether or not a BSSID or SSID filter
271  *                       is being sent in the command to firmware.  Used to
272  *                       increase the number of channels sent in a scan
273  *                       command and to disable the firmware channel scan
274  *                       filter.
275  *
276  *  @return              void
277  */
278 static void wlan_scan_create_channel_list(wlan_private * priv,
279                                           struct chanscanparamset * scanchanlist,
280                                           u8 filteredscan)
281 {
282
283         wlan_adapter *adapter = priv->adapter;
284         struct region_channel *scanregion;
285         struct chan_freq_power *cfp;
286         int rgnidx;
287         int chanidx;
288         int nextchan;
289         u8 scantype;
290
291         chanidx = 0;
292
293         /* Set the default scan type to the user specified type, will later
294          *   be changed to passive on a per channel basis if restricted by
295          *   regulatory requirements (11d or 11h)
296          */
297         scantype = adapter->scantype;
298
299         for (rgnidx = 0; rgnidx < ARRAY_SIZE(adapter->region_channel); rgnidx++) {
300                 if (priv->adapter->enable11d &&
301                     adapter->connect_status != libertas_connected) {
302                         /* Scan all the supported chan for the first scan */
303                         if (!adapter->universal_channel[rgnidx].valid)
304                                 continue;
305                         scanregion = &adapter->universal_channel[rgnidx];
306
307                         /* clear the parsed_region_chan for the first scan */
308                         memset(&adapter->parsed_region_chan, 0x00,
309                                sizeof(adapter->parsed_region_chan));
310                 } else {
311                         if (!adapter->region_channel[rgnidx].valid)
312                                 continue;
313                         scanregion = &adapter->region_channel[rgnidx];
314                 }
315
316                 for (nextchan = 0;
317                      nextchan < scanregion->nrcfp; nextchan++, chanidx++) {
318
319                         cfp = scanregion->CFP + nextchan;
320
321                         if (priv->adapter->enable11d) {
322                                 scantype =
323                                     libertas_get_scan_type_11d(cfp->channel,
324                                                            &adapter->
325                                                            parsed_region_chan);
326                         }
327
328                         switch (scanregion->band) {
329                         case BAND_B:
330                         case BAND_G:
331                         default:
332                                 scanchanlist[chanidx].radiotype =
333                                     cmd_scan_radio_type_bg;
334                                 break;
335                         }
336
337                         if (scantype == cmd_scan_type_passive) {
338                                 scanchanlist[chanidx].maxscantime =
339                                     cpu_to_le16
340                                     (MRVDRV_PASSIVE_SCAN_CHAN_TIME);
341                                 scanchanlist[chanidx].chanscanmode.passivescan =
342                                     1;
343                         } else {
344                                 scanchanlist[chanidx].maxscantime =
345                                     cpu_to_le16
346                                     (MRVDRV_ACTIVE_SCAN_CHAN_TIME);
347                                 scanchanlist[chanidx].chanscanmode.passivescan =
348                                     0;
349                         }
350
351                         scanchanlist[chanidx].channumber = cfp->channel;
352
353                         if (filteredscan) {
354                                 scanchanlist[chanidx].chanscanmode.
355                                     disablechanfilt = 1;
356                         }
357                 }
358         }
359 }
360
361 /**
362  *  @brief Construct a wlan_scan_cmd_config structure to use in issue scan cmds
363  *
364  *  Application layer or other functions can invoke wlan_scan_networks
365  *    with a scan configuration supplied in a wlan_ioctl_user_scan_cfg struct.
366  *    This structure is used as the basis of one or many wlan_scan_cmd_config
367  *    commands that are sent to the command processing module and sent to
368  *    firmware.
369  *
370  *  Create a wlan_scan_cmd_config based on the following user supplied
371  *    parameters (if present):
372  *             - SSID filter
373  *             - BSSID filter
374  *             - Number of Probes to be sent
375  *             - channel list
376  *
377  *  If the SSID or BSSID filter is not present, disable/clear the filter.
378  *  If the number of probes is not set, use the adapter default setting
379  *  Qualify the channel
380  *
381  *  @param priv             A pointer to wlan_private structure
382  *  @param puserscanin      NULL or pointer to scan configuration parameters
383  *  @param ppchantlvout     Output parameter: Pointer to the start of the
384  *                          channel TLV portion of the output scan config
385  *  @param pscanchanlist    Output parameter: Pointer to the resulting channel
386  *                          list to scan
387  *  @param pmaxchanperscan  Output parameter: Number of channels to scan for
388  *                          each issuance of the firmware scan command
389  *  @param pfilteredscan    Output parameter: Flag indicating whether or not
390  *                          a BSSID or SSID filter is being sent in the
391  *                          command to firmware.  Used to increase the number
392  *                          of channels sent in a scan command and to
393  *                          disable the firmware channel scan filter.
394  *  @param pscancurrentonly Output parameter: Flag indicating whether or not
395  *                          we are only scanning our current active channel
396  *
397  *  @return                 resulting scan configuration
398  */
399 static struct wlan_scan_cmd_config *
400 wlan_scan_setup_scan_config(wlan_private * priv,
401                             const struct wlan_ioctl_user_scan_cfg * puserscanin,
402                             struct mrvlietypes_chanlistparamset ** ppchantlvout,
403                             struct chanscanparamset * pscanchanlist,
404                             int *pmaxchanperscan,
405                             u8 * pfilteredscan,
406                             u8 * pscancurrentonly)
407 {
408         wlan_adapter *adapter = priv->adapter;
409         const u8 zeromac[ETH_ALEN] = { 0, 0, 0, 0, 0, 0 };
410         struct mrvlietypes_numprobes *pnumprobestlv;
411         struct mrvlietypes_ssidparamset *pssidtlv;
412         struct wlan_scan_cmd_config * pscancfgout = NULL;
413         u8 *ptlvpos;
414         u16 numprobes;
415         u16 ssidlen;
416         int chanidx;
417         int scantype;
418         int scandur;
419         int channel;
420         int radiotype;
421
422         pscancfgout = kzalloc(MAX_SCAN_CFG_ALLOC, GFP_KERNEL);
423         if (pscancfgout == NULL)
424                 goto out;
425
426         /* The tlvbufferlen is calculated for each scan command.  The TLVs added
427          *   in this routine will be preserved since the routine that sends
428          *   the command will append channelTLVs at *ppchantlvout.  The difference
429          *   between the *ppchantlvout and the tlvbuffer start will be used
430          *   to calculate the size of anything we add in this routine.
431          */
432         pscancfgout->tlvbufferlen = 0;
433
434         /* Running tlv pointer.  Assigned to ppchantlvout at end of function
435          *  so later routines know where channels can be added to the command buf
436          */
437         ptlvpos = pscancfgout->tlvbuffer;
438
439         /*
440          * Set the initial scan paramters for progressive scanning.  If a specific
441          *   BSSID or SSID is used, the number of channels in the scan command
442          *   will be increased to the absolute maximum
443          */
444         *pmaxchanperscan = MRVDRV_CHANNELS_PER_SCAN_CMD;
445
446         /* Initialize the scan as un-filtered by firmware, set to TRUE below if
447          *   a SSID or BSSID filter is sent in the command
448          */
449         *pfilteredscan = 0;
450
451         /* Initialize the scan as not being only on the current channel.  If
452          *   the channel list is customized, only contains one channel, and
453          *   is the active channel, this is set true and data flow is not halted.
454          */
455         *pscancurrentonly = 0;
456
457         if (puserscanin) {
458
459                 /* Set the bss type scan filter, use adapter setting if unset */
460                 pscancfgout->bsstype =
461                     (puserscanin->bsstype ? puserscanin->bsstype : adapter->
462                      scanmode);
463
464                 /* Set the number of probes to send, use adapter setting if unset */
465                 numprobes = (puserscanin->numprobes ? puserscanin->numprobes :
466                              adapter->scanprobes);
467
468                 /*
469                  * Set the BSSID filter to the incoming configuration,
470                  *   if non-zero.  If not set, it will remain disabled (all zeros).
471                  */
472                 memcpy(pscancfgout->specificBSSID,
473                        puserscanin->specificBSSID,
474                        sizeof(pscancfgout->specificBSSID));
475
476                 ssidlen = strlen(puserscanin->specificSSID);
477
478                 if (ssidlen) {
479                         pssidtlv =
480                             (struct mrvlietypes_ssidparamset *) pscancfgout->
481                             tlvbuffer;
482                         pssidtlv->header.type = cpu_to_le16(TLV_TYPE_SSID);
483                         pssidtlv->header.len = cpu_to_le16(ssidlen);
484                         memcpy(pssidtlv->ssid, puserscanin->specificSSID,
485                                ssidlen);
486                         ptlvpos += sizeof(pssidtlv->header) + ssidlen;
487                 }
488
489                 /*
490                  *  The default number of channels sent in the command is low to
491                  *    ensure the response buffer from the firmware does not truncate
492                  *    scan results.  That is not an issue with an SSID or BSSID
493                  *    filter applied to the scan results in the firmware.
494                  */
495                 if (ssidlen || (memcmp(pscancfgout->specificBSSID,
496                                        &zeromac, sizeof(zeromac)) != 0)) {
497                         *pmaxchanperscan = MRVDRV_MAX_CHANNELS_PER_SCAN;
498                         *pfilteredscan = 1;
499                 }
500         } else {
501                 pscancfgout->bsstype = adapter->scanmode;
502                 numprobes = adapter->scanprobes;
503         }
504
505         /* If the input config or adapter has the number of Probes set, add tlv */
506         if (numprobes) {
507                 pnumprobestlv = (struct mrvlietypes_numprobes *) ptlvpos;
508                 pnumprobestlv->header.type =
509                     cpu_to_le16(TLV_TYPE_NUMPROBES);
510                 pnumprobestlv->header.len = sizeof(pnumprobestlv->numprobes);
511                 pnumprobestlv->numprobes = cpu_to_le16(numprobes);
512
513                 ptlvpos +=
514                     sizeof(pnumprobestlv->header) + pnumprobestlv->header.len;
515
516                 pnumprobestlv->header.len =
517                     cpu_to_le16(pnumprobestlv->header.len);
518         }
519
520         /*
521          * Set the output for the channel TLV to the address in the tlv buffer
522          *   past any TLVs that were added in this fuction (SSID, numprobes).
523          *   channel TLVs will be added past this for each scan command, preserving
524          *   the TLVs that were previously added.
525          */
526         *ppchantlvout = (struct mrvlietypes_chanlistparamset *) ptlvpos;
527
528         if (puserscanin && puserscanin->chanlist[0].channumber) {
529
530                 lbs_deb_scan("Scan: Using supplied channel list\n");
531
532                 for (chanidx = 0;
533                      chanidx < WLAN_IOCTL_USER_SCAN_CHAN_MAX
534                      && puserscanin->chanlist[chanidx].channumber; chanidx++) {
535
536                         channel = puserscanin->chanlist[chanidx].channumber;
537                         (pscanchanlist + chanidx)->channumber = channel;
538
539                         radiotype = puserscanin->chanlist[chanidx].radiotype;
540                         (pscanchanlist + chanidx)->radiotype = radiotype;
541
542                         scantype = puserscanin->chanlist[chanidx].scantype;
543
544                         if (scantype == cmd_scan_type_passive) {
545                                 (pscanchanlist +
546                                  chanidx)->chanscanmode.passivescan = 1;
547                         } else {
548                                 (pscanchanlist +
549                                  chanidx)->chanscanmode.passivescan = 0;
550                         }
551
552                         if (puserscanin->chanlist[chanidx].scantime) {
553                                 scandur =
554                                     puserscanin->chanlist[chanidx].scantime;
555                         } else {
556                                 if (scantype == cmd_scan_type_passive) {
557                                         scandur = MRVDRV_PASSIVE_SCAN_CHAN_TIME;
558                                 } else {
559                                         scandur = MRVDRV_ACTIVE_SCAN_CHAN_TIME;
560                                 }
561                         }
562
563                         (pscanchanlist + chanidx)->minscantime =
564                             cpu_to_le16(scandur);
565                         (pscanchanlist + chanidx)->maxscantime =
566                             cpu_to_le16(scandur);
567                 }
568
569                 /* Check if we are only scanning the current channel */
570                 if ((chanidx == 1) && (puserscanin->chanlist[0].channumber
571                                        ==
572                                        priv->adapter->curbssparams.channel)) {
573                         *pscancurrentonly = 1;
574                         lbs_deb_scan("Scan: Scanning current channel only");
575                 }
576
577         } else {
578                 lbs_deb_scan("Scan: Creating full region channel list\n");
579                 wlan_scan_create_channel_list(priv, pscanchanlist,
580                                               *pfilteredscan);
581         }
582
583 out:
584         return pscancfgout;
585 }
586
587 /**
588  *  @brief Construct and send multiple scan config commands to the firmware
589  *
590  *  Previous routines have created a wlan_scan_cmd_config with any requested
591  *   TLVs.  This function splits the channel TLV into maxchanperscan lists
592  *   and sends the portion of the channel TLV along with the other TLVs
593  *   to the wlan_cmd routines for execution in the firmware.
594  *
595  *  @param priv            A pointer to wlan_private structure
596  *  @param maxchanperscan  Maximum number channels to be included in each
597  *                         scan command sent to firmware
598  *  @param filteredscan    Flag indicating whether or not a BSSID or SSID
599  *                         filter is being used for the firmware command
600  *                         scan command sent to firmware
601  *  @param pscancfgout     Scan configuration used for this scan.
602  *  @param pchantlvout     Pointer in the pscancfgout where the channel TLV
603  *                         should start.  This is past any other TLVs that
604  *                         must be sent down in each firmware command.
605  *  @param pscanchanlist   List of channels to scan in maxchanperscan segments
606  *
607  *  @return                0 or error return otherwise
608  */
609 static int wlan_scan_channel_list(wlan_private * priv,
610                                   int maxchanperscan,
611                                   u8 filteredscan,
612                                   struct wlan_scan_cmd_config * pscancfgout,
613                                   struct mrvlietypes_chanlistparamset * pchantlvout,
614                                   struct chanscanparamset * pscanchanlist,
615                                   const struct wlan_ioctl_user_scan_cfg * puserscanin,
616                                   int full_scan)
617 {
618         struct chanscanparamset *ptmpchan;
619         struct chanscanparamset *pstartchan;
620         u8 scanband;
621         int doneearly;
622         int tlvidx;
623         int ret = 0;
624         int scanned = 0;
625         union iwreq_data wrqu;
626
627         lbs_deb_enter(LBS_DEB_ASSOC);
628
629         if (pscancfgout == 0 || pchantlvout == 0 || pscanchanlist == 0) {
630                 lbs_deb_scan("Scan: Null detect: %p, %p, %p\n",
631                        pscancfgout, pchantlvout, pscanchanlist);
632                 return -1;
633         }
634
635         pchantlvout->header.type = cpu_to_le16(TLV_TYPE_CHANLIST);
636
637         /* Set the temp channel struct pointer to the start of the desired list */
638         ptmpchan = pscanchanlist;
639
640         if (priv->adapter->last_scanned_channel && !puserscanin)
641                 ptmpchan += priv->adapter->last_scanned_channel;
642
643         /* Loop through the desired channel list, sending a new firmware scan
644          *   commands for each maxchanperscan channels (or for 1,6,11 individually
645          *   if configured accordingly)
646          */
647         while (ptmpchan->channumber) {
648
649                 tlvidx = 0;
650                 pchantlvout->header.len = 0;
651                 scanband = ptmpchan->radiotype;
652                 pstartchan = ptmpchan;
653                 doneearly = 0;
654
655                 /* Construct the channel TLV for the scan command.  Continue to
656                  *  insert channel TLVs until:
657                  *    - the tlvidx hits the maximum configured per scan command
658                  *    - the next channel to insert is 0 (end of desired channel list)
659                  *    - doneearly is set (controlling individual scanning of 1,6,11)
660                  */
661                 while (tlvidx < maxchanperscan && ptmpchan->channumber
662                        && !doneearly && scanned < 2) {
663
664             lbs_deb_scan(
665                     "Scan: Chan(%3d), Radio(%d), mode(%d,%d), Dur(%d)\n",
666                 ptmpchan->channumber, ptmpchan->radiotype,
667                 ptmpchan->chanscanmode.passivescan,
668                 ptmpchan->chanscanmode.disablechanfilt,
669                 ptmpchan->maxscantime);
670
671                         /* Copy the current channel TLV to the command being prepared */
672                         memcpy(pchantlvout->chanscanparam + tlvidx,
673                                ptmpchan, sizeof(pchantlvout->chanscanparam));
674
675                         /* Increment the TLV header length by the size appended */
676                         pchantlvout->header.len +=
677                             sizeof(pchantlvout->chanscanparam);
678
679                         /*
680                          *  The tlv buffer length is set to the number of bytes of the
681                          *    between the channel tlv pointer and the start of the
682                          *    tlv buffer.  This compensates for any TLVs that were appended
683                          *    before the channel list.
684                          */
685                         pscancfgout->tlvbufferlen = ((u8 *) pchantlvout
686                                                      - pscancfgout->tlvbuffer);
687
688                         /*  Add the size of the channel tlv header and the data length */
689                         pscancfgout->tlvbufferlen +=
690                             (sizeof(pchantlvout->header)
691                              + pchantlvout->header.len);
692
693                         /* Increment the index to the channel tlv we are constructing */
694                         tlvidx++;
695
696                         doneearly = 0;
697
698                         /* Stop the loop if the *current* channel is in the 1,6,11 set
699                          *   and we are not filtering on a BSSID or SSID.
700                          */
701                         if (!filteredscan && (ptmpchan->channumber == 1
702                                               || ptmpchan->channumber == 6
703                                               || ptmpchan->channumber == 11)) {
704                                 doneearly = 1;
705                         }
706
707                         /* Increment the tmp pointer to the next channel to be scanned */
708                         ptmpchan++;
709                         scanned++;
710
711                         /* Stop the loop if the *next* channel is in the 1,6,11 set.
712                          *  This will cause it to be the only channel scanned on the next
713                          *  interation
714                          */
715                         if (!filteredscan && (ptmpchan->channumber == 1
716                                               || ptmpchan->channumber == 6
717                                               || ptmpchan->channumber == 11)) {
718                                 doneearly = 1;
719                         }
720                 }
721
722                 /* Send the scan command to the firmware with the specified cfg */
723                 ret = libertas_prepare_and_send_command(priv, cmd_802_11_scan, 0,
724                                             0, 0, pscancfgout);
725                 if (scanned >= 2 && !full_scan) {
726                         priv->adapter->last_scanned_channel = ptmpchan->channumber;
727                         ret = 0;
728                         goto done;
729                 }
730                 scanned = 0;
731         }
732
733         priv->adapter->last_scanned_channel = ptmpchan->channumber;
734
735         memset(&wrqu, 0, sizeof(union iwreq_data));
736         wireless_send_event(priv->wlan_dev.netdev, SIOCGIWSCAN, &wrqu, NULL);
737
738 done:
739         lbs_deb_leave_args(LBS_DEB_SCAN, "ret %d", ret);
740         return ret;
741 }
742
743 /**
744  *  @brief Internal function used to start a scan based on an input config
745  *
746  *  Use the input user scan configuration information when provided in
747  *    order to send the appropriate scan commands to firmware to populate or
748  *    update the internal driver scan table
749  *
750  *  @param priv          A pointer to wlan_private structure
751  *  @param puserscanin   Pointer to the input configuration for the requested
752  *                       scan.
753  *
754  *  @return              0 or < 0 if error
755  */
756 int wlan_scan_networks(wlan_private * priv,
757                               const struct wlan_ioctl_user_scan_cfg * puserscanin,
758                               int full_scan)
759 {
760         wlan_adapter *adapter = priv->adapter;
761         struct mrvlietypes_chanlistparamset *pchantlvout;
762         struct chanscanparamset * scan_chan_list = NULL;
763         struct wlan_scan_cmd_config * scan_cfg = NULL;
764         u8 keeppreviousscan;
765         u8 filteredscan;
766         u8 scancurrentchanonly;
767         int maxchanperscan;
768         int ret;
769
770         lbs_deb_enter(LBS_DEB_ASSOC);
771
772         scan_chan_list = kzalloc(sizeof(struct chanscanparamset) *
773                                 WLAN_IOCTL_USER_SCAN_CHAN_MAX, GFP_KERNEL);
774         if (scan_chan_list == NULL) {
775                 ret = -ENOMEM;
776                 goto out;
777         }
778
779         scan_cfg = wlan_scan_setup_scan_config(priv,
780                                                puserscanin,
781                                                &pchantlvout,
782                                                scan_chan_list,
783                                                &maxchanperscan,
784                                                &filteredscan,
785                                                &scancurrentchanonly);
786         if (scan_cfg == NULL) {
787                 ret = -ENOMEM;
788                 goto out;
789         }
790
791         keeppreviousscan = 0;
792
793         if (puserscanin) {
794                 keeppreviousscan = puserscanin->keeppreviousscan;
795         }
796
797         if (adapter->last_scanned_channel)
798                 keeppreviousscan = 1;
799
800         if (!keeppreviousscan) {
801                 memset(adapter->scantable, 0x00,
802                        sizeof(struct bss_descriptor) * MRVDRV_MAX_BSSID_LIST);
803                 adapter->numinscantable = 0;
804         }
805
806         /* Keep the data path active if we are only scanning our current channel */
807         if (!scancurrentchanonly) {
808                 netif_stop_queue(priv->wlan_dev.netdev);
809                 netif_carrier_off(priv->wlan_dev.netdev);
810                 netif_stop_queue(priv->mesh_dev);
811                 netif_carrier_off(priv->mesh_dev);
812         }
813
814         ret = wlan_scan_channel_list(priv,
815                                      maxchanperscan,
816                                      filteredscan,
817                                      scan_cfg,
818                                      pchantlvout,
819                                      scan_chan_list,
820                                      puserscanin,
821                                      full_scan);
822
823         /*  Process the resulting scan table:
824          *    - Remove any bad ssids
825          *    - Update our current BSS information from scan data
826          */
827         wlan_scan_process_results(priv);
828
829         if (priv->adapter->connect_status == libertas_connected) {
830                 netif_carrier_on(priv->mesh_dev);
831                 netif_wake_queue(priv->mesh_dev);
832         }
833
834 out:
835         if (scan_cfg)
836                 kfree(scan_cfg);
837
838         if (scan_chan_list)
839                 kfree(scan_chan_list);
840
841         lbs_deb_leave_args(LBS_DEB_SCAN, "ret %d", ret);
842         return ret;
843 }
844
845 /**
846  *  @brief Inspect the scan response buffer for pointers to expected TLVs
847  *
848  *  TLVs can be included at the end of the scan response BSS information.
849  *    Parse the data in the buffer for pointers to TLVs that can potentially
850  *    be passed back in the response
851  *
852  *  @param ptlv        Pointer to the start of the TLV buffer to parse
853  *  @param tlvbufsize  size of the TLV buffer
854  *  @param ptsftlv     Output parameter: Pointer to the TSF TLV if found
855  *
856  *  @return            void
857  */
858 static
859 void wlan_ret_802_11_scan_get_tlv_ptrs(struct mrvlietypes_data * ptlv,
860                                        int tlvbufsize,
861                                        struct mrvlietypes_tsftimestamp ** ptsftlv)
862 {
863         struct mrvlietypes_data *pcurrenttlv;
864         int tlvbufleft;
865         u16 tlvtype;
866         u16 tlvlen;
867
868         pcurrenttlv = ptlv;
869         tlvbufleft = tlvbufsize;
870         *ptsftlv = NULL;
871
872         lbs_deb_scan("SCAN_RESP: tlvbufsize = %d\n", tlvbufsize);
873         lbs_dbg_hex("SCAN_RESP: TLV Buf", (u8 *) ptlv, tlvbufsize);
874
875         while (tlvbufleft >= sizeof(struct mrvlietypesheader)) {
876                 tlvtype = le16_to_cpu(pcurrenttlv->header.type);
877                 tlvlen = le16_to_cpu(pcurrenttlv->header.len);
878
879                 switch (tlvtype) {
880                 case TLV_TYPE_TSFTIMESTAMP:
881                         *ptsftlv = (struct mrvlietypes_tsftimestamp *) pcurrenttlv;
882                         break;
883
884                 default:
885                         lbs_deb_scan("SCAN_RESP: Unhandled TLV = %d\n",
886                                tlvtype);
887                         /* Give up, this seems corrupted */
888                         return;
889                 }               /* switch */
890
891                 tlvbufleft -= (sizeof(ptlv->header) + tlvlen);
892                 pcurrenttlv =
893                     (struct mrvlietypes_data *) (pcurrenttlv->Data + tlvlen);
894         }                       /* while */
895 }
896
897 /**
898  *  @brief Interpret a BSS scan response returned from the firmware
899  *
900  *  Parse the various fixed fields and IEs passed back for a a BSS probe
901  *   response or beacon from the scan command.  Record information as needed
902  *   in the scan table struct bss_descriptor for that entry.
903  *
904  *  @param pBSSIDEntry  Output parameter: Pointer to the BSS Entry
905  *
906  *  @return             0 or -1
907  */
908 static int InterpretBSSDescriptionWithIE(struct bss_descriptor * pBSSEntry,
909                                          u8 ** pbeaconinfo, int *bytesleft)
910 {
911         enum ieeetypes_elementid elemID;
912         struct ieeetypes_fhparamset *pFH;
913         struct ieeetypes_dsparamset *pDS;
914         struct ieeetypes_cfparamset *pCF;
915         struct ieeetypes_ibssparamset *pibss;
916         struct ieeetypes_capinfo *pcap;
917         struct WLAN_802_11_FIXED_IEs fixedie;
918         u8 *pcurrentptr;
919         u8 *pRate;
920         u8 elemlen;
921         u8 bytestocopy;
922         u8 ratesize;
923         u16 beaconsize;
924         u8 founddatarateie;
925         int bytesleftforcurrentbeacon;
926         int ret;
927
928         struct IE_WPA *pIe;
929         const u8 oui01[4] = { 0x00, 0x50, 0xf2, 0x01 };
930
931         struct ieeetypes_countryinfoset *pcountryinfo;
932
933         lbs_deb_enter(LBS_DEB_ASSOC);
934
935         founddatarateie = 0;
936         ratesize = 0;
937         beaconsize = 0;
938
939         if (*bytesleft >= sizeof(beaconsize)) {
940                 /* Extract & convert beacon size from the command buffer */
941                 memcpy(&beaconsize, *pbeaconinfo, sizeof(beaconsize));
942                 beaconsize = le16_to_cpu(beaconsize);
943                 *bytesleft -= sizeof(beaconsize);
944                 *pbeaconinfo += sizeof(beaconsize);
945         }
946
947         if (beaconsize == 0 || beaconsize > *bytesleft) {
948
949                 *pbeaconinfo += *bytesleft;
950                 *bytesleft = 0;
951
952                 return -1;
953         }
954
955         /* Initialize the current working beacon pointer for this BSS iteration */
956         pcurrentptr = *pbeaconinfo;
957
958         /* Advance the return beacon pointer past the current beacon */
959         *pbeaconinfo += beaconsize;
960         *bytesleft -= beaconsize;
961
962         bytesleftforcurrentbeacon = beaconsize;
963
964         memcpy(pBSSEntry->macaddress, pcurrentptr, ETH_ALEN);
965         lbs_deb_scan("InterpretIE: AP MAC Addr-%x:%x:%x:%x:%x:%x\n",
966                pBSSEntry->macaddress[0], pBSSEntry->macaddress[1],
967                pBSSEntry->macaddress[2], pBSSEntry->macaddress[3],
968                pBSSEntry->macaddress[4], pBSSEntry->macaddress[5]);
969
970         pcurrentptr += ETH_ALEN;
971         bytesleftforcurrentbeacon -= ETH_ALEN;
972
973         if (bytesleftforcurrentbeacon < 12) {
974                 lbs_deb_scan("InterpretIE: Not enough bytes left\n");
975                 return -1;
976         }
977
978         /*
979          * next 4 fields are RSSI, time stamp, beacon interval,
980          *   and capability information
981          */
982
983         /* RSSI is 1 byte long */
984         pBSSEntry->rssi = le32_to_cpu((long)(*pcurrentptr));
985         lbs_deb_scan("InterpretIE: RSSI=%02X\n", *pcurrentptr);
986         pcurrentptr += 1;
987         bytesleftforcurrentbeacon -= 1;
988
989         /* time stamp is 8 bytes long */
990         memcpy(fixedie.timestamp, pcurrentptr, 8);
991         memcpy(pBSSEntry->timestamp, pcurrentptr, 8);
992         pcurrentptr += 8;
993         bytesleftforcurrentbeacon -= 8;
994
995         /* beacon interval is 2 bytes long */
996         memcpy(&fixedie.beaconinterval, pcurrentptr, 2);
997         pBSSEntry->beaconperiod = le16_to_cpu(fixedie.beaconinterval);
998         pcurrentptr += 2;
999         bytesleftforcurrentbeacon -= 2;
1000
1001         /* capability information is 2 bytes long */
1002         memcpy(&fixedie.capabilities, pcurrentptr, 2);
1003         lbs_deb_scan("InterpretIE: fixedie.capabilities=0x%X\n",
1004                fixedie.capabilities);
1005         fixedie.capabilities = le16_to_cpu(fixedie.capabilities);
1006         pcap = (struct ieeetypes_capinfo *) & fixedie.capabilities;
1007         memcpy(&pBSSEntry->cap, pcap, sizeof(struct ieeetypes_capinfo));
1008         pcurrentptr += 2;
1009         bytesleftforcurrentbeacon -= 2;
1010
1011         /* rest of the current buffer are IE's */
1012         lbs_deb_scan("InterpretIE: IElength for this AP = %d\n",
1013                bytesleftforcurrentbeacon);
1014
1015         lbs_dbg_hex("InterpretIE: IE info", (u8 *) pcurrentptr,
1016                 bytesleftforcurrentbeacon);
1017
1018         if (pcap->privacy) {
1019                 lbs_deb_scan("InterpretIE: AP WEP enabled\n");
1020                 pBSSEntry->privacy = wlan802_11privfilter8021xWEP;
1021         } else {
1022                 pBSSEntry->privacy = wlan802_11privfilteracceptall;
1023         }
1024
1025         if (pcap->ibss == 1) {
1026                 pBSSEntry->mode = IW_MODE_ADHOC;
1027         } else {
1028                 pBSSEntry->mode = IW_MODE_INFRA;
1029         }
1030
1031         /* process variable IE */
1032         while (bytesleftforcurrentbeacon >= 2) {
1033                 elemID = (enum ieeetypes_elementid) (*((u8 *) pcurrentptr));
1034                 elemlen = *((u8 *) pcurrentptr + 1);
1035
1036                 if (bytesleftforcurrentbeacon < elemlen) {
1037                         lbs_deb_scan("InterpretIE: error in processing IE, "
1038                                "bytes left < IE length\n");
1039                         bytesleftforcurrentbeacon = 0;
1040                         continue;
1041                 }
1042
1043                 switch (elemID) {
1044
1045                 case SSID:
1046                         pBSSEntry->ssid.ssidlength = elemlen;
1047                         memcpy(pBSSEntry->ssid.ssid, (pcurrentptr + 2),
1048                                elemlen);
1049                         lbs_deb_scan("ssid '%s'\n", pBSSEntry->ssid.ssid);
1050                         break;
1051
1052                 case SUPPORTED_RATES:
1053                         memcpy(pBSSEntry->datarates, (pcurrentptr + 2),
1054                                elemlen);
1055                         memmove(pBSSEntry->libertas_supported_rates, (pcurrentptr + 2),
1056                                 elemlen);
1057                         ratesize = elemlen;
1058                         founddatarateie = 1;
1059                         break;
1060
1061                 case EXTRA_IE:
1062                         lbs_deb_scan("InterpretIE: EXTRA_IE Found!\n");
1063                         pBSSEntry->extra_ie = 1;
1064                         break;
1065
1066                 case FH_PARAM_SET:
1067                         pFH = (struct ieeetypes_fhparamset *) pcurrentptr;
1068                         memmove(&pBSSEntry->phyparamset.fhparamset, pFH,
1069                                 sizeof(struct ieeetypes_fhparamset));
1070                         pBSSEntry->phyparamset.fhparamset.dwelltime
1071                             =
1072                             le16_to_cpu(pBSSEntry->phyparamset.fhparamset.
1073                                              dwelltime);
1074                         break;
1075
1076                 case DS_PARAM_SET:
1077                         pDS = (struct ieeetypes_dsparamset *) pcurrentptr;
1078
1079                         pBSSEntry->channel = pDS->currentchan;
1080
1081                         memcpy(&pBSSEntry->phyparamset.dsparamset, pDS,
1082                                sizeof(struct ieeetypes_dsparamset));
1083                         break;
1084
1085                 case CF_PARAM_SET:
1086                         pCF = (struct ieeetypes_cfparamset *) pcurrentptr;
1087
1088                         memcpy(&pBSSEntry->ssparamset.cfparamset, pCF,
1089                                sizeof(struct ieeetypes_cfparamset));
1090                         break;
1091
1092                 case IBSS_PARAM_SET:
1093                         pibss = (struct ieeetypes_ibssparamset *) pcurrentptr;
1094                         pBSSEntry->atimwindow =
1095                             le32_to_cpu(pibss->atimwindow);
1096
1097                         memmove(&pBSSEntry->ssparamset.ibssparamset, pibss,
1098                                 sizeof(struct ieeetypes_ibssparamset));
1099
1100                         pBSSEntry->ssparamset.ibssparamset.atimwindow
1101                             =
1102                             le16_to_cpu(pBSSEntry->ssparamset.ibssparamset.
1103                                              atimwindow);
1104                         break;
1105
1106                         /* Handle Country Info IE */
1107                 case COUNTRY_INFO:
1108                         pcountryinfo =
1109                             (struct ieeetypes_countryinfoset *) pcurrentptr;
1110
1111                         if (pcountryinfo->len <
1112                             sizeof(pcountryinfo->countrycode)
1113                             || pcountryinfo->len > 254) {
1114                                 lbs_deb_scan("InterpretIE: 11D- Err "
1115                                        "CountryInfo len =%d min=%zd max=254\n",
1116                                        pcountryinfo->len,
1117                                        sizeof(pcountryinfo->countrycode));
1118                                 ret = -1;
1119                                 goto done;
1120                         }
1121
1122                         memcpy(&pBSSEntry->countryinfo,
1123                                pcountryinfo, pcountryinfo->len + 2);
1124                         lbs_dbg_hex("InterpretIE: 11D- CountryInfo:",
1125                                 (u8 *) pcountryinfo,
1126                                 (u32) (pcountryinfo->len + 2));
1127                         break;
1128
1129                 case EXTENDED_SUPPORTED_RATES:
1130                         /*
1131                          * only process extended supported rate
1132                          * if data rate is already found.
1133                          * data rate IE should come before
1134                          * extended supported rate IE
1135                          */
1136                         if (founddatarateie) {
1137                                 if ((elemlen + ratesize) > WLAN_SUPPORTED_RATES) {
1138                                         bytestocopy =
1139                                             (WLAN_SUPPORTED_RATES - ratesize);
1140                                 } else {
1141                                         bytestocopy = elemlen;
1142                                 }
1143
1144                                 pRate = (u8 *) pBSSEntry->datarates;
1145                                 pRate += ratesize;
1146                                 memmove(pRate, (pcurrentptr + 2), bytestocopy);
1147
1148                                 pRate = (u8 *) pBSSEntry->libertas_supported_rates;
1149
1150                                 pRate += ratesize;
1151                                 memmove(pRate, (pcurrentptr + 2), bytestocopy);
1152                         }
1153                         break;
1154
1155                 case VENDOR_SPECIFIC_221:
1156 #define IE_ID_LEN_FIELDS_BYTES 2
1157                         pIe = (struct IE_WPA *)pcurrentptr;
1158
1159                         if (memcmp(pIe->oui, oui01, sizeof(oui01)))
1160                                 break;
1161
1162                         pBSSEntry->wpa_ie_len = min_t(size_t,
1163                                 elemlen + IE_ID_LEN_FIELDS_BYTES,
1164                                 sizeof(pBSSEntry->wpa_ie));
1165                         memcpy(pBSSEntry->wpa_ie, pcurrentptr,
1166                                 pBSSEntry->wpa_ie_len);
1167                         lbs_dbg_hex("InterpretIE: Resp WPA_IE",
1168                                 pBSSEntry->wpa_ie, elemlen);
1169                         break;
1170                 case WPA2_IE:
1171                         pIe = (struct IE_WPA *)pcurrentptr;
1172
1173                         pBSSEntry->rsn_ie_len = min_t(size_t,
1174                                 elemlen + IE_ID_LEN_FIELDS_BYTES,
1175                                 sizeof(pBSSEntry->rsn_ie));
1176                         memcpy(pBSSEntry->rsn_ie, pcurrentptr,
1177                                 pBSSEntry->rsn_ie_len);
1178                         lbs_dbg_hex("InterpretIE: Resp WPA2_IE",
1179                                 pBSSEntry->rsn_ie, elemlen);
1180                         break;
1181                 case TIM:
1182                         break;
1183
1184                 case CHALLENGE_TEXT:
1185                         break;
1186                 }
1187
1188                 pcurrentptr += elemlen + 2;
1189
1190                 /* need to account for IE ID and IE len */
1191                 bytesleftforcurrentbeacon -= (elemlen + 2);
1192
1193         }                       /* while (bytesleftforcurrentbeacon > 2) */
1194         ret = 0;
1195
1196 done:
1197         lbs_deb_leave_args(LBS_DEB_SCAN, "ret %d", ret);
1198         return ret;
1199 }
1200
1201 /**
1202  *  @brief Compare two SSIDs
1203  *
1204  *  @param ssid1    A pointer to ssid to compare
1205  *  @param ssid2    A pointer to ssid to compare
1206  *
1207  *  @return         0--ssid is same, otherwise is different
1208  */
1209 int libertas_SSID_cmp(struct WLAN_802_11_SSID *ssid1, struct WLAN_802_11_SSID *ssid2)
1210 {
1211         if (!ssid1 || !ssid2)
1212                 return -1;
1213
1214         if (ssid1->ssidlength != ssid2->ssidlength)
1215                 return -1;
1216
1217         return memcmp(ssid1->ssid, ssid2->ssid, ssid1->ssidlength);
1218 }
1219
1220 /**
1221  *  @brief This function finds a specific compatible BSSID in the scan list
1222  *
1223  *  @param adapter  A pointer to wlan_adapter
1224  *  @param bssid    BSSID to find in the scan list
1225  *  @param mode     Network mode: Infrastructure or IBSS
1226  *
1227  *  @return         index in BSSID list, or error return code (< 0)
1228  */
1229 int libertas_find_BSSID_in_list(wlan_adapter * adapter, u8 * bssid, u8 mode)
1230 {
1231         int ret = -ENETUNREACH;
1232         int i;
1233
1234         if (!bssid)
1235                 return -EFAULT;
1236
1237         lbs_deb_scan("FindBSSID: Num of BSSIDs = %d\n",
1238                adapter->numinscantable);
1239
1240         /* Look through the scan table for a compatible match. The ret return
1241          *   variable will be equal to the index in the scan table (greater
1242          *   than zero) if the network is compatible.  The loop will continue
1243          *   past a matched bssid that is not compatible in case there is an
1244          *   AP with multiple SSIDs assigned to the same BSSID
1245          */
1246         for (i = 0; ret < 0 && i < adapter->numinscantable; i++) {
1247                 if (!memcmp(adapter->scantable[i].macaddress, bssid, ETH_ALEN)) {
1248                         switch (mode) {
1249                         case IW_MODE_INFRA:
1250                         case IW_MODE_ADHOC:
1251                                 ret = is_network_compatible(adapter, i, mode);
1252                                 break;
1253                         default:
1254                                 ret = i;
1255                                 break;
1256                         }
1257                 }
1258         }
1259
1260         return ret;
1261 }
1262
1263 /**
1264  *  @brief This function finds ssid in ssid list.
1265  *
1266  *  @param adapter  A pointer to wlan_adapter
1267  *  @param ssid     SSID to find in the list
1268  *  @param bssid    BSSID to qualify the SSID selection (if provided)
1269  *  @param mode     Network mode: Infrastructure or IBSS
1270  *
1271  *  @return         index in BSSID list
1272  */
1273 int libertas_find_SSID_in_list(wlan_adapter * adapter,
1274                    struct WLAN_802_11_SSID *ssid, u8 * bssid, u8 mode)
1275 {
1276         int net = -ENETUNREACH;
1277         u8 bestrssi = 0;
1278         int i;
1279         int j;
1280
1281         lbs_deb_scan("Num of Entries in Table = %d\n", adapter->numinscantable);
1282
1283         for (i = 0; i < adapter->numinscantable; i++) {
1284                 if (!libertas_SSID_cmp(&adapter->scantable[i].ssid, ssid) &&
1285                     (!bssid ||
1286                      !memcmp(adapter->scantable[i].
1287                              macaddress, bssid, ETH_ALEN))) {
1288                         switch (mode) {
1289                         case IW_MODE_INFRA:
1290                         case IW_MODE_ADHOC:
1291                                 j = is_network_compatible(adapter, i, mode);
1292
1293                                 if (j >= 0) {
1294                                         if (bssid) {
1295                                                 return i;
1296                                         }
1297
1298                                         if (SCAN_RSSI
1299                                             (adapter->scantable[i].rssi)
1300                                             > bestrssi) {
1301                                                 bestrssi =
1302                                                     SCAN_RSSI(adapter->
1303                                                               scantable[i].
1304                                                               rssi);
1305                                                 net = i;
1306                                         }
1307                                 } else {
1308                                         if (net == -ENETUNREACH) {
1309                                                 net = j;
1310                                         }
1311                                 }
1312                                 break;
1313                         case IW_MODE_AUTO:
1314                         default:
1315                                 if (SCAN_RSSI(adapter->scantable[i].rssi)
1316                                     > bestrssi) {
1317                                         bestrssi =
1318                                             SCAN_RSSI(adapter->scantable[i].
1319                                                       rssi);
1320                                         net = i;
1321                                 }
1322                                 break;
1323                         }
1324                 }
1325         }
1326
1327         return net;
1328 }
1329
1330 /**
1331  *  @brief This function finds the best SSID in the Scan List
1332  *
1333  *  Search the scan table for the best SSID that also matches the current
1334  *   adapter network preference (infrastructure or adhoc)
1335  *
1336  *  @param adapter  A pointer to wlan_adapter
1337  *
1338  *  @return         index in BSSID list
1339  */
1340 int libertas_find_best_SSID_in_list(wlan_adapter * adapter, u8 mode)
1341 {
1342         int bestnet = -ENETUNREACH;
1343         u8 bestrssi = 0;
1344         int i;
1345
1346         lbs_deb_enter(LBS_DEB_ASSOC);
1347
1348         lbs_deb_scan("Num of BSSIDs = %d\n", adapter->numinscantable);
1349
1350         for (i = 0; i < adapter->numinscantable; i++) {
1351                 switch (mode) {
1352                 case IW_MODE_INFRA:
1353                 case IW_MODE_ADHOC:
1354                         if (is_network_compatible(adapter, i, mode) >= 0) {
1355                                 if (SCAN_RSSI(adapter->scantable[i].rssi) >
1356                                     bestrssi) {
1357                                         bestrssi =
1358                                             SCAN_RSSI(adapter->scantable[i].
1359                                                       rssi);
1360                                         bestnet = i;
1361                                 }
1362                         }
1363                         break;
1364                 case IW_MODE_AUTO:
1365                 default:
1366                         if (SCAN_RSSI(adapter->scantable[i].rssi) > bestrssi) {
1367                                 bestrssi =
1368                                     SCAN_RSSI(adapter->scantable[i].rssi);
1369                                 bestnet = i;
1370                         }
1371                         break;
1372                 }
1373         }
1374
1375         lbs_deb_leave_args(LBS_DEB_SCAN, "bestnet %d", bestnet);
1376         return bestnet;
1377 }
1378
1379 /**
1380  *  @brief Find the AP with specific ssid in the scan list
1381  *
1382  *  @param priv         A pointer to wlan_private structure
1383  *  @param pSSID        A pointer to AP's ssid
1384  *
1385  *  @return             0--success, otherwise--fail
1386  */
1387 int libertas_find_best_network_SSID(wlan_private * priv,
1388                                     struct WLAN_802_11_SSID *pSSID,
1389                                     u8 preferred_mode, u8 *out_mode)
1390 {
1391         wlan_adapter *adapter = priv->adapter;
1392         int ret = 0;
1393         struct bss_descriptor *preqbssid;
1394         int i;
1395
1396         lbs_deb_enter(LBS_DEB_ASSOC);
1397
1398         memset(pSSID, 0, sizeof(struct WLAN_802_11_SSID));
1399
1400         wlan_scan_networks(priv, NULL, 1);
1401         if (adapter->surpriseremoved)
1402                 return -1;
1403         wait_event_interruptible(adapter->cmd_pending, !adapter->nr_cmd_pending);
1404
1405         i = libertas_find_best_SSID_in_list(adapter, preferred_mode);
1406         if (i < 0) {
1407                 ret = -1;
1408                 goto out;
1409         }
1410
1411         preqbssid = &adapter->scantable[i];
1412         memcpy(pSSID, &preqbssid->ssid,
1413                sizeof(struct WLAN_802_11_SSID));
1414         *out_mode = preqbssid->mode;
1415
1416         if (!pSSID->ssidlength) {
1417                 ret = -1;
1418         }
1419
1420 out:
1421         lbs_deb_leave_args(LBS_DEB_SCAN, "ret %d", ret);
1422         return ret;
1423 }
1424
1425 /**
1426  *  @brief Scan Network
1427  *
1428  *  @param dev          A pointer to net_device structure
1429  *  @param info         A pointer to iw_request_info structure
1430  *  @param vwrq         A pointer to iw_param structure
1431  *  @param extra        A pointer to extra data buf
1432  *
1433  *  @return             0 --success, otherwise fail
1434  */
1435 int libertas_set_scan(struct net_device *dev, struct iw_request_info *info,
1436                   struct iw_param *vwrq, char *extra)
1437 {
1438         wlan_private *priv = dev->priv;
1439         wlan_adapter *adapter = priv->adapter;
1440
1441         lbs_deb_enter(LBS_DEB_SCAN);
1442
1443         wlan_scan_networks(priv, NULL, 0);
1444
1445         if (adapter->surpriseremoved)
1446                 return -1;
1447
1448         lbs_deb_leave(LBS_DEB_SCAN);
1449         return 0;
1450 }
1451
1452 /**
1453  *  @brief Send a scan command for all available channels filtered on a spec
1454  *
1455  *  @param priv             A pointer to wlan_private structure
1456  *  @param prequestedssid   A pointer to AP's ssid
1457  *  @param keeppreviousscan Flag used to save/clear scan table before scan
1458  *
1459  *  @return                0-success, otherwise fail
1460  */
1461 int libertas_send_specific_SSID_scan(wlan_private * priv,
1462                          struct WLAN_802_11_SSID *prequestedssid,
1463                          u8 keeppreviousscan)
1464 {
1465         wlan_adapter *adapter = priv->adapter;
1466         struct wlan_ioctl_user_scan_cfg scancfg;
1467
1468         lbs_deb_enter(LBS_DEB_ASSOC);
1469
1470         if (prequestedssid == NULL) {
1471                 return -1;
1472         }
1473
1474         memset(&scancfg, 0x00, sizeof(scancfg));
1475
1476         memcpy(scancfg.specificSSID, prequestedssid->ssid,
1477                prequestedssid->ssidlength);
1478         scancfg.keeppreviousscan = keeppreviousscan;
1479
1480         wlan_scan_networks(priv, &scancfg, 1);
1481         if (adapter->surpriseremoved)
1482                 return -1;
1483         wait_event_interruptible(adapter->cmd_pending, !adapter->nr_cmd_pending);
1484
1485         lbs_deb_leave(LBS_DEB_ASSOC);
1486         return 0;
1487 }
1488
1489 /**
1490  *  @brief scan an AP with specific BSSID
1491  *
1492  *  @param priv             A pointer to wlan_private structure
1493  *  @param bssid            A pointer to AP's bssid
1494  *  @param keeppreviousscan Flag used to save/clear scan table before scan
1495  *
1496  *  @return          0-success, otherwise fail
1497  */
1498 int libertas_send_specific_BSSID_scan(wlan_private * priv, u8 * bssid, u8 keeppreviousscan)
1499 {
1500         struct wlan_ioctl_user_scan_cfg scancfg;
1501
1502         lbs_deb_enter(LBS_DEB_ASSOC);
1503
1504         if (bssid == NULL) {
1505                 return -1;
1506         }
1507
1508         memset(&scancfg, 0x00, sizeof(scancfg));
1509         memcpy(scancfg.specificBSSID, bssid, sizeof(scancfg.specificBSSID));
1510         scancfg.keeppreviousscan = keeppreviousscan;
1511
1512         wlan_scan_networks(priv, &scancfg, 1);
1513         if (priv->adapter->surpriseremoved)
1514                 return -1;
1515         wait_event_interruptible(priv->adapter->cmd_pending,
1516                 !priv->adapter->nr_cmd_pending);
1517
1518         lbs_deb_leave(LBS_DEB_ASSOC);
1519         return 0;
1520 }
1521
1522 /**
1523  *  @brief  Retrieve the scan table entries via wireless tools IOCTL call
1524  *
1525  *  @param dev          A pointer to net_device structure
1526  *  @param info         A pointer to iw_request_info structure
1527  *  @param dwrq         A pointer to iw_point structure
1528  *  @param extra        A pointer to extra data buf
1529  *
1530  *  @return             0 --success, otherwise fail
1531  */
1532 int libertas_get_scan(struct net_device *dev, struct iw_request_info *info,
1533                   struct iw_point *dwrq, char *extra)
1534 {
1535         wlan_private *priv = dev->priv;
1536         wlan_adapter *adapter = priv->adapter;
1537         int ret = 0;
1538         char *current_ev = extra;
1539         char *end_buf = extra + IW_SCAN_MAX_DATA;
1540         struct chan_freq_power *cfp;
1541         struct bss_descriptor *pscantable;
1542         char *current_val;      /* For rates */
1543         struct iw_event iwe;    /* Temporary buffer */
1544         int i;
1545         int j;
1546         int rate;
1547 #define PERFECT_RSSI ((u8)50)
1548 #define WORST_RSSI   ((u8)0)
1549 #define RSSI_DIFF    ((u8)(PERFECT_RSSI - WORST_RSSI))
1550         u8 rssi;
1551
1552         u8 buf[16 + 256 * 2];
1553         u8 *ptr;
1554
1555         lbs_deb_enter(LBS_DEB_ASSOC);
1556
1557         /*
1558          * if there's either commands in the queue or one being
1559          * processed return -EAGAIN for iwlist to retry later.
1560          */
1561         if (adapter->nr_cmd_pending)
1562                 return -EAGAIN;
1563
1564         if (adapter->last_scanned_channel) {
1565                 wlan_scan_networks(priv, NULL, 0);
1566                 return -EAGAIN;
1567         }
1568
1569         if (adapter->connect_status == libertas_connected)
1570                 lbs_deb_scan("current ssid '%s'\n",
1571                        adapter->curbssparams.ssid.ssid);
1572
1573         lbs_deb_scan("Scan: Get: numinscantable = %d\n",
1574                adapter->numinscantable);
1575
1576         /* The old API using SIOCGIWAPLIST had a hard limit of IW_MAX_AP.
1577          * The new API using SIOCGIWSCAN is only limited by buffer size
1578          * WE-14 -> WE-16 the buffer is limited to IW_SCAN_MAX_DATA bytes
1579          * which is 4096.
1580          */
1581         for (i = 0; i < adapter->numinscantable; i++) {
1582                 if ((current_ev + MAX_SCAN_CELL_SIZE) >= end_buf) {
1583                         lbs_deb_scan("i=%d break out: current_ev=%p end_buf=%p "
1584                                "MAX_SCAN_CELL_SIZE=%zd\n",
1585                                i, current_ev, end_buf, MAX_SCAN_CELL_SIZE);
1586                         break;
1587                 }
1588
1589                 pscantable = &adapter->scantable[i];
1590
1591                 lbs_deb_scan("i %d, ssid '%s'\n", i, pscantable->ssid.ssid);
1592
1593                 cfp =
1594                     libertas_find_cfp_by_band_and_channel(adapter, 0,
1595                                                  pscantable->channel);
1596                 if (!cfp) {
1597                         lbs_deb_scan("Invalid channel number %d\n",
1598                                pscantable->channel);
1599                         continue;
1600                 }
1601
1602                 if (!ssid_valid(&adapter->scantable[i].ssid)) {
1603                         continue;
1604                 }
1605
1606                 /* First entry *MUST* be the AP MAC address */
1607                 iwe.cmd = SIOCGIWAP;
1608                 iwe.u.ap_addr.sa_family = ARPHRD_ETHER;
1609                 memcpy(iwe.u.ap_addr.sa_data,
1610                        &adapter->scantable[i].macaddress, ETH_ALEN);
1611
1612                 iwe.len = IW_EV_ADDR_LEN;
1613                 current_ev =
1614                     iwe_stream_add_event(current_ev, end_buf, &iwe, iwe.len);
1615
1616                 //Add the ESSID
1617                 iwe.u.data.length = adapter->scantable[i].ssid.ssidlength;
1618
1619                 if (iwe.u.data.length > 32) {
1620                         iwe.u.data.length = 32;
1621                 }
1622
1623                 iwe.cmd = SIOCGIWESSID;
1624                 iwe.u.data.flags = 1;
1625                 iwe.len = IW_EV_POINT_LEN + iwe.u.data.length;
1626                 current_ev = iwe_stream_add_point(current_ev, end_buf, &iwe,
1627                                                   adapter->scantable[i].ssid.
1628                                                   ssid);
1629
1630                 //Add mode
1631                 iwe.cmd = SIOCGIWMODE;
1632                 iwe.u.mode = adapter->scantable[i].mode;
1633                 iwe.len = IW_EV_UINT_LEN;
1634                 current_ev =
1635                     iwe_stream_add_event(current_ev, end_buf, &iwe, iwe.len);
1636
1637                 //frequency
1638                 iwe.cmd = SIOCGIWFREQ;
1639                 iwe.u.freq.m = (long)cfp->freq * 100000;
1640                 iwe.u.freq.e = 1;
1641                 iwe.len = IW_EV_FREQ_LEN;
1642                 current_ev =
1643                     iwe_stream_add_event(current_ev, end_buf, &iwe, iwe.len);
1644
1645                 /* Add quality statistics */
1646                 iwe.cmd = IWEVQUAL;
1647                 iwe.u.qual.updated = IW_QUAL_ALL_UPDATED;
1648                 iwe.u.qual.level = SCAN_RSSI(adapter->scantable[i].rssi);
1649
1650                 rssi = iwe.u.qual.level - MRVDRV_NF_DEFAULT_SCAN_VALUE;
1651                 iwe.u.qual.qual =
1652                     (100 * RSSI_DIFF * RSSI_DIFF - (PERFECT_RSSI - rssi) *
1653                      (15 * (RSSI_DIFF) + 62 * (PERFECT_RSSI - rssi))) /
1654                     (RSSI_DIFF * RSSI_DIFF);
1655                 if (iwe.u.qual.qual > 100)
1656                         iwe.u.qual.qual = 100;
1657                 else if (iwe.u.qual.qual < 1)
1658                         iwe.u.qual.qual = 0;
1659
1660                 if (adapter->NF[TYPE_BEACON][TYPE_NOAVG] == 0) {
1661                         iwe.u.qual.noise = MRVDRV_NF_DEFAULT_SCAN_VALUE;
1662                 } else {
1663                         iwe.u.qual.noise =
1664                             CAL_NF(adapter->NF[TYPE_BEACON][TYPE_NOAVG]);
1665                 }
1666                 if ((adapter->mode == IW_MODE_ADHOC) &&
1667                     !libertas_SSID_cmp(&adapter->curbssparams.ssid,
1668                              &adapter->scantable[i].ssid)
1669                     && adapter->adhoccreate) {
1670                         ret = libertas_prepare_and_send_command(priv,
1671                                                     cmd_802_11_rssi,
1672                                                     0,
1673                                                     cmd_option_waitforrsp,
1674                                                     0, NULL);
1675
1676                         if (!ret) {
1677                                 iwe.u.qual.level =
1678                                     CAL_RSSI(adapter->SNR[TYPE_RXPD][TYPE_AVG] /
1679                                              AVG_SCALE,
1680                                              adapter->NF[TYPE_RXPD][TYPE_AVG] /
1681                                              AVG_SCALE);
1682                         }
1683                 }
1684                 iwe.len = IW_EV_QUAL_LEN;
1685                 current_ev =
1686                     iwe_stream_add_event(current_ev, end_buf, &iwe, iwe.len);
1687
1688                 /* Add encryption capability */
1689                 iwe.cmd = SIOCGIWENCODE;
1690                 if (adapter->scantable[i].privacy) {
1691                         iwe.u.data.flags = IW_ENCODE_ENABLED | IW_ENCODE_NOKEY;
1692                 } else {
1693                         iwe.u.data.flags = IW_ENCODE_DISABLED;
1694                 }
1695                 iwe.u.data.length = 0;
1696                 iwe.len = IW_EV_POINT_LEN + iwe.u.data.length;
1697                 current_ev = iwe_stream_add_point(current_ev, end_buf, &iwe,
1698                                                   adapter->scantable->ssid.
1699                                                   ssid);
1700
1701                 current_val = current_ev + IW_EV_LCP_LEN;
1702
1703                 iwe.cmd = SIOCGIWRATE;
1704
1705                 iwe.u.bitrate.fixed = 0;
1706                 iwe.u.bitrate.disabled = 0;
1707                 iwe.u.bitrate.value = 0;
1708
1709                 /* Bit rate given in 500 kb/s units (+ 0x80) */
1710                 for (j = 0; j < sizeof(adapter->scantable[i].libertas_supported_rates);
1711                      j++) {
1712                         if (adapter->scantable[i].libertas_supported_rates[j] == 0) {
1713                                 break;
1714                         }
1715                         rate =
1716                             (adapter->scantable[i].libertas_supported_rates[j] & 0x7F) *
1717                             500000;
1718                         if (rate > iwe.u.bitrate.value) {
1719                                 iwe.u.bitrate.value = rate;
1720                         }
1721
1722                         iwe.u.bitrate.value =
1723                             (adapter->scantable[i].libertas_supported_rates[j]
1724                              & 0x7f) * 500000;
1725                         iwe.len = IW_EV_PARAM_LEN;
1726                         current_ev =
1727                             iwe_stream_add_value(current_ev, current_val,
1728                                                  end_buf, &iwe, iwe.len);
1729
1730                 }
1731                 if ((adapter->scantable[i].mode == IW_MODE_ADHOC)
1732                     && !libertas_SSID_cmp(&adapter->curbssparams.ssid,
1733                                 &adapter->scantable[i].ssid)
1734                     && adapter->adhoccreate) {
1735                         iwe.u.bitrate.value = 22 * 500000;
1736                 }
1737                 iwe.len = IW_EV_PARAM_LEN;
1738                 current_ev =
1739                     iwe_stream_add_value(current_ev, current_val, end_buf, &iwe,
1740                                          iwe.len);
1741
1742                 /* Add new value to event */
1743                 current_val = current_ev + IW_EV_LCP_LEN;
1744
1745                 if (adapter->scantable[i].rsn_ie[0] == WPA2_IE) {
1746                         memset(&iwe, 0, sizeof(iwe));
1747                         memset(buf, 0, sizeof(buf));
1748                         memcpy(buf, adapter->scantable[i].rsn_ie,
1749                                         adapter->scantable[i].rsn_ie_len);
1750                         iwe.cmd = IWEVGENIE;
1751                         iwe.u.data.length = adapter->scantable[i].rsn_ie_len;
1752                         iwe.len = IW_EV_POINT_LEN + iwe.u.data.length;
1753                         current_ev = iwe_stream_add_point(current_ev, end_buf,
1754                                         &iwe, buf);
1755                 }
1756                 if (adapter->scantable[i].wpa_ie[0] == WPA_IE) {
1757                         memset(&iwe, 0, sizeof(iwe));
1758                         memset(buf, 0, sizeof(buf));
1759                         memcpy(buf, adapter->scantable[i].wpa_ie,
1760                                         adapter->scantable[i].wpa_ie_len);
1761                         iwe.cmd = IWEVGENIE;
1762                         iwe.u.data.length = adapter->scantable[i].wpa_ie_len;
1763                         iwe.len = IW_EV_POINT_LEN + iwe.u.data.length;
1764                         current_ev = iwe_stream_add_point(current_ev, end_buf,
1765                                         &iwe, buf);
1766                 }
1767
1768
1769                 if (adapter->scantable[i].extra_ie != 0) {
1770                         memset(&iwe, 0, sizeof(iwe));
1771                         memset(buf, 0, sizeof(buf));
1772                         ptr = buf;
1773                         ptr += sprintf(ptr, "extra_ie");
1774                         iwe.u.data.length = strlen(buf);
1775
1776                         lbs_deb_scan("iwe.u.data.length %d\n",
1777                                iwe.u.data.length);
1778                         lbs_deb_scan("BUF: %s \n", buf);
1779
1780                         iwe.cmd = IWEVCUSTOM;
1781                         iwe.len = IW_EV_POINT_LEN + iwe.u.data.length;
1782                         current_ev =
1783                             iwe_stream_add_point(current_ev, end_buf, &iwe,
1784                                                  buf);
1785                 }
1786
1787                 current_val = current_ev + IW_EV_LCP_LEN;
1788
1789                 /*
1790                  * Check if we added any event
1791                  */
1792                 if ((current_val - current_ev) > IW_EV_LCP_LEN)
1793                         current_ev = current_val;
1794         }
1795
1796         dwrq->length = (current_ev - extra);
1797         dwrq->flags = 0;
1798
1799         lbs_deb_leave(LBS_DEB_ASSOC);
1800         return 0;
1801 }
1802
1803 /**
1804  *  @brief Prepare a scan command to be sent to the firmware
1805  *
1806  *  Use the wlan_scan_cmd_config sent to the command processing module in
1807  *   the libertas_prepare_and_send_command to configure a cmd_ds_802_11_scan command
1808  *   struct to send to firmware.
1809  *
1810  *  The fixed fields specifying the BSS type and BSSID filters as well as a
1811  *   variable number/length of TLVs are sent in the command to firmware.
1812  *
1813  *  @param priv       A pointer to wlan_private structure
1814  *  @param cmd        A pointer to cmd_ds_command structure to be sent to
1815  *                    firmware with the cmd_DS_801_11_SCAN structure
1816  *  @param pdata_buf  Void pointer cast of a wlan_scan_cmd_config struct used
1817  *                    to set the fields/TLVs for the command sent to firmware
1818  *
1819  *  @return           0 or -1
1820  *
1821  *  @sa wlan_scan_create_channel_list
1822  */
1823 int libertas_cmd_80211_scan(wlan_private * priv,
1824                          struct cmd_ds_command *cmd, void *pdata_buf)
1825 {
1826         struct cmd_ds_802_11_scan *pscan = &cmd->params.scan;
1827         struct wlan_scan_cmd_config *pscancfg;
1828
1829         lbs_deb_enter(LBS_DEB_ASSOC);
1830
1831         pscancfg = pdata_buf;
1832
1833         /* Set fixed field variables in scan command */
1834         pscan->bsstype = pscancfg->bsstype;
1835         memcpy(pscan->BSSID, pscancfg->specificBSSID, sizeof(pscan->BSSID));
1836         memcpy(pscan->tlvbuffer, pscancfg->tlvbuffer, pscancfg->tlvbufferlen);
1837
1838         cmd->command = cpu_to_le16(cmd_802_11_scan);
1839
1840         /* size is equal to the sizeof(fixed portions) + the TLV len + header */
1841         cmd->size = cpu_to_le16(sizeof(pscan->bsstype)
1842                                      + sizeof(pscan->BSSID)
1843                                      + pscancfg->tlvbufferlen + S_DS_GEN);
1844
1845         lbs_deb_scan("SCAN_CMD: command=%x, size=%x, seqnum=%x\n",
1846                cmd->command, cmd->size, cmd->seqnum);
1847
1848         lbs_deb_leave(LBS_DEB_ASSOC);
1849         return 0;
1850 }
1851
1852 /**
1853  *  @brief This function handles the command response of scan
1854  *
1855  *   The response buffer for the scan command has the following
1856  *      memory layout:
1857  *
1858  *     .-----------------------------------------------------------.
1859  *     |  header (4 * sizeof(u16)):  Standard command response hdr |
1860  *     .-----------------------------------------------------------.
1861  *     |  bufsize (u16) : sizeof the BSS Description data          |
1862  *     .-----------------------------------------------------------.
1863  *     |  NumOfSet (u8) : Number of BSS Descs returned             |
1864  *     .-----------------------------------------------------------.
1865  *     |  BSSDescription data (variable, size given in bufsize)    |
1866  *     .-----------------------------------------------------------.
1867  *     |  TLV data (variable, size calculated using header->size,  |
1868  *     |            bufsize and sizeof the fixed fields above)     |
1869  *     .-----------------------------------------------------------.
1870  *
1871  *  @param priv    A pointer to wlan_private structure
1872  *  @param resp    A pointer to cmd_ds_command
1873  *
1874  *  @return        0 or -1
1875  */
1876 int libertas_ret_80211_scan(wlan_private * priv, struct cmd_ds_command *resp)
1877 {
1878         wlan_adapter *adapter = priv->adapter;
1879         struct cmd_ds_802_11_scan_rsp *pscan;
1880         struct bss_descriptor newbssentry;
1881         struct mrvlietypes_data *ptlv;
1882         struct mrvlietypes_tsftimestamp *ptsftlv;
1883         u8 *pbssinfo;
1884         u16 scanrespsize;
1885         int bytesleft;
1886         int numintable;
1887         int bssIdx;
1888         int idx;
1889         int tlvbufsize;
1890         u64 tsfval;
1891         int ret;
1892
1893         lbs_deb_enter(LBS_DEB_ASSOC);
1894
1895         pscan = &resp->params.scanresp;
1896
1897         if (pscan->nr_sets > MRVDRV_MAX_BSSID_LIST) {
1898         lbs_deb_scan(
1899                        "SCAN_RESP: Invalid number of AP returned (%d)!!\n",
1900                        pscan->nr_sets);
1901                 ret = -1;
1902                 goto done;
1903         }
1904
1905         bytesleft = le16_to_cpu(pscan->bssdescriptsize);
1906         lbs_deb_scan("SCAN_RESP: bssdescriptsize %d\n", bytesleft);
1907
1908         scanrespsize = le16_to_cpu(resp->size);
1909         lbs_deb_scan("SCAN_RESP: returned %d AP before parsing\n",
1910                pscan->nr_sets);
1911
1912         numintable = adapter->numinscantable;
1913         pbssinfo = pscan->bssdesc_and_tlvbuffer;
1914
1915         /* The size of the TLV buffer is equal to the entire command response
1916          *   size (scanrespsize) minus the fixed fields (sizeof()'s), the
1917          *   BSS Descriptions (bssdescriptsize as bytesLef) and the command
1918          *   response header (S_DS_GEN)
1919          */
1920         tlvbufsize = scanrespsize - (bytesleft + sizeof(pscan->bssdescriptsize)
1921                                      + sizeof(pscan->nr_sets)
1922                                      + S_DS_GEN);
1923
1924         ptlv = (struct mrvlietypes_data *) (pscan->bssdesc_and_tlvbuffer + bytesleft);
1925
1926         /* Search the TLV buffer space in the scan response for any valid TLVs */
1927         wlan_ret_802_11_scan_get_tlv_ptrs(ptlv, tlvbufsize, &ptsftlv);
1928
1929         /*
1930          *  Process each scan response returned (pscan->nr_sets).  Save
1931          *    the information in the newbssentry and then insert into the
1932          *    driver scan table either as an update to an existing entry
1933          *    or as an addition at the end of the table
1934          */
1935         for (idx = 0; idx < pscan->nr_sets && bytesleft; idx++) {
1936                 /* Zero out the newbssentry we are about to store info in */
1937                 memset(&newbssentry, 0x00, sizeof(newbssentry));
1938
1939                 /* Process the data fields and IEs returned for this BSS */
1940                 if ((InterpretBSSDescriptionWithIE(&newbssentry,
1941                                                    &pbssinfo,
1942                                                    &bytesleft) ==
1943                      0)
1944                     && CHECK_SSID_IS_VALID(&newbssentry.ssid)) {
1945
1946             lbs_deb_scan(
1947                                "SCAN_RESP: BSSID = %02x:%02x:%02x:%02x:%02x:%02x\n",
1948                                newbssentry.macaddress[0],
1949                                newbssentry.macaddress[1],
1950                                newbssentry.macaddress[2],
1951                                newbssentry.macaddress[3],
1952                                newbssentry.macaddress[4],
1953                                newbssentry.macaddress[5]);
1954
1955                         /*
1956                          * Search the scan table for the same bssid
1957                          */
1958                         for (bssIdx = 0; bssIdx < numintable; bssIdx++) {
1959                                 if (memcmp(newbssentry.macaddress,
1960                                            adapter->scantable[bssIdx].
1961                                            macaddress,
1962                                            sizeof(newbssentry.macaddress)) ==
1963                                     0) {
1964                                         /*
1965                                          * If the SSID matches as well, it is a duplicate of
1966                                          *   this entry.  Keep the bssIdx set to this
1967                                          *   entry so we replace the old contents in the table
1968                                          */
1969                                         if ((newbssentry.ssid.ssidlength ==
1970                                              adapter->scantable[bssIdx].ssid.
1971                                              ssidlength)
1972                                             &&
1973                                             (memcmp
1974                                              (newbssentry.ssid.ssid,
1975                                               adapter->scantable[bssIdx].ssid.
1976                                               ssid,
1977                                               newbssentry.ssid.ssidlength) ==
1978                                              0)) {
1979                         lbs_deb_scan(
1980                                                        "SCAN_RESP: Duplicate of index: %d\n",
1981                                                        bssIdx);
1982                                                 break;
1983                                         }
1984                                 }
1985                         }
1986                         /*
1987                          * If the bssIdx is equal to the number of entries in the table,
1988                          *   the new entry was not a duplicate; append it to the scan
1989                          *   table
1990                          */
1991                         if (bssIdx == numintable) {
1992                                 /* Range check the bssIdx, keep it limited to the last entry */
1993                                 if (bssIdx == MRVDRV_MAX_BSSID_LIST) {
1994                                         bssIdx--;
1995                                 } else {
1996                                         numintable++;
1997                                 }
1998                         }
1999
2000                         /*
2001                          * If the TSF TLV was appended to the scan results, save the
2002                          *   this entries TSF value in the networktsf field.  The
2003                          *   networktsf is the firmware's TSF value at the time the
2004                          *   beacon or probe response was received.
2005                          */
2006                         if (ptsftlv) {
2007                                 memcpy(&tsfval, &ptsftlv->tsftable[idx],
2008                                        sizeof(tsfval));
2009                                 tsfval = le64_to_cpu(tsfval);
2010
2011                                 memcpy(&newbssentry.networktsf,
2012                                        &tsfval, sizeof(newbssentry.networktsf));
2013                         }
2014
2015                         /* Copy the locally created newbssentry to the scan table */
2016                         memcpy(&adapter->scantable[bssIdx],
2017                                &newbssentry,
2018                                sizeof(adapter->scantable[bssIdx]));
2019
2020                 } else {
2021
2022                         /* error parsing/interpreting the scan response, skipped */
2023                         lbs_deb_scan("SCAN_RESP: "
2024                                "InterpretBSSDescriptionWithIE returned ERROR\n");
2025                 }
2026         }
2027
2028         lbs_deb_scan("SCAN_RESP: Scanned %2d APs, %d valid, %d total\n",
2029                pscan->nr_sets, numintable - adapter->numinscantable,
2030                numintable);
2031
2032         /* Update the total number of BSSIDs in the scan table */
2033         adapter->numinscantable = numintable;
2034         ret = 0;
2035
2036 done:
2037         lbs_deb_leave_args(LBS_DEB_SCAN, "ret %d", ret);
2038         return ret;
2039 }