1 /****************************************************************************** 2 SPDX-License-Identifier: BSD-3-Clause 3 4 Copyright (c) 2001-2020, Intel Corporation 5 All rights reserved. 6 7 Redistribution and use in source and binary forms, with or without 8 modification, are permitted provided that the following conditions are met: 9 10 1. Redistributions of source code must retain the above copyright notice, 11 this list of conditions and the following disclaimer. 12 13 2. Redistributions in binary form must reproduce the above copyright 14 notice, this list of conditions and the following disclaimer in the 15 documentation and/or other materials provided with the distribution. 16 17 3. Neither the name of the Intel Corporation nor the names of its 18 contributors may be used to endorse or promote products derived from 19 this software without specific prior written permission. 20 21 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 22 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 25 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 26 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 27 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 28 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 29 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 30 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 31 POSSIBILITY OF SUCH DAMAGE. 32 33 ******************************************************************************/ 34 35 #ifndef _E1000_NVM_H_ 36 #define _E1000_NVM_H_ 37 38 struct e1000_pba { 39 u16 word[2]; 40 u16 *pba_block; 41 }; 42 43 struct e1000_fw_version { 44 u32 etrack_id; 45 u16 eep_major; 46 u16 eep_minor; 47 u16 eep_build; 48 49 u8 invm_major; 50 u8 invm_minor; 51 u8 invm_img_type; 52 53 bool or_valid; 54 u16 or_major; 55 u16 or_build; 56 u16 or_patch; 57 }; 58 59 60 void e1000_init_nvm_ops_generic(struct e1000_hw *hw); 61 s32 e1000_null_read_nvm(struct e1000_hw *hw, u16 a, u16 b, u16 *c); 62 void e1000_null_nvm_generic(struct e1000_hw *hw); 63 s32 e1000_null_led_default(struct e1000_hw *hw, u16 *data); 64 s32 e1000_null_write_nvm(struct e1000_hw *hw, u16 a, u16 b, u16 *c); 65 s32 e1000_acquire_nvm_generic(struct e1000_hw *hw); 66 67 s32 e1000_poll_eerd_eewr_done(struct e1000_hw *hw, int ee_reg); 68 s32 e1000_read_mac_addr_generic(struct e1000_hw *hw); 69 s32 e1000_read_pba_num_generic(struct e1000_hw *hw, u32 *pba_num); 70 s32 e1000_read_pba_string_generic(struct e1000_hw *hw, u8 *pba_num, 71 u32 pba_num_size); 72 s32 e1000_read_pba_length_generic(struct e1000_hw *hw, u32 *pba_num_size); 73 s32 e1000_read_pba_raw(struct e1000_hw *hw, u16 *eeprom_buf, 74 u32 eeprom_buf_size, u16 max_pba_block_size, 75 struct e1000_pba *pba); 76 s32 e1000_write_pba_raw(struct e1000_hw *hw, u16 *eeprom_buf, 77 u32 eeprom_buf_size, struct e1000_pba *pba); 78 s32 e1000_get_pba_block_size(struct e1000_hw *hw, u16 *eeprom_buf, 79 u32 eeprom_buf_size, u16 *pba_block_size); 80 s32 e1000_read_nvm_spi(struct e1000_hw *hw, u16 offset, u16 words, u16 *data); 81 s32 e1000_read_nvm_microwire(struct e1000_hw *hw, u16 offset, 82 u16 words, u16 *data); 83 s32 e1000_read_nvm_eerd(struct e1000_hw *hw, u16 offset, u16 words, 84 u16 *data); 85 s32 e1000_valid_led_default_generic(struct e1000_hw *hw, u16 *data); 86 s32 e1000_validate_nvm_checksum_generic(struct e1000_hw *hw); 87 s32 e1000_write_nvm_microwire(struct e1000_hw *hw, u16 offset, 88 u16 words, u16 *data); 89 s32 e1000_write_nvm_spi(struct e1000_hw *hw, u16 offset, u16 words, 90 u16 *data); 91 s32 e1000_update_nvm_checksum_generic(struct e1000_hw *hw); 92 void e1000_stop_nvm(struct e1000_hw *hw); 93 void e1000_release_nvm_generic(struct e1000_hw *hw); 94 void e1000_get_fw_version(struct e1000_hw *hw, 95 struct e1000_fw_version *fw_vers); 96 97 #define E1000_STM_OPCODE 0xDB00 98 99 #endif 100