13  * @length: length of the section to be read (in bytes from the offset)
16  * @read_shadow_ram: tell if this is a shadow RAM read
19  * Read the NVM using the admin queue commands (0x0701)
51  * ice_read_flat_nvm - Read portion of NVM by flat offset
54  * @length: (in) number of bytes to read; (out) number of bytes actually read
56  * @read_shadow_ram: if true, read from shadow RAM instead of NVM
59  * breaks read requests across Shadow RAM sectors and ensures that no single
60  * read request exceeds the maximum 4KB read for a single AdminQ command.
76 	/* Verify the length of the read if this is for the Shadow RAM */  in ice_read_flat_nvm()
85 		/* ice_aq_read_nvm cannot read more than 4KB at a time.  in ice_read_flat_nvm()
86 		 * Additionally, a read from the Shadow RAM may not cross over  in ice_read_flat_nvm()
183  * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF)
184  * @data: word read from the Shadow RAM
209  * @access: NVM access type (read or write)
238  * @bank: whether to read from the active or inactive flash bank
239  * @module: the module to read from
304  * ice_read_flash_module - Read a word from one of the main NVM modules
306  * @bank: which bank of the module to read
307  * @module: the module to read
309  * @data: storage for the word read from the flash
310  * @length: bytes of data to read
312  * Read data from the specified flash module. The bank parameter indicates
313  * whether or not to read from the active bank or the inactive bank of that
316  * The word will be read using flat NVM access, and relies on the
346  * ice_read_nvm_module - Read from the active main NVM module
348  * @bank: whether to read from active or inactive NVM module
349  * @offset: offset into the NVM module to read, in words
352  * Read the specified word from the active NVM module. This includes the CSS
370  * ice_read_nvm_sr_copy - Read a word from the Shadow RAM copy in the NVM bank
372  * @bank: whether to read from the active or inactive NVM module
373  * @offset: offset into the Shadow RAM copy to read, in words
376  * Read the specified word from the copy of the Shadow RAM found in the
386  * ice_read_netlist_module - Read data from the netlist module area
388  * @bank: whether to read from the active or inactive module
389  * @offset: offset into the netlist to read from
392  * Read a word from the specified netlist bank.
411  * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF)
412  * @data: word read from the Shadow RAM
438  * use these to read the variable length TLV value.
455 		ice_debug(hw, ICE_DBG_INIT, "Failed to read PFA length.\n");  in ice_get_pfa_module_tlv()
466 		/* Read TLV type */  in ice_get_pfa_module_tlv()
469 			ice_debug(hw, ICE_DBG_INIT, "Failed to read TLV type.\n");  in ice_get_pfa_module_tlv()
472 		/* Read TLV length */  in ice_get_pfa_module_tlv()
475 			ice_debug(hw, ICE_DBG_INIT, "Failed to read TLV length.\n");  in ice_get_pfa_module_tlv()
513 		ice_debug(hw, ICE_DBG_INIT, "Failed to read PBA Block TLV.\n");  in ice_read_pba_string()
520 		ice_debug(hw, ICE_DBG_INIT, "Failed to read PBA Section size.\n");  in ice_read_pba_string()
541 			ice_debug(hw, ICE_DBG_INIT, "Failed to read PBA Block word %d.\n", i);  in ice_read_pba_string()
554  * ice_get_nvm_ver_info - Read NVM version information
556  * @bank: whether to read from the active or inactive flash bank
559  * Read the NVM EETRACK ID and map version of the main NVM image bank, filling
570 		ice_debug(hw, ICE_DBG_NVM, "Failed to read DEV starter version.\n");  in ice_get_nvm_ver_info()
579 		ice_debug(hw, ICE_DBG_NVM, "Failed to read EETRACK lo.\n");  in ice_get_nvm_ver_info()
584 		ice_debug(hw, ICE_DBG_NVM, "Failed to read EETRACK hi.\n");  in ice_get_nvm_ver_info()
594  * ice_get_inactive_nvm_ver - Read Option ROM version from the inactive bank
610  * @bank: whether to read from the active or inactive flash module
633 	 * It's significantly faster to read the entire Option ROM up front  in ice_get_orom_civd_data()
634 	 * using the maximum page size, than to read each possible location  in ice_get_orom_civd_data()
645 		ice_debug(hw, ICE_DBG_NVM, "Unable to read Option ROM data\n");  in ice_get_orom_civd_data()
687  * ice_get_orom_ver_info - Read Option ROM version information
689  * @bank: whether to read from the active or inactive flash module
692  * Read Option ROM version and security revision from the Option ROM flash
718  * ice_get_inactive_orom_ver - Read Option ROM version from the inactive bank
734  * @bank: whether to read from the active or inactive flash bank
779 	/* Read out the entire Netlist ID Block at once. */  in ice_get_netlist_info()
798 	/* Read the left most 4 bytes of SHA */  in ice_get_netlist_info()
813  * Read the netlist version data from the inactive netlist bank. Used to
872  * ice_read_sr_pointer - Read the value of a Shadow RAM pointer word
874  * @offset: the word offset of the Shadow RAM word to read
875  * @pointer: pointer value read from Shadow RAM
877  * Read the given Shadow RAM word, and convert it to a pointer value specified
904  * ice_read_sr_area_size - Read an area size from a Shadow RAM word
906  * @offset: the word offset of the Shadow RAM to read
907  * @size: size value read from the Shadow RAM
909  * Read the given Shadow RAM word, and convert it to an area size value
935  * Read the Shadow RAM control word and determine which banks are active for
936  * the NVM, OROM, and Netlist modules. Also read and calculate the associated
938  * structure for later use in order to calculate the correct offset to read
949 		ice_debug(hw, ICE_DBG_NVM, "Failed to read the Shadow RAM control word\n");  in ice_determine_active_flash_banks()
976 		ice_debug(hw, ICE_DBG_NVM, "Failed to read NVM bank pointer\n");  in ice_determine_active_flash_banks()
982 		ice_debug(hw, ICE_DBG_NVM, "Failed to read NVM bank area size\n");  in ice_determine_active_flash_banks()
988 		ice_debug(hw, ICE_DBG_NVM, "Failed to read OROM bank pointer\n");  in ice_determine_active_flash_banks()
994 		ice_debug(hw, ICE_DBG_NVM, "Failed to read OROM bank area size\n");  in ice_determine_active_flash_banks()
1000 		ice_debug(hw, ICE_DBG_NVM, "Failed to read Netlist bank pointer\n");  in ice_determine_active_flash_banks()
1006 		ice_debug(hw, ICE_DBG_NVM, "Failed to read Netlist bank area size\n");  in ice_determine_active_flash_banks()
1061 		ice_debug(hw, ICE_DBG_INIT, "Failed to read NVM info.\n");  in ice_init_nvm()
1067 		ice_debug(hw, ICE_DBG_INIT, "Failed to read Option ROM info.\n");  in ice_init_nvm()
1069 	/* read the netlist version information */  in ice_init_nvm()
1072 		ice_debug(hw, ICE_DBG_INIT, "Failed to read netlist info.\n");  in ice_init_nvm()