1/*
2 * WPA Supplicant - Scanning
3 * Copyright (c) 2003-2014, Jouni Malinen <j@w1.fi>
4 *
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
7 */
8
9#ifndef SCAN_H
10#define SCAN_H
11
12/*
13 * Noise floor values to use when we have signal strength
14 * measurements, but no noise floor measurements. These values were
15 * measured in an office environment with many APs.
16 */
17#define DEFAULT_NOISE_FLOOR_2GHZ (-89)
18#define DEFAULT_NOISE_FLOOR_5GHZ (-92)
19#define DEFAULT_NOISE_FLOOR_6GHZ (-92)
20
21/*
22 * Channels with a great SNR can operate at full rate. What is a great SNR?
23 * This doc https://supportforums.cisco.com/docs/DOC-12954 says, "the general
24 * rule of thumb is that any SNR above 20 is good." This one
25 * http://www.cisco.com/en/US/tech/tk722/tk809/technologies_q_and_a_item09186a00805e9a96.shtml#qa23
26 * recommends 25 as a minimum SNR for 54 Mbps data rate. The estimates used in
27 * scan_est_throughput() allow even smaller SNR values for the maximum rates
28 * (21 for 54 Mbps, 22 for VHT80 MCS9, 24 for HT40 and HT20 MCS7). Use 25 as a
29 * somewhat conservative value here.
30 */
31#define GREAT_SNR 25
32
33#define IS_2P4GHZ(n) (n >= 2412 && n <= 2484)
34#define IS_5GHZ(n) (n > 4000 && n < 5895)
35
36int wpa_supplicant_enabled_networks(struct wpa_supplicant *wpa_s);
37void wpa_supplicant_req_scan(struct wpa_supplicant *wpa_s, int sec, int usec);
38int wpa_supplicant_delayed_sched_scan(struct wpa_supplicant *wpa_s,
39				      int sec, int usec);
40int wpa_supplicant_req_sched_scan(struct wpa_supplicant *wpa_s);
41void wpa_supplicant_cancel_scan(struct wpa_supplicant *wpa_s);
42void wpa_supplicant_cancel_delayed_sched_scan(struct wpa_supplicant *wpa_s);
43void wpa_supplicant_cancel_sched_scan(struct wpa_supplicant *wpa_s);
44void wpa_supplicant_notify_scanning(struct wpa_supplicant *wpa_s,
45				    int scanning);
46struct wpa_driver_scan_params;
47int wpa_supplicant_trigger_scan(struct wpa_supplicant *wpa_s,
48				struct wpa_driver_scan_params *params);
49struct wpa_scan_results *
50wpa_supplicant_get_scan_results(struct wpa_supplicant *wpa_s,
51				struct scan_info *info, int new_scan);
52int wpa_supplicant_update_scan_results(struct wpa_supplicant *wpa_s);
53const u8 * wpa_scan_get_ie(const struct wpa_scan_res *res, u8 ie);
54const u8 * wpa_scan_get_vendor_ie(const struct wpa_scan_res *res,
55				  u32 vendor_type);
56const u8 * wpa_scan_get_vendor_ie_beacon(const struct wpa_scan_res *res,
57					 u32 vendor_type);
58struct wpabuf * wpa_scan_get_vendor_ie_multi(const struct wpa_scan_res *res,
59					     u32 vendor_type);
60int wpa_supplicant_filter_bssid_match(struct wpa_supplicant *wpa_s,
61				      const u8 *bssid);
62void wpa_supplicant_update_scan_int(struct wpa_supplicant *wpa_s, int sec);
63void scan_only_handler(struct wpa_supplicant *wpa_s,
64		       struct wpa_scan_results *scan_res);
65int wpas_scan_scheduled(struct wpa_supplicant *wpa_s);
66struct wpa_driver_scan_params *
67wpa_scan_clone_params(const struct wpa_driver_scan_params *src);
68void wpa_scan_free_params(struct wpa_driver_scan_params *params);
69int wpas_start_pno(struct wpa_supplicant *wpa_s);
70int wpas_stop_pno(struct wpa_supplicant *wpa_s);
71void wpas_scan_reset_sched_scan(struct wpa_supplicant *wpa_s);
72void wpas_scan_restart_sched_scan(struct wpa_supplicant *wpa_s);
73
74void wpas_mac_addr_rand_scan_clear(struct wpa_supplicant *wpa_s,
75				   unsigned int type);
76int wpas_mac_addr_rand_scan_set(struct wpa_supplicant *wpa_s,
77				unsigned int type, const u8 *addr,
78				const u8 *mask);
79int wpas_mac_addr_rand_scan_get_mask(struct wpa_supplicant *wpa_s,
80				     unsigned int type, u8 *mask);
81int wpas_abort_ongoing_scan(struct wpa_supplicant *wpa_s);
82void filter_scan_res(struct wpa_supplicant *wpa_s,
83		     struct wpa_scan_results *res);
84void scan_snr(struct wpa_scan_res *res);
85void scan_est_throughput(struct wpa_supplicant *wpa_s,
86			 struct wpa_scan_res *res);
87unsigned int wpas_get_est_tpt(const struct wpa_supplicant *wpa_s,
88			      const u8 *ies, size_t ies_len, int rate,
89			      int snr, int freq);
90void wpa_supplicant_set_default_scan_ies(struct wpa_supplicant *wpa_s);
91int wpa_add_scan_freqs_list(struct wpa_supplicant *wpa_s,
92			    enum hostapd_hw_mode band,
93			    struct wpa_driver_scan_params *params,
94			    bool is_6ghz);
95
96#endif /* SCAN_H */
97