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, 2024 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 link_sta_info *link_sta); 33 void rate_control_rate_init_all_links(struct sta_info *sta); 34 void rate_control_rate_update(struct ieee80211_local *local, 35 struct ieee80211_supported_band *sband, 36 struct link_sta_info *link_sta, 37 u32 changed); 38 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 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 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 debugfs_short_fops rcname_ops; 66 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 102 static inline int rc80211_minstrel_init(void) 103 { 104 return 0; 105 } 106 static inline void rc80211_minstrel_exit(void) 107 { 108 } 109 #endif 110 111 112 #endif /* IEEE80211_RATE_H */ 113