ar5212.h revision 238607
1185377Ssam/*
2187831Ssam * Copyright (c) 2002-2009 Sam Leffler, Errno Consulting
3185377Ssam * Copyright (c) 2002-2008 Atheros Communications, Inc.
4185377Ssam *
5185377Ssam * Permission to use, copy, modify, and/or distribute this software for any
6185377Ssam * purpose with or without fee is hereby granted, provided that the above
7185377Ssam * copyright notice and this permission notice appear in all copies.
8185377Ssam *
9185377Ssam * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
10185377Ssam * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
11185377Ssam * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
12185377Ssam * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
13185377Ssam * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
14185377Ssam * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
15185377Ssam * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
16185377Ssam *
17187831Ssam * $FreeBSD: head/sys/dev/ath/ath_hal/ar5212/ar5212.h 238607 2012-07-19 02:25:14Z adrian $
18185377Ssam */
19185377Ssam#ifndef _ATH_AR5212_H_
20185377Ssam#define _ATH_AR5212_H_
21185377Ssam
22185377Ssam#include "ah_eeprom.h"
23185377Ssam
24185377Ssam#define	AR5212_MAGIC	0x19541014
25185377Ssam
26185377Ssam/* DCU Transmit Filter macros */
27185377Ssam#define CALC_MMR(dcu, idx) \
28185377Ssam	( (4 * dcu) + (idx < 32 ? 0 : (idx < 64 ? 1 : (idx < 96 ? 2 : 3))) )
29185377Ssam#define TXBLK_FROM_MMR(mmr) \
30185377Ssam	(AR_D_TXBLK_BASE + ((mmr & 0x1f) << 6) + ((mmr & 0x20) >> 3))
31185377Ssam#define CALC_TXBLK_ADDR(dcu, idx)	(TXBLK_FROM_MMR(CALC_MMR(dcu, idx)))
32185377Ssam#define CALC_TXBLK_VALUE(idx)		(1 << (idx & 0x1f))
33185377Ssam
34185377Ssam/* MAC register values */
35185377Ssam
36185377Ssam#define INIT_INTERRUPT_MASK \
37185377Ssam	( AR_IMR_TXERR  | AR_IMR_TXOK | AR_IMR_RXORN | \
38185377Ssam	  AR_IMR_RXERR  | AR_IMR_RXOK | AR_IMR_TXURN | \
39185377Ssam	  AR_IMR_HIUERR )
40185377Ssam#define INIT_BEACON_CONTROL \
41185377Ssam	((INIT_RESET_TSF << 24)  | (INIT_BEACON_EN << 23) | \
42185377Ssam	  (INIT_TIM_OFFSET << 16) | INIT_BEACON_PERIOD)
43185377Ssam
44185377Ssam#define INIT_CONFIG_STATUS	0x00000000
45185377Ssam#define INIT_RSSI_THR		0x00000781	/* Missed beacon counter initialized to 0x7 (max is 0xff) */
46185377Ssam#define INIT_IQCAL_LOG_COUNT_MAX	0xF
47185377Ssam#define INIT_BCON_CNTRL_REG	0x00000000
48185377Ssam
49185377Ssam#define INIT_USEC		40
50185377Ssam#define HALF_RATE_USEC		19 /* ((40 / 2) - 1 ) */
51185377Ssam#define QUARTER_RATE_USEC	9  /* ((40 / 4) - 1 ) */
52185377Ssam
53185377Ssam#define RX_NON_FULL_RATE_LATENCY	63
54185377Ssam#define TX_HALF_RATE_LATENCY		108
55185377Ssam#define TX_QUARTER_RATE_LATENCY		216
56185377Ssam
57185377Ssam#define IFS_SLOT_FULL_RATE	0x168 /* 9 us half, 40 MHz core clock (9*40) */
58185377Ssam#define IFS_SLOT_HALF_RATE	0x104 /* 13 us half, 20 MHz core clock (13*20) */
59185377Ssam#define IFS_SLOT_QUARTER_RATE	0xD2 /* 21 us quarter, 10 MHz core clock (21*10) */
60185377Ssam#define IFS_EIFS_FULL_RATE	0xE60 /* (74 + (2 * 9)) * 40MHz core clock */
61185377Ssam#define IFS_EIFS_HALF_RATE	0xDAC /* (149 + (2 * 13)) * 20MHz core clock */
62185377Ssam#define IFS_EIFS_QUARTER_RATE	0xD48 /* (298 + (2 * 21)) * 10MHz core clock */
63185377Ssam
64185377Ssam#define ACK_CTS_TIMEOUT_11A	0x3E8 /* ACK timeout in 11a core clocks */
65185377Ssam
66185377Ssam/* Tx frame start to tx data start delay */
67185377Ssam#define TX_FRAME_D_START_HALF_RATE 	0xc
68185377Ssam#define TX_FRAME_D_START_QUARTER_RATE 	0xd
69185377Ssam
70185377Ssam/*
71185377Ssam * Various fifo fill before Tx start, in 64-byte units
72185377Ssam * i.e. put the frame in the air while still DMAing
73185377Ssam */
74185377Ssam#define MIN_TX_FIFO_THRESHOLD	0x1
75185377Ssam#define MAX_TX_FIFO_THRESHOLD	((IEEE80211_MAX_LEN / 64) + 1)
76185377Ssam#define INIT_TX_FIFO_THRESHOLD	MIN_TX_FIFO_THRESHOLD
77185377Ssam
78185377Ssam#define	HAL_DECOMP_MASK_SIZE	128	/* 1 byte per key */
79185377Ssam
80185377Ssam/*
81185377Ssam * Gain support.
82185377Ssam */
83185377Ssam#define	NUM_CORNER_FIX_BITS		4
84185377Ssam#define	NUM_CORNER_FIX_BITS_5112	7
85185377Ssam#define	DYN_ADJ_UP_MARGIN		15
86185377Ssam#define	DYN_ADJ_LO_MARGIN		20
87185377Ssam#define	PHY_PROBE_CCK_CORRECTION	5
88185377Ssam#define	CCK_OFDM_GAIN_DELTA		15
89185377Ssam
90185377Ssamenum GAIN_PARAMS {
91185377Ssam	GP_TXCLIP,
92185377Ssam	GP_PD90,
93185377Ssam	GP_PD84,
94185377Ssam	GP_GSEL,
95185377Ssam};
96185377Ssam
97185377Ssamenum GAIN_PARAMS_5112 {
98185377Ssam	GP_MIXGAIN_OVR,
99185377Ssam	GP_PWD_138,
100185377Ssam	GP_PWD_137,
101185377Ssam	GP_PWD_136,
102185377Ssam	GP_PWD_132,
103185377Ssam	GP_PWD_131,
104185377Ssam	GP_PWD_130,
105185377Ssam};
106185377Ssam
107185377Ssamtypedef struct _gainOptStep {
108185377Ssam	int16_t	paramVal[NUM_CORNER_FIX_BITS_5112];
109185377Ssam	int32_t	stepGain;
110185377Ssam	int8_t	stepName[16];
111185377Ssam} GAIN_OPTIMIZATION_STEP;
112185377Ssam
113185377Ssamtypedef struct {
114185377Ssam	uint32_t	numStepsInLadder;
115185377Ssam	uint32_t	defaultStepNum;
116185377Ssam	GAIN_OPTIMIZATION_STEP optStep[10];
117185377Ssam} GAIN_OPTIMIZATION_LADDER;
118185377Ssam
119185377Ssamtypedef struct {
120185377Ssam	uint32_t	currStepNum;
121185377Ssam	uint32_t	currGain;
122185377Ssam	uint32_t	targetGain;
123185377Ssam	uint32_t	loTrig;
124185377Ssam	uint32_t	hiTrig;
125185377Ssam	uint32_t	active;
126185377Ssam	const GAIN_OPTIMIZATION_STEP *currStep;
127185377Ssam} GAIN_VALUES;
128185377Ssam
129185377Ssam/* RF HAL structures */
130185377Ssamtypedef struct RfHalFuncs {
131185377Ssam	void	  *priv;		/* private state */
132185377Ssam
133185377Ssam	void	  (*rfDetach)(struct ath_hal *ah);
134185377Ssam	void	  (*writeRegs)(struct ath_hal *,
135187831Ssam		      u_int modeIndex, u_int freqIndex, int regWrites);
136185377Ssam	uint32_t *(*getRfBank)(struct ath_hal *ah, int bank);
137187831Ssam	HAL_BOOL  (*setChannel)(struct ath_hal *,
138187831Ssam		      const struct ieee80211_channel *);
139185377Ssam	HAL_BOOL  (*setRfRegs)(struct ath_hal *,
140187831Ssam		      const struct ieee80211_channel *, uint16_t modesIndex,
141185377Ssam		      uint16_t *rfXpdGain);
142185377Ssam	HAL_BOOL  (*setPowerTable)(struct ath_hal *ah,
143185377Ssam		      int16_t *minPower, int16_t *maxPower,
144187831Ssam		      const struct ieee80211_channel *, uint16_t *rfXpdGain);
145187831Ssam	HAL_BOOL  (*getChannelMaxMinPower)(struct ath_hal *ah,
146187831Ssam		      const const struct ieee80211_channel *,
147185377Ssam		      int16_t *maxPow, int16_t *minPow);
148185377Ssam	int16_t	  (*getNfAdjust)(struct ath_hal *, const HAL_CHANNEL_INTERNAL*);
149185377Ssam} RF_HAL_FUNCS;
150185377Ssam
151185377Ssamstruct ar5212AniParams {
152185377Ssam	int		maxNoiseImmunityLevel;	/* [0..4] */
153185377Ssam	int		totalSizeDesired[5];
154185377Ssam	int		coarseHigh[5];
155185377Ssam	int		coarseLow[5];
156185377Ssam	int		firpwr[5];
157185377Ssam
158185377Ssam	int		maxSpurImmunityLevel;	/* [0..7] */
159185377Ssam	int		cycPwrThr1[8];
160185377Ssam
161185377Ssam	int		maxFirstepLevel;	/* [0..2] */
162185377Ssam	int		firstep[3];
163185377Ssam
164185377Ssam	uint32_t	ofdmTrigHigh;
165185377Ssam	uint32_t	ofdmTrigLow;
166185377Ssam	uint32_t	cckTrigHigh;
167185377Ssam	uint32_t	cckTrigLow;
168185377Ssam	int32_t		rssiThrLow;
169185377Ssam	uint32_t	rssiThrHigh;
170185377Ssam
171185377Ssam	int		period;			/* update listen period */
172185377Ssam
173185377Ssam	/* NB: intentionally ordered so data exported to user space is first */
174185377Ssam	uint32_t	ofdmPhyErrBase;	/* Base value for ofdm err counter */
175185377Ssam	uint32_t	cckPhyErrBase;	/* Base value for cck err counters */
176185377Ssam};
177185377Ssam
178185377Ssam/*
179185377Ssam * Per-channel ANI state private to the driver.
180185377Ssam */
181185377Ssamstruct ar5212AniState {
182185377Ssam	uint8_t		noiseImmunityLevel;
183185377Ssam	uint8_t		spurImmunityLevel;
184185377Ssam	uint8_t		firstepLevel;
185185377Ssam	uint8_t		ofdmWeakSigDetectOff;
186185377Ssam	uint8_t		cckWeakSigThreshold;
187185377Ssam	uint32_t	listenTime;
188185377Ssam
189185377Ssam	/* NB: intentionally ordered so data exported to user space is first */
190185377Ssam	uint32_t	txFrameCount;	/* Last txFrameCount */
191185377Ssam	uint32_t	rxFrameCount;	/* Last rx Frame count */
192185377Ssam	uint32_t	cycleCount;	/* Last cycleCount
193185377Ssam					   (to detect wrap-around) */
194185377Ssam	uint32_t	ofdmPhyErrCount;/* OFDM err count since last reset */
195185377Ssam	uint32_t	cckPhyErrCount;	/* CCK err count since last reset */
196185377Ssam
197185377Ssam	const struct ar5212AniParams *params;
198185377Ssam};
199185377Ssam
200185377Ssam#define	HAL_ANI_ENA		0x00000001	/* ANI operation enabled */
201185377Ssam#define	HAL_RSSI_ANI_ENA	0x00000002	/* rssi-based processing ena'd*/
202185377Ssam
203185377Ssamstruct ar5212Stats {
204185377Ssam	uint32_t	ast_ani_niup;	/* ANI increased noise immunity */
205185377Ssam	uint32_t	ast_ani_nidown;	/* ANI decreased noise immunity */
206185377Ssam	uint32_t	ast_ani_spurup;	/* ANI increased spur immunity */
207185377Ssam	uint32_t	ast_ani_spurdown;/* ANI descreased spur immunity */
208185377Ssam	uint32_t	ast_ani_ofdmon;	/* ANI OFDM weak signal detect on */
209185377Ssam	uint32_t	ast_ani_ofdmoff;/* ANI OFDM weak signal detect off */
210185377Ssam	uint32_t	ast_ani_cckhigh;/* ANI CCK weak signal threshold high */
211185377Ssam	uint32_t	ast_ani_ccklow;	/* ANI CCK weak signal threshold low */
212185377Ssam	uint32_t	ast_ani_stepup;	/* ANI increased first step level */
213185377Ssam	uint32_t	ast_ani_stepdown;/* ANI decreased first step level */
214185377Ssam	uint32_t	ast_ani_ofdmerrs;/* ANI cumulative ofdm phy err count */
215185377Ssam	uint32_t	ast_ani_cckerrs;/* ANI cumulative cck phy err count */
216185377Ssam	uint32_t	ast_ani_reset;	/* ANI parameters zero'd for non-STA */
217185377Ssam	uint32_t	ast_ani_lzero;	/* ANI listen time forced to zero */
218185377Ssam	uint32_t	ast_ani_lneg;	/* ANI listen time calculated < 0 */
219185377Ssam	HAL_MIB_STATS	ast_mibstats;	/* MIB counter stats */
220185377Ssam	HAL_NODE_STATS	ast_nodestats;	/* Latest rssi stats from driver */
221185377Ssam};
222185377Ssam
223185377Ssam/*
224185377Ssam * NF Cal history buffer
225185377Ssam */
226185377Ssam#define	AR5212_CCA_MAX_GOOD_VALUE	-95
227185377Ssam#define	AR5212_CCA_MAX_HIGH_VALUE	-62
228185377Ssam#define	AR5212_CCA_MIN_BAD_VALUE	-125
229185377Ssam
230185377Ssam#define	AR512_NF_CAL_HIST_MAX		5
231185377Ssam
232185377Ssamstruct ar5212NfCalHist {
233185377Ssam	int16_t		nfCalBuffer[AR512_NF_CAL_HIST_MAX];
234185377Ssam	int16_t		privNF;
235185377Ssam	uint8_t		currIndex;
236185377Ssam	uint8_t		first_run;
237185377Ssam	uint8_t		invalidNFcount;
238185377Ssam};
239185377Ssam
240185377Ssamstruct ath_hal_5212 {
241185377Ssam	struct ath_hal_private	ah_priv;	/* base class */
242185377Ssam
243185377Ssam	/*
244185377Ssam	 * Per-chip common Initialization data.
245185377Ssam	 * NB: RF backends have their own ini data.
246185377Ssam	 */
247185377Ssam	HAL_INI_ARRAY	ah_ini_modes;
248185377Ssam	HAL_INI_ARRAY	ah_ini_common;
249185377Ssam
250185377Ssam	GAIN_VALUES	ah_gainValues;
251185377Ssam
252185377Ssam	uint8_t		ah_macaddr[IEEE80211_ADDR_LEN];
253185377Ssam	uint8_t		ah_bssid[IEEE80211_ADDR_LEN];
254185377Ssam	uint8_t		ah_bssidmask[IEEE80211_ADDR_LEN];
255226760Sadrian	uint16_t	ah_assocId;
256185377Ssam
257185377Ssam	/*
258185377Ssam	 * Runtime state.
259185377Ssam	 */
260185377Ssam	uint32_t	ah_maskReg;		/* copy of AR_IMR */
261185377Ssam	struct ar5212Stats ah_stats;		/* various statistics */
262185377Ssam	RF_HAL_FUNCS	*ah_rfHal;
263185377Ssam	uint32_t	ah_txDescMask;		/* mask for TXDESC */
264185377Ssam	uint32_t	ah_txOkInterruptMask;
265185377Ssam	uint32_t	ah_txErrInterruptMask;
266185377Ssam	uint32_t	ah_txDescInterruptMask;
267185377Ssam	uint32_t	ah_txEolInterruptMask;
268185377Ssam	uint32_t	ah_txUrnInterruptMask;
269185377Ssam	HAL_TX_QUEUE_INFO ah_txq[HAL_NUM_TX_QUEUES];
270185380Ssam	uint32_t	ah_intrTxqs;		/* tx q interrupt state */
271185377Ssam						/* decomp mask array */
272185380Ssam	uint8_t		ah_decompMask[HAL_DECOMP_MASK_SIZE];
273185377Ssam	HAL_POWER_MODE	ah_powerMode;
274185380Ssam	HAL_ANT_SETTING ah_antControl;		/* antenna setting */
275185380Ssam	HAL_BOOL	ah_diversity;		/* fast diversity setting */
276185377Ssam	enum {
277185377Ssam		IQ_CAL_INACTIVE,
278185377Ssam		IQ_CAL_RUNNING,
279185377Ssam		IQ_CAL_DONE
280185377Ssam	} ah_bIQCalibration;			/* IQ calibrate state */
281185377Ssam	HAL_RFGAIN	ah_rfgainState;		/* RF gain calibrartion state */
282185377Ssam	uint32_t	ah_tx6PowerInHalfDbm;	/* power output for 6Mb tx */
283185377Ssam	uint32_t	ah_staId1Defaults;	/* STA_ID1 default settings */
284185377Ssam	uint32_t	ah_miscMode;		/* MISC_MODE settings */
285185377Ssam	uint32_t	ah_rssiThr;		/* RSSI_THR settings */
286185377Ssam	HAL_BOOL	ah_cwCalRequire;	/* for ap51 */
287185377Ssam	HAL_BOOL	ah_tpcEnabled;		/* per-packet tpc enabled */
288185380Ssam	HAL_BOOL	ah_phyPowerOn;		/* PHY power state */
289185380Ssam	HAL_BOOL	ah_isHb63;		/* cached HB63 check */
290185377Ssam	uint32_t	ah_macTPC;		/* tpc register */
291185377Ssam	uint32_t	ah_beaconInterval;	/* XXX */
292185377Ssam	enum {
293185377Ssam		AUTO_32KHZ,		/* use it if 32kHz crystal present */
294185377Ssam		USE_32KHZ,		/* do it regardless */
295185377Ssam		DONT_USE_32KHZ,		/* don't use it regardless */
296185377Ssam	} ah_enable32kHzClock;			/* whether to sleep at 32kHz */
297185377Ssam	uint32_t	ah_ofdmTxPower;
298185377Ssam	int16_t		ah_txPowerIndexOffset;
299185377Ssam	/*
300185377Ssam	 * Noise floor cal histogram support.
301185377Ssam	 */
302185377Ssam	struct ar5212NfCalHist ah_nfCalHist;
303185377Ssam
304185377Ssam	u_int		ah_slottime;		/* user-specified slot time */
305185377Ssam	u_int		ah_acktimeout;		/* user-specified ack timeout */
306185377Ssam	u_int		ah_ctstimeout;		/* user-specified cts timeout */
307185377Ssam	u_int		ah_sifstime;		/* user-specified sifs time */
308185377Ssam	/*
309185377Ssam	 * RF Silent handling; setup according to the EEPROM.
310185377Ssam	 */
311185377Ssam	uint32_t	ah_gpioSelect;		/* GPIO pin to use */
312185377Ssam	uint32_t	ah_polarity;		/* polarity to disable RF */
313185377Ssam	uint32_t	ah_gpioBit;		/* after init, prev value */
314185377Ssam	/*
315185377Ssam	 * ANI support.
316185377Ssam	 */
317185377Ssam	uint32_t	ah_procPhyErr;		/* Process Phy errs */
318185377Ssam	HAL_BOOL	ah_hasHwPhyCounters;	/* Hardware has phy counters */
319185377Ssam	struct ar5212AniParams ah_aniParams24;	/* 2.4GHz parameters */
320185377Ssam	struct ar5212AniParams ah_aniParams5;	/* 5GHz parameters */
321185377Ssam	struct ar5212AniState	*ah_curani;	/* cached last reference */
322187831Ssam	struct ar5212AniState	ah_ani[AH_MAXCHAN]; /* per-channel state */
323234774Sadrian	HAL_CHANNEL_SURVEY	ah_chansurvey; /* channel survey */
324185377Ssam
325222265Sadrian	/* AR5416 uses some of the AR5212 ANI code; these are the ANI methods */
326222265Sadrian	HAL_BOOL	(*ah_aniControl) (struct ath_hal *, HAL_ANI_CMD cmd, int param);
327222265Sadrian
328185377Ssam	/*
329185377Ssam	 * Transmit power state.  Note these are maintained
330185377Ssam	 * here so they can be retrieved by diagnostic tools.
331185377Ssam	 */
332185377Ssam	uint16_t	*ah_pcdacTable;
333185377Ssam	u_int		ah_pcdacTableSize;
334218012Sadrian	uint16_t	ah_ratesArray[37];
335204579Srpaulo
336204579Srpaulo	uint8_t		ah_txTrigLev;		/* current Tx trigger level */
337204579Srpaulo	uint8_t		ah_maxTxTrigLev;	/* max tx trigger level */
338185377Ssam};
339185377Ssam#define	AH5212(_ah)	((struct ath_hal_5212 *)(_ah))
340185377Ssam
341185380Ssam/*
342185380Ssam * IS_XXXX macros test the MAC version
343185380Ssam * IS_RADXXX macros test the radio/RF version (matching both 2G-only and 2/5G)
344185380Ssam *
345185380Ssam * Some single chip radios have equivalent radio/RF (e.g. 5112)
346185380Ssam * for those use IS_RADXXX_ANY macros.
347185380Ssam */
348185377Ssam#define IS_2317(ah) \
349185377Ssam	((AH_PRIVATE(ah)->ah_devid == AR5212_AR2317_REV1) || \
350185377Ssam	 (AH_PRIVATE(ah)->ah_devid == AR5212_AR2317_REV2))
351185377Ssam#define	IS_2316(ah) \
352185377Ssam	(AH_PRIVATE(ah)->ah_macVersion == AR_SREV_2415)
353185377Ssam#define	IS_2413(ah) \
354185377Ssam	(AH_PRIVATE(ah)->ah_macVersion == AR_SREV_2413 || IS_2316(ah))
355185377Ssam#define IS_5424(ah) \
356185377Ssam	(AH_PRIVATE(ah)->ah_macVersion == AR_SREV_5424 || \
357185377Ssam	(AH_PRIVATE(ah)->ah_macVersion == AR_SREV_5413 && \
358185377Ssam	  AH_PRIVATE(ah)->ah_macRev <= AR_SREV_D2PLUS_MS))
359185377Ssam#define IS_5413(ah) \
360185377Ssam	(AH_PRIVATE(ah)->ah_macVersion == AR_SREV_5413 || IS_5424(ah))
361185377Ssam#define IS_2425(ah) \
362185377Ssam	(AH_PRIVATE(ah)->ah_macVersion == AR_SREV_2425)
363185377Ssam#define IS_2417(ah) \
364185377Ssam	((AH_PRIVATE(ah)->ah_macVersion) == AR_SREV_2417)
365185377Ssam#define IS_HB63(ah)		(AH5212(ah)->ah_isHb63 == AH_TRUE)
366185377Ssam
367185380Ssam#define	AH_RADIO_MAJOR(ah) \
368185380Ssam	(AH_PRIVATE(ah)->ah_analog5GhzRev & AR_RADIO_SREV_MAJOR)
369185380Ssam#define	AH_RADIO_MINOR(ah) \
370185380Ssam	(AH_PRIVATE(ah)->ah_analog5GhzRev & AR_RADIO_SREV_MINOR)
371185380Ssam#define	IS_RAD5111(ah) \
372185380Ssam	(AH_RADIO_MAJOR(ah) == AR_RAD5111_SREV_MAJOR || \
373185380Ssam	 AH_RADIO_MAJOR(ah) == AR_RAD2111_SREV_MAJOR)
374185380Ssam#define	IS_RAD5112(ah) \
375185380Ssam	(AH_RADIO_MAJOR(ah) == AR_RAD5112_SREV_MAJOR || \
376185380Ssam	 AH_RADIO_MAJOR(ah) == AR_RAD2112_SREV_MAJOR)
377185380Ssam/* NB: does not include 5413 as Atheros' IS_5112 macro does */
378185380Ssam#define	IS_RAD5112_ANY(ah) \
379185380Ssam	(AR_RAD5112_SREV_MAJOR <= AH_RADIO_MAJOR(ah) && \
380185380Ssam	 AH_RADIO_MAJOR(ah) <= AR_RAD2413_SREV_MAJOR)
381185380Ssam#define	IS_RAD5112_REV1(ah) \
382185380Ssam	(IS_RAD5112(ah) && \
383185380Ssam	 AH_RADIO_MINOR(ah) < (AR_RAD5112_SREV_2_0 & AR_RADIO_SREV_MINOR))
384185380Ssam#define IS_RADX112_REV2(ah) \
385185380Ssam	(AH_PRIVATE(ah)->ah_analog5GhzRev == AR_RAD5112_SREV_2_0 || \
386185380Ssam	 AH_PRIVATE(ah)->ah_analog5GhzRev == AR_RAD2112_SREV_2_0 || \
387185380Ssam	 AH_PRIVATE(ah)->ah_analog5GhzRev == AR_RAD2112_SREV_2_1 || \
388185380Ssam	 AH_PRIVATE(ah)->ah_analog5GhzRev == AR_RAD5112_SREV_2_1)
389185380Ssam
390185377Ssam#define	ar5212RfDetach(ah) do {				\
391185377Ssam	if (AH5212(ah)->ah_rfHal != AH_NULL)		\
392185377Ssam		AH5212(ah)->ah_rfHal->rfDetach(ah);	\
393185377Ssam} while (0)
394185377Ssam#define	ar5212GetRfBank(ah, b) \
395185377Ssam	AH5212(ah)->ah_rfHal->getRfBank(ah, b)
396185377Ssam
397185377Ssam/*
398185377Ssam * Hack macros for Nala/San: 11b is handled
399185377Ssam * using 11g; flip the channel flags to accomplish this.
400185377Ssam */
401185377Ssam#define SAVE_CCK(_ah, _chan, _flag) do {			\
402185377Ssam	if ((IS_2425(_ah) || IS_2417(_ah)) &&			\
403187831Ssam	    (((_chan)->ic_flags) & IEEE80211_CHAN_CCK)) {	\
404187831Ssam		(_chan)->ic_flags &= ~IEEE80211_CHAN_CCK;	\
405187831Ssam		(_chan)->ic_flags |= IEEE80211_CHAN_DYN;	\
406185377Ssam		(_flag) = AH_TRUE;				\
407188012Ssam	} else							\
408188012Ssam		(_flag) = AH_FALSE;				\
409185377Ssam} while (0)
410185377Ssam#define RESTORE_CCK(_ah, _chan, _flag) do {                     \
411188012Ssam	if ((_flag) && (IS_2425(_ah) || IS_2417(_ah))) {	\
412187831Ssam		(_chan)->ic_flags &= ~IEEE80211_CHAN_DYN;	\
413187831Ssam		(_chan)->ic_flags |= IEEE80211_CHAN_CCK;	\
414185377Ssam	}							\
415185377Ssam} while (0)
416185377Ssam
417185377Ssamstruct ath_hal;
418185377Ssam
419185377Ssamextern	uint32_t ar5212GetRadioRev(struct ath_hal *ah);
420185377Ssamextern	void ar5212InitState(struct ath_hal_5212 *, uint16_t devid, HAL_SOFTC,
421185377Ssam		HAL_BUS_TAG st, HAL_BUS_HANDLE sh, HAL_STATUS *status);
422185377Ssamextern	void ar5212Detach(struct ath_hal *ah);
423185377Ssamextern  HAL_BOOL ar5212ChipTest(struct ath_hal *ah);
424185377Ssamextern  HAL_BOOL ar5212GetChannelEdges(struct ath_hal *ah,
425185377Ssam                uint16_t flags, uint16_t *low, uint16_t *high);
426185377Ssamextern	HAL_BOOL ar5212FillCapabilityInfo(struct ath_hal *ah);
427185377Ssam
428185377Ssamextern	void ar5212SetBeaconTimers(struct ath_hal *ah,
429185377Ssam		const HAL_BEACON_TIMERS *);
430185377Ssamextern	void ar5212BeaconInit(struct ath_hal *ah,
431185377Ssam		uint32_t next_beacon, uint32_t beacon_period);
432185377Ssamextern	void ar5212ResetStaBeaconTimers(struct ath_hal *ah);
433185377Ssamextern	void ar5212SetStaBeaconTimers(struct ath_hal *ah,
434185377Ssam		const HAL_BEACON_STATE *);
435225444Sadrianextern	uint64_t ar5212GetNextTBTT(struct ath_hal *);
436185377Ssam
437185377Ssamextern	HAL_BOOL ar5212IsInterruptPending(struct ath_hal *ah);
438185377Ssamextern	HAL_BOOL ar5212GetPendingInterrupts(struct ath_hal *ah, HAL_INT *);
439185377Ssamextern	HAL_INT ar5212GetInterrupts(struct ath_hal *ah);
440185377Ssamextern	HAL_INT ar5212SetInterrupts(struct ath_hal *ah, HAL_INT ints);
441185377Ssam
442185377Ssamextern	uint32_t ar5212GetKeyCacheSize(struct ath_hal *);
443185377Ssamextern	HAL_BOOL ar5212IsKeyCacheEntryValid(struct ath_hal *, uint16_t entry);
444185377Ssamextern	HAL_BOOL ar5212ResetKeyCacheEntry(struct ath_hal *ah, uint16_t entry);
445185377Ssamextern	HAL_BOOL ar5212SetKeyCacheEntryMac(struct ath_hal *,
446185377Ssam			uint16_t entry, const uint8_t *mac);
447185377Ssamextern	HAL_BOOL ar5212SetKeyCacheEntry(struct ath_hal *ah, uint16_t entry,
448185377Ssam                       const HAL_KEYVAL *k, const uint8_t *mac, int xorKey);
449185377Ssam
450185377Ssamextern	void ar5212GetMacAddress(struct ath_hal *ah, uint8_t *mac);
451185377Ssamextern	HAL_BOOL ar5212SetMacAddress(struct ath_hal *ah, const uint8_t *);
452185377Ssamextern	void ar5212GetBssIdMask(struct ath_hal *ah, uint8_t *mac);
453185377Ssamextern	HAL_BOOL ar5212SetBssIdMask(struct ath_hal *, const uint8_t *);
454185377Ssamextern	HAL_BOOL ar5212EepromRead(struct ath_hal *, u_int off, uint16_t *data);
455185377Ssamextern	HAL_BOOL ar5212EepromWrite(struct ath_hal *, u_int off, uint16_t data);
456185377Ssamextern	HAL_BOOL ar5212SetRegulatoryDomain(struct ath_hal *ah,
457185377Ssam		uint16_t regDomain, HAL_STATUS *stats);
458185377Ssamextern	u_int ar5212GetWirelessModes(struct ath_hal *ah);
459185377Ssamextern	void ar5212EnableRfKill(struct ath_hal *);
460188974Ssamextern	HAL_BOOL ar5212GpioCfgOutput(struct ath_hal *, uint32_t gpio,
461188974Ssam		HAL_GPIO_MUX_TYPE);
462185377Ssamextern	HAL_BOOL ar5212GpioCfgInput(struct ath_hal *, uint32_t gpio);
463185377Ssamextern	HAL_BOOL ar5212GpioSet(struct ath_hal *, uint32_t gpio, uint32_t val);
464185377Ssamextern	uint32_t ar5212GpioGet(struct ath_hal *ah, uint32_t gpio);
465185377Ssamextern	void ar5212GpioSetIntr(struct ath_hal *ah, u_int, uint32_t ilevel);
466185377Ssamextern	void ar5212SetLedState(struct ath_hal *ah, HAL_LED_STATE state);
467185377Ssamextern	void ar5212WriteAssocid(struct ath_hal *ah, const uint8_t *bssid,
468185377Ssam		uint16_t assocId);
469185377Ssamextern	uint32_t ar5212GetTsf32(struct ath_hal *ah);
470185377Ssamextern	uint64_t ar5212GetTsf64(struct ath_hal *ah);
471219419Sadrianextern	void ar5212SetTsf64(struct ath_hal *ah, uint64_t tsf64);
472185377Ssamextern	void ar5212ResetTsf(struct ath_hal *ah);
473185377Ssamextern	void ar5212SetBasicRate(struct ath_hal *ah, HAL_RATE_SET *pSet);
474185377Ssamextern	uint32_t ar5212GetRandomSeed(struct ath_hal *ah);
475185377Ssamextern	HAL_BOOL ar5212DetectCardPresent(struct ath_hal *ah);
476185377Ssamextern	void ar5212EnableMibCounters(struct ath_hal *);
477185377Ssamextern	void ar5212DisableMibCounters(struct ath_hal *);
478185377Ssamextern	void ar5212UpdateMibCounters(struct ath_hal *ah, HAL_MIB_STATS* stats);
479185377Ssamextern	HAL_BOOL ar5212IsJapanChannelSpreadSupported(struct ath_hal *ah);
480185377Ssamextern	uint32_t ar5212GetCurRssi(struct ath_hal *ah);
481185377Ssamextern	u_int ar5212GetDefAntenna(struct ath_hal *ah);
482185377Ssamextern	void ar5212SetDefAntenna(struct ath_hal *ah, u_int antenna);
483185377Ssamextern	HAL_ANT_SETTING ar5212GetAntennaSwitch(struct ath_hal *);
484185377Ssamextern	HAL_BOOL ar5212SetAntennaSwitch(struct ath_hal *, HAL_ANT_SETTING);
485185377Ssamextern	HAL_BOOL ar5212IsSleepAfterBeaconBroken(struct ath_hal *ah);
486185377Ssamextern	HAL_BOOL ar5212SetSifsTime(struct ath_hal *, u_int);
487185377Ssamextern	u_int ar5212GetSifsTime(struct ath_hal *);
488185377Ssamextern	HAL_BOOL ar5212SetSlotTime(struct ath_hal *, u_int);
489185377Ssamextern	u_int ar5212GetSlotTime(struct ath_hal *);
490185377Ssamextern	HAL_BOOL ar5212SetAckTimeout(struct ath_hal *, u_int);
491185377Ssamextern	u_int ar5212GetAckTimeout(struct ath_hal *);
492185377Ssamextern	HAL_BOOL ar5212SetAckCTSRate(struct ath_hal *, u_int);
493185377Ssamextern	u_int ar5212GetAckCTSRate(struct ath_hal *);
494185377Ssamextern	HAL_BOOL ar5212SetCTSTimeout(struct ath_hal *, u_int);
495185377Ssamextern	u_int ar5212GetCTSTimeout(struct ath_hal *);
496185377Ssamextern  HAL_BOOL ar5212SetDecompMask(struct ath_hal *, uint16_t, int);
497185377Ssamvoid 	ar5212SetCoverageClass(struct ath_hal *, uint8_t, int);
498185377Ssamextern	void ar5212SetPCUConfig(struct ath_hal *);
499185377Ssamextern	HAL_BOOL ar5212Use32KHzclock(struct ath_hal *ah, HAL_OPMODE opmode);
500185377Ssamextern	void ar5212SetupClock(struct ath_hal *ah, HAL_OPMODE opmode);
501185377Ssamextern	void ar5212RestoreClock(struct ath_hal *ah, HAL_OPMODE opmode);
502185377Ssamextern	int16_t ar5212GetNfAdjust(struct ath_hal *,
503185377Ssam		const HAL_CHANNEL_INTERNAL *);
504185377Ssamextern	void ar5212SetCompRegs(struct ath_hal *ah);
505185377Ssamextern	HAL_STATUS ar5212GetCapability(struct ath_hal *, HAL_CAPABILITY_TYPE,
506185377Ssam		uint32_t, uint32_t *);
507185377Ssamextern	HAL_BOOL ar5212SetCapability(struct ath_hal *, HAL_CAPABILITY_TYPE,
508185377Ssam		uint32_t, uint32_t, HAL_STATUS *);
509185377Ssamextern	HAL_BOOL ar5212GetDiagState(struct ath_hal *ah, int request,
510185377Ssam		const void *args, uint32_t argsize,
511185377Ssam		void **result, uint32_t *resultsize);
512222644Sadrianextern	HAL_STATUS ar5212SetQuiet(struct ath_hal *ah, uint32_t period,
513222644Sadrian		uint32_t duration, uint32_t nextStart, HAL_QUIET_FLAG flag);
514234873Sadrianextern	HAL_BOOL ar5212GetMibCycleCounts(struct ath_hal *,
515234873Sadrian		HAL_SURVEY_SAMPLE *);
516185377Ssam
517185377Ssamextern	HAL_BOOL ar5212SetPowerMode(struct ath_hal *ah, HAL_POWER_MODE mode,
518185377Ssam		int setChip);
519185377Ssamextern	HAL_POWER_MODE ar5212GetPowerMode(struct ath_hal *ah);
520185377Ssamextern	HAL_BOOL ar5212GetPowerStatus(struct ath_hal *ah);
521185377Ssam
522238278Sadrianextern	uint32_t ar5212GetRxDP(struct ath_hal *ath, HAL_RX_QUEUE);
523238278Sadrianextern	void ar5212SetRxDP(struct ath_hal *ah, uint32_t rxdp, HAL_RX_QUEUE);
524185377Ssamextern	void ar5212EnableReceive(struct ath_hal *ah);
525185377Ssamextern	HAL_BOOL ar5212StopDmaReceive(struct ath_hal *ah);
526185377Ssamextern	void ar5212StartPcuReceive(struct ath_hal *ah);
527185377Ssamextern	void ar5212StopPcuReceive(struct ath_hal *ah);
528185377Ssamextern	void ar5212SetMulticastFilter(struct ath_hal *ah,
529185377Ssam		uint32_t filter0, uint32_t filter1);
530185377Ssamextern	HAL_BOOL ar5212ClrMulticastFilterIndex(struct ath_hal *, uint32_t ix);
531185377Ssamextern	HAL_BOOL ar5212SetMulticastFilterIndex(struct ath_hal *, uint32_t ix);
532185377Ssamextern	uint32_t ar5212GetRxFilter(struct ath_hal *ah);
533185377Ssamextern	void ar5212SetRxFilter(struct ath_hal *ah, uint32_t bits);
534185377Ssamextern	HAL_BOOL ar5212SetupRxDesc(struct ath_hal *,
535185377Ssam		struct ath_desc *, uint32_t size, u_int flags);
536185377Ssamextern	HAL_STATUS ar5212ProcRxDesc(struct ath_hal *ah, struct ath_desc *,
537185377Ssam		uint32_t, struct ath_desc *, uint64_t,
538185377Ssam		struct ath_rx_status *);
539185377Ssam
540185377Ssamextern	HAL_BOOL ar5212Reset(struct ath_hal *ah, HAL_OPMODE opmode,
541187831Ssam		struct ieee80211_channel *chan, HAL_BOOL bChannelChange,
542187831Ssam		HAL_STATUS *status);
543187831Ssamextern	HAL_BOOL ar5212SetChannel(struct ath_hal *,
544187831Ssam		const struct ieee80211_channel *);
545185377Ssamextern	void ar5212SetOperatingMode(struct ath_hal *ah, int opmode);
546185377Ssamextern	HAL_BOOL ar5212PhyDisable(struct ath_hal *ah);
547185377Ssamextern	HAL_BOOL ar5212Disable(struct ath_hal *ah);
548187831Ssamextern	HAL_BOOL ar5212ChipReset(struct ath_hal *ah,
549187831Ssam		const struct ieee80211_channel *);
550187831Ssamextern	HAL_BOOL ar5212PerCalibration(struct ath_hal *ah,
551187831Ssam		struct ieee80211_channel *chan, HAL_BOOL *isIQdone);
552187831Ssamextern	HAL_BOOL ar5212PerCalibrationN(struct ath_hal *ah,
553187831Ssam		struct ieee80211_channel *chan, u_int chainMask,
554187831Ssam		HAL_BOOL longCal, HAL_BOOL *isCalDone);
555187831Ssamextern	HAL_BOOL ar5212ResetCalValid(struct ath_hal *ah,
556187831Ssam		const struct ieee80211_channel *);
557185377Ssamextern	int16_t ar5212GetNoiseFloor(struct ath_hal *ah);
558185377Ssamextern	void ar5212InitNfCalHistBuffer(struct ath_hal *);
559185377Ssamextern	int16_t ar5212GetNfHistMid(const int16_t calData[]);
560187831Ssamextern	void ar5212SetSpurMitigation(struct ath_hal *,
561187831Ssam		 const struct ieee80211_channel *);
562185377Ssamextern	HAL_BOOL ar5212SetAntennaSwitchInternal(struct ath_hal *ah,
563187831Ssam		HAL_ANT_SETTING settings, const struct ieee80211_channel *);
564185377Ssamextern	HAL_BOOL ar5212SetTxPowerLimit(struct ath_hal *ah, uint32_t limit);
565185377Ssamextern	HAL_BOOL ar5212GetChipPowerLimits(struct ath_hal *ah,
566187831Ssam		struct ieee80211_channel *chan);
567185377Ssamextern	void ar5212InitializeGainValues(struct ath_hal *);
568185377Ssamextern	HAL_RFGAIN ar5212GetRfgain(struct ath_hal *ah);
569185380Ssamextern	void ar5212RequestRfgain(struct ath_hal *);
570185377Ssam
571185377Ssamextern	HAL_BOOL ar5212UpdateTxTrigLevel(struct ath_hal *,
572185377Ssam		HAL_BOOL IncTrigLevel);
573185377Ssamextern  HAL_BOOL ar5212SetTxQueueProps(struct ath_hal *ah, int q,
574185377Ssam		const HAL_TXQ_INFO *qInfo);
575185377Ssamextern	HAL_BOOL ar5212GetTxQueueProps(struct ath_hal *ah, int q,
576185377Ssam		HAL_TXQ_INFO *qInfo);
577185377Ssamextern	int ar5212SetupTxQueue(struct ath_hal *ah, HAL_TX_QUEUE type,
578185377Ssam		const HAL_TXQ_INFO *qInfo);
579185377Ssamextern	HAL_BOOL ar5212ReleaseTxQueue(struct ath_hal *ah, u_int q);
580185377Ssamextern	HAL_BOOL ar5212ResetTxQueue(struct ath_hal *ah, u_int q);
581185377Ssamextern	uint32_t ar5212GetTxDP(struct ath_hal *ah, u_int q);
582185377Ssamextern	HAL_BOOL ar5212SetTxDP(struct ath_hal *ah, u_int q, uint32_t txdp);
583185377Ssamextern	HAL_BOOL ar5212StartTxDma(struct ath_hal *ah, u_int q);
584185377Ssamextern	uint32_t ar5212NumTxPending(struct ath_hal *ah, u_int q);
585185377Ssamextern	HAL_BOOL ar5212StopTxDma(struct ath_hal *ah, u_int q);
586185377Ssamextern	HAL_BOOL ar5212SetupTxDesc(struct ath_hal *ah, struct ath_desc *ds,
587185377Ssam		u_int pktLen, u_int hdrLen, HAL_PKT_TYPE type, u_int txPower,
588185377Ssam		u_int txRate0, u_int txTries0,
589185377Ssam		u_int keyIx, u_int antMode, u_int flags,
590185377Ssam		u_int rtsctsRate, u_int rtsctsDuration,
591185377Ssam		u_int compicvLen, u_int compivLen, u_int comp);
592185377Ssamextern	HAL_BOOL ar5212SetupXTxDesc(struct ath_hal *, struct ath_desc *,
593185377Ssam		u_int txRate1, u_int txRetries1,
594185377Ssam		u_int txRate2, u_int txRetries2,
595185377Ssam		u_int txRate3, u_int txRetries3);
596185377Ssamextern	HAL_BOOL ar5212FillTxDesc(struct ath_hal *ah, struct ath_desc *ds,
597185377Ssam		u_int segLen, HAL_BOOL firstSeg, HAL_BOOL lastSeg,
598185377Ssam		const struct ath_desc *ds0);
599185377Ssamextern	HAL_STATUS ar5212ProcTxDesc(struct ath_hal *ah,
600185377Ssam		struct ath_desc *, struct ath_tx_status *);
601185377Ssamextern  void ar5212GetTxIntrQueue(struct ath_hal *ah, uint32_t *);
602185377Ssamextern  void ar5212IntrReqTxDesc(struct ath_hal *ah, struct ath_desc *);
603217621Sadrianextern	HAL_BOOL ar5212GetTxCompletionRates(struct ath_hal *ah,
604217621Sadrian		const struct ath_desc *ds0, int *rates, int *tries);
605238607Sadrianextern	void ar5212SetTxDescLink(struct ath_hal *ah, void *ds,
606238607Sadrian		uint32_t link);
607238607Sadrianextern	void ar5212GetTxDescLink(struct ath_hal *ah, void *ds,
608238607Sadrian		uint32_t *link);
609238607Sadrianextern	void ar5212GetTxDescLinkPtr(struct ath_hal *ah, void *ds,
610238607Sadrian		uint32_t **linkptr);
611185377Ssam
612185377Ssamextern	const HAL_RATE_TABLE *ar5212GetRateTable(struct ath_hal *, u_int mode);
613185377Ssam
614185377Ssamextern	void ar5212AniAttach(struct ath_hal *, const struct ar5212AniParams *,
615185377Ssam		const struct ar5212AniParams *, HAL_BOOL ena);
616185377Ssamextern	void ar5212AniDetach(struct ath_hal *);
617185377Ssamextern	struct ar5212AniState *ar5212AniGetCurrentState(struct ath_hal *);
618185377Ssamextern	struct ar5212Stats *ar5212AniGetCurrentStats(struct ath_hal *);
619185377Ssamextern	HAL_BOOL ar5212AniControl(struct ath_hal *, HAL_ANI_CMD cmd, int param);
620185377Ssamextern	HAL_BOOL ar5212AniSetParams(struct ath_hal *,
621185377Ssam		const struct ar5212AniParams *, const struct ar5212AniParams *);
622185377Ssamstruct ath_rx_status;
623185377Ssamextern	void ar5212AniPhyErrReport(struct ath_hal *ah,
624185377Ssam		const struct ath_rx_status *rs);
625185377Ssamextern	void ar5212ProcessMibIntr(struct ath_hal *, const HAL_NODE_STATS *);
626217684Sadrianextern	void ar5212RxMonitor(struct ath_hal *, const HAL_NODE_STATS *,
627187831Ssam			     const struct ieee80211_channel *);
628217684Sadrianextern	void ar5212AniPoll(struct ath_hal *, const struct ieee80211_channel *);
629187831Ssamextern	void ar5212AniReset(struct ath_hal *, const struct ieee80211_channel *,
630185377Ssam		HAL_OPMODE, int);
631211206Sadrian
632211206Sadrianextern	HAL_BOOL ar5212IsNFCalInProgress(struct ath_hal *ah);
633211206Sadrianextern	HAL_BOOL ar5212WaitNFCalComplete(struct ath_hal *ah, int i);
634222584Sadrianextern	void ar5212EnableDfs(struct ath_hal *ah, HAL_PHYERR_PARAM *pe);
635222584Sadrianextern	void ar5212GetDfsThresh(struct ath_hal *ah, HAL_PHYERR_PARAM *pe);
636222815Sadrianextern	HAL_BOOL ar5212ProcessRadarEvent(struct ath_hal *ah,
637222815Sadrian	    struct ath_rx_status *rxs, uint64_t fulltsf, const char *buf,
638222815Sadrian	    HAL_DFS_EVENT *event);
639224709Sadrianextern	HAL_BOOL ar5212IsFastClockEnabled(struct ath_hal *ah);
640230791Sadrianextern	uint32_t ar5212Get11nExtBusy(struct ath_hal *ah);
641211206Sadrian
642185377Ssam#endif	/* _ATH_AR5212_H_ */
643