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) 2012 - 2014 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 COPYING.
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) 2012 - 2014 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.
62 *****************************************************************************/
63 #include <linux/firmware.h>
64 #include "iwl-trans.h"
66 #include "iwl-eeprom-parse.h"
67 #include "iwl-eeprom-read.h"
68 #include "iwl-nvm-parse.h"
70 /* Default NVM size to read */
71 #define IWL_NVM_DEFAULT_CHUNK_SIZE (2*1024)
72 #define IWL_MAX_NVM_SECTION_SIZE 7000
74 #define NVM_WRITE_OPCODE 1
75 #define NVM_READ_OPCODE 0
78 * prepare the NVM host command w/ the pointers to the nvm buffer
81 static int iwl_nvm_write_chunk(struct iwl_mvm
*mvm
, u16 section
,
82 u16 offset
, u16 length
, const u8
*data
)
84 struct iwl_nvm_access_cmd nvm_access_cmd
= {
85 .offset
= cpu_to_le16(offset
),
86 .length
= cpu_to_le16(length
),
87 .type
= cpu_to_le16(section
),
88 .op_code
= NVM_WRITE_OPCODE
,
90 struct iwl_host_cmd cmd
= {
92 .len
= { sizeof(struct iwl_nvm_access_cmd
), length
},
93 .flags
= CMD_SYNC
| CMD_SEND_IN_RFKILL
,
94 .data
= { &nvm_access_cmd
, data
},
95 /* data may come from vmalloc, so use _DUP */
96 .dataflags
= { 0, IWL_HCMD_DFL_DUP
},
99 return iwl_mvm_send_cmd(mvm
, &cmd
);
102 static int iwl_nvm_read_chunk(struct iwl_mvm
*mvm
, u16 section
,
103 u16 offset
, u16 length
, u8
*data
)
105 struct iwl_nvm_access_cmd nvm_access_cmd
= {
106 .offset
= cpu_to_le16(offset
),
107 .length
= cpu_to_le16(length
),
108 .type
= cpu_to_le16(section
),
109 .op_code
= NVM_READ_OPCODE
,
111 struct iwl_nvm_access_resp
*nvm_resp
;
112 struct iwl_rx_packet
*pkt
;
113 struct iwl_host_cmd cmd
= {
114 .id
= NVM_ACCESS_CMD
,
115 .flags
= CMD_SYNC
| CMD_WANT_SKB
| CMD_SEND_IN_RFKILL
,
116 .data
= { &nvm_access_cmd
, },
118 int ret
, bytes_read
, offset_read
;
121 cmd
.len
[0] = sizeof(struct iwl_nvm_access_cmd
);
123 ret
= iwl_mvm_send_cmd(mvm
, &cmd
);
128 if (pkt
->hdr
.flags
& IWL_CMD_FAILED_MSK
) {
129 IWL_ERR(mvm
, "Bad return from NVM_ACCES_COMMAND (0x%08X)\n",
135 /* Extract NVM response */
136 nvm_resp
= (void *)pkt
->data
;
137 ret
= le16_to_cpu(nvm_resp
->status
);
138 bytes_read
= le16_to_cpu(nvm_resp
->length
);
139 offset_read
= le16_to_cpu(nvm_resp
->offset
);
140 resp_data
= nvm_resp
->data
;
143 "NVM access command failed with status %d (device: %s)\n",
144 ret
, mvm
->cfg
->name
);
149 if (offset_read
!= offset
) {
150 IWL_ERR(mvm
, "NVM ACCESS response with invalid offset %d\n",
156 /* Write data to NVM */
157 memcpy(data
+ offset
, resp_data
, bytes_read
);
165 static int iwl_nvm_write_section(struct iwl_mvm
*mvm
, u16 section
,
166 const u8
*data
, u16 length
)
170 /* copy data in chunks of 2k (and remainder if any) */
172 while (offset
< length
) {
175 chunk_size
= min(IWL_NVM_DEFAULT_CHUNK_SIZE
,
178 ret
= iwl_nvm_write_chunk(mvm
, section
, offset
,
179 chunk_size
, data
+ offset
);
183 offset
+= chunk_size
;
190 * Reads an NVM section completely.
191 * NICs prior to 7000 family doesn't have a real NVM, but just read
192 * section 0 which is the EEPROM. Because the EEPROM reading is unlimited
193 * by uCode, we need to manually check in this case that we don't
194 * overflow and try to read more than the EEPROM size.
195 * For 7000 family NICs, we supply the maximal size we can read, and
196 * the uCode fills the response with as much data as we can,
197 * without overflowing, so no check is needed.
199 static int iwl_nvm_read_section(struct iwl_mvm
*mvm
, u16 section
,
202 u16 length
, offset
= 0;
205 /* Set nvm section read length */
206 length
= IWL_NVM_DEFAULT_CHUNK_SIZE
;
210 /* Read the NVM until exhausted (reading less than requested) */
211 while (ret
== length
) {
212 ret
= iwl_nvm_read_chunk(mvm
, section
, offset
, length
, data
);
215 "Cannot read NVM from section %d offset %d, length %d\n",
216 section
, offset
, length
);
222 IWL_DEBUG_EEPROM(mvm
->trans
->dev
,
223 "NVM section %d read completed\n", section
);
227 static struct iwl_nvm_data
*
228 iwl_parse_nvm_sections(struct iwl_mvm
*mvm
)
230 struct iwl_nvm_section
*sections
= mvm
->nvm_sections
;
231 const __le16
*hw
, *sw
, *calib
, *regulatory
, *mac_override
;
233 /* Checking for required sections */
234 if (mvm
->trans
->cfg
->device_family
!= IWL_DEVICE_FAMILY_8000
) {
235 if (!mvm
->nvm_sections
[NVM_SECTION_TYPE_SW
].data
||
236 !mvm
->nvm_sections
[mvm
->cfg
->nvm_hw_section_num
].data
) {
237 IWL_ERR(mvm
, "Can't parse empty NVM sections\n");
241 if (!mvm
->nvm_sections
[NVM_SECTION_TYPE_SW
].data
||
242 !mvm
->nvm_sections
[NVM_SECTION_TYPE_MAC_OVERRIDE
].data
||
243 !mvm
->nvm_sections
[NVM_SECTION_TYPE_REGULATORY
].data
) {
245 "Can't parse empty family 8000 NVM sections\n");
250 if (WARN_ON(!mvm
->cfg
))
253 hw
= (const __le16
*)sections
[mvm
->cfg
->nvm_hw_section_num
].data
;
254 sw
= (const __le16
*)sections
[NVM_SECTION_TYPE_SW
].data
;
255 calib
= (const __le16
*)sections
[NVM_SECTION_TYPE_CALIBRATION
].data
;
256 regulatory
= (const __le16
*)sections
[NVM_SECTION_TYPE_REGULATORY
].data
;
258 (const __le16
*)sections
[NVM_SECTION_TYPE_MAC_OVERRIDE
].data
;
260 return iwl_parse_nvm_data(mvm
->trans
->dev
, mvm
->cfg
, hw
, sw
, calib
,
261 regulatory
, mac_override
,
262 mvm
->fw
->valid_tx_ant
,
263 mvm
->fw
->valid_rx_ant
);
266 #define MAX_NVM_FILE_LEN 16384
269 * Reads external NVM from a file into mvm->nvm_sections
271 * HOW TO CREATE THE NVM FILE FORMAT:
272 * ------------------------------
273 * 1. create hex file, format:
278 * rev - 6 bit (word1)
279 * len - 10 bit (word1)
281 * rsv - 12 bit (word2)
283 * 2. flip 8bits with 8 bits per line to get the right NVM file format
285 * 3. create binary file from the hex file
287 * 4. save as "iNVM_xxx.bin" under /lib/firmware
289 static int iwl_mvm_read_external_nvm(struct iwl_mvm
*mvm
)
291 int ret
, section_size
;
293 const struct firmware
*fw_entry
;
299 const u8
*eof
, *temp
;
301 #define NVM_WORD1_LEN(x) (8 * (x & 0x03FF))
302 #define NVM_WORD2_ID(x) (x >> 12)
303 #define NVM_WORD2_LEN_FAMILY_8000(x) (2 * ((x & 0xFF) << 8 | x >> 8))
304 #define NVM_WORD1_ID_FAMILY_8000(x) (x >> 4)
306 IWL_DEBUG_EEPROM(mvm
->trans
->dev
, "Read from external NVM\n");
309 * Obtain NVM image via request_firmware. Since we already used
310 * request_firmware_nowait() for the firmware binary load and only
311 * get here after that we assume the NVM request can be satisfied
314 ret
= request_firmware(&fw_entry
, iwlwifi_mod_params
.nvm_file
,
317 IWL_ERR(mvm
, "ERROR: %s isn't available %d\n",
318 iwlwifi_mod_params
.nvm_file
, ret
);
322 IWL_INFO(mvm
, "Loaded NVM file %s (%zu bytes)\n",
323 iwlwifi_mod_params
.nvm_file
, fw_entry
->size
);
325 if (fw_entry
->size
< sizeof(*file_sec
)) {
326 IWL_ERR(mvm
, "NVM file too small\n");
331 if (fw_entry
->size
> MAX_NVM_FILE_LEN
) {
332 IWL_ERR(mvm
, "NVM file too large\n");
337 eof
= fw_entry
->data
+ fw_entry
->size
;
339 file_sec
= (void *)fw_entry
->data
;
342 if (file_sec
->data
> eof
) {
344 "ERROR - NVM file too short for section header\n");
349 /* check for EOF marker */
350 if (!file_sec
->word1
&& !file_sec
->word2
) {
355 if (mvm
->trans
->cfg
->device_family
!= IWL_DEVICE_FAMILY_8000
) {
357 2 * NVM_WORD1_LEN(le16_to_cpu(file_sec
->word1
));
358 section_id
= NVM_WORD2_ID(le16_to_cpu(file_sec
->word2
));
360 section_size
= 2 * NVM_WORD2_LEN_FAMILY_8000(
361 le16_to_cpu(file_sec
->word2
));
362 section_id
= NVM_WORD1_ID_FAMILY_8000(
363 le16_to_cpu(file_sec
->word1
));
366 if (section_size
> IWL_MAX_NVM_SECTION_SIZE
) {
367 IWL_ERR(mvm
, "ERROR - section too large (%d)\n",
374 IWL_ERR(mvm
, "ERROR - section empty\n");
379 if (file_sec
->data
+ section_size
> eof
) {
381 "ERROR - NVM file too short for section (%d bytes)\n",
387 if (WARN(section_id
>= NVM_MAX_NUM_SECTIONS
,
388 "Invalid NVM section ID %d\n", section_id
)) {
393 temp
= kmemdup(file_sec
->data
, section_size
, GFP_KERNEL
);
398 mvm
->nvm_sections
[section_id
].data
= temp
;
399 mvm
->nvm_sections
[section_id
].length
= section_size
;
401 /* advance to the next section */
402 file_sec
= (void *)(file_sec
->data
+ section_size
);
405 release_firmware(fw_entry
);
409 /* Loads the NVM data stored in mvm->nvm_sections into the NIC */
410 int iwl_mvm_load_nvm_to_nic(struct iwl_mvm
*mvm
)
413 struct iwl_nvm_section
*sections
= mvm
->nvm_sections
;
415 IWL_DEBUG_EEPROM(mvm
->trans
->dev
, "'Write to NVM\n");
417 for (i
= 0; i
< ARRAY_SIZE(mvm
->nvm_sections
); i
++) {
418 if (!mvm
->nvm_sections
[i
].data
|| !mvm
->nvm_sections
[i
].length
)
420 ret
= iwl_nvm_write_section(mvm
, i
, sections
[i
].data
,
423 IWL_ERR(mvm
, "iwl_mvm_send_cmd failed: %d\n", ret
);
430 int iwl_nvm_init(struct iwl_mvm
*mvm
, bool read_nvm_from_nic
)
433 u8
*nvm_buffer
, *temp
;
434 int nvm_to_read
[NVM_MAX_NUM_SECTIONS
];
435 int num_of_sections_to_read
;
437 if (WARN_ON_ONCE(mvm
->cfg
->nvm_hw_section_num
>= NVM_MAX_NUM_SECTIONS
))
440 /* load external NVM if configured */
441 if (iwlwifi_mod_params
.nvm_file
) {
442 /* move to External NVM flow */
443 ret
= iwl_mvm_read_external_nvm(mvm
);
448 if (read_nvm_from_nic
) {
449 /* list of NVM sections we are allowed/need to read */
450 if (mvm
->trans
->cfg
->device_family
!= IWL_DEVICE_FAMILY_8000
) {
451 nvm_to_read
[0] = mvm
->cfg
->nvm_hw_section_num
;
452 nvm_to_read
[1] = NVM_SECTION_TYPE_SW
;
453 nvm_to_read
[2] = NVM_SECTION_TYPE_CALIBRATION
;
454 nvm_to_read
[3] = NVM_SECTION_TYPE_PRODUCTION
;
455 num_of_sections_to_read
= 4;
457 nvm_to_read
[0] = NVM_SECTION_TYPE_SW
;
458 nvm_to_read
[1] = NVM_SECTION_TYPE_CALIBRATION
;
459 nvm_to_read
[2] = NVM_SECTION_TYPE_PRODUCTION
;
460 nvm_to_read
[3] = NVM_SECTION_TYPE_REGULATORY
;
461 nvm_to_read
[4] = NVM_SECTION_TYPE_MAC_OVERRIDE
;
462 num_of_sections_to_read
= 5;
465 /* Read From FW NVM */
466 IWL_DEBUG_EEPROM(mvm
->trans
->dev
, "Read from NVM\n");
468 nvm_buffer
= kmalloc(mvm
->cfg
->base_params
->eeprom_size
,
472 for (i
= 0; i
< num_of_sections_to_read
; i
++) {
473 section
= nvm_to_read
[i
];
474 /* we override the constness for initial read */
475 ret
= iwl_nvm_read_section(mvm
, section
, nvm_buffer
);
478 temp
= kmemdup(nvm_buffer
, ret
, GFP_KERNEL
);
483 mvm
->nvm_sections
[section
].data
= temp
;
484 mvm
->nvm_sections
[section
].length
= ret
;
486 #ifdef CONFIG_IWLWIFI_DEBUGFS
488 case NVM_SECTION_TYPE_SW
:
489 mvm
->nvm_sw_blob
.data
= temp
;
490 mvm
->nvm_sw_blob
.size
= ret
;
492 case NVM_SECTION_TYPE_CALIBRATION
:
493 mvm
->nvm_calib_blob
.data
= temp
;
494 mvm
->nvm_calib_blob
.size
= ret
;
496 case NVM_SECTION_TYPE_PRODUCTION
:
497 mvm
->nvm_prod_blob
.data
= temp
;
498 mvm
->nvm_prod_blob
.size
= ret
;
501 if (section
== mvm
->cfg
->nvm_hw_section_num
) {
502 mvm
->nvm_hw_blob
.data
= temp
;
503 mvm
->nvm_hw_blob
.size
= ret
;
506 WARN(1, "section: %d", section
);
515 mvm
->nvm_data
= iwl_parse_nvm_sections(mvm
);