~ubuntu-branches/ubuntu/precise/linux-lowlatency/precise

« back to all changes in this revision

Viewing changes to drivers/net/wireless/ath/ath5k/ani.h

  • Committer: Package Import Robot
  • Author(s): Alessio Igor Bogani
  • Date: 2011-10-26 11:13:05 UTC
  • Revision ID: package-import@ubuntu.com-20111026111305-tz023xykf0i6eosh
Tags: upstream-3.2.0
ImportĀ upstreamĀ versionĀ 3.2.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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
#include "../ath.h"
 
20
 
 
21
enum ath5k_phy_error_code;
 
22
 
 
23
/* these thresholds are relative to the ATH5K_ANI_LISTEN_PERIOD */
 
24
#define ATH5K_ANI_LISTEN_PERIOD         100
 
25
#define ATH5K_ANI_OFDM_TRIG_HIGH        500
 
26
#define ATH5K_ANI_OFDM_TRIG_LOW         200
 
27
#define ATH5K_ANI_CCK_TRIG_HIGH         200
 
28
#define ATH5K_ANI_CCK_TRIG_LOW          100
 
29
 
 
30
/* average beacon RSSI thresholds */
 
31
#define ATH5K_ANI_RSSI_THR_HIGH         40
 
32
#define ATH5K_ANI_RSSI_THR_LOW          7
 
33
 
 
34
/* maximum available levels */
 
35
#define ATH5K_ANI_MAX_FIRSTEP_LVL       2
 
36
#define ATH5K_ANI_MAX_NOISE_IMM_LVL     1
 
37
 
 
38
 
 
39
/**
 
40
 * enum ath5k_ani_mode - mode for ANI / noise sensitivity
 
41
 *
 
42
 * @ATH5K_ANI_MODE_OFF: Turn ANI off. This can be useful to just stop the ANI
 
43
 *      algorithm after it has been on auto mode.
 
44
 * ATH5K_ANI_MODE_MANUAL_LOW: Manually set all immunity parameters to low,
 
45
 *      maximizing sensitivity. ANI will not run.
 
46
 * ATH5K_ANI_MODE_MANUAL_HIGH: Manually set all immunity parameters to high,
 
47
 *      minimizing sensitivity. ANI will not run.
 
48
 * ATH5K_ANI_MODE_AUTO: Automatically control immunity parameters based on the
 
49
 *      amount of OFDM and CCK frame errors (default).
 
50
 */
 
51
enum ath5k_ani_mode {
 
52
        ATH5K_ANI_MODE_OFF              = 0,
 
53
        ATH5K_ANI_MODE_MANUAL_LOW       = 1,
 
54
        ATH5K_ANI_MODE_MANUAL_HIGH      = 2,
 
55
        ATH5K_ANI_MODE_AUTO             = 3
 
56
};
 
57
 
 
58
 
 
59
/**
 
60
 * struct ath5k_ani_state - ANI state and associated counters
 
61
 *
 
62
 * @max_spur_level: the maximum spur level is chip dependent
 
63
 */
 
64
struct ath5k_ani_state {
 
65
        enum ath5k_ani_mode     ani_mode;
 
66
 
 
67
        /* state */
 
68
        int                     noise_imm_level;
 
69
        int                     spur_level;
 
70
        int                     firstep_level;
 
71
        bool                    ofdm_weak_sig;
 
72
        bool                    cck_weak_sig;
 
73
 
 
74
        int                     max_spur_level;
 
75
 
 
76
        /* used by the algorithm */
 
77
        unsigned int            listen_time;
 
78
        unsigned int            ofdm_errors;
 
79
        unsigned int            cck_errors;
 
80
 
 
81
        /* debug/statistics only: numbers from last ANI calibration */
 
82
        struct ath_cycle_counters last_cc;
 
83
        unsigned int            last_listen;
 
84
        unsigned int            last_ofdm_errors;
 
85
        unsigned int            last_cck_errors;
 
86
        unsigned int            sum_ofdm_errors;
 
87
        unsigned int            sum_cck_errors;
 
88
};
 
89
 
 
90
void ath5k_ani_init(struct ath5k_hw *ah, enum ath5k_ani_mode mode);
 
91
void ath5k_ani_mib_intr(struct ath5k_hw *ah);
 
92
void ath5k_ani_calibration(struct ath5k_hw *ah);
 
93
void ath5k_ani_phy_error_report(struct ath5k_hw *ah,
 
94
                                enum ath5k_phy_error_code phyerr);
 
95
 
 
96
/* for manual control */
 
97
void ath5k_ani_set_noise_immunity_level(struct ath5k_hw *ah, int level);
 
98
void ath5k_ani_set_spur_immunity_level(struct ath5k_hw *ah, int level);
 
99
void ath5k_ani_set_firstep_level(struct ath5k_hw *ah, int level);
 
100
void ath5k_ani_set_ofdm_weak_signal_detection(struct ath5k_hw *ah, bool on);
 
101
void ath5k_ani_set_cck_weak_signal_detection(struct ath5k_hw *ah, bool on);
 
102
 
 
103
void ath5k_ani_print_counters(struct ath5k_hw *ah);
 
104
 
 
105
#endif /* ANI_H */