12111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf/* 22111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * Copyright (C) 2010 Bruno Randolf <br1@einfach.org> 32111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * 42111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * Permission to use, copy, modify, and/or distribute this software for any 52111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * purpose with or without fee is hereby granted, provided that the above 62111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * copyright notice and this permission notice appear in all copies. 72111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * 82111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 92111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 102111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 112111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 122111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 132111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 142111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 152111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf */ 162111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#ifndef ANI_H 172111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ANI_H 182111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 19931be260ed54843edac37cb3ff09a40b86114b31Pavel Roskin#include "../ath.h" 20931be260ed54843edac37cb3ff09a40b86114b31Pavel Roskin 21931be260ed54843edac37cb3ff09a40b86114b31Pavel Roskinenum ath5k_phy_error_code; 22931be260ed54843edac37cb3ff09a40b86114b31Pavel Roskin 232111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf/* these thresholds are relative to the ATH5K_ANI_LISTEN_PERIOD */ 242111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_LISTEN_PERIOD 100 252111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_OFDM_TRIG_HIGH 500 262111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_OFDM_TRIG_LOW 200 272111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_CCK_TRIG_HIGH 200 282111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_CCK_TRIG_LOW 100 292111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 302111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf/* average beacon RSSI thresholds */ 312111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_RSSI_THR_HIGH 40 322111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_RSSI_THR_LOW 7 332111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 3425985edcedea6396277003854657b5f3cb31a628Lucas De Marchi/* maximum available levels */ 352111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_MAX_FIRSTEP_LVL 2 362111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#define ATH5K_ANI_MAX_NOISE_IMM_LVL 1 372111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 382111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 392111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf/** 402111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * enum ath5k_ani_mode - mode for ANI / noise sensitivity 412111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * 422111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * @ATH5K_ANI_MODE_OFF: Turn ANI off. This can be useful to just stop the ANI 43c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * algorithm after it has been on auto mode. 44c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @ATH5K_ANI_MODE_MANUAL_LOW: Manually set all immunity parameters to low, 45c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * maximizing sensitivity. ANI will not run. 46c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @ATH5K_ANI_MODE_MANUAL_HIGH: Manually set all immunity parameters to high, 47c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * minimizing sensitivity. ANI will not run. 48c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @ATH5K_ANI_MODE_AUTO: Automatically control immunity parameters based on the 49c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * amount of OFDM and CCK frame errors (default). 502111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf */ 512111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfenum ath5k_ani_mode { 522111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf ATH5K_ANI_MODE_OFF = 0, 532111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf ATH5K_ANI_MODE_MANUAL_LOW = 1, 542111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf ATH5K_ANI_MODE_MANUAL_HIGH = 2, 552111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf ATH5K_ANI_MODE_AUTO = 3 562111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf}; 572111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 582111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 592111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf/** 602111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf * struct ath5k_ani_state - ANI state and associated counters 61c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @ani_mode: One of enum ath5k_ani_mode 62c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @noise_imm_level: Noise immunity level 63c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @spur_level: Spur immunity level 64c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @firstep_level: FIRstep level 65c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @ofdm_weak_sig: OFDM weak signal detection state (on/off) 66c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @cck_weak_sig: CCK weak signal detection state (on/off) 67c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @max_spur_level: Max spur immunity level (chip specific) 68c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @listen_time: Listen time 69c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @ofdm_errors: OFDM timing error count 70c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @cck_errors: CCK timing error count 71c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @last_cc: The &struct ath_cycle_counters (for stats) 72c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @last_listen: Listen time from previous run (for stats) 73c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @last_ofdm_errors: OFDM timing error count from previous run (for tats) 74c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @last_cck_errors: CCK timing error count from previous run (for stats) 75c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @sum_ofdm_errors: Sum of OFDM timing errors (for stats) 76c47faa364cfb249d5d7670fb7293a6f9acd8aa9eNick Kossifidis * @sum_cck_errors: Sum of all CCK timing errors (for stats) 772111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf */ 782111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfstruct ath5k_ani_state { 792111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf enum ath5k_ani_mode ani_mode; 802111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 812111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf /* state */ 822111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf int noise_imm_level; 832111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf int spur_level; 842111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf int firstep_level; 852111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf bool ofdm_weak_sig; 862111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf bool cck_weak_sig; 872111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 882111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf int max_spur_level; 892111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 902111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf /* used by the algorithm */ 912111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int listen_time; 922111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int ofdm_errors; 932111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int cck_errors; 942111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 952111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf /* debug/statistics only: numbers from last ANI calibration */ 967109ca5c80a0bb94378ebd7f8bb6d00edb5e6fbaFelix Fietkau struct ath_cycle_counters last_cc; 972111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int last_listen; 982111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int last_ofdm_errors; 992111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int last_cck_errors; 1002111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int sum_ofdm_errors; 1012111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf unsigned int sum_cck_errors; 1022111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf}; 1032111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 1042111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_init(struct ath5k_hw *ah, enum ath5k_ani_mode mode); 1052111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_mib_intr(struct ath5k_hw *ah); 1062111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_calibration(struct ath5k_hw *ah); 1072111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_phy_error_report(struct ath5k_hw *ah, 1082111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf enum ath5k_phy_error_code phyerr); 1092111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 1102111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf/* for manual control */ 1112111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_set_noise_immunity_level(struct ath5k_hw *ah, int level); 1122111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_set_spur_immunity_level(struct ath5k_hw *ah, int level); 1132111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_set_firstep_level(struct ath5k_hw *ah, int level); 1142111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_set_ofdm_weak_signal_detection(struct ath5k_hw *ah, bool on); 1152111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_set_cck_weak_signal_detection(struct ath5k_hw *ah, bool on); 1162111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 1172111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolfvoid ath5k_ani_print_counters(struct ath5k_hw *ah); 1182111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf 1192111ac0d888767999c7dd6d1309dcc1fb8012022Bruno Randolf#endif /* ANI_H */ 120