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
60  * @ltr_short_idle_timeout: LTR Short Idle timeout (in usec). Used only if
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
108  *	is used also with a new	power API for device wide power settings.
112  * @keep_alive_seconds: Keep alive period in seconds. Default - 25 sec.
113  *			Minimum allowed:- 3 * DTIM. Keep alive period must be
117  * @rx_data_timeout:    Minimum time (usec) from last Rx packet for AM to
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
182  * @rx_data_timeout:    Minimum time (usec) from last Rx packet for AM to
183  *			PSM transition - legacy PM
184  * @tx_data_timeout:    Minimum time (usec) from last Tx packet for AM to
185  *			PSM transition - legacy PM
189  * @rx_data_timeout_uapsd: Minimum time (usec) from last Rx packet for AM to
190  *			PSM transition - uAPSD
191  * @tx_data_timeout_uapsd: Minimum time (usec) from last Tx packet for AM to
192  *			PSM transition - uAPSD
198  *			packets received. It is also the minimum time from last
203  * @uapsd_ac_flags:	Set trigger-enabled and delivery-enabled indication for
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
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
325  * struct iwl_dev_tx_power_cmd_v5 - TX power reduction command version 5
330  *	from last command. used if set_mode is
332  *	note: if not changed, the command is used for keep alive only.
346  * struct iwl_dev_tx_power_cmd_v6 - TX power reduction command version 6
351  *	from last command. used if set_mode is
353  *	note: if not changed, the command is used for keep alive only.
367  * struct iwl_dev_tx_power_cmd_v7 - TX power reduction command version 7
372  *	from last command. used if set_mode is
374  *	note: if not changed, the command is used for keep alive only.
389  * struct iwl_dev_tx_power_cmd - TX power reduction command (multiversion)
413  * enum iwl_geo_per_chain_offset_operation - type of operation
415  * @IWL_PER_CHAIN_OFFSET_GET_CURRENT_TABLE: retrieve the last configured table.
423  * struct iwl_per_chain_offset - embedded struct for PER_CHAIN_LIMIT_OFFSET_CMD.
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
515  *         bit 1 can be used only in v3 (identical to v2)
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
549  * @bf_energy_delta: Used for RSSI filtering, if in 'normal' state. Send beacon
550  *      to driver if delta in Energy values calculated for this and last
555  * @bf_roaming_energy_delta: Used for RSSI filtering, if in 'roaming' state.
557  *      and last passed beacon is greater than this threshold. Zero value
560  * @bf_roaming_state: Used for RSSI filtering. If absolute Energy values
563  *      Threshold. Typical energy threshold is -72dBm.
566  *	If the current temperature is above this threshold - Fast filter
567  *	will be used, If the current temperature is below this threshold -
568  *	Slow filter will be used.
570  *      calculated for this and the last passed beacon is greater than this
575  *      calculated for this and the last passed beacon is greater than this
584  *      for a longer period of time then this escape-timeout. Units: Beacons.
589  *      direction the bf_energy_absolute_low[i] is used. For the 'Decrease'
590  *      direction the bf_energy_absolute_high[i] is used. Zero value means