xref: /linux/drivers/net/wireless/ath/ath12k/mac.h (revision 0b897fbd900e12a08baa3d1a0457944046a882ea)
1 /* SPDX-License-Identifier: BSD-3-Clause-Clear */
2 /*
3  * Copyright (c) 2018-2021 The Linux Foundation. All rights reserved.
4  * Copyright (c) 2021-2025 Qualcomm Innovation Center, Inc. All rights reserved.
5  */
6 
7 #ifndef ATH12K_MAC_H
8 #define ATH12K_MAC_H
9 
10 #include <net/mac80211.h>
11 #include <net/cfg80211.h>
12 #include "wmi.h"
13 
14 struct ath12k;
15 struct ath12k_base;
16 struct ath12k_hw;
17 struct ath12k_hw_group;
18 struct ath12k_pdev_map;
19 
20 struct ath12k_generic_iter {
21 	struct ath12k *ar;
22 	int ret;
23 };
24 
25 /* number of failed packets (20 packets with 16 sw reties each) */
26 #define ATH12K_KICKOUT_THRESHOLD		(20 * 16)
27 
28 /* Use insanely high numbers to make sure that the firmware implementation
29  * won't start, we have the same functionality already in hostapd. Unit
30  * is seconds.
31  */
32 #define ATH12K_KEEPALIVE_MIN_IDLE		3747
33 #define ATH12K_KEEPALIVE_MAX_IDLE		3895
34 #define ATH12K_KEEPALIVE_MAX_UNRESPONSIVE	3900
35 
36 #define ATH12K_PDEV_TX_POWER_INVALID		((u32)-1)
37 #define ATH12K_PDEV_TX_POWER_REFRESH_TIME_MSECS	5000 /* msecs */
38 
39 /* FIXME: should these be in ieee80211.h? */
40 #define IEEE80211_VHT_MCS_SUPPORT_0_11_MASK	GENMASK(23, 16)
41 #define IEEE80211_DISABLE_VHT_MCS_SUPPORT_0_11	BIT(24)
42 
43 #define ATH12K_CHAN_WIDTH_NUM			14
44 
45 #define ATH12K_TX_POWER_MAX_VAL	70
46 #define ATH12K_TX_POWER_MIN_VAL	0
47 
48 #define ATH12K_DEFAULT_LINK_ID	0
49 #define ATH12K_INVALID_LINK_ID	255
50 
51 /* Default link after the IEEE802.11 defined Max link id limit
52  * for driver usage purpose.
53  */
54 #define ATH12K_DEFAULT_SCAN_LINK	IEEE80211_MLD_MAX_NUM_LINKS
55 #define ATH12K_NUM_MAX_LINKS		(IEEE80211_MLD_MAX_NUM_LINKS + 1)
56 
57 enum ath12k_supported_bw {
58 	ATH12K_BW_20    = 0,
59 	ATH12K_BW_40    = 1,
60 	ATH12K_BW_80    = 2,
61 	ATH12K_BW_160   = 3,
62 	ATH12K_BW_320   = 4,
63 };
64 
65 struct ath12k_mac_get_any_chanctx_conf_arg {
66 	struct ath12k *ar;
67 	struct ieee80211_chanctx_conf *chanctx_conf;
68 };
69 
70 extern const struct htt_rx_ring_tlv_filter ath12k_mac_mon_status_filter_default;
71 
72 #define ATH12K_SCAN_11D_INTERVAL		600000
73 #define ATH12K_11D_INVALID_VDEV_ID		0xFFFF
74 
75 void ath12k_mac_11d_scan_start(struct ath12k *ar, u32 vdev_id);
76 void ath12k_mac_11d_scan_stop(struct ath12k *ar);
77 void ath12k_mac_11d_scan_stop_all(struct ath12k_base *ab);
78 
79 void ath12k_mac_destroy(struct ath12k_hw_group *ag);
80 void ath12k_mac_unregister(struct ath12k_hw_group *ag);
81 int ath12k_mac_register(struct ath12k_hw_group *ag);
82 int ath12k_mac_allocate(struct ath12k_hw_group *ag);
83 int ath12k_mac_hw_ratecode_to_legacy_rate(u8 hw_rc, u8 preamble, u8 *rateidx,
84 					  u16 *rate);
85 u8 ath12k_mac_bitrate_to_idx(const struct ieee80211_supported_band *sband,
86 			     u32 bitrate);
87 u8 ath12k_mac_hw_rate_to_idx(const struct ieee80211_supported_band *sband,
88 			     u8 hw_rate, bool cck);
89 
90 void __ath12k_mac_scan_finish(struct ath12k *ar);
91 void ath12k_mac_scan_finish(struct ath12k *ar);
92 
93 struct ath12k_link_vif *ath12k_mac_get_arvif(struct ath12k *ar, u32 vdev_id);
94 struct ath12k_link_vif *ath12k_mac_get_arvif_by_vdev_id(struct ath12k_base *ab,
95 							u32 vdev_id);
96 struct ath12k *ath12k_mac_get_ar_by_vdev_id(struct ath12k_base *ab, u32 vdev_id);
97 struct ath12k *ath12k_mac_get_ar_by_pdev_id(struct ath12k_base *ab, u32 pdev_id);
98 
99 void ath12k_mac_drain_tx(struct ath12k *ar);
100 void ath12k_mac_peer_cleanup_all(struct ath12k *ar);
101 int ath12k_mac_tx_mgmt_pending_free(int buf_id, void *skb, void *ctx);
102 enum rate_info_bw ath12k_mac_bw_to_mac80211_bw(enum ath12k_supported_bw bw);
103 enum ath12k_supported_bw ath12k_mac_mac80211_bw_to_ath12k_bw(enum rate_info_bw bw);
104 enum hal_encrypt_type ath12k_dp_tx_get_encrypt_type(u32 cipher);
105 int ath12k_mac_rfkill_enable_radio(struct ath12k *ar, bool enable);
106 int ath12k_mac_rfkill_config(struct ath12k *ar);
107 int ath12k_mac_wait_tx_complete(struct ath12k *ar);
108 void ath12k_mac_handle_beacon(struct ath12k *ar, struct sk_buff *skb);
109 void ath12k_mac_handle_beacon_miss(struct ath12k *ar, u32 vdev_id);
110 int ath12k_mac_vif_set_keepalive(struct ath12k_link_vif *arvif,
111 				 enum wmi_sta_keepalive_method method,
112 				 u32 interval);
113 u8 ath12k_mac_get_target_pdev_id(struct ath12k *ar);
114 int ath12k_mac_mlo_setup(struct ath12k_hw_group *ag);
115 int ath12k_mac_mlo_ready(struct ath12k_hw_group *ag);
116 void ath12k_mac_mlo_teardown(struct ath12k_hw_group *ag);
117 int ath12k_mac_vdev_stop(struct ath12k_link_vif *arvif);
118 void ath12k_mac_get_any_chanctx_conf_iter(struct ieee80211_hw *hw,
119 					  struct ieee80211_chanctx_conf *conf,
120 					  void *data);
121 u16 ath12k_mac_he_convert_tones_to_ru_tones(u16 tones);
122 enum nl80211_eht_ru_alloc ath12k_mac_eht_ru_tones_to_nl80211_eht_ru_alloc(u16 ru_tones);
123 enum nl80211_eht_gi ath12k_mac_eht_gi_to_nl80211_eht_gi(u8 sgi);
124 struct ieee80211_bss_conf *ath12k_mac_get_link_bss_conf(struct ath12k_link_vif *arvif);
125 struct ath12k *ath12k_get_ar_by_vif(struct ieee80211_hw *hw,
126 				    struct ieee80211_vif *vif,
127 				    u8 link_id);
128 int ath12k_mac_get_fw_stats(struct ath12k *ar, struct ath12k_fw_stats_req_params *param);
129 void ath12k_mac_update_freq_range(struct ath12k *ar,
130 				  u32 freq_low, u32 freq_high);
131 #endif
132