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