fw/api/power.h

1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
3  * Copyright (C) 2012-2014, 2018-2024 Intel Corporation
4  * Copyright (C) 2013-2014 Intel Mobile Communications GmbH
5  * Copyright (C) 2015-2017 Intel Deutschland GmbH
13  * enum iwl_ltr_config_flags - masks for LTR config command flags
39  * struct iwl_ltr_config_cmd_v1 - configures the LTR
53  * struct iwl_ltr_config_cmd - configures the LTR
58  *	TX, RX, Short Idle, Long Idle. Used only if %LTR_CFG_FLAG_UPDATE_VALUES
77  * enum iwl_power_flags - masks for power table command flags
79  *		receiver and transmitter. '0' - does not allow.
84  * @POWER_FLAGS_SNOOZE_ENA_MSK: Enable snoozing only if uAPSD is enabled and all
86  * @POWER_FLAGS_BT_SCO_ENA: Enable BT SCO coex only if uAPSD and
88  * @POWER_FLAGS_ADVANCE_PM_ENA_MSK: Advanced PM (uAPSD) enable mask
89  * @POWER_FLAGS_LPRX_ENA_MSK: Low Power RX enable.
107  * struct iwl_powertable_cmd - legacy power command. Beside old API support this
112  * @keep_alive_seconds: Keep alive period in seconds. Default - 25 sec.
113  *			Minimum allowed:- 3 * DTIM. Keep alive period must be
118  *			PSM transition - legacy PM
119  * @tx_data_timeout:    Minimum time (usec) from last Tx packet for AM to
120  *			PSM transition - legacy PM
141  * enum iwl_device_power_flags - masks for device power command flags
144  *	receiver and transmitter. '0' - does not allow.
161  * struct iwl_device_power_cmd - device wide power command.
174  * struct iwl_mac_power_cmd - New power command containing uAPSD support
178  * @keep_alive_seconds:	Keep alive period in seconds. Default - 25 sec.
179  *			Minimum allowed:- 3 * DTIM. Keep alive period must be
183  *			PSM transition - legacy PM
184  * @tx_data_timeout:    Minimum time (usec) from last Tx packet for AM to
185  *			PSM transition - legacy PM
190  *			PSM transition - uAPSD
191  * @tx_data_timeout_uapsd: Minimum time (usec) from last Tx packet for AM to
192  *			PSM transition - uAPSD
203  * @uapsd_ac_flags:	Set trigger-enabled and delivery-enabled indication for
208  * @heavy_tx_thld_packets:	TX threshold measured in number of packets
210  * @heavy_tx_thld_percentage:	TX threshold measured in load's percentage
243  * struct iwl_uapsd_misbehaving_ap_notif - FW sends this notification when
246  * @sta_id: index of station in uCode's station table - associated AP ID in
256  * struct iwl_reduce_tx_power_cmd - TX power reduction command
259  * @mac_context_id: id of the mac ctx for which we are reducing TX power.
260  * @pwr_restriction: TX power restriction in dBms.
284  * struct iwl_dev_tx_power_common - Common part of the TX power reduction cmd
286  * @mac_context_id: id of the mac ctx for which we are reducing TX power.
287  * @pwr_restriction: TX power restriction in 1/8 dBms.
296  * struct iwl_dev_tx_power_cmd_v3 - TX power reduction command version 3
306  * struct iwl_dev_tx_power_cmd_v4 - TX power reduction command version 4
308  * @enable_ack_reduction: enable or disable close range ack TX power
319  * struct iwl_dev_tx_power_cmd_v5 - TX power reduction command version 5
321  * @enable_ack_reduction: enable or disable close range ack TX power
340  * struct iwl_dev_tx_power_cmd_v6 - TX power reduction command version 6
342  * @enable_ack_reduction: enable or disable close range ack TX power
361  * struct iwl_dev_tx_power_cmd_v7 - TX power reduction command version 7
363  * @enable_ack_reduction: enable or disable close range ack TX power
384  * struct iwl_dev_tx_power_cmd_v8 - TX power reduction command version 8
386  * @enable_ack_reduction: enable or disable close range ack TX power
410  * @dev_24: device TX power restriction in 1/8 dBms
411  * @dev_52_low: device TX power restriction upper band - low
412  * @dev_52_high: device TX power restriction upper band - high
421  * struct iwl_dev_tx_power_cmd_v3_v8 - TX power reduction command (multiversion)
445  * struct iwl_dev_tx_power_cmd_v9 - TX power reduction cmd
465  * struct iwl_dev_tx_power_cmd_v10 - TX power reduction cmd
485  * struct iwl_dev_tx_power_cmd - TX power reduction command (multiversion)
504  * enum iwl_geo_per_chain_offset_operation - type of operation
514  * struct iwl_per_chain_offset - embedded struct for PER_CHAIN_LIMIT_OFFSET_CMD.
515  * @max_tx_power: maximum allowed tx power.
516  * @chain_a: tx power offset for chain a.
517  * @chain_b: tx power offset for chain b.
526  * struct iwl_geo_tx_power_profiles_cmd_v1 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
536  * struct iwl_geo_tx_power_profiles_cmd_v2 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
539  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
548  * struct iwl_geo_tx_power_profiles_cmd_v3 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
551  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
560  * struct iwl_geo_tx_power_profiles_cmd_v4 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
563  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
572  * struct iwl_geo_tx_power_profiles_cmd_v5 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
575  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
592  * struct iwl_geo_tx_power_profiles_resp -  response to PER_CHAIN_LIMIT_OFFSET_CMD cmd
600  * enum iwl_ppag_flags - PPAG enable masks
601  * @IWL_PPAG_ETSI_MASK: enable PPAG in ETSI
602  * @IWL_PPAG_CHINA_MASK: enable PPAG in China
603  * @IWL_PPAG_ETSI_LPI_UHB_MASK: enable LPI in ETSI for UHB
604  * @IWL_PPAG_ETSI_VLP_UHB_MASK: enable VLP in ETSI for UHB
605  * @IWL_PPAG_ETSI_SP_UHB_MASK: enable SP in ETSI for UHB
606  * @IWL_PPAG_USA_LPI_UHB_MASK: enable LPI in USA for UHB
607  * @IWL_PPAG_USA_VLP_UHB_MASK: enable VLP in USA for UHB
608  * @IWL_PPAG_USA_SP_UHB_MASK: enable SP in USA for UHB
609  * @IWL_PPAG_CANADA_LPI_UHB_MASK: enable LPI in CANADA for UHB
610  * @IWL_PPAG_CANADA_VLP_UHB_MASK: enable VLP in CANADA for UHB
611  * @IWL_PPAG_CANADA_SP_UHB_MASK: enable SP in CANADA for UHB
628  * union iwl_ppag_table_cmd - union for all versions of PPAG command
634  * @v1.gain: table of antenna gain values per chain and sub-band
637  * @v2.gain: table of antenna gain values per chain and sub-band
662  * struct iwl_sar_offset_mapping_cmd - struct for SAR_OFFSET_MAPPING_TABLE_CMD
689  *      Threshold. Typical energy threshold is -72dBm.
692  *	If the current temperature is above this threshold - Fast filter
693  *	will be used, If the current temperature is below this threshold -
710  *      for a longer period of time then this escape-timeout. Units: Beacons.
820  * @eirp_pwr: 8-bit 2s complement signed integer in the range
821  *	-64 dBm to 63 dBm with a 0.5 dB step
823  * @psd_pwr: 8-bit 2s complement signed integer in the range
824  *	-63.5 to +63 dBm/MHz with a 0.5 step
825  *	value - 128 indicates that the corresponding 20