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