[linux-2.6-block.git] / drivers / net / wireless / iwlwifi / iwl-eeprom-parse.h

/******************************************************************************
 *
 * This file is provided under a dual BSD/GPLv2 license.  When using or
 * redistributing this file, you may do so under either license.
 *
 * GPL LICENSE SUMMARY
 *
 * Copyright(c) 2008 - 2014 Intel Corporation. All rights reserved.
 * Copyright(c) 2015 Intel Mobile Communications GmbH
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of version 2 of the GNU General Public License as
 * published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
 * USA
 *
 * The full GNU General Public License is included in this distribution
 * in the file called COPYING.
 *
 * Contact Information:
 *  Intel Linux Wireless <ilw@linux.intel.com>
 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
 *
 * BSD LICENSE
 *
 * Copyright(c) 2005 - 2014 Intel Corporation. All rights reserved.
 * Copyright(c) 2015 Intel Mobile Communications GmbH
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *  * Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *  * Neither the name Intel Corporation nor the names of its
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *****************************************************************************/
#ifndef __iwl_eeprom_parse_h__
#define __iwl_eeprom_parse_h__

#include <linux/types.h>
#include <linux/if_ether.h>
#include "iwl-trans.h"

struct iwl_nvm_data {
	int n_hw_addrs;
	u8 hw_addr[ETH_ALEN];

	u8 calib_version;
	__le16 calib_voltage;

	__le16 raw_temperature;
	__le16 kelvin_temperature;
	__le16 kelvin_voltage;
	__le16 xtal_calib[2];

	bool sku_cap_band_24GHz_enable;
	bool sku_cap_band_52GHz_enable;
	bool sku_cap_11n_enable;
	bool sku_cap_11ac_enable;
	bool sku_cap_amt_enable;
	bool sku_cap_ipan_enable;
	bool sku_cap_mimo_disabled;

	u16 radio_cfg_type;
	u8 radio_cfg_step;
	u8 radio_cfg_dash;
	u8 radio_cfg_pnum;
	u8 valid_tx_ant, valid_rx_ant;

	u32 nvm_version;
	s8 max_tx_pwr_half_dbm;

	bool lar_enabled;
	struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
	struct ieee80211_channel channels[];
};

/**
 * iwl_parse_eeprom_data - parse EEPROM data and return values
 *
 * @dev: device pointer we're parsing for, for debug only
 * @cfg: device configuration for parsing and overrides
 * @eeprom: the EEPROM data
 * @eeprom_size: length of the EEPROM data
 *
 * This function parses all EEPROM values we need and then
 * returns a (newly allocated) struct containing all the
 * relevant values for driver use. The struct must be freed
 * later with iwl_free_nvm_data().
 */
struct iwl_nvm_data *
iwl_parse_eeprom_data(struct device *dev, const struct iwl_cfg *cfg,
		      const u8 *eeprom, size_t eeprom_size);

/**
 * iwl_free_nvm_data - free NVM data
 * @data: the data to free
 */
static inline void iwl_free_nvm_data(struct iwl_nvm_data *data)
{
	kfree(data);
}

int iwl_nvm_check_version(struct iwl_nvm_data *data,
			  struct iwl_trans *trans);

int iwl_init_sband_channels(struct iwl_nvm_data *data,
			    struct ieee80211_supported_band *sband,
			    int n_channels, enum ieee80211_band band);

void iwl_init_ht_hw_capab(const struct iwl_cfg *cfg,
			  struct iwl_nvm_data *data,
			  struct ieee80211_sta_ht_cap *ht_info,
			  enum ieee80211_band band,
			  u8 tx_chains, u8 rx_chains);

#endif /* __iwl_eeprom_parse_h__ */
Commit	Line	Data
26a7ca9a JB	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	*
51368bf7	8	* Copyright(c) 2008 - 2014 Intel Corporation. All rights reserved.
5f0d98f2	9	* Copyright(c) 2015 Intel Mobile Communications GmbH
26a7ca9a JB	10	*
	11	* This program is free software; you can redistribute it and/or modify
	12	* it under the terms of version 2 of the GNU General Public License as
	13	* published by the Free Software Foundation.
	14	*
	15	* This program is distributed in the hope that it will be useful, but
	16	* WITHOUT ANY WARRANTY; without even the implied warranty of
	17	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	18	* General Public License for more details.
	19	*
	20	* You should have received a copy of the GNU General Public License
	21	* along with this program; if not, write to the Free Software
	22	* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110,
	23	* USA
	24	*
	25	* The full GNU General Public License is included in this distribution
410dc5aa	26	* in the file called COPYING.
26a7ca9a JB	27	*
	28	* Contact Information:
	29	* Intel Linux Wireless <ilw@linux.intel.com>
	30	* Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
	31	*
	32	* BSD LICENSE
	33	*
