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
71 /* Radio LP RX Energy Threshold measured in dBm */
77  * enum iwl_power_flags - masks for power table command flags
79  *		receiver and transmitter. '0' - does not allow.
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
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
185  *			PSM transition - legacy PM
190  *			PSM transition - uAPSD
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
209  * @heavy_rx_thld_packets:	RX threshold measured in number of packets
210  * @heavy_tx_thld_percentage:	TX threshold measured in load's percentage
211  * @heavy_rx_thld_percentage:	RX 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
284  * struct iwl_dev_tx_power_common - Common part of the TX power reduction cmd
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
319  * struct iwl_dev_tx_power_cmd_v5 - TX power reduction command version 5
340  * struct iwl_dev_tx_power_cmd_v6 - TX power reduction command version 6
361  * struct iwl_dev_tx_power_cmd_v7 - TX power reduction command version 7
384  * struct iwl_dev_tx_power_cmd_v8 - TX power reduction command version 8
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.
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
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
663  * @offset_map: mapping a mcc to a geo sar group
677  *      passed beacon is greater than this threshold. Zero value means that
683  *      and last passed beacon is greater than this threshold. Zero value
687  *      calculated for current beacon is less than the threshold, use
688  *      Roaming Energy Delta Threshold, otherwise use normal Energy Delta
689  *      Threshold. Typical energy threshold is -72dBm.
690  * @bf_temp_threshold: This threshold determines the type of temperature
692  *	If the current temperature is above this threshold - Fast filter
693  *	will be used, If the current temperature is below this threshold -
697  *      threshold. Zero value means that the temperature change is ignored for
702  *      threshold. Zero value means that the temperature change is ignored for
710  *      for a longer period of time then this escape-timeout. Units: Beacons.
714  *      for this beacon crossed this absolute threshold. For the 'Increase'
717  *      that this specific threshold is ignored for beacon filtering, and
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