| 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 |
void iwl_tt_enter_ct_kill(struct iwl_priv *priv); |
| 104 |
void iwl_tt_exit_ct_kill(struct iwl_priv *priv); |
| 105 |
void iwl_tt_handler(struct iwl_priv *priv); |
| 106 |
void iwl_tt_initialize(struct iwl_priv *priv); |
| 107 |
void iwl_tt_exit(struct iwl_priv *priv); |
| 108 |
|
| 109 |
#endif /* __iwl_tt_setting_h__ */ |