net/mac80211/rc80211_minstrel.h

   1 /*
   2  * Copyright (C) 2008 Felix Fietkau <nbd@openwrt.org>
   3  *
   4  * This program is free software; you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License version 2 as
   6  * published by the Free Software Foundation.
   7  */
   8
   9 #ifndef __RC_MINSTREL_H
  10 #define __RC_MINSTREL_H
  11
  12 #define EWMA_LEVEL      96      /* ewma weighting factor [/EWMA_DIV] */
  13 #define EWMA_DIV        128
  14 #define SAMPLE_COLUMNS  10      /* number of columns in sample table */
  15
  16
  17 /* scaled fraction values */
  18 #define MINSTREL_SCALE  16
  19 #define MINSTREL_FRAC(val, div) (((val) << MINSTREL_SCALE) / div)
  20 #define MINSTREL_TRUNC(val) ((val) >> MINSTREL_SCALE)
  21
  22 /* number of highest throughput rates to consider*/
  23 #define MAX_THR_RATES 4
  24
  25 /*
  26  * Perform EWMA (Exponentially Weighted Moving Average) calculation
  27   */
  28 static inline int
  29 minstrel_ewma(int old, int new, int weight)
  30 {
  31         return (new * (EWMA_DIV - weight) + old * weight) / EWMA_DIV;
  32 }
  33
  34 struct minstrel_rate_stats {
  35         /* current / last sampling period attempts/success counters */
  36         u16 attempts, last_attempts;
  37         u16 success, last_success;
  38
  39         /* total attempts/success counters */
  40         u64 att_hist, succ_hist;
  41
  42         /* current throughput */
  43         unsigned int cur_tp;
  44
  45         /* packet delivery probabilities */
  46         unsigned int cur_prob, probability;
  47
  48         /* maximum retry counts */
  49         u8 retry_count;
  50         u8 retry_count_rtscts;
  51
  52         u8 sample_skipped;
  53         bool retry_updated;
  54 };
  55
  56 struct minstrel_rate {
  57         int bitrate;
  58
  59         s8 rix;
  60         u8 retry_count_cts;
  61         u8 adjusted_retry_count;
  62
  63         unsigned int perfect_tx_time;
  64         unsigned int ack_time;
  65
  66         int sample_limit;
  67
  68         struct minstrel_rate_stats stats;
  69 };
  70
  71 struct minstrel_sta_info {
  72         struct ieee80211_sta *sta;
  73
  74         unsigned long stats_update;
  75         unsigned int sp_ack_dur;
  76         unsigned int rate_avg;
  77
  78         unsigned int lowest_rix;
  79
  80         u8 max_tp_rate[MAX_THR_RATES];
  81         u8 max_prob_rate;
  82         unsigned int total_packets;
  83         unsigned int sample_packets;
  84         int sample_deferred;
  85
  86         unsigned int sample_row;
  87         unsigned int sample_column;
  88
  89         int n_rates;
  90         struct minstrel_rate *r;
  91         bool prev_sample;
  92
  93         /* sampling table */
  94         u8 *sample_table;
  95
  96 #ifdef CONFIG_MAC80211_DEBUGFS
  97         struct dentry *dbg_stats;
  98 #endif
  99 };
 100
 101 struct minstrel_priv {
 102         struct ieee80211_hw *hw;
 103         bool has_mrr;
 104         unsigned int cw_min;
 105         unsigned int cw_max;
 106         unsigned int max_retry;
 107         unsigned int segment_size;
 108         unsigned int update_interval;
 109         unsigned int lookaround_rate;
 110         unsigned int lookaround_rate_mrr;
 111
 112         u8 cck_rates[4];
 113
 114 #ifdef CONFIG_MAC80211_DEBUGFS
 115         /*
 116          * enable fixed rate processing per RC
 117          *   - write static index to debugfs:ieee80211/phyX/rc/fixed_rate_idx
 118          *   - write -1 to enable RC processing again
 119          *   - setting will be applied on next update
 120          */
 121         u32 fixed_rate_idx;
 122         struct dentry *dbg_fixed_rate;
 123 #endif
 124
 125 };
 126
 127 struct minstrel_debugfs_info {
 128         size_t len;
 129         char buf[];
 130 };
 131
 132 extern const struct rate_control_ops mac80211_minstrel;
 133 void minstrel_add_sta_debugfs(void *priv, void *priv_sta, struct dentry *dir);
 134 void minstrel_remove_sta_debugfs(void *priv, void *priv_sta);
 135
 136 /* debugfs */
 137 int minstrel_stats_open(struct inode *inode, struct file *file);
 138 ssize_t minstrel_stats_read(struct file *file, char __user *buf, size_t len, loff_t *ppos);
 139 int minstrel_stats_release(struct inode *inode, struct file *file);
 140
 141 #endif