drivers/net/wireless/ath/ath9k/calib.h

   1 /*
   2  * Copyright (c) 2008-2011 Atheros Communications Inc.
   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
  17 #ifndef CALIB_H
  18 #define CALIB_H
  19
  20 #include "hw.h"
  21
  22 #define AR_PHY_CCA_FILTERWINDOW_LENGTH          5
  23
  24 /* Internal noise floor can vary by about 6db depending on the frequency */
  25 #define ATH9K_NF_CAL_NOISE_THRESH               6
  26
  27 #define NUM_NF_READINGS       6
  28 #define ATH9K_NF_CAL_HIST_MAX 5
  29
  30 struct ar5416IniArray {
  31         u32 *ia_array;
  32         u32 ia_rows;
  33         u32 ia_columns;
  34 };
  35
  36 #define INIT_INI_ARRAY(iniarray, array) do {    \
  37                 (iniarray)->ia_array = (u32 *)(array);          \
  38                 (iniarray)->ia_rows = ARRAY_SIZE(array);        \
  39                 (iniarray)->ia_columns = ARRAY_SIZE(array[0]);  \
  40         } while (0)
  41
  42 #define INI_RA(iniarray, row, column) \
  43         (((iniarray)->ia_array)[(row) * ((iniarray)->ia_columns) + (column)])
  44
  45 #define INIT_CAL(_perCal) do {                          \
  46                 (_perCal)->calState = CAL_WAITING;      \
  47                 (_perCal)->calNext = NULL;              \
  48         } while (0)
  49
  50 #define INSERT_CAL(_ahp, _perCal)                                       \
  51         do {                                                            \
  52                 if ((_ahp)->cal_list_last == NULL) {                    \
  53                         (_ahp)->cal_list =                              \
  54                                 (_ahp)->cal_list_last = (_perCal);      \
  55                         ((_ahp)->cal_list_last)->calNext = (_perCal); \
  56                 } else {                                                \
  57                         ((_ahp)->cal_list_last)->calNext = (_perCal); \
  58                         (_ahp)->cal_list_last = (_perCal);              \
  59                         (_perCal)->calNext = (_ahp)->cal_list;  \
  60                 }                                                       \
  61         } while (0)
  62
  63 enum ath9k_cal_state {
  64         CAL_INACTIVE,
  65         CAL_WAITING,
  66         CAL_RUNNING,
  67         CAL_DONE
  68 };
  69
  70 #define MIN_CAL_SAMPLES     1
  71 #define MAX_CAL_SAMPLES    64
  72 #define INIT_LOG_COUNT      5
  73 #define PER_MIN_LOG_COUNT   2
  74 #define PER_MAX_LOG_COUNT  10
  75
  76 struct ath9k_percal_data {
  77         u32 calType;
  78         u32 calNumSamples;
  79         u32 calCountMax;
  80         void (*calCollect) (struct ath_hw *);
  81         void (*calPostProc) (struct ath_hw *, u8);
  82 };
  83
  84 struct ath9k_cal_list {
  85         const struct ath9k_percal_data *calData;
  86         enum ath9k_cal_state calState;
  87         struct ath9k_cal_list *calNext;
  88 };
  89
  90 struct ath9k_nfcal_hist {
  91         int16_t nfCalBuffer[ATH9K_NF_CAL_HIST_MAX];
  92         u8 currIndex;
  93         int16_t privNF;
  94         u8 invalidNFcount;
  95 };
  96
  97 #define MAX_PACAL_SKIPCOUNT 8
  98 struct ath9k_pacal_info{
  99         int32_t prev_offset;    /* Previous value of PA offset value */
 100         int8_t max_skipcount;   /* Max No. of times PACAL can be skipped */
 101         int8_t skipcount;       /* No. of times the PACAL to be skipped */
 102 };
 103
 104 bool ath9k_hw_reset_calvalid(struct ath_hw *ah);
 105 void ath9k_hw_start_nfcal(struct ath_hw *ah, bool update);
 106 void ath9k_hw_loadnf(struct ath_hw *ah, struct ath9k_channel *chan);
 107 bool ath9k_hw_getnf(struct ath_hw *ah, struct ath9k_channel *chan);
 108 void ath9k_init_nfcal_hist_buffer(struct ath_hw *ah,
 109                                   struct ath9k_channel *chan);
 110 void ath9k_hw_bstuck_nfcal(struct ath_hw *ah);
 111 void ath9k_hw_reset_calibration(struct ath_hw *ah,
 112                                 struct ath9k_cal_list *currCal);
 113 s16 ath9k_hw_getchan_noise(struct ath_hw *ah, struct ath9k_channel *chan);
 114
 115
 116 #endif /* CALIB_H */