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