target_firmware/wlan/ratectrl.h

   1 /*
   2  * Copyright (c) 2013 Qualcomm Atheros, Inc.
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted (subject to the limitations in the
   7  * disclaimer below) provided that the following conditions are met:
   8  *
   9  *  * Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  *
  12  *  * Redistributions in binary form must reproduce the above copyright
  13  *    notice, this list of conditions and the following disclaimer in the
  14  *    documentation and/or other materials provided with the
  15  *    distribution.
  16  *
  17  *  * Neither the name of Qualcomm Atheros nor the names of its
  18  *    contributors may be used to endorse or promote products derived
  19  *    from this software without specific prior written permission.
  20  *
  21  * NO EXPRESS OR IMPLIED LICENSES TO ANY PARTY'S PATENT RIGHTS ARE
  22  * GRANTED BY THIS LICENSE.  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT
  23  * HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED
  24  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  25  * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  26  * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  27  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  28  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  29  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
  30  * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  31  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
  32  * OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
  33  * IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  34  */
  35
  36 #ifndef _RATECTRL_H_
  37 #define _RATECTRL_H_
  38
  39 #include <adf_os_types.h>
  40 #include <adf_os_dma.h>
  41 #include <adf_os_timer.h>
  42 #include <adf_os_lock.h>
  43 #include <adf_os_io.h>
  44 #include <adf_os_mem.h>
  45 #include <adf_os_util.h>
  46 #include <adf_os_stdtypes.h>
  47 #include <adf_os_defer.h>
  48 #include <adf_os_atomic.h>
  49 #include <adf_nbuf.h>
  50 #include <adf_net.h>
  51 #include <adf_net_types.h>
  52 #include <adf_net_wcmd.h>
  53
  54 #include <ieee80211_var.h>
  55
  56 #include "if_athrate.h"
  57 #include "if_athvar.h"
  58
  59 #define FALSE   0
  60 #define TRUE    1
  61
  62 typedef int8_t          A_RSSI;
  63 typedef int32_t         A_RSSI32;
  64 typedef u_int8_t        WLAN_PHY;
  65
  66 #ifndef INLINE
  67 #define INLINE          __inline
  68 #endif
  69
  70 #ifndef A_MIN
  71 #define A_MIN(a,b)      ((a)<(b)?(a):(b))
  72 #endif
  73
  74 #ifndef A_MAX
  75 #define A_MAX(a,b)      ((a)>(b)?(a):(b))
  76 #endif
  77
  78 /*
  79  * Use the hal os glue code to get ms time; we supply
  80  * a null arg because we know it's not needed.
  81  */
  82 #define A_MS_TICKGET()  OS_GETUPTIME(NULL)
  83 #define A_MEM_ZERO(p,s) OS_MEMZERO(p,s)
  84
  85 #define WLAN_PHY_OFDM   IEEE80211_T_OFDM
  86 #define WLAN_PHY_TURBO  IEEE80211_T_TURBO
  87 #define WLAN_PHY_CCK    IEEE80211_T_CCK
  88 #define WLAN_PHY_XR     (IEEE80211_T_TURBO+1)
  89
  90 enum {
  91         WLAN_RC_PHY_CCK,
  92         WLAN_RC_PHY_OFDM,
  93         WLAN_RC_PHY_TURBO,
  94         WLAN_RC_PHY_XR,
  95         WLAN_RC_PHY_HT_20_SS,
  96         WLAN_RC_PHY_HT_20_DS,
  97         WLAN_RC_PHY_HT_40_SS,
  98         WLAN_RC_PHY_HT_40_DS,
  99         WLAN_RC_PHY_HT_20_SS_HGI,
 100         WLAN_RC_PHY_HT_20_DS_HGI,
 101         WLAN_RC_PHY_HT_40_SS_HGI,
 102         WLAN_RC_PHY_HT_40_DS_HGI,
 103         WLAN_RC_PHY_MAX
 104 };
 105
 106 #define IS_CHAN_TURBO(_c)   (((_c)->channelFlags & CHANNEL_TURBO) != 0)
 107 #define IS_CHAN_2GHZ(_c)    (((_c)->channelFlags & CHANNEL_2GHZ) != 0)
 108
 109 #define PKTLOG_RATE_CTL_FIND(_sc, log_data, flags)   ath_log_rcfind(_sc, log_data, flags);
 110 #define PKTLOG_RATE_CTL_UPDATE(_sc, log_data, flags) ath_log_rcupdate(_sc, log_data, flags);
 111 #define ASSERT(condition)
 112
 113 #define WIRELESS_MODE_11NA      IEEE80211_MODE_11NA
 114 #define WIRELESS_MODE_11NG      IEEE80211_MODE_11NG
 115 #define WIRELESS_MODE_MAX       IEEE80211_MODE_MAX
 116
 117 #define RX_FLIP_THRESHOLD       3       /* XXX */
 118
 119 #ifdef MAGPIE_MERLIN
 120 #define MAX_TX_RATE_TBL         46
 121 #define MAX_TX_RATE_PHY         48
 122 #else
 123 #define MAX_TX_RATE_TBL         54//46
 124 #define MAX_TX_RATE_PHY         56//48
 125 #endif
 126
 127 /*
 128  * State structures for new rate adaptation code
 129  *
 130  * NOTE: Modifying these structures will impact
 131  * the Perl script that parses packet logging data.
 132  * See the packet logging module for more information.
 133  */
 134 typedef struct TxRateCrtlState_s {
 135         A_UINT8 per;                /* recent estimate of packet error rate (%) */
 136 } TxRateCtrlState;
 137
 138 typedef struct TxRateCtrl_s {
 139         TxRateCtrlState state[MAX_TX_RATE_TBL];                         /* state for each rate */
 140         A_UINT8  rateTableSize;       /* rate table size */
 141         A_UINT8  probeRate;           /* rate we are probing at */
 142         A_UINT32 rssiTime;            /* msec timestamp for last ack rssi */
 143         A_UINT32 probeTime;           /* msec timestamp for last probe */
 144         A_UINT8  hwMaxRetryPktCnt;    /* num packets since we got HW max retry error */
 145         A_UINT8  maxValidRate;       /* maximum number of valid rate */
 146         A_UINT8  validRateIndex[MAX_TX_RATE_TBL];    /* rc Index is valid for this Sib */
 147         A_UINT32 perDownTime;         /* msec timstamp for last PER down step */
 148         A_UINT8  rcPhyMode;
 149         A_UINT8  rateMaxPhy;          /* Phy index for the max rate */
 150 } TX_RATE_CTRL;
 151
 152 typedef struct phy_rate_ctrl {
 153         /* 11n state */
 154         A_UINT8  validPhyRateCount[WLAN_RC_PHY_MAX]; /* valid rate count */
 155         A_UINT8  validPhyRateIndex[WLAN_RC_PHY_MAX][MAX_TX_RATE_TBL]; /* index */
 156 }PHY_STATE_CTRL;
 157
 158 /* per-node state */
 159 struct atheros_node {
 160         TX_RATE_CTRL txRateCtrl;    /* rate control state proper */
 161         A_UINT32 lastRateKbps;      /* last rate in Kb/s */
 162         A_UINT32 htcap;            /* ht capabilites */
 163         A_UINT8 singleStream    :1,   /* When TRUE, only single stream Tx possible */
 164                 stbc            :2;   /* Rx stbc capability */
 165
 166 };
 167
 168 #define ATH_NODE_ATHEROS(an)    (an->an_rcnode)
 169
 170 /*
 171  * Rate Table structure for various modes - 'b', 'a', 'g', 'xr';
 172  * order of fields in info structure is important because hardcoded
 173  * structures are initialized within the hal for these
 174  */
 175
 176 typedef struct {
 177         int         rateCount;
 178         A_UINT8     rateCodeToIndex[RATE_TABLE_SIZE]; /* backward mapping */
 179         struct {
 180                 int    valid;            /* Valid for use in rate control */
 181                 WLAN_PHY  phy;              /* CCK/OFDM/TURBO/XR */
 182                 A_UINT16  rateKbps;         /* Rate in Kbits per second */
 183                 A_UINT16  userRateKbps;     /* User rate in KBits per second */
 184                 A_UINT8   rateCode;         /* rate that goes into hw descriptors */
 185                 A_UINT8   shortPreamble;    /* Mask for enabling short preamble in rate code for CCK */
 186                 A_UINT8   dot11Rate;        /* Value that goes into supported rates info element of MLME */
 187                 A_UINT8   controlRate;      /* Index of next lower basic rate, used for duration computation */
 188                 A_RSSI    rssiAckValidMin;  /* Rate control related information */
 189                 A_RSSI    rssiAckDeltaMin;  /* Rate control related information */
 190                 A_UINT16  lpAckDuration;    /* long preamble ACK duration */
 191                 A_UINT16  spAckDuration;    /* short preamble ACK duration*/
 192                 A_UINT32  max4msFrameLen;   /* Maximum frame length(bytes) for 4ms tx duration */
 193                 struct {
 194                         A_UINT32  word4Retries;
 195                         A_UINT32  word5Rates;
 196                 } normalSched;
 197                 struct {
 198                         A_UINT32  word4Retries;
 199                         A_UINT32  word5Rates;
 200                 } shortSched;
 201                 struct {
 202                         A_UINT32  word4Retries;
 203                         A_UINT32  word5Rates;
 204                 } probeSched;
 205                 struct {
 206                         A_UINT32  word4Retries;
 207                         A_UINT32  word5Rates;
 208                 } probeShortSched;
 209                 struct {
 210                         A_UINT32  word4Retries;
 211                         A_UINT32  word5Rates;
 212                 } uapsd_normalSched;
 213                 struct {
 214                         A_UINT32  word4Retries;
 215                         A_UINT32  word5Rates;
 216                 } uapsd_shortSched;
 217 #ifdef ATH_REMOVE_5G_RATE_TABLE
 218 #ifdef ATH_REMOVE_TURBO_RATE_TABLE
 219 #ifdef ATH_REMOVE_XR_RATE_TABLE
 220         } info[12];
 221 #else
 222 } info[32];
 223 #endif
 224 #else
 225 } info[32];
 226 #endif
 227 #else
 228 } info[32];
 229 #endif
 230 A_UINT32    probeInterval;        /* interval for ratectrl to probe for
 231                                      other rates */
 232 A_UINT32    rssiReduceInterval;   /* interval for ratectrl to reduce RSSI */
 233 A_UINT8     regularToTurboThresh; /* upperbound on regular (11a or 11g)
 234                                      mode's rate before switching to turbo*/
 235 A_UINT8     turboToRegularThresh; /* lowerbound on turbo mode's rate before
 236                                      switching to regular */
 237 A_UINT8     pktCountThresh;       /* mode switch recommendation criterion:
 238                                      number of consecutive packets sent at
 239                                      rate beyond the rate threshold */
 240 A_UINT8     initialRateMax;       /* the initial rateMax value used in
 241                                      rcSibUpdate() */
 242 A_UINT8     numTurboRates;        /* number of Turbo rates in the rateTable */
 243 A_UINT8     xrToRegularThresh;    /* threshold to switch to Normal mode */
 244 } RATE_TABLE;
 245
 246 /* per-device state */
 247 struct atheros_softc {
 248         struct ath_ratectrl     arc;
 249         /* phy tables that contain rate control data */
 250         void                    *hwRateTable[WIRELESS_MODE_MAX];
 251         A_UINT32                tx_chainmask;
 252         A_UINT32                currentTxRateKbps;
 253         A_UINT32                currentTxRateIndex;
 254 };
 255
 256 /*
 257  *  Update the SIB's rate control information
 258  *
 259  *  This should be called when the supported rates change
 260  *  (e.g. SME operation, wireless mode change)
 261  *
 262  *  It will determine which rates are valid for use.
 263  */
 264 void
 265 rcSibUpdate(struct ath_softc_tgt *sc,
 266             struct ath_node_target *an,
 267             A_BOOL keepState,
 268             struct ieee80211_rateset *pRateSet);
 269
 270 /*
 271  *  This routine is called to initialize the rate control parameters
 272  *  in the SIB. It is called initially during system initialization
 273  *  or when a station is associated with the AP.
 274  */
 275 void rcSibInit(struct ath_softc_tgt *, struct ath_node_target *);
 276
 277 /*
 278  * Determines and returns the new Tx rate index.
 279  */
 280 A_UINT16 rcRateFind(struct ath_softc_tgt *, struct atheros_node *,
 281                     A_UINT32 frameLen,const  RATE_TABLE *pRateTable);
 282
 283 struct fusion_rate_info {
 284         A_UINT32 txrate;
 285         A_UINT8 rssi;
 286         A_UINT8 per;
 287 };
 288
 289 void ar5416AttachRateTables(struct atheros_softc *sc);
 290
 291 #endif /* _RATECTRL_H_ */