1 /******************************************************************************
2  *
3  * Copyright(c) 2007 - 2012 Intel Corporation. All rights reserved.
4  *
5  * Portions of this file are derived from the ipw3945 project, as well
6  * as portions of the ieee80211 subsystem header files.
7  *
8  * This program is free software; you can redistribute it and/or modify it
9  * under the terms of version 2 of the GNU General Public License as
10  * published by the Free Software Foundation.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
14  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
15  * more details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program; if not, write to the Free Software Foundation, Inc.,
19  * 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
20  *
21  * The full GNU General Public License is included in this distribution in the
22  * file called LICENSE.
23  *
24  * Contact Information:
25  *  Intel Linux Wireless <ilw@linux.intel.com>
26  * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
27  *****************************************************************************/
28 #ifndef __iwl_tt_setting_h__
29 #define __iwl_tt_setting_h__
30 
31 #include "iwl-commands.h"
32 
33 #define IWL_ABSOLUTE_ZERO		0
34 #define IWL_ABSOLUTE_MAX		0xFFFFFFFF
35 #define IWL_TT_INCREASE_MARGIN	5
36 #define IWL_TT_CT_KILL_MARGIN	3
37 
38 enum iwl_antenna_ok {
39 	IWL_ANT_OK_NONE,
40 	IWL_ANT_OK_SINGLE,
41 	IWL_ANT_OK_MULTI,
42 };
43 
44 /* Thermal Throttling State Machine states */
45 enum  iwl_tt_state {
46 	IWL_TI_0,	/* normal temperature, system power state */
47 	IWL_TI_1,	/* high temperature detect, low power state */
48 	IWL_TI_2,	/* higher temperature detected, lower power state */
49 	IWL_TI_CT_KILL, /* critical temperature detected, lowest power state */
50 	IWL_TI_STATE_MAX
51 };
52 
53 /**
54  * struct iwl_tt_restriction - Thermal Throttling restriction table
55  * @tx_stream: number of tx stream allowed
56  * @is_ht: ht enable/disable
57  * @rx_stream: number of rx stream allowed
58  *
59  * This table is used by advance thermal throttling management
60  * based on the current thermal throttling state, and determines
61  * the number of tx/rx streams and the status of HT operation.
62  */
63 struct iwl_tt_restriction {
64 	enum iwl_antenna_ok tx_stream;
65 	enum iwl_antenna_ok rx_stream;
66 	bool is_ht;
67 };
68 
69 /**
70  * struct iwl_tt_trans - Thermal Throttling transaction table
71  * @next_state:  next thermal throttling mode
72  * @tt_low: low temperature threshold to change state
73  * @tt_high: high temperature threshold to change state
74  *
75  * This is used by the advanced thermal throttling algorithm
76  * to determine the next thermal state to go based on the
77  * current temperature.
78  */
79 struct iwl_tt_trans {
80 	enum iwl_tt_state next_state;
81 	u32 tt_low;
82 	u32 tt_high;
83 };
84 
85 /**
86  * struct iwl_tt_mgnt - Thermal Throttling Management structure
87  * @advanced_tt:    advanced thermal throttle required
88  * @state:          current Thermal Throttling state
89  * @tt_power_mode:  Thermal Throttling power mode index
90  *		    being used to set power level when
91  *		    when thermal throttling state != IWL_TI_0
92  *		    the tt_power_mode should set to different
93  *		    power mode based on the current tt state
94  * @tt_previous_temperature: last measured temperature
95  * @iwl_tt_restriction: ptr to restriction tbl, used by advance
96  *		    thermal throttling to determine how many tx/rx streams
97  *		    should be used in tt state; and can HT be enabled or not
98  * @iwl_tt_trans: ptr to adv trans table, used by advance thermal throttling
99  *		    state transaction
100  * @ct_kill_toggle: used to toggle the CSR bit when checking uCode temperature
101  * @ct_kill_exit_tm: timer to exit thermal kill
102  */
103 struct iwl_tt_mgmt {
104 	enum iwl_tt_state state;
105 	bool advanced_tt;
106 	u8 tt_power_mode;
107 	bool ct_kill_toggle;
108 #ifdef CONFIG_IWLWIFI_DEBUG
109 	s32 tt_previous_temp;
110 #endif
111 	struct iwl_tt_restriction *restriction;
112 	struct iwl_tt_trans *transaction;
113 	struct timer_list ct_kill_exit_tm;
114 	struct timer_list ct_kill_waiting_tm;
115 };
116 
117 u8 iwl_tt_current_power_mode(struct iwl_priv *priv);
118 bool iwl_tt_is_low_power_state(struct iwl_priv *priv);
119 bool iwl_ht_enabled(struct iwl_priv *priv);
120 enum iwl_antenna_ok iwl_tx_ant_restriction(struct iwl_priv *priv);
121 enum iwl_antenna_ok iwl_rx_ant_restriction(struct iwl_priv *priv);
122 void iwl_tt_enter_ct_kill(struct iwl_priv *priv);
123 void iwl_tt_exit_ct_kill(struct iwl_priv *priv);
124 void iwl_tt_handler(struct iwl_priv *priv);
125 void iwl_tt_initialize(struct iwl_priv *priv);
126 void iwl_tt_exit(struct iwl_priv *priv);
127 
128 #endif  /* __iwl_tt_setting_h__ */
129