fw/api/mac.h

1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
3  * Copyright (C) 2012-2014, 2018-2022 Intel Corporation
11  * AUX indices follows - 1 for non-CDB, 2 for CDB.
31  * enum iwl_mac_protection_flags - MAC context flags
40 	MAC_PROT_FLG_TGG_PROTECT	= BIT(3),
41 	MAC_PROT_FLG_HT_PROT		= BIT(23),
42 	MAC_PROT_FLG_FAT_PROT		= BIT(24),
43 	MAC_PROT_FLG_SELF_CTS_EN	= BIT(30),
46 #define MAC_FLG_SHORT_SLOT		BIT(4)
47 #define MAC_FLG_SHORT_PREAMBLE		BIT(5)
50  * enum iwl_mac_types - Supported MAC types
54  * @FW_MAC_TYPE_PIBSS: Pseudo-IBSS
78  * enum iwl_tsf_id - TSF hw timer ID
94  * struct iwl_mac_data_ap - configuration data for AP MAC context
117  * struct iwl_mac_data_ibss - configuration data for IBSS MAC context
133  * enum iwl_mac_data_policy - policy of the data path for this MAC
142  *	during 802.1X negotiation (and allowed during 4-way-HS)
145 	TWT_SUPPORTED = BIT(0),
146 	MORE_DATA_ACK_SUPPORTED = BIT(1),
147 	FLEXIBLE_TWT_SUPPORTED = BIT(2),
148 	PROTECTED_TWT_SUPPORTED = BIT(3),
149 	BROADCAST_TWT_SUPPORTED = BIT(4),
150 	COEX_HIGH_PRIORITY_ENABLE = BIT(5),
154  * struct iwl_mac_data_sta - configuration data for station MAC context
180  * struct iwl_mac_data_go - configuration data for P2P GO MAC context
193  * struct iwl_mac_data_p2p_sta - configuration data for P2P client MAC context
204  * struct iwl_mac_data_pibss - Pseudo IBSS config data
212  * struct iwl_mac_data_p2p_dev - configuration data for the P2P Device MAC
226  * enum iwl_mac_filter_flags - MAC context filter flags
240 	MAC_FILTER_IN_PROMISC		= BIT(0),
241 	MAC_FILTER_IN_CONTROL_AND_MGMT	= BIT(1),
242 	MAC_FILTER_ACCEPT_GRP		= BIT(2),
243 	MAC_FILTER_DIS_DECRYPT		= BIT(3),
244 	MAC_FILTER_DIS_GRP_DECRYPT	= BIT(4),
245 	MAC_FILTER_IN_BEACON		= BIT(6),
246 	MAC_FILTER_OUT_BCAST		= BIT(8),
247 	MAC_FILTER_IN_CRC32		= BIT(11),
248 	MAC_FILTER_IN_PROBE_REQUEST	= BIT(12),
252 	MAC_FILTER_IN_11AX		= BIT(14),
256  * enum iwl_mac_qos_flags - QoS flags
263 	MAC_QOS_FLG_UPDATE_EDCA	= BIT(0),
264 	MAC_QOS_FLG_TGN		= BIT(1),
265 	MAC_QOS_FLG_TXOP_TYPE	= BIT(4),
269  * struct iwl_ac_qos - QOS timing params for MAC_CONTEXT_CMD
271  *	Should be a power-of-2, minus 1.  Device's default is 0x0f.
273  *	Should be a power-of-2, minus 1.  Device's default is 0x3f.
283  * transmission retry.  Device uses cw_max as a bit mask, ANDed with new CW
295  * struct iwl_mac_ctx_cmd - command structure to configure MAC contexts
356  * struct iwl_missed_beacons_notif_ver_3 - information on missed beacons
374  * struct iwl_missed_beacons_notif - information on missed beacons
392  * struct iwl_he_backoff_conf - used for backoff configuration
393  * Per each trigger-based AC, (set by MU EDCA Parameter set info-element)
395  * The MU-TIMER is reloaded w/ MU_TIME each time a frame from the AC is sent via
396  * trigger-based TX.
400  *	AIFSN=0, means that no backoff from the specified TRIG-BASED AC is
401  *	allowed till the MU-TIMER is 0
412  * enum iwl_he_pkt_ext_constellations - PPE constellation indices
415  * @IWL_HE_PKT_EXT_16QAM: 16-QAM
416  * @IWL_HE_PKT_EXT_64QAM: 64-QAM
417  * @IWL_HE_PKT_EXT_256QAM: 256-QAM
418  * @IWL_HE_PKT_EXT_1024QAM: 1024-QAM
419  * @IWL_HE_PKT_EXT_4096QAM: 4096-QAM, for EHT only
438  * struct iwl_he_pkt_ext_v1 - QAM thresholds
442  *	(0=SISO, 1=MIMO2) x (0-20MHz, 1-40MHz, 2-80MHz, 3-160MHz)
446  *	QAM_tx < QAM_th1            --> PPE=0us
447  *	QAM_th1 <= QAM_tx < QAM_th2 --> PPE=8us
448  *	QAM_th2 <= QAM_tx           --> PPE=16us
454  *	Nss (0-siso, 1-mimo2) x BW (0-20MHz, 1-40MHz, 2-80MHz, 3-160MHz) x
455  *		(0-low_th, 1-high_th)
462  * struct iwl_he_pkt_ext_v2 - QAM thresholds
466  *	(0=SISO, 1=MIMO2) x (0-20MHz, 1-40MHz, 2-80MHz, 3-160MHz)
470  *	QAM_tx < QAM_th1            --> PPE=0us
471  *	QAM_th1 <= QAM_tx < QAM_th2 --> PPE=8us
472  *	QAM_th2 <= QAM_tx           --> PPE=16us
478  *	Nss (0-siso, 1-mimo2) x
479  *	BW (0-20MHz, 1-40MHz, 2-80MHz, 3-160MHz, 4-320MHz) x
480  *	(0-low_th, 1-high_th)
487  * enum iwl_he_sta_ctxt_flags - HE STA context flags
494  *	of 32-bits
495  * @STA_CTXT_HE_PACKET_EXT: indicates that the packet-extension info is valid
500  * @STA_CTXT_HE_ACK_ENABLED: indicates that the AP supports receiving ACK-
501  *	enabled AGG, i.e. both BACK and non-BACK frames in a single AGG
503  *	parameter set, i.e. the backoff counters for trig-based ACs
505  *	ACK-enabled AGG, (i.e. both BACK and non-BACK frames in single AGG).
506  *	If the NIC is not ACK_ENABLED it may use the EOF-bit in first non-0
508  * @STA_CTXT_HE_RU_2MHZ_BLOCK: indicates that 26-tone RU OFDMA transmission are
515  *	extended to 20us for BW > 160Mhz or for MCS w/ 4096-QAM.
518 	STA_CTXT_HE_REF_BSSID_VALID		= BIT(4),
519 	STA_CTXT_HE_BSS_COLOR_DIS		= BIT(5),
520 	STA_CTXT_HE_PARTIAL_BSS_COLOR		= BIT(6),
521 	STA_CTXT_HE_32BIT_BA_BITMAP		= BIT(7),
522 	STA_CTXT_HE_PACKET_EXT			= BIT(8),
523 	STA_CTXT_HE_TRIG_RND_ALLOC		= BIT(9),
524 	STA_CTXT_HE_CONST_TRIG_RND_ALLOC	= BIT(10),
525 	STA_CTXT_HE_ACK_ENABLED			= BIT(11),
526 	STA_CTXT_HE_MU_EDCA_CW			= BIT(12),
527 	STA_CTXT_HE_NIC_NOT_ACK_ENABLED		= BIT(13),
528 	STA_CTXT_HE_RU_2MHZ_BLOCK		= BIT(14),
529 	STA_CTXT_HE_NDP_FEEDBACK_ENABLED	= BIT(15),
530 	STA_CTXT_EHT_PUNCTURE_MASK_VALID	= BIT(16),
531 	STA_CTXT_EHT_LONG_PPE_ENABLED		= BIT(17),
535  * enum iwl_he_htc_flags - HE HTC support flags
536  * @IWL_HE_HTC_SUPPORT: HE-HTC support
538  *	support via A-control field
539  * @IWL_HE_HTC_BSR_SUPP: BSR support in A-control field
540  * @IWL_HE_HTC_OMI_SUPP: A-OMI support in A-control field
541  * @IWL_HE_HTC_BQR_SUPP: A-BQR support in A-control field
544 	IWL_HE_HTC_SUPPORT			= BIT(0),
545 	IWL_HE_HTC_UL_MU_RESP_SCHED		= BIT(3),
546 	IWL_HE_HTC_BSR_SUPP			= BIT(4),
547 	IWL_HE_HTC_OMI_SUPP			= BIT(5),
548 	IWL_HE_HTC_BQR_SUPP			= BIT(6),
563  * struct iwl_he_sta_context_cmd_v1 - configure FW to work with HE AP
565  * @tid_limit: max num of TIDs in TX HE-SU multi-TID agg
566  *	0 - bad value, 1 - multi-tid not supported, 2..8 - tid limit
573  * @frag_flags: frag support in A-MSDU
577  * @pkt_ext: optional, exists according to PPE-present bit in the HE-PHY capa
578  * @bss_color: 11ax AP ID that is used in the HE SIG-A to mark inter BSS frame
581  * @rand_alloc_ecwmin: random CWmin = 2**ECWmin-1
582  * @rand_alloc_ecwmax: random CWmax = 2**ECWmax-1
597 	/* The below fields are set via HE-capabilities IE */
608 	/* The below fields are set via HE-Operation IE */
623  * struct iwl_he_sta_context_cmd_v2 - configure FW to work with HE AP
625  * @tid_limit: max num of TIDs in TX HE-SU multi-TID agg
626  *	0 - bad value, 1 - multi-tid not supported, 2..8 - tid limit
633  * @frag_flags: frag support in A-MSDU
637  * @pkt_ext: optional, exists according to PPE-present bit in the HE-PHY capa
638  * @bss_color: 11ax AP ID that is used in the HE SIG-A to mark inter BSS frame
641  * @rand_alloc_ecwmin: random CWmin = 2**ECWmin-1
642  * @rand_alloc_ecwmax: random CWmax = 2**ECWmax-1
648  * @ema_ap: AP supports enhanced Multi BSSID advertisement
665 	/* The below fields are set via HE-capabilities IE */
676 	/* The below fields are set via HE-Operation IE */
698  * struct iwl_he_sta_context_cmd_v3 - configure FW to work with HE AP
700  * @tid_limit: max num of TIDs in TX HE-SU multi-TID agg
701  *	0 - bad value, 1 - multi-tid not supported, 2..8 - tid limit
708  * @frag_flags: frag support in A-MSDU
712  * @pkt_ext: optional, exists according to PPE-present bit in the HE-PHY capa
713  * @bss_color: 11ax AP ID that is used in the HE SIG-A to mark inter BSS frame
716  * @rand_alloc_ecwmin: random CWmin = 2**ECWmin-1
717  * @rand_alloc_ecwmax: random CWmax = 2**ECWmax-1
723  * @ema_ap: AP supports enhanced Multi BSSID advertisement
740 	/* The below fields are set via HE-capabilities IE */
751 	/* The below fields are set via HE-Operation IE */
773  * struct iwl_he_monitor_cmd - configure air sniffer for HE