rc80211_minstrel.h revision 631ad703ba3a585e96acbfd2ac8c0f0fee1ad99b
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  */
28static inline int
29minstrel_ewma(int old, int new, int weight)
30{
31	return (new * (EWMA_DIV - weight) + old * weight) / EWMA_DIV;
32}
33
34
35struct minstrel_rate {
36	int bitrate;
37	int rix;
38
39	unsigned int perfect_tx_time;
40	unsigned int ack_time;
41
42	int sample_limit;
43	unsigned int retry_count;
44	unsigned int retry_count_cts;
45	unsigned int retry_count_rtscts;
46	unsigned int adjusted_retry_count;
47
48	u32 success;
49	u32 attempts;
50	u32 last_attempts;
51	u32 last_success;
52	u8 sample_skipped;
53
54	/* parts per thousand */
55	u32 cur_prob;
56	u32 probability;
57
58	/* per-rate throughput */
59	u32 cur_tp;
60
61	u64 succ_hist;
62	u64 att_hist;
63};
64
65struct minstrel_sta_info {
66	struct ieee80211_sta *sta;
67
68	unsigned long stats_update;
69	unsigned int sp_ack_dur;
70	unsigned int rate_avg;
71
72	unsigned int lowest_rix;
73
74	u8 max_tp_rate[MAX_THR_RATES];
75	u8 max_prob_rate;
76	unsigned int packet_count;
77	unsigned int sample_count;
78	int sample_deferred;
79
80	unsigned int sample_row;
81	unsigned int sample_column;
82
83	int n_rates;
84	struct minstrel_rate *r;
85	bool prev_sample;
86
87	/* sampling table */
88	u8 *sample_table;
89
90#ifdef CONFIG_MAC80211_DEBUGFS
91	struct dentry *dbg_stats;
92#endif
93};
94
95struct minstrel_priv {
96	struct ieee80211_hw *hw;
97	bool has_mrr;
98	unsigned int cw_min;
99	unsigned int cw_max;
100	unsigned int max_retry;
101	unsigned int segment_size;
102	unsigned int update_interval;
103	unsigned int lookaround_rate;
104	unsigned int lookaround_rate_mrr;
105
106	u8 cck_rates[4];
107
108#ifdef CONFIG_MAC80211_DEBUGFS
109	/*
110	 * enable fixed rate processing per RC
111	 *   - write static index to debugfs:ieee80211/phyX/rc/fixed_rate_idx
112	 *   - write -1 to enable RC processing again
113	 *   - setting will be applied on next update
114	 */
115	u32 fixed_rate_idx;
116	struct dentry *dbg_fixed_rate;
117#endif
118
119};
120
121struct minstrel_debugfs_info {
122	size_t len;
123	char buf[];
124};
125
126extern const struct rate_control_ops mac80211_minstrel;
127void minstrel_add_sta_debugfs(void *priv, void *priv_sta, struct dentry *dir);
128void minstrel_remove_sta_debugfs(void *priv, void *priv_sta);
129
130/* debugfs */
131int minstrel_stats_open(struct inode *inode, struct file *file);
132ssize_t minstrel_stats_read(struct file *file, char __user *buf, size_t len, loff_t *ppos);
133int minstrel_stats_release(struct inode *inode, struct file *file);
134
135#endif
136