xref: /freebsd/sys/dev/ath/ath_rate/sample/sample.c (revision 262e143bd46171a6415a5b28af260a5efa2a3db8)
1 /*-
2  * Copyright (c) 2005 John Bicket
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer,
10  *    without modification.
11  * 2. Redistributions in binary form must reproduce at minimum a disclaimer
12  *    similar to the "NO WARRANTY" disclaimer below ("Disclaimer") and any
13  *    redistribution must be conditioned upon including a substantially
14  *    similar Disclaimer requirement for further binary redistribution.
15  * 3. Neither the names of the above-listed copyright holders nor the names
16  *    of any contributors may be used to endorse or promote products derived
17  *    from this software without specific prior written permission.
18  *
19  * Alternatively, this software may be distributed under the terms of the
20  * GNU General Public License ("GPL") version 2 as published by the Free
21  * Software Foundation.
22  *
23  * NO WARRANTY
24  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
25  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
26  * LIMITED TO, THE IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTIBILITY
27  * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
28  * THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR SPECIAL, EXEMPLARY,
29  * OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
30  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
31  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
32  * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
33  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF
34  * THE POSSIBILITY OF SUCH DAMAGES.
35  */
36 
37 #include <sys/cdefs.h>
38 __FBSDID("$FreeBSD$");
39 
40 /*
41  * John Bicket's SampleRate control algorithm.
42  */
43 #include "opt_inet.h"
44 
45 #include <sys/param.h>
46 #include <sys/systm.h>
47 #include <sys/sysctl.h>
48 #include <sys/module.h>
49 #include <sys/kernel.h>
50 #include <sys/lock.h>
51 #include <sys/mutex.h>
52 #include <sys/errno.h>
53 
54 #include <machine/bus.h>
55 #include <machine/resource.h>
56 #include <sys/bus.h>
57 
58 #include <sys/socket.h>
59 
60 #include <net/if.h>
61 #include <net/if_media.h>
62 #include <net/if_arp.h>
63 #include <net/ethernet.h>		/* XXX for ether_sprintf */
64 
65 #include <net80211/ieee80211_var.h>
66 
67 #include <net/bpf.h>
68 
69 #ifdef INET
70 #include <netinet/in.h>
71 #include <netinet/if_ether.h>
72 #endif
73 
74 #include <dev/ath/if_athvar.h>
75 #include <dev/ath/ath_rate/sample/sample.h>
76 #include <contrib/dev/ath/ah_desc.h>
77 
78 #define	SAMPLE_DEBUG
79 #ifdef SAMPLE_DEBUG
80 enum {
81 	ATH_DEBUG_RATE		= 0x00000010,	/* rate control */
82 };
83 #define	DPRINTF(sc, _fmt, ...) do {				\
84 	if (sc->sc_debug & ATH_DEBUG_RATE)			\
85 		printf(_fmt, __VA_ARGS__);			\
86 } while (0)
87 #else
88 #define	DPRINTF(sc, _fmt, ...)
89 #endif
90 
91 /*
92  * This file is an implementation of the SampleRate algorithm
93  * in "Bit-rate Selection in Wireless Networks"
94  * (http://www.pdos.lcs.mit.edu/papers/jbicket-ms.ps)
95  *
96  * SampleRate chooses the bit-rate it predicts will provide the most
97  * throughput based on estimates of the expected per-packet
98  * transmission time for each bit-rate.  SampleRate periodically sends
99  * packets at bit-rates other than the current one to estimate when
100  * another bit-rate will provide better performance. SampleRate
101  * switches to another bit-rate when its estimated per-packet
102  * transmission time becomes smaller than the current bit-rate's.
103  * SampleRate reduces the number of bit-rates it must sample by
104  * eliminating those that could not perform better than the one
105  * currently being used.  SampleRate also stops probing at a bit-rate
106  * if it experiences several successive losses.
107  *
108  * The difference between the algorithm in the thesis and the one in this
109  * file is that the one in this file uses a ewma instead of a window.
110  *
111  */
112 
113 #define STALE_FAILURE_TIMEOUT_MS 10000
114 
115 static void	ath_rate_ctl_reset(struct ath_softc *, struct ieee80211_node *);
116 
117 static __inline int size_to_bin(int size)
118 {
119 	int x = 0;
120 	for (x = 0; x < NUM_PACKET_SIZE_BINS; x++) {
121 		if (size <= packet_size_bins[x]) {
122 			return x;
123 		}
124 	}
125 	return NUM_PACKET_SIZE_BINS-1;
126 }
127 static __inline int bin_to_size(int index) {
128 	return packet_size_bins[index];
129 }
130 
131 static __inline int rate_to_ndx(struct sample_node *sn, int rate) {
132 	int x = 0;
133 	for (x = 0; x < sn->num_rates; x++) {
134 		if (sn->rates[x].rate == rate) {
135 			return x;
136 		}
137 	}
138 	return -1;
139 }
140 
141 /*
142  * Setup rate codes for management/control frames.  We force
143  * all such frames to the lowest rate.
144  */
145 static void
146 ath_rate_setmgtrates(struct ath_softc *sc, struct ath_node *an)
147 {
148 	const HAL_RATE_TABLE *rt = sc->sc_currates;
149 
150 	/* setup rates for management frames */
151 	/* XXX management/control frames always go at lowest speed */
152 	an->an_tx_mgtrate = rt->info[0].rateCode;
153 	an->an_tx_mgtratesp = an->an_tx_mgtrate
154 			    | rt->info[0].shortPreamble;
155 }
156 
157 void
158 ath_rate_node_init(struct ath_softc *sc, struct ath_node *an)
159 {
160 	DPRINTF(sc, "%s:\n", __func__);
161 	/* NB: assumed to be zero'd by caller */
162 	ath_rate_setmgtrates(sc, an);
163 }
164 
165 void
166 ath_rate_node_cleanup(struct ath_softc *sc, struct ath_node *an)
167 {
168 	DPRINTF(sc, "%s:\n", __func__);
169 }
170 
171 
172 /*
173  * returns the ndx with the lowest average_tx_time,
174  * or -1 if all the average_tx_times are 0.
175  */
176 static __inline int best_rate_ndx(struct sample_node *sn, int size_bin,
177 				  int require_acked_before)
178 {
179 	int x = 0;
180         int best_rate_ndx = 0;
181         int best_rate_tt = 0;
182         for (x = 0; x < sn->num_rates; x++) {
183 		int tt = sn->stats[size_bin][x].average_tx_time;
184 		if (tt <= 0 || (require_acked_before &&
185 				!sn->stats[size_bin][x].packets_acked)) {
186 			continue;
187 		}
188 		if (!best_rate_tt || best_rate_tt > tt) {
189 			best_rate_tt = tt;
190 			best_rate_ndx = x;
191 		}
192         }
193         return (best_rate_tt) ? best_rate_ndx : -1;
194 }
195 
196 /*
197  * pick a ndx s.t. the perfect_tx_time
198  * is less than the best bit-rate's average_tx_time
199  * and the ndx has not had four successive failures.
200  */
201 static __inline int pick_sample_ndx(struct sample_node *sn, int size_bin)
202 {
203 	int x = 0;
204 	int current_ndx = 0;
205 	unsigned current_tt = 0;
206 
207 	current_ndx = sn->current_rate[size_bin];
208 	if (current_ndx < 0) {
209 		/* no successes yet, send at the lowest bit-rate */
210 		return 0;
211 	}
212 
213 	current_tt = sn->stats[size_bin][current_ndx].average_tx_time;
214 
215 	for (x = 0; x < sn->num_rates; x++) {
216 		int ndx = (sn->last_sample_ndx[size_bin] + 1 + x) % sn->num_rates;
217 		/*
218 		 * clear any stale stuff out.
219 		 */
220 		if (ticks - sn->stats[size_bin][ndx].last_tx > ((hz * STALE_FAILURE_TIMEOUT_MS)/1000)) {
221 			sn->stats[size_bin][ndx].average_tx_time = sn->stats[size_bin][ndx].perfect_tx_time;
222 			sn->stats[size_bin][ndx].successive_failures = 0;
223 			sn->stats[size_bin][ndx].tries = 0;
224 			sn->stats[size_bin][ndx].total_packets = 0;
225 			sn->stats[size_bin][ndx].packets_acked = 0;
226 		}
227 
228 		if (ndx != current_ndx &&
229 		    sn->stats[size_bin][ndx].perfect_tx_time < current_tt &&
230 		    sn->stats[size_bin][ndx].successive_failures < 4) {
231 			sn->last_sample_ndx[size_bin] = ndx;
232 			return ndx;
233 		}
234 	}
235 	return current_ndx;
236 }
237 
238 void
239 ath_rate_findrate(struct ath_softc *sc, struct ath_node *an,
240 		  int shortPreamble, size_t frameLen,
241 		  u_int8_t *rix, int *try0, u_int8_t *txrate)
242 {
243 	struct sample_node *sn = ATH_NODE_SAMPLE(an);
244 	struct sample_softc *ssc = ATH_SOFTC_SAMPLE(sc);
245 	struct ieee80211com *ic = &sc->sc_ic;
246 	int ndx, size_bin, mrr, best_ndx;
247 	unsigned average_tx_time;
248 
249 	mrr = sc->sc_mrretry && !(ic->ic_flags & IEEE80211_F_USEPROT) &&
250 		!(frameLen > ic->ic_rtsthreshold);
251 	size_bin = size_to_bin(frameLen);
252 	best_ndx = best_rate_ndx(sn, size_bin, !mrr);
253 
254 	if (best_ndx >= 0) {
255 		average_tx_time = sn->stats[size_bin][best_ndx].average_tx_time;
256 	} else {
257 		average_tx_time = 0;
258 	}
259 	if (sn->static_rate_ndx != -1) {
260 		ndx = sn->static_rate_ndx;
261 		*try0 = ATH_TXMAXTRY;
262 	} else {
263 		ndx = 0;
264 		*try0 = mrr ? 2 : ATH_TXMAXTRY;
265 
266 		DPRINTF(sc, "%s: %s size %d mrr %d packets_sent %d best_ndx %d "
267 			"sample tt %d packets since %d\n"
268 			, __func__, ether_sprintf(an->an_node.ni_macaddr)
269 			, packet_size_bins[size_bin]
270 			, mrr
271 			, sn->packets_sent[size_bin]
272 			, best_ndx
273 			, sn->sample_tt[size_bin]
274 			, sn->packets_since_sample[size_bin]
275 		);
276 		if (!sn->packets_sent[size_bin]) {
277 			/* no packets sent */
278 			if (best_ndx == -1) {
279 				ndx = sn->num_rates - 1;
280 				if (sc->sc_curmode != IEEE80211_MODE_11B) {
281 					for (; ndx >= 0 && sn->rates[ndx].rate > 72; ndx--)
282 						;
283 
284 				}
285 			} else {
286 				ndx = best_ndx;
287 			}
288 		} else if (best_ndx == -1) {
289 			/* no packet has succeeded yet */
290 			if (mrr) {
291 				/*
292 				 * no packet has succeeded, try the
293 				 * highest bitrate that hasn't failed
294 				 */
295 				for (ndx = sn->num_rates-1; ndx >= 0; ndx--) {
296 					if (sn->stats[size_bin][ndx].successive_failures == 0) {
297 						break;
298 					}
299 				}
300 			} else {
301 				ndx = sn->num_rates - 1;
302 				if (sc->sc_curmode != IEEE80211_MODE_11B) {
303 					for (; ndx >= 0 && sn->rates[ndx].rate > 72; ndx--)
304 						;
305 
306 				}
307 			}
308 		} else if (sn->sample_tt[size_bin] < (sn->packets_since_sample[size_bin]*ssc->ath_sample_rate/100) * average_tx_time &&
309 			   sn->packets_since_sample[size_bin] > 15) {
310 			/*
311 			 * we want to limit the time measuring the performance
312 			 * of other bit-rates to ath_sample_rate% of the
313 			 * total transmission time.
314 			 */
315 			ndx = pick_sample_ndx(sn, size_bin);
316 			if (ndx != sn->current_rate[size_bin]) {
317 				DPRINTF(sc, "%s: %s size %d last sample tt %d sampling %d packets since %d\n",
318 					__func__,
319 					ether_sprintf(an->an_node.ni_macaddr),
320 					packet_size_bins[size_bin],
321 					sn->sample_tt[size_bin],
322 					sn->rates[ndx].rate,
323 					sn->packets_since_sample[size_bin]);
324 				sn->current_sample_ndx[size_bin] = ndx;
325 			} else {
326 				sn->current_sample_ndx[size_bin] = -1;
327 			}
328 			sn->packets_since_sample[size_bin] = 0;
329 
330 		} else {
331 			sn->packets_since_sample[size_bin]++;
332 			/*
333 			 * don't switch bit-rates every packet.  only
334 			 * switch during the first few packets we send
335 			 * or after 100 packets, or if the current
336 			 * bit-rate begins to perform twice as bad as
337 			 * another one.
338 			 */
339 			if (sn->packets_sent[size_bin] < 20 ||
340 			    ticks - ((hz*2000)/1000) > sn->jiffies_since_switch[size_bin] ||
341 			    average_tx_time * 2 < sn->stats[size_bin][sn->current_rate[size_bin]].average_tx_time ) {
342 				if (sn->packets_sent[size_bin] > 20) {
343 					DPRINTF(sc, "%s: %s size %d switch rate %d (%d/%d) -> %d (%d/%d) after %d packets mmr %d\n",
344 						__func__,
345 						ether_sprintf(an->an_node.ni_macaddr),
346 						packet_size_bins[size_bin],
347 						sn->rates[sn->current_rate[size_bin]].rate,
348 						sn->stats[size_bin][sn->current_rate[size_bin]].average_tx_time,
349 						sn->stats[size_bin][sn->current_rate[size_bin]].perfect_tx_time,
350 						sn->rates[best_ndx].rate,
351 						sn->stats[size_bin][best_ndx].average_tx_time,
352 						sn->stats[size_bin][best_ndx].perfect_tx_time,
353 						sn->packets_since_switch[size_bin],
354 						mrr);
355 				}
356 				sn->packets_since_switch[size_bin] = 0;
357 				sn->current_rate[size_bin] = best_ndx;
358 				sn->jiffies_since_switch[size_bin] = ticks;
359 			}
360 			ndx = sn->current_rate[size_bin];
361 			sn->packets_since_switch[size_bin]++;
362 		}
363 
364 	}
365 
366 	if (ndx < 0) {
367 		ndx = 0;
368 	}
369 	*rix = sn->rates[ndx].rix;
370 	if (shortPreamble) {
371 		*txrate = sn->rates[ndx].shortPreambleRateCode;
372 	} else {
373 		*txrate = sn->rates[ndx].rateCode;
374 	}
375 	sn->packets_sent[size_bin]++;
376 	an->an_node.ni_txrate = ndx;
377 }
378 
379 void
380 ath_rate_setupxtxdesc(struct ath_softc *sc, struct ath_node *an,
381 		      struct ath_desc *ds, int shortPreamble, u_int8_t rix)
382 {
383 	struct sample_node *sn = ATH_NODE_SAMPLE(an);
384 	int rateCode = -1;
385 	int frame_size, size_bin, best_ndx, ndx;
386 
387 	frame_size = ds->ds_ctl0 & 0x0fff; /* low-order 12 bits of ds_ctl0 */
388 	KASSERT(frame_size != 0, ("no frame size"));
389 	size_bin = size_to_bin(frame_size);
390 	best_ndx = best_rate_ndx(sn, size_bin, 0);
391 
392 	if (best_ndx == -1 || !sn->stats[size_bin][best_ndx].packets_acked) {
393 		/*
394 		 * no packet has succeeded, so also try at the
395 		 * lowest bitate.
396 		 */
397 		ndx = 0;
398 	} else {
399 		/*
400 		 * we're trying a different bit-rate, and it could be lossy,
401 		 * so if it fails try at the best bit-rate.
402 		 */
403 		ndx = best_ndx;
404 	}
405 	KASSERT(0 <= ndx && ndx < IEEE80211_RATE_MAXSIZE,
406 		("invalid ndx %d", ndx));
407 	if (shortPreamble) {
408 		rateCode = sn->rates[ndx].shortPreambleRateCode;
409 	} else {
410 		rateCode = sn->rates[ndx].rateCode;
411 	}
412 	ath_hal_setupxtxdesc(sc->sc_ah, ds
413 			     , rateCode, 3	        /* series 1 */
414 			     , sn->rates[0].rateCode, 3	/* series 2 */
415 			     , 0, 0	                /* series 3 */
416 			     );
417 }
418 
419 static void
420 update_stats(struct ath_softc *sc, struct ath_node *an,
421 		  int frame_size,
422 		  int ndx0, int tries0,
423 		  int ndx1, int tries1,
424 		  int ndx2, int tries2,
425 		  int ndx3, int tries3,
426 		  int short_tries, int tries, int status)
427 {
428 	struct sample_node *sn = ATH_NODE_SAMPLE(an);
429 	struct sample_softc *ssc = ATH_SOFTC_SAMPLE(sc);
430 	int tt = 0;
431 	int tries_so_far = 0;
432 	int size_bin = 0;
433 	int size = 0;
434 	int rate = 0;
435 
436 	size_bin = size_to_bin(frame_size);
437 	size = bin_to_size(size_bin);
438 	rate = sn->rates[ndx0].rate;
439 
440 	tt += calc_usecs_unicast_packet(sc, size, sn->rates[ndx0].rix,
441 					short_tries-1,
442 					MIN(tries0, tries) - 1);
443 	tries_so_far += tries0;
444 	if (tries1 && tries0 < tries) {
445 		tt += calc_usecs_unicast_packet(sc, size, sn->rates[ndx1].rix,
446 						short_tries-1,
447 						MIN(tries1 + tries_so_far, tries) - tries_so_far - 1);
448 	}
449 	tries_so_far += tries1;
450 
451 	if (tries2 && tries0 + tries1 < tries) {
452 		tt += calc_usecs_unicast_packet(sc, size, sn->rates[ndx2].rix,
453 					       short_tries-1,
454 						MIN(tries2 + tries_so_far, tries) - tries_so_far - 1);
455 	}
456 
457 	tries_so_far += tries2;
458 
459 	if (tries3 && tries0 + tries1 + tries2 < tries) {
460 		tt += calc_usecs_unicast_packet(sc, size, sn->rates[ndx3].rix,
461 						short_tries-1,
462 						MIN(tries3 + tries_so_far, tries) - tries_so_far - 1);
463 	}
464 #ifdef SAMPLE_DEBUG
465 	if (short_tries + tries > 3 || status) {
466 		DPRINTF(sc, "%s: %s size %d rate %d ndx %d tries (%d/%d) tries0 %d tt %d avg_tt %d perfect_tt %d status %d\n",
467 			__func__, ether_sprintf(an->an_node.ni_macaddr),
468 			size,
469 			rate, ndx0, short_tries, tries, tries0, tt,
470 			sn->stats[size_bin][ndx0].average_tx_time,
471 			sn->stats[size_bin][ndx0].perfect_tx_time,
472 			status);
473 	}
474 #endif /* SAMPLE_DEBUG */
475 	if (sn->stats[size_bin][ndx0].total_packets < (100 / (100 - ssc->ath_smoothing_rate))) {
476 		/* just average the first few packets */
477 		int avg_tx = sn->stats[size_bin][ndx0].average_tx_time;
478 		int packets = sn->stats[size_bin][ndx0].total_packets;
479 		sn->stats[size_bin][ndx0].average_tx_time = (tt+(avg_tx*packets))/(packets+1);
480 	} else {
481 		/* use a ewma */
482 		sn->stats[size_bin][ndx0].average_tx_time =
483 			((sn->stats[size_bin][ndx0].average_tx_time * ssc->ath_smoothing_rate) +
484 			 (tt * (100 - ssc->ath_smoothing_rate))) / 100;
485 	}
486 
487 	if (status) {
488 		/*
489 		 * this packet failed - count this as a failure
490 		 * for larger packets also, since we assume
491 		 * if a small packet fails at a lower bit-rate
492 		 * then a larger one will also.
493 		 */
494 		int y;
495 		for (y = size_bin; y < NUM_PACKET_SIZE_BINS; y++) {
496 			sn->stats[y][ndx0].successive_failures++;
497 			sn->stats[y][ndx0].last_tx = ticks;
498 		}
499 	} else {
500 		sn->stats[size_bin][ndx0].packets_acked++;
501 		sn->stats[size_bin][ndx0].successive_failures = 0;
502 	}
503 	sn->stats[size_bin][ndx0].tries += tries;
504 	sn->stats[size_bin][ndx0].last_tx = ticks;
505 	sn->stats[size_bin][ndx0].total_packets++;
506 
507 
508 	if (ndx0 == sn->current_sample_ndx[size_bin]) {
509 		DPRINTF(sc, "%s: %s size %d sample rate %d tries (%d/%d) tt %d avg_tt (%d/%d) status %d\n",
510 			__func__, ether_sprintf(an->an_node.ni_macaddr),
511 			size, rate, short_tries, tries, tt,
512 			sn->stats[size_bin][ndx0].average_tx_time,
513 			sn->stats[size_bin][ndx0].perfect_tx_time,
514 			status);
515 		sn->sample_tt[size_bin] = tt;
516 		sn->current_sample_ndx[size_bin] = -1;
517 	}
518 }
519 
520 void
521 ath_rate_tx_complete(struct ath_softc *sc, struct ath_node *an,
522 	const struct ath_desc *ds, const struct ath_desc *ds0)
523 {
524 	struct sample_node *sn = ATH_NODE_SAMPLE(an);
525 	const struct ar5212_desc *ads = (const struct ar5212_desc *)&ds->ds_ctl0;
526 	int final_rate, short_tries, long_tries, frame_size;
527 	int ndx = -1;
528 
529 	final_rate = sc->sc_hwmap[ds->ds_txstat.ts_rate &~ HAL_TXSTAT_ALTRATE].ieeerate;
530 	short_tries = ds->ds_txstat.ts_shortretry + 1;
531 	long_tries = ds->ds_txstat.ts_longretry + 1;
532 	frame_size = ds0->ds_ctl0 & 0x0fff; /* low-order 12 bits of ds_ctl0 */
533 	if (frame_size == 0)		    /* NB: should not happen */
534 		frame_size = 1500;
535 
536 	if (sn->num_rates <= 0) {
537 		DPRINTF(sc, "%s: %s size %d status %d rate/try %d/%d "
538 			"no rates yet\n",
539 			__func__, ether_sprintf(an->an_node.ni_macaddr),
540 			bin_to_size(size_to_bin(frame_size)),
541 			ds->ds_txstat.ts_status,
542 			short_tries, long_tries);
543 		return;
544 	}
545 
546 	if (sc->sc_mrretry && ds->ds_txstat.ts_status) {
547 		/* this packet failed */
548 		DPRINTF(sc, "%s: %s size %d rate/try %d/%d %d/%d %d/%d %d/%d status %s retries (%d/%d)\n",
549 			__func__,
550 			ether_sprintf(an->an_node.ni_macaddr),
551 			bin_to_size(size_to_bin(frame_size)),
552 			sc->sc_hwmap[ads->xmit_rate0].ieeerate,
553 				ads->xmit_tries0,
554 			sc->sc_hwmap[ads->xmit_rate1].ieeerate,
555 				ads->xmit_tries1,
556 			sc->sc_hwmap[ads->xmit_rate2].ieeerate,
557 				ads->xmit_tries2,
558 			sc->sc_hwmap[ads->xmit_rate3].ieeerate,
559 				ads->xmit_tries3,
560 			ds->ds_txstat.ts_status ? "FAIL" : "OK",
561 			short_tries,
562 			long_tries);
563 	}
564 
565 	if (!(ds->ds_txstat.ts_rate & HAL_TXSTAT_ALTRATE)) {
566 		/* only one rate was used */
567 		ndx = rate_to_ndx(sn, final_rate);
568 		DPRINTF(sc, "%s: %s size %d status %d rate/try %d/%d/%d\n",
569 			__func__, ether_sprintf(an->an_node.ni_macaddr),
570 			bin_to_size(size_to_bin(frame_size)),
571 			ds->ds_txstat.ts_status,
572 			ndx, short_tries, long_tries);
573 		if (ndx >= 0 && ndx < sn->num_rates) {
574 			update_stats(sc, an, frame_size,
575 				     ndx, long_tries,
576 				     0, 0,
577 				     0, 0,
578 				     0, 0,
579 				     short_tries, long_tries, ds->ds_txstat.ts_status);
580 		}
581 	} else {
582 		int rate0, tries0, ndx0;
583 		int rate1, tries1, ndx1;
584 		int rate2, tries2, ndx2;
585 		int rate3, tries3, ndx3;
586 		int finalTSIdx = ads->final_ts_index;
587 
588 		/*
589 		 * Process intermediate rates that failed.
590 		 */
591 
592 		rate0 = sc->sc_hwmap[ads->xmit_rate0].ieeerate;
593 		tries0 = ads->xmit_tries0;
594 		ndx0 = rate_to_ndx(sn, rate0);
595 
596 		rate1 = sc->sc_hwmap[ads->xmit_rate1].ieeerate;
597 		tries1 = ads->xmit_tries1;
598 		ndx1 = rate_to_ndx(sn, rate1);
599 
600 		rate2 = sc->sc_hwmap[ads->xmit_rate2].ieeerate;
601 		tries2 = ads->xmit_tries2;
602 		ndx2 = rate_to_ndx(sn, rate2);
603 
604 		rate3 = sc->sc_hwmap[ads->xmit_rate3].ieeerate;
605 		tries3 = ads->xmit_tries3;
606 		ndx3 = rate_to_ndx(sn, rate3);
607 
608 #if 1
609 		DPRINTF(sc, "%s: %s size %d finaltsidx %d tries %d status %d rate/try %d/%d %d/%d %d/%d %d/%d\n",
610 			__func__, ether_sprintf(an->an_node.ni_macaddr),
611 			bin_to_size(size_to_bin(frame_size)),
612 			finalTSIdx,
613 			long_tries,
614 			ds->ds_txstat.ts_status,
615 			rate0, tries0,
616 			rate1, tries1,
617 			rate2, tries2,
618 			rate3, tries3);
619 #endif
620 
621 		if (tries0) {
622 			update_stats(sc, an, frame_size,
623 				     ndx0, tries0,
624 				     ndx1, tries1,
625 				     ndx2, tries2,
626 				     ndx3, tries3,
627 				     short_tries, ds->ds_txstat.ts_longretry + 1,
628 				     ds->ds_txstat.ts_status);
629 		}
630 
631 		if (tries1 && finalTSIdx > 0) {
632 			update_stats(sc, an, frame_size,
633 				     ndx1, tries1,
634 				     ndx2, tries2,
635 				     ndx3, tries3,
636 				     0, 0,
637 				     short_tries, ds->ds_txstat.ts_longretry + 1 - tries0,
638 				     ds->ds_txstat.ts_status);
639 		}
640 
641 		if (tries2 && finalTSIdx > 1) {
642 			update_stats(sc, an, frame_size,
643 				     ndx2, tries2,
644 				     ndx3, tries3,
645 				     0, 0,
646 				     0, 0,
647 				     short_tries, ds->ds_txstat.ts_longretry + 1 - tries0 - tries1,
648 				     ds->ds_txstat.ts_status);
649 		}
650 
651 		if (tries3 && finalTSIdx > 2) {
652 			update_stats(sc, an, frame_size,
653 				     ndx3, tries3,
654 				     0, 0,
655 				     0, 0,
656 				     0, 0,
657 				     short_tries, ds->ds_txstat.ts_longretry + 1 - tries0 - tries1 - tries2,
658 				     ds->ds_txstat.ts_status);
659 		}
660 	}
661 }
662 
663 void
664 ath_rate_newassoc(struct ath_softc *sc, struct ath_node *an, int isnew)
665 {
666 	DPRINTF(sc, "%s: %s isnew %d\n", __func__,
667 		ether_sprintf(an->an_node.ni_macaddr), isnew);
668 	if (isnew)
669 		ath_rate_ctl_reset(sc, &an->an_node);
670 }
671 
672 /*
673  * Initialize the tables for a node.
674  */
675 static void
676 ath_rate_ctl_reset(struct ath_softc *sc, struct ieee80211_node *ni)
677 {
678 #define	RATE(_ix)	(ni->ni_rates.rs_rates[(_ix)] & IEEE80211_RATE_VAL)
679 	struct ieee80211com *ic = &sc->sc_ic;
680 	struct ath_node *an = ATH_NODE(ni);
681 	struct sample_node *sn = ATH_NODE_SAMPLE(an);
682 	const HAL_RATE_TABLE *rt = sc->sc_currates;
683 	int x, y, srate;
684 
685 	KASSERT(rt != NULL, ("no rate table, mode %u", sc->sc_curmode));
686         sn->static_rate_ndx = -1;
687 	if (ic->ic_fixed_rate != IEEE80211_FIXED_RATE_NONE) {
688 		/*
689 		 * A fixed rate is to be used; ic_fixed_rate is an
690 		 * index into the supported rate set.  Convert this
691 		 * to the index into the negotiated rate set for
692 		 * the node.  We know the rate is there because the
693 		 * rate set is checked when the station associates.
694 		 */
695 		const struct ieee80211_rateset *rs =
696 			&ic->ic_sup_rates[ic->ic_curmode];
697 		int r = rs->rs_rates[ic->ic_fixed_rate] & IEEE80211_RATE_VAL;
698 		/* NB: the rate set is assumed sorted */
699 		srate = ni->ni_rates.rs_nrates - 1;
700 		for (; srate >= 0 && RATE(srate) != r; srate--)
701 			;
702 		KASSERT(srate >= 0,
703 			("fixed rate %d not in rate set", ic->ic_fixed_rate));
704                 sn->static_rate_ndx = srate;
705 	}
706 
707         DPRINTF(sc, "%s: %s size 1600 rate/tt", __func__, ether_sprintf(ni->ni_macaddr));
708 
709 	sn->num_rates = ni->ni_rates.rs_nrates;
710         for (x = 0; x < ni->ni_rates.rs_nrates; x++) {
711 		sn->rates[x].rate = ni->ni_rates.rs_rates[x] & IEEE80211_RATE_VAL;
712 		sn->rates[x].rix = sc->sc_rixmap[sn->rates[x].rate];
713 		if (sn->rates[x].rix == 0xff) {
714 			DPRINTF(sc, "%s: ignore bogus rix at %d\n",
715 				__func__, x);
716 			continue;
717 		}
718 		sn->rates[x].rateCode = rt->info[sn->rates[x].rix].rateCode;
719 		sn->rates[x].shortPreambleRateCode =
720 			rt->info[sn->rates[x].rix].rateCode |
721 			rt->info[sn->rates[x].rix].shortPreamble;
722 
723 		DPRINTF(sc, " %d/%d", sn->rates[x].rate,
724 			calc_usecs_unicast_packet(sc, 1600, sn->rates[x].rix,
725 						  0,0));
726 	}
727 	DPRINTF(sc, "%s\n", "");
728 
729 	/* set the visible bit-rate to the lowest one available */
730 	ni->ni_txrate = 0;
731 	sn->num_rates = ni->ni_rates.rs_nrates;
732 
733 	for (y = 0; y < NUM_PACKET_SIZE_BINS; y++) {
734 		int size = bin_to_size(y);
735 		sn->packets_sent[y] = 0;
736 		sn->current_sample_ndx[y] = -1;
737 		sn->last_sample_ndx[y] = 0;
738 
739 		for (x = 0; x < ni->ni_rates.rs_nrates; x++) {
740 			sn->stats[y][x].successive_failures = 0;
741 			sn->stats[y][x].tries = 0;
742 			sn->stats[y][x].total_packets = 0;
743 			sn->stats[y][x].packets_acked = 0;
744 			sn->stats[y][x].last_tx = 0;
745 
746 			sn->stats[y][x].perfect_tx_time =
747 				calc_usecs_unicast_packet(sc, size,
748 							  sn->rates[x].rix,
749 							  0, 0);
750 			sn->stats[y][x].average_tx_time = sn->stats[y][x].perfect_tx_time;
751 		}
752 	}
753 #undef RATE
754 }
755 
756 static void
757 rate_cb(void *arg, struct ieee80211_node *ni)
758 {
759 	struct ath_softc *sc = arg;
760 
761 	ath_rate_newassoc(sc, ATH_NODE(ni), 1);
762 }
763 
764 /*
765  * Reset the rate control state for each 802.11 state transition.
766  */
767 void
768 ath_rate_newstate(struct ath_softc *sc, enum ieee80211_state state)
769 {
770 	struct ieee80211com *ic = &sc->sc_ic;
771 
772 	if (state == IEEE80211_S_RUN) {
773 		if (ic->ic_opmode != IEEE80211_M_STA) {
774 			/*
775 			 * Sync rates for associated stations and neighbors.
776 			 */
777 			ieee80211_iterate_nodes(&ic->ic_sta, rate_cb, sc);
778 		}
779 		ath_rate_newassoc(sc, ATH_NODE(ic->ic_bss), 1);
780 	}
781 }
782 
783 static void
784 ath_rate_sysctlattach(struct ath_softc *sc, struct sample_softc *osc)
785 {
786 	struct sysctl_ctx_list *ctx = device_get_sysctl_ctx(sc->sc_dev);
787 	struct sysctl_oid *tree = device_get_sysctl_tree(sc->sc_dev);
788 
789 	/* XXX bounds check [0..100] */
790 	SYSCTL_ADD_INT(ctx, SYSCTL_CHILDREN(tree), OID_AUTO,
791 		"smoothing_rate", CTLFLAG_RW, &osc->ath_smoothing_rate, 0,
792 		"rate control: retry threshold to credit rate raise (%%)");
793 	/* XXX bounds check [2..100] */
794 	SYSCTL_ADD_INT(ctx, SYSCTL_CHILDREN(tree), OID_AUTO,
795 		"sample_rate", CTLFLAG_RW, &osc->ath_sample_rate,0,
796 		"rate control: # good periods before raising rate");
797 }
798 
799 struct ath_ratectrl *
800 ath_rate_attach(struct ath_softc *sc)
801 {
802 	struct sample_softc *osc;
803 
804 	DPRINTF(sc, "%s:\n", __func__);
805 	osc = malloc(sizeof(struct sample_softc), M_DEVBUF, M_NOWAIT|M_ZERO);
806 	if (osc == NULL)
807 		return NULL;
808 	osc->arc.arc_space = sizeof(struct sample_node);
809 	osc->ath_smoothing_rate = 95;	/* ewma percentage (out of 100) */
810 	osc->ath_sample_rate = 10;	/* send a different bit-rate 1/X packets */
811 	ath_rate_sysctlattach(sc, osc);
812 	return &osc->arc;
813 }
814 
815 void
816 ath_rate_detach(struct ath_ratectrl *arc)
817 {
818 	struct sample_softc *osc = (struct sample_softc *) arc;
819 
820 	free(osc, M_DEVBUF);
821 }
822 
823 /*
824  * Module glue.
825  */
826 static int
827 sample_modevent(module_t mod, int type, void *unused)
828 {
829 	switch (type) {
830 	case MOD_LOAD:
831 		if (bootverbose)
832 			printf("ath_rate: version 1.2 <SampleRate bit-rate selection algorithm>\n");
833 		return 0;
834 	case MOD_UNLOAD:
835 		return 0;
836 	}
837 	return EINVAL;
838 }
839 
840 static moduledata_t sample_mod = {
841 	"ath_rate",
842 	sample_modevent,
843 	0
844 };
845 DECLARE_MODULE(ath_rate, sample_mod, SI_SUB_DRIVERS, SI_ORDER_FIRST);
846 MODULE_VERSION(ath_rate, 1);
847 MODULE_DEPEND(ath_rate, ath_hal, 1, 1, 1);	/* Atheros HAL */
848 MODULE_DEPEND(ath_rate, wlan, 1, 1, 1);
849