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)
50  * ice_read_flat_nvm - Read portion of NVM by flat offset
53  * @length: (in) number of bytes to read; (out) number of bytes actually read
55  * @read_shadow_ram: if true, read from shadow RAM instead of NVM
58  * breaks read requests across Shadow RAM sectors and ensures that no single
59  * read request exceeds the maximum 4KB read for a single AdminQ command.
75 	/* Verify the length of the read if this is for the Shadow RAM */  in ice_read_flat_nvm()
84 		/* ice_aq_read_nvm cannot read more than 4KB at a time.  in ice_read_flat_nvm()
85 		 * Additionally, a read from the Shadow RAM may not cross over  in ice_read_flat_nvm()
182  * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF)
183  * @data: word read from the Shadow RAM
208  * @access: NVM access type (read or write)
237  * @bank: whether to read from the active or inactive flash bank
238  * @module: the module to read from
303  * ice_read_flash_module - Read a word from one of the main NVM modules
305  * @bank: which bank of the module to read
306  * @module: the module to read
308  * @data: storage for the word read from the flash
309  * @length: bytes of data to read
311  * Read data from the specified flash module. The bank parameter indicates
312  * whether or not to read from the active bank or the inactive bank of that
315  * The word will be read using flat NVM access, and relies on the
345  * ice_read_nvm_module - Read from the active main NVM module
347  * @bank: whether to read from active or inactive NVM module
348  * @offset: offset into the NVM module to read, in words
351  * Read the specified word from the active NVM module. This includes the CSS
369  * ice_read_nvm_sr_copy - Read a word from the Shadow RAM copy in the NVM bank
371  * @bank: whether to read from the active or inactive NVM module
372  * @offset: offset into the Shadow RAM copy to read, in words
375  * Read the specified word from the copy of the Shadow RAM found in the
399  * ice_read_netlist_module - Read data from the netlist module area
401  * @bank: whether to read from the active or inactive module
402  * @offset: offset into the netlist to read from
405  * Read a word from the specified netlist bank.
424  * @offset: offset of the Shadow RAM word to read (0x000000 - 0x001FFF)
425  * @data: word read from the Shadow RAM
451  * use these to read the variable length TLV value.
467 		ice_debug(hw, ICE_DBG_INIT, "Failed to read PFA length.\n");  in ice_get_pfa_module_tlv()
490 		/* Read TLV type */  in ice_get_pfa_module_tlv()
493 			ice_debug(hw, ICE_DBG_INIT, "Failed to read TLV type.\n");  in ice_get_pfa_module_tlv()
496 		/* Read TLV length */  in ice_get_pfa_module_tlv()
499 			ice_debug(hw, ICE_DBG_INIT, "Failed to read TLV length.\n");  in ice_get_pfa_module_tlv()
540 		ice_debug(hw, ICE_DBG_INIT, "Failed to read PBA Block TLV.\n");  in ice_read_pba_string()
547 		ice_debug(hw, ICE_DBG_INIT, "Failed to read PBA Section size.\n");  in ice_read_pba_string()
568 			ice_debug(hw, ICE_DBG_INIT, "Failed to read PBA Block word %d.\n", i);  in ice_read_pba_string()
581  * ice_get_nvm_ver_info - Read NVM version information
583  * @bank: whether to read from the active or inactive flash bank
586  * Read the NVM EETRACK ID and map version of the main NVM image bank, filling
597 		ice_debug(hw, ICE_DBG_NVM, "Failed to read DEV starter version.\n");  in ice_get_nvm_ver_info()
606 		ice_debug(hw, ICE_DBG_NVM, "Failed to read EETRACK lo.\n");  in ice_get_nvm_ver_info()
611 		ice_debug(hw, ICE_DBG_NVM, "Failed to read EETRACK hi.\n");  in ice_get_nvm_ver_info()
621  * ice_get_inactive_nvm_ver - Read Option ROM version from the inactive bank
637  * @bank: whether to read from the active or inactive flash module
660 	 * It's significantly faster to read the entire Option ROM up front  in ice_get_orom_civd_data()
661 	 * using the maximum page size, than to read each possible location  in ice_get_orom_civd_data()
672 		ice_debug(hw, ICE_DBG_NVM, "Unable to read Option ROM data\n");  in ice_get_orom_civd_data()
713  * ice_get_orom_ver_info - Read Option ROM version information
715  * @bank: whether to read from the active or inactive flash module
718  * Read Option ROM version and security revision from the Option ROM flash
744  * ice_get_inactive_orom_ver - Read Option ROM version from the inactive bank
760  * @bank: whether to read from the active or inactive flash bank
805 	/* Read out the entire Netlist ID Block at once. */  in ice_get_netlist_info()
824 	/* Read the left most 4 bytes of SHA */  in ice_get_netlist_info()
839  * Read the netlist version data from the inactive netlist bank. Used to
898  * ice_read_sr_pointer - Read the value of a Shadow RAM pointer word
900  * @offset: the word offset of the Shadow RAM word to read
901  * @pointer: pointer value read from Shadow RAM
903  * Read the given Shadow RAM word, and convert it to a pointer value specified
930  * ice_read_sr_area_size - Read an area size from a Shadow RAM word
932  * @offset: the word offset of the Shadow RAM to read
933  * @size: size value read from the Shadow RAM
935  * Read the given Shadow RAM word, and convert it to an area size value
961  * Read the Shadow RAM control word and determine which banks are active for
962  * the NVM, OROM, and Netlist modules. Also read and calculate the associated
964  * structure for later use in order to calculate the correct offset to read
975 		ice_debug(hw, ICE_DBG_NVM, "Failed to read the Shadow RAM control word\n");  in ice_determine_active_flash_banks()
1003 		ice_debug(hw, ICE_DBG_NVM, "Failed to read NVM bank pointer\n");  in ice_determine_active_flash_banks()
1009 		ice_debug(hw, ICE_DBG_NVM, "Failed to read NVM bank area size\n");  in ice_determine_active_flash_banks()
1015 		ice_debug(hw, ICE_DBG_NVM, "Failed to read OROM bank pointer\n");  in ice_determine_active_flash_banks()
1021 		ice_debug(hw, ICE_DBG_NVM, "Failed to read OROM bank area size\n");  in ice_determine_active_flash_banks()
1027 		ice_debug(hw, ICE_DBG_NVM, "Failed to read Netlist bank pointer\n");  in ice_determine_active_flash_banks()
1033 		ice_debug(hw, ICE_DBG_NVM, "Failed to read Netlist bank area size\n");  in ice_determine_active_flash_banks()
1041  * ice_get_nvm_css_hdr_len - Read the CSS header length from the NVM CSS header
1043  * @bank: whether to read from the active or inactive flash bank
1046  * Read the CSS header length from the NVM CSS header and add the Authentication
1160 		ice_debug(hw, ICE_DBG_INIT, "Failed to read NVM info.\n");  in ice_init_nvm()
1166 		ice_debug(hw, ICE_DBG_INIT, "Failed to read Option ROM info.\n");  in ice_init_nvm()
1168 	/* read the netlist version information */  in ice_init_nvm()
1171 		ice_debug(hw, ICE_DBG_INIT, "Failed to read netlist info.\n");  in ice_init_nvm()