rate.c 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535
  1. /*
  2. * Copyright 2002-2005, Instant802 Networks, Inc.
  3. * Copyright 2005-2006, Devicescape Software, Inc.
  4. * Copyright (c) 2006 Jiri Benc <jbenc@suse.cz>
  5. *
  6. * This program is free software; you can redistribute it and/or modify
  7. * it under the terms of the GNU General Public License version 2 as
  8. * published by the Free Software Foundation.
  9. */
  10. #include <linux/kernel.h>
  11. #include <linux/rtnetlink.h>
  12. #include <linux/slab.h>
  13. #include <linux/module.h>
  14. #include "rate.h"
  15. #include "ieee80211_i.h"
  16. #include "debugfs.h"
  17. struct rate_control_alg {
  18. struct list_head list;
  19. struct rate_control_ops *ops;
  20. };
  21. static LIST_HEAD(rate_ctrl_algs);
  22. static DEFINE_MUTEX(rate_ctrl_mutex);
  23. static char *ieee80211_default_rc_algo = CONFIG_MAC80211_RC_DEFAULT;
  24. module_param(ieee80211_default_rc_algo, charp, 0644);
  25. MODULE_PARM_DESC(ieee80211_default_rc_algo,
  26. "Default rate control algorithm for mac80211 to use");
  27. int ieee80211_rate_control_register(struct rate_control_ops *ops)
  28. {
  29. struct rate_control_alg *alg;
  30. if (!ops->name)
  31. return -EINVAL;
  32. mutex_lock(&rate_ctrl_mutex);
  33. list_for_each_entry(alg, &rate_ctrl_algs, list) {
  34. if (!strcmp(alg->ops->name, ops->name)) {
  35. /* don't register an algorithm twice */
  36. WARN_ON(1);
  37. mutex_unlock(&rate_ctrl_mutex);
  38. return -EALREADY;
  39. }
  40. }
  41. alg = kzalloc(sizeof(*alg), GFP_KERNEL);
  42. if (alg == NULL) {
  43. mutex_unlock(&rate_ctrl_mutex);
  44. return -ENOMEM;
  45. }
  46. alg->ops = ops;
  47. list_add_tail(&alg->list, &rate_ctrl_algs);
  48. mutex_unlock(&rate_ctrl_mutex);
  49. return 0;
  50. }
  51. EXPORT_SYMBOL(ieee80211_rate_control_register);
  52. void ieee80211_rate_control_unregister(struct rate_control_ops *ops)
  53. {
  54. struct rate_control_alg *alg;
  55. mutex_lock(&rate_ctrl_mutex);
  56. list_for_each_entry(alg, &rate_ctrl_algs, list) {
  57. if (alg->ops == ops) {
  58. list_del(&alg->list);
  59. kfree(alg);
  60. break;
  61. }
  62. }
  63. mutex_unlock(&rate_ctrl_mutex);
  64. }
  65. EXPORT_SYMBOL(ieee80211_rate_control_unregister);
  66. static struct rate_control_ops *
  67. ieee80211_try_rate_control_ops_get(const char *name)
  68. {
  69. struct rate_control_alg *alg;
  70. struct rate_control_ops *ops = NULL;
  71. if (!name)
  72. return NULL;
  73. mutex_lock(&rate_ctrl_mutex);
  74. list_for_each_entry(alg, &rate_ctrl_algs, list) {
  75. if (!strcmp(alg->ops->name, name))
  76. if (try_module_get(alg->ops->module)) {
  77. ops = alg->ops;
  78. break;
  79. }
  80. }
  81. mutex_unlock(&rate_ctrl_mutex);
  82. return ops;
  83. }
  84. /* Get the rate control algorithm. */
  85. static struct rate_control_ops *
  86. ieee80211_rate_control_ops_get(const char *name)
  87. {
  88. struct rate_control_ops *ops;
  89. const char *alg_name;
  90. kparam_block_sysfs_write(ieee80211_default_rc_algo);
  91. if (!name)
  92. alg_name = ieee80211_default_rc_algo;
  93. else
  94. alg_name = name;
  95. ops = ieee80211_try_rate_control_ops_get(alg_name);
  96. if (!ops) {
  97. request_module("rc80211_%s", alg_name);
  98. ops = ieee80211_try_rate_control_ops_get(alg_name);
  99. }
  100. if (!ops && name)
  101. /* try default if specific alg requested but not found */
  102. ops = ieee80211_try_rate_control_ops_get(ieee80211_default_rc_algo);
  103. /* try built-in one if specific alg requested but not found */
  104. if (!ops && strlen(CONFIG_MAC80211_RC_DEFAULT))
  105. ops = ieee80211_try_rate_control_ops_get(CONFIG_MAC80211_RC_DEFAULT);
  106. kparam_unblock_sysfs_write(ieee80211_default_rc_algo);
  107. return ops;
  108. }
  109. static void ieee80211_rate_control_ops_put(struct rate_control_ops *ops)
  110. {
  111. module_put(ops->module);
  112. }
  113. #ifdef CONFIG_MAC80211_DEBUGFS
  114. static ssize_t rcname_read(struct file *file, char __user *userbuf,
  115. size_t count, loff_t *ppos)
  116. {
  117. struct rate_control_ref *ref = file->private_data;
  118. int len = strlen(ref->ops->name);
  119. return simple_read_from_buffer(userbuf, count, ppos,
  120. ref->ops->name, len);
  121. }
  122. static const struct file_operations rcname_ops = {
  123. .read = rcname_read,
  124. .open = simple_open,
  125. .llseek = default_llseek,
  126. };
  127. #endif
  128. static struct rate_control_ref *rate_control_alloc(const char *name,
  129. struct ieee80211_local *local)
  130. {
  131. struct dentry *debugfsdir = NULL;
  132. struct rate_control_ref *ref;
  133. ref = kmalloc(sizeof(struct rate_control_ref), GFP_KERNEL);
  134. if (!ref)
  135. goto fail_ref;
  136. ref->local = local;
  137. ref->ops = ieee80211_rate_control_ops_get(name);
  138. if (!ref->ops)
  139. goto fail_ops;
  140. #ifdef CONFIG_MAC80211_DEBUGFS
  141. debugfsdir = debugfs_create_dir("rc", local->hw.wiphy->debugfsdir);
  142. local->debugfs.rcdir = debugfsdir;
  143. debugfs_create_file("name", 0400, debugfsdir, ref, &rcname_ops);
  144. #endif
  145. ref->priv = ref->ops->alloc(&local->hw, debugfsdir);
  146. if (!ref->priv)
  147. goto fail_priv;
  148. return ref;
  149. fail_priv:
  150. ieee80211_rate_control_ops_put(ref->ops);
  151. fail_ops:
  152. kfree(ref);
  153. fail_ref:
  154. return NULL;
  155. }
  156. static void rate_control_free(struct rate_control_ref *ctrl_ref)
  157. {
  158. ctrl_ref->ops->free(ctrl_ref->priv);
  159. #ifdef CONFIG_MAC80211_DEBUGFS
  160. debugfs_remove_recursive(ctrl_ref->local->debugfs.rcdir);
  161. ctrl_ref->local->debugfs.rcdir = NULL;
  162. #endif
  163. ieee80211_rate_control_ops_put(ctrl_ref->ops);
  164. kfree(ctrl_ref);
  165. }
  166. static bool rc_no_data_or_no_ack_use_min(struct ieee80211_tx_rate_control *txrc)
  167. {
  168. struct sk_buff *skb = txrc->skb;
  169. struct ieee80211_hdr *hdr = (struct ieee80211_hdr *) skb->data;
  170. struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
  171. __le16 fc;
  172. fc = hdr->frame_control;
  173. return (info->flags & (IEEE80211_TX_CTL_NO_ACK |
  174. IEEE80211_TX_CTL_USE_MINRATE)) ||
  175. !ieee80211_is_data(fc);
  176. }
  177. static void rc_send_low_broadcast(s8 *idx, u32 basic_rates,
  178. struct ieee80211_supported_band *sband)
  179. {
  180. u8 i;
  181. if (basic_rates == 0)
  182. return; /* assume basic rates unknown and accept rate */
  183. if (*idx < 0)
  184. return;
  185. if (basic_rates & (1 << *idx))
  186. return; /* selected rate is a basic rate */
  187. for (i = *idx + 1; i <= sband->n_bitrates; i++) {
  188. if (basic_rates & (1 << i)) {
  189. *idx = i;
  190. return;
  191. }
  192. }
  193. /* could not find a basic rate; use original selection */
  194. }
  195. static inline s8
  196. rate_lowest_non_cck_index(struct ieee80211_supported_band *sband,
  197. struct ieee80211_sta *sta)
  198. {
  199. int i;
  200. for (i = 0; i < sband->n_bitrates; i++) {
  201. struct ieee80211_rate *srate = &sband->bitrates[i];
  202. if ((srate->bitrate == 10) || (srate->bitrate == 20) ||
  203. (srate->bitrate == 55) || (srate->bitrate == 110))
  204. continue;
  205. if (rate_supported(sta, sband->band, i))
  206. return i;
  207. }
  208. /* No matching rate found */
  209. return 0;
  210. }
  211. bool rate_control_send_low(struct ieee80211_sta *sta,
  212. void *priv_sta,
  213. struct ieee80211_tx_rate_control *txrc)
  214. {
  215. struct ieee80211_tx_info *info = IEEE80211_SKB_CB(txrc->skb);
  216. struct ieee80211_supported_band *sband = txrc->sband;
  217. int mcast_rate;
  218. if (!sta || !priv_sta || rc_no_data_or_no_ack_use_min(txrc)) {
  219. if ((sband->band != IEEE80211_BAND_2GHZ) ||
  220. !(info->flags & IEEE80211_TX_CTL_NO_CCK_RATE))
  221. info->control.rates[0].idx =
  222. rate_lowest_index(txrc->sband, sta);
  223. else
  224. info->control.rates[0].idx =
  225. rate_lowest_non_cck_index(txrc->sband, sta);
  226. info->control.rates[0].count =
  227. (info->flags & IEEE80211_TX_CTL_NO_ACK) ?
  228. 1 : txrc->hw->max_rate_tries;
  229. if (!sta && txrc->bss) {
  230. mcast_rate = txrc->bss_conf->mcast_rate[sband->band];
  231. if (mcast_rate > 0) {
  232. info->control.rates[0].idx = mcast_rate - 1;
  233. return true;
  234. }
  235. rc_send_low_broadcast(&info->control.rates[0].idx,
  236. txrc->bss_conf->basic_rates,
  237. sband);
  238. }
  239. return true;
  240. }
  241. return false;
  242. }
  243. EXPORT_SYMBOL(rate_control_send_low);
  244. static bool rate_idx_match_legacy_mask(struct ieee80211_tx_rate *rate,
  245. int n_bitrates, u32 mask)
  246. {
  247. int j;
  248. /* See whether the selected rate or anything below it is allowed. */
  249. for (j = rate->idx; j >= 0; j--) {
  250. if (mask & (1 << j)) {
  251. /* Okay, found a suitable rate. Use it. */
  252. rate->idx = j;
  253. return true;
  254. }
  255. }
  256. /* Try to find a higher rate that would be allowed */
  257. for (j = rate->idx + 1; j < n_bitrates; j++) {
  258. if (mask & (1 << j)) {
  259. /* Okay, found a suitable rate. Use it. */
  260. rate->idx = j;
  261. return true;
  262. }
  263. }
  264. return false;
  265. }
  266. static bool rate_idx_match_mcs_mask(struct ieee80211_tx_rate *rate,
  267. u8 mcs_mask[IEEE80211_HT_MCS_MASK_LEN])
  268. {
  269. int i, j;
  270. int ridx, rbit;
  271. ridx = rate->idx / 8;
  272. rbit = rate->idx % 8;
  273. /* sanity check */
  274. if (ridx < 0 || ridx >= IEEE80211_HT_MCS_MASK_LEN)
  275. return false;
  276. /* See whether the selected rate or anything below it is allowed. */
  277. for (i = ridx; i >= 0; i--) {
  278. for (j = rbit; j >= 0; j--)
  279. if (mcs_mask[i] & BIT(j)) {
  280. rate->idx = i * 8 + j;
  281. return true;
  282. }
  283. rbit = 7;
  284. }
  285. /* Try to find a higher rate that would be allowed */
  286. ridx = (rate->idx + 1) / 8;
  287. rbit = (rate->idx + 1) % 8;
  288. for (i = ridx; i < IEEE80211_HT_MCS_MASK_LEN; i++) {
  289. for (j = rbit; j < 8; j++)
  290. if (mcs_mask[i] & BIT(j)) {
  291. rate->idx = i * 8 + j;
  292. return true;
  293. }
  294. rbit = 0;
  295. }
  296. return false;
  297. }
  298. static void rate_idx_match_mask(struct ieee80211_tx_rate *rate,
  299. struct ieee80211_tx_rate_control *txrc,
  300. u32 mask,
  301. u8 mcs_mask[IEEE80211_HT_MCS_MASK_LEN])
  302. {
  303. struct ieee80211_tx_rate alt_rate;
  304. /* handle HT rates */
  305. if (rate->flags & IEEE80211_TX_RC_MCS) {
  306. if (rate_idx_match_mcs_mask(rate, mcs_mask))
  307. return;
  308. /* also try the legacy rates. */
  309. alt_rate.idx = 0;
  310. /* keep protection flags */
  311. alt_rate.flags = rate->flags &
  312. (IEEE80211_TX_RC_USE_RTS_CTS |
  313. IEEE80211_TX_RC_USE_CTS_PROTECT |
  314. IEEE80211_TX_RC_USE_SHORT_PREAMBLE);
  315. alt_rate.count = rate->count;
  316. if (rate_idx_match_legacy_mask(&alt_rate,
  317. txrc->sband->n_bitrates,
  318. mask)) {
  319. *rate = alt_rate;
  320. return;
  321. }
  322. } else {
  323. struct sk_buff *skb = txrc->skb;
  324. struct ieee80211_hdr *hdr = (struct ieee80211_hdr *) skb->data;
  325. __le16 fc;
  326. /* handle legacy rates */
  327. if (rate_idx_match_legacy_mask(rate, txrc->sband->n_bitrates,
  328. mask))
  329. return;
  330. /* if HT BSS, and we handle a data frame, also try HT rates */
  331. if (txrc->bss_conf->channel_type == NL80211_CHAN_NO_HT)
  332. return;
  333. fc = hdr->frame_control;
  334. if (!ieee80211_is_data(fc))
  335. return;
  336. alt_rate.idx = 0;
  337. /* keep protection flags */
  338. alt_rate.flags = rate->flags &
  339. (IEEE80211_TX_RC_USE_RTS_CTS |
  340. IEEE80211_TX_RC_USE_CTS_PROTECT |
  341. IEEE80211_TX_RC_USE_SHORT_PREAMBLE);
  342. alt_rate.count = rate->count;
  343. alt_rate.flags |= IEEE80211_TX_RC_MCS;
  344. if ((txrc->bss_conf->channel_type == NL80211_CHAN_HT40MINUS) ||
  345. (txrc->bss_conf->channel_type == NL80211_CHAN_HT40PLUS))
  346. alt_rate.flags |= IEEE80211_TX_RC_40_MHZ_WIDTH;
  347. if (rate_idx_match_mcs_mask(&alt_rate, mcs_mask)) {
  348. *rate = alt_rate;
  349. return;
  350. }
  351. }
  352. /*
  353. * Uh.. No suitable rate exists. This should not really happen with
  354. * sane TX rate mask configurations. However, should someone manage to
  355. * configure supported rates and TX rate mask in incompatible way,
  356. * allow the frame to be transmitted with whatever the rate control
  357. * selected.
  358. */
  359. }
  360. void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
  361. struct sta_info *sta,
  362. struct ieee80211_tx_rate_control *txrc)
  363. {
  364. struct rate_control_ref *ref = sdata->local->rate_ctrl;
  365. void *priv_sta = NULL;
  366. struct ieee80211_sta *ista = NULL;
  367. struct ieee80211_tx_info *info = IEEE80211_SKB_CB(txrc->skb);
  368. int i;
  369. u32 mask;
  370. u8 mcs_mask[IEEE80211_HT_MCS_MASK_LEN];
  371. if (sta && test_sta_flag(sta, WLAN_STA_RATE_CONTROL)) {
  372. ista = &sta->sta;
  373. priv_sta = sta->rate_ctrl_priv;
  374. }
  375. for (i = 0; i < IEEE80211_TX_MAX_RATES; i++) {
  376. info->control.rates[i].idx = -1;
  377. info->control.rates[i].flags = 0;
  378. info->control.rates[i].count = 0;
  379. }
  380. if (sdata->local->hw.flags & IEEE80211_HW_HAS_RATE_CONTROL)
  381. return;
  382. ref->ops->get_rate(ref->priv, ista, priv_sta, txrc);
  383. /*
  384. * Try to enforce the rateidx mask the user wanted. skip this if the
  385. * default mask (allow all rates) is used to save some processing for
  386. * the common case.
  387. */
  388. mask = sdata->rc_rateidx_mask[info->band];
  389. memcpy(mcs_mask, sdata->rc_rateidx_mcs_mask[info->band],
  390. sizeof(mcs_mask));
  391. if (mask != (1 << txrc->sband->n_bitrates) - 1) {
  392. if (sta) {
  393. /* Filter out rates that the STA does not support */
  394. mask &= sta->sta.supp_rates[info->band];
  395. for (i = 0; i < sizeof(mcs_mask); i++)
  396. mcs_mask[i] &= sta->sta.ht_cap.mcs.rx_mask[i];
  397. }
  398. /*
  399. * Make sure the rate index selected for each TX rate is
  400. * included in the configured mask and change the rate indexes
  401. * if needed.
  402. */
  403. for (i = 0; i < IEEE80211_TX_MAX_RATES; i++) {
  404. /* Skip invalid rates */
  405. if (info->control.rates[i].idx < 0)
  406. break;
  407. rate_idx_match_mask(&info->control.rates[i], txrc,
  408. mask, mcs_mask);
  409. }
  410. }
  411. BUG_ON(info->control.rates[0].idx < 0);
  412. }
  413. int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
  414. const char *name)
  415. {
  416. struct rate_control_ref *ref;
  417. ASSERT_RTNL();
  418. if (local->open_count)
  419. return -EBUSY;
  420. if (local->hw.flags & IEEE80211_HW_HAS_RATE_CONTROL) {
  421. if (WARN_ON(!local->ops->set_rts_threshold))
  422. return -EINVAL;
  423. return 0;
  424. }
  425. ref = rate_control_alloc(name, local);
  426. if (!ref) {
  427. wiphy_warn(local->hw.wiphy,
  428. "Failed to select rate control algorithm\n");
  429. return -ENOENT;
  430. }
  431. WARN_ON(local->rate_ctrl);
  432. local->rate_ctrl = ref;
  433. wiphy_debug(local->hw.wiphy, "Selected rate control algorithm '%s'\n",
  434. ref->ops->name);
  435. return 0;
  436. }
  437. void rate_control_deinitialize(struct ieee80211_local *local)
  438. {
  439. struct rate_control_ref *ref;
  440. ref = local->rate_ctrl;
  441. if (!ref)
  442. return;
  443. local->rate_ctrl = NULL;
  444. rate_control_free(ref);
  445. }