1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright 2002-2005, Instant802 Networks, Inc.
4  * Copyright 2005, Devicescape Software, Inc.
5  * Copyright (c) 2006 Jiri Benc <jbenc@suse.cz>
6  * Copyright (C) 2022 Intel Corporation
7  */
8 
9 #ifndef IEEE80211_RATE_H
10 #define IEEE80211_RATE_H
11 
12 #include <linux/netdevice.h>
13 #include <linux/skbuff.h>
14 #include <linux/types.h>
15 #include <net/mac80211.h>
16 #include "ieee80211_i.h"
17 #include "sta_info.h"
18 #include "driver-ops.h"
19 
20 struct rate_control_ref {
21 	const struct rate_control_ops *ops;
22 	void *priv;
23 };
24 
25 void rate_control_get_rate(struct ieee80211_sub_if_data *sdata,
26 			   struct sta_info *sta,
27 			   struct ieee80211_tx_rate_control *txrc);
28 
29 void rate_control_tx_status(struct ieee80211_local *local,
30 			    struct ieee80211_tx_status *st);
31 
32 void rate_control_rate_init(struct sta_info *sta);
33 void rate_control_rate_update(struct ieee80211_local *local,
34 			      struct ieee80211_supported_band *sband,
35 			      struct sta_info *sta,
36 			      unsigned int link_id,
37 			      u32 changed);
38 
rate_control_alloc_sta(struct rate_control_ref * ref,struct sta_info * sta,gfp_t gfp)39 static inline void *rate_control_alloc_sta(struct rate_control_ref *ref,
40 					   struct sta_info *sta, gfp_t gfp)
41 {
42 	spin_lock_init(&sta->rate_ctrl_lock);
43 	return ref->ops->alloc_sta(ref->priv, &sta->sta, gfp);
44 }
45 
rate_control_free_sta(struct sta_info * sta)46 static inline void rate_control_free_sta(struct sta_info *sta)
47 {
48 	struct rate_control_ref *ref = sta->rate_ctrl;
49 	struct ieee80211_sta *ista = &sta->sta;
50 	void *priv_sta = sta->rate_ctrl_priv;
51 
52 	ref->ops->free_sta(ref->priv, ista, priv_sta);
53 }
54 
rate_control_add_sta_debugfs(struct sta_info * sta)55 static inline void rate_control_add_sta_debugfs(struct sta_info *sta)
56 {
57 #ifdef CONFIG_MAC80211_DEBUGFS
58 	struct rate_control_ref *ref = sta->rate_ctrl;
59 	if (ref && sta->debugfs_dir && ref->ops->add_sta_debugfs)
60 		ref->ops->add_sta_debugfs(ref->priv, sta->rate_ctrl_priv,
61 					  sta->debugfs_dir);
62 #endif
63 }
64 
65 extern const struct file_operations rcname_ops;
66 
rate_control_add_debugfs(struct ieee80211_local * local)67 static inline void rate_control_add_debugfs(struct ieee80211_local *local)
68 {
69 #ifdef CONFIG_MAC80211_DEBUGFS
70 	struct dentry *debugfsdir;
71 
72 	if (!local->rate_ctrl)
73 		return;
74 
75 	if (!local->rate_ctrl->ops->add_debugfs)
76 		return;
77 
78 	debugfsdir = debugfs_create_dir("rc", local->hw.wiphy->debugfsdir);
79 	local->debugfs.rcdir = debugfsdir;
80 	debugfs_create_file("name", 0400, debugfsdir,
81 			    local->rate_ctrl, &rcname_ops);
82 
83 	local->rate_ctrl->ops->add_debugfs(&local->hw, local->rate_ctrl->priv,
84 					   debugfsdir);
85 #endif
86 }
87 
88 void ieee80211_check_rate_mask(struct ieee80211_link_data *link);
89 
90 /* Get a reference to the rate control algorithm. If `name' is NULL, get the
91  * first available algorithm. */
92 int ieee80211_init_rate_ctrl_alg(struct ieee80211_local *local,
93 				 const char *name);
94 void rate_control_deinitialize(struct ieee80211_local *local);
95 
96 
97 /* Rate control algorithms */
98 #ifdef CONFIG_MAC80211_RC_MINSTREL
99 int rc80211_minstrel_init(void);
100 void rc80211_minstrel_exit(void);
101 #else
rc80211_minstrel_init(void)102 static inline int rc80211_minstrel_init(void)
103 {
104 	return 0;
105 }
rc80211_minstrel_exit(void)106 static inline void rc80211_minstrel_exit(void)
107 {
108 }
109 #endif
110 
111 
112 #endif /* IEEE80211_RATE_H */
113