1 /*
2  * Copyright (C) 2010 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_HT_H
10 #define __RC_MINSTREL_HT_H
11 
12 /*
13  * The number of streams can be changed to 2 to reduce code
14  * size and memory footprint.
15  */
16 #define MINSTREL_MAX_STREAMS	3
17 #define MINSTREL_STREAM_GROUPS	4
18 
19 #define MCS_GROUP_RATES	8
20 
21 struct mcs_group {
22 	u32 flags;
23 	unsigned int streams;
24 	unsigned int duration[MCS_GROUP_RATES];
25 };
26 
27 extern const struct mcs_group minstrel_mcs_groups[];
28 
29 struct minstrel_rate_stats {
30 	/* current / last sampling period attempts/success counters */
31 	unsigned int attempts, last_attempts;
32 	unsigned int success, last_success;
33 
34 	/* total attempts/success counters */
35 	u64 att_hist, succ_hist;
36 
37 	/* current throughput */
38 	unsigned int cur_tp;
39 
40 	/* packet delivery probabilities */
41 	unsigned int cur_prob, probability;
42 
43 	/* maximum retry counts */
44 	unsigned int retry_count;
45 	unsigned int retry_count_rtscts;
46 
47 	bool retry_updated;
48 	u8 sample_skipped;
49 };
50 
51 struct minstrel_mcs_group_data {
52 	u8 index;
53 	u8 column;
54 
55 	/* bitfield of supported MCS rates of this group */
56 	u8 supported;
57 
58 	/* selected primary rates */
59 	unsigned int max_tp_rate;
60 	unsigned int max_tp_rate2;
61 	unsigned int max_prob_rate;
62 
63 	/* MCS rate statistics */
64 	struct minstrel_rate_stats rates[MCS_GROUP_RATES];
65 };
66 
67 struct minstrel_ht_sta {
68 	struct ieee80211_sta *sta;
69 
70 	/* ampdu length (average, per sampling interval) */
71 	unsigned int ampdu_len;
72 	unsigned int ampdu_packets;
73 
74 	/* ampdu length (EWMA) */
75 	unsigned int avg_ampdu_len;
76 
77 	/* best throughput rate */
78 	unsigned int max_tp_rate;
79 
80 	/* second best throughput rate */
81 	unsigned int max_tp_rate2;
82 
83 	/* best probability rate */
84 	unsigned int max_prob_rate;
85 	unsigned int max_prob_streams;
86 
87 	/* time of last status update */
88 	unsigned long stats_update;
89 
90 	/* overhead time in usec for each frame */
91 	unsigned int overhead;
92 	unsigned int overhead_rtscts;
93 
94 	unsigned int total_packets;
95 	unsigned int sample_packets;
96 
97 	/* tx flags to add for frames for this sta */
98 	u32 tx_flags;
99 
100 	u8 sample_wait;
101 	u8 sample_tries;
102 	u8 sample_count;
103 	u8 sample_slow;
104 
105 	/* current MCS group to be sampled */
106 	u8 sample_group;
107 
108 	u8 cck_supported;
109 	u8 cck_supported_short;
110 
111 	/* MCS rate group info and statistics */
112 	struct minstrel_mcs_group_data groups[MINSTREL_MAX_STREAMS * MINSTREL_STREAM_GROUPS + 1];
113 };
114 
115 struct minstrel_ht_sta_priv {
116 	union {
117 		struct minstrel_ht_sta ht;
118 		struct minstrel_sta_info legacy;
119 	};
120 #ifdef CONFIG_MAC80211_DEBUGFS
121 	struct dentry *dbg_stats;
122 #endif
123 	void *ratelist;
124 	void *sample_table;
125 	bool is_ht;
126 };
127 
128 void minstrel_ht_add_sta_debugfs(void *priv, void *priv_sta, struct dentry *dir);
129 void minstrel_ht_remove_sta_debugfs(void *priv, void *priv_sta);
130 
131 #endif
132