1 /******************************************************************************
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.
8 * Copyright(c) 2008 - 2010 Intel Corporation. All rights reserved.
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.
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.
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,
24 * The full GNU General Public License is included in this distribution
25 * in the file called LICENSE.GPL.
27 * Contact Information:
28 * Intel Linux Wireless <ilw@linux.intel.com>
29 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
33 * Copyright(c) 2005 - 2010 Intel Corporation. All rights reserved.
34 * All rights reserved.
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
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
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.
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 *****************************************************************************/
64 #include <linux/kernel.h>
65 #include <linux/module.h>
66 #include <linux/slab.h>
67 #include <linux/init.h>
69 #include <net/mac80211.h>
71 #include "iwl-commands.h"
74 #include "iwl-debug.h"
78 /************************** EEPROM BANDS ****************************
80 * The iwl_eeprom_band definitions below provide the mapping from the
81 * EEPROM contents to the specific channel number supported for each
84 * For example, iwl_priv->eeprom.band_3_channels[4] from the band_3
85 * definition below maps to physical channel 42 in the 5.2GHz spectrum.
86 * The specific geography and calibration information for that channel
87 * is contained in the eeprom map itself.
89 * During init, we copy the eeprom information and channel map
90 * information into priv->channel_info_24/52 and priv->channel_map_24/52
92 * channel_map_24/52 provides the index in the channel_info array for a
93 * given channel. We have to have two separate maps as there is channel
94 * overlap with the 2.4GHz and 5.2GHz spectrum as seen in band_1 and
97 * A value of 0xff stored in the channel_map indicates that the channel
98 * is not supported by the hardware at all.
100 * A value of 0xfe in the channel_map indicates that the channel is not
101 * valid for Tx with the current hardware. This means that
102 * while the system can tune and receive on a given channel, it may not
103 * be able to associate or transmit any frames on that
104 * channel. There is no corresponding channel information for that
107 *********************************************************************/
110 * struct iwl_txpwr_section: eeprom section information
111 * @offset: indirect address into eeprom image
112 * @count: number of "struct iwl_eeprom_enhanced_txpwr" in this section
113 * @band: band type for the section
114 * @is_common - true: common section, false: channel section
115 * @is_cck - true: cck section, false: not cck section
116 * @is_ht_40 - true: all channel in the section are HT40 channel,
117 * false: legacy or HT 20 MHz
118 * ignore if it is common section
119 * @iwl_eeprom_section_channel: channel array in the section,
120 * ignore if common section
122 struct iwl_txpwr_section {
125 enum ieee80211_band band;
129 u8 iwl_eeprom_section_channel[EEPROM_MAX_TXPOWER_SECTION_ELEMENTS];
133 * section 1 - 3 are regulatory tx power apply to all channels based on
134 * modulation: CCK, OFDM
135 * Band: 2.4GHz, 5.2GHz
136 * section 4 - 10 are regulatory tx power apply to specified channels
138 * 1L - Channel 1 Legacy
140 * (1,+1) - Channel 1 HT40 "_above_"
142 * Section 1: all CCK channels
143 * Section 2: all 2.4 GHz OFDM (Legacy, HT and HT40) channels
144 * Section 3: all 5.2 GHz OFDM (Legacy, HT and HT40) channels
145 * Section 4: 2.4 GHz 20MHz channels: 1L, 1HT, 2L, 2HT, 10L, 10HT, 11L, 11HT
146 * Section 5: 2.4 GHz 40MHz channels: (1,+1) (2,+1) (6,+1) (7,+1) (9,+1)
147 * Section 6: 5.2 GHz 20MHz channels: 36L, 64L, 100L, 36HT, 64HT, 100HT
148 * Section 7: 5.2 GHz 40MHz channels: (36,+1) (60,+1) (100,+1)
149 * Section 8: 2.4 GHz channel: 13L, 13HT
150 * Section 9: 2.4 GHz channel: 140L, 140HT
151 * Section 10: 2.4 GHz 40MHz channels: (132,+1) (44,+1)
154 static const struct iwl_txpwr_section enhinfo[] = {
155 { EEPROM_LB_CCK_20_COMMON, 1, IEEE80211_BAND_2GHZ, true, true, false },
156 { EEPROM_LB_OFDM_COMMON, 3, IEEE80211_BAND_2GHZ, true, false, false },
157 { EEPROM_HB_OFDM_COMMON, 3, IEEE80211_BAND_5GHZ, true, false, false },
158 { EEPROM_LB_OFDM_20_BAND, 8, IEEE80211_BAND_2GHZ,
160 {1, 1, 2, 2, 10, 10, 11, 11 } },
161 { EEPROM_LB_OFDM_HT40_BAND, 5, IEEE80211_BAND_2GHZ,
164 { EEPROM_HB_OFDM_20_BAND, 6, IEEE80211_BAND_5GHZ,
166 { 36, 64, 100, 36, 64, 100 } },
167 { EEPROM_HB_OFDM_HT40_BAND, 3, IEEE80211_BAND_5GHZ,
170 { EEPROM_LB_OFDM_20_CHANNEL_13, 2, IEEE80211_BAND_2GHZ,
173 { EEPROM_HB_OFDM_20_CHANNEL_140, 2, IEEE80211_BAND_5GHZ,
176 { EEPROM_HB_OFDM_HT40_BAND_1, 2, IEEE80211_BAND_5GHZ,
181 /******************************************************************************
183 * EEPROM related functions
185 ******************************************************************************/
188 * The device's EEPROM semaphore prevents conflicts between driver and uCode
189 * when accessing the EEPROM; each access is a series of pulses to/from the
190 * EEPROM chip, not a single event, so even reads could conflict if they
191 * weren't arbitrated by the semaphore.
193 int iwlcore_eeprom_acquire_semaphore(struct iwl_priv *priv)
198 for (count = 0; count < EEPROM_SEM_RETRY_LIMIT; count++) {
199 /* Request semaphore */
200 iwl_set_bit(priv, CSR_HW_IF_CONFIG_REG,
201 CSR_HW_IF_CONFIG_REG_BIT_EEPROM_OWN_SEM);
203 /* See if we got it */
204 ret = iwl_poll_bit(priv, CSR_HW_IF_CONFIG_REG,
205 CSR_HW_IF_CONFIG_REG_BIT_EEPROM_OWN_SEM,
206 CSR_HW_IF_CONFIG_REG_BIT_EEPROM_OWN_SEM,
210 "Acquired semaphore after %d tries.\n",
219 void iwlcore_eeprom_release_semaphore(struct iwl_priv *priv)
221 iwl_clear_bit(priv, CSR_HW_IF_CONFIG_REG,
222 CSR_HW_IF_CONFIG_REG_BIT_EEPROM_OWN_SEM);
226 int iwl_eeprom_check_version(struct iwl_priv *priv)
231 eeprom_ver = iwl_eeprom_query16(priv, EEPROM_VERSION);
232 calib_ver = priv->cfg->ops->lib->eeprom_ops.calib_version(priv);
234 if (eeprom_ver < priv->cfg->eeprom_ver ||
235 calib_ver < priv->cfg->eeprom_calib_ver)
238 IWL_INFO(priv, "device EEPROM VER=0x%x, CALIB=0x%x\n",
239 eeprom_ver, calib_ver);
243 IWL_ERR(priv, "Unsupported (too old) EEPROM VER=0x%x < 0x%x "
244 "CALIB=0x%x < 0x%x\n",
245 eeprom_ver, priv->cfg->eeprom_ver,
246 calib_ver, priv->cfg->eeprom_calib_ver);
251 int iwl_eeprom_check_sku(struct iwl_priv *priv)
256 eeprom_sku = iwl_eeprom_query16(priv, EEPROM_SKU_CAP);
258 priv->cfg->sku = ((eeprom_sku & EEPROM_SKU_CAP_BAND_SELECTION) >>
259 EEPROM_SKU_CAP_BAND_POS);
260 if (eeprom_sku & EEPROM_SKU_CAP_11N_ENABLE)
261 priv->cfg->sku |= IWL_SKU_N;
263 if (!priv->cfg->sku) {
264 IWL_ERR(priv, "Invalid device sku\n");
268 IWL_INFO(priv, "Device SKU: 0X%x\n", priv->cfg->sku);
270 if (!priv->cfg->valid_tx_ant && !priv->cfg->valid_rx_ant) {
271 /* not using .cfg overwrite */
272 radio_cfg = iwl_eeprom_query16(priv, EEPROM_RADIO_CONFIG);
273 priv->cfg->valid_tx_ant = EEPROM_RF_CFG_TX_ANT_MSK(radio_cfg);
274 priv->cfg->valid_rx_ant = EEPROM_RF_CFG_TX_ANT_MSK(radio_cfg);
275 if (!priv->cfg->valid_tx_ant || !priv->cfg->valid_rx_ant) {
276 IWL_ERR(priv, "Invalid chain (0X%x, 0X%x)\n",
277 priv->cfg->valid_tx_ant,
278 priv->cfg->valid_rx_ant);
281 IWL_INFO(priv, "Valid Tx ant: 0X%x, Valid Rx ant: 0X%x\n",
282 priv->cfg->valid_tx_ant, priv->cfg->valid_rx_ant);
285 * for some special cases,
286 * EEPROM did not reflect the correct antenna setting
287 * so overwrite the valid tx/rx antenna from .cfg
292 void iwl_eeprom_get_mac(const struct iwl_priv *priv, u8 *mac)
294 const u8 *addr = priv->cfg->ops->lib->eeprom_ops.query_addr(priv,
296 memcpy(mac, addr, ETH_ALEN);
300 * iwl_get_max_txpower_avg - get the highest tx power from all chains.
301 * find the highest tx power from all chains for the channel
303 static s8 iwl_get_max_txpower_avg(struct iwl_priv *priv,
304 struct iwl_eeprom_enhanced_txpwr *enhanced_txpower,
305 int element, s8 *max_txpower_in_half_dbm)
307 s8 max_txpower_avg = 0; /* (dBm) */
309 IWL_DEBUG_INFO(priv, "%d - "
310 "chain_a: %d dB chain_b: %d dB "
311 "chain_c: %d dB mimo2: %d dB mimo3: %d dB\n",
313 enhanced_txpower[element].chain_a_max >> 1,
314 enhanced_txpower[element].chain_b_max >> 1,
315 enhanced_txpower[element].chain_c_max >> 1,
316 enhanced_txpower[element].mimo2_max >> 1,
317 enhanced_txpower[element].mimo3_max >> 1);
318 /* Take the highest tx power from any valid chains */
319 if ((priv->cfg->valid_tx_ant & ANT_A) &&
320 (enhanced_txpower[element].chain_a_max > max_txpower_avg))
321 max_txpower_avg = enhanced_txpower[element].chain_a_max;
322 if ((priv->cfg->valid_tx_ant & ANT_B) &&
323 (enhanced_txpower[element].chain_b_max > max_txpower_avg))
324 max_txpower_avg = enhanced_txpower[element].chain_b_max;
325 if ((priv->cfg->valid_tx_ant & ANT_C) &&
326 (enhanced_txpower[element].chain_c_max > max_txpower_avg))
327 max_txpower_avg = enhanced_txpower[element].chain_c_max;
328 if (((priv->cfg->valid_tx_ant == ANT_AB) |
329 (priv->cfg->valid_tx_ant == ANT_BC) |
330 (priv->cfg->valid_tx_ant == ANT_AC)) &&
331 (enhanced_txpower[element].mimo2_max > max_txpower_avg))
332 max_txpower_avg = enhanced_txpower[element].mimo2_max;
333 if ((priv->cfg->valid_tx_ant == ANT_ABC) &&
334 (enhanced_txpower[element].mimo3_max > max_txpower_avg))
335 max_txpower_avg = enhanced_txpower[element].mimo3_max;
338 * max. tx power in EEPROM is in 1/2 dBm format
339 * convert from 1/2 dBm to dBm (round-up convert)
340 * but we also do not want to loss 1/2 dBm resolution which
341 * will impact performance
343 *max_txpower_in_half_dbm = max_txpower_avg;
344 return (max_txpower_avg & 0x01) + (max_txpower_avg >> 1);
348 * iwl_update_common_txpower: update channel tx power
349 * update tx power per band based on EEPROM enhanced tx power info.
351 static s8 iwl_update_common_txpower(struct iwl_priv *priv,
352 struct iwl_eeprom_enhanced_txpwr *enhanced_txpower,
353 int section, int element, s8 *max_txpower_in_half_dbm)
355 struct iwl_channel_info *ch_info;
357 bool is_ht40 = false;
358 s8 max_txpower_avg; /* (dBm) */
360 /* it is common section, contain all type (Legacy, HT and HT40)
361 * based on the element in the section to determine
364 if (element == EEPROM_TXPOWER_COMMON_HT40_INDEX)
367 iwl_get_max_txpower_avg(priv, enhanced_txpower,
368 element, max_txpower_in_half_dbm);
370 ch_info = priv->channel_info;
372 for (ch = 0; ch < priv->channel_count; ch++) {
373 /* find matching band and update tx power if needed */
374 if ((ch_info->band == enhinfo[section].band) &&
375 (ch_info->max_power_avg < max_txpower_avg) &&
377 /* Update regulatory-based run-time data */
378 ch_info->max_power_avg = ch_info->curr_txpow =
380 ch_info->scan_power = max_txpower_avg;
382 if ((ch_info->band == enhinfo[section].band) && is_ht40 &&
383 (ch_info->ht40_max_power_avg < max_txpower_avg)) {
384 /* Update regulatory-based run-time data */
385 ch_info->ht40_max_power_avg = max_txpower_avg;
389 return max_txpower_avg;
393 * iwl_update_channel_txpower: update channel tx power
394 * update channel tx power based on EEPROM enhanced tx power info.
396 static s8 iwl_update_channel_txpower(struct iwl_priv *priv,
397 struct iwl_eeprom_enhanced_txpwr *enhanced_txpower,
398 int section, int element, s8 *max_txpower_in_half_dbm)
400 struct iwl_channel_info *ch_info;
403 s8 max_txpower_avg; /* (dBm) */
405 channel = enhinfo[section].iwl_eeprom_section_channel[element];
407 iwl_get_max_txpower_avg(priv, enhanced_txpower,
408 element, max_txpower_in_half_dbm);
410 ch_info = priv->channel_info;
411 for (ch = 0; ch < priv->channel_count; ch++) {
412 /* find matching channel and update tx power if needed */
413 if (ch_info->channel == channel) {
414 if ((ch_info->max_power_avg < max_txpower_avg) &&
415 (!enhinfo[section].is_ht40)) {
416 /* Update regulatory-based run-time data */
417 ch_info->max_power_avg = max_txpower_avg;
418 ch_info->curr_txpow = max_txpower_avg;
419 ch_info->scan_power = max_txpower_avg;
421 if ((enhinfo[section].is_ht40) &&
422 (ch_info->ht40_max_power_avg < max_txpower_avg)) {
423 /* Update regulatory-based run-time data */
424 ch_info->ht40_max_power_avg = max_txpower_avg;
430 return max_txpower_avg;
434 * iwlcore_eeprom_enhanced_txpower: process enhanced tx power info
436 void iwlcore_eeprom_enhanced_txpower(struct iwl_priv *priv)
438 int eeprom_section_count = 0;
439 int section, element;
440 struct iwl_eeprom_enhanced_txpwr *enhanced_txpower;
442 s8 max_txpower_avg; /* (dBm) */
443 s8 max_txpower_in_half_dbm; /* (half-dBm) */
445 /* Loop through all the sections
446 * adjust bands and channel's max tx power
447 * Set the tx_power_user_lmt to the highest power
448 * supported by any channels and chains
450 for (section = 0; section < ARRAY_SIZE(enhinfo); section++) {
451 eeprom_section_count = enhinfo[section].count;
452 offset = enhinfo[section].offset;
453 enhanced_txpower = (struct iwl_eeprom_enhanced_txpwr *)
454 iwl_eeprom_query_addr(priv, offset);
457 * check for valid entry -
458 * different version of EEPROM might contain different set
459 * of enhanced tx power table
460 * always check for valid entry before process
463 if (!enhanced_txpower->common || enhanced_txpower->reserved)
466 for (element = 0; element < eeprom_section_count; element++) {
467 if (enhinfo[section].is_common)
469 iwl_update_common_txpower(priv,
470 enhanced_txpower, section,
472 &max_txpower_in_half_dbm);
475 iwl_update_channel_txpower(priv,
476 enhanced_txpower, section,
478 &max_txpower_in_half_dbm);
480 /* Update the tx_power_user_lmt to the highest power
481 * supported by any channel */
482 if (max_txpower_avg > priv->tx_power_user_lmt)
483 priv->tx_power_user_lmt = max_txpower_avg;
486 * Update the tx_power_lmt_in_half_dbm to
487 * the highest power supported by any channel
489 if (max_txpower_in_half_dbm >
490 priv->tx_power_lmt_in_half_dbm)
491 priv->tx_power_lmt_in_half_dbm =
492 max_txpower_in_half_dbm;