[deliverable/linux.git] / drivers / net / wireless / ath / ath9k / calib.h

/*
 * Copyright (c) 2008-2011 Atheros Communications Inc.
 *
 * Permission to use, copy, modify, and/or distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */

#ifndef CALIB_H
#define CALIB_H

#include "hw.h"

#define AR_PHY_CCA_FILTERWINDOW_LENGTH          5

/* Internal noise floor can vary by about 6db depending on the frequency */
#define ATH9K_NF_CAL_NOISE_THRESH		6

#define NUM_NF_READINGS       6
#define ATH9K_NF_CAL_HIST_MAX 5

struct ar5416IniArray {
	u32 *ia_array;
	u32 ia_rows;
	u32 ia_columns;
};

#define STATIC_INI_ARRAY(array) {			\
		.ia_array = (u32 *)(array),		\
		.ia_rows = ARRAY_SIZE(array),		\
		.ia_columns = ARRAY_SIZE(array[0]),	\
	}

#define INIT_INI_ARRAY(iniarray, array) do {	\
		(iniarray)->ia_array = (u32 *)(array);		\
		(iniarray)->ia_rows = ARRAY_SIZE(array);	\
		(iniarray)->ia_columns = ARRAY_SIZE(array[0]);	\
	} while (0)

#define INI_RA(iniarray, row, column) \
	(((iniarray)->ia_array)[(row) *	((iniarray)->ia_columns) + (column)])

#define INIT_CAL(_perCal) do {				\
		(_perCal)->calState = CAL_WAITING;	\
		(_perCal)->calNext = NULL;		\
	} while (0)

#define INSERT_CAL(_ahp, _perCal)					\
	do {								\
		if ((_ahp)->cal_list_last == NULL) {			\
			(_ahp)->cal_list =				\
				(_ahp)->cal_list_last = (_perCal);	\
			((_ahp)->cal_list_last)->calNext = (_perCal); \
		} else {						\
			((_ahp)->cal_list_last)->calNext = (_perCal); \
			(_ahp)->cal_list_last = (_perCal);		\
			(_perCal)->calNext = (_ahp)->cal_list;	\
		}							\
	} while (0)

enum ath9k_cal_state {
	CAL_INACTIVE,
	CAL_WAITING,
	CAL_RUNNING,
	CAL_DONE
};

#define MIN_CAL_SAMPLES     1
#define MAX_CAL_SAMPLES    64
#define INIT_LOG_COUNT      5
#define PER_MIN_LOG_COUNT   2
#define PER_MAX_LOG_COUNT  10

struct ath9k_percal_data {
	u32 calType;
	u32 calNumSamples;
	u32 calCountMax;
	void (*calCollect) (struct ath_hw *);
	void (*calPostProc) (struct ath_hw *, u8);
};

struct ath9k_cal_list {
	const struct ath9k_percal_data *calData;
	enum ath9k_cal_state calState;
	struct ath9k_cal_list *calNext;
};

struct ath9k_nfcal_hist {
	int16_t nfCalBuffer[ATH9K_NF_CAL_HIST_MAX];
	u8 currIndex;
	int16_t privNF;
	u8 invalidNFcount;
};

#define MAX_PACAL_SKIPCOUNT 8
struct ath9k_pacal_info{
	int32_t prev_offset;	/* Previous value of PA offset value */
	int8_t max_skipcount;	/* Max No. of times PACAL can be skipped */
	int8_t skipcount;	/* No. of times the PACAL to be skipped */
};

bool ath9k_hw_reset_calvalid(struct ath_hw *ah);
void ath9k_hw_start_nfcal(struct ath_hw *ah, bool update);
void ath9k_hw_loadnf(struct ath_hw *ah, struct ath9k_channel *chan);
bool ath9k_hw_getnf(struct ath_hw *ah, struct ath9k_channel *chan);
void ath9k_init_nfcal_hist_buffer(struct ath_hw *ah,
				  struct ath9k_channel *chan);
