1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /* 3 * Copyright (C) 2010 Felix Fietkau <nbd@openwrt.org> 4 */ 5 6 #ifndef __RC_MINSTREL_HT_H 7 #define __RC_MINSTREL_HT_H 8 9 #include <linux/bitfield.h> 10 11 /* number of highest throughput rates to consider*/ 12 #define MAX_THR_RATES 4 13 #define SAMPLE_COLUMNS 10 /* number of columns in sample table */ 14 15 /* scaled fraction values */ 16 #define MINSTREL_SCALE 12 17 #define MINSTREL_FRAC(val, div) (((val) << MINSTREL_SCALE) / div) 18 #define MINSTREL_TRUNC(val) ((val) >> MINSTREL_SCALE) 19 20 #define EWMA_LEVEL 96 /* ewma weighting factor [/EWMA_DIV] */ 21 #define EWMA_DIV 128 22 23 /* 24 * Coefficients for moving average with noise filter (period=16), 25 * scaled by 10 bits 26 * 27 * a1 = exp(-pi * sqrt(2) / period) 28 * coeff2 = 2 * a1 * cos(sqrt(2) * 2 * pi / period) 29 * coeff3 = -sqr(a1) 30 * coeff1 = 1 - coeff2 - coeff3 31 */ 32 #define MINSTREL_AVG_COEFF1 (MINSTREL_FRAC(1, 1) - \ 33 MINSTREL_AVG_COEFF2 - \ 34 MINSTREL_AVG_COEFF3) 35 #define MINSTREL_AVG_COEFF2 0x00001499 36 #define MINSTREL_AVG_COEFF3 -0x0000092e 37 38 /* 39 * The number of streams can be changed to 2 to reduce code 40 * size and memory footprint. 41 */ 42 #define MINSTREL_MAX_STREAMS 4 43 #define MINSTREL_HT_STREAM_GROUPS 4 /* BW(=2) * SGI(=2) */ 44 #define MINSTREL_VHT_STREAM_GROUPS 6 /* BW(=3) * SGI(=2) */ 45 46 #define MINSTREL_HT_GROUPS_NB (MINSTREL_MAX_STREAMS * \ 47 MINSTREL_HT_STREAM_GROUPS) 48 #define MINSTREL_VHT_GROUPS_NB (MINSTREL_MAX_STREAMS * \ 49 MINSTREL_VHT_STREAM_GROUPS) 50 #define MINSTREL_LEGACY_GROUPS_NB 2 51 #define MINSTREL_GROUPS_NB (MINSTREL_HT_GROUPS_NB + \ 52 MINSTREL_VHT_GROUPS_NB + \ 53 MINSTREL_LEGACY_GROUPS_NB) 54 55 #define MINSTREL_HT_GROUP_0 0 56 #define MINSTREL_CCK_GROUP (MINSTREL_HT_GROUP_0 + MINSTREL_HT_GROUPS_NB) 57 #define MINSTREL_OFDM_GROUP (MINSTREL_CCK_GROUP + 1) 58 #define MINSTREL_VHT_GROUP_0 (MINSTREL_OFDM_GROUP + 1) 59 60 #define MCS_GROUP_RATES 10 61 62 #define MI_RATE_IDX_MASK GENMASK(3, 0) 63 #define MI_RATE_GROUP_MASK GENMASK(15, 4) 64 65 #define MI_RATE(_group, _idx) \ 66 (FIELD_PREP(MI_RATE_GROUP_MASK, _group) | \ 67 FIELD_PREP(MI_RATE_IDX_MASK, _idx)) 68 69 #define MI_RATE_IDX(_rate) FIELD_GET(MI_RATE_IDX_MASK, _rate) 70 #define MI_RATE_GROUP(_rate) FIELD_GET(MI_RATE_GROUP_MASK, _rate) 71 72 #define MINSTREL_SAMPLE_RATES 5 /* rates per sample type */ 73 #define MINSTREL_SAMPLE_INTERVAL (HZ / 50) 74 75 struct minstrel_priv { 76 struct ieee80211_hw *hw; 77 bool has_mrr; 78 unsigned int cw_min; 79 unsigned int cw_max; 80 unsigned int max_retry; 81 unsigned int segment_size; 82 unsigned int update_interval; 83 84 u8 cck_rates[4]; 85 u8 ofdm_rates[NUM_NL80211_BANDS][8]; 86 87 #ifdef CONFIG_MAC80211_DEBUGFS 88 /* 89 * enable fixed rate processing per RC 90 * - write static index to debugfs:ieee80211/phyX/rc/fixed_rate_idx 91 * - write -1 to enable RC processing again 92 * - setting will be applied on next update 93 */ 94 u32 fixed_rate_idx; 95 #endif 96 }; 97 98 99 struct mcs_group { 100 u16 flags; 101 u8 streams; 102 u8 shift; 103 u8 bw; 104 u16 duration[MCS_GROUP_RATES]; 105 }; 106 107 extern const s16 minstrel_cck_bitrates[4]; 108 extern const s16 minstrel_ofdm_bitrates[8]; 109 extern const struct mcs_group minstrel_mcs_groups[]; 110 111 struct minstrel_rate_stats { 112 /* current / last sampling period attempts/success counters */ 113 u16 attempts, last_attempts; 114 u16 success, last_success; 115 116 /* total attempts/success counters */ 117 u32 att_hist, succ_hist; 118 119 /* prob_avg - moving average of prob */ 120 u16 prob_avg; 121 u16 prob_avg_1; 122 123 /* maximum retry counts */ 124 u8 retry_count; 125 u8 retry_count_rtscts; 126 127 bool retry_updated; 128 }; 129 130 enum minstrel_sample_type { 131 MINSTREL_SAMPLE_TYPE_INC, 132 MINSTREL_SAMPLE_TYPE_JUMP, 133 MINSTREL_SAMPLE_TYPE_SLOW, 134 __MINSTREL_SAMPLE_TYPE_MAX 135 }; 136 137 struct minstrel_mcs_group_data { 138 u8 index; 139 u8 column; 140 141 /* sorted rate set within a MCS group*/ 142 u16 max_group_tp_rate[MAX_THR_RATES]; 143 u16 max_group_prob_rate; 144 145 /* MCS rate statistics */ 146 struct minstrel_rate_stats rates[MCS_GROUP_RATES]; 147 }; 148 149 struct minstrel_sample_category { 150 u8 sample_group; 151 u16 sample_rates[MINSTREL_SAMPLE_RATES]; 152 u16 cur_sample_rates[MINSTREL_SAMPLE_RATES]; 153 }; 154 155 struct minstrel_ht_sta { 156 struct ieee80211_sta *sta; 157 158 /* ampdu length (average, per sampling interval) */ 159 unsigned int ampdu_len; 160 unsigned int ampdu_packets; 161 162 /* ampdu length (EWMA) */ 163 unsigned int avg_ampdu_len; 164 165 /* overall sorted rate set */ 166 u16 max_tp_rate[MAX_THR_RATES]; 167 u16 max_prob_rate; 168 169 /* time of last status update */ 170 unsigned long last_stats_update; 171 172 /* overhead time in usec for each frame */ 173 unsigned int overhead; 174 unsigned int overhead_rtscts; 175 unsigned int overhead_legacy; 176 unsigned int overhead_legacy_rtscts; 177 178 unsigned int total_packets; 179 unsigned int sample_packets; 180 181 /* tx flags to add for frames for this sta */ 182 u32 tx_flags; 183 bool use_short_preamble; 184 u8 band; 185 186 u8 sample_seq; 187 u16 sample_rate; 188 189 unsigned long sample_time; 190 struct minstrel_sample_category sample[__MINSTREL_SAMPLE_TYPE_MAX]; 191 192 /* Bitfield of supported MCS rates of all groups */ 193 u16 supported[MINSTREL_GROUPS_NB]; 194 195 /* MCS rate group info and statistics */ 196 struct minstrel_mcs_group_data groups[MINSTREL_GROUPS_NB]; 197 }; 198 199 void minstrel_ht_add_sta_debugfs(void *priv, void *priv_sta, struct dentry *dir); 200 int minstrel_ht_get_tp_avg(struct minstrel_ht_sta *mi, int group, int rate, 201 int prob_avg); 202 203 #endif 204