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 #define ATH12K_BW_NSS_MAP_ENABLE BIT(31) 45 #define ATH12K_PEER_RX_NSS_160MHZ GENMASK(2, 0) 46 47 #define ATH12K_TX_POWER_MAX_VAL 70 48 #define ATH12K_TX_POWER_MIN_VAL 0 49 50 #define ATH12K_DEFAULT_LINK_ID 0 51 #define ATH12K_INVALID_LINK_ID 255 52 53 /* Default link after the IEEE802.11 defined Max link id limit 54 * for driver usage purpose. 55 */ 56 #define ATH12K_FIRST_SCAN_LINK IEEE80211_MLD_MAX_NUM_LINKS 57 #define ATH12K_SCAN_MAX_LINKS ATH12K_GROUP_MAX_RADIO 58 /* Define 1 scan link for each radio for parallel scan purposes */ 59 #define ATH12K_NUM_MAX_LINKS (IEEE80211_MLD_MAX_NUM_LINKS + ATH12K_SCAN_MAX_LINKS) 60 #define ATH12K_SCAN_LINKS_MASK GENMASK(ATH12K_NUM_MAX_LINKS, IEEE80211_MLD_MAX_NUM_LINKS) 61 62 #define ATH12K_NUM_MAX_ACTIVE_LINKS_PER_DEVICE 2 63 64 #define HECAP_PHY_SUBFMR_GET(hecap_phy) \ 65 u8_get_bits(hecap_phy[3], IEEE80211_HE_PHY_CAP3_SU_BEAMFORMER) 66 67 #define HECAP_PHY_SUBFME_GET(hecap_phy) \ 68 u8_get_bits(hecap_phy[4], IEEE80211_HE_PHY_CAP4_SU_BEAMFORMEE) 69 70 #define HECAP_PHY_MUBFMR_GET(hecap_phy) \ 71 u8_get_bits(hecap_phy[4], IEEE80211_HE_PHY_CAP4_MU_BEAMFORMER) 72 73 #define HECAP_PHY_ULMUMIMO_GET(hecap_phy) \ 74 u8_get_bits(hecap_phy[2], IEEE80211_HE_PHY_CAP2_UL_MU_FULL_MU_MIMO) 75 76 #define HECAP_PHY_ULOFDMA_GET(hecap_phy) \ 77 u8_get_bits(hecap_phy[2], IEEE80211_HE_PHY_CAP2_UL_MU_PARTIAL_MU_MIMO) 78 79 enum ath12k_supported_bw { 80 ATH12K_BW_20 = 0, 81 ATH12K_BW_40 = 1, 82 ATH12K_BW_80 = 2, 83 ATH12K_BW_160 = 3, 84 ATH12K_BW_320 = 4, 85 }; 86 87 struct ath12k_mac_get_any_chanctx_conf_arg { 88 struct ath12k *ar; 89 struct ieee80211_chanctx_conf *chanctx_conf; 90 }; 91 92 /** 93 * struct ath12k_chan_power_info - TPE containing power info per channel chunk 94 * @chan_cfreq: channel center freq (MHz) 95 * e.g. 96 * channel 37/20 MHz, it is 6135 97 * channel 37/40 MHz, it is 6125 98 * channel 37/80 MHz, it is 6145 99 * channel 37/160 MHz, it is 6185 100 * @tx_power: transmit power (dBm) 101 */ 102 struct ath12k_chan_power_info { 103 u16 chan_cfreq; 104 s8 tx_power; 105 }; 106 107 /* ath12k only deals with 320 MHz, so 16 subchannels */ 108 #define ATH12K_NUM_PWR_LEVELS 16 109 110 /** 111 * struct ath12k_reg_tpc_power_info - regulatory TPC power info 112 * @is_psd_power: is PSD power or not 113 * @eirp_power: Maximum EIRP power (dBm), valid only if power is PSD 114 * @ap_power_type: type of power (SP/LPI/VLP) 115 * @num_pwr_levels: number of power levels 116 * @reg_max: Array of maximum TX power (dBm) per PSD value 117 * @ap_constraint_power: AP constraint power (dBm) 118 * @tpe: TPE values processed from TPE IE 119 * @chan_power_info: power info to send to firmware 120 */ 121 struct ath12k_reg_tpc_power_info { 122 bool is_psd_power; 123 u8 eirp_power; 124 enum wmi_reg_6g_ap_type ap_power_type; 125 u8 num_pwr_levels; 126 u8 reg_max[ATH12K_NUM_PWR_LEVELS]; 127 u8 ap_constraint_power; 128 s8 tpe[ATH12K_NUM_PWR_LEVELS]; 129 struct ath12k_chan_power_info chan_power_info[ATH12K_NUM_PWR_LEVELS]; 130 }; 131 132 extern const struct htt_rx_ring_tlv_filter ath12k_mac_mon_status_filter_default; 133 134 #define ATH12K_SCAN_11D_INTERVAL 600000 135 #define ATH12K_11D_INVALID_VDEV_ID 0xFFFF 136 137 void ath12k_mac_11d_scan_start(struct ath12k *ar, u32 vdev_id); 138 void ath12k_mac_11d_scan_stop(struct ath12k *ar); 139 void ath12k_mac_11d_scan_stop_all(struct ath12k_base *ab); 140 141 void ath12k_mac_destroy(struct ath12k_hw_group *ag); 142 void ath12k_mac_unregister(struct ath12k_hw_group *ag); 143 int ath12k_mac_register(struct ath12k_hw_group *ag); 144 int ath12k_mac_allocate(struct ath12k_hw_group *ag); 145 int ath12k_mac_hw_ratecode_to_legacy_rate(u8 hw_rc, u8 preamble, u8 *rateidx, 146 u16 *rate); 147 u8 ath12k_mac_bitrate_to_idx(const struct ieee80211_supported_band *sband, 148 u32 bitrate); 149 u8 ath12k_mac_hw_rate_to_idx(const struct ieee80211_supported_band *sband, 150 u8 hw_rate, bool cck); 151 152 void __ath12k_mac_scan_finish(struct ath12k *ar); 153 void ath12k_mac_scan_finish(struct ath12k *ar); 154 155 struct ath12k_link_vif *ath12k_mac_get_arvif(struct ath12k *ar, u32 vdev_id); 156 struct ath12k_link_vif *ath12k_mac_get_arvif_by_vdev_id(struct ath12k_base *ab, 157 u32 vdev_id); 158 struct ath12k *ath12k_mac_get_ar_by_vdev_id(struct ath12k_base *ab, u32 vdev_id); 159 struct ath12k *ath12k_mac_get_ar_by_pdev_id(struct ath12k_base *ab, u32 pdev_id); 160 161 void ath12k_mac_drain_tx(struct ath12k *ar); 162 void ath12k_mac_peer_cleanup_all(struct ath12k *ar); 163 int ath12k_mac_tx_mgmt_pending_free(int buf_id, void *skb, void *ctx); 164 enum rate_info_bw ath12k_mac_bw_to_mac80211_bw(enum ath12k_supported_bw bw); 165 enum ath12k_supported_bw ath12k_mac_mac80211_bw_to_ath12k_bw(enum rate_info_bw bw); 166 enum hal_encrypt_type ath12k_dp_tx_get_encrypt_type(u32 cipher); 167 int ath12k_mac_rfkill_enable_radio(struct ath12k *ar, bool enable); 168 int ath12k_mac_rfkill_config(struct ath12k *ar); 169 int ath12k_mac_wait_tx_complete(struct ath12k *ar); 170 void ath12k_mac_handle_beacon(struct ath12k *ar, struct sk_buff *skb); 171 void ath12k_mac_handle_beacon_miss(struct ath12k *ar, u32 vdev_id); 172 int ath12k_mac_vif_set_keepalive(struct ath12k_link_vif *arvif, 173 enum wmi_sta_keepalive_method method, 174 u32 interval); 175 u8 ath12k_mac_get_target_pdev_id(struct ath12k *ar); 176 int ath12k_mac_mlo_setup(struct ath12k_hw_group *ag); 177 int ath12k_mac_mlo_ready(struct ath12k_hw_group *ag); 178 void ath12k_mac_mlo_teardown(struct ath12k_hw_group *ag); 179 int ath12k_mac_vdev_stop(struct ath12k_link_vif *arvif); 180 void ath12k_mac_get_any_chanctx_conf_iter(struct ieee80211_hw *hw, 181 struct ieee80211_chanctx_conf *conf, 182 void *data); 183 u16 ath12k_mac_he_convert_tones_to_ru_tones(u16 tones); 184 enum nl80211_eht_ru_alloc ath12k_mac_eht_ru_tones_to_nl80211_eht_ru_alloc(u16 ru_tones); 185 enum nl80211_eht_gi ath12k_mac_eht_gi_to_nl80211_eht_gi(u8 sgi); 186 struct ieee80211_bss_conf *ath12k_mac_get_link_bss_conf(struct ath12k_link_vif *arvif); 187 struct ath12k *ath12k_get_ar_by_vif(struct ieee80211_hw *hw, 188 struct ieee80211_vif *vif, 189 u8 link_id); 190 int ath12k_mac_get_fw_stats(struct ath12k *ar, struct ath12k_fw_stats_req_params *param); 191 void ath12k_mac_update_freq_range(struct ath12k *ar, 192 u32 freq_low, u32 freq_high); 193 void ath12k_mac_fill_reg_tpc_info(struct ath12k *ar, 194 struct ath12k_link_vif *arvif, 195 struct ieee80211_chanctx_conf *ctx); 196 #endif 197