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
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
298  * struct iwl_dev_tx_power_cmd_v3 - TX power reduction command version 3
308  * struct iwl_dev_tx_power_cmd_v4 - TX power reduction command version 4
321  * struct iwl_dev_tx_power_cmd_v5 - TX power reduction command version 5
326  *	from last command. used if set_mode is
328  *	note: if not changed, the command is used for keep alive only.
342  * struct iwl_dev_tx_power_cmd_v6 - TX power reduction command version 6
347  *	from last command. used if set_mode is
349  *	note: if not changed, the command is used for keep alive only.
363  * struct iwl_dev_tx_power_cmd_v7 - TX power reduction command version 7
368  *	from last command. used if set_mode is
370  *	note: if not changed, the command is used for keep alive only.
386  * struct iwl_dev_tx_power_cmd_v8 - TX power reduction command version 8
391  *	from last command. used if set_mode is
393  *	note: if not changed, the command is used for keep alive only.
413  * @dev_52_low: device TX power restriction upper band - low
414  * @dev_52_high: device TX power restriction upper band - high
423  * struct iwl_dev_tx_power_cmd_v3_v8 - TX power reduction command (multiversion)
447  * struct iwl_dev_tx_power_cmd_v9 - TX power reduction cmd
451  *	from last command. used if set_mode is
453  *	note: if not changed, the command is used for keep alive only.
467  * struct iwl_dev_tx_power_cmd_v10 - TX power reduction cmd
470  *	from last command. used if set_mode is
472  *	note: if not changed, the command is used for keep alive only.
487  * struct iwl_dev_tx_power_cmd - TX power reduction command (multiversion)
506  * enum iwl_geo_per_chain_offset_operation - type of operation
508  * @IWL_PER_CHAIN_OFFSET_GET_CURRENT_TABLE: retrieve the last configured table.
516  * struct iwl_per_chain_offset - embedded struct for PER_CHAIN_LIMIT_OFFSET_CMD.
528  * struct iwl_geo_tx_power_profiles_cmd_v1 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
538  * struct iwl_geo_tx_power_profiles_cmd_v2 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
541  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
550  * struct iwl_geo_tx_power_profiles_cmd_v3 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
553  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
562  * struct iwl_geo_tx_power_profiles_cmd_v4 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
565  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
574  * struct iwl_geo_tx_power_profiles_cmd_v5 - struct for PER_CHAIN_LIMIT_OFFSET_CMD cmd.
577  * @table_revision: 0 for not-South Korea, 1 for South Korea (the name is misleading)
594  * struct iwl_geo_tx_power_profiles_resp -  response to PER_CHAIN_LIMIT_OFFSET_CMD cmd
602  * enum iwl_ppag_flags - PPAG enable masks
630  * union iwl_ppag_table_cmd - union for all versions of PPAG command
636  * @v1.gain: table of antenna gain values per chain and sub-band
639  * @v2.gain: table of antenna gain values per chain and sub-band
664  * struct iwl_sar_offset_mapping_cmd - struct for SAR_OFFSET_MAPPING_TABLE_CMD
677  * @bf_energy_delta: Used for RSSI filtering, if in 'normal' state. Send beacon
678  *      to driver if delta in Energy values calculated for this and last
683  * @bf_roaming_energy_delta: Used for RSSI filtering, if in 'roaming' state.
685  *      and last passed beacon is greater than this threshold. Zero value
688  * @bf_roaming_state: Used for RSSI filtering. If absolute Energy values
691  *      Threshold. Typical energy threshold is -72dBm.
694  *	If the current temperature is above this threshold - Fast filter
695  *	will be used, If the current temperature is below this threshold -
696  *	Slow filter will be used.
698  *      calculated for this and the last passed beacon is greater than this
703  *      calculated for this and the last passed beacon is greater than this
712  *      for a longer period of time then this escape-timeout. Units: Beacons.
717  *      direction the bf_energy_absolute_low[i] is used. For the 'Decrease'
718  *      direction the bf_energy_absolute_high[i] is used. Zero value means
819  * Used for VLP/LPI/AFC Access Point power constraints for 6GHz channels
822  * @eirp_pwr: 8-bit 2s complement signed integer in the range
823  *	-64 dBm to 63 dBm with a 0.5 dB step
825  * @psd_pwr: 8-bit 2s complement signed integer in the range
826  *	-63.5 to +63 dBm/MHz with a 0.5 step
827  *	value - 128 indicates that the corresponding 20
828  *	MHz channel cannot be used for transmission.