Home | History | Annotate | Line # | Download | only in net80211
ieee80211_rssadapt.h revision 1.3.2.6
      1  1.3.2.6  christos /* $NetBSD: ieee80211_rssadapt.h,v 1.3.2.6 2005/12/11 10:29:22 christos 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.6  christos #ifndef _NET80211_IEEE80211_RSSADAPT_H_
     33  1.3.2.6  christos #define _NET80211_IEEE80211_RSSADAPT_H_
     34  1.3.2.6  christos 
     35  1.3.2.2     skrll /* Data-rate adaptation loosely based on "Link Adaptation Strategy
     36  1.3.2.2     skrll  * for IEEE 802.11 WLAN via Received Signal Strength Measurement"
     37  1.3.2.2     skrll  * by Javier del Prado Pavon and Sunghyun Choi.
     38  1.3.2.5     skrll  */
     39  1.3.2.2     skrll 
     40  1.3.2.2     skrll /* Buckets for frames 0-128 bytes long, 129-1024, 1025-maximum. */
     41  1.3.2.2     skrll #define	IEEE80211_RSSADAPT_BKTS		3
     42  1.3.2.2     skrll #define IEEE80211_RSSADAPT_BKT0		128
     43  1.3.2.5     skrll #define	IEEE80211_RSSADAPT_BKTPOWER	3	/* 2**_BKTPOWER */
     44  1.3.2.2     skrll 
     45  1.3.2.2     skrll #define	ieee80211_rssadapt_thresh_new \
     46  1.3.2.2     skrll     (ieee80211_rssadapt_thresh_denom - ieee80211_rssadapt_thresh_old)
     47  1.3.2.2     skrll #define	ieee80211_rssadapt_decay_new \
     48  1.3.2.2     skrll     (ieee80211_rssadapt_decay_denom - ieee80211_rssadapt_decay_old)
     49  1.3.2.2     skrll #define	ieee80211_rssadapt_avgrssi_new \
     50  1.3.2.2     skrll     (ieee80211_rssadapt_avgrssi_denom - ieee80211_rssadapt_avgrssi_old)
     51  1.3.2.2     skrll 
     52  1.3.2.2     skrll struct ieee80211_rssadapt_expavgctl {
     53  1.3.2.2     skrll 	/* RSS threshold decay. */
     54  1.3.2.2     skrll 	u_int rc_decay_denom;
     55  1.3.2.2     skrll 	u_int rc_decay_old;
     56  1.3.2.2     skrll 	/* RSS threshold update. */
     57  1.3.2.2     skrll 	u_int rc_thresh_denom;
     58  1.3.2.2     skrll 	u_int rc_thresh_old;
     59  1.3.2.2     skrll 	/* RSS average update. */
     60  1.3.2.2     skrll 	u_int rc_avgrssi_denom;
     61  1.3.2.2     skrll 	u_int rc_avgrssi_old;
     62  1.3.2.2     skrll };
     63  1.3.2.2     skrll 
     64  1.3.2.2     skrll struct ieee80211_rssadapt {
     65  1.3.2.2     skrll 	/* exponential average RSSI << 8 */
     66  1.3.2.2     skrll 	u_int16_t		ra_avg_rssi;
     67  1.3.2.2     skrll 	/* Tx failures in this update interval */
     68  1.3.2.2     skrll 	u_int32_t		ra_nfail;
     69  1.3.2.2     skrll 	/* Tx successes in this update interval */
     70  1.3.2.2     skrll 	u_int32_t		ra_nok;
     71  1.3.2.2     skrll 	/* exponential average packets/second */
     72  1.3.2.2     skrll 	u_int32_t		ra_pktrate;
     73  1.3.2.2     skrll 	/* RSSI threshold for each Tx rate */
     74  1.3.2.2     skrll 	u_int16_t		ra_rate_thresh[IEEE80211_RSSADAPT_BKTS]
     75  1.3.2.2     skrll 					      [IEEE80211_RATE_SIZE];
     76  1.3.2.2     skrll 	struct timeval		ra_last_raise;
     77  1.3.2.2     skrll 	struct timeval		ra_raise_interval;
     78  1.3.2.2     skrll };
     79  1.3.2.2     skrll 
     80  1.3.2.5     skrll /* Properties of a Tx packet, for link adaptation. */
     81  1.3.2.2     skrll struct ieee80211_rssdesc {
     82  1.3.2.2     skrll 	u_int			 id_len;	/* Tx packet length */
     83  1.3.2.2     skrll 	u_int			 id_rateidx;	/* index into ni->ni_rates */
     84  1.3.2.2     skrll 	struct ieee80211_node	*id_node;	/* destination STA MAC */
     85  1.3.2.2     skrll 	u_int8_t		 id_rssi;	/* destination STA avg RSS @
     86  1.3.2.2     skrll 						 * Tx time
     87  1.3.2.2     skrll 						 */
     88  1.3.2.2     skrll };
     89  1.3.2.2     skrll 
     90  1.3.2.2     skrll void	ieee80211_rssadapt_updatestats(struct ieee80211_rssadapt *);
     91  1.3.2.2     skrll void	ieee80211_rssadapt_input(struct ieee80211com *, struct ieee80211_node *,
     92  1.3.2.2     skrll 	    struct ieee80211_rssadapt *, int);
     93  1.3.2.2     skrll void	ieee80211_rssadapt_lower_rate(struct ieee80211com *,
     94  1.3.2.2     skrll 	    struct ieee80211_node *, struct ieee80211_rssadapt *,
     95  1.3.2.2     skrll 	    struct ieee80211_rssdesc *);
     96  1.3.2.2     skrll void	ieee80211_rssadapt_raise_rate(struct ieee80211com *,
     97  1.3.2.2     skrll 	    struct ieee80211_rssadapt *, struct ieee80211_rssdesc *);
     98  1.3.2.2     skrll int	ieee80211_rssadapt_choose(struct ieee80211_rssadapt *,
     99  1.3.2.2     skrll 	    struct ieee80211_rateset *, struct ieee80211_frame *, u_int, int,
    100  1.3.2.2     skrll 	    const char *, int);
    101  1.3.2.2     skrll #ifdef IEEE80211_DEBUG
    102  1.3.2.2     skrll extern int ieee80211_rssadapt_debug;
    103  1.3.2.2     skrll #endif /* IEEE80211_DEBUG */
    104  1.3.2.6  christos 
    105  1.3.2.6  christos #endif /* !_NET80211_IEEE80211_RSSADAPT_H_ */
    106  1.3.2.6  christos 
    107