xref: /freebsd/sys/dev/ath/ath_hal/ar5416/ar5416_cal_iq.c (revision ebacd8013fe5f7fdf9f6a5b286f6680dd2891036)
1 /*-
2  * SPDX-License-Identifier: ISC
3  *
4  * Copyright (c) 2002-2008 Sam Leffler, Errno Consulting
5  * Copyright (c) 2002-2008 Atheros Communications, Inc.
6  *
7  * Permission to use, copy, modify, and/or distribute this software for any
8  * purpose with or without fee is hereby granted, provided that the above
9  * copyright notice and this permission notice appear in all copies.
10  *
11  * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
12  * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
13  * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
14  * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
15  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
16  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
17  * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
18  *
19  * $FreeBSD$
20  */
21 #include "opt_ah.h"
22 
23 #include "ah.h"
24 #include "ah_internal.h"
25 #include "ah_devid.h"
26 
27 #include "ar5416/ar5416.h"
28 #include "ar5416/ar5416reg.h"
29 #include "ar5416/ar5416phy.h"
30 
31 /* IQ Cal aliases */
32 #define	totalPowerMeasI(i)	caldata[0][i].u
33 #define	totalPowerMeasQ(i)	caldata[1][i].u
34 #define	totalIqCorrMeas(i)	caldata[2][i].s
35 
36 /*
37  * Collect data from HW to later perform IQ Mismatch Calibration
38  */
39 void
40 ar5416IQCalCollect(struct ath_hal *ah)
41 {
42 	struct ar5416PerCal *cal = &AH5416(ah)->ah_cal;
43 	int i;
44 
45 	/*
46 	 * Accumulate IQ cal measures for active chains
47 	 */
48 	for (i = 0; i < AR5416_MAX_CHAINS; i++) {
49 		cal->totalPowerMeasI(i) +=
50 		    OS_REG_READ(ah, AR_PHY_CAL_MEAS_0(i));
51 		cal->totalPowerMeasQ(i) +=
52 		    OS_REG_READ(ah, AR_PHY_CAL_MEAS_1(i));
53 		cal->totalIqCorrMeas(i) += (int32_t)
54 		    OS_REG_READ(ah, AR_PHY_CAL_MEAS_2(i));
55 		HALDEBUG(ah, HAL_DEBUG_PERCAL,
56 		    "%d: Chn %d pmi=0x%08x;pmq=0x%08x;iqcm=0x%08x;\n",
57 		    cal->calSamples, i, cal->totalPowerMeasI(i),
58 		    cal->totalPowerMeasQ(i), cal->totalIqCorrMeas(i));
59 	}
60 }
61 
62 /*
63  * Use HW data to do IQ Mismatch Calibration
64  */
65 void
66 ar5416IQCalibration(struct ath_hal *ah, uint8_t numChains)
67 {
68 	struct ar5416PerCal *cal = &AH5416(ah)->ah_cal;
69 	int i;
70 
71 	for (i = 0; i < numChains; i++) {
72 		uint32_t powerMeasI = cal->totalPowerMeasI(i);
73 		uint32_t powerMeasQ = cal->totalPowerMeasQ(i);
74 		uint32_t iqCorrMeas = cal->totalIqCorrMeas(i);
75 		uint32_t qCoffDenom, iCoffDenom;
76 		int iqCorrNeg;
77 
78 		HALDEBUG(ah, HAL_DEBUG_PERCAL,
79 		    "Start IQ Cal and Correction for Chain %d\n", i);
80 		HALDEBUG(ah, HAL_DEBUG_PERCAL,
81 		    "Orignal: iq_corr_meas = 0x%08x\n", iqCorrMeas);
82 
83 		iqCorrNeg = 0;
84 		/* iqCorrMeas is always negative. */
85 		if (iqCorrMeas > 0x80000000)  {
86 			iqCorrMeas = (0xffffffff - iqCorrMeas) + 1;
87 			iqCorrNeg = 1;
88 		}
89 
90 		HALDEBUG(ah, HAL_DEBUG_PERCAL, " pwr_meas_i = 0x%08x\n",
91 		    powerMeasI);
92 		HALDEBUG(ah, HAL_DEBUG_PERCAL, " pwr_meas_q = 0x%08x\n",
93 		    powerMeasQ);
94 		HALDEBUG(ah, HAL_DEBUG_PERCAL, " iqCorrNeg is 0x%08x\n",
95 		    iqCorrNeg);
96 
97 		iCoffDenom = (powerMeasI/2 + powerMeasQ/2)/ 128;
98 		qCoffDenom = powerMeasQ / 64;
99 		/* Protect against divide-by-0 */
100 		if (powerMeasQ != 0) {
101 			/* IQ corr_meas is already negated if iqcorr_neg == 1 */
102 			int32_t iCoff = iqCorrMeas/iCoffDenom;
103 			int32_t qCoff = powerMeasI/qCoffDenom - 64;
104 
105 			HALDEBUG(ah, HAL_DEBUG_PERCAL, " iCoff = 0x%08x\n",
106 			    iCoff);
107 			HALDEBUG(ah, HAL_DEBUG_PERCAL, " qCoff = 0x%08x\n",
108 			    qCoff);
109 
110 			/* Negate iCoff if iqCorrNeg == 0 */
111 			iCoff = iCoff & 0x3f;
112 			HALDEBUG(ah, HAL_DEBUG_PERCAL,
113 			    "New:  iCoff = 0x%08x\n", iCoff);
114 
115 			if (iqCorrNeg == 0x0)
116 				iCoff = 0x40 - iCoff;
117 			if (qCoff > 15)
118 				qCoff = 15;
119 			else if (qCoff <= -16)
120 				qCoff = -16;
121 			HALDEBUG(ah, HAL_DEBUG_PERCAL,
122 			    " : iCoff = 0x%x  qCoff = 0x%x\n", iCoff, qCoff);
123 
124 			OS_REG_RMW_FIELD(ah, AR_PHY_TIMING_CTRL4_CHAIN(i),
125 			    AR_PHY_TIMING_CTRL4_IQCORR_Q_I_COFF, iCoff);
126 			OS_REG_RMW_FIELD(ah, AR_PHY_TIMING_CTRL4_CHAIN(i),
127 			    AR_PHY_TIMING_CTRL4_IQCORR_Q_Q_COFF, qCoff);
128 			HALDEBUG(ah, HAL_DEBUG_PERCAL,
129 			    "IQ Cal and Correction done for Chain %d\n", i);
130 		}
131 	}
132 	OS_REG_SET_BIT(ah, AR_PHY_TIMING_CTRL4,
133 	    AR_PHY_TIMING_CTRL4_IQCORR_ENABLE);
134 }
135