| 1 |
/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */ |
| 2 |
/* |
| 3 |
* Copyright (C) 2024-2025 Intel Corporation |
| 4 |
*/ |
| 5 |
#ifndef __iwl_mld_iface_h__ |
| 6 |
#define __iwl_mld_iface_h__ |
| 7 |
|
| 8 |
#include <net/mac80211.h> |
| 9 |
|
| 10 |
#include "link.h" |
| 11 |
#include "session-protect.h" |
| 12 |
#include "d3.h" |
| 13 |
#include "fw/api/time-event.h" |
| 14 |
|
| 15 |
enum iwl_mld_cca_40mhz_wa_status { |
| 16 |
CCA_40_MHZ_WA_NONE, |
| 17 |
CCA_40_MHZ_WA_RESET, |
| 18 |
CCA_40_MHZ_WA_RECONNECT, |
| 19 |
}; |
| 20 |
|
| 21 |
/** |
| 22 |
* enum iwl_mld_emlsr_blocked - defines reasons for which EMLSR is blocked |
| 23 |
* |
| 24 |
* These blocks are applied/stored per-VIF. |
| 25 |
* |
| 26 |
* @IWL_MLD_EMLSR_BLOCKED_PREVENTION: Prevent repeated EMLSR enter/exit |
| 27 |
* @IWL_MLD_EMLSR_BLOCKED_WOWLAN: WOWLAN is preventing EMLSR |
| 28 |
* @IWL_MLD_EMLSR_BLOCKED_ROC: remain-on-channel is preventing EMLSR |
| 29 |
* @IWL_MLD_EMLSR_BLOCKED_NON_BSS: An active non-BSS interface's link is |
| 30 |
* preventing EMLSR |
| 31 |
* @IWL_MLD_EMLSR_BLOCKED_TMP_NON_BSS: An expected active non-BSS interface's |
| 32 |
* link is preventing EMLSR. This is a temporary blocking that is set when |
| 33 |
* there is an indication that a non-BSS interface is to be added. |
| 34 |
* @IWL_MLD_EMLSR_BLOCKED_TPT: throughput is too low to make EMLSR worthwhile |
| 35 |
* @IWL_MLD_EMLSR_BLOCKED_NAN: NAN is preventing EMLSR. |
| 36 |
*/ |
| 37 |
enum iwl_mld_emlsr_blocked { |
| 38 |
IWL_MLD_EMLSR_BLOCKED_PREVENTION = 0x1, |
| 39 |
IWL_MLD_EMLSR_BLOCKED_WOWLAN = 0x2, |
| 40 |
IWL_MLD_EMLSR_BLOCKED_ROC = 0x4, |
| 41 |
IWL_MLD_EMLSR_BLOCKED_NON_BSS = 0x8, |
| 42 |
IWL_MLD_EMLSR_BLOCKED_TMP_NON_BSS = 0x10, |
| 43 |
IWL_MLD_EMLSR_BLOCKED_TPT = 0x20, |
| 44 |
IWL_MLD_EMLSR_BLOCKED_NAN = 0x40, |
| 45 |
}; |
| 46 |
|
| 47 |
/** |
| 48 |
* enum iwl_mld_emlsr_exit - defines reasons for exiting EMLSR |
| 49 |
* |
| 50 |
* Reasons to exit EMLSR may be either link specific or even specific to a |
| 51 |
* combination of links. |
| 52 |
* |
| 53 |
* @IWL_MLD_EMLSR_EXIT_BLOCK: Exit due to a block reason being set |
| 54 |
* @IWL_MLD_EMLSR_EXIT_MISSED_BEACON: Exit due to missed beacons |
| 55 |
* @IWL_MLD_EMLSR_EXIT_FAIL_ENTRY: FW failed to enter EMLSR |
| 56 |
* @IWL_MLD_EMLSR_EXIT_CSA: EMLSR prevented due to channel switch on link |
| 57 |
* @IWL_MLD_EMLSR_EXIT_EQUAL_BAND: EMLSR prevented as both links share the band |
| 58 |
* @IWL_MLD_EMLSR_EXIT_LOW_RSSI: Link RSSI is unsuitable for EMLSR |
| 59 |
* @IWL_MLD_EMLSR_EXIT_LINK_USAGE: Exit EMLSR due to low TPT on secondary link |
| 60 |
* @IWL_MLD_EMLSR_EXIT_BT_COEX: Exit EMLSR due to BT coexistence |
| 61 |
* @IWL_MLD_EMLSR_EXIT_CHAN_LOAD: Exit EMLSR because the primary channel is not |
| 62 |
* loaded enough to justify EMLSR. |
| 63 |
* @IWL_MLD_EMLSR_EXIT_RFI: Exit EMLSR due to RFI |
| 64 |
* @IWL_MLD_EMLSR_EXIT_FW_REQUEST: Exit EMLSR because the FW requested it |
| 65 |
* @IWL_MLD_EMLSR_EXIT_INVALID: internal exit reason due to invalid data |
| 66 |
*/ |
| 67 |
enum iwl_mld_emlsr_exit { |
| 68 |
IWL_MLD_EMLSR_EXIT_BLOCK = 0x1, |
| 69 |
IWL_MLD_EMLSR_EXIT_MISSED_BEACON = 0x2, |
| 70 |
IWL_MLD_EMLSR_EXIT_FAIL_ENTRY = 0x4, |
| 71 |
IWL_MLD_EMLSR_EXIT_CSA = 0x8, |
| 72 |
IWL_MLD_EMLSR_EXIT_EQUAL_BAND = 0x10, |
| 73 |
IWL_MLD_EMLSR_EXIT_LOW_RSSI = 0x20, |
| 74 |
IWL_MLD_EMLSR_EXIT_LINK_USAGE = 0x40, |
| 75 |
IWL_MLD_EMLSR_EXIT_BT_COEX = 0x80, |
| 76 |
IWL_MLD_EMLSR_EXIT_CHAN_LOAD = 0x100, |
| 77 |
IWL_MLD_EMLSR_EXIT_RFI = 0x200, |
| 78 |
IWL_MLD_EMLSR_EXIT_FW_REQUEST = 0x400, |
| 79 |
IWL_MLD_EMLSR_EXIT_INVALID = 0x800, |
| 80 |
}; |
| 81 |
|
| 82 |
/** |
| 83 |
* struct iwl_mld_emlsr - per-VIF data about EMLSR operation |
| 84 |
* |
| 85 |
* @primary: The current primary link |
| 86 |
* @selected_primary: Primary link as selected during the last link selection |
| 87 |
* @selected_links: Links as selected during the last link selection |
| 88 |
* @blocked_reasons: Reasons preventing EMLSR from being enabled |
| 89 |
* @last_exit_reason: Reason for the last EMLSR exit |
| 90 |
* @last_exit_ts: Time of the last EMLSR exit (if @last_exit_reason is non-zero) |
| 91 |
* @exit_repeat_count: Number of times EMLSR was exited for the same reason |
| 92 |
* @last_entry_ts: the time of the last EMLSR entry (if iwl_mld_emlsr_active() |
| 93 |
* is true) |
| 94 |
* @unblock_tpt_wk: Unblock EMLSR because the throughput limit was reached |
| 95 |
* @check_tpt_wk: a worker to check if IWL_MLD_EMLSR_BLOCKED_TPT should be |
| 96 |
* added, for example if there is no longer enough traffic. |
| 97 |
* @prevent_done_wk: Worker to remove %IWL_MLD_EMLSR_BLOCKED_PREVENTION |
| 98 |
* @tmp_non_bss_done_wk: Worker to remove %IWL_MLD_EMLSR_BLOCKED_TMP_NON_BSS |
| 99 |
*/ |
| 100 |
struct iwl_mld_emlsr { |
| 101 |
struct_group(zeroed_on_not_authorized, |
| 102 |
u8 primary; |
| 103 |
|
| 104 |
u8 selected_primary; |
| 105 |
u16 selected_links; |
| 106 |
|
| 107 |
enum iwl_mld_emlsr_blocked blocked_reasons; |
| 108 |
|
| 109 |
enum iwl_mld_emlsr_exit last_exit_reason; |
| 110 |
unsigned long last_exit_ts; |
| 111 |
u8 exit_repeat_count; |
| 112 |
unsigned long last_entry_ts; |
| 113 |
); |
| 114 |
|
| 115 |
struct wiphy_work unblock_tpt_wk; |
| 116 |
struct wiphy_delayed_work check_tpt_wk; |
| 117 |
|
| 118 |
struct wiphy_delayed_work prevent_done_wk; |
| 119 |
struct wiphy_delayed_work tmp_non_bss_done_wk; |
| 120 |
}; |
| 121 |
|
| 122 |
/** |
| 123 |
* struct iwl_mld_vif - virtual interface (MAC context) configuration parameters |
| 124 |
* |
| 125 |
* @fw_id: fw id of the mac context. |
| 126 |
* @session_protect: session protection parameters |
| 127 |
* @ap_sta: pointer to AP sta, for easier access to it. |
| 128 |
* Relevant only for STA vifs. |
| 129 |
* @authorized: indicates the AP station was set to authorized |
| 130 |
* @num_associated_stas: number of associated STAs. Relevant only for AP mode. |
| 131 |
* @ap_ibss_active: whether the AP/IBSS was started |
| 132 |
* @cca_40mhz_workaround: When we are connected in 2.4 GHz and 40 MHz, and the |
| 133 |
* environment is too loaded, we work around this by reconnecting to the |
| 134 |
* same AP with 20 MHz. This manages the status of the workaround. |
| 135 |
* @beacon_inject_active: indicates an active debugfs beacon ie injection |
| 136 |
* @low_latency_causes: bit flags, indicating the causes for low-latency, |
| 137 |
* see @iwl_mld_low_latency_cause. |
| 138 |
* @ps_disabled: indicates that PS is disabled for this interface |
| 139 |
* @last_link_activation_time: last time a link was activated, for |
| 140 |
* deferring MLO scans (to make them more reliable) |
| 141 |
* @mld: pointer to the mld structure. |
| 142 |
* @deflink: default link data, for use in non-MLO, |
| 143 |
* @link: reference to link data for each valid link, for use in MLO. |
| 144 |
* @emlsr: information related to EMLSR |
| 145 |
* @wowlan_data: data used by the wowlan suspend flow |
| 146 |
* @use_ps_poll: use ps_poll frames |
| 147 |
* @disable_bf: disable beacon filter |
| 148 |
* @dbgfs_slink: debugfs symlink for this interface |
| 149 |
* @roc_activity: the id of the roc_activity running. Relevant for STA and |
| 150 |
* p2p device only. Set to %ROC_NUM_ACTIVITIES when not in use. |
| 151 |
* @aux_sta: station used for remain on channel. Used in P2P device. |
| 152 |
* @mlo_scan_start_wk: worker to start a deferred MLO scan |
| 153 |
*/ |
| 154 |
struct iwl_mld_vif { |
| 155 |
/* Add here fields that need clean up on restart */ |
| 156 |
struct_group(zeroed_on_hw_restart, |
| 157 |
u8 fw_id; |
| 158 |
struct iwl_mld_session_protect session_protect; |
| 159 |
struct ieee80211_sta *ap_sta; |
| 160 |
bool authorized; |
| 161 |
u8 num_associated_stas; |
| 162 |
bool ap_ibss_active; |
| 163 |
enum iwl_mld_cca_40mhz_wa_status cca_40mhz_workaround; |
| 164 |
#ifdef CONFIG_IWLWIFI_DEBUGFS |
| 165 |
bool beacon_inject_active; |
| 166 |
#endif |
| 167 |
u8 low_latency_causes; |
| 168 |
bool ps_disabled; |
| 169 |
time64_t last_link_activation_time; |
| 170 |
); |
| 171 |
/* And here fields that survive a fw restart */ |
| 172 |
struct iwl_mld *mld; |
| 173 |
struct iwl_mld_link deflink; |
| 174 |
struct iwl_mld_link __rcu *link[IEEE80211_MLD_MAX_NUM_LINKS]; |
| 175 |
|
| 176 |
struct iwl_mld_emlsr emlsr; |
| 177 |
|
| 178 |
#ifdef CONFIG_PM_SLEEP |
| 179 |
struct iwl_mld_wowlan_data wowlan_data; |
| 180 |
#endif |
| 181 |
#ifdef CONFIG_IWLWIFI_DEBUGFS |
| 182 |
bool use_ps_poll; |
| 183 |
bool disable_bf; |
| 184 |
struct dentry *dbgfs_slink; |
| 185 |
#endif |
| 186 |
enum iwl_roc_activity roc_activity; |
| 187 |
struct iwl_mld_int_sta aux_sta; |
| 188 |
|
| 189 |
struct wiphy_delayed_work mlo_scan_start_wk; |
| 190 |
}; |
| 191 |
|
| 192 |
static inline struct iwl_mld_vif * |
| 193 |
iwl_mld_vif_from_mac80211(struct ieee80211_vif *vif) |
| 194 |
{ |
| 195 |
return (void *)vif->drv_priv; |
| 196 |
} |
| 197 |
|
| 198 |
static inline struct ieee80211_vif * |
| 199 |
iwl_mld_vif_to_mac80211(struct iwl_mld_vif *mld_vif) |
| 200 |
{ |
| 201 |
return container_of((void *)mld_vif, struct ieee80211_vif, drv_priv); |
| 202 |
} |
| 203 |
|
| 204 |
#define iwl_mld_link_dereference_check(mld_vif, link_id) \ |
| 205 |
rcu_dereference_check((mld_vif)->link[link_id], \ |
| 206 |
lockdep_is_held(&mld_vif->mld->wiphy->mtx)) |
| 207 |
|
| 208 |
#define for_each_mld_vif_valid_link(mld_vif, mld_link) \ |
| 209 |
for (int link_id = 0; link_id < ARRAY_SIZE((mld_vif)->link); \ |
| 210 |
link_id++) \ |
| 211 |
if ((mld_link = iwl_mld_link_dereference_check(mld_vif, link_id))) |
| 212 |
|
| 213 |
/* Retrieve pointer to mld link from mac80211 structures */ |
| 214 |
static inline struct iwl_mld_link * |
| 215 |
iwl_mld_link_from_mac80211(struct ieee80211_bss_conf *bss_conf) |
| 216 |
{ |
| 217 |
struct iwl_mld_vif *mld_vif = iwl_mld_vif_from_mac80211(bss_conf->vif); |
| 218 |
|
| 219 |
return iwl_mld_link_dereference_check(mld_vif, bss_conf->link_id); |
| 220 |
} |
| 221 |
|
| 222 |
int iwl_mld_mac80211_iftype_to_fw(const struct ieee80211_vif *vif); |
| 223 |
|
| 224 |
/* Cleanup function for struct iwl_mld_vif, will be called in restart */ |
| 225 |
void iwl_mld_cleanup_vif(void *data, u8 *mac, struct ieee80211_vif *vif); |
| 226 |
int iwl_mld_mac_fw_action(struct iwl_mld *mld, struct ieee80211_vif *vif, |
| 227 |
u32 action); |
| 228 |
int iwl_mld_add_vif(struct iwl_mld *mld, struct ieee80211_vif *vif); |
| 229 |
void iwl_mld_rm_vif(struct iwl_mld *mld, struct ieee80211_vif *vif); |
| 230 |
void iwl_mld_set_vif_associated(struct iwl_mld *mld, |
| 231 |
struct ieee80211_vif *vif); |
| 232 |
u8 iwl_mld_get_fw_bss_vifs_ids(struct iwl_mld *mld); |
| 233 |
void iwl_mld_handle_probe_resp_data_notif(struct iwl_mld *mld, |
| 234 |
struct iwl_rx_packet *pkt); |
| 235 |
|
| 236 |
void iwl_mld_handle_datapath_monitor_notif(struct iwl_mld *mld, |
| 237 |
struct iwl_rx_packet *pkt); |
| 238 |
|
| 239 |
void iwl_mld_handle_uapsd_misbehaving_ap_notif(struct iwl_mld *mld, |
| 240 |
struct iwl_rx_packet *pkt); |
| 241 |
|
| 242 |
void iwl_mld_reset_cca_40mhz_workaround(struct iwl_mld *mld, |
| 243 |
struct ieee80211_vif *vif); |
| 244 |
|
| 245 |
static inline bool iwl_mld_vif_low_latency(const struct iwl_mld_vif *mld_vif) |
| 246 |
{ |
| 247 |
return !!mld_vif->low_latency_causes; |
| 248 |
} |
| 249 |
|
| 250 |
struct ieee80211_vif *iwl_mld_get_bss_vif(struct iwl_mld *mld); |
| 251 |
|
| 252 |
#endif /* __iwl_mld_iface_h__ */ |