2 * Copyright (c) 2013 Qualcomm Atheros, Inc.
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:
9 * * Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
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
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.
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.
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>
51 #include <adf_net_types.h>
52 #include <adf_net_wcmd.h>
54 #include <ieee80211_var.h>
56 #include "if_athrate.h"
57 #include "if_athvar.h"
62 typedef int8_t A_RSSI;
63 typedef int32_t A_RSSI32;
64 typedef u_int8_t WLAN_PHY;
67 #define INLINE __inline
71 #define A_MIN(a,b) ((a)<(b)?(a):(b))
75 #define A_MAX(a,b) ((a)>(b)?(a):(b))
79 * Use the hal os glue code to get ms time; we supply
80 * a null arg because we know it's not needed.
82 #define A_MS_TICKGET() OS_GETUPTIME(NULL)
84 #define WLAN_PHY_OFDM IEEE80211_T_OFDM
85 #define WLAN_PHY_TURBO IEEE80211_T_TURBO
86 #define WLAN_PHY_CCK IEEE80211_T_CCK
87 #define WLAN_PHY_XR (IEEE80211_T_TURBO+1)
98 WLAN_RC_PHY_HT_20_SS_HGI,
99 WLAN_RC_PHY_HT_20_DS_HGI,
100 WLAN_RC_PHY_HT_40_SS_HGI,
101 WLAN_RC_PHY_HT_40_DS_HGI,
105 #define IS_CHAN_TURBO(_c) (((_c)->channelFlags & CHANNEL_TURBO) != 0)
106 #define IS_CHAN_2GHZ(_c) (((_c)->channelFlags & CHANNEL_2GHZ) != 0)
108 #define PKTLOG_RATE_CTL_FIND(_sc, log_data, flags) ath_log_rcfind(_sc, log_data, flags);
109 #define PKTLOG_RATE_CTL_UPDATE(_sc, log_data, flags) ath_log_rcupdate(_sc, log_data, flags);
110 #define ASSERT(condition)
112 #define WIRELESS_MODE_11NA IEEE80211_MODE_11NA
113 #define WIRELESS_MODE_11NG IEEE80211_MODE_11NG
114 #define WIRELESS_MODE_MAX IEEE80211_MODE_MAX
116 #define RX_FLIP_THRESHOLD 3 /* XXX */
119 #define MAX_TX_RATE_TBL 46
121 #define MAX_TX_RATE_TBL 54//46
125 * State structures for new rate adaptation code
127 * NOTE: Modifying these structures will impact
128 * the Perl script that parses packet logging data.
129 * See the packet logging module for more information.
131 typedef struct TxRateCrtlState_s {
132 A_UINT8 per; /* recent estimate of packet error rate (%) */
135 typedef struct TxRateCtrl_s {
136 TxRateCtrlState state[MAX_TX_RATE_TBL]; /* state for each rate */
137 A_UINT8 rateTableSize; /* rate table size */
138 A_UINT8 probeRate; /* rate we are probing at */
139 A_UINT32 rssiTime; /* msec timestamp for last ack rssi */
140 A_UINT32 probeTime; /* msec timestamp for last probe */
141 A_UINT8 hwMaxRetryPktCnt; /* num packets since we got HW max retry error */
142 A_UINT8 maxValidRate; /* maximum number of valid rate */
143 A_UINT8 validRateIndex[MAX_TX_RATE_TBL]; /* rc Index is valid for this Sib */
144 A_UINT32 perDownTime; /* msec timstamp for last PER down step */
146 A_UINT8 rateMaxPhy; /* Phy index for the max rate */
149 typedef struct phy_rate_ctrl {
151 A_UINT8 validPhyRateCount[WLAN_RC_PHY_MAX]; /* valid rate count */
152 A_UINT8 validPhyRateIndex[WLAN_RC_PHY_MAX][MAX_TX_RATE_TBL]; /* index */
156 struct atheros_node {
157 TX_RATE_CTRL txRateCtrl; /* rate control state proper */
158 A_UINT32 lastRateKbps; /* last rate in Kb/s */
159 A_UINT8 singleStream :1, /* When TRUE, only single stream Tx possible */
160 stbc :2; /* Rx stbc capability */
164 #define ATH_NODE_ATHEROS(an) (an->an_rcnode)
167 * Rate Table structure for various modes - 'b', 'a', 'g', 'xr';
168 * order of fields in info structure is important because hardcoded
169 * structures are initialized within the hal for these
174 A_UINT8 rateCodeToIndex[RATE_TABLE_SIZE]; /* backward mapping */
176 int valid; /* Valid for use in rate control */
177 WLAN_PHY phy; /* CCK/OFDM/TURBO/XR */
178 A_UINT16 rateKbps; /* Rate in Kbits per second */
179 A_UINT16 userRateKbps; /* User rate in KBits per second */
180 A_UINT8 rateCode; /* rate that goes into hw descriptors */
181 A_UINT8 shortPreamble; /* Mask for enabling short preamble in rate code for CCK */
182 A_UINT8 dot11Rate; /* Value that goes into supported rates info element of MLME */
183 A_UINT8 controlRate; /* Index of next lower basic rate, used for duration computation */
184 A_RSSI rssiAckValidMin; /* Rate control related information */
185 A_RSSI rssiAckDeltaMin; /* Rate control related information */
186 A_UINT16 lpAckDuration; /* long preamble ACK duration */
187 A_UINT16 spAckDuration; /* short preamble ACK duration*/
188 A_UINT32 max4msFrameLen; /* Maximum frame length(bytes) for 4ms tx duration */
190 A_UINT32 word4Retries;
194 A_UINT32 word4Retries;
198 A_UINT32 word4Retries;
202 A_UINT32 word4Retries;
206 A_UINT32 word4Retries;
210 A_UINT32 word4Retries;
213 #ifdef ATH_REMOVE_5G_RATE_TABLE
214 #ifdef ATH_REMOVE_TURBO_RATE_TABLE
215 #ifdef ATH_REMOVE_XR_RATE_TABLE
226 A_UINT32 probeInterval; /* interval for ratectrl to probe for
228 A_UINT32 rssiReduceInterval; /* interval for ratectrl to reduce RSSI */
229 A_UINT8 regularToTurboThresh; /* upperbound on regular (11a or 11g)
230 mode's rate before switching to turbo*/
231 A_UINT8 turboToRegularThresh; /* lowerbound on turbo mode's rate before
232 switching to regular */
233 A_UINT8 pktCountThresh; /* mode switch recommendation criterion:
234 number of consecutive packets sent at
235 rate beyond the rate threshold */
236 A_UINT8 initialRateMax; /* the initial rateMax value used in
238 A_UINT8 numTurboRates; /* number of Turbo rates in the rateTable */
239 A_UINT8 xrToRegularThresh; /* threshold to switch to Normal mode */
242 /* per-device state */
243 struct atheros_softc {
244 struct ath_ratectrl arc;
245 /* phy tables that contain rate control data */
246 void *hwRateTable[WIRELESS_MODE_MAX];
247 A_UINT32 tx_chainmask;
248 A_UINT32 currentTxRateKbps;
249 A_UINT32 currentTxRateIndex;
253 * Update the SIB's rate control information
255 * This should be called when the supported rates change
256 * (e.g. SME operation, wireless mode change)
258 * It will determine which rates are valid for use.
261 rcSibUpdate(struct ath_softc_tgt *sc,
262 struct ath_node_target *an,
264 struct ieee80211_rateset *pRateSet);
267 * This routine is called to initialize the rate control parameters
268 * in the SIB. It is called initially during system initialization
269 * or when a station is associated with the AP.
271 void rcSibInit(struct ath_softc_tgt *, struct ath_node_target *);
274 * Determines and returns the new Tx rate index.
276 A_UINT16 rcRateFind(struct ath_softc_tgt *, struct atheros_node *,
277 A_UINT32 frameLen,const RATE_TABLE *pRateTable);
279 struct fusion_rate_info {
285 void ar5416AttachRateTables(struct atheros_softc *sc);
287 #endif /* _RATECTRL_H_ */