bgscan_simple.c 8.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289
  1. /*
  2. * WPA Supplicant - background scan and roaming module: simple
  3. * Copyright (c) 2009-2010, Jouni Malinen <j@w1.fi>
  4. *
  5. * This program is free software; you can redistribute it and/or modify
  6. * it under the terms of the GNU General Public License version 2 as
  7. * published by the Free Software Foundation.
  8. *
  9. * Alternatively, this software may be distributed under the terms of BSD
  10. * license.
  11. *
  12. * See README and COPYING for more details.
  13. */
  14. #include "includes.h"
  15. #include "common.h"
  16. #include "eloop.h"
  17. #include "drivers/driver.h"
  18. #include "config_ssid.h"
  19. #include "wpa_supplicant_i.h"
  20. #include "driver_i.h"
  21. #include "scan.h"
  22. #include "bgscan.h"
  23. struct bgscan_simple_data {
  24. struct wpa_supplicant *wpa_s;
  25. const struct wpa_ssid *ssid;
  26. int scan_interval;
  27. int signal_threshold;
  28. int short_scan_count; /* counter for scans using short scan interval */
  29. int max_short_scans; /* maximum times we short-scan before back-off */
  30. int short_interval; /* use if signal < threshold */
  31. int long_interval; /* use if signal > threshold */
  32. struct os_time last_bgscan;
  33. };
  34. static void bgscan_simple_timeout(void *eloop_ctx, void *timeout_ctx)
  35. {
  36. struct bgscan_simple_data *data = eloop_ctx;
  37. struct wpa_supplicant *wpa_s = data->wpa_s;
  38. struct wpa_driver_scan_params params;
  39. os_memset(&params, 0, sizeof(params));
  40. params.num_ssids = 1;
  41. params.ssids[0].ssid = data->ssid->ssid;
  42. params.ssids[0].ssid_len = data->ssid->ssid_len;
  43. params.freqs = data->ssid->scan_freq;
  44. /*
  45. * A more advanced bgscan module would learn about most like channels
  46. * over time and request scans only for some channels (probing others
  47. * every now and then) to reduce effect on the data connection.
  48. */
  49. wpa_printf(MSG_DEBUG, "bgscan simple: Request a background scan");
  50. if (wpa_supplicant_trigger_scan(wpa_s, &params)) {
  51. wpa_printf(MSG_DEBUG, "bgscan simple: Failed to trigger scan");
  52. eloop_register_timeout(data->scan_interval, 0,
  53. bgscan_simple_timeout, data, NULL);
  54. } else {
  55. if (data->scan_interval == data->short_interval) {
  56. data->short_scan_count++;
  57. /*
  58. * Spend at most the duration of a long scan interval
  59. * scanning at the short scan interval. After that,
  60. * revert to the long scan interval.
  61. */
  62. if (data->short_scan_count > data->max_short_scans) {
  63. data->scan_interval = data->long_interval;
  64. wpa_printf(MSG_DEBUG, "bgscan simple: Backing "
  65. "off to long scan interval");
  66. }
  67. } else if (data->short_scan_count > 0) {
  68. /*
  69. * If we lasted a long scan interval without any
  70. * CQM triggers, decrease the short-scan count,
  71. * which allows 1 more short-scan interval to
  72. * occur in the future when CQM triggers.
  73. */
  74. data->short_scan_count--;
  75. }
  76. os_get_time(&data->last_bgscan);
  77. }
  78. }
  79. static int bgscan_simple_get_params(struct bgscan_simple_data *data,
  80. const char *params)
  81. {
  82. const char *pos;
  83. if (params == NULL)
  84. return 0;
  85. data->short_interval = atoi(params);
  86. pos = os_strchr(params, ':');
  87. if (pos == NULL)
  88. return 0;
  89. pos++;
  90. data->signal_threshold = atoi(pos);
  91. pos = os_strchr(pos, ':');
  92. if (pos == NULL) {
  93. wpa_printf(MSG_ERROR, "bgscan simple: Missing scan interval "
  94. "for high signal");
  95. return -1;
  96. }
  97. pos++;
  98. data->long_interval = atoi(pos);
  99. return 0;
  100. }
  101. static void * bgscan_simple_init(struct wpa_supplicant *wpa_s,
  102. const char *params,
  103. const struct wpa_ssid *ssid)
  104. {
  105. struct bgscan_simple_data *data;
  106. data = os_zalloc(sizeof(*data));
  107. if (data == NULL)
  108. return NULL;
  109. data->wpa_s = wpa_s;
  110. data->ssid = ssid;
  111. if (bgscan_simple_get_params(data, params) < 0) {
  112. os_free(data);
  113. return NULL;
  114. }
  115. if (data->short_interval <= 0)
  116. data->short_interval = 30;
  117. if (data->long_interval <= 0)
  118. data->long_interval = 30;
  119. wpa_printf(MSG_DEBUG, "bgscan simple: Signal strength threshold %d "
  120. "Short bgscan interval %d Long bgscan interval %d",
  121. data->signal_threshold, data->short_interval,
  122. data->long_interval);
  123. if (data->signal_threshold &&
  124. wpa_drv_signal_monitor(wpa_s, data->signal_threshold, 4) < 0) {
  125. wpa_printf(MSG_ERROR, "bgscan simple: Failed to enable "
  126. "signal strength monitoring");
  127. }
  128. data->scan_interval = data->short_interval;
  129. data->max_short_scans = data->long_interval / data->short_interval + 1;
  130. if (data->signal_threshold) {
  131. /* Poll for signal info to set initial scan interval */
  132. struct wpa_signal_info siginfo;
  133. if (wpa_drv_signal_poll(wpa_s, &siginfo) == 0 &&
  134. siginfo.current_signal >= data->signal_threshold)
  135. data->scan_interval = data->long_interval;
  136. }
  137. wpa_printf(MSG_DEBUG, "bgscan simple: Init scan interval: %d",
  138. data->scan_interval);
  139. eloop_register_timeout(data->scan_interval, 0, bgscan_simple_timeout,
  140. data, NULL);
  141. /*
  142. * This function is called immediately after an association, so it is
  143. * reasonable to assume that a scan was completed recently. This makes
  144. * us skip an immediate new scan in cases where the current signal
  145. * level is below the bgscan threshold.
  146. */
  147. os_get_time(&data->last_bgscan);
  148. return data;
  149. }
  150. static void bgscan_simple_deinit(void *priv)
  151. {
  152. struct bgscan_simple_data *data = priv;
  153. eloop_cancel_timeout(bgscan_simple_timeout, data, NULL);
  154. if (data->signal_threshold)
  155. wpa_drv_signal_monitor(data->wpa_s, 0, 0);
  156. os_free(data);
  157. }
  158. static int bgscan_simple_notify_scan(void *priv,
  159. struct wpa_scan_results *scan_res)
  160. {
  161. struct bgscan_simple_data *data = priv;
  162. wpa_printf(MSG_DEBUG, "bgscan simple: scan result notification");
  163. eloop_cancel_timeout(bgscan_simple_timeout, data, NULL);
  164. eloop_register_timeout(data->scan_interval, 0, bgscan_simple_timeout,
  165. data, NULL);
  166. /*
  167. * A more advanced bgscan could process scan results internally, select
  168. * the BSS and request roam if needed. This sample uses the existing
  169. * BSS/ESS selection routine. Change this to return 1 if selection is
  170. * done inside the bgscan module.
  171. */
  172. return 0;
  173. }
  174. static void bgscan_simple_notify_beacon_loss(void *priv)
  175. {
  176. wpa_printf(MSG_DEBUG, "bgscan simple: beacon loss");
  177. /* TODO: speed up background scanning */
  178. }
  179. static void bgscan_simple_notify_signal_change(void *priv, int above,
  180. int current_signal,
  181. int current_noise,
  182. int current_txrate)
  183. {
  184. struct bgscan_simple_data *data = priv;
  185. int scan = 0;
  186. struct os_time now;
  187. if (data->short_interval == data->long_interval ||
  188. data->signal_threshold == 0)
  189. return;
  190. wpa_printf(MSG_DEBUG, "bgscan simple: signal level changed "
  191. "(above=%d current_signal=%d current_noise=%d "
  192. "current_txrate=%d))", above, current_signal,
  193. current_noise, current_txrate);
  194. if (data->scan_interval == data->long_interval && !above) {
  195. wpa_printf(MSG_DEBUG, "bgscan simple: Start using short "
  196. "bgscan interval");
  197. data->scan_interval = data->short_interval;
  198. os_get_time(&now);
  199. if (now.sec > data->last_bgscan.sec + 1 &&
  200. data->short_scan_count <= data->max_short_scans)
  201. /*
  202. * If we haven't just previously (<1 second ago)
  203. * performed a scan, and we haven't depleted our
  204. * budget for short-scans, perform a scan
  205. * immediately.
  206. */
  207. scan = 1;
  208. else if (data->last_bgscan.sec + data->long_interval >
  209. now.sec + data->scan_interval) {
  210. /*
  211. * Restart scan interval timer if currently scheduled
  212. * scan is too far in the future.
  213. */
  214. eloop_cancel_timeout(bgscan_simple_timeout, data,
  215. NULL);
  216. eloop_register_timeout(data->scan_interval, 0,
  217. bgscan_simple_timeout, data,
  218. NULL);
  219. }
  220. } else if (data->scan_interval == data->short_interval && above) {
  221. wpa_printf(MSG_DEBUG, "bgscan simple: Start using long bgscan "
  222. "interval");
  223. data->scan_interval = data->long_interval;
  224. eloop_cancel_timeout(bgscan_simple_timeout, data, NULL);
  225. eloop_register_timeout(data->scan_interval, 0,
  226. bgscan_simple_timeout, data, NULL);
  227. } else if (!above) {
  228. /*
  229. * Signal dropped further 4 dB. Request a new scan if we have
  230. * not yet scanned in a while.
  231. */
  232. os_get_time(&now);
  233. if (now.sec > data->last_bgscan.sec + 10)
  234. scan = 1;
  235. }
  236. if (scan) {
  237. wpa_printf(MSG_DEBUG, "bgscan simple: Trigger immediate scan");
  238. eloop_cancel_timeout(bgscan_simple_timeout, data, NULL);
  239. eloop_register_timeout(0, 0, bgscan_simple_timeout, data,
  240. NULL);
  241. }
  242. }
  243. const struct bgscan_ops bgscan_simple_ops = {
  244. .name = "simple",
  245. .init = bgscan_simple_init,
  246. .deinit = bgscan_simple_deinit,
  247. .notify_scan = bgscan_simple_notify_scan,
  248. .notify_beacon_loss = bgscan_simple_notify_beacon_loss,
  249. .notify_signal_change = bgscan_simple_notify_signal_change,
  250. };