xref: /openbmc/linux/net/mac80211/rate.h (revision 9d56dd3b083a3bec56e9da35ce07baca81030b03)
1 /*
2  * Copyright 2002-2005, Instant802 Networks, Inc.
3  * Copyright 2005, Devicescape Software, Inc.
4  * Copyright (c) 2006 Jiri Benc <jbenc@suse.cz>
5  *
6  * This program is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation.
9  */
10 
11 #ifndef IEEE80211_RATE_H
12 #define IEEE80211_RATE_H
13 
14 #include <linux/netdevice.h>
15 #include <linux/skbuff.h>
16 #include <linux/types.h>
17 #include <linux/kref.h>
18 #include <net/mac80211.h>
19 #include "ieee80211_i.h"
20 #include "sta_info.h"
21 
22 struct rate_control_ref {
23 	struct ieee80211_local *local;
24 	struct rate_control_ops *ops;
25 	void *priv;
26 	struct kref kref;
27 };
28 
29 /* Get a reference to the rate control algorithm. If `name' is NULL, get the
30  * first available algorithm. */
31 struct rate_control_ref *rate_control_alloc(const char *name,
32 					    struct ieee80211_local *local);
33 void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
34 			   struct sta_info *sta,
35 			   struct ieee80211_tx_rate_control *txrc);
36 struct rate_control_ref *rate_control_get(struct rate_control_ref *ref);
37 void rate_control_put(struct rate_control_ref *ref);
38 
39 static inline void rate_control_tx_status(struct ieee80211_local *local,
40 					  struct ieee80211_supported_band *sband,
41 					  struct sta_info *sta,
42 					  struct sk_buff *skb)
43 {
44 	struct rate_control_ref *ref = local->rate_ctrl;
45 	struct ieee80211_sta *ista = &sta->sta;
46 	void *priv_sta = sta->rate_ctrl_priv;
47 	struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
48 
49 	if (likely(info->flags & IEEE80211_TX_INTFL_RCALGO))
50 		ref->ops->tx_status(ref->priv, sband, ista, priv_sta, skb);
51 }
52 
53 
54 static inline void rate_control_rate_init(struct sta_info *sta)
55 {
56 	struct ieee80211_local *local = sta->sdata->local;
57 	struct rate_control_ref *ref = sta->rate_ctrl;
58 	struct ieee80211_sta *ista = &sta->sta;
59 	void *priv_sta = sta->rate_ctrl_priv;
60 	struct ieee80211_supported_band *sband;
61 
62 	if (!ref)
63 		return;
64 
65 	sband = local->hw.wiphy->bands[local->hw.conf.channel->band];
66 
67 	ref->ops->rate_init(ref->priv, sband, ista, priv_sta);
68 }
69 
70 static inline void rate_control_rate_update(struct ieee80211_local *local,
71 				    struct ieee80211_supported_band *sband,
72 				    struct sta_info *sta, u32 changed)
73 {
74 	struct rate_control_ref *ref = local->rate_ctrl;
75 	struct ieee80211_sta *ista = &sta->sta;
76 	void *priv_sta = sta->rate_ctrl_priv;
77 
78 	if (ref && ref->ops->rate_update)
79 		ref->ops->rate_update(ref->priv, sband, ista,
80 				      priv_sta, changed);
81 }
82 
83 static inline void *rate_control_alloc_sta(struct rate_control_ref *ref,
84 					   struct ieee80211_sta *sta,
85 					   gfp_t gfp)
86 {
87 	return ref->ops->alloc_sta(ref->priv, sta, gfp);
88 }
89 
90 static inline void rate_control_free_sta(struct sta_info *sta)
91 {
92 	struct rate_control_ref *ref = sta->rate_ctrl;
93 	struct ieee80211_sta *ista = &sta->sta;
94 	void *priv_sta = sta->rate_ctrl_priv;
95 
96 	ref->ops->free_sta(ref->priv, ista, priv_sta);
97 }
98 
99 static inline void rate_control_add_sta_debugfs(struct sta_info *sta)
100 {
101 #ifdef CONFIG_MAC80211_DEBUGFS
102 	struct rate_control_ref *ref = sta->rate_ctrl;
103 	if (ref && sta->debugfs.dir && ref->ops->add_sta_debugfs)
104 		ref->ops->add_sta_debugfs(ref->priv, sta->rate_ctrl_priv,
105 					  sta->debugfs.dir);
106 #endif
107 }
108 
109 static inline void rate_control_remove_sta_debugfs(struct sta_info *sta)
110 {
111 #ifdef CONFIG_MAC80211_DEBUGFS
112 	struct rate_control_ref *ref = sta->rate_ctrl;
113 	if (ref && ref->ops->remove_sta_debugfs)
114 		ref->ops->remove_sta_debugfs(ref->priv, sta->rate_ctrl_priv);
115 #endif
116 }
117 
118 /* functions for rate control related to a device */
119 int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
120 				 const char *name);
121 void rate_control_deinitialize(struct ieee80211_local *local);
122 
123 
124 /* Rate control algorithms */
125 #ifdef CONFIG_MAC80211_RC_PID
126 extern int rc80211_pid_init(void);
127 extern void rc80211_pid_exit(void);
128 #else
129 static inline int rc80211_pid_init(void)
130 {
131 	return 0;
132 }
133 static inline void rc80211_pid_exit(void)
134 {
135 }
136 #endif
137 
138 #ifdef CONFIG_MAC80211_RC_MINSTREL
139 extern int rc80211_minstrel_init(void);
140 extern void rc80211_minstrel_exit(void);
141 #else
142 static inline int rc80211_minstrel_init(void)
143 {
144 	return 0;
145 }
146 static inline void rc80211_minstrel_exit(void)
147 {
148 }
149 #endif
150 
151 
152 #endif /* IEEE80211_RATE_H */
153