1 /*******************************************************************************
3 * Intel Ethernet Controller XL710 Family Linux Driver
4 * Copyright(c) 2013 - 2014 Intel Corporation.
6 * This program is free software; you can redistribute it and/or modify it
7 * under the terms and conditions of the GNU General Public License,
8 * version 2, as published by the Free Software Foundation.
10 * This program is distributed in the hope it will be useful, but WITHOUT
11 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
12 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
15 * You should have received a copy of the GNU General Public License along
16 * with this program. If not, see <http://www.gnu.org/licenses/>.
18 * The full GNU General Public License is included in this distribution in
19 * the file called "COPYING".
21 * Contact Information:
22 * e1000-devel Mailing List <e1000-devel@lists.sourceforge.net>
23 * Intel Corporation, 5200 N.E. Elam Young Parkway, Hillsboro, OR 97124-6497
25 ******************************************************************************/
27 #include "i40e_prototype.h"
30 * i40e_init_nvm_ops - Initialize NVM function pointers
31 * @hw: pointer to the HW structure
33 * Setup the function pointers and the NVM info structure. Should be called
34 * once per NVM initialization, e.g. inside the i40e_init_shared_code().
35 * Please notice that the NVM term is used here (& in all methods covered
36 * in this file) as an equivalent of the FLASH part mapped into the SR.
37 * We are accessing FLASH always thru the Shadow RAM.
39 i40e_status
i40e_init_nvm(struct i40e_hw
*hw
)
41 struct i40e_nvm_info
*nvm
= &hw
->nvm
;
42 i40e_status ret_code
= 0;
46 /* The SR size is stored regardless of the nvm programming mode
47 * as the blank mode may be used in the factory line.
49 gens
= rd32(hw
, I40E_GLNVM_GENS
);
50 sr_size
= ((gens
& I40E_GLNVM_GENS_SR_SIZE_MASK
) >>
51 I40E_GLNVM_GENS_SR_SIZE_SHIFT
);
52 /* Switching to words (sr_size contains power of 2KB) */
53 nvm
->sr_size
= (1 << sr_size
) * I40E_SR_WORDS_IN_1KB
;
55 /* Check if we are in the normal or blank NVM programming mode */
56 fla
= rd32(hw
, I40E_GLNVM_FLA
);
57 if (fla
& I40E_GLNVM_FLA_LOCKED_MASK
) { /* Normal programming mode */
59 nvm
->timeout
= I40E_MAX_NVM_TIMEOUT
;
60 nvm
->blank_nvm_mode
= false;
61 } else { /* Blank programming mode */
62 nvm
->blank_nvm_mode
= true;
63 ret_code
= I40E_ERR_NVM_BLANK_MODE
;
64 i40e_debug(hw
, I40E_DEBUG_NVM
, "NVM init error: unsupported blank mode.\n");
71 * i40e_acquire_nvm - Generic request for acquiring the NVM ownership
72 * @hw: pointer to the HW structure
73 * @access: NVM access type (read or write)
75 * This function will request NVM ownership for reading
76 * via the proper Admin Command.
78 i40e_status
i40e_acquire_nvm(struct i40e_hw
*hw
,
79 enum i40e_aq_resource_access_type access
)
81 i40e_status ret_code
= 0;
85 if (hw
->nvm
.blank_nvm_mode
)
86 goto i40e_i40e_acquire_nvm_exit
;
88 ret_code
= i40e_aq_request_resource(hw
, I40E_NVM_RESOURCE_ID
, access
,
90 /* Reading the Global Device Timer */
91 gtime
= rd32(hw
, I40E_GLVFGEN_TIMER
);
93 /* Store the timeout */
94 hw
->nvm
.hw_semaphore_timeout
= I40E_MS_TO_GTIME(time_left
) + gtime
;
97 i40e_debug(hw
, I40E_DEBUG_NVM
,
98 "NVM acquire type %d failed time_left=%llu ret=%d aq_err=%d\n",
99 access
, time_left
, ret_code
, hw
->aq
.asq_last_status
);
101 if (ret_code
&& time_left
) {
102 /* Poll until the current NVM owner timeouts */
103 timeout
= I40E_MS_TO_GTIME(I40E_MAX_NVM_TIMEOUT
) + gtime
;
104 while ((gtime
< timeout
) && time_left
) {
105 usleep_range(10000, 20000);
106 gtime
= rd32(hw
, I40E_GLVFGEN_TIMER
);
107 ret_code
= i40e_aq_request_resource(hw
,
108 I40E_NVM_RESOURCE_ID
,
109 access
, 0, &time_left
,
112 hw
->nvm
.hw_semaphore_timeout
=
113 I40E_MS_TO_GTIME(time_left
) + gtime
;
118 hw
->nvm
.hw_semaphore_timeout
= 0;
119 i40e_debug(hw
, I40E_DEBUG_NVM
,
120 "NVM acquire timed out, wait %llu ms before trying again. status=%d aq_err=%d\n",
121 time_left
, ret_code
, hw
->aq
.asq_last_status
);
125 i40e_i40e_acquire_nvm_exit
:
130 * i40e_release_nvm - Generic request for releasing the NVM ownership
131 * @hw: pointer to the HW structure
133 * This function will release NVM resource via the proper Admin Command.
135 void i40e_release_nvm(struct i40e_hw
*hw
)
137 if (!hw
->nvm
.blank_nvm_mode
)
138 i40e_aq_release_resource(hw
, I40E_NVM_RESOURCE_ID
, 0, NULL
);
142 * i40e_poll_sr_srctl_done_bit - Polls the GLNVM_SRCTL done bit
143 * @hw: pointer to the HW structure
145 * Polls the SRCTL Shadow RAM register done bit.
147 static i40e_status
i40e_poll_sr_srctl_done_bit(struct i40e_hw
*hw
)
149 i40e_status ret_code
= I40E_ERR_TIMEOUT
;
152 /* Poll the I40E_GLNVM_SRCTL until the done bit is set */
153 for (wait_cnt
= 0; wait_cnt
< I40E_SRRD_SRCTL_ATTEMPTS
; wait_cnt
++) {
154 srctl
= rd32(hw
, I40E_GLNVM_SRCTL
);
155 if (srctl
& I40E_GLNVM_SRCTL_DONE_MASK
) {
161 if (ret_code
== I40E_ERR_TIMEOUT
)
162 i40e_debug(hw
, I40E_DEBUG_NVM
, "Done bit in GLNVM_SRCTL not set");
167 * i40e_read_nvm_word_srctl - Reads Shadow RAM via SRCTL register
168 * @hw: pointer to the HW structure
169 * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF)
170 * @data: word read from the Shadow RAM
172 * Reads one 16 bit word from the Shadow RAM using the GLNVM_SRCTL register.
174 static i40e_status
i40e_read_nvm_word_srctl(struct i40e_hw
*hw
, u16 offset
,
177 i40e_status ret_code
= I40E_ERR_TIMEOUT
;
180 if (offset
>= hw
->nvm
.sr_size
) {
181 i40e_debug(hw
, I40E_DEBUG_NVM
,
182 "NVM read error: offset %d beyond Shadow RAM limit %d\n",
183 offset
, hw
->nvm
.sr_size
);
184 ret_code
= I40E_ERR_PARAM
;
188 /* Poll the done bit first */
189 ret_code
= i40e_poll_sr_srctl_done_bit(hw
);
191 /* Write the address and start reading */
192 sr_reg
= (u32
)(offset
<< I40E_GLNVM_SRCTL_ADDR_SHIFT
) |
193 (1 << I40E_GLNVM_SRCTL_START_SHIFT
);
194 wr32(hw
, I40E_GLNVM_SRCTL
, sr_reg
);
196 /* Poll I40E_GLNVM_SRCTL until the done bit is set */
197 ret_code
= i40e_poll_sr_srctl_done_bit(hw
);
199 sr_reg
= rd32(hw
, I40E_GLNVM_SRDATA
);
200 *data
= (u16
)((sr_reg
&
201 I40E_GLNVM_SRDATA_RDDATA_MASK
)
202 >> I40E_GLNVM_SRDATA_RDDATA_SHIFT
);
203 *data
= le16_to_cpu(*data
);
207 i40e_debug(hw
, I40E_DEBUG_NVM
,
208 "NVM read error: Couldn't access Shadow RAM address: 0x%x\n",
216 * i40e_read_nvm_word - Reads Shadow RAM
217 * @hw: pointer to the HW structure
218 * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF)
219 * @data: word read from the Shadow RAM
221 * Reads one 16 bit word from the Shadow RAM using the GLNVM_SRCTL register.
223 i40e_status
i40e_read_nvm_word(struct i40e_hw
*hw
, u16 offset
,
226 return i40e_read_nvm_word_srctl(hw
, offset
, data
);
230 * i40e_read_nvm_buffer_srctl - Reads Shadow RAM buffer via SRCTL register
231 * @hw: pointer to the HW structure
232 * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF).
233 * @words: (in) number of words to read; (out) number of words actually read
234 * @data: words read from the Shadow RAM
236 * Reads 16 bit words (data buffer) from the SR using the i40e_read_nvm_srrd()
237 * method. The buffer read is preceded by the NVM ownership take
238 * and followed by the release.
240 static i40e_status
i40e_read_nvm_buffer_srctl(struct i40e_hw
*hw
, u16 offset
,
241 u16
*words
, u16
*data
)
243 i40e_status ret_code
= 0;
246 /* Loop thru the selected region */
247 for (word
= 0; word
< *words
; word
++) {
248 index
= offset
+ word
;
249 ret_code
= i40e_read_nvm_word_srctl(hw
, index
, &data
[word
]);
254 /* Update the number of words read from the Shadow RAM */
261 * i40e_read_nvm_buffer - Reads Shadow RAM buffer
262 * @hw: pointer to the HW structure
263 * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF).
264 * @words: (in) number of words to read; (out) number of words actually read
265 * @data: words read from the Shadow RAM
267 * Reads 16 bit words (data buffer) from the SR using the i40e_read_nvm_srrd()
268 * method. The buffer read is preceded by the NVM ownership take
269 * and followed by the release.
271 i40e_status
i40e_read_nvm_buffer(struct i40e_hw
*hw
, u16 offset
,
272 u16
*words
, u16
*data
)
274 return i40e_read_nvm_buffer_srctl(hw
, offset
, words
, data
);
278 * i40e_write_nvm_aq - Writes Shadow RAM.
279 * @hw: pointer to the HW structure.
280 * @module_pointer: module pointer location in words from the NVM beginning
281 * @offset: offset in words from module start
282 * @words: number of words to write
283 * @data: buffer with words to write to the Shadow RAM
284 * @last_command: tells the AdminQ that this is the last command
286 * Writes a 16 bit words buffer to the Shadow RAM using the admin command.
288 static i40e_status
i40e_write_nvm_aq(struct i40e_hw
*hw
, u8 module_pointer
,
289 u32 offset
, u16 words
, void *data
,
292 i40e_status ret_code
= I40E_ERR_NVM
;
294 /* Here we are checking the SR limit only for the flat memory model.
295 * We cannot do it for the module-based model, as we did not acquire
296 * the NVM resource yet (we cannot get the module pointer value).
297 * Firmware will check the module-based model.
299 if ((offset
+ words
) > hw
->nvm
.sr_size
)
300 i40e_debug(hw
, I40E_DEBUG_NVM
,
301 "NVM write error: offset %d beyond Shadow RAM limit %d\n",
302 (offset
+ words
), hw
->nvm
.sr_size
);
303 else if (words
> I40E_SR_SECTOR_SIZE_IN_WORDS
)
304 /* We can write only up to 4KB (one sector), in one AQ write */
305 i40e_debug(hw
, I40E_DEBUG_NVM
,
306 "NVM write fail error: tried to write %d words, limit is %d.\n",
307 words
, I40E_SR_SECTOR_SIZE_IN_WORDS
);
308 else if (((offset
+ (words
- 1)) / I40E_SR_SECTOR_SIZE_IN_WORDS
)
309 != (offset
/ I40E_SR_SECTOR_SIZE_IN_WORDS
))
310 /* A single write cannot spread over two sectors */
311 i40e_debug(hw
, I40E_DEBUG_NVM
,
312 "NVM write error: cannot spread over two sectors in a single write offset=%d words=%d\n",
315 ret_code
= i40e_aq_update_nvm(hw
, module_pointer
,
316 2 * offset
, /*bytes*/
318 data
, last_command
, NULL
);
324 * i40e_calc_nvm_checksum - Calculates and returns the checksum
325 * @hw: pointer to hardware structure
326 * @checksum: pointer to the checksum
328 * This function calculates SW Checksum that covers the whole 64kB shadow RAM
329 * except the VPD and PCIe ALT Auto-load modules. The structure and size of VPD
330 * is customer specific and unknown. Therefore, this function skips all maximum
331 * possible size of VPD (1kB).
333 static i40e_status
i40e_calc_nvm_checksum(struct i40e_hw
*hw
,
336 i40e_status ret_code
= 0;
337 struct i40e_virt_mem vmem
;
338 u16 pcie_alt_module
= 0;
339 u16 checksum_local
= 0;
344 ret_code
= i40e_allocate_virt_mem(hw
, &vmem
,
345 I40E_SR_SECTOR_SIZE_IN_WORDS
* sizeof(u16
));
347 goto i40e_calc_nvm_checksum_exit
;
348 data
= (u16
*)vmem
.va
;
350 /* read pointer to VPD area */
351 ret_code
= i40e_read_nvm_word(hw
, I40E_SR_VPD_PTR
, &vpd_module
);
353 ret_code
= I40E_ERR_NVM_CHECKSUM
;
354 goto i40e_calc_nvm_checksum_exit
;
357 /* read pointer to PCIe Alt Auto-load module */
358 ret_code
= i40e_read_nvm_word(hw
, I40E_SR_PCIE_ALT_AUTO_LOAD_PTR
,
361 ret_code
= I40E_ERR_NVM_CHECKSUM
;
362 goto i40e_calc_nvm_checksum_exit
;
365 /* Calculate SW checksum that covers the whole 64kB shadow RAM
366 * except the VPD and PCIe ALT Auto-load modules
368 for (i
= 0; i
< hw
->nvm
.sr_size
; i
++) {
370 if ((i
% I40E_SR_SECTOR_SIZE_IN_WORDS
) == 0) {
371 u16 words
= I40E_SR_SECTOR_SIZE_IN_WORDS
;
373 ret_code
= i40e_read_nvm_buffer(hw
, i
, &words
, data
);
375 ret_code
= I40E_ERR_NVM_CHECKSUM
;
376 goto i40e_calc_nvm_checksum_exit
;
380 /* Skip Checksum word */
381 if (i
== I40E_SR_SW_CHECKSUM_WORD
)
383 /* Skip VPD module (convert byte size to word count) */
384 if ((i
>= (u32
)vpd_module
) &&
385 (i
< ((u32
)vpd_module
+
386 (I40E_SR_VPD_MODULE_MAX_SIZE
/ 2)))) {
389 /* Skip PCIe ALT module (convert byte size to word count) */
390 if ((i
>= (u32
)pcie_alt_module
) &&
391 (i
< ((u32
)pcie_alt_module
+
392 (I40E_SR_PCIE_ALT_MODULE_MAX_SIZE
/ 2)))) {
396 checksum_local
+= data
[i
% I40E_SR_SECTOR_SIZE_IN_WORDS
];
399 *checksum
= (u16
)I40E_SR_SW_CHECKSUM_BASE
- checksum_local
;
401 i40e_calc_nvm_checksum_exit
:
402 i40e_free_virt_mem(hw
, &vmem
);
407 * i40e_update_nvm_checksum - Updates the NVM checksum
408 * @hw: pointer to hardware structure
410 * NVM ownership must be acquired before calling this function and released
411 * on ARQ completion event reception by caller.
412 * This function will commit SR to NVM.
414 i40e_status
i40e_update_nvm_checksum(struct i40e_hw
*hw
)
416 i40e_status ret_code
= 0;
419 ret_code
= i40e_calc_nvm_checksum(hw
, &checksum
);
421 ret_code
= i40e_write_nvm_aq(hw
, 0x00, I40E_SR_SW_CHECKSUM_WORD
,
428 * i40e_validate_nvm_checksum - Validate EEPROM checksum
429 * @hw: pointer to hardware structure
430 * @checksum: calculated checksum
432 * Performs checksum calculation and validates the NVM SW checksum. If the
433 * caller does not need checksum, the value can be NULL.
435 i40e_status
i40e_validate_nvm_checksum(struct i40e_hw
*hw
,
438 i40e_status ret_code
= 0;
440 u16 checksum_local
= 0;
442 ret_code
= i40e_calc_nvm_checksum(hw
, &checksum_local
);
444 goto i40e_validate_nvm_checksum_exit
;
446 /* Do not use i40e_read_nvm_word() because we do not want to take
447 * the synchronization semaphores twice here.
449 i40e_read_nvm_word(hw
, I40E_SR_SW_CHECKSUM_WORD
, &checksum_sr
);
451 /* Verify read checksum from EEPROM is the same as
452 * calculated checksum
454 if (checksum_local
!= checksum_sr
)
455 ret_code
= I40E_ERR_NVM_CHECKSUM
;
457 /* If the user cares, return the calculated checksum */
459 *checksum
= checksum_local
;
461 i40e_validate_nvm_checksum_exit
:
465 static i40e_status
i40e_nvmupd_state_init(struct i40e_hw
*hw
,
466 struct i40e_nvm_access
*cmd
,
467 u8
*bytes
, int *errno
);
468 static i40e_status
i40e_nvmupd_state_reading(struct i40e_hw
*hw
,
469 struct i40e_nvm_access
*cmd
,
470 u8
*bytes
, int *errno
);
471 static i40e_status
i40e_nvmupd_state_writing(struct i40e_hw
*hw
,
472 struct i40e_nvm_access
*cmd
,
473 u8
*bytes
, int *errno
);
474 static enum i40e_nvmupd_cmd
i40e_nvmupd_validate_command(struct i40e_hw
*hw
,
475 struct i40e_nvm_access
*cmd
,
477 static i40e_status
i40e_nvmupd_nvm_erase(struct i40e_hw
*hw
,
478 struct i40e_nvm_access
*cmd
,
480 static i40e_status
i40e_nvmupd_nvm_write(struct i40e_hw
*hw
,
481 struct i40e_nvm_access
*cmd
,
482 u8
*bytes
, int *errno
);
483 static i40e_status
i40e_nvmupd_nvm_read(struct i40e_hw
*hw
,
484 struct i40e_nvm_access
*cmd
,
485 u8
*bytes
, int *errno
);
486 static inline u8
i40e_nvmupd_get_module(u32 val
)
488 return (u8
)(val
& I40E_NVM_MOD_PNT_MASK
);
490 static inline u8
i40e_nvmupd_get_transaction(u32 val
)
492 return (u8
)((val
& I40E_NVM_TRANS_MASK
) >> I40E_NVM_TRANS_SHIFT
);
495 static char *i40e_nvm_update_state_str
[] = {
496 "I40E_NVMUPD_INVALID",
497 "I40E_NVMUPD_READ_CON",
498 "I40E_NVMUPD_READ_SNT",
499 "I40E_NVMUPD_READ_LCB",
500 "I40E_NVMUPD_READ_SA",
501 "I40E_NVMUPD_WRITE_ERA",
502 "I40E_NVMUPD_WRITE_CON",
503 "I40E_NVMUPD_WRITE_SNT",
504 "I40E_NVMUPD_WRITE_LCB",
505 "I40E_NVMUPD_WRITE_SA",
506 "I40E_NVMUPD_CSUM_CON",
507 "I40E_NVMUPD_CSUM_SA",
508 "I40E_NVMUPD_CSUM_LCB",
512 * i40e_nvmupd_command - Process an NVM update command
513 * @hw: pointer to hardware structure
514 * @cmd: pointer to nvm update command
515 * @bytes: pointer to the data buffer
516 * @errno: pointer to return error code
518 * Dispatches command depending on what update state is current
520 i40e_status
i40e_nvmupd_command(struct i40e_hw
*hw
,
521 struct i40e_nvm_access
*cmd
,
522 u8
*bytes
, int *errno
)
529 switch (hw
->nvmupd_state
) {
530 case I40E_NVMUPD_STATE_INIT
:
531 status
= i40e_nvmupd_state_init(hw
, cmd
, bytes
, errno
);
534 case I40E_NVMUPD_STATE_READING
:
535 status
= i40e_nvmupd_state_reading(hw
, cmd
, bytes
, errno
);
538 case I40E_NVMUPD_STATE_WRITING
:
539 status
= i40e_nvmupd_state_writing(hw
, cmd
, bytes
, errno
);
543 /* invalid state, should never happen */
544 i40e_debug(hw
, I40E_DEBUG_NVM
,
545 "NVMUPD: no such state %d\n", hw
->nvmupd_state
);
546 status
= I40E_NOT_SUPPORTED
;
554 * i40e_nvmupd_state_init - Handle NVM update state Init
555 * @hw: pointer to hardware structure
556 * @cmd: pointer to nvm update command buffer
557 * @bytes: pointer to the data buffer
558 * @errno: pointer to return error code
560 * Process legitimate commands of the Init state and conditionally set next
561 * state. Reject all other commands.
563 static i40e_status
i40e_nvmupd_state_init(struct i40e_hw
*hw
,
564 struct i40e_nvm_access
*cmd
,
565 u8
*bytes
, int *errno
)
567 i40e_status status
= 0;
568 enum i40e_nvmupd_cmd upd_cmd
;
570 upd_cmd
= i40e_nvmupd_validate_command(hw
, cmd
, errno
);
573 case I40E_NVMUPD_READ_SA
:
574 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_READ
);
576 *errno
= i40e_aq_rc_to_posix(status
,
577 hw
->aq
.asq_last_status
);
579 status
= i40e_nvmupd_nvm_read(hw
, cmd
, bytes
, errno
);
580 i40e_release_nvm(hw
);
584 case I40E_NVMUPD_READ_SNT
:
585 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_READ
);
587 *errno
= i40e_aq_rc_to_posix(status
,
588 hw
->aq
.asq_last_status
);
590 status
= i40e_nvmupd_nvm_read(hw
, cmd
, bytes
, errno
);
592 i40e_release_nvm(hw
);
594 hw
->nvmupd_state
= I40E_NVMUPD_STATE_READING
;
598 case I40E_NVMUPD_WRITE_ERA
:
599 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_WRITE
);
601 *errno
= i40e_aq_rc_to_posix(status
,
602 hw
->aq
.asq_last_status
);
604 status
= i40e_nvmupd_nvm_erase(hw
, cmd
, errno
);
606 i40e_release_nvm(hw
);
608 hw
->aq
.nvm_release_on_done
= true;
612 case I40E_NVMUPD_WRITE_SA
:
613 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_WRITE
);
615 *errno
= i40e_aq_rc_to_posix(status
,
616 hw
->aq
.asq_last_status
);
618 status
= i40e_nvmupd_nvm_write(hw
, cmd
, bytes
, errno
);
620 i40e_release_nvm(hw
);
622 hw
->aq
.nvm_release_on_done
= true;
626 case I40E_NVMUPD_WRITE_SNT
:
627 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_WRITE
);
629 *errno
= i40e_aq_rc_to_posix(status
,
630 hw
->aq
.asq_last_status
);
632 status
= i40e_nvmupd_nvm_write(hw
, cmd
, bytes
, errno
);
634 i40e_release_nvm(hw
);
636 hw
->nvmupd_state
= I40E_NVMUPD_STATE_WRITING
;
640 case I40E_NVMUPD_CSUM_SA
:
641 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_WRITE
);
643 *errno
= i40e_aq_rc_to_posix(status
,
644 hw
->aq
.asq_last_status
);
646 status
= i40e_update_nvm_checksum(hw
);
648 *errno
= hw
->aq
.asq_last_status
?
649 i40e_aq_rc_to_posix(status
,
650 hw
->aq
.asq_last_status
) :
652 i40e_release_nvm(hw
);
654 hw
->aq
.nvm_release_on_done
= true;
660 i40e_debug(hw
, I40E_DEBUG_NVM
,
661 "NVMUPD: bad cmd %s in init state\n",
662 i40e_nvm_update_state_str
[upd_cmd
]);
663 status
= I40E_ERR_NVM
;
671 * i40e_nvmupd_state_reading - Handle NVM update state Reading
672 * @hw: pointer to hardware structure
673 * @cmd: pointer to nvm update command buffer
674 * @bytes: pointer to the data buffer
675 * @errno: pointer to return error code
677 * NVM ownership is already held. Process legitimate commands and set any
678 * change in state; reject all other commands.
680 static i40e_status
i40e_nvmupd_state_reading(struct i40e_hw
*hw
,
681 struct i40e_nvm_access
*cmd
,
682 u8
*bytes
, int *errno
)
685 enum i40e_nvmupd_cmd upd_cmd
;
687 upd_cmd
= i40e_nvmupd_validate_command(hw
, cmd
, errno
);
690 case I40E_NVMUPD_READ_SA
:
691 case I40E_NVMUPD_READ_CON
:
692 status
= i40e_nvmupd_nvm_read(hw
, cmd
, bytes
, errno
);
695 case I40E_NVMUPD_READ_LCB
:
696 status
= i40e_nvmupd_nvm_read(hw
, cmd
, bytes
, errno
);
697 i40e_release_nvm(hw
);
698 hw
->nvmupd_state
= I40E_NVMUPD_STATE_INIT
;
702 i40e_debug(hw
, I40E_DEBUG_NVM
,
703 "NVMUPD: bad cmd %s in reading state.\n",
704 i40e_nvm_update_state_str
[upd_cmd
]);
705 status
= I40E_NOT_SUPPORTED
;
713 * i40e_nvmupd_state_writing - Handle NVM update state Writing
714 * @hw: pointer to hardware structure
715 * @cmd: pointer to nvm update command buffer
716 * @bytes: pointer to the data buffer
717 * @errno: pointer to return error code
719 * NVM ownership is already held. Process legitimate commands and set any
720 * change in state; reject all other commands
722 static i40e_status
i40e_nvmupd_state_writing(struct i40e_hw
*hw
,
723 struct i40e_nvm_access
*cmd
,
724 u8
*bytes
, int *errno
)
727 enum i40e_nvmupd_cmd upd_cmd
;
728 bool retry_attempt
= false;
730 upd_cmd
= i40e_nvmupd_validate_command(hw
, cmd
, errno
);
734 case I40E_NVMUPD_WRITE_CON
:
735 status
= i40e_nvmupd_nvm_write(hw
, cmd
, bytes
, errno
);
738 case I40E_NVMUPD_WRITE_LCB
:
739 status
= i40e_nvmupd_nvm_write(hw
, cmd
, bytes
, errno
);
741 hw
->aq
.nvm_release_on_done
= true;
742 hw
->nvmupd_state
= I40E_NVMUPD_STATE_INIT
;
745 case I40E_NVMUPD_CSUM_CON
:
746 status
= i40e_update_nvm_checksum(hw
);
748 *errno
= hw
->aq
.asq_last_status
?
749 i40e_aq_rc_to_posix(status
,
750 hw
->aq
.asq_last_status
) :
752 hw
->nvmupd_state
= I40E_NVMUPD_STATE_INIT
;
756 case I40E_NVMUPD_CSUM_LCB
:
757 status
= i40e_update_nvm_checksum(hw
);
759 *errno
= hw
->aq
.asq_last_status
?
760 i40e_aq_rc_to_posix(status
,
761 hw
->aq
.asq_last_status
) :
764 hw
->aq
.nvm_release_on_done
= true;
765 hw
->nvmupd_state
= I40E_NVMUPD_STATE_INIT
;
769 i40e_debug(hw
, I40E_DEBUG_NVM
,
770 "NVMUPD: bad cmd %s in writing state.\n",
771 i40e_nvm_update_state_str
[upd_cmd
]);
772 status
= I40E_NOT_SUPPORTED
;
777 /* In some circumstances, a multi-write transaction takes longer
778 * than the default 3 minute timeout on the write semaphore. If
779 * the write failed with an EBUSY status, this is likely the problem,
780 * so here we try to reacquire the semaphore then retry the write.
781 * We only do one retry, then give up.
783 if (status
&& (hw
->aq
.asq_last_status
== I40E_AQ_RC_EBUSY
) &&
785 i40e_status old_status
= status
;
786 u32 old_asq_status
= hw
->aq
.asq_last_status
;
789 gtime
= rd32(hw
, I40E_GLVFGEN_TIMER
);
790 if (gtime
>= hw
->nvm
.hw_semaphore_timeout
) {
791 i40e_debug(hw
, I40E_DEBUG_ALL
,
792 "NVMUPD: write semaphore expired (%d >= %lld), retrying\n",
793 gtime
, hw
->nvm
.hw_semaphore_timeout
);
794 i40e_release_nvm(hw
);
795 status
= i40e_acquire_nvm(hw
, I40E_RESOURCE_WRITE
);
797 i40e_debug(hw
, I40E_DEBUG_ALL
,
798 "NVMUPD: write semaphore reacquire failed aq_err = %d\n",
799 hw
->aq
.asq_last_status
);
801 hw
->aq
.asq_last_status
= old_asq_status
;
803 retry_attempt
= true;
813 * i40e_nvmupd_validate_command - Validate given command
814 * @hw: pointer to hardware structure
815 * @cmd: pointer to nvm update command buffer
816 * @errno: pointer to return error code
818 * Return one of the valid command types or I40E_NVMUPD_INVALID
820 static enum i40e_nvmupd_cmd
i40e_nvmupd_validate_command(struct i40e_hw
*hw
,
821 struct i40e_nvm_access
*cmd
,
824 enum i40e_nvmupd_cmd upd_cmd
;
825 u8 transaction
, module
;
827 /* anything that doesn't match a recognized case is an error */
828 upd_cmd
= I40E_NVMUPD_INVALID
;
830 transaction
= i40e_nvmupd_get_transaction(cmd
->config
);
831 module
= i40e_nvmupd_get_module(cmd
->config
);
833 /* limits on data size */
834 if ((cmd
->data_size
< 1) ||
835 (cmd
->data_size
> I40E_NVMUPD_MAX_DATA
)) {
836 i40e_debug(hw
, I40E_DEBUG_NVM
,
837 "i40e_nvmupd_validate_command data_size %d\n",
840 return I40E_NVMUPD_INVALID
;
843 switch (cmd
->command
) {
845 switch (transaction
) {
847 upd_cmd
= I40E_NVMUPD_READ_CON
;
850 upd_cmd
= I40E_NVMUPD_READ_SNT
;
853 upd_cmd
= I40E_NVMUPD_READ_LCB
;
856 upd_cmd
= I40E_NVMUPD_READ_SA
;
862 switch (transaction
) {
864 upd_cmd
= I40E_NVMUPD_WRITE_CON
;
867 upd_cmd
= I40E_NVMUPD_WRITE_SNT
;
870 upd_cmd
= I40E_NVMUPD_WRITE_LCB
;
873 upd_cmd
= I40E_NVMUPD_WRITE_SA
;
876 upd_cmd
= I40E_NVMUPD_WRITE_ERA
;
879 upd_cmd
= I40E_NVMUPD_CSUM_CON
;
881 case (I40E_NVM_CSUM
|I40E_NVM_SA
):
882 upd_cmd
= I40E_NVMUPD_CSUM_SA
;
884 case (I40E_NVM_CSUM
|I40E_NVM_LCB
):
885 upd_cmd
= I40E_NVMUPD_CSUM_LCB
;
890 i40e_debug(hw
, I40E_DEBUG_NVM
, "%s state %d nvm_release_on_hold %d\n",
891 i40e_nvm_update_state_str
[upd_cmd
],
893 hw
->aq
.nvm_release_on_done
);
895 if (upd_cmd
== I40E_NVMUPD_INVALID
) {
897 i40e_debug(hw
, I40E_DEBUG_NVM
,
898 "i40e_nvmupd_validate_command returns %d errno %d\n",
905 * i40e_nvmupd_nvm_read - Read NVM
906 * @hw: pointer to hardware structure
907 * @cmd: pointer to nvm update command buffer
908 * @bytes: pointer to the data buffer
909 * @errno: pointer to return error code
911 * cmd structure contains identifiers and data buffer
913 static i40e_status
i40e_nvmupd_nvm_read(struct i40e_hw
*hw
,
914 struct i40e_nvm_access
*cmd
,
915 u8
*bytes
, int *errno
)
918 u8 module
, transaction
;
921 transaction
= i40e_nvmupd_get_transaction(cmd
->config
);
922 module
= i40e_nvmupd_get_module(cmd
->config
);
923 last
= (transaction
== I40E_NVM_LCB
) || (transaction
== I40E_NVM_SA
);
925 status
= i40e_aq_read_nvm(hw
, module
, cmd
->offset
, (u16
)cmd
->data_size
,
928 i40e_debug(hw
, I40E_DEBUG_NVM
,
929 "i40e_nvmupd_nvm_read mod 0x%x off 0x%x len 0x%x\n",
930 module
, cmd
->offset
, cmd
->data_size
);
931 i40e_debug(hw
, I40E_DEBUG_NVM
,
932 "i40e_nvmupd_nvm_read status %d aq %d\n",
933 status
, hw
->aq
.asq_last_status
);
934 *errno
= i40e_aq_rc_to_posix(status
, hw
->aq
.asq_last_status
);
941 * i40e_nvmupd_nvm_erase - Erase an NVM module
942 * @hw: pointer to hardware structure
943 * @cmd: pointer to nvm update command buffer
944 * @errno: pointer to return error code
946 * module, offset, data_size and data are in cmd structure
948 static i40e_status
i40e_nvmupd_nvm_erase(struct i40e_hw
*hw
,
949 struct i40e_nvm_access
*cmd
,
952 i40e_status status
= 0;
953 u8 module
, transaction
;
956 transaction
= i40e_nvmupd_get_transaction(cmd
->config
);
957 module
= i40e_nvmupd_get_module(cmd
->config
);
958 last
= (transaction
& I40E_NVM_LCB
);
959 status
= i40e_aq_erase_nvm(hw
, module
, cmd
->offset
, (u16
)cmd
->data_size
,
962 i40e_debug(hw
, I40E_DEBUG_NVM
,
963 "i40e_nvmupd_nvm_erase mod 0x%x off 0x%x len 0x%x\n",
964 module
, cmd
->offset
, cmd
->data_size
);
965 i40e_debug(hw
, I40E_DEBUG_NVM
,
966 "i40e_nvmupd_nvm_erase status %d aq %d\n",
967 status
, hw
->aq
.asq_last_status
);
968 *errno
= i40e_aq_rc_to_posix(status
, hw
->aq
.asq_last_status
);
975 * i40e_nvmupd_nvm_write - Write NVM
976 * @hw: pointer to hardware structure
977 * @cmd: pointer to nvm update command buffer
978 * @bytes: pointer to the data buffer
979 * @errno: pointer to return error code
981 * module, offset, data_size and data are in cmd structure
983 static i40e_status
i40e_nvmupd_nvm_write(struct i40e_hw
*hw
,
984 struct i40e_nvm_access
*cmd
,
985 u8
*bytes
, int *errno
)
987 i40e_status status
= 0;
988 u8 module
, transaction
;
991 transaction
= i40e_nvmupd_get_transaction(cmd
->config
);
992 module
= i40e_nvmupd_get_module(cmd
->config
);
993 last
= (transaction
& I40E_NVM_LCB
);
995 status
= i40e_aq_update_nvm(hw
, module
, cmd
->offset
,
996 (u16
)cmd
->data_size
, bytes
, last
, NULL
);
998 i40e_debug(hw
, I40E_DEBUG_NVM
,
999 "i40e_nvmupd_nvm_write mod 0x%x off 0x%x len 0x%x\n",
1000 module
, cmd
->offset
, cmd
->data_size
);
1001 i40e_debug(hw
, I40E_DEBUG_NVM
,
1002 "i40e_nvmupd_nvm_write status %d aq %d\n",
1003 status
, hw
->aq
.asq_last_status
);
1004 *errno
= i40e_aq_rc_to_posix(status
, hw
->aq
.asq_last_status
);