Return to ieee80211_rssadapt.h CVS log

Up to [local] / sys / net80211

Annotation of sys/net80211/ieee80211_rssadapt.h, Revision 1.1.1.1

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