xref: /freebsd/sys/dev/ath/ath_hal/ar5416/ar5416_cal_iq.c (revision 02e9120893770924227138ba49df1edb3896112a)
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 #include "opt_ah.h"
20 
21 #include "ah.h"
22 #include "ah_internal.h"
23 #include "ah_devid.h"
24 
25 #include "ar5416/ar5416.h"
26 #include "ar5416/ar5416reg.h"
27 #include "ar5416/ar5416phy.h"
28 
29 /* IQ Cal aliases */
30 #define	totalPowerMeasI(i)	caldata[0][i].u
31 #define	totalPowerMeasQ(i)	caldata[1][i].u
32 #define	totalIqCorrMeas(i)	caldata[2][i].s
33 
34 /*
35  * Collect data from HW to later perform IQ Mismatch Calibration
36  */
37 void
38 ar5416IQCalCollect(struct ath_hal *ah)
39 {
40 	struct ar5416PerCal *cal = &AH5416(ah)->ah_cal;
41 	int i;
42 
43 	/*
44 	 * Accumulate IQ cal measures for active chains
45 	 */
46 	for (i = 0; i < AR5416_MAX_CHAINS; i++) {
47 		cal->totalPowerMeasI(i) +=
48 		    OS_REG_READ(ah, AR_PHY_CAL_MEAS_0(i));
49 		cal->totalPowerMeasQ(i) +=
50 		    OS_REG_READ(ah, AR_PHY_CAL_MEAS_1(i));
51 		cal->totalIqCorrMeas(i) += (int32_t)
52 		    OS_REG_READ(ah, AR_PHY_CAL_MEAS_2(i));
53 		HALDEBUG(ah, HAL_DEBUG_PERCAL,
54 		    "%d: Chn %d pmi=0x%08x;pmq=0x%08x;iqcm=0x%08x;\n",
55 		    cal->calSamples, i, cal->totalPowerMeasI(i),
56 		    cal->totalPowerMeasQ(i), cal->totalIqCorrMeas(i));
57 	}
58 }
59 
60 /*
61  * Use HW data to do IQ Mismatch Calibration
62  */
63 void
64 ar5416IQCalibration(struct ath_hal *ah, uint8_t numChains)
65 {
66 	struct ar5416PerCal *cal = &AH5416(ah)->ah_cal;
67 	int i;
68 
69 	for (i = 0; i < numChains; i++) {
70 		uint32_t powerMeasI = cal->totalPowerMeasI(i);
71 		uint32_t powerMeasQ = cal->totalPowerMeasQ(i);
72 		uint32_t iqCorrMeas = cal->totalIqCorrMeas(i);
73 		uint32_t qCoffDenom, iCoffDenom;
74 		int iqCorrNeg;
75 
76 		HALDEBUG(ah, HAL_DEBUG_PERCAL,
77 		    "Start IQ Cal and Correction for Chain %d\n", i);
78 		HALDEBUG(ah, HAL_DEBUG_PERCAL,
79 		    "Orignal: iq_corr_meas = 0x%08x\n", iqCorrMeas);
80 
81 		iqCorrNeg = 0;
82 		/* iqCorrMeas is always negative. */
83 		if (iqCorrMeas > 0x80000000)  {
84 			iqCorrMeas = (0xffffffff - iqCorrMeas) + 1;
85 			iqCorrNeg = 1;
86 		}
87 
88 		HALDEBUG(ah, HAL_DEBUG_PERCAL, " pwr_meas_i = 0x%08x\n",
89 		    powerMeasI);
90 		HALDEBUG(ah, HAL_DEBUG_PERCAL, " pwr_meas_q = 0x%08x\n",
91 		    powerMeasQ);
92 		HALDEBUG(ah, HAL_DEBUG_PERCAL, " iqCorrNeg is 0x%08x\n",
93 		    iqCorrNeg);
94 
95 		iCoffDenom = (powerMeasI/2 + powerMeasQ/2)/ 128;
96 		qCoffDenom = powerMeasQ / 64;
97 		/* Protect against divide-by-0 */
98 		if (powerMeasQ != 0) {
99 			/* IQ corr_meas is already negated if iqcorr_neg == 1 */
100 			int32_t iCoff = iqCorrMeas/iCoffDenom;
101 			int32_t qCoff = powerMeasI/qCoffDenom - 64;
102 
103 			HALDEBUG(ah, HAL_DEBUG_PERCAL, " iCoff = 0x%08x\n",
104 			    iCoff);
105 			HALDEBUG(ah, HAL_DEBUG_PERCAL, " qCoff = 0x%08x\n",
106 			    qCoff);
107 
108 			/* Negate iCoff if iqCorrNeg == 0 */
109 			iCoff = iCoff & 0x3f;
110 			HALDEBUG(ah, HAL_DEBUG_PERCAL,
111 			    "New:  iCoff = 0x%08x\n", iCoff);
112 
113 			if (iqCorrNeg == 0x0)
114 				iCoff = 0x40 - iCoff;
115 			if (qCoff > 15)
116 				qCoff = 15;
117 			else if (qCoff <= -16)
118 				qCoff = -16;
119 			HALDEBUG(ah, HAL_DEBUG_PERCAL,
120 			    " : iCoff = 0x%x  qCoff = 0x%x\n", iCoff, qCoff);
121 
122 			OS_REG_RMW_FIELD(ah, AR_PHY_TIMING_CTRL4_CHAIN(i),
123 			    AR_PHY_TIMING_CTRL4_IQCORR_Q_I_COFF, iCoff);
124 			OS_REG_RMW_FIELD(ah, AR_PHY_TIMING_CTRL4_CHAIN(i),
125 			    AR_PHY_TIMING_CTRL4_IQCORR_Q_Q_COFF, qCoff);
126 			HALDEBUG(ah, HAL_DEBUG_PERCAL,
127 			    "IQ Cal and Correction done for Chain %d\n", i);
128 		}
129 	}
130 	OS_REG_SET_BIT(ah, AR_PHY_TIMING_CTRL4,
131 	    AR_PHY_TIMING_CTRL4_IQCORR_ENABLE);
132 }
133