51368bf7	34	* Copyright(c) 2005 - 2014 Intel Corporation. All rights reserved.
5f0d98f2	35	* Copyright(c) 2015 Intel Mobile Communications GmbH
26a7ca9a JB	36	* All rights reserved.
	37	*
	38	* Redistribution and use in source and binary forms, with or without
	39	* modification, are permitted provided that the following conditions
	40	* are met:
	41	*
	42	* * Redistributions of source code must retain the above copyright
	43	* notice, this list of conditions and the following disclaimer.
	44	* * Redistributions in binary form must reproduce the above copyright
	45	* notice, this list of conditions and the following disclaimer in
	46	* the documentation and/or other materials provided with the
	47	* distribution.
	48	* * Neither the name Intel Corporation nor the names of its
	49	* contributors may be used to endorse or promote products derived
	50	* from this software without specific prior written permission.
	51	*
	52	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
	53	* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
	54	* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
	55	* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
	56	* OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
	57	* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
	58	* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
	59	* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
	60	* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	61	* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
	62	* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
	63	*****************************************************************************/
	64	#ifndef __iwl_eeprom_parse_h__
	65	#define __iwl_eeprom_parse_h__
	66
	67	#include <linux/types.h>
	68	#include <linux/if_ether.h>
	69	#include "iwl-trans.h"
	70
b7998c8b	71	struct iwl_nvm_data {
26a7ca9a JB	72	int n_hw_addrs;
	73	u8 hw_addr[ETH_ALEN];
	74
26a7ca9a JB	75	u8 calib_version;
	76	__le16 calib_voltage;
	77
	78	__le16 raw_temperature;
	79	__le16 kelvin_temperature;
	80	__le16 kelvin_voltage;
	81	__le16 xtal_calib[2];
	82
b7998c8b EL	83	bool sku_cap_band_24GHz_enable;
	84	bool sku_cap_band_52GHz_enable;
	85	bool sku_cap_11n_enable;
77db0a3c	86	bool sku_cap_11ac_enable;
b7998c8b EL	87	bool sku_cap_amt_enable;
b7998c8b EL	88	bool sku_cap_ipan_enable;
5f0d98f2	89	bool sku_cap_mimo_disabled;
26a7ca9a	90
77db0a3c	91	u16 radio_cfg_type;
b7998c8b EL	92	u8 radio_cfg_step;
	93	u8 radio_cfg_dash;
	94	u8 radio_cfg_pnum;
26a7ca9a JB	95	u8 valid_tx_ant, valid_rx_ant;
26a7ca9a JB	96
77db0a3c	97	u32 nvm_version;
b7998c8b EL	98	s8 max_tx_pwr_half_dbm;
b7998c8b EL	99
d0d15197	100	bool lar_enabled;
26a7ca9a JB	101	struct ieee80211_supported_band bands[IEEE80211_NUM_BANDS];
	102	struct ieee80211_channel channels[];
	103	};
	104
	105	/**
	106	* iwl_parse_eeprom_data - parse EEPROM data and return values
	107	*
	108	* @dev: device pointer we're parsing for, for debug only
	109	* @cfg: device configuration for parsing and overrides
	110	* @eeprom: the EEPROM data
	111	* @eeprom_size: length of the EEPROM data
	112	*
	113	* This function parses all EEPROM values we need and then
	114	* returns a (newly allocated) struct containing all the
	115	* relevant values for driver use. The struct must be freed
b7998c8b	116	* later with iwl_free_nvm_data().
26a7ca9a	117	*/
b7998c8b	118	struct iwl_nvm_data *
26a7ca9a JB	119	iwl_parse_eeprom_data(struct device dev, const struct iwl_cfg cfg,
	120	const u8 *eeprom, size_t eeprom_size);
	121
	122	/**
b7998c8b	123	* iwl_free_nvm_data - free NVM data
26a7ca9a JB	124	* @data: the data to free
26a7ca9a JB	125	*/
b7998c8b	126	static inline void iwl_free_nvm_data(struct iwl_nvm_data *data)
26a7ca9a JB	127	{
	128	kfree(data);
	129	}
	130
b7998c8b EL	131	int iwl_nvm_check_version(struct iwl_nvm_data *data,
b7998c8b EL	132	struct iwl_trans *trans);
26a7ca9a	133
b1e1adfa JB	134	int iwl_init_sband_channels(struct iwl_nvm_data *data,
	135	struct ieee80211_supported_band *sband,
	136	int n_channels, enum ieee80211_band band);
	137
	138	void iwl_init_ht_hw_capab(const struct iwl_cfg *cfg,
	139	struct iwl_nvm_data *data,
	140	struct ieee80211_sta_ht_cap *ht_info,
9ce4fa72 EG	141	enum ieee80211_band band,
9ce4fa72 EG	142	u8 tx_chains, u8 rx_chains);
b1e1adfa	143
26a7ca9a	144	#endif /* __iwl_eeprom_parse_h__ */