xref: /openbmc/linux/drivers/net/wireless/ath/ath9k/calib.h (revision e5451c8f8330e03ad3cfa16048b4daf961af434f)
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 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  
69  enum 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  
82  struct 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  
90  struct ath9k_cal_list {
91  	const struct ath9k_percal_data *calData;
92  	enum ath9k_cal_state calState;
93  	struct ath9k_cal_list *calNext;
94  };
95  
96  struct 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
104  struct 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  
110  bool ath9k_hw_reset_calvalid(struct ath_hw *ah);
111  void ath9k_hw_start_nfcal(struct ath_hw *ah, bool update);
112  int ath9k_hw_loadnf(struct ath_hw *ah, struct ath9k_channel *chan);
113  bool ath9k_hw_getnf(struct ath_hw *ah, struct ath9k_channel *chan);
114  void ath9k_init_nfcal_hist_buffer(struct ath_hw *ah,
115  				  struct ath9k_channel *chan);
116  void ath9k_hw_bstuck_nfcal(struct ath_hw *ah);
117  void ath9k_hw_reset_calibration(struct ath_hw *ah,
118  				struct ath9k_cal_list *currCal);
119  s16 ath9k_hw_getchan_noise(struct ath_hw *ah, struct ath9k_channel *chan,
120  			   s16 nf);
121  
122  
123  #endif /* CALIB_H */
124