xref: /linux/drivers/net/wireless/intel/iwlwifi/mld/mld.c (revision a34b0e4e21d6be3c3d620aa7f9dfbf0e9550c19e)
1 // SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause
2 /*
3  * Copyright (C) 2024-2025 Intel Corporation
4  */
5 #include <linux/rtnetlink.h>
6 #include <net/mac80211.h>
7 
8 #include "fw/api/rx.h"
9 #include "fw/api/datapath.h"
10 #include "fw/api/commands.h"
11 #include "fw/api/offload.h"
12 #include "fw/api/coex.h"
13 #include "fw/dbg.h"
14 #include "fw/uefi.h"
15 
16 #include "mld.h"
17 #include "mlo.h"
18 #include "mac80211.h"
19 #include "led.h"
20 #include "scan.h"
21 #include "tx.h"
22 #include "sta.h"
23 #include "regulatory.h"
24 #include "thermal.h"
25 #include "low_latency.h"
26 #include "hcmd.h"
27 #include "fw/api/location.h"
28 
29 #include "iwl-nvm-parse.h"
30 
31 #define DRV_DESCRIPTION "Intel(R) MLD wireless driver for Linux"
32 MODULE_DESCRIPTION(DRV_DESCRIPTION);
33 MODULE_LICENSE("GPL");
34 MODULE_IMPORT_NS("IWLWIFI");
35 
36 static const struct iwl_op_mode_ops iwl_mld_ops;
37 
38 static int __init iwl_mld_init(void)
39 {
40 	int ret = iwl_opmode_register("iwlmld", &iwl_mld_ops);
41 
42 	if (ret)
43 		pr_err("Unable to register MLD op_mode: %d\n", ret);
44 
45 	return ret;
46 }
47 module_init(iwl_mld_init);
48 
49 static void __exit iwl_mld_exit(void)
50 {
51 	iwl_opmode_deregister("iwlmld");
52 }
53 module_exit(iwl_mld_exit);
54 
55 static void iwl_mld_hw_set_regulatory(struct iwl_mld *mld)
56 {
57 	struct wiphy *wiphy = mld->wiphy;
58 
59 	wiphy->regulatory_flags |= REGULATORY_WIPHY_SELF_MANAGED;
60 	wiphy->regulatory_flags |= REGULATORY_ENABLE_RELAX_NO_IR;
61 }
62 
63 VISIBLE_IF_IWLWIFI_KUNIT
64 void iwl_construct_mld(struct iwl_mld *mld, struct iwl_trans *trans,
65 		       const struct iwl_rf_cfg *cfg, const struct iwl_fw *fw,
66 		       struct ieee80211_hw *hw, struct dentry *dbgfs_dir)
67 {
68 	mld->dev = trans->dev;
69 	mld->trans = trans;
70 	mld->cfg = cfg;
71 	mld->fw = fw;
72 	mld->hw = hw;
73 	mld->wiphy = hw->wiphy;
74 	mld->debugfs_dir = dbgfs_dir;
75 
76 	iwl_notification_wait_init(&mld->notif_wait);
77 
78 	/* Setup async RX handling */
79 	spin_lock_init(&mld->async_handlers_lock);
80 	INIT_LIST_HEAD(&mld->async_handlers_list);
81 	wiphy_work_init(&mld->async_handlers_wk,
82 			iwl_mld_async_handlers_wk);
83 
84 	/* Dynamic Queue Allocation */
85 	spin_lock_init(&mld->add_txqs_lock);
86 	INIT_LIST_HEAD(&mld->txqs_to_add);
87 	wiphy_work_init(&mld->add_txqs_wk, iwl_mld_add_txqs_wk);
88 
89 	/* Setup RX queues sync wait queue */
90 	init_waitqueue_head(&mld->rxq_sync.waitq);
91 }
92 EXPORT_SYMBOL_IF_IWLWIFI_KUNIT(iwl_construct_mld);
93 
94 static void __acquires(&mld->wiphy->mtx)
95 iwl_mld_fwrt_dump_start(void *ctx)
96 {
97 	struct iwl_mld *mld = ctx;
98 
99 	wiphy_lock(mld->wiphy);
100 }
101 
102 static void __releases(&mld->wiphy->mtx)
103 iwl_mld_fwrt_dump_end(void *ctx)
104 {
105 	struct iwl_mld *mld = ctx;
106 
107 	wiphy_unlock(mld->wiphy);
108 }
109 
110 static bool iwl_mld_d3_debug_enable(void *ctx)
111 {
112 	return IWL_MLD_D3_DEBUG;
113 }
114 
115 static int iwl_mld_fwrt_send_hcmd(void *ctx, struct iwl_host_cmd *host_cmd)
116 {
117 	struct iwl_mld *mld = (struct iwl_mld *)ctx;
118 	int ret;
119 
120 	wiphy_lock(mld->wiphy);
121 	ret = iwl_mld_send_cmd(mld, host_cmd);
122 	wiphy_unlock(mld->wiphy);
123 
124 	return ret;
125 }
126 
127 static const struct iwl_fw_runtime_ops iwl_mld_fwrt_ops = {
128 	.dump_start = iwl_mld_fwrt_dump_start,
129 	.dump_end = iwl_mld_fwrt_dump_end,
130 	.send_hcmd = iwl_mld_fwrt_send_hcmd,
131 	.d3_debug_enable = iwl_mld_d3_debug_enable,
132 };
133 
134 static void
135 iwl_mld_construct_fw_runtime(struct iwl_mld *mld, struct iwl_trans *trans,
136 			     const struct iwl_fw *fw,
137 			     struct dentry *debugfs_dir)
138 {
139 	iwl_fw_runtime_init(&mld->fwrt, trans, fw, &iwl_mld_fwrt_ops, mld,
140 			    NULL, NULL, debugfs_dir);
141 
142 	iwl_fw_set_current_image(&mld->fwrt, IWL_UCODE_REGULAR);
143 }
144 
145 /* Please keep this array *SORTED* by hex value.
146  * Access is done through binary search
147  */
148 static const struct iwl_hcmd_names iwl_mld_legacy_names[] = {
149 	HCMD_NAME(UCODE_ALIVE_NTFY),
150 	HCMD_NAME(REPLY_ERROR),
151 	HCMD_NAME(INIT_COMPLETE_NOTIF),
152 	HCMD_NAME(PHY_CONTEXT_CMD),
153 	HCMD_NAME(SCAN_CFG_CMD),
154 	HCMD_NAME(SCAN_REQ_UMAC),
155 	HCMD_NAME(SCAN_ABORT_UMAC),
156 	HCMD_NAME(SCAN_COMPLETE_UMAC),
157 	HCMD_NAME(TX_CMD),
158 	HCMD_NAME(TXPATH_FLUSH),
159 	HCMD_NAME(LEDS_CMD),
160 	HCMD_NAME(WNM_80211V_TIMING_MEASUREMENT_NOTIFICATION),
161 	HCMD_NAME(WNM_80211V_TIMING_MEASUREMENT_CONFIRM_NOTIFICATION),
162 	HCMD_NAME(PHY_CONFIGURATION_CMD),
163 	HCMD_NAME(SCAN_OFFLOAD_UPDATE_PROFILES_CMD),
164 	HCMD_NAME(POWER_TABLE_CMD),
165 	HCMD_NAME(PSM_UAPSD_AP_MISBEHAVING_NOTIFICATION),
166 	HCMD_NAME(BEACON_NOTIFICATION),
167 	HCMD_NAME(BEACON_TEMPLATE_CMD),
168 	HCMD_NAME(TX_ANT_CONFIGURATION_CMD),
169 	HCMD_NAME(BT_CONFIG),
170 	HCMD_NAME(REDUCE_TX_POWER_CMD),
171 	HCMD_NAME(MISSED_BEACONS_NOTIFICATION),
172 	HCMD_NAME(MAC_PM_POWER_TABLE),
173 	HCMD_NAME(MFUART_LOAD_NOTIFICATION),
174 	HCMD_NAME(RSS_CONFIG_CMD),
175 	HCMD_NAME(SCAN_ITERATION_COMPLETE_UMAC),
176 	HCMD_NAME(REPLY_RX_MPDU_CMD),
177 	HCMD_NAME(BA_NOTIF),
178 	HCMD_NAME(MCC_UPDATE_CMD),
179 	HCMD_NAME(MCC_CHUB_UPDATE_CMD),
180 	HCMD_NAME(MCAST_FILTER_CMD),
181 	HCMD_NAME(REPLY_BEACON_FILTERING_CMD),
182 	HCMD_NAME(PROT_OFFLOAD_CONFIG_CMD),
183 	HCMD_NAME(MATCH_FOUND_NOTIFICATION),
184 	HCMD_NAME(WOWLAN_PATTERNS),
185 	HCMD_NAME(WOWLAN_CONFIGURATION),
186 	HCMD_NAME(WOWLAN_TSC_RSC_PARAM),
187 	HCMD_NAME(WOWLAN_KEK_KCK_MATERIAL),
188 	HCMD_NAME(DEBUG_HOST_COMMAND),
189 	HCMD_NAME(LDBG_CONFIG_CMD),
190 };
191 
192 /* Please keep this array *SORTED* by hex value.
193  * Access is done through binary search
194  */
195 static const struct iwl_hcmd_names iwl_mld_system_names[] = {
196 	HCMD_NAME(SHARED_MEM_CFG_CMD),
197 	HCMD_NAME(SOC_CONFIGURATION_CMD),
198 	HCMD_NAME(INIT_EXTENDED_CFG_CMD),
199 	HCMD_NAME(FW_ERROR_RECOVERY_CMD),
200 	HCMD_NAME(RFI_CONFIG_CMD),
201 	HCMD_NAME(RFI_GET_FREQ_TABLE_CMD),
202 	HCMD_NAME(SYSTEM_STATISTICS_CMD),
203 	HCMD_NAME(SYSTEM_STATISTICS_END_NOTIF),
204 };
205 
206 /* Please keep this array *SORTED* by hex value.
207  * Access is done through binary search
208  */
209 static const struct iwl_hcmd_names iwl_mld_reg_and_nvm_names[] = {
210 	HCMD_NAME(LARI_CONFIG_CHANGE),
211 	HCMD_NAME(NVM_GET_INFO),
212 	HCMD_NAME(TAS_CONFIG),
213 	HCMD_NAME(SAR_OFFSET_MAPPING_TABLE_CMD),
214 	HCMD_NAME(MCC_ALLOWED_AP_TYPE_CMD),
215 };
216 
217 /* Please keep this array *SORTED* by hex value.
218  * Access is done through binary search
219  */
220 static const struct iwl_hcmd_names iwl_mld_debug_names[] = {
221 	HCMD_NAME(HOST_EVENT_CFG),
222 	HCMD_NAME(DBGC_SUSPEND_RESUME),
223 };
224 
225 /* Please keep this array *SORTED* by hex value.
226  * Access is done through binary search
227  */
228 static const struct iwl_hcmd_names iwl_mld_mac_conf_names[] = {
229 	HCMD_NAME(LOW_LATENCY_CMD),
230 	HCMD_NAME(SESSION_PROTECTION_CMD),
231 	HCMD_NAME(MAC_CONFIG_CMD),
232 	HCMD_NAME(LINK_CONFIG_CMD),
233 	HCMD_NAME(STA_CONFIG_CMD),
234 	HCMD_NAME(AUX_STA_CMD),
235 	HCMD_NAME(STA_REMOVE_CMD),
236 	HCMD_NAME(ROC_CMD),
237 	HCMD_NAME(NAN_CFG_CMD),
238 	HCMD_NAME(NAN_DW_END_NOTIF),
239 	HCMD_NAME(NAN_JOINED_CLUSTER_NOTIF),
240 	HCMD_NAME(MISSED_BEACONS_NOTIF),
241 	HCMD_NAME(EMLSR_TRANS_FAIL_NOTIF),
242 	HCMD_NAME(ROC_NOTIF),
243 	HCMD_NAME(CHANNEL_SWITCH_ERROR_NOTIF),
244 	HCMD_NAME(SESSION_PROTECTION_NOTIF),
245 	HCMD_NAME(PROBE_RESPONSE_DATA_NOTIF),
246 	HCMD_NAME(CHANNEL_SWITCH_START_NOTIF),
247 };
248 
249 /* Please keep this array *SORTED* by hex value.
250  * Access is done through binary search
251  */
252 static const struct iwl_hcmd_names iwl_mld_data_path_names[] = {
253 	HCMD_NAME(TRIGGER_RX_QUEUES_NOTIF_CMD),
254 	HCMD_NAME(WNM_PLATFORM_PTM_REQUEST_CMD),
255 	HCMD_NAME(WNM_80211V_TIMING_MEASUREMENT_CONFIG_CMD),
256 	HCMD_NAME(RFH_QUEUE_CONFIG_CMD),
257 	HCMD_NAME(TLC_MNG_CONFIG_CMD),
258 	HCMD_NAME(RX_BAID_ALLOCATION_CONFIG_CMD),
259 	HCMD_NAME(SCD_QUEUE_CONFIG_CMD),
260 	HCMD_NAME(SEC_KEY_CMD),
261 	HCMD_NAME(ESR_MODE_NOTIF),
262 	HCMD_NAME(MONITOR_NOTIF),
263 	HCMD_NAME(TLC_MNG_UPDATE_NOTIF),
264 	HCMD_NAME(BEACON_FILTER_IN_NOTIF),
265 	HCMD_NAME(PHY_AIR_SNIFFER_NOTIF),
266 	HCMD_NAME(MU_GROUP_MGMT_NOTIF),
267 };
268 
269 /* Please keep this array *SORTED* by hex value.
270  * Access is done through binary search
271  */
272 static const struct iwl_hcmd_names iwl_mld_scan_names[] = {
273 	HCMD_NAME(CHANNEL_SURVEY_NOTIF),
274 };
275 
276 /* Please keep this array *SORTED* by hex value.
277  * Access is done through binary search
278  */
279 static const struct iwl_hcmd_names iwl_mld_location_names[] = {
280 	HCMD_NAME(TOF_RANGE_REQ_CMD),
281 	HCMD_NAME(TOF_RANGE_RESPONSE_NOTIF),
282 };
283 
284 /* Please keep this array *SORTED* by hex value.
285  * Access is done through binary search
286  */
287 static const struct iwl_hcmd_names iwl_mld_phy_names[] = {
288 	HCMD_NAME(CMD_DTS_MEASUREMENT_TRIGGER_WIDE),
289 	HCMD_NAME(CTDP_CONFIG_CMD),
290 	HCMD_NAME(TEMP_REPORTING_THRESHOLDS_CMD),
291 	HCMD_NAME(PER_CHAIN_LIMIT_OFFSET_CMD),
292 	HCMD_NAME(CT_KILL_NOTIFICATION),
293 	HCMD_NAME(DTS_MEASUREMENT_NOTIF_WIDE),
294 };
295 
296 /* Please keep this array *SORTED* by hex value.
297  * Access is done through binary search
298  */
299 static const struct iwl_hcmd_names iwl_mld_statistics_names[] = {
300 	HCMD_NAME(STATISTICS_OPER_NOTIF),
301 	HCMD_NAME(STATISTICS_OPER_PART1_NOTIF),
302 };
303 
304 /* Please keep this array *SORTED* by hex value.
305  * Access is done through binary search
306  */
307 static const struct iwl_hcmd_names iwl_mld_prot_offload_names[] = {
308 	HCMD_NAME(WOWLAN_WAKE_PKT_NOTIFICATION),
309 	HCMD_NAME(WOWLAN_INFO_NOTIFICATION),
310 	HCMD_NAME(D3_END_NOTIFICATION),
311 };
312 
313 /* Please keep this array *SORTED* by hex value.
314  * Access is done through binary search
315  */
316 static const struct iwl_hcmd_names iwl_mld_coex_names[] = {
317 	HCMD_NAME(PROFILE_NOTIF),
318 };
319 
320 VISIBLE_IF_IWLWIFI_KUNIT
321 const struct iwl_hcmd_arr iwl_mld_groups[] = {
322 	[LEGACY_GROUP] = HCMD_ARR(iwl_mld_legacy_names),
323 	[LONG_GROUP] = HCMD_ARR(iwl_mld_legacy_names),
324 	[SYSTEM_GROUP] = HCMD_ARR(iwl_mld_system_names),
325 	[MAC_CONF_GROUP] = HCMD_ARR(iwl_mld_mac_conf_names),
326 	[DATA_PATH_GROUP] = HCMD_ARR(iwl_mld_data_path_names),
327 	[SCAN_GROUP] = HCMD_ARR(iwl_mld_scan_names),
328 	[LOCATION_GROUP] = HCMD_ARR(iwl_mld_location_names),
329 	[REGULATORY_AND_NVM_GROUP] = HCMD_ARR(iwl_mld_reg_and_nvm_names),
330 	[DEBUG_GROUP] = HCMD_ARR(iwl_mld_debug_names),
331 	[PHY_OPS_GROUP] = HCMD_ARR(iwl_mld_phy_names),
332 	[STATISTICS_GROUP] = HCMD_ARR(iwl_mld_statistics_names),
333 	[PROT_OFFLOAD_GROUP] = HCMD_ARR(iwl_mld_prot_offload_names),
334 	[BT_COEX_GROUP] = HCMD_ARR(iwl_mld_coex_names),
335 };
336 EXPORT_SYMBOL_IF_IWLWIFI_KUNIT(iwl_mld_groups);
337 
338 #if IS_ENABLED(CONFIG_IWLWIFI_KUNIT_TESTS)
339 const unsigned int global_iwl_mld_goups_size = ARRAY_SIZE(iwl_mld_groups);
340 EXPORT_SYMBOL_IF_IWLWIFI_KUNIT(global_iwl_mld_goups_size);
341 #endif
342 
343 static void
344 iwl_mld_configure_trans(struct iwl_op_mode *op_mode)
345 {
346 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
347 	static const u8 no_reclaim_cmds[] = {TX_CMD};
348 	struct iwl_trans *trans = mld->trans;
349 	u32 eckv_value;
350 
351 	iwl_bios_setup_step(trans, &mld->fwrt);
352 	iwl_uefi_get_step_table(trans);
353 
354 	if (iwl_bios_get_eckv(&mld->fwrt, &eckv_value))
355 		IWL_DEBUG_RADIO(mld, "ECKV table doesn't exist in BIOS\n");
356 	else
357 		trans->conf.ext_32khz_clock_valid = !!eckv_value;
358 
359 	trans->conf.rx_buf_size = iwl_amsdu_size_to_rxb_size();
360 	trans->conf.command_groups = iwl_mld_groups;
361 	trans->conf.command_groups_size = ARRAY_SIZE(iwl_mld_groups);
362 	trans->conf.fw_reset_handshake = true;
363 	trans->conf.queue_alloc_cmd_ver =
364 		iwl_fw_lookup_cmd_ver(mld->fw, WIDE_ID(DATA_PATH_GROUP,
365 						       SCD_QUEUE_CONFIG_CMD),
366 				      0);
367 	trans->conf.cb_data_offs = offsetof(struct ieee80211_tx_info,
368 					    driver_data[2]);
369 	BUILD_BUG_ON(sizeof(no_reclaim_cmds) >
370 		     sizeof(trans->conf.no_reclaim_cmds));
371 	memcpy(trans->conf.no_reclaim_cmds, no_reclaim_cmds,
372 	       sizeof(no_reclaim_cmds));
373 	trans->conf.n_no_reclaim_cmds = ARRAY_SIZE(no_reclaim_cmds);
374 
375 	trans->conf.rx_mpdu_cmd = REPLY_RX_MPDU_CMD;
376 	trans->conf.rx_mpdu_cmd_hdr_size = sizeof(struct iwl_rx_mpdu_desc);
377 	trans->conf.wide_cmd_header = true;
378 
379 	iwl_trans_op_mode_enter(trans, op_mode);
380 }
381 
382 /*
383  *****************************************************
384  * op mode ops functions
385  *****************************************************
386  */
387 
388 #define NUM_FW_LOAD_RETRIES	3
389 static struct iwl_op_mode *
390 iwl_op_mode_mld_start(struct iwl_trans *trans, const struct iwl_rf_cfg *cfg,
391 		      const struct iwl_fw *fw, struct dentry *dbgfs_dir)
392 {
393 	struct ieee80211_hw *hw;
394 	struct iwl_op_mode *op_mode;
395 	struct iwl_mld *mld;
396 	int ret;
397 
398 	/* Allocate and initialize a new hardware device */
399 	hw = ieee80211_alloc_hw(sizeof(struct iwl_op_mode) +
400 				sizeof(struct iwl_mld),
401 				&iwl_mld_hw_ops);
402 	if (!hw)
403 		return ERR_PTR(-ENOMEM);
404 
405 	op_mode = hw->priv;
406 
407 	op_mode->ops = &iwl_mld_ops;
408 
409 	mld = IWL_OP_MODE_GET_MLD(op_mode);
410 
411 	iwl_construct_mld(mld, trans, cfg, fw, hw, dbgfs_dir);
412 
413 	/* we'll verify later it matches between commands */
414 	mld->fw_rates_ver_3 = iwl_fw_lookup_cmd_ver(mld->fw, TX_CMD, 0) >= 11;
415 
416 	iwl_mld_construct_fw_runtime(mld, trans, fw, dbgfs_dir);
417 
418 	iwl_mld_get_bios_tables(mld);
419 	iwl_uefi_get_sgom_table(trans, &mld->fwrt);
420 	mld->bios_enable_puncturing = iwl_uefi_get_puncturing(&mld->fwrt);
421 
422 	iwl_mld_hw_set_regulatory(mld);
423 
424 	/* Configure transport layer with the opmode specific params */
425 	iwl_mld_configure_trans(op_mode);
426 
427 	/* needed for regulatory init */
428 	rtnl_lock();
429 	/* Needed for sending commands */
430 	wiphy_lock(mld->wiphy);
431 
432 	for (int i = 0; i < NUM_FW_LOAD_RETRIES; i++) {
433 		ret = iwl_mld_load_fw(mld);
434 		if (!ret)
435 			break;
436 	}
437 
438 	if (!ret) {
439 		mld->nvm_data = iwl_get_nvm(mld->trans, mld->fw, 0, 0);
440 		if (IS_ERR(mld->nvm_data)) {
441 			IWL_ERR(mld, "Failed to read NVM: %d\n", ret);
442 			ret = PTR_ERR(mld->nvm_data);
443 		}
444 	}
445 
446 	if (ret) {
447 		wiphy_unlock(mld->wiphy);
448 		rtnl_unlock();
449 		goto err;
450 	}
451 
452 	/* We are about to stop the FW. Notifications may require an
453 	 * operational FW, so handle them all here before we stop.
454 	 */
455 	wiphy_work_flush(mld->wiphy, &mld->async_handlers_wk);
456 
457 	iwl_mld_stop_fw(mld);
458 
459 	wiphy_unlock(mld->wiphy);
460 	rtnl_unlock();
461 
462 	ret = iwl_mld_leds_init(mld);
463 	if (ret)
464 		goto free_nvm;
465 
466 	ret = iwl_mld_alloc_scan_cmd(mld);
467 	if (ret)
468 		goto leds_exit;
469 
470 	ret = iwl_mld_low_latency_init(mld);
471 	if (ret)
472 		goto free_scan_cmd;
473 
474 	ret = iwl_mld_register_hw(mld);
475 	if (ret)
476 		goto low_latency_free;
477 
478 	iwl_mld_toggle_tx_ant(mld, &mld->mgmt_tx_ant);
479 
480 	iwl_mld_add_debugfs_files(mld, dbgfs_dir);
481 	iwl_mld_thermal_initialize(mld);
482 
483 	iwl_mld_ptp_init(mld);
484 
485 	return op_mode;
486 
487 low_latency_free:
488 	iwl_mld_low_latency_free(mld);
489 free_scan_cmd:
490 	kfree(mld->scan.cmd);
491 leds_exit:
492 	iwl_mld_leds_exit(mld);
493 free_nvm:
494 	kfree(mld->nvm_data);
495 err:
496 	iwl_trans_op_mode_leave(mld->trans);
497 	ieee80211_free_hw(mld->hw);
498 	return ERR_PTR(ret);
499 }
500 
501 static void
502 iwl_op_mode_mld_stop(struct iwl_op_mode *op_mode)
503 {
504 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
505 
506 	iwl_mld_ptp_remove(mld);
507 	iwl_mld_leds_exit(mld);
508 
509 	iwl_mld_thermal_exit(mld);
510 
511 	wiphy_lock(mld->wiphy);
512 	iwl_mld_low_latency_stop(mld);
513 	iwl_mld_deinit_time_sync(mld);
514 	wiphy_unlock(mld->wiphy);
515 
516 	ieee80211_unregister_hw(mld->hw);
517 
518 	iwl_fw_runtime_free(&mld->fwrt);
519 	iwl_mld_low_latency_free(mld);
520 
521 	iwl_trans_op_mode_leave(mld->trans);
522 
523 	kfree(mld->nvm_data);
524 	kfree(mld->scan.cmd);
525 	kfree(mld->channel_survey);
526 	kfree(mld->error_recovery_buf);
527 	kfree(mld->mcast_filter_cmd);
528 
529 	ieee80211_free_hw(mld->hw);
530 }
531 
532 static void iwl_mld_queue_state_change(struct iwl_op_mode *op_mode,
533 				       int hw_queue, bool queue_full)
534 {
535 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
536 	struct ieee80211_txq *txq;
537 	struct iwl_mld_sta *mld_sta;
538 	struct iwl_mld_txq *mld_txq;
539 
540 	rcu_read_lock();
541 
542 	txq = rcu_dereference(mld->fw_id_to_txq[hw_queue]);
543 	if (!txq) {
544 		rcu_read_unlock();
545 
546 		if (queue_full) {
547 			/* An internal queue is not expected to become full */
548 			IWL_WARN(mld,
549 				 "Internal hw_queue %d is full! stopping all queues\n",
550 				 hw_queue);
551 			/* Stop all queues, as an internal queue is not
552 			 * mapped to a mac80211 one
553 			 */
554 			ieee80211_stop_queues(mld->hw);
555 		} else {
556 			ieee80211_wake_queues(mld->hw);
557 		}
558 
559 		return;
560 	}
561 
562 	mld_txq = iwl_mld_txq_from_mac80211(txq);
563 	mld_sta = txq->sta ? iwl_mld_sta_from_mac80211(txq->sta) : NULL;
564 
565 	mld_txq->status.stop_full = queue_full;
566 
567 	if (!queue_full && mld_sta &&
568 	    mld_sta->sta_state != IEEE80211_STA_NOTEXIST) {
569 		local_bh_disable();
570 		iwl_mld_tx_from_txq(mld, txq);
571 		local_bh_enable();
572 	}
573 
574 	rcu_read_unlock();
575 }
576 
577 static void
578 iwl_mld_queue_full(struct iwl_op_mode *op_mode, int hw_queue)
579 {
580 	iwl_mld_queue_state_change(op_mode, hw_queue, true);
581 }
582 
583 static void
584 iwl_mld_queue_not_full(struct iwl_op_mode *op_mode, int hw_queue)
585 {
586 	iwl_mld_queue_state_change(op_mode, hw_queue, false);
587 }
588 
589 static bool
590 iwl_mld_set_hw_rfkill_state(struct iwl_op_mode *op_mode, bool state)
591 {
592 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
593 
594 	iwl_mld_set_hwkill(mld, state);
595 
596 	return false;
597 }
598 
599 static void
600 iwl_mld_free_skb(struct iwl_op_mode *op_mode, struct sk_buff *skb)
601 {
602 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
603 	struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
604 
605 	iwl_trans_free_tx_cmd(mld->trans, info->driver_data[1]);
606 	ieee80211_free_txskb(mld->hw, skb);
607 }
608 
609 static void iwl_mld_read_error_recovery_buffer(struct iwl_mld *mld)
610 {
611 	u32 src_size = mld->fw->ucode_capa.error_log_size;
612 	u32 src_addr = mld->fw->ucode_capa.error_log_addr;
613 	u8 *recovery_buf;
614 	int ret;
615 
616 	/* no recovery buffer size defined in a TLV */
617 	if (!src_size)
618 		return;
619 
620 	recovery_buf = kzalloc(src_size, GFP_ATOMIC);
621 	if (!recovery_buf)
622 		return;
623 
624 	ret = iwl_trans_read_mem_bytes(mld->trans, src_addr,
625 				       recovery_buf, src_size);
626 	if (ret) {
627 		IWL_ERR(mld, "Failed to read error recovery buffer (%d)\n",
628 			ret);
629 		kfree(recovery_buf);
630 		return;
631 	}
632 
633 	mld->error_recovery_buf = recovery_buf;
634 }
635 
636 static void iwl_mld_restart_nic(struct iwl_mld *mld)
637 {
638 	iwl_mld_read_error_recovery_buffer(mld);
639 
640 	mld->fwrt.trans->dbg.restart_required = false;
641 
642 	ieee80211_restart_hw(mld->hw);
643 }
644 
645 static void
646 iwl_mld_nic_error(struct iwl_op_mode *op_mode,
647 		  enum iwl_fw_error_type type)
648 {
649 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
650 	bool trans_dead = iwl_trans_is_dead(mld->trans);
651 
652 	if (type == IWL_ERR_TYPE_CMD_QUEUE_FULL)
653 		IWL_ERR(mld, "Command queue full!\n");
654 	else if (!trans_dead && !mld->fw_status.do_not_dump_once)
655 		iwl_fwrt_dump_error_logs(&mld->fwrt);
656 
657 	mld->fw_status.do_not_dump_once = false;
658 
659 	/* It is necessary to abort any os scan here because mac80211 requires
660 	 * having the scan cleared before restarting.
661 	 * We'll reset the scan_status to NONE in restart cleanup in
662 	 * the next drv_start() call from mac80211. If ieee80211_hw_restart
663 	 * isn't called scan status will stay busy.
664 	 */
665 	iwl_mld_report_scan_aborted(mld);
666 
667 	/*
668 	 * This should be first thing before trying to collect any
669 	 * data to avoid endless loops if any HW error happens while
670 	 * collecting debug data.
671 	 * It might not actually be true that we'll restart, but the
672 	 * setting doesn't matter if we're going to be unbound either.
673 	 */
674 	if (type != IWL_ERR_TYPE_RESET_HS_TIMEOUT &&
675 	    mld->fw_status.running)
676 		mld->fw_status.in_hw_restart = true;
677 }
678 
679 static void iwl_mld_dump_error(struct iwl_op_mode *op_mode,
680 			       struct iwl_fw_error_dump_mode *mode)
681 {
682 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
683 
684 	/* if we come in from opmode we have the mutex held */
685 	if (mode->context == IWL_ERR_CONTEXT_FROM_OPMODE) {
686 		lockdep_assert_wiphy(mld->wiphy);
687 		iwl_fw_error_collect(&mld->fwrt);
688 	} else {
689 		wiphy_lock(mld->wiphy);
690 		if (mode->context != IWL_ERR_CONTEXT_ABORT)
691 			iwl_fw_error_collect(&mld->fwrt);
692 		wiphy_unlock(mld->wiphy);
693 	}
694 }
695 
696 static bool iwl_mld_sw_reset(struct iwl_op_mode *op_mode,
697 			     enum iwl_fw_error_type type)
698 {
699 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
700 
701 	/* SW reset can happen for TOP error w/o NIC error, so
702 	 * also abort scan here and set in_hw_restart, when we
703 	 * had a NIC error both were already done.
704 	 */
705 	iwl_mld_report_scan_aborted(mld);
706 	mld->fw_status.in_hw_restart = true;
707 
708 	/* Do restart only in the following conditions are met:
709 	 * - we consider the FW as running
710 	 * - The trigger that brought us here is defined as one that requires
711 	 *   a restart (in the debug TLVs)
712 	 */
713 	if (!mld->fw_status.running || !mld->fwrt.trans->dbg.restart_required)
714 		return false;
715 
716 	iwl_mld_restart_nic(mld);
717 	return true;
718 }
719 
720 static void
721 iwl_mld_time_point(struct iwl_op_mode *op_mode,
722 		   enum iwl_fw_ini_time_point tp_id,
723 		   union iwl_dbg_tlv_tp_data *tp_data)
724 {
725 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
726 
727 	iwl_dbg_tlv_time_point(&mld->fwrt, tp_id, tp_data);
728 }
729 
730 #ifdef CONFIG_PM_SLEEP
731 static void iwl_mld_device_powered_off(struct iwl_op_mode *op_mode)
732 {
733 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
734 
735 	wiphy_lock(mld->wiphy);
736 	iwl_mld_stop_fw(mld);
737 	mld->fw_status.in_d3 = false;
738 	wiphy_unlock(mld->wiphy);
739 }
740 #else
741 static void iwl_mld_device_powered_off(struct iwl_op_mode *op_mode)
742 {}
743 #endif
744 
745 static void iwl_mld_dump(struct iwl_op_mode *op_mode)
746 {
747 	struct iwl_mld *mld = IWL_OP_MODE_GET_MLD(op_mode);
748 	struct iwl_fw_runtime *fwrt = &mld->fwrt;
749 
750 	if (!iwl_trans_fw_running(fwrt->trans))
751 		return;
752 
753 	iwl_dbg_tlv_time_point(fwrt, IWL_FW_INI_TIME_POINT_USER_TRIGGER, NULL);
754 }
755 
756 static const struct iwl_op_mode_ops iwl_mld_ops = {
757 	.start = iwl_op_mode_mld_start,
758 	.stop = iwl_op_mode_mld_stop,
759 	.rx = iwl_mld_rx,
760 	.rx_rss = iwl_mld_rx_rss,
761 	.queue_full = iwl_mld_queue_full,
762 	.queue_not_full = iwl_mld_queue_not_full,
763 	.hw_rf_kill = iwl_mld_set_hw_rfkill_state,
764 	.free_skb = iwl_mld_free_skb,
765 	.nic_error = iwl_mld_nic_error,
766 	.dump_error = iwl_mld_dump_error,
767 	.sw_reset = iwl_mld_sw_reset,
768 	.time_point = iwl_mld_time_point,
769 	.device_powered_off = pm_sleep_ptr(iwl_mld_device_powered_off),
770 	.dump = iwl_mld_dump,
771 };
772 
773 struct iwl_mld_mod_params iwlmld_mod_params = {
774 	.power_scheme = IWL_POWER_SCHEME_BPS,
775 };
776 
777 module_param_named(power_scheme, iwlmld_mod_params.power_scheme, int, 0444);
778 MODULE_PARM_DESC(power_scheme,
779 		 "power management scheme: 1-active, 2-balanced, default: 2");
780