1 /* SPDX-License-Identifier: GPL-2.0-only */ 2 /****************************************************************************** 3 * 4 * Copyright(c) 2007 - 2014, 2023-2024 Intel Corporation. All rights reserved. 5 * 6 * Portions of this file are derived from the ipw3945 project, as well 7 * as portions of the ieee80211 subsystem header files. 8 *****************************************************************************/ 9 #ifndef __iwl_tt_setting_h__ 10 #define __iwl_tt_setting_h__ 11 12 #include "commands.h" 13 14 #define IWL_ABSOLUTE_ZERO 0 15 #define IWL_ABSOLUTE_MAX 0xFFFFFFFF 16 #define IWL_TT_INCREASE_MARGIN 5 17 #define IWL_TT_CT_KILL_MARGIN 3 18 19 enum iwl_antenna_ok { 20 IWL_ANT_OK_NONE, 21 IWL_ANT_OK_SINGLE, 22 IWL_ANT_OK_MULTI, 23 }; 24 25 /* Thermal Throttling State Machine states */ 26 enum iwl_tt_state { 27 IWL_TI_0, /* normal temperature, system power state */ 28 IWL_TI_1, /* high temperature detect, low power state */ 29 IWL_TI_2, /* higher temperature detected, lower power state */ 30 IWL_TI_CT_KILL, /* critical temperature detected, lowest power state */ 31 IWL_TI_STATE_MAX 32 }; 33 34 /** 35 * struct iwl_tt_restriction - Thermal Throttling restriction table 36 * @tx_stream: number of tx stream allowed 37 * @is_ht: ht enable/disable 38 * @rx_stream: number of rx stream allowed 39 * 40 * This table is used by advance thermal throttling management 41 * based on the current thermal throttling state, and determines 42 * the number of tx/rx streams and the status of HT operation. 43 */ 44 struct iwl_tt_restriction { 45 enum iwl_antenna_ok tx_stream; 46 enum iwl_antenna_ok rx_stream; 47 bool is_ht; 48 }; 49 50 /** 51 * struct iwl_tt_trans - Thermal Throttling transaction table 52 * @next_state: next thermal throttling mode 53 * @tt_low: low temperature threshold to change state 54 * @tt_high: high temperature threshold to change state 55 * 56 * This is used by the advanced thermal throttling algorithm 57 * to determine the next thermal state to go based on the 58 * current temperature. 59 */ 60 struct iwl_tt_trans { 61 enum iwl_tt_state next_state; 62 u32 tt_low; 63 u32 tt_high; 64 }; 65 66 /** 67 * struct iwl_tt_mgmt - Thermal Throttling Management structure 68 * @advanced_tt: advanced thermal throttle required 69 * @state: current Thermal Throttling state 70 * @tt_power_mode: Thermal Throttling power mode index 71 * being used to set power level when 72 * when thermal throttling state != IWL_TI_0 73 * the tt_power_mode should set to different 74 * power mode based on the current tt state 75 * @tt_previous_temp: last measured temperature 76 * @restriction: ptr to restriction tbl, used by advance 77 * thermal throttling to determine how many tx/rx streams 78 * should be used in tt state; and can HT be enabled or not 79 * @transaction: ptr to adv trans table, used by advance thermal throttling 80 * state transaction 81 * @ct_kill_toggle: used to toggle the CSR bit when checking uCode temperature 82 * @ct_kill_exit_tm: timer to exit thermal kill 83 * @ct_kill_waiting_tm: timer to enter thermal kill 84 */ 85 struct iwl_tt_mgmt { 86 enum iwl_tt_state state; 87 bool advanced_tt; 88 u8 tt_power_mode; 89 bool ct_kill_toggle; 90 #ifdef CONFIG_IWLWIFI_DEBUG 91 s32 tt_previous_temp; 92 #endif 93 struct iwl_tt_restriction *restriction; 94 struct iwl_tt_trans *transaction; 95 struct timer_list ct_kill_exit_tm; 96 struct timer_list ct_kill_waiting_tm; 97 }; 98 99 u8 iwl_tt_current_power_mode(struct iwl_priv *priv); 100 bool iwl_tt_is_low_power_state(struct iwl_priv *priv); 101 bool iwl_ht_enabled(struct iwl_priv *priv); 102 enum iwl_antenna_ok iwl_tx_ant_restriction(struct iwl_priv *priv); 103 enum iwl_antenna_ok iwl_rx_ant_restriction(struct iwl_priv *priv); 104 void iwl_tt_enter_ct_kill(struct iwl_priv *priv); 105 void iwl_tt_exit_ct_kill(struct iwl_priv *priv); 106 void iwl_tt_handler(struct iwl_priv *priv); 107 void iwl_tt_initialize(struct iwl_priv *priv); 108 void iwl_tt_exit(struct iwl_priv *priv); 109 110 #endif /* __iwl_tt_setting_h__ */ 111