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