10  * i40e_init_nvm - Initialize NVM function pointers
13  * Setup the function pointers and the NVM info structure. Should be called
14  * once per NVM initialization, e.g. inside the i40e_init_shared_code().
15  * Please notice that the NVM term is used here (& in all methods covered
21 	struct i40e_nvm_info *nvm = &hw->nvm;  in i40e_init_nvm()  local
26 	/* The SR size is stored regardless of the nvm programming mode  in i40e_init_nvm()
33 	nvm->sr_size = BIT(sr_size) * I40E_SR_WORDS_IN_1KB;  in i40e_init_nvm()
35 	/* Check if we are in the normal or blank NVM programming mode */  in i40e_init_nvm()
38 		/* Max NVM timeout */  in i40e_init_nvm()
39 		nvm->timeout = I40E_MAX_NVM_TIMEOUT;  in i40e_init_nvm()
40 		nvm->blank_nvm_mode = false;  in i40e_init_nvm()
42 		nvm->blank_nvm_mode = true;  in i40e_init_nvm()
44 		i40e_debug(hw, I40E_DEBUG_NVM, "NVM init error: unsupported blank mode.\n");  in i40e_init_nvm()
51  * i40e_acquire_nvm - Generic request for acquiring the NVM ownership
53  * @access: NVM access type (read or write)
55  * This function will request NVM ownership for reading
65 	if (hw->nvm.blank_nvm_mode)  in i40e_acquire_nvm()
74 	hw->nvm.hw_semaphore_timeout = I40E_MS_TO_GTIME(time_left) + gtime;  in i40e_acquire_nvm()
78 			   "NVM acquire type %d failed time_left=%llu ret=%d aq_err=%d\n",  in i40e_acquire_nvm()
82 		/* Poll until the current NVM owner timeouts */  in i40e_acquire_nvm()
92 				hw->nvm.hw_semaphore_timeout =  in i40e_acquire_nvm()
98 			hw->nvm.hw_semaphore_timeout = 0;  in i40e_acquire_nvm()
100 				   "NVM acquire timed out, wait %llu ms before trying again. status=%d aq_err=%d\n",  in i40e_acquire_nvm()
110  * i40e_release_nvm - Generic request for releasing the NVM ownership
113  * This function will release NVM resource via the proper Admin Command.
120 	if (hw->nvm.blank_nvm_mode)  in i40e_release_nvm()
177 	if (offset >= hw->nvm.sr_size) {  in i40e_read_nvm_word_srctl()
179 			   "NVM read error: offset %d beyond Shadow RAM limit %d\n",  in i40e_read_nvm_word_srctl()
180 			   offset, hw->nvm.sr_size);  in i40e_read_nvm_word_srctl()
204 			   "NVM read error: Couldn't access Shadow RAM address: 0x%x\n",  in i40e_read_nvm_word_srctl()
214  * @module_pointer: module pointer location in words from the NVM beginning
235 	 * the NVM resource yet (we cannot get the module pointer value).  in i40e_read_nvm_aq()
238 	if ((offset + words) > hw->nvm.sr_size)  in i40e_read_nvm_aq()
240 			   "NVM read error: offset %d beyond Shadow RAM limit %d\n",  in i40e_read_nvm_aq()
241 			   (offset + words), hw->nvm.sr_size);  in i40e_read_nvm_aq()
245 			   "NVM read fail error: tried to read %d words, limit is %d.\n",  in i40e_read_nvm_aq()
251 			   "NVM read error: cannot spread over two sectors in a single read offset=%d words=%d\n",  in i40e_read_nvm_aq()
282  * __i40e_read_nvm_word - Reads nvm word, assumes caller does the locking
289  * Do not use this function except in cases where the nvm lock is already
302  * i40e_read_nvm_word - Reads nvm word and acquire lock if necessary
328  * i40e_read_nvm_module_data - Reads NVM Buffer to specified memory location
330  * @module_ptr: Pointer to module in words with respect to NVM beginning
333  * @words_data_size: Words to read from NVM
352 				   "Reading nvm word failed.Error code: %d.\n",  in i40e_read_nvm_module_data()
371 			   "Reading nvm data failed. Pointer points outside of the Shared RAM mapped area.\n");  in i40e_read_nvm_module_data()
381 				   "Reading nvm word failed.Error code: %d.\n",  in i40e_read_nvm_module_data()
393 				   "Reading nvm buffer failed.Error code: %d.\n",  in i40e_read_nvm_module_data()
409  * method. The buffer read is preceded by the NVM ownership take
440  * method. The buffer read is preceded by the NVM ownership take
490  * __i40e_read_nvm_buffer - Reads nvm buffer, caller must acquire lock
517  * method. The buffer read is preceded by the NVM ownership take
542  * @module_pointer: module pointer location in words from the NVM beginning
562 	 * the NVM resource yet (we cannot get the module pointer value).  in i40e_write_nvm_aq()
565 	if ((offset + words) > hw->nvm.sr_size)  in i40e_write_nvm_aq()
567 			   "NVM write error: offset %d beyond Shadow RAM limit %d\n",  in i40e_write_nvm_aq()
568 			   (offset + words), hw->nvm.sr_size);  in i40e_write_nvm_aq()
572 			   "NVM write fail error: tried to write %d words, limit is %d.\n",  in i40e_write_nvm_aq()
578 			   "NVM write error: cannot spread over two sectors in a single write offset=%d words=%d\n",  in i40e_write_nvm_aq()
635 	for (i = 0; i < hw->nvm.sr_size; i++) {  in i40e_calc_nvm_checksum()
674  * i40e_update_nvm_checksum - Updates the NVM checksum
677  * NVM ownership must be acquired before calling this function and released
679  * This function will commit SR to NVM.
702  * Performs checksum calculation and validates the NVM SW checksum. If the
712 	/* We must acquire the NVM lock in order to correctly synchronize the  in i40e_validate_nvm_checksum()
713 	 * NVM accesses across multiple PFs. Without doing so it is possible  in i40e_validate_nvm_checksum()
805  * i40e_nvmupd_command - Process an NVM update command
807  * @cmd: pointer to nvm update command
920  * i40e_nvmupd_state_init - Handle NVM update state Init
922  * @cmd: pointer to nvm update command buffer
1059  * i40e_nvmupd_state_reading - Handle NVM update state Reading
1061  * @cmd: pointer to nvm update command buffer
1065  * NVM ownership is already held.  Process legitimate commands and set any
1101  * i40e_nvmupd_state_writing - Handle NVM update state Writing
1103  * @cmd: pointer to nvm update command buffer
1107  * NVM ownership is already held.  Process legitimate commands and set any
1146 		/* Assumes the caller has acquired the nvm */  in i40e_nvmupd_state_writing()
1161 		/* Assumes the caller has acquired the nvm */  in i40e_nvmupd_state_writing()
1198 		if (gtime >= hw->nvm.hw_semaphore_timeout) {  in i40e_nvmupd_state_writing()
1201 				   gtime, hw->nvm.hw_semaphore_timeout);  in i40e_nvmupd_state_writing()
1256  * i40e_nvmupd_check_wait_event - handle NVM update operation events
1275  * @cmd: pointer to nvm update command buffer
1370  * @cmd: pointer to nvm update command buffer
1454  * @cmd: pointer to nvm update command buffer
1523  * @cmd: pointer to nvm update command buffer
1555  * i40e_nvmupd_nvm_read - Read NVM
1557  * @cmd: pointer to nvm update command buffer
1595  * i40e_nvmupd_nvm_erase - Erase an NVM module
1597  * @cmd: pointer to nvm update command buffer
1634  * i40e_nvmupd_nvm_write - Write NVM
1636  * @cmd: pointer to nvm update command buffer