xref: /linux/drivers/net/wireless/ath/ath9k/ar9003_eeprom.h (revision 9a87ffc99ec8eb8d35eed7c4f816d75f5cc9662e)
1 /*
2  * Copyright (c) 2010-2011 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 AR9003_EEPROM_H
18 #define AR9003_EEPROM_H
19 
20 #include <linux/types.h>
21 
22 #define AR9300_EEP_VER               0xD000
23 #define AR9300_EEP_VER_MINOR_MASK    0xFFF
24 #define AR9300_EEP_MINOR_VER_1       0x1
25 #define AR9300_EEP_MINOR_VER         AR9300_EEP_MINOR_VER_1
26 
27 /* 16-bit offset location start of calibration struct */
28 #define AR9300_EEP_START_LOC         256
29 #define AR9300_NUM_5G_CAL_PIERS      8
30 #define AR9300_NUM_2G_CAL_PIERS      3
31 #define AR9300_NUM_5G_20_TARGET_POWERS  8
32 #define AR9300_NUM_5G_40_TARGET_POWERS  8
33 #define AR9300_NUM_2G_CCK_TARGET_POWERS 2
34 #define AR9300_NUM_2G_20_TARGET_POWERS  3
35 #define AR9300_NUM_2G_40_TARGET_POWERS  3
36 /* #define AR9300_NUM_CTLS              21 */
37 #define AR9300_NUM_CTLS_5G           9
38 #define AR9300_NUM_CTLS_2G           12
39 #define AR9300_NUM_BAND_EDGES_5G     8
40 #define AR9300_NUM_BAND_EDGES_2G     4
41 #define AR9300_EEPMISC_WOW           0x02
42 #define AR9300_CUSTOMER_DATA_SIZE    20
43 
44 #define AR9300_MAX_CHAINS            3
45 #define AR9300_ANT_16S               25
46 #define AR9300_FUTURE_MODAL_SZ       6
47 
48 #define AR9300_PAPRD_RATE_MASK		0x01ffffff
49 #define AR9300_PAPRD_SCALE_1		0x0e000000
50 #define AR9300_PAPRD_SCALE_1_S		25
51 #define AR9300_PAPRD_SCALE_2		0x70000000
52 #define AR9300_PAPRD_SCALE_2_S		28
53 
54 #define AR9300_EEP_ANTDIV_CONTROL_DEFAULT_VALUE 0xc9
55 
56 /* Delta from which to start power to pdadc table */
57 /* This offset is used in both open loop and closed loop power control
58  * schemes. In open loop power control, it is not really needed, but for
59  * the "sake of consistency" it was kept. For certain AP designs, this
60  * value is overwritten by the value in the flag "pwrTableOffset" just
61  * before writing the pdadc vs pwr into the chip registers.
62  */
63 #define AR9300_PWR_TABLE_OFFSET  0
64 
65 /* Noise power data definitions
66  * units are: 4 x dBm - NOISE_PWR_DATA_OFFSET
67  * (e.g. -25 = (-25/4 - 90) = -96.25 dBm)
68  * range (for 6 signed bits) is (-32 to 31) + offset => -122dBm to -59dBm
69  * resolution (2 bits) is 0.25dBm
70  */
71 #define NOISE_PWR_DATA_OFFSET	-90
72 #define NOISE_PWR_DBM_2_INT(_p)	((((_p) + 3) >> 2) + NOISE_PWR_DATA_OFFSET)
73 #define N2DBM(_p)		NOISE_PWR_DBM_2_INT(_p)
74 
75 /* byte addressable */
76 #define AR9300_EEPROM_SIZE (16*1024)
77 
78 #define AR9300_BASE_ADDR_4K 0xfff
79 #define AR9300_BASE_ADDR 0x3ff
80 #define AR9300_BASE_ADDR_512 0x1ff
81 
82 /* AR5416_EEPMISC_BIG_ENDIAN not set indicates little endian */
83 #define AR9300_EEPMISC_LITTLE_ENDIAN 0
84 
85 #define AR9300_OTP_BASE(_ah) \
86 		((AR_SREV_9340(_ah) || AR_SREV_9550(_ah)) ? 0x30000 : 0x14000)
87 #define AR9300_OTP_STATUS(_ah) \
88 		((AR_SREV_9340(_ah) || AR_SREV_9550(_ah)) ? 0x31018 : 0x15f18)
89 #define AR9300_OTP_STATUS_TYPE		0x7
90 #define AR9300_OTP_STATUS_VALID		0x4
91 #define AR9300_OTP_STATUS_ACCESS_BUSY	0x2
92 #define AR9300_OTP_STATUS_SM_BUSY	0x1
93 #define AR9300_OTP_READ_DATA(_ah) \
94 		((AR_SREV_9340(_ah) || AR_SREV_9550(_ah)) ? 0x3101c : 0x15f1c)
95 
96 enum targetPowerHTRates {
97 	HT_TARGET_RATE_0_8_16,
98 	HT_TARGET_RATE_1_3_9_11_17_19,
99 	HT_TARGET_RATE_4,
100 	HT_TARGET_RATE_5,
101 	HT_TARGET_RATE_6,
102 	HT_TARGET_RATE_7,
103 	HT_TARGET_RATE_12,
104 	HT_TARGET_RATE_13,
105 	HT_TARGET_RATE_14,
106 	HT_TARGET_RATE_15,
107 	HT_TARGET_RATE_20,
108 	HT_TARGET_RATE_21,
109 	HT_TARGET_RATE_22,
110 	HT_TARGET_RATE_23
111 };
112 
113 enum targetPowerLegacyRates {
114 	LEGACY_TARGET_RATE_6_24,
115 	LEGACY_TARGET_RATE_36,
116 	LEGACY_TARGET_RATE_48,
117 	LEGACY_TARGET_RATE_54
118 };
119 
120 enum targetPowerCckRates {
121 	LEGACY_TARGET_RATE_1L_5L,
122 	LEGACY_TARGET_RATE_5S,
123 	LEGACY_TARGET_RATE_11L,
124 	LEGACY_TARGET_RATE_11S
125 };
126 
127 enum ar9300_Rates {
128 	ALL_TARGET_LEGACY_6_24,
129 	ALL_TARGET_LEGACY_36,
130 	ALL_TARGET_LEGACY_48,
131 	ALL_TARGET_LEGACY_54,
132 	ALL_TARGET_LEGACY_1L_5L,
133 	ALL_TARGET_LEGACY_5S,
134 	ALL_TARGET_LEGACY_11L,
135 	ALL_TARGET_LEGACY_11S,
136 	ALL_TARGET_HT20_0_8_16,
137 	ALL_TARGET_HT20_1_3_9_11_17_19,
138 	ALL_TARGET_HT20_4,
139 	ALL_TARGET_HT20_5,
140 	ALL_TARGET_HT20_6,
141 	ALL_TARGET_HT20_7,
142 	ALL_TARGET_HT20_12,
143 	ALL_TARGET_HT20_13,
144 	ALL_TARGET_HT20_14,
145 	ALL_TARGET_HT20_15,
146 	ALL_TARGET_HT20_20,
147 	ALL_TARGET_HT20_21,
148 	ALL_TARGET_HT20_22,
149 	ALL_TARGET_HT20_23,
150 	ALL_TARGET_HT40_0_8_16,
151 	ALL_TARGET_HT40_1_3_9_11_17_19,
152 	ALL_TARGET_HT40_4,
153 	ALL_TARGET_HT40_5,
154 	ALL_TARGET_HT40_6,
155 	ALL_TARGET_HT40_7,
156 	ALL_TARGET_HT40_12,
157 	ALL_TARGET_HT40_13,
158 	ALL_TARGET_HT40_14,
159 	ALL_TARGET_HT40_15,
160 	ALL_TARGET_HT40_20,
161 	ALL_TARGET_HT40_21,
162 	ALL_TARGET_HT40_22,
163 	ALL_TARGET_HT40_23,
164 	ar9300RateSize,
165 };
166 
167 
168 struct eepFlags {
169 	u8 opFlags;
170 	u8 eepMisc;
171 } __packed;
172 
173 enum CompressAlgorithm {
174 	_CompressNone = 0,
175 	_CompressLzma,
176 	_CompressPairs,
177 	_CompressBlock,
178 	_Compress4,
179 	_Compress5,
180 	_Compress6,
181 	_Compress7,
182 };
183 
184 struct ar9300_base_eep_hdr {
185 	__le16 regDmn[2];
186 	/* 4 bits tx and 4 bits rx */
187 	u8 txrxMask;
188 	struct eepFlags opCapFlags;
189 	u8 rfSilent;
190 	u8 blueToothOptions;
191 	u8 deviceCap;
192 	/* takes lower byte in eeprom location */
193 	u8 deviceType;
194 	/* offset in dB to be added to beginning
195 	 * of pdadc table in calibration
196 	 */
197 	int8_t pwrTableOffset;
198 	u8 params_for_tuning_caps[2];
199 	/*
200 	 * bit0 - enable tx temp comp
201 	 * bit1 - enable tx volt comp
202 	 * bit2 - enable fastClock - default to 1
203 	 * bit3 - enable doubling - default to 1
204 	 * bit4 - enable internal regulator - default to 1
205 	 */
206 	u8 featureEnable;
207 	/* misc flags: bit0 - turn down drivestrength */
208 	u8 miscConfiguration;
209 	u8 eepromWriteEnableGpio;
210 	u8 wlanDisableGpio;
211 	u8 wlanLedGpio;
212 	u8 rxBandSelectGpio;
213 	u8 txrxgain;
214 	/* SW controlled internal regulator fields */
215 	__le32 swreg;
216 } __packed;
217 
218 struct ar9300_modal_eep_header {
219 	/* 4 idle, t1, t2, b (4 bits per setting) */
220 	__le32 antCtrlCommon;
221 	/* 4 ra1l1, ra2l1, ra1l2, ra2l2, ra12 */
222 	__le32 antCtrlCommon2;
223 	/* 6 idle, t, r, rx1, rx12, b (2 bits each) */
224 	__le16 antCtrlChain[AR9300_MAX_CHAINS];
225 	/* 3 xatten1_db for AR9280 (0xa20c/b20c 5:0) */
226 	u8 xatten1DB[AR9300_MAX_CHAINS];
227 	/* 3  xatten1_margin for merlin (0xa20c/b20c 16:12 */
228 	u8 xatten1Margin[AR9300_MAX_CHAINS];
229 	int8_t tempSlope;
230 	int8_t voltSlope;
231 	/* spur channels in usual fbin coding format */
232 	u8 spurChans[AR_EEPROM_MODAL_SPURS];
233 	/* 3  Check if the register is per chain */
234 	int8_t noiseFloorThreshCh[AR9300_MAX_CHAINS];
235 	u8 reserved[11];
236 	int8_t quick_drop;
237 	u8 xpaBiasLvl;
238 	u8 txFrameToDataStart;
239 	u8 txFrameToPaOn;
240 	u8 txClip;
241 	int8_t antennaGain;
242 	u8 switchSettling;
243 	int8_t adcDesiredSize;
244 	u8 txEndToXpaOff;
245 	u8 txEndToRxOn;
246 	u8 txFrameToXpaOn;
247 	u8 thresh62;
248 	__le32 papdRateMaskHt20;
249 	__le32 papdRateMaskHt40;
250 	__le16 switchcomspdt;
251 	u8 xlna_bias_strength;
252 	u8 futureModal[7];
253 } __packed;
254 
255 struct ar9300_cal_data_per_freq_op_loop {
256 	int8_t refPower;
257 	/* pdadc voltage at power measurement */
258 	u8 voltMeas;
259 	/* pcdac used for power measurement   */
260 	u8 tempMeas;
261 	/* range is -60 to -127 create a mapping equation 1db resolution */
262 	int8_t rxNoisefloorCal;
263 	/*range is same as noisefloor */
264 	int8_t rxNoisefloorPower;
265 	/* temp measured when noisefloor cal was performed */
266 	u8 rxTempMeas;
267 } __packed;
268 
269 struct cal_tgt_pow_legacy {
270 	u8 tPow2x[4];
271 } __packed;
272 
273 struct cal_tgt_pow_ht {
274 	u8 tPow2x[14];
275 } __packed;
276 
277 struct cal_ctl_data_2g {
278 	u8 ctlEdges[AR9300_NUM_BAND_EDGES_2G];
279 } __packed;
280 
281 struct cal_ctl_data_5g {
282 	u8 ctlEdges[AR9300_NUM_BAND_EDGES_5G];
283 } __packed;
284 
285 #define MAX_BASE_EXTENSION_FUTURE 2
286 
287 struct ar9300_BaseExtension_1 {
288 	u8 ant_div_control;
289 	u8 future[MAX_BASE_EXTENSION_FUTURE];
290 	/*
291 	 * misc_enable:
292 	 *
293 	 * BIT 0   - TX Gain Cap enable.
294 	 * BIT 1   - Uncompressed Checksum enable.
295 	 * BIT 2/3 - MinCCApwr enable 2g/5g.
296 	 */
297 	u8 misc_enable;
298 	int8_t tempslopextension[8];
299 	int8_t quick_drop_low;
300 	int8_t quick_drop_high;
301 } __packed;
302 
303 struct ar9300_BaseExtension_2 {
304 	int8_t    tempSlopeLow;
305 	int8_t    tempSlopeHigh;
306 	u8   xatten1DBLow[AR9300_MAX_CHAINS];
307 	u8   xatten1MarginLow[AR9300_MAX_CHAINS];
308 	u8   xatten1DBHigh[AR9300_MAX_CHAINS];
309 	u8   xatten1MarginHigh[AR9300_MAX_CHAINS];
310 } __packed;
311 
312 struct ar9300_eeprom {
313 	u8 eepromVersion;
314 	u8 templateVersion;
315 	u8 macAddr[6];
316 	u8 custData[AR9300_CUSTOMER_DATA_SIZE];
317 
318 	struct ar9300_base_eep_hdr baseEepHeader;
319 
320 	struct ar9300_modal_eep_header modalHeader2G;
321 	struct ar9300_BaseExtension_1 base_ext1;
322 	u8 calFreqPier2G[AR9300_NUM_2G_CAL_PIERS];
323 	struct ar9300_cal_data_per_freq_op_loop
324 	 calPierData2G[AR9300_MAX_CHAINS][AR9300_NUM_2G_CAL_PIERS];
325 	u8 calTarget_freqbin_Cck[AR9300_NUM_2G_CCK_TARGET_POWERS];
326 	u8 calTarget_freqbin_2G[AR9300_NUM_2G_20_TARGET_POWERS];
327 	u8 calTarget_freqbin_2GHT20[AR9300_NUM_2G_20_TARGET_POWERS];
328 	u8 calTarget_freqbin_2GHT40[AR9300_NUM_2G_40_TARGET_POWERS];
329 	struct cal_tgt_pow_legacy
330 	 calTargetPowerCck[AR9300_NUM_2G_CCK_TARGET_POWERS];
331 	struct cal_tgt_pow_legacy
332 	 calTargetPower2G[AR9300_NUM_2G_20_TARGET_POWERS];
333 	struct cal_tgt_pow_ht
334 	 calTargetPower2GHT20[AR9300_NUM_2G_20_TARGET_POWERS];
335 	struct cal_tgt_pow_ht
336 	 calTargetPower2GHT40[AR9300_NUM_2G_40_TARGET_POWERS];
337 	u8 ctlIndex_2G[AR9300_NUM_CTLS_2G];
338 	u8 ctl_freqbin_2G[AR9300_NUM_CTLS_2G][AR9300_NUM_BAND_EDGES_2G];
339 	struct cal_ctl_data_2g ctlPowerData_2G[AR9300_NUM_CTLS_2G];
340 	struct ar9300_modal_eep_header modalHeader5G;
341 	struct ar9300_BaseExtension_2 base_ext2;
342 	u8 calFreqPier5G[AR9300_NUM_5G_CAL_PIERS];
343 	struct ar9300_cal_data_per_freq_op_loop
344 	 calPierData5G[AR9300_MAX_CHAINS][AR9300_NUM_5G_CAL_PIERS];
345 	u8 calTarget_freqbin_5G[AR9300_NUM_5G_20_TARGET_POWERS];
346 	u8 calTarget_freqbin_5GHT20[AR9300_NUM_5G_20_TARGET_POWERS];
347 	u8 calTarget_freqbin_5GHT40[AR9300_NUM_5G_40_TARGET_POWERS];
348 	struct cal_tgt_pow_legacy
349 	 calTargetPower5G[AR9300_NUM_5G_20_TARGET_POWERS];
350 	struct cal_tgt_pow_ht
351 	 calTargetPower5GHT20[AR9300_NUM_5G_20_TARGET_POWERS];
352 	struct cal_tgt_pow_ht
353 	 calTargetPower5GHT40[AR9300_NUM_5G_40_TARGET_POWERS];
354 	u8 ctlIndex_5G[AR9300_NUM_CTLS_5G];
355 	u8 ctl_freqbin_5G[AR9300_NUM_CTLS_5G][AR9300_NUM_BAND_EDGES_5G];
356 	struct cal_ctl_data_5g ctlPowerData_5G[AR9300_NUM_CTLS_5G];
357 } __packed;
358 
359 s32 ar9003_hw_get_tx_gain_idx(struct ath_hw *ah);
360 s32 ar9003_hw_get_rx_gain_idx(struct ath_hw *ah);
361 u32 ar9003_hw_ant_ctrl_common_get(struct ath_hw *ah, bool is2ghz);
362 u32 ar9003_hw_ant_ctrl_common_2_get(struct ath_hw *ah, bool is2ghz);
363 
364 u8 *ar9003_get_spur_chan_ptr(struct ath_hw *ah, bool is_2ghz);
365 
366 u32 ar9003_get_paprd_rate_mask_ht20(struct ath_hw *ah, bool is2ghz);
367 u32 ar9003_get_paprd_rate_mask_ht40(struct ath_hw *ah, bool is2ghz);
368 unsigned int ar9003_get_paprd_scale_factor(struct ath_hw *ah,
369 					   struct ath9k_channel *chan);
370 
371 void ar9003_hw_internal_regulator_apply(struct ath_hw *ah);
372 int ar9003_hw_tx_power_regwrite(struct ath_hw *ah, u8 * pPwrArray);
373 
374 #endif
375