Merge branch 'gpio/merge' of git://git.secretlab.ca/git/linux-2.6
[deliverable/linux.git] / drivers / net / wireless / iwlwifi / iwl-eeprom.h
CommitLineData
34cf6ff6
AK
1/******************************************************************************
2 *
3 * This file is provided under a dual BSD/GPLv2 license. When using or
4 * redistributing this file, you may do so under either license.
5 *
6 * GPL LICENSE SUMMARY
7 *
901069c7 8 * Copyright(c) 2008 - 2011 Intel Corporation. All rights reserved.
34cf6ff6
AK
9 *
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of version 2 of the GNU General Public License as
12 * published by the Free Software Foundation.
13 *
14 * This program is distributed in the hope that it will be useful, but
15 * WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17 * General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
22 * USA
23 *
24 * The full GNU General Public License is included in this distribution
25 * in the file called LICENSE.GPL.
26 *
27 * Contact Information:
759ef89f 28 * Intel Linux Wireless <ilw@linux.intel.com>
34cf6ff6
AK
29 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
30 *
31 * BSD LICENSE
32 *
901069c7 33 * Copyright(c) 2005 - 2011 Intel Corporation. All rights reserved.
34cf6ff6
AK
34 * All rights reserved.
35 *
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 *
40 * * Redistributions of source code must retain the above copyright
41 * notice, this list of conditions and the following disclaimer.
42 * * Redistributions in binary form must reproduce the above copyright
43 * notice, this list of conditions and the following disclaimer in
44 * the documentation and/or other materials provided with the
45 * distribution.
46 * * Neither the name Intel Corporation nor the names of its
47 * contributors may be used to endorse or promote products derived
48 * from this software without specific prior written permission.
49 *
50 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
51 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
52 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
53 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
54 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
55 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
56 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
57 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
58 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
59 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
60 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
61 *****************************************************************************/
62
63#ifndef __iwl_eeprom_h__
64#define __iwl_eeprom_h__
65
be1a71a1
JB
66#include <net/mac80211.h>
67
c79dd5b5 68struct iwl_priv;
34cf6ff6
AK
69
70/*
71 * EEPROM access time values:
72 *
3d5717ad 73 * Driver initiates EEPROM read by writing byte address << 1 to CSR_EEPROM_REG.
34cf6ff6
AK
74 * Driver then polls CSR_EEPROM_REG for CSR_EEPROM_REG_READ_VALID_MSK (0x1).
75 * When polling, wait 10 uSec between polling loops, up to a maximum 5000 uSec.
76 * Driver reads 16-bit value from bits 31-16 of CSR_EEPROM_REG.
77 */
78#define IWL_EEPROM_ACCESS_TIMEOUT 5000 /* uSec */
34cf6ff6 79
3d5717ad 80#define IWL_EEPROM_SEM_TIMEOUT 10 /* microseconds */
34cf6ff6
AK
81#define IWL_EEPROM_SEM_RETRY_LIMIT 1000 /* number of attempts (not time) */
82
83
84/*
85 * Regulatory channel usage flags in EEPROM struct iwl4965_eeprom_channel.flags.
86 *
87 * IBSS and/or AP operation is allowed *only* on those channels with
88 * (VALID && IBSS && ACTIVE && !RADAR). This restriction is in place because
89 * RADAR detection is not supported by the 4965 driver, but is a
90 * requirement for establishing a new network for legal operation on channels
91 * requiring RADAR detection or restricting ACTIVE scanning.
92 *
7aafef1c
WYG
93 * NOTE: "WIDE" flag does not indicate anything about "HT40" 40 MHz channels.
94 * It only indicates that 20 MHz channel use is supported; HT40 channel
34cf6ff6 95 * usage is indicated by a separate set of regulatory flags for each
7aafef1c 96 * HT40 channel pair.
34cf6ff6
AK
97 *
98 * NOTE: Using a channel inappropriately will result in a uCode error!
99 */
100#define IWL_NUM_TX_CALIB_GROUPS 5
101enum {
102 EEPROM_CHANNEL_VALID = (1 << 0), /* usable for this SKU/geo */
103 EEPROM_CHANNEL_IBSS = (1 << 1), /* usable as an IBSS channel */
104 /* Bit 2 Reserved */
105 EEPROM_CHANNEL_ACTIVE = (1 << 3), /* active scanning allowed */
106 EEPROM_CHANNEL_RADAR = (1 << 4), /* radar detection required */
107 EEPROM_CHANNEL_WIDE = (1 << 5), /* 20 MHz channel okay */
fe7c4040 108 /* Bit 6 Reserved (was Narrow Channel) */
34cf6ff6
AK
109 EEPROM_CHANNEL_DFS = (1 << 7), /* dynamic freq selection candidate */
110};
111
112/* SKU Capabilities */
05269297
WYG
113#define EEPROM_SKU_CAP_BAND_24GHZ (1 << 4)
114#define EEPROM_SKU_CAP_BAND_52GHZ (1 << 5)
21a5b3c6 115#define EEPROM_SKU_CAP_11N_ENABLE (1 << 6)
05269297 116#define EEPROM_SKU_CAP_AMT_ENABLE (1 << 7)
21a5b3c6
WYG
117#define EEPROM_SKU_CAP_IPAN_ENABLE (1 << 8)
118
34cf6ff6 119/* *regulatory* channel data format in eeprom, one for each channel.
7aafef1c 120 * There are separate entries for HT40 (40 MHz) vs. normal (20 MHz) channels. */
073d3f5f 121struct iwl_eeprom_channel {
34cf6ff6
AK
122 u8 flags; /* EEPROM_CHANNEL_* flags copied from EEPROM */
123 s8 max_power_avg; /* max power (dBm) on this chnl, limit 31 */
ba2d3587 124} __packed;
34cf6ff6 125
8d6748ca
JB
126enum iwl_eeprom_enhanced_txpwr_flags {
127 IWL_EEPROM_ENH_TXP_FL_VALID = BIT(0),
128 IWL_EEPROM_ENH_TXP_FL_BAND_52G = BIT(1),
129 IWL_EEPROM_ENH_TXP_FL_OFDM = BIT(2),
130 IWL_EEPROM_ENH_TXP_FL_40MHZ = BIT(3),
131 IWL_EEPROM_ENH_TXP_FL_HT_AP = BIT(4),
132 IWL_EEPROM_ENH_TXP_FL_RES1 = BIT(5),
133 IWL_EEPROM_ENH_TXP_FL_RES2 = BIT(6),
134 IWL_EEPROM_ENH_TXP_FL_COMMON_TYPE = BIT(7),
135};
136
ab9fd1bf
WYG
137/**
138 * iwl_eeprom_enhanced_txpwr structure
139 * This structure presents the enhanced regulatory tx power limit layout
140 * in eeprom image
141 * Enhanced regulatory tx power portion of eeprom image can be broken down
142 * into individual structures; each one is 8 bytes in size and contain the
143 * following information
e7362a00
JB
144 * @flags: entry flags
145 * @channel: channel number
ab9fd1bf
WYG
146 * @chain_a_max_pwr: chain a max power in 1/2 dBm
147 * @chain_b_max_pwr: chain b max power in 1/2 dBm
148 * @chain_c_max_pwr: chain c max power in 1/2 dBm
e7362a00 149 * @delta_20_in_40: 20-in-40 deltas (hi/lo)
ab9fd1bf
WYG
150 * @mimo2_max_pwr: mimo2 max power in 1/2 dBm
151 * @mimo3_max_pwr: mimo3 max power in 1/2 dBm
152 *
153 */
154struct iwl_eeprom_enhanced_txpwr {
e7362a00
JB
155 u8 flags;
156 u8 channel;
ab9fd1bf
WYG
157 s8 chain_a_max;
158 s8 chain_b_max;
159 s8 chain_c_max;
e7362a00 160 u8 delta_20_in_40;
ab9fd1bf
WYG
161 s8 mimo2_max;
162 s8 mimo3_max;
ba2d3587 163} __packed;
ab9fd1bf 164
8d8854d9 165/* calibration */
7d8f2d50
WYG
166struct iwl_eeprom_calib_hdr {
167 u8 version;
168 u8 pa_type;
169 __le16 voltage;
170} __packed;
171
7944f8e4
WYG
172#define EEPROM_CALIB_ALL (INDIRECT_ADDRESS | INDIRECT_CALIBRATION)
173#define EEPROM_XTAL ((2*0x128) | EEPROM_CALIB_ALL)
174
8d8854d9 175/* temperature */
c6f30347
WYG
176#define EEPROM_KELVIN_TEMPERATURE ((2*0x12A) | EEPROM_CALIB_ALL)
177#define EEPROM_RAW_TEMPERATURE ((2*0x12B) | EEPROM_CALIB_ALL)
178
7944f8e4
WYG
179
180/* agn links */
181#define EEPROM_LINK_HOST (2*0x64)
182#define EEPROM_LINK_GENERAL (2*0x65)
183#define EEPROM_LINK_REGULATORY (2*0x66)
184#define EEPROM_LINK_CALIBRATION (2*0x67)
185#define EEPROM_LINK_PROCESS_ADJST (2*0x68)
186#define EEPROM_LINK_OTHERS (2*0x69)
8d6748ca
JB
187#define EEPROM_LINK_TXP_LIMIT (2*0x6a)
188#define EEPROM_LINK_TXP_LIMIT_SIZE (2*0x6b)
7944f8e4
WYG
189
190/* agn regulatory - indirect access */
e04ed0a5 191#define EEPROM_REG_BAND_1_CHANNELS ((0x08)\
25ae3986 192 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 28 bytes */
e04ed0a5 193#define EEPROM_REG_BAND_2_CHANNELS ((0x26)\
25ae3986 194 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 26 bytes */
e04ed0a5 195#define EEPROM_REG_BAND_3_CHANNELS ((0x42)\
25ae3986 196 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 24 bytes */
e04ed0a5 197#define EEPROM_REG_BAND_4_CHANNELS ((0x5C)\
25ae3986 198 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 22 bytes */
e04ed0a5 199#define EEPROM_REG_BAND_5_CHANNELS ((0x74)\
25ae3986 200 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 12 bytes */
e04ed0a5 201#define EEPROM_REG_BAND_24_HT40_CHANNELS ((0x82)\
25ae3986 202 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 14 bytes */
e04ed0a5 203#define EEPROM_REG_BAND_52_HT40_CHANNELS ((0x92)\
25ae3986
TW
204 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 22 bytes */
205
f2fa1b01
SZ
206/* 6000 regulatory - indirect access */
207#define EEPROM_6000_REG_BAND_24_HT40_CHANNELS ((0x80)\
208 | INDIRECT_ADDRESS | INDIRECT_REGULATORY) /* 14 bytes */
209
109a0ac5
WYG
210/* 5000 Specific */
211#define EEPROM_5000_TX_POWER_VERSION (4)
212#define EEPROM_5000_EEPROM_VERSION (0x11A)
213
0ef2ca67
TW
214/* 5050 Specific */
215#define EEPROM_5050_TX_POWER_VERSION (4)
216#define EEPROM_5050_EEPROM_VERSION (0x21E)
25ae3986 217
1f4b9665 218/* 1000 Specific */
00e70590 219#define EEPROM_1000_TX_POWER_VERSION (4)
72f0ebd9 220#define EEPROM_1000_EEPROM_VERSION (0x15C)
1f4b9665 221
32b7e244 222/* 6x00 Specific */
00e70590 223#define EEPROM_6000_TX_POWER_VERSION (4)
3d7dc7e8 224#define EEPROM_6000_EEPROM_VERSION (0x423)
1f4b9665 225
32b7e244 226/* 6x50 Specific */
00e70590 227#define EEPROM_6050_TX_POWER_VERSION (4)
32b7e244
WYG
228#define EEPROM_6050_EEPROM_VERSION (0x532)
229
1956e1ad
WYG
230/* 6150 Specific */
231#define EEPROM_6150_TX_POWER_VERSION (6)
232#define EEPROM_6150_EEPROM_VERSION (0x553)
03264339 233
1956e1ad
WYG
234/* 6x05 Specific */
235#define EEPROM_6005_TX_POWER_VERSION (6)
236#define EEPROM_6005_EEPROM_VERSION (0x709)
237
238/* 6x30 Specific */
239#define EEPROM_6030_TX_POWER_VERSION (6)
240#define EEPROM_6030_EEPROM_VERSION (0x709)
4b3e8062 241
fa57980e
WYG
242/* 2x00 Specific */
243#define EEPROM_2000_TX_POWER_VERSION (6)
244#define EEPROM_2000_EEPROM_VERSION (0x805)
245
246/* 6x35 Specific */
247#define EEPROM_6035_TX_POWER_VERSION (6)
248#define EEPROM_6035_EEPROM_VERSION (0x753)
249
250
0848e297 251/* OTP */
415e4993
WYG
252/* lower blocks contain EEPROM image and calibration data */
253#define OTP_LOW_IMAGE_SIZE (2 * 512 * sizeof(u16)) /* 2 KB */
254/* high blocks contain PAPD data */
255#define OTP_HIGH_IMAGE_SIZE_6x00 (6 * 512 * sizeof(u16)) /* 6 KB */
256#define OTP_HIGH_IMAGE_SIZE_1000 (0x200 * sizeof(u16)) /* 1024 bytes */
257#define OTP_MAX_LL_ITEMS_1000 (3) /* OTP blocks for 1000 */
258#define OTP_MAX_LL_ITEMS_6x00 (4) /* OTP blocks for 6x00 */
259#define OTP_MAX_LL_ITEMS_6x50 (7) /* OTP blocks for 6x50 */
fa57980e 260#define OTP_MAX_LL_ITEMS_2x00 (4) /* OTP blocks for 2x00 */
0848e297 261
bf85ea4f
AK
262/* 2.4 GHz */
263extern const u8 iwl_eeprom_band_1[14];
34cf6ff6 264
073d3f5f
TW
265#define ADDRESS_MSK 0x0000FFFF
266#define INDIRECT_TYPE_MSK 0x000F0000
267#define INDIRECT_HOST 0x00010000
268#define INDIRECT_GENERAL 0x00020000
269#define INDIRECT_REGULATORY 0x00030000
270#define INDIRECT_CALIBRATION 0x00040000
271#define INDIRECT_PROCESS_ADJST 0x00050000
272#define INDIRECT_OTHERS 0x00060000
8d6748ca
JB
273#define INDIRECT_TXP_LIMIT 0x00070000
274#define INDIRECT_TXP_LIMIT_SIZE 0x00080000
073d3f5f
TW
275#define INDIRECT_ADDRESS 0x00100000
276
277/* General */
278#define EEPROM_DEVICE_ID (2*0x08) /* 2 bytes */
e1910cb3 279#define EEPROM_SUBSYSTEM_ID (2*0x0A) /* 2 bytes */
073d3f5f
TW
280#define EEPROM_MAC_ADDRESS (2*0x15) /* 6 bytes */
281#define EEPROM_BOARD_REVISION (2*0x35) /* 2 bytes */
282#define EEPROM_BOARD_PBA_NUMBER (2*0x3B+1) /* 9 bytes */
283#define EEPROM_VERSION (2*0x44) /* 2 bytes */
21a5b3c6 284#define EEPROM_SKU_CAP (2*0x45) /* 2 bytes */
073d3f5f 285#define EEPROM_OEM_MODE (2*0x46) /* 2 bytes */
694cc56d 286#define EEPROM_RADIO_CONFIG (2*0x48) /* 2 bytes */
c6fa17ed 287#define EEPROM_NUM_MAC_ADDRESS (2*0x4C) /* 2 bytes */
34cf6ff6 288
694cc56d
TW
289/* The following masks are to be applied on EEPROM_RADIO_CONFIG */
290#define EEPROM_RF_CFG_TYPE_MSK(x) (x & 0x3) /* bits 0-1 */
291#define EEPROM_RF_CFG_STEP_MSK(x) ((x >> 2) & 0x3) /* bits 2-3 */
292#define EEPROM_RF_CFG_DASH_MSK(x) ((x >> 4) & 0x3) /* bits 4-5 */
293#define EEPROM_RF_CFG_PNUM_MSK(x) ((x >> 6) & 0x3) /* bits 6-7 */
294#define EEPROM_RF_CFG_TX_ANT_MSK(x) ((x >> 8) & 0xF) /* bits 8-11 */
295#define EEPROM_RF_CFG_RX_ANT_MSK(x) ((x >> 12) & 0xF) /* bits 12-15 */
296
9371d4ed 297#define EEPROM_RF_CONFIG_TYPE_MAX 0x3
694cc56d 298
7aafef1c 299#define EEPROM_REGULATORY_BAND_NO_HT40 (0)
a89d03c4 300
34cf6ff6 301struct iwl_eeprom_ops {
073d3f5f 302 const u32 regulatory_bands[7];
ab9fd1bf 303 void (*update_enhanced_txpower) (struct iwl_priv *priv);
34cf6ff6
AK
304};
305
306
e98a1302 307int iwl_eeprom_init(struct iwl_priv *priv, u32 hw_rev);
073d3f5f 308void iwl_eeprom_free(struct iwl_priv *priv);
8614f360 309int iwl_eeprom_check_version(struct iwl_priv *priv);
21a5b3c6 310int iwl_eeprom_check_sku(struct iwl_priv *priv);
073d3f5f 311const u8 *iwl_eeprom_query_addr(const struct iwl_priv *priv, size_t offset);
3be63ff0 312u16 iwl_eeprom_query16(const struct iwl_priv *priv, size_t offset);
bf85ea4f
AK
313int iwl_init_channel_map(struct iwl_priv *priv);
314void iwl_free_channel_map(struct iwl_priv *priv);
8622e705 315const struct iwl_channel_info *iwl_get_channel_info(
bf85ea4f
AK
316 const struct iwl_priv *priv,
317 enum ieee80211_band band, u16 channel);
86cb3b4e 318void iwl_rf_config(struct iwl_priv *priv);
bf85ea4f 319
34cf6ff6 320#endif /* __iwl_eeprom_h__ */
This page took 0.747198 seconds and 5 git commands to generate.