bgscan_simple.c 8.0 KB

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