xref: /linux/drivers/net/wireless/intel/iwlwifi/mld/notif.c (revision b089c415e0a9e44f4ecba470e189063c1ed7f4d4)
1 // SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
2 /*
3  * Copyright (C) 2024-2025 Intel Corporation
4  */
5 
6 #include "mld.h"
7 #include "notif.h"
8 #include "scan.h"
9 #include "iface.h"
10 #include "mlo.h"
11 #include "iwl-trans.h"
12 #include "fw/file.h"
13 #include "fw/dbg.h"
14 #include "fw/api/cmdhdr.h"
15 #include "fw/api/mac-cfg.h"
16 #include "session-protect.h"
17 #include "fw/api/time-event.h"
18 #include "fw/api/tx.h"
19 #include "fw/api/rs.h"
20 #include "fw/api/offload.h"
21 #include "fw/api/stats.h"
22 #include "fw/api/rfi.h"
23 #include "fw/api/coex.h"
24 
25 #include "mcc.h"
26 #include "link.h"
27 #include "tx.h"
28 #include "rx.h"
29 #include "tlc.h"
30 #include "agg.h"
31 #include "mac80211.h"
32 #include "thermal.h"
33 #include "roc.h"
34 #include "stats.h"
35 #include "coex.h"
36 #include "time_sync.h"
37 #include "ftm-initiator.h"
38 
39 /* Please use this in an increasing order of the versions */
40 #define CMD_VER_ENTRY(_ver, _struct)			\
41 	{ .size = sizeof(struct _struct), .ver = _ver },
42 #define CMD_VERSIONS(name, ...)				\
43 	static const struct iwl_notif_struct_size	\
44 	iwl_notif_struct_sizes_##name[] = { __VA_ARGS__ };
45 
46 #define RX_HANDLER_NO_OBJECT(_grp, _cmd, _name, _context)		\
47 	{.cmd_id = WIDE_ID(_grp, _cmd),					\
48 	 .context = _context,						\
49 	 .fn = iwl_mld_handle_##_name,					\
50 	 .sizes = iwl_notif_struct_sizes_##_name,			\
51 	 .n_sizes = ARRAY_SIZE(iwl_notif_struct_sizes_##_name),		\
52 	},
53 
54 /* Use this for Rx handlers that do not need notification validation */
55 #define RX_HANDLER_NO_VAL(_grp, _cmd, _name, _context)			\
56 	{.cmd_id = WIDE_ID(_grp, _cmd),					\
57 	 .context = _context,						\
58 	 .fn = iwl_mld_handle_##_name,					\
59 	},
60 
61 #define RX_HANDLER_VAL_FN(_grp, _cmd, _name, _context)			\
62 	{ .cmd_id = WIDE_ID(_grp, _cmd),				\
63 	  .context = _context,						\
64 	  .fn = iwl_mld_handle_##_name,					\
65 	  .val_fn = iwl_mld_validate_##_name,				\
66 	},
67 
68 #define DEFINE_SIMPLE_CANCELLATION(name, notif_struct, id_member)		\
69 static bool iwl_mld_cancel_##name##_notif(struct iwl_mld *mld,			\
70 					  struct iwl_rx_packet *pkt,		\
71 					  u32 obj_id)				\
72 {										\
73 	const struct notif_struct *notif = (const void *)pkt->data;		\
74 										\
75 	return obj_id == _Generic((notif)->id_member,				\
76 				  __le32: le32_to_cpu((notif)->id_member),	\
77 				  __le16: le16_to_cpu((notif)->id_member),	\
78 				  u8: (notif)->id_member);			\
79 }
80 
81 static bool iwl_mld_always_cancel(struct iwl_mld *mld,
82 				  struct iwl_rx_packet *pkt,
83 				  u32 obj_id)
84 {
85 	return true;
86 }
87 
88 /* Currently only defined for the RX_HANDLER_SIZES options. Use this for
89  * notifications that belong to a specific object, and that should be
90  * canceled when the object is removed
91  */
92 #define RX_HANDLER_OF_OBJ(_grp, _cmd, _name, _obj_type)			\
93 	{.cmd_id = WIDE_ID(_grp, _cmd),					\
94 	/* Only async handlers can be canceled */			\
95 	 .context = RX_HANDLER_ASYNC,					\
96 	 .fn = iwl_mld_handle_##_name,					\
97 	 .sizes = iwl_notif_struct_sizes_##_name,			\
98 	 .n_sizes = ARRAY_SIZE(iwl_notif_struct_sizes_##_name),		\
99 	 .obj_type = IWL_MLD_OBJECT_TYPE_##_obj_type,			\
100 	 .cancel = iwl_mld_cancel_##_name,				\
101 	 },
102 
103 #define RX_HANDLER_OF_LINK(_grp, _cmd, _name)				\
104 	RX_HANDLER_OF_OBJ(_grp, _cmd, _name, LINK)			\
105 
106 #define RX_HANDLER_OF_VIF(_grp, _cmd, _name)				\
107 	RX_HANDLER_OF_OBJ(_grp, _cmd, _name, VIF)			\
108 
109 #define RX_HANDLER_OF_STA(_grp, _cmd, _name)				\
110 	RX_HANDLER_OF_OBJ(_grp, _cmd, _name, STA)			\
111 
112 #define RX_HANDLER_OF_ROC(_grp, _cmd, _name)				\
113 	RX_HANDLER_OF_OBJ(_grp, _cmd, _name, ROC)
114 
115 #define RX_HANDLER_OF_SCAN(_grp, _cmd, _name)				\
116 	RX_HANDLER_OF_OBJ(_grp, _cmd, _name, SCAN)
117 
118 #define RX_HANDLER_OF_FTM_REQ(_grp, _cmd, _name)				\
119 	RX_HANDLER_OF_OBJ(_grp, _cmd, _name, FTM_REQ)
120 
121 static void iwl_mld_handle_mfuart_notif(struct iwl_mld *mld,
122 					struct iwl_rx_packet *pkt)
123 {
124 	struct iwl_mfuart_load_notif *mfuart_notif = (void *)pkt->data;
125 
126 	IWL_DEBUG_INFO(mld,
127 		       "MFUART: installed ver: 0x%08x, external ver: 0x%08x\n",
128 		       le32_to_cpu(mfuart_notif->installed_ver),
129 		       le32_to_cpu(mfuart_notif->external_ver));
130 	IWL_DEBUG_INFO(mld,
131 		       "MFUART: status: 0x%08x, duration: 0x%08x image size: 0x%08x\n",
132 		       le32_to_cpu(mfuart_notif->status),
133 		       le32_to_cpu(mfuart_notif->duration),
134 		       le32_to_cpu(mfuart_notif->image_size));
135 }
136 
137 static void iwl_mld_mu_mimo_iface_iterator(void *_data, u8 *mac,
138 					   struct ieee80211_vif *vif)
139 {
140 	struct ieee80211_bss_conf *bss_conf = &vif->bss_conf;
141 	unsigned int link_id = 0;
142 
143 	if (WARN(hweight16(vif->active_links) > 1,
144 		 "no support for this notif while in EMLSR 0x%x\n",
145 		 vif->active_links))
146 		return;
147 
148 	if (ieee80211_vif_is_mld(vif)) {
149 		link_id = __ffs(vif->active_links);
150 		bss_conf = link_conf_dereference_check(vif, link_id);
151 	}
152 
153 	if (!WARN_ON(!bss_conf) && bss_conf->mu_mimo_owner) {
154 		const struct iwl_mu_group_mgmt_notif *notif = _data;
155 
156 		BUILD_BUG_ON(sizeof(notif->membership_status) !=
157 			     WLAN_MEMBERSHIP_LEN);
158 		BUILD_BUG_ON(sizeof(notif->user_position) !=
159 			     WLAN_USER_POSITION_LEN);
160 
161 		/* MU-MIMO Group Id action frame is little endian. We treat
162 		 * the data received from firmware as if it came from the
163 		 * action frame, so no conversion is needed.
164 		 */
165 		ieee80211_update_mu_groups(vif, link_id,
166 					   (u8 *)&notif->membership_status,
167 					   (u8 *)&notif->user_position);
168 	}
169 }
170 
171 /* This handler is called in SYNC mode because it needs to be serialized with
172  * Rx as specified in ieee80211_update_mu_groups()'s documentation.
173  */
174 static void iwl_mld_handle_mu_mimo_grp_notif(struct iwl_mld *mld,
175 					     struct iwl_rx_packet *pkt)
176 {
177 	struct iwl_mu_group_mgmt_notif *notif = (void *)pkt->data;
178 
179 	ieee80211_iterate_active_interfaces_atomic(mld->hw,
180 						   IEEE80211_IFACE_ITER_NORMAL,
181 						   iwl_mld_mu_mimo_iface_iterator,
182 						   notif);
183 }
184 
185 static void
186 iwl_mld_handle_channel_switch_start_notif(struct iwl_mld *mld,
187 					  struct iwl_rx_packet *pkt)
188 {
189 	struct iwl_channel_switch_start_notif *notif = (void *)pkt->data;
190 	u32 link_id = le32_to_cpu(notif->link_id);
191 	struct ieee80211_bss_conf *link_conf =
192 		iwl_mld_fw_id_to_link_conf(mld, link_id);
193 	struct ieee80211_vif *vif;
194 
195 	if (WARN_ON(!link_conf))
196 		return;
197 
198 	vif = link_conf->vif;
199 
200 	IWL_DEBUG_INFO(mld,
201 		       "CSA Start Notification with vif type: %d, link_id: %d\n",
202 		       vif->type,
203 		       link_conf->link_id);
204 
205 	switch (vif->type) {
206 	case NL80211_IFTYPE_AP:
207 		/* We don't support canceling a CSA as it was advertised
208 		 * by the AP itself
209 		 */
210 		if (!link_conf->csa_active)
211 			return;
212 
213 		ieee80211_csa_finish(vif, link_conf->link_id);
214 		break;
215 	case NL80211_IFTYPE_STATION:
216 		if (!link_conf->csa_active) {
217 			/* Either unexpected cs notif or mac80211 chose to
218 			 * ignore, for example in channel switch to same channel
219 			 */
220 			struct iwl_cancel_channel_switch_cmd cmd = {
221 				.id = cpu_to_le32(link_id),
222 			};
223 
224 			if (iwl_mld_send_cmd_pdu(mld,
225 						 WIDE_ID(MAC_CONF_GROUP,
226 							 CANCEL_CHANNEL_SWITCH_CMD),
227 						 &cmd))
228 				IWL_ERR(mld,
229 					"Failed to cancel the channel switch\n");
230 			return;
231 		}
232 
233 		ieee80211_chswitch_done(vif, true, link_conf->link_id);
234 		break;
235 
236 	default:
237 		WARN(1, "CSA on invalid vif type: %d", vif->type);
238 	}
239 }
240 
241 static void
242 iwl_mld_handle_channel_switch_error_notif(struct iwl_mld *mld,
243 					  struct iwl_rx_packet *pkt)
244 {
245 	struct iwl_channel_switch_error_notif *notif = (void *)pkt->data;
246 	struct ieee80211_bss_conf *link_conf;
247 	struct ieee80211_vif *vif;
248 	u32 link_id = le32_to_cpu(notif->link_id);
249 	u32 csa_err_mask = le32_to_cpu(notif->csa_err_mask);
250 
251 	link_conf = iwl_mld_fw_id_to_link_conf(mld, link_id);
252 	if (WARN_ON(!link_conf))
253 		return;
254 
255 	vif = link_conf->vif;
256 
257 	IWL_DEBUG_INFO(mld, "FW reports CSA error: id=%u, csa_err_mask=%u\n",
258 		       link_id, csa_err_mask);
259 
260 	if (csa_err_mask & (CS_ERR_COUNT_ERROR |
261 			    CS_ERR_LONG_DELAY_AFTER_CS |
262 			    CS_ERR_TX_BLOCK_TIMER_EXPIRED))
263 		ieee80211_channel_switch_disconnect(vif);
264 }
265 
266 static void iwl_mld_handle_beacon_notification(struct iwl_mld *mld,
267 					       struct iwl_rx_packet *pkt)
268 {
269 	struct iwl_extended_beacon_notif *beacon = (void *)pkt->data;
270 
271 	mld->ibss_manager = !!beacon->ibss_mgr_status;
272 }
273 
274 /**
275  * DOC: Notification versioning
276  *
277  * The firmware's notifications change from time to time. In order to
278  * differentiate between different versions of the same notification, the
279  * firmware advertises the version of each notification.
280  * Here are listed all the notifications that are supported. Several versions
281  * of the same notification can be allowed at the same time:
282  *
283  * CMD_VERSION(my_multi_version_notif,
284  *	       CMD_VER_ENTRY(1, iwl_my_multi_version_notif_ver1)
285  *	       CMD_VER_ENTRY(2, iwl_my_multi_version_notif_ver2)
286  *
287  * etc...
288  *
289  * The driver will enforce that the notification coming from the firmware
290  * has its version listed here and it'll also enforce that the firmware sent
291  * at least enough bytes to cover the structure listed in the CMD_VER_ENTRY.
292  */
293 
294 CMD_VERSIONS(scan_complete_notif,
295 	     CMD_VER_ENTRY(1, iwl_umac_scan_complete))
296 CMD_VERSIONS(scan_iter_complete_notif,
297 	     CMD_VER_ENTRY(2, iwl_umac_scan_iter_complete_notif))
298 CMD_VERSIONS(channel_survey_notif,
299 	     CMD_VER_ENTRY(1, iwl_umac_scan_channel_survey_notif))
300 CMD_VERSIONS(mfuart_notif,
301 	     CMD_VER_ENTRY(2, iwl_mfuart_load_notif))
302 CMD_VERSIONS(update_mcc,
303 	     CMD_VER_ENTRY(1, iwl_mcc_chub_notif))
304 CMD_VERSIONS(session_prot_notif,
305 	     CMD_VER_ENTRY(3, iwl_session_prot_notif))
306 CMD_VERSIONS(missed_beacon_notif,
307 	     CMD_VER_ENTRY(5, iwl_missed_beacons_notif))
308 CMD_VERSIONS(tx_resp_notif,
309 	     CMD_VER_ENTRY(8, iwl_tx_resp)
310 	     CMD_VER_ENTRY(9, iwl_tx_resp))
311 CMD_VERSIONS(compressed_ba_notif,
312 	     CMD_VER_ENTRY(5, iwl_compressed_ba_notif)
313 	     CMD_VER_ENTRY(6, iwl_compressed_ba_notif)
314 	     CMD_VER_ENTRY(7, iwl_compressed_ba_notif))
315 CMD_VERSIONS(tlc_notif,
316 	     CMD_VER_ENTRY(3, iwl_tlc_update_notif)
317 	     CMD_VER_ENTRY(4, iwl_tlc_update_notif))
318 CMD_VERSIONS(mu_mimo_grp_notif,
319 	     CMD_VER_ENTRY(1, iwl_mu_group_mgmt_notif))
320 CMD_VERSIONS(channel_switch_start_notif,
321 	     CMD_VER_ENTRY(3, iwl_channel_switch_start_notif))
322 CMD_VERSIONS(channel_switch_error_notif,
323 	     CMD_VER_ENTRY(2, iwl_channel_switch_error_notif))
324 CMD_VERSIONS(ct_kill_notif,
325 	     CMD_VER_ENTRY(2, ct_kill_notif))
326 CMD_VERSIONS(temp_notif,
327 	     CMD_VER_ENTRY(2, iwl_dts_measurement_notif))
328 CMD_VERSIONS(roc_notif,
329 	     CMD_VER_ENTRY(1, iwl_roc_notif))
330 CMD_VERSIONS(probe_resp_data_notif,
331 	     CMD_VER_ENTRY(1, iwl_probe_resp_data_notif))
332 CMD_VERSIONS(datapath_monitor_notif,
333 	     CMD_VER_ENTRY(1, iwl_datapath_monitor_notif))
334 CMD_VERSIONS(stats_oper_notif,
335 	     CMD_VER_ENTRY(3, iwl_system_statistics_notif_oper))
336 CMD_VERSIONS(stats_oper_part1_notif,
337 	     CMD_VER_ENTRY(4, iwl_system_statistics_part1_notif_oper))
338 CMD_VERSIONS(bt_coex_notif,
339 	     CMD_VER_ENTRY(1, iwl_bt_coex_profile_notif))
340 CMD_VERSIONS(beacon_notification,
341 	     CMD_VER_ENTRY(6, iwl_extended_beacon_notif))
342 CMD_VERSIONS(emlsr_mode_notif,
343 	     CMD_VER_ENTRY(1, iwl_esr_mode_notif_v1)
344 	     CMD_VER_ENTRY(2, iwl_esr_mode_notif))
345 CMD_VERSIONS(emlsr_trans_fail_notif,
346 	     CMD_VER_ENTRY(1, iwl_esr_trans_fail_notif))
347 CMD_VERSIONS(uapsd_misbehaving_ap_notif,
348 	     CMD_VER_ENTRY(1, iwl_uapsd_misbehaving_ap_notif))
349 CMD_VERSIONS(time_msmt_notif,
350 	     CMD_VER_ENTRY(1, iwl_time_msmt_notify))
351 CMD_VERSIONS(time_sync_confirm_notif,
352 	     CMD_VER_ENTRY(1, iwl_time_msmt_cfm_notify))
353 CMD_VERSIONS(omi_status_notif,
354 	     CMD_VER_ENTRY(2, iwl_omi_send_status_notif))
355 CMD_VERSIONS(ftm_resp_notif, CMD_VER_ENTRY(10, iwl_tof_range_rsp_ntfy))
356 CMD_VERSIONS(beacon_filter_notif, CMD_VER_ENTRY(2, iwl_beacon_filter_notif))
357 
358 DEFINE_SIMPLE_CANCELLATION(session_prot, iwl_session_prot_notif, mac_link_id)
359 DEFINE_SIMPLE_CANCELLATION(tlc, iwl_tlc_update_notif, sta_id)
360 DEFINE_SIMPLE_CANCELLATION(channel_switch_start,
361 			   iwl_channel_switch_start_notif, link_id)
362 DEFINE_SIMPLE_CANCELLATION(channel_switch_error,
363 			   iwl_channel_switch_error_notif, link_id)
364 DEFINE_SIMPLE_CANCELLATION(datapath_monitor, iwl_datapath_monitor_notif,
365 			   link_id)
366 DEFINE_SIMPLE_CANCELLATION(roc, iwl_roc_notif, activity)
367 DEFINE_SIMPLE_CANCELLATION(scan_complete, iwl_umac_scan_complete, uid)
368 DEFINE_SIMPLE_CANCELLATION(probe_resp_data, iwl_probe_resp_data_notif,
369 			   mac_id)
370 DEFINE_SIMPLE_CANCELLATION(uapsd_misbehaving_ap, iwl_uapsd_misbehaving_ap_notif,
371 			   mac_id)
372 #define iwl_mld_cancel_omi_status_notif iwl_mld_always_cancel
373 DEFINE_SIMPLE_CANCELLATION(ftm_resp, iwl_tof_range_rsp_ntfy, request_id)
374 DEFINE_SIMPLE_CANCELLATION(beacon_filter, iwl_beacon_filter_notif, link_id)
375 
376 /**
377  * DOC: Handlers for fw notifications
378  *
379  * Here are listed the notifications IDs (including the group ID), the handler
380  * of the notification and how it should be called:
381  *
382  *  - RX_HANDLER_SYNC: will be called as part of the Rx path
383  *  - RX_HANDLER_ASYNC: will be handled in a working with the wiphy_lock held
384  *
385  * This means that if the firmware sends two notifications A and B in that
386  * order and notification A is RX_HANDLER_ASYNC and notification is
387  * RX_HANDLER_SYNC, the handler of B will likely be called before the handler
388  * of A.
389  *
390  * This list should be in order of frequency for performance purposes.
391  * The handler can be one from two contexts, see &iwl_rx_handler_context
392  *
393  * A handler can declare that it relies on a specific object in which case it
394  * can be cancelled in case the object is deleted. In order to use this
395  * mechanism, a cancellation function is needed. The cancellation function must
396  * receive an object id (the index of that object in the firmware) and a
397  * notification payload. It'll return true if that specific notification should
398  * be cancelled upon the obliteration of the specific instance of the object.
399  *
400  * DEFINE_SIMPLE_CANCELLATION allows to easily create a cancellation function
401  * that wills simply return true if a given object id matches the object id in
402  * the firmware notification.
403  */
404 
405 VISIBLE_IF_IWLWIFI_KUNIT
406 const struct iwl_rx_handler iwl_mld_rx_handlers[] = {
407 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP, TX_CMD, tx_resp_notif,
408 			     RX_HANDLER_SYNC)
409 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP, BA_NOTIF, compressed_ba_notif,
410 			     RX_HANDLER_SYNC)
411 	RX_HANDLER_OF_SCAN(LEGACY_GROUP, SCAN_COMPLETE_UMAC,
412 			   scan_complete_notif)
413 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP, SCAN_ITERATION_COMPLETE_UMAC,
414 			     scan_iter_complete_notif,
415 			     RX_HANDLER_SYNC)
416 	RX_HANDLER_NO_VAL(LEGACY_GROUP, MATCH_FOUND_NOTIFICATION,
417 			  match_found_notif, RX_HANDLER_SYNC)
418 
419 	RX_HANDLER_NO_OBJECT(SCAN_GROUP, CHANNEL_SURVEY_NOTIF,
420 			     channel_survey_notif,
421 			     RX_HANDLER_ASYNC)
422 
423 	RX_HANDLER_NO_OBJECT(STATISTICS_GROUP, STATISTICS_OPER_NOTIF,
424 			     stats_oper_notif, RX_HANDLER_ASYNC)
425 	RX_HANDLER_NO_OBJECT(STATISTICS_GROUP, STATISTICS_OPER_PART1_NOTIF,
426 			     stats_oper_part1_notif, RX_HANDLER_ASYNC)
427 
428 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP, MFUART_LOAD_NOTIFICATION,
429 			     mfuart_notif, RX_HANDLER_SYNC)
430 
431 	RX_HANDLER_NO_OBJECT(PHY_OPS_GROUP, DTS_MEASUREMENT_NOTIF_WIDE,
432 			     temp_notif, RX_HANDLER_ASYNC)
433 	RX_HANDLER_OF_LINK(MAC_CONF_GROUP, SESSION_PROTECTION_NOTIF,
434 			   session_prot_notif)
435 	RX_HANDLER_OF_LINK(MAC_CONF_GROUP, MISSED_BEACONS_NOTIF,
436 			   missed_beacon_notif)
437 	RX_HANDLER_OF_STA(DATA_PATH_GROUP, TLC_MNG_UPDATE_NOTIF, tlc_notif)
438 	RX_HANDLER_OF_LINK(MAC_CONF_GROUP, CHANNEL_SWITCH_START_NOTIF,
439 			   channel_switch_start_notif)
440 	RX_HANDLER_OF_LINK(MAC_CONF_GROUP, CHANNEL_SWITCH_ERROR_NOTIF,
441 			   channel_switch_error_notif)
442 	RX_HANDLER_OF_ROC(MAC_CONF_GROUP, ROC_NOTIF, roc_notif)
443 	RX_HANDLER_NO_OBJECT(DATA_PATH_GROUP, MU_GROUP_MGMT_NOTIF,
444 			     mu_mimo_grp_notif, RX_HANDLER_SYNC)
445 	RX_HANDLER_OF_VIF(MAC_CONF_GROUP, PROBE_RESPONSE_DATA_NOTIF,
446 			  probe_resp_data_notif)
447 	RX_HANDLER_NO_OBJECT(PHY_OPS_GROUP, CT_KILL_NOTIFICATION,
448 			     ct_kill_notif, RX_HANDLER_ASYNC)
449 	RX_HANDLER_OF_LINK(DATA_PATH_GROUP, MONITOR_NOTIF,
450 			   datapath_monitor_notif)
451 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP, MCC_CHUB_UPDATE_CMD, update_mcc,
452 			     RX_HANDLER_ASYNC)
453 	RX_HANDLER_NO_OBJECT(BT_COEX_GROUP, PROFILE_NOTIF,
454 			     bt_coex_notif, RX_HANDLER_ASYNC)
455 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP, BEACON_NOTIFICATION,
456 			     beacon_notification, RX_HANDLER_ASYNC)
457 	RX_HANDLER_NO_OBJECT(DATA_PATH_GROUP, ESR_MODE_NOTIF,
458 			     emlsr_mode_notif, RX_HANDLER_ASYNC)
459 	RX_HANDLER_NO_OBJECT(MAC_CONF_GROUP, EMLSR_TRANS_FAIL_NOTIF,
460 			     emlsr_trans_fail_notif, RX_HANDLER_ASYNC)
461 	RX_HANDLER_OF_VIF(LEGACY_GROUP, PSM_UAPSD_AP_MISBEHAVING_NOTIFICATION,
462 			  uapsd_misbehaving_ap_notif)
463 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP,
464 			     WNM_80211V_TIMING_MEASUREMENT_NOTIFICATION,
465 			     time_msmt_notif, RX_HANDLER_SYNC)
466 	RX_HANDLER_NO_OBJECT(LEGACY_GROUP,
467 			     WNM_80211V_TIMING_MEASUREMENT_CONFIRM_NOTIFICATION,
468 			     time_sync_confirm_notif, RX_HANDLER_ASYNC)
469 	RX_HANDLER_OF_LINK(DATA_PATH_GROUP, OMI_SEND_STATUS_NOTIF,
470 			   omi_status_notif)
471 	RX_HANDLER_OF_LINK(DATA_PATH_GROUP, BEACON_FILTER_IN_NOTIF,
472 			   beacon_filter_notif)
473 	RX_HANDLER_OF_FTM_REQ(LOCATION_GROUP, TOF_RANGE_RESPONSE_NOTIF,
474 			      ftm_resp_notif)
475 };
476 EXPORT_SYMBOL_IF_IWLWIFI_KUNIT(iwl_mld_rx_handlers);
477 
478 #if IS_ENABLED(CONFIG_IWLWIFI_KUNIT_TESTS)
479 const unsigned int iwl_mld_rx_handlers_num = ARRAY_SIZE(iwl_mld_rx_handlers);
480 EXPORT_SYMBOL_IF_IWLWIFI_KUNIT(iwl_mld_rx_handlers_num);
481 #endif
482 
483 static bool
484 iwl_mld_notif_is_valid(struct iwl_mld *mld, struct iwl_rx_packet *pkt,
485 		       const struct iwl_rx_handler *handler)
486 {
487 	unsigned int size = iwl_rx_packet_payload_len(pkt);
488 	size_t notif_ver;
489 
490 	/* If n_sizes == 0, it indicates that a validation function may be used
491 	 * or that no validation is required.
492 	 */
493 	if (!handler->n_sizes) {
494 		if (handler->val_fn)
495 			return handler->val_fn(mld, pkt);
496 		return true;
497 	}
498 
499 	notif_ver = iwl_fw_lookup_notif_ver(mld->fw,
500 					    iwl_cmd_groupid(handler->cmd_id),
501 					    iwl_cmd_opcode(handler->cmd_id),
502 					    IWL_FW_CMD_VER_UNKNOWN);
503 
504 	for (int i = 0; i < handler->n_sizes; i++) {
505 		if (handler->sizes[i].ver != notif_ver)
506 			continue;
507 
508 		if (IWL_FW_CHECK(mld, size < handler->sizes[i].size,
509 				 "unexpected notification 0x%04x size %d, need %d\n",
510 				 handler->cmd_id, size, handler->sizes[i].size))
511 			return false;
512 		return true;
513 	}
514 
515 	IWL_FW_CHECK_FAILED(mld,
516 			    "notif 0x%04x ver %zu missing expected size, use version %u size\n",
517 			    handler->cmd_id, notif_ver,
518 			    handler->sizes[handler->n_sizes - 1].ver);
519 
520 	return size < handler->sizes[handler->n_sizes - 1].size;
521 }
522 
523 struct iwl_async_handler_entry {
524 	struct list_head list;
525 	struct iwl_rx_cmd_buffer rxb;
526 	const struct iwl_rx_handler *rx_h;
527 };
528 
529 static void
530 iwl_mld_log_async_handler_op(struct iwl_mld *mld, const char *op,
531 			     struct iwl_rx_cmd_buffer *rxb)
532 {
533 	struct iwl_rx_packet *pkt = rxb_addr(rxb);
534 
535 	IWL_DEBUG_HC(mld,
536 		     "%s async handler for notif %s (%.2x.%2x, seq 0x%x)\n",
537 		     op, iwl_get_cmd_string(mld->trans,
538 		     WIDE_ID(pkt->hdr.group_id, pkt->hdr.cmd)),
539 		     pkt->hdr.group_id, pkt->hdr.cmd,
540 		     le16_to_cpu(pkt->hdr.sequence));
541 }
542 
543 static void iwl_mld_rx_notif(struct iwl_mld *mld,
544 			     struct iwl_rx_cmd_buffer *rxb,
545 			     struct iwl_rx_packet *pkt)
546 {
547 	for (int i = 0; i < ARRAY_SIZE(iwl_mld_rx_handlers); i++) {
548 		const struct iwl_rx_handler *rx_h = &iwl_mld_rx_handlers[i];
549 		struct iwl_async_handler_entry *entry;
550 
551 		if (rx_h->cmd_id != WIDE_ID(pkt->hdr.group_id, pkt->hdr.cmd))
552 			continue;
553 
554 		if (!iwl_mld_notif_is_valid(mld, pkt, rx_h))
555 			return;
556 
557 		if (rx_h->context == RX_HANDLER_SYNC) {
558 			rx_h->fn(mld, pkt);
559 			break;
560 		}
561 
562 		entry = kzalloc(sizeof(*entry), GFP_ATOMIC);
563 		/* we can't do much... */
564 		if (!entry)
565 			return;
566 
567 		/* Set the async handler entry */
568 		entry->rxb._page = rxb_steal_page(rxb);
569 		entry->rxb._offset = rxb->_offset;
570 		entry->rxb._rx_page_order = rxb->_rx_page_order;
571 
572 		entry->rx_h = rx_h;
573 
574 		/* Add it to the list and queue the work */
575 		spin_lock(&mld->async_handlers_lock);
576 		list_add_tail(&entry->list, &mld->async_handlers_list);
577 		spin_unlock(&mld->async_handlers_lock);
578 
579 		wiphy_work_queue(mld->hw->wiphy,
580 				 &mld->async_handlers_wk);
581 
582 		iwl_mld_log_async_handler_op(mld, "Queued", rxb);
583 		break;
584 	}
585 
586 	iwl_notification_wait_notify(&mld->notif_wait, pkt);
587 }
588 
589 void iwl_mld_rx(struct iwl_op_mode *op_mode, struct napi_struct *napi,
590 		struct iwl_rx_cmd_buffer *rxb)
591 {
592 	struct iwl_rx_packet *pkt = rxb_addr(rxb);
593 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
594 	u16 cmd_id = WIDE_ID(pkt->hdr.group_id, pkt->hdr.cmd);
595 
596 	if (likely(cmd_id == WIDE_ID(LEGACY_GROUP, REPLY_RX_MPDU_CMD)))
597 		iwl_mld_rx_mpdu(mld, napi, rxb, 0);
598 	else if (cmd_id == WIDE_ID(LEGACY_GROUP, FRAME_RELEASE))
599 		iwl_mld_handle_frame_release_notif(mld, napi, pkt, 0);
600 	else if (cmd_id == WIDE_ID(LEGACY_GROUP, BAR_FRAME_RELEASE))
601 		iwl_mld_handle_bar_frame_release_notif(mld, napi, pkt, 0);
602 	else if (unlikely(cmd_id == WIDE_ID(DATA_PATH_GROUP,
603 					    RX_QUEUES_NOTIFICATION)))
604 		iwl_mld_handle_rx_queues_sync_notif(mld, napi, pkt, 0);
605 	else if (cmd_id == WIDE_ID(DATA_PATH_GROUP, RX_NO_DATA_NOTIF))
606 		iwl_mld_rx_monitor_no_data(mld, napi, pkt, 0);
607 	else
608 		iwl_mld_rx_notif(mld, rxb, pkt);
609 }
610 
611 void iwl_mld_rx_rss(struct iwl_op_mode *op_mode, struct napi_struct *napi,
612 		    struct iwl_rx_cmd_buffer *rxb, unsigned int queue)
613 {
614 	struct iwl_rx_packet *pkt = rxb_addr(rxb);
615 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
616 	u16 cmd_id = WIDE_ID(pkt->hdr.group_id, pkt->hdr.cmd);
617 
618 	if (unlikely(queue >= mld->trans->info.num_rxqs))
619 		return;
620 
621 	if (likely(cmd_id == WIDE_ID(LEGACY_GROUP, REPLY_RX_MPDU_CMD)))
622 		iwl_mld_rx_mpdu(mld, napi, rxb, queue);
623 	else if (unlikely(cmd_id == WIDE_ID(DATA_PATH_GROUP,
624 					    RX_QUEUES_NOTIFICATION)))
625 		iwl_mld_handle_rx_queues_sync_notif(mld, napi, pkt, queue);
626 	else if (unlikely(cmd_id == WIDE_ID(LEGACY_GROUP, FRAME_RELEASE)))
627 		iwl_mld_handle_frame_release_notif(mld, napi, pkt, queue);
628 }
629 
630 void iwl_mld_delete_handlers(struct iwl_mld *mld, const u16 *cmds, int n_cmds)
631 {
632 	struct iwl_async_handler_entry *entry, *tmp;
633 
634 	spin_lock_bh(&mld->async_handlers_lock);
635 	list_for_each_entry_safe(entry, tmp, &mld->async_handlers_list, list) {
636 		bool match = false;
637 
638 		for (int i = 0; i < n_cmds; i++) {
639 			if (entry->rx_h->cmd_id == cmds[i]) {
640 				match = true;
641 				break;
642 			}
643 		}
644 
645 		if (!match)
646 			continue;
647 
648 		iwl_mld_log_async_handler_op(mld, "Delete", &entry->rxb);
649 		iwl_free_rxb(&entry->rxb);
650 		list_del(&entry->list);
651 		kfree(entry);
652 	}
653 	spin_unlock_bh(&mld->async_handlers_lock);
654 }
655 
656 void iwl_mld_async_handlers_wk(struct wiphy *wiphy, struct wiphy_work *wk)
657 {
658 	struct iwl_mld *mld =
659 		container_of(wk, struct iwl_mld, async_handlers_wk);
660 	struct iwl_async_handler_entry *entry, *tmp;
661 	LIST_HEAD(local_list);
662 
663 	/* Sync with Rx path with a lock. Remove all the entries from this
664 	 * list, add them to a local one (lock free), and then handle them.
665 	 */
666 	spin_lock_bh(&mld->async_handlers_lock);
667 	list_splice_init(&mld->async_handlers_list, &local_list);
668 	spin_unlock_bh(&mld->async_handlers_lock);
669 
670 	list_for_each_entry_safe(entry, tmp, &local_list, list) {
671 		iwl_mld_log_async_handler_op(mld, "Handle", &entry->rxb);
672 		entry->rx_h->fn(mld, rxb_addr(&entry->rxb));
673 		iwl_free_rxb(&entry->rxb);
674 		list_del(&entry->list);
675 		kfree(entry);
676 	}
677 }
678 
679 void iwl_mld_cancel_async_notifications(struct iwl_mld *mld)
680 {
681 	struct iwl_async_handler_entry *entry, *tmp;
682 
683 	lockdep_assert_wiphy(mld->wiphy);
684 
685 	wiphy_work_cancel(mld->wiphy, &mld->async_handlers_wk);
686 
687 	spin_lock_bh(&mld->async_handlers_lock);
688 	list_for_each_entry_safe(entry, tmp, &mld->async_handlers_list, list) {
689 		iwl_mld_log_async_handler_op(mld, "Purged", &entry->rxb);
690 		iwl_free_rxb(&entry->rxb);
691 		list_del(&entry->list);
692 		kfree(entry);
693 	}
694 	spin_unlock_bh(&mld->async_handlers_lock);
695 }
696 
697 void iwl_mld_cancel_notifications_of_object(struct iwl_mld *mld,
698 					    enum iwl_mld_object_type obj_type,
699 					    u32 obj_id)
700 {
701 	struct iwl_async_handler_entry *entry, *tmp;
702 	LIST_HEAD(cancel_list);
703 
704 	lockdep_assert_wiphy(mld->wiphy);
705 
706 	if (WARN_ON(obj_type == IWL_MLD_OBJECT_TYPE_NONE))
707 		return;
708 
709 	/* Sync with RX path and remove matching entries from the async list */
710 	spin_lock_bh(&mld->async_handlers_lock);
711 	list_for_each_entry_safe(entry, tmp, &mld->async_handlers_list, list) {
712 		const struct iwl_rx_handler *rx_h = entry->rx_h;
713 
714 		if (rx_h->obj_type != obj_type || WARN_ON(!rx_h->cancel))
715 			continue;
716 
717 		if (rx_h->cancel(mld, rxb_addr(&entry->rxb), obj_id)) {
718 			iwl_mld_log_async_handler_op(mld, "Cancel", &entry->rxb);
719 			list_del(&entry->list);
720 			list_add_tail(&entry->list, &cancel_list);
721 		}
722 	}
723 
724 	spin_unlock_bh(&mld->async_handlers_lock);
725 
726 	/* Free the matching entries outside of the spinlock */
727 	list_for_each_entry_safe(entry, tmp, &cancel_list, list) {
728 		iwl_free_rxb(&entry->rxb);
729 		list_del(&entry->list);
730 		kfree(entry);
731 	}
732 }
733