ah_eeprom_9287.h revision 221888
1/*
2 * Copyright (c) 2008-2009 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 * $FreeBSD: head/sys/dev/ath/ath_hal/ah_eeprom_9287.h 221888 2011-05-14 14:25:15Z adrian $
17 */
18
19#ifndef	__AH_EEPROM_9287_H__
20#define	__AH_EEPROM_9287_H__
21
22#define OLC_FOR_AR9287_10_LATER (AR_SREV_9287_11_OR_LATER(ah) && \
23				 ah->eep_ops->get_eeprom(ah, EEP_OL_PWRCTRL))
24
25#define AR9287_EEP_VER               0xE
26#define AR9287_EEP_VER_MINOR_MASK    0xFFF
27#define AR9287_EEP_MINOR_VER_1       0x1
28#define AR9287_EEP_MINOR_VER_2       0x2
29#define AR9287_EEP_MINOR_VER_3       0x3
30#define AR9287_EEP_MINOR_VER         AR9287_EEP_MINOR_VER_3
31#define AR9287_EEP_MINOR_VER_b       AR9287_EEP_MINOR_VER
32#define AR9287_EEP_NO_BACK_VER       AR9287_EEP_MINOR_VER_1
33
34#define AR9287_EEP_START_LOC            128
35#define AR9287_HTC_EEP_START_LOC        256
36#define AR9287_NUM_2G_CAL_PIERS         3
37#define AR9287_NUM_2G_CCK_TARGET_POWERS 3
38#define AR9287_NUM_2G_20_TARGET_POWERS  3
39#define AR9287_NUM_2G_40_TARGET_POWERS  3
40#define AR9287_NUM_CTLS              	12
41#define AR9287_NUM_BAND_EDGES        	4
42#define AR9287_PD_GAIN_ICEPTS           1
43#define AR9287_EEPMISC_BIG_ENDIAN       0x01
44#define AR9287_EEPMISC_WOW              0x02
45#define AR9287_MAX_CHAINS               2
46#define AR9287_ANT_16S                  32
47
48#define AR9287_DATA_SZ                  32
49
50#define AR9287_PWR_TABLE_OFFSET_DB  -5
51
52#define AR9287_CHECKSUM_LOCATION (AR9287_EEP_START_LOC + 1)
53
54struct base_eep_ar9287_header {
55	uint16_t version;		/* Swapped w/ length; check ah_eeprom_v14.h */
56	uint16_t checksum;
57	uint16_t length;
58	uint8_t opCapFlags;
59	uint8_t eepMisc;
60	uint16_t regDmn[2];
61	uint8_t macAddr[6];
62	uint8_t rxMask;
63	uint8_t txMask;
64	uint16_t rfSilent;
65	uint16_t blueToothOptions;
66	uint16_t deviceCap;
67	uint32_t binBuildNumber;
68	uint8_t deviceType;
69	uint8_t openLoopPwrCntl;
70	int8_t pwrTableOffset;
71	int8_t tempSensSlope;
72	int8_t tempSensSlopePalOn;
73	uint8_t futureBase[29];
74} __packed;
75
76struct modal_eep_ar9287_header {
77	uint32_t antCtrlChain[AR9287_MAX_CHAINS];
78	uint32_t antCtrlCommon;
79	int8_t antennaGainCh[AR9287_MAX_CHAINS];
80	uint8_t switchSettling;
81	uint8_t txRxAttenCh[AR9287_MAX_CHAINS];
82	uint8_t rxTxMarginCh[AR9287_MAX_CHAINS];
83	int8_t adcDesiredSize;
84	uint8_t txEndToXpaOff;
85	uint8_t txEndToRxOn;
86	uint8_t txFrameToXpaOn;
87	uint8_t thresh62;
88	int8_t noiseFloorThreshCh[AR9287_MAX_CHAINS];
89	uint8_t xpdGain;
90	uint8_t xpd;
91	int8_t iqCalICh[AR9287_MAX_CHAINS];
92	int8_t iqCalQCh[AR9287_MAX_CHAINS];
93	uint8_t pdGainOverlap;
94	uint8_t xpaBiasLvl;
95	uint8_t txFrameToDataStart;
96	uint8_t txFrameToPaOn;
97	uint8_t ht40PowerIncForPdadc;
98	uint8_t bswAtten[AR9287_MAX_CHAINS];
99	uint8_t bswMargin[AR9287_MAX_CHAINS];
100	uint8_t swSettleHt40;
101	uint8_t version;
102	uint8_t db1;
103	uint8_t db2;
104	uint8_t ob_cck;
105	uint8_t ob_psk;
106	uint8_t ob_qam;
107	uint8_t ob_pal_off;
108	uint8_t futureModal[30];
109	SPUR_CHAN spurChans[AR5416_EEPROM_MODAL_SPURS];
110} __packed;
111
112struct cal_data_op_loop_ar9287 {
113	uint8_t pwrPdg[2][5];
114	uint8_t vpdPdg[2][5];
115	uint8_t pcdac[2][5];
116	uint8_t empty[2][5];
117} __packed;
118
119struct cal_data_per_freq_ar9287 {
120	uint8_t pwrPdg[AR5416_NUM_PD_GAINS][AR9287_PD_GAIN_ICEPTS];
121	uint8_t vpdPdg[AR5416_NUM_PD_GAINS][AR9287_PD_GAIN_ICEPTS];
122} __packed;
123
124union cal_data_per_freq_ar9287_u {
125	struct cal_data_op_loop_ar9287 calDataOpen;
126	struct cal_data_per_freq_ar9287 calDataClose;
127} __packed;
128
129struct cal_ctl_data_ar9287 {
130	CAL_CTL_EDGES ctlEdges[AR9287_MAX_CHAINS][AR9287_NUM_BAND_EDGES];
131} __packed;
132
133struct ar9287_eeprom {
134	struct base_eep_ar9287_header baseEepHeader;
135	uint8_t custData[AR9287_DATA_SZ];
136	struct modal_eep_ar9287_header modalHeader;
137	uint8_t calFreqPier2G[AR9287_NUM_2G_CAL_PIERS];
138	union cal_data_per_freq_ar9287_u
139	    calPierData2G[AR9287_MAX_CHAINS][AR9287_NUM_2G_CAL_PIERS];
140	CAL_TARGET_POWER_LEG
141	    calTargetPowerCck[AR9287_NUM_2G_CCK_TARGET_POWERS];
142	CAL_TARGET_POWER_LEG
143	    calTargetPower2G[AR9287_NUM_2G_20_TARGET_POWERS];
144	CAL_TARGET_POWER_HT
145	    calTargetPower2GHT20[AR9287_NUM_2G_20_TARGET_POWERS];
146	CAL_TARGET_POWER_HT
147	    calTargetPower2GHT40[AR9287_NUM_2G_40_TARGET_POWERS];
148	uint8_t ctlIndex[AR9287_NUM_CTLS];
149	struct cal_ctl_data_ar9287 ctlData[AR9287_NUM_CTLS];
150	uint8_t padding;
151} __packed;
152
153typedef struct {
154        struct ar9287_eeprom ee_base;
155#define NUM_EDGES        8
156        uint16_t        ee_numCtls;
157        RD_EDGES_POWER  ee_rdEdgesPower[NUM_EDGES*AR9287_NUM_CTLS];
158        /* XXX these are dynamically calculated for use by shared code */
159        int8_t          ee_antennaGainMax[2];
160} HAL_EEPROM_9287;
161
162typedef struct modal_eep_ar9287_header MODAL_EEP_9287_HEADER;
163typedef struct base_eep_ar9287_header BASE_EEP_9287_HEADER;
164
165
166#endif /* __AH_EEPROM_9287_H__ */
167