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

/*
 * Copyright (c) 2008 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

extern const struct hal_percal_data iq_cal_multi_sample;
extern const struct hal_percal_data iq_cal_single_sample;
extern const struct hal_percal_data adc_gain_cal_multi_sample;
extern const struct hal_percal_data adc_gain_cal_single_sample;
extern const struct hal_percal_data adc_dc_cal_multi_sample;
extern const struct hal_percal_data adc_dc_cal_single_sample;
extern const struct hal_percal_data adc_init_dc_cal;

#define AR_PHY_CCA_MAX_GOOD_VALUE      		-85
#define AR_PHY_CCA_MAX_HIGH_VALUE      		-62
#define AR_PHY_CCA_MIN_BAD_VALUE       		-140
#define AR_PHY_CCA_FILTERWINDOW_LENGTH_INIT     3
#define AR_PHY_CCA_FILTERWINDOW_LENGTH          5

#define NUM_NF_READINGS       6
#define ATH9K_NF_CAL_HIST_MAX 5

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

#define INIT_INI_ARRAY(iniarray, array, rows, columns) do {	\
		(iniarray)->ia_array = (u32 *)(array);		\
		(iniarray)->ia_rows = (rows);			\
		(iniarray)->ia_columns = (columns);		\
	} 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 hal_cal_types {
	ADC_DC_INIT_CAL = 0x1,
	ADC_GAIN_CAL = 0x2,
	ADC_DC_CAL = 0x4,
	IQ_MISMATCH_CAL = 0x8
};

enum hal_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 hal_percal_data {
	enum hal_cal_types calType;
	u32 calNumSamples;
	u32 calCountMax;
	void (*calCollect) (struct ath_hw *);
	void (*calPostProc) (struct ath_hw *, u8);
};

struct hal_cal_list {
	const struct hal_percal_data *calData;
	enum hal_cal_state calState;
	struct hal_cal_list *calNext;
};

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

bool ath9k_hw_reset_calvalid(struct ath_hw *ah);
void ath9k_hw_start_nfcal(struct ath_hw *ah);
void ath9k_hw_loadnf(struct ath_hw *ah, struct ath9k_channel *chan);
int16_t ath9k_hw_getnf(struct ath_hw *ah,
		       struct ath9k_channel *chan);
void ath9k_init_nfcal_hist_buffer(struct ath_hw *ah);
s16 ath9k_hw_getchan_noise(struct ath_hw *ah, struct ath9k_channel *chan);
bool ath9k_hw_calibrate(struct ath_hw *ah, struct ath9k_channel *chan,
			u8 rxchainmask, bool longcal,
			bool *isCalDone);
bool ath9k_hw_init_cal(struct ath_hw *ah,
		       struct ath9k_channel *chan);

#endif /* CALIB_H */
Commit	Line	Data
394cf0a1 S	1	/*
	2	* Copyright (c) 2008 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	extern const struct hal_percal_data iq_cal_multi_sample;
	21	extern const struct hal_percal_data iq_cal_single_sample;
	22	extern const struct hal_percal_data adc_gain_cal_multi_sample;
	23	extern const struct hal_percal_data adc_gain_cal_single_sample;
	24	extern const struct hal_percal_data adc_dc_cal_multi_sample;
	25	extern const struct hal_percal_data adc_dc_cal_single_sample;
	26	extern const struct hal_percal_data adc_init_dc_cal;
	27
	28	#define AR_PHY_CCA_MAX_GOOD_VALUE -85
	29	#define AR_PHY_CCA_MAX_HIGH_VALUE -62
b06e786d	30	#define AR_PHY_CCA_MIN_BAD_VALUE -140
394cf0a1 S	31	#define AR_PHY_CCA_FILTERWINDOW_LENGTH_INIT 3
	32	#define AR_PHY_CCA_FILTERWINDOW_LENGTH 5
	33
	34	#define NUM_NF_READINGS 6
	35	#define ATH9K_NF_CAL_HIST_MAX 5
	36
	37	struct ar5416IniArray {
	38	u32 *ia_array;
	39	u32 ia_rows;
	40	u32 ia_columns;
	41	};
	42
	43	#define INIT_INI_ARRAY(iniarray, array, rows, columns) do { \
	44	(iniarray)->ia_array = (u32 *)(array); \
	45	(iniarray)->ia_rows = (rows); \
	46	(iniarray)->ia_columns = (columns); \
	47	} while (0)
	48
	49	#define INI_RA(iniarray, row, column) \
	50	(((iniarray)->ia_array)[(row) * ((iniarray)->ia_columns) + (column)])
	51
	52	#define INIT_CAL(_perCal) do { \
	53	(_perCal)->calState = CAL_WAITING; \
	54	(_perCal)->calNext = NULL; \
	55	} while (0)
	56
	57	#define INSERT_CAL(_ahp, _perCal) \
	58	do { \
2660b81a S	59	if ((_ahp)->cal_list_last == NULL) { \
	60	(_ahp)->cal_list = \
	61	(_ahp)->cal_list_last = (_perCal); \
	62	((_ahp)->cal_list_last)->calNext = (_perCal); \
394cf0a1	63	} else { \
2660b81a S	64	((_ahp)->cal_list_last)->calNext = (_perCal); \
	65	(_ahp)->cal_list_last = (_perCal); \
	66	(_perCal)->calNext = (_ahp)->cal_list; \
394cf0a1 S	67	} \
	68	} while (0)
	69
	70	enum hal_cal_types {
	71	ADC_DC_INIT_CAL = 0x1,
	72	ADC_GAIN_CAL = 0x2,
	73	ADC_DC_CAL = 0x4,
	74	IQ_MISMATCH_CAL = 0x8
	75	};
	76
	77	enum hal_cal_state {
	78	CAL_INACTIVE,
	79	CAL_WAITING,
	80	CAL_RUNNING,
	81	CAL_DONE
	82	};
	83
	84	#define MIN_CAL_SAMPLES 1
	85	#define MAX_CAL_SAMPLES 64
	86	#define INIT_LOG_COUNT 5
	87	#define PER_MIN_LOG_COUNT 2
	88	#define PER_MAX_LOG_COUNT 10
	89
	90	struct hal_percal_data {
	91	enum hal_cal_types calType;
	92	u32 calNumSamples;
	93	u32 calCountMax;
cbe61d8a S	94	void (calCollect) (struct ath_hw );
cbe61d8a S	95	void (calPostProc) (struct ath_hw , u8);
394cf0a1 S	96	};
	97
	98	struct hal_cal_list {
	99	const struct hal_percal_data *calData;
	100	enum hal_cal_state calState;
	101	struct hal_cal_list *calNext;
	102	};
	103
	104	struct ath9k_nfcal_hist {
	105	int16_t nfCalBuffer[ATH9K_NF_CAL_HIST_MAX];
	106	u8 currIndex;
	107	int16_t privNF;
	108	u8 invalidNFcount;
	109	};
	110
cbe61d8a S	111	bool ath9k_hw_reset_calvalid(struct ath_hw *ah);
	112	void ath9k_hw_start_nfcal(struct ath_hw *ah);
	113	void ath9k_hw_loadnf(struct ath_hw ah, struct ath9k_channel chan);
	114	int16_t ath9k_hw_getnf(struct ath_hw *ah,
394cf0a1	115	struct ath9k_channel *chan);
cbe61d8a S	116	void ath9k_init_nfcal_hist_buffer(struct ath_hw *ah);
	117	s16 ath9k_hw_getchan_noise(struct ath_hw ah, struct ath9k_channel chan);
	118	bool ath9k_hw_calibrate(struct ath_hw ah, struct ath9k_channel chan,
394cf0a1 S	119	u8 rxchainmask, bool longcal,
394cf0a1 S	120	bool *isCalDone);
cbe61d8a	121	bool ath9k_hw_init_cal(struct ath_hw *ah,
394cf0a1 S	122	struct ath9k_channel *chan);
	123
	124	#endif /* CALIB_H */