xref: /freebsd/sys/net80211/ieee80211_rssadapt.h (revision 4f52dfbb)
1 /*	$FreeBSD$	*/
2 /* $NetBSD: ieee80211_rssadapt.h,v 1.4 2005/02/26 22:45:09 perry Exp $ */
3 /*-
4  * SPDX-License-Identifier: BSD-3-Clause
5  *
6  * Copyright (c) 2003, 2004 David Young.  All rights reserved.
7  *
8  * Redistribution and use in source and binary forms, with or
9  * without modification, are permitted provided that the following
10  * conditions are met:
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  * 2. Redistributions in binary form must reproduce the above
14  *    copyright notice, this list of conditions and the following
15  *    disclaimer in the documentation and/or other materials provided
16  *    with the distribution.
17  * 3. The name of David Young may not be used to endorse or promote
18  *    products derived from this software without specific prior
19  *    written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY David Young ``AS IS'' AND ANY
22  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
23  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
24  * PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL David
25  * Young BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
26  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
27  * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
29  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
30  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
32  * OF SUCH DAMAGE.
33  */
34 #ifndef _NET80211_IEEE80211_RSSADAPT_H_
35 #define _NET80211_IEEE80211_RSSADAPT_H_
36 
37 /* Data-rate adaptation loosely based on "Link Adaptation Strategy
38  * for IEEE 802.11 WLAN via Received Signal Strength Measurement"
39  * by Javier del Prado Pavon and Sunghyun Choi.
40  */
41 
42 /* Buckets for frames 0-128 bytes long, 129-1024, 1025-maximum. */
43 #define	IEEE80211_RSSADAPT_BKTS		3
44 #define IEEE80211_RSSADAPT_BKT0		128
45 #define	IEEE80211_RSSADAPT_BKTPOWER	3	/* 2**_BKTPOWER */
46 
47 struct ieee80211_rssadapt {
48 	const struct ieee80211vap *vap;
49 	int	interval;			/* update interval (ticks) */
50 };
51 
52 struct ieee80211_rssadapt_node {
53 	struct ieee80211_rssadapt *ra_rs;	/* backpointer */
54 	struct ieee80211_rateset ra_rates;	/* negotiated rates */
55 	int	ra_rix;				/* current rate index */
56 	int	ra_ticks;			/* time of last update */
57 	int	ra_last_raise;			/* time of last rate raise */
58 	int	ra_raise_interval;		/* rate raise time threshold */
59 
60 	/* Tx failures in this update interval */
61 	uint32_t		ra_nfail;
62 	/* Tx successes in this update interval */
63 	uint32_t		ra_nok;
64 	/* exponential average packets/second */
65 	uint32_t		ra_pktrate;
66 	/* RSSI threshold for each Tx rate */
67 	uint16_t		ra_rate_thresh[IEEE80211_RSSADAPT_BKTS]
68 					      [IEEE80211_RATE_SIZE];
69 };
70 
71 #define	IEEE80211_RSSADAPT_SUCCESS	1
72 #define	IEEE80211_RSSADAPT_FAILURE	0
73 #endif /* _NET80211_IEEE80211_RSSADAPT_H_ */
74