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 */