link.h

  1/* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
  2/*
  3 * Copyright (C) 2024-2025 Intel Corporation
  4 */
  5#ifndef __iwl_mld_link_h__
  6#define __iwl_mld_link_h__
  7
  8#include <net/mac80211.h>
  9
 10#include "mld.h"
 11#include "sta.h"
 12
 13/**
 14 * struct iwl_probe_resp_data - data for NoA/CSA updates
 15 * @rcu_head: used for freeing the data on update
 16 * @notif: notification data
 17 * @noa_len: length of NoA attribute, calculated from the notification
 18 */
 19struct iwl_probe_resp_data {
 20	struct rcu_head rcu_head;
 21	struct iwl_probe_resp_data_notif notif;
 22	int noa_len;
 23};
 24
 25/**
 26 * struct iwl_mld_link - link configuration parameters
 27 *
 28 * @rcu_head: RCU head for freeing this data.
 29 * @fw_id: the fw id of the link.
 30 * @active: if the link is active or not.
 31 * @queue_params: QoS data from mac80211. This is updated with a call to
 32 *	drv_conf_tx per each AC, and then notified once with BSS_CHANGED_QOS.
 33 *	So we store it here and then send one link cmd for all the ACs.
 34 * @chan_ctx: pointer to the channel context assigned to the link. If a link
 35 *	has an assigned channel context it means that it is active.
 36 * @he_ru_2mhz_block: 26-tone RU OFDMA transmissions should be blocked.
 37 * @igtk: fw can only have one IGTK at a time, whereas mac80211 can have two.
 38 *	This tracks the one IGTK that currently exists in FW.
 39 * @bigtks: BIGTKs of the AP. Only valid for STA mode.
 40 * @bcast_sta: station used for broadcast packets. Used in AP, GO and IBSS.
 41 * @mcast_sta: station used for multicast packets. Used in AP, GO and IBSS.
 42 * @mon_sta: station used for TX injection in monitor interface.
 43 * @average_beacon_energy: average beacon energy for beacons received during
 44 *	client connections
 45 * @ap_early_keys: The firmware cannot install keys before bcast/mcast STAs,
 46 *	but higher layers work differently, so we store the keys here for
 47 *	later installation.
 48 * @silent_deactivation: next deactivation needs to be silent.
 49 * @probe_resp_data: data from FW notification to store NOA related data to be
 50 *	inserted into probe response.
 51 */
 52struct iwl_mld_link {
 53	struct rcu_head rcu_head;
 54
 55	/* Add here fields that need clean up on restart */
 56	struct_group(zeroed_on_hw_restart,
 57		u8 fw_id;
 58		bool active;
 59		struct ieee80211_tx_queue_params queue_params[IEEE80211_NUM_ACS];
 60		struct ieee80211_chanctx_conf __rcu *chan_ctx;
 61		bool he_ru_2mhz_block;
 62		struct ieee80211_key_conf *igtk;
 63		struct ieee80211_key_conf __rcu *bigtks[2];
 64	);
 65	/* And here fields that survive a fw restart */
 66	struct iwl_mld_int_sta bcast_sta;
 67	struct iwl_mld_int_sta mcast_sta;
 68	struct iwl_mld_int_sta mon_sta;
 69
 70	/* we can only have 2 GTK + 2 IGTK + 2 BIGTK active at a time */
 71	struct ieee80211_key_conf *ap_early_keys[6];
 72	u32 average_beacon_energy;
 73	bool silent_deactivation;
 74	struct iwl_probe_resp_data __rcu *probe_resp_data;
 75};
 76
 77/* Cleanup function for struct iwl_mld_link, will be called in restart */
 78static inline void
 79iwl_mld_cleanup_link(struct iwl_mld *mld, struct iwl_mld_link *link)
 80{
 81	struct iwl_probe_resp_data *probe_data;
 82
 83	probe_data = wiphy_dereference(mld->wiphy, link->probe_resp_data);
 84	RCU_INIT_POINTER(link->probe_resp_data, NULL);
 85	if (probe_data)
 86		kfree_rcu(probe_data, rcu_head);
 87
 88	CLEANUP_STRUCT(link);
 89	if (link->bcast_sta.sta_id != IWL_INVALID_STA)
 90		iwl_mld_free_internal_sta(mld, &link->bcast_sta);
 91	if (link->mcast_sta.sta_id != IWL_INVALID_STA)
 92		iwl_mld_free_internal_sta(mld, &link->mcast_sta);
 93	if (link->mon_sta.sta_id != IWL_INVALID_STA)
 94		iwl_mld_free_internal_sta(mld, &link->mon_sta);
 95}
 96
 97/* Convert a percentage from [0,100] to [0,255] */
 98#define NORMALIZE_PERCENT_TO_255(percentage) ((percentage) * 256 / 100)
 99
100int iwl_mld_add_link(struct iwl_mld *mld,
101		     struct ieee80211_bss_conf *bss_conf);
102void iwl_mld_remove_link(struct iwl_mld *mld,
103			 struct ieee80211_bss_conf *bss_conf);
104int iwl_mld_activate_link(struct iwl_mld *mld,
105			  struct ieee80211_bss_conf *link);
106void iwl_mld_deactivate_link(struct iwl_mld *mld,
107			     struct ieee80211_bss_conf *link);
108int iwl_mld_change_link_in_fw(struct iwl_mld *mld,
109			      struct ieee80211_bss_conf *link, u32 changes);
110void iwl_mld_handle_missed_beacon_notif(struct iwl_mld *mld,
111					struct iwl_rx_packet *pkt);
112bool iwl_mld_cancel_missed_beacon_notif(struct iwl_mld *mld,
113					struct iwl_rx_packet *pkt,
114					u32 removed_link_id);
115int iwl_mld_link_set_associated(struct iwl_mld *mld, struct ieee80211_vif *vif,
116				struct ieee80211_bss_conf *link);
117
118unsigned int iwl_mld_get_link_grade(struct iwl_mld *mld,
119				    struct ieee80211_bss_conf *link_conf);
120
121unsigned int iwl_mld_get_chan_load(struct iwl_mld *mld,
122				   struct ieee80211_bss_conf *link_conf);
123
124int iwl_mld_get_chan_load_by_others(struct iwl_mld *mld,
125				    struct ieee80211_bss_conf *link_conf,
126				    bool expect_active_link);
127
128void iwl_mld_handle_beacon_filter_notif(struct iwl_mld *mld,
129					struct iwl_rx_packet *pkt);
130
131#endif /* __iwl_mld_link_h__ */