sys/net80211/ieee80211_rssadapt.h

   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_ */