ieee80211_rssadapt.h revision 1.3.2.4 1 1.3.2.4 skrll /* $NetBSD: ieee80211_rssadapt.h,v 1.3.2.4 2004/09/21 13:36:55 skrll Exp $ */
2 1.3.2.2 skrll /*-
3 1.3.2.2 skrll * Copyright (c) 2003, 2004 David Young. All rights reserved.
4 1.3.2.2 skrll *
5 1.3.2.2 skrll * Redistribution and use in source and binary forms, with or
6 1.3.2.2 skrll * without modification, are permitted provided that the following
7 1.3.2.2 skrll * conditions are met:
8 1.3.2.2 skrll * 1. Redistributions of source code must retain the above copyright
9 1.3.2.2 skrll * notice, this list of conditions and the following disclaimer.
10 1.3.2.2 skrll * 2. Redistributions in binary form must reproduce the above
11 1.3.2.2 skrll * copyright notice, this list of conditions and the following
12 1.3.2.2 skrll * disclaimer in the documentation and/or other materials provided
13 1.3.2.2 skrll * with the distribution.
14 1.3.2.2 skrll * 3. The name of David Young may not be used to endorse or promote
15 1.3.2.2 skrll * products derived from this software without specific prior
16 1.3.2.2 skrll * written permission.
17 1.3.2.2 skrll *
18 1.3.2.2 skrll * THIS SOFTWARE IS PROVIDED BY David Young ``AS IS'' AND ANY
19 1.3.2.2 skrll * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
20 1.3.2.2 skrll * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
21 1.3.2.2 skrll * PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL David
22 1.3.2.2 skrll * Young BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
23 1.3.2.2 skrll * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
24 1.3.2.2 skrll * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
25 1.3.2.2 skrll * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
26 1.3.2.2 skrll * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
27 1.3.2.2 skrll * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 1.3.2.2 skrll * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY
29 1.3.2.2 skrll * OF SUCH DAMAGE.
30 1.3.2.2 skrll */
31 1.3.2.2 skrll
32 1.3.2.2 skrll /* Data-rate adaptation loosely based on "Link Adaptation Strategy
33 1.3.2.2 skrll * for IEEE 802.11 WLAN via Received Signal Strength Measurement"
34 1.3.2.2 skrll * by Javier del Prado Pavon and Sunghyun Choi.
35 1.3.2.2 skrll */
36 1.3.2.2 skrll
37 1.3.2.2 skrll /* Buckets for frames 0-128 bytes long, 129-1024, 1025-maximum. */
38 1.3.2.2 skrll #define IEEE80211_RSSADAPT_BKTS 3
39 1.3.2.2 skrll #define IEEE80211_RSSADAPT_BKT0 128
40 1.3.2.2 skrll #define IEEE80211_RSSADAPT_BKTPOWER 3 /* 2**_BKTPOWER */
41 1.3.2.2 skrll
42 1.3.2.2 skrll #define ieee80211_rssadapt_thresh_new \
43 1.3.2.2 skrll (ieee80211_rssadapt_thresh_denom - ieee80211_rssadapt_thresh_old)
44 1.3.2.2 skrll #define ieee80211_rssadapt_decay_new \
45 1.3.2.2 skrll (ieee80211_rssadapt_decay_denom - ieee80211_rssadapt_decay_old)
46 1.3.2.2 skrll #define ieee80211_rssadapt_avgrssi_new \
47 1.3.2.2 skrll (ieee80211_rssadapt_avgrssi_denom - ieee80211_rssadapt_avgrssi_old)
48 1.3.2.2 skrll
49 1.3.2.2 skrll struct ieee80211_rssadapt_expavgctl {
50 1.3.2.2 skrll /* RSS threshold decay. */
51 1.3.2.2 skrll u_int rc_decay_denom;
52 1.3.2.2 skrll u_int rc_decay_old;
53 1.3.2.2 skrll /* RSS threshold update. */
54 1.3.2.2 skrll u_int rc_thresh_denom;
55 1.3.2.2 skrll u_int rc_thresh_old;
56 1.3.2.2 skrll /* RSS average update. */
57 1.3.2.2 skrll u_int rc_avgrssi_denom;
58 1.3.2.2 skrll u_int rc_avgrssi_old;
59 1.3.2.2 skrll };
60 1.3.2.2 skrll
61 1.3.2.2 skrll struct ieee80211_rssadapt {
62 1.3.2.2 skrll /* exponential average RSSI << 8 */
63 1.3.2.2 skrll u_int16_t ra_avg_rssi;
64 1.3.2.2 skrll /* Tx failures in this update interval */
65 1.3.2.2 skrll u_int32_t ra_nfail;
66 1.3.2.2 skrll /* Tx successes in this update interval */
67 1.3.2.2 skrll u_int32_t ra_nok;
68 1.3.2.2 skrll /* exponential average packets/second */
69 1.3.2.2 skrll u_int32_t ra_pktrate;
70 1.3.2.2 skrll /* RSSI threshold for each Tx rate */
71 1.3.2.2 skrll u_int16_t ra_rate_thresh[IEEE80211_RSSADAPT_BKTS]
72 1.3.2.2 skrll [IEEE80211_RATE_SIZE];
73 1.3.2.2 skrll struct timeval ra_last_raise;
74 1.3.2.2 skrll struct timeval ra_raise_interval;
75 1.3.2.2 skrll };
76 1.3.2.2 skrll
77 1.3.2.2 skrll /* Properties of a Tx packet, for link adaptation. */
78 1.3.2.2 skrll struct ieee80211_rssdesc {
79 1.3.2.2 skrll u_int id_len; /* Tx packet length */
80 1.3.2.2 skrll u_int id_rateidx; /* index into ni->ni_rates */
81 1.3.2.2 skrll struct ieee80211_node *id_node; /* destination STA MAC */
82 1.3.2.2 skrll u_int8_t id_rssi; /* destination STA avg RSS @
83 1.3.2.2 skrll * Tx time
84 1.3.2.2 skrll */
85 1.3.2.2 skrll };
86 1.3.2.2 skrll
87 1.3.2.2 skrll void ieee80211_rssadapt_updatestats(struct ieee80211_rssadapt *);
88 1.3.2.2 skrll void ieee80211_rssadapt_input(struct ieee80211com *, struct ieee80211_node *,
89 1.3.2.2 skrll struct ieee80211_rssadapt *, int);
90 1.3.2.2 skrll void ieee80211_rssadapt_lower_rate(struct ieee80211com *,
91 1.3.2.2 skrll struct ieee80211_node *, struct ieee80211_rssadapt *,
92 1.3.2.2 skrll struct ieee80211_rssdesc *);
93 1.3.2.2 skrll void ieee80211_rssadapt_raise_rate(struct ieee80211com *,
94 1.3.2.2 skrll struct ieee80211_rssadapt *, struct ieee80211_rssdesc *);
95 1.3.2.2 skrll int ieee80211_rssadapt_choose(struct ieee80211_rssadapt *,
96 1.3.2.2 skrll struct ieee80211_rateset *, struct ieee80211_frame *, u_int, int,
97 1.3.2.2 skrll const char *, int);
98 1.3.2.2 skrll #ifdef IEEE80211_DEBUG
99 1.3.2.2 skrll extern int ieee80211_rssadapt_debug;
100 1.3.2.2 skrll #endif /* IEEE80211_DEBUG */
101