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 *
iwl_mld_vif_from_mac80211(struct ieee80211_vif * 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 *
iwl_mld_vif_to_mac80211(struct iwl_mld_vif * mld_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 *
iwl_mld_link_from_mac80211(struct ieee80211_bss_conf * bss_conf)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
iwl_mld_vif_low_latency(const struct iwl_mld_vif * mld_vif)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__ */
253