LXR linux/drivers/net/wireless/intel/iwlwifi/dvm/tt.h

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