Gitiles
Code Review Sign In
gerrit-public.fairphone.software / fp2-dev / kernel / msm / fca5238ef3232cd0cf4bf0457e751b3bb20912a9 / . / drivers / net / wireless / ath / ath5k / ani.h
blob: d0a664039c877c2f4e8f064c499833a9bf0a3883 [file] [log] [blame]
Bruno Randolf2111ac02010-04-02 18:44:08 +0900[diff] [blame]1/*
2 * Copyright (C) 2010 Bruno Randolf <br1@einfach.org>
3 *
4 * Permission to use, copy, modify, and/or distribute this software for any
5 * purpose with or without fee is hereby granted, provided that the above
6 * copyright notice and this permission notice appear in all copies.
7 *
8 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
9 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
10 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
11 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
12 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
13 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
14 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
15 */
16#ifndef ANI_H
17#define ANI_H
18
19/* these thresholds are relative to the ATH5K_ANI_LISTEN_PERIOD */
20#define ATH5K_ANI_LISTEN_PERIOD 100
21#define ATH5K_ANI_OFDM_TRIG_HIGH 500
22#define ATH5K_ANI_OFDM_TRIG_LOW 200
23#define ATH5K_ANI_CCK_TRIG_HIGH 200
24#define ATH5K_ANI_CCK_TRIG_LOW 100
25
26/* average beacon RSSI thresholds */
27#define ATH5K_ANI_RSSI_THR_HIGH 40
28#define ATH5K_ANI_RSSI_THR_LOW 7
29
30/* maximum availabe levels */
31#define ATH5K_ANI_MAX_FIRSTEP_LVL 2
32#define ATH5K_ANI_MAX_NOISE_IMM_LVL 1
33
34
35/**
36 * enum ath5k_ani_mode - mode for ANI / noise sensitivity
37 *
38 * @ATH5K_ANI_MODE_OFF: Turn ANI off. This can be useful to just stop the ANI
39 * algorithm after it has been on auto mode.
40 * ATH5K_ANI_MODE_MANUAL_LOW: Manually set all immunity parameters to low,
41 * maximizing sensitivity. ANI will not run.
42 * ATH5K_ANI_MODE_MANUAL_HIGH: Manually set all immunity parameters to high,
43 * minimizing sensitivity. ANI will not run.
44 * ATH5K_ANI_MODE_AUTO: Automatically control immunity parameters based on the
45 * amount of OFDM and CCK frame errors (default).
46 */
47enum ath5k_ani_mode {
48 ATH5K_ANI_MODE_OFF = 0,
49 ATH5K_ANI_MODE_MANUAL_LOW = 1,
50 ATH5K_ANI_MODE_MANUAL_HIGH = 2,
51 ATH5K_ANI_MODE_AUTO = 3
52};
53
54
55/**
56 * struct ath5k_ani_state - ANI state and associated counters
57 *
58 * @max_spur_level: the maximum spur level is chip dependent
59 */
60struct ath5k_ani_state {
61 enum ath5k_ani_mode ani_mode;
62
63 /* state */
64 int noise_imm_level;
65 int spur_level;
66 int firstep_level;
67 bool ofdm_weak_sig;
68 bool cck_weak_sig;
69
70 int max_spur_level;
71
72 /* used by the algorithm */
73 unsigned int listen_time;
74 unsigned int ofdm_errors;
75 unsigned int cck_errors;
76
77 /* debug/statistics only: numbers from last ANI calibration */
Felix Fietkau7109ca52010-10-08 22:13:54 +0200[diff] [blame]78 struct ath_cycle_counters last_cc;
Bruno Randolf2111ac02010-04-02 18:44:08 +0900[diff] [blame]79 unsigned int last_listen;
80 unsigned int last_ofdm_errors;
81 unsigned int last_cck_errors;
82 unsigned int sum_ofdm_errors;
83 unsigned int sum_cck_errors;
84};
85
86void ath5k_ani_init(struct ath5k_hw *ah, enum ath5k_ani_mode mode);
87void ath5k_ani_mib_intr(struct ath5k_hw *ah);
88void ath5k_ani_calibration(struct ath5k_hw *ah);
89void ath5k_ani_phy_error_report(struct ath5k_hw *ah,
90 enum ath5k_phy_error_code phyerr);
91
92/* for manual control */
93void ath5k_ani_set_noise_immunity_level(struct ath5k_hw *ah, int level);
94void ath5k_ani_set_spur_immunity_level(struct ath5k_hw *ah, int level);
95void ath5k_ani_set_firstep_level(struct ath5k_hw *ah, int level);
96void ath5k_ani_set_ofdm_weak_signal_detection(struct ath5k_hw *ah, bool on);
97void ath5k_ani_set_cck_weak_signal_detection(struct ath5k_hw *ah, bool on);
98
99void ath5k_ani_print_counters(struct ath5k_hw *ah);
100
101#endif /* ANI_H */