void ath9k_hw_bstuck_nfcal(struct ath_hw *ah);
void ath9k_hw_reset_calibration(struct ath_hw *ah,
				struct ath9k_cal_list *currCal);
s16 ath9k_hw_getchan_noise(struct ath_hw *ah, struct ath9k_channel *chan,
			   s16 nf);


#endif /* CALIB_H */
Commit	Line	Data
394cf0a1	1	/*
5b68138e	2	* Copyright (c) 2008-2011 Atheros Communications Inc.
394cf0a1 S	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
c46917bb LR	20	#include "hw.h"
c46917bb LR	21
394cf0a1 S	22	#define AR_PHY_CCA_FILTERWINDOW_LENGTH 5
394cf0a1 S	23
b7c0c238 FF	24	/* Internal noise floor can vary by about 6db depending on the frequency */
	25	#define ATH9K_NF_CAL_NOISE_THRESH 6
	26
394cf0a1 S	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
a043dfb9 FF	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
a364517b	42	#define INIT_INI_ARRAY(iniarray, array) do { \
394cf0a1	43	(iniarray)->ia_array = (u32 *)(array); \
a364517b FF	44	(iniarray)->ia_rows = ARRAY_SIZE(array); \
a364517b FF	45	(iniarray)->ia_columns = ARRAY_SIZE(array[0]); \
394cf0a1 S	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 { \
2660b81a S	58	if ((_ahp)->cal_list_last == NULL) { \
	59	(_ahp)->cal_list = \
	60	(_ahp)->cal_list_last = (_perCal); \
	61	((_ahp)->cal_list_last)->calNext = (_perCal); \
394cf0a1	62	} else { \
2660b81a S	63	((_ahp)->cal_list_last)->calNext = (_perCal); \
	64	(_ahp)->cal_list_last = (_perCal); \
	65	(_perCal)->calNext = (_ahp)->cal_list; \
394cf0a1 S	66	} \
	67	} while (0)
	68
cbfe9468	69	enum ath9k_cal_state {
394cf0a1 S	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
cbfe9468	82	struct ath9k_percal_data {
6497827f	83	u32 calType;
394cf0a1 S	84	u32 calNumSamples;
394cf0a1 S	85	u32 calCountMax;
cbe61d8a S	86	void (calCollect) (struct ath_hw );
cbe61d8a S	87	void (calPostProc) (struct ath_hw , u8);
394cf0a1 S	88	};
394cf0a1 S	89
cbfe9468 S	90	struct ath9k_cal_list {
	91	const struct ath9k_percal_data *calData;
	92	enum ath9k_cal_state calState;
	93	struct ath9k_cal_list *calNext;
394cf0a1 S	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
a13883b0 S	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
cbe61d8a	110	bool ath9k_hw_reset_calvalid(struct ath_hw *ah);
00c86590	111	void ath9k_hw_start_nfcal(struct ath_hw *ah, bool update);
bbacee13	112	void ath9k_hw_loadnf(struct ath_hw ah, struct ath9k_channel chan);
4254bc1c	113	bool ath9k_hw_getnf(struct ath_hw ah, struct ath9k_channel chan);
20bd2a09 FF	114	void ath9k_init_nfcal_hist_buffer(struct ath_hw *ah,
20bd2a09 FF	115	struct ath9k_channel *chan);
70cf1533	116	void ath9k_hw_bstuck_nfcal(struct ath_hw *ah);
795f5e2c LR	117	void ath9k_hw_reset_calibration(struct ath_hw *ah,
795f5e2c LR	118	struct ath9k_cal_list *currCal);
5bc225ac LB	119	s16 ath9k_hw_getchan_noise(struct ath_hw ah, struct ath9k_channel chan,
5bc225ac LB	120	s16 nf);
795f5e2c	121
394cf0a1 S	122
394cf0a1 S	123	#endif /* CALIB_H */