LXR linux/drivers/net/wireless/iwlwifi/iwl-eeprom-parse.h

   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 *
   8 * Copyright(c) 2008 - 2013 Intel Corporation. All rights reserved.
   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 COPYING.
  26 *
  27 * Contact Information:
  28 *  Intel Linux Wireless <ilw@linux.intel.com>
  29 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
  30 *
  31 * BSD LICENSE
  32 *
  33 * Copyright(c) 2005 - 2013 Intel Corporation. All rights reserved.
  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#ifndef __iwl_eeprom_parse_h__
  63#define __iwl_eeprom_parse_h__
  64
  65#include <linux/types.h>
  66#include <linux/if_ether.h>
  67#include "iwl-trans.h"
  68
  69struct iwl_nvm_data {
  70        int n_hw_addrs;
  71        u8 hw_addr[ETH_ALEN];
  72
  73        u8 calib_version;
  74        __le16 calib_voltage;
  75
  76        __le16 raw_temperature;
  77        __le16 kelvin_temperature;
  78        __le16 kelvin_voltage;
  79        __le16 xtal_calib[2];
  80
  81        bool sku_cap_band_24GHz_enable;
  82        bool sku_cap_band_52GHz_enable;
  83        bool sku_cap_11n_enable;
  84        bool sku_cap_amt_enable;
  85        bool sku_cap_ipan_enable;
  86
  87        u8 radio_cfg_type;
  88        u8 radio_cfg_step;
  89        u8 radio_cfg_dash;
  90        u8 radio_cfg_pnum;
  91        u8 valid_tx_ant, valid_rx_ant;
  92
  93        u16 nvm_version;
  94        s8 max_tx_pwr_half_dbm;
  95
  96        struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
  97        struct ieee80211_channel channels[];
  98};
  99
 100/**
 101 * iwl_parse_eeprom_data - parse EEPROM data and return values
 102 *
 103 * @dev: device pointer we're parsing for, for debug only
 104 * @cfg: device configuration for parsing and overrides
 105 * @eeprom: the EEPROM data
 106 * @eeprom_size: length of the EEPROM data
 107 *
 108 * This function parses all EEPROM values we need and then
 109 * returns a (newly allocated) struct containing all the
 110 * relevant values for driver use. The struct must be freed
 111 * later with iwl_free_nvm_data().
 112 */
 113struct iwl_nvm_data *
 114iwl_parse_eeprom_data(struct device *dev, const struct iwl_cfg *cfg,
 115                      const u8 *eeprom, size_t eeprom_size);
 116
 117/**
 118 * iwl_free_nvm_data - free NVM data
 119 * @data: the data to free
 120 */
 121static inline void iwl_free_nvm_data(struct iwl_nvm_data *data)
 122{
 123        kfree(data);
 124}
 125
 126int iwl_nvm_check_version(struct iwl_nvm_data *data,
 127                          struct iwl_trans *trans);
 128
 129int iwl_init_sband_channels(struct iwl_nvm_data *data,
 130                            struct ieee80211_supported_band *sband,
 131                            int n_channels, enum ieee80211_band band);
 132
 133void iwl_init_ht_hw_capab(const struct iwl_cfg *cfg,
 134                          struct iwl_nvm_data *data,
 135                          struct ieee80211_sta_ht_cap *ht_info,
 136                          enum ieee80211_band band,
 137                          u8 tx_chains, u8 rx_chains);
 138
 139#endif /* __iwl_eeprom_parse_h__ */
 140