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, rows, columns) do {	\
37 		(iniarray)->ia_array = (u32 *)(array);		\
38 		(iniarray)->ia_rows = (rows);			\
39 		(iniarray)->ia_columns = (columns);		\
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 */
117