fw/api/power.h

1 /* SPDX-License-Identifier: GPL-2.0 OR BSD-3-Clause */
3  * Copyright (C) 2012-2014, 2018-2023 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
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
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
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
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.
288  * @dev_24: device TX power restriction in 1/8 dBms
289  * @dev_52_low: device TX power restriction upper band - low
290  * @dev_52_high: device TX power restriction upper band - high
302  * struct iwl_dev_tx_power_cmd_v3 - TX power reduction command version 3
312  * struct iwl_dev_tx_power_cmd_v4 - TX power reduction command version 4
314  * @enable_ack_reduction: enable or disable close range ack TX power
325  * struct iwl_dev_tx_power_cmd_v5 - TX power reduction command version 5
327  * @enable_ack_reduction: enable or disable close range ack TX power
346  * struct iwl_dev_tx_power_cmd_v6 - TX power reduction command version 6
348  * @enable_ack_reduction: enable or disable close range ack TX power
367  * struct iwl_dev_tx_power_cmd_v7 - TX power reduction command version 7
369  * @enable_ack_reduction: enable or disable close range ack TX power
389  * struct iwl_dev_tx_power_cmd - TX power reduction command (multiversion)
413  * enum iwl_geo_per_chain_offset_operation - type of operation
423  * struct iwl_per_chain_offset - embedded struct for PER_CHAIN_LIMIT_OFFSET_CMD.
424  * @max_tx_power: maximum allowed tx power.
425  * @chain_a: tx power offset for chain a.
426  * @chain_b: tx power offset for chain b.
435  * struct iwl_geo_tx_power_profile_cmd_v1 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
445  * struct iwl_geo_tx_power_profile_cmd_v2 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
448  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
457  * struct iwl_geo_tx_power_profile_cmd_v3 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
460  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
469  * struct iwl_geo_tx_power_profile_cmd_v4 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
472  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
481  * struct iwl_geo_tx_power_profile_cmd_v5 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
484  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
501  * struct iwl_geo_tx_power_profiles_resp -  response to PER_CHAIN_LIMIT_OFFSET_CMD cmd
509  * union iwl_ppag_table_cmd - union for all versions of PPAG command
513  * @flags: bit 0 - indicates enablement of PPAG for ETSI
514  *         bit 1 - indicates enablement of PPAG for CHINA BIOS
516  * @gain: table of antenna gain values per chain and sub-band
536  * struct iwl_sar_offset_mapping_cmd - struct for SAR_OFFSET_MAPPING_TABLE_CMD
551  *      passed beacon is greater than this threshold. Zero value means that
557  *      and last passed beacon is greater than this threshold. Zero value
561  *      calculated for current beacon is less than the threshold, use
562  *      Roaming Energy Delta Threshold, otherwise use normal Energy Delta
563  *      Threshold. Typical energy threshold is -72dBm.
564  * @bf_temp_threshold: This threshold determines the type of temperature
566  *	If the current temperature is above this threshold - Fast filter
567  *	will be used, If the current temperature is below this threshold -
571  *      threshold. Zero value means that the temperature change is ignored for
576  *      threshold. Zero value means that the temperature change is ignored for
584  *      for a longer period of time then this escape-timeout. Units: Beacons.
588  *      for this beacon crossed this absolute threshold. For the 'Increase'
591  *      that this specific threshold is ignored for beacon filtering, and