2 * SPDX-License-Identifier: ISC
4 * Copyright (c) 2008-2009 Sam Leffler, Errno Consulting
5 * Copyright (c) 2008 Atheros Communications, Inc.
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.
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.
24 * NB: Merlin and later have a simpler RF backend.
27 #include "ah_internal.h"
29 #include "ah_eeprom_v14.h"
31 #include "ar9002/ar9280.h"
32 #include "ar5416/ar5416reg.h"
33 #include "ar5416/ar5416phy.h"
35 #define N(a) (sizeof(a)/sizeof(a[0]))
38 RF_HAL_FUNCS base; /* public state, must be first */
39 uint16_t pcdacTable[1]; /* XXX */
41 #define AR9280(ah) ((struct ar9280State *) AH5212(ah)->ah_rfHal)
43 static HAL_BOOL ar9280GetChannelMaxMinPower(struct ath_hal *,
44 const struct ieee80211_channel *, int16_t *maxPow,int16_t *minPow);
45 int16_t ar9280GetNfAdjust(struct ath_hal *ah, const HAL_CHANNEL_INTERNAL *c);
48 ar9280WriteRegs(struct ath_hal *ah, u_int modesIndex, u_int freqIndex,
51 (void) ath_hal_ini_write(ah, &AH5416(ah)->ah_ini_bb_rfgain,
56 * Take the MHz channel value and set the Channel value
58 * ASSUMES: Writes enabled to analog bus
63 * Channel Frequency = (3/4) * freq_ref * (chansel[8:0] + chanfrac[16:0]/2^17)
67 * Channel Frequency = (3/2) * freq_ref * (chansel[8:0] + chanfrac[16:0]/2^10)
68 * (freq_ref = 40MHz/(24>>amodeRefSel))
70 * For 5GHz channels which are 5MHz spaced,
71 * Channel Frequency = (3/2) * freq_ref * (chansel[8:0] + chanfrac[16:0]/2^17)
75 ar9280SetChannel(struct ath_hal *ah, const struct ieee80211_channel *chan)
77 uint16_t bMode, fracMode, aModeRefSel = 0;
78 uint32_t freq, ndiv, channelSel = 0, channelFrac = 0, reg32 = 0;
80 uint32_t refDivA = 24;
83 OS_MARK(ah, AH_MARK_SETCHANNEL, chan->ic_freq);
85 ar5416GetChannelCenters(ah, chan, ¢ers);
86 freq = centers.synth_center;
88 reg32 = OS_REG_READ(ah, AR_PHY_SYNTH_CONTROL);
91 if (ath_hal_eepromGet(ah, AR_EEP_FRAC_N_5G, &frac_n_5g) != HAL_OK)
94 if (freq < 4800) { /* 2 GHz, fractional mode */
100 channelSel = (freq * 0x10000)/15;
102 txctl = OS_REG_READ(ah, AR_PHY_CCK_TX_CTRL);
104 /* Enable channel spreading for channel 14 */
105 OS_REG_WRITE(ah, AR_PHY_CCK_TX_CTRL,
106 txctl | AR_PHY_CCK_TX_CTRL_JAPAN);
108 OS_REG_WRITE(ah, AR_PHY_CCK_TX_CTRL,
109 txctl &~ AR_PHY_CCK_TX_CTRL_JAPAN);
118 * Enable fractional mode for half/quarter rate
121 * This is from the Linux ath9k code, rather than
122 * the Atheros HAL code.
124 if (IEEE80211_IS_CHAN_QUARTER(chan) ||
125 IEEE80211_IS_CHAN_HALF(chan))
127 else if ((freq % 20) == 0) {
129 } else if ((freq % 10) == 0) {
132 if (aModeRefSel) break;
136 /* Enable 2G (fractional) mode for channels which are 5MHz spaced */
139 * Workaround for talking on PSB non-5MHz channels;
140 * the pre-Merlin chips only had a 2.5MHz channel
141 * spacing so some channels aren't reachable.
144 * This interoperates on the quarter rate channels
145 * with the AR5112 and later RF synths. Please note
146 * that the synthesiser isn't able to completely
147 * accurately represent these frequencies (as the
148 * resolution in this reference is 2.5MHz) and thus
149 * it will be slightly "off centre." This matches
150 * the same slightly incorrect centre frequency
151 * behaviour that the AR5112 and later channel
152 * selection code has.
154 * This also interoperates with the AR5416
155 * synthesiser modification for programming
156 * fractional frequencies in 5GHz mode. However
157 * that modification is also disabled by default.
159 * This is disabled because it hasn't been tested for
160 * regulatory compliance and neither have the NICs
161 * which would use it. So if you enable this code,
162 * you must first ensure that you've re-certified the
163 * NICs in question beforehand or you will be
164 * violating your local regulatory rules and breaking
173 channelSel = (freq * 0x8000)/15;
176 /* Offset by 500KHz */
182 /* Calculate the "adjusted" frequency */
184 ch = (((f - 4800) * 10) / 25) + 1;
186 ch2 = ((ch * 25) / 5) + 9600;
187 channelSel = (ch2 * 0x4000) / 15;
189 // "%s: freq=%d, ch=%d, ch2=%d, "
190 // "channelSel=%d\n",
191 // __func__, freq, ch, ch2, channelSel);
195 /* RefDivA setting */
196 OS_A_REG_RMW_FIELD(ah, AR_AN_SYNTH9,
197 AR_AN_SYNTH9_REFDIVA, refDivA);
201 ndiv = (freq * (refDivA >> aModeRefSel))/60;
202 channelSel = ndiv & 0x1ff;
203 channelFrac = (ndiv & 0xfffffe00) * 2;
204 channelSel = (channelSel << 17) | channelFrac;
208 reg32 = reg32 | (bMode << 29) | (fracMode << 28) |
209 (aModeRefSel << 26) | (channelSel);
211 OS_REG_WRITE(ah, AR_PHY_SYNTH_CONTROL, reg32);
213 AH_PRIVATE(ah)->ah_curchan = chan;
219 * Return a reference to the requested RF Bank.
222 ar9280GetRfBank(struct ath_hal *ah, int bank)
224 HALDEBUG(ah, HAL_DEBUG_ANY, "%s: unknown RF Bank %d requested\n",
230 * Reads EEPROM header info from device structure and programs
234 ar9280SetRfRegs(struct ath_hal *ah, const struct ieee80211_channel *chan,
235 uint16_t modesIndex, uint16_t *rfXpdGain)
237 return AH_TRUE; /* nothing to do */
241 * Read the transmit power levels from the structures taken from EEPROM
242 * Interpolate read transmit power values for this channel
243 * Organize the transmit power values into a table for writing into the hardware
247 ar9280SetPowerTable(struct ath_hal *ah, int16_t *pPowerMin, int16_t *pPowerMax,
248 const struct ieee80211_channel *chan, uint16_t *rfXpdGain)
255 ar9280GetMinPower(struct ath_hal *ah, EXPN_DATA_PER_CHANNEL_5112 *data)
258 int16_t minGain,minPwr,minPcdac,retVal;
260 /* Assume NUM_POINTS_XPD0 > 0 */
261 minGain = data->pDataPerXPD[0].xpd_gain;
262 for (minIndex=0,i=1; i<NUM_XPD_PER_CHANNEL; i++) {
263 if (data->pDataPerXPD[i].xpd_gain < minGain) {
265 minGain = data->pDataPerXPD[i].xpd_gain;
268 minPwr = data->pDataPerXPD[minIndex].pwr_t4[0];
269 minPcdac = data->pDataPerXPD[minIndex].pcdac[0];
270 for (i=1; i<NUM_POINTS_XPD0; i++) {
271 if (data->pDataPerXPD[minIndex].pwr_t4[i] < minPwr) {
272 minPwr = data->pDataPerXPD[minIndex].pwr_t4[i];
273 minPcdac = data->pDataPerXPD[minIndex].pcdac[i];
276 retVal = minPwr - (minPcdac*2);
282 ar9280GetChannelMaxMinPower(struct ath_hal *ah,
283 const struct ieee80211_channel *chan,
284 int16_t *maxPow, int16_t *minPow)
287 struct ath_hal_5212 *ahp = AH5212(ah);
288 int numChannels=0,i,last;
289 int totalD, totalF,totalMin;
290 EXPN_DATA_PER_CHANNEL_5112 *data=AH_NULL;
291 EEPROM_POWER_EXPN_5112 *powerArray=AH_NULL;
294 if (IS_CHAN_A(chan)) {
295 powerArray = ahp->ah_modePowerArray5112;
296 data = powerArray[headerInfo11A].pDataPerChannel;
297 numChannels = powerArray[headerInfo11A].numChannels;
298 } else if (IS_CHAN_G(chan) || IS_CHAN_108G(chan)) {
299 /* XXX - is this correct? Should we also use the same power for turbo G? */
300 powerArray = ahp->ah_modePowerArray5112;
301 data = powerArray[headerInfo11G].pDataPerChannel;
302 numChannels = powerArray[headerInfo11G].numChannels;
303 } else if (IS_CHAN_B(chan)) {
304 powerArray = ahp->ah_modePowerArray5112;
305 data = powerArray[headerInfo11B].pDataPerChannel;
306 numChannels = powerArray[headerInfo11B].numChannels;
310 /* Make sure the channel is in the range of the TP values
313 if ((numChannels < 1) ||
314 (chan->channel < data[0].channelValue) ||
315 (chan->channel > data[numChannels-1].channelValue))
318 /* Linearly interpolate the power value now */
320 (i<numChannels) && (chan->channel > data[i].channelValue);
322 totalD = data[i].channelValue - data[last].channelValue;
324 totalF = data[i].maxPower_t4 - data[last].maxPower_t4;
325 *maxPow = (int8_t) ((totalF*(chan->channel-data[last].channelValue) + data[last].maxPower_t4*totalD)/totalD);
327 totalMin = ar9280GetMinPower(ah,&data[i]) - ar9280GetMinPower(ah, &data[last]);
328 *minPow = (int8_t) ((totalMin*(chan->channel-data[last].channelValue) + ar9280GetMinPower(ah, &data[last])*totalD)/totalD);
331 if (chan->channel == data[i].channelValue) {
332 *maxPow = data[i].maxPower_t4;
333 *minPow = ar9280GetMinPower(ah, &data[i]);
339 *maxPow = *minPow = 0;
345 * The ordering of nfarray is thus:
347 * nfarray[0]: Chain 0 ctl
348 * nfarray[1]: Chain 1 ctl
349 * nfarray[2]: Chain 2 ctl
350 * nfarray[3]: Chain 0 ext
351 * nfarray[4]: Chain 1 ext
352 * nfarray[5]: Chain 2 ext
355 ar9280GetNoiseFloor(struct ath_hal *ah, int16_t nfarray[])
359 nf = MS(OS_REG_READ(ah, AR_PHY_CCA), AR9280_PHY_MINCCA_PWR);
361 nf = 0 - ((nf ^ 0x1ff) + 1);
362 HALDEBUG(ah, HAL_DEBUG_NFCAL,
363 "NF calibrated [ctl] [chain 0] is %d\n", nf);
366 nf = MS(OS_REG_READ(ah, AR_PHY_CH1_CCA), AR9280_PHY_CH1_MINCCA_PWR);
368 nf = 0 - ((nf ^ 0x1ff) + 1);
369 HALDEBUG(ah, HAL_DEBUG_NFCAL,
370 "NF calibrated [ctl] [chain 1] is %d\n", nf);
373 nf = MS(OS_REG_READ(ah, AR_PHY_EXT_CCA), AR9280_PHY_EXT_MINCCA_PWR);
375 nf = 0 - ((nf ^ 0x1ff) + 1);
376 HALDEBUG(ah, HAL_DEBUG_NFCAL,
377 "NF calibrated [ext] [chain 0] is %d\n", nf);
380 nf = MS(OS_REG_READ(ah, AR_PHY_CH1_EXT_CCA), AR9280_PHY_CH1_EXT_MINCCA_PWR);
382 nf = 0 - ((nf ^ 0x1ff) + 1);
383 HALDEBUG(ah, HAL_DEBUG_NFCAL,
384 "NF calibrated [ext] [chain 1] is %d\n", nf);
387 /* Chain 2 - invalid */
394 * Adjust NF based on statistical values for 5GHz frequencies.
395 * Stubbed:Not used by Fowl
398 ar9280GetNfAdjust(struct ath_hal *ah, const HAL_CHANNEL_INTERNAL *c)
404 * Free memory for analog bank scratch buffers
407 ar9280RfDetach(struct ath_hal *ah)
409 struct ath_hal_5212 *ahp = AH5212(ah);
411 HALASSERT(ahp->ah_rfHal != AH_NULL);
412 ath_hal_free(ahp->ah_rfHal);
413 ahp->ah_rfHal = AH_NULL;
417 ar9280RfAttach(struct ath_hal *ah, HAL_STATUS *status)
419 struct ath_hal_5212 *ahp = AH5212(ah);
420 struct ar9280State *priv;
422 HALDEBUG(ah, HAL_DEBUG_ATTACH, "%s: attach AR9280 radio\n", __func__);
424 HALASSERT(ahp->ah_rfHal == AH_NULL);
425 priv = ath_hal_malloc(sizeof(struct ar9280State));
426 if (priv == AH_NULL) {
427 HALDEBUG(ah, HAL_DEBUG_ANY,
428 "%s: cannot allocate private state\n", __func__);
429 *status = HAL_ENOMEM; /* XXX */
432 priv->base.rfDetach = ar9280RfDetach;
433 priv->base.writeRegs = ar9280WriteRegs;
434 priv->base.getRfBank = ar9280GetRfBank;
435 priv->base.setChannel = ar9280SetChannel;
436 priv->base.setRfRegs = ar9280SetRfRegs;
437 priv->base.setPowerTable = ar9280SetPowerTable;
438 priv->base.getChannelMaxMinPower = ar9280GetChannelMaxMinPower;
439 priv->base.getNfAdjust = ar9280GetNfAdjust;
441 ahp->ah_pcdacTable = priv->pcdacTable;
442 ahp->ah_pcdacTableSize = sizeof(priv->pcdacTable);
443 ahp->ah_rfHal = &priv->base;
445 * Set noise floor adjust method; we arrange a
446 * direct call instead of thunking.
448 AH_PRIVATE(ah)->ah_getNfAdjust = priv->base.getNfAdjust;
449 AH_PRIVATE(ah)->ah_getNoiseFloor = ar9280GetNoiseFloor;
455 ar9280RfProbe(struct ath_hal *ah)
457 return (AR_SREV_MERLIN(ah));
460 AH_RF(RF9280, ar9280RfProbe, ar9280RfAttach);