1 /****************************************************************************** 2 3 Copyright (c) 2001-2011, Intel Corporation 4 All rights reserved. 5 6 Redistribution and use in source and binary forms, with or without 7 modification, are permitted provided that the following conditions are met: 8 9 1. Redistributions of source code must retain the above copyright notice, 10 this list of conditions and the following disclaimer. 11 12 2. Redistributions in binary form must reproduce the above copyright 13 notice, this list of conditions and the following disclaimer in the 14 documentation and/or other materials provided with the distribution. 15 16 3. Neither the name of the Intel Corporation nor the names of its 17 contributors may be used to endorse or promote products derived from 18 this software without specific prior written permission. 19 20 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 21 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 22 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 23 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 24 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 25 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 26 SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 27 INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 28 CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 29 ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 30 POSSIBILITY OF SUCH DAMAGE. 31 32 ******************************************************************************/ 33 /*$FreeBSD*/ 34 35 #ifndef _E1000_API_H_ 36 #define _E1000_API_H_ 37 38 #include "e1000_hw.h" 39 40 #ifndef NO_82542_SUPPORT 41 extern void e1000_init_function_pointers_82542(struct e1000_hw *hw); 42 #endif 43 extern void e1000_init_function_pointers_82543(struct e1000_hw *hw); 44 extern void e1000_init_function_pointers_82540(struct e1000_hw *hw); 45 extern void e1000_init_function_pointers_82571(struct e1000_hw *hw); 46 extern void e1000_init_function_pointers_82541(struct e1000_hw *hw); 47 extern void e1000_init_function_pointers_80003es2lan(struct e1000_hw *hw); 48 extern void e1000_init_function_pointers_ich8lan(struct e1000_hw *hw); 49 extern void e1000_init_function_pointers_82575(struct e1000_hw *hw); 50 extern void e1000_rx_fifo_flush_82575(struct e1000_hw *hw); 51 extern void e1000_init_function_pointers_vf(struct e1000_hw *hw); 52 extern void e1000_power_up_fiber_serdes_link(struct e1000_hw *hw); 53 extern void e1000_shutdown_fiber_serdes_link(struct e1000_hw *hw); 54 55 s32 e1000_set_mac_type(struct e1000_hw *hw); 56 s32 e1000_setup_init_funcs(struct e1000_hw *hw, bool init_device); 57 s32 e1000_init_mac_params(struct e1000_hw *hw); 58 s32 e1000_init_nvm_params(struct e1000_hw *hw); 59 s32 e1000_init_phy_params(struct e1000_hw *hw); 60 s32 e1000_init_mbx_params(struct e1000_hw *hw); 61 s32 e1000_get_bus_info(struct e1000_hw *hw); 62 void e1000_clear_vfta(struct e1000_hw *hw); 63 void e1000_write_vfta(struct e1000_hw *hw, u32 offset, u32 value); 64 s32 e1000_force_mac_fc(struct e1000_hw *hw); 65 s32 e1000_check_for_link(struct e1000_hw *hw); 66 s32 e1000_reset_hw(struct e1000_hw *hw); 67 s32 e1000_init_hw(struct e1000_hw *hw); 68 s32 e1000_setup_link(struct e1000_hw *hw); 69 s32 e1000_get_speed_and_duplex(struct e1000_hw *hw, u16 *speed, 70 u16 *duplex); 71 s32 e1000_disable_pcie_master(struct e1000_hw *hw); 72 void e1000_config_collision_dist(struct e1000_hw *hw); 73 void e1000_rar_set(struct e1000_hw *hw, u8 *addr, u32 index); 74 u32 e1000_hash_mc_addr(struct e1000_hw *hw, u8 *mc_addr); 75 void e1000_update_mc_addr_list(struct e1000_hw *hw, 76 u8 *mc_addr_list, u32 mc_addr_count); 77 s32 e1000_setup_led(struct e1000_hw *hw); 78 s32 e1000_cleanup_led(struct e1000_hw *hw); 79 s32 e1000_check_reset_block(struct e1000_hw *hw); 80 s32 e1000_blink_led(struct e1000_hw *hw); 81 s32 e1000_led_on(struct e1000_hw *hw); 82 s32 e1000_led_off(struct e1000_hw *hw); 83 s32 e1000_id_led_init(struct e1000_hw *hw); 84 void e1000_reset_adaptive(struct e1000_hw *hw); 85 void e1000_update_adaptive(struct e1000_hw *hw); 86 s32 e1000_get_cable_length(struct e1000_hw *hw); 87 s32 e1000_validate_mdi_setting(struct e1000_hw *hw); 88 s32 e1000_read_phy_reg(struct e1000_hw *hw, u32 offset, u16 *data); 89 s32 e1000_write_phy_reg(struct e1000_hw *hw, u32 offset, u16 data); 90 s32 e1000_write_8bit_ctrl_reg(struct e1000_hw *hw, u32 reg, 91 u32 offset, u8 data); 92 s32 e1000_get_phy_info(struct e1000_hw *hw); 93 void e1000_release_phy(struct e1000_hw *hw); 94 s32 e1000_acquire_phy(struct e1000_hw *hw); 95 s32 e1000_cfg_on_link_up(struct e1000_hw *hw); 96 s32 e1000_phy_hw_reset(struct e1000_hw *hw); 97 s32 e1000_phy_commit(struct e1000_hw *hw); 98 void e1000_power_up_phy(struct e1000_hw *hw); 99 void e1000_power_down_phy(struct e1000_hw *hw); 100 s32 e1000_read_mac_addr(struct e1000_hw *hw); 101 s32 e1000_read_pba_num(struct e1000_hw *hw, u32 *part_num); 102 s32 e1000_read_pba_string(struct e1000_hw *hw, u8 *pba_num, 103 u32 pba_num_size); 104 s32 e1000_read_pba_length(struct e1000_hw *hw, u32 *pba_num_size); 105 void e1000_reload_nvm(struct e1000_hw *hw); 106 s32 e1000_update_nvm_checksum(struct e1000_hw *hw); 107 s32 e1000_validate_nvm_checksum(struct e1000_hw *hw); 108 s32 e1000_read_nvm(struct e1000_hw *hw, u16 offset, u16 words, u16 *data); 109 s32 e1000_read_kmrn_reg(struct e1000_hw *hw, u32 offset, u16 *data); 110 s32 e1000_write_kmrn_reg(struct e1000_hw *hw, u32 offset, u16 data); 111 s32 e1000_write_nvm(struct e1000_hw *hw, u16 offset, u16 words, 112 u16 *data); 113 s32 e1000_wait_autoneg(struct e1000_hw *hw); 114 s32 e1000_set_d3_lplu_state(struct e1000_hw *hw, bool active); 115 s32 e1000_set_d0_lplu_state(struct e1000_hw *hw, bool active); 116 bool e1000_check_mng_mode(struct e1000_hw *hw); 117 bool e1000_enable_tx_pkt_filtering(struct e1000_hw *hw); 118 s32 e1000_mng_enable_host_if(struct e1000_hw *hw); 119 s32 e1000_mng_host_if_write(struct e1000_hw *hw, 120 u8 *buffer, u16 length, u16 offset, u8 *sum); 121 s32 e1000_mng_write_cmd_header(struct e1000_hw *hw, 122 struct e1000_host_mng_command_header *hdr); 123 s32 e1000_mng_write_dhcp_info(struct e1000_hw * hw, 124 u8 *buffer, u16 length); 125 #ifndef NO_82542_SUPPORT 126 u32 e1000_translate_register_82542(u32 reg); 127 #endif 128 129 /* 130 * TBI_ACCEPT macro definition: 131 * 132 * This macro requires: 133 * adapter = a pointer to struct e1000_hw 134 * status = the 8 bit status field of the Rx descriptor with EOP set 135 * error = the 8 bit error field of the Rx descriptor with EOP set 136 * length = the sum of all the length fields of the Rx descriptors that 137 * make up the current frame 138 * last_byte = the last byte of the frame DMAed by the hardware 139 * max_frame_length = the maximum frame length we want to accept. 140 * min_frame_length = the minimum frame length we want to accept. 141 * 142 * This macro is a conditional that should be used in the interrupt 143 * handler's Rx processing routine when RxErrors have been detected. 144 * 145 * Typical use: 146 * ... 147 * if (TBI_ACCEPT) { 148 * accept_frame = TRUE; 149 * e1000_tbi_adjust_stats(adapter, MacAddress); 150 * frame_length--; 151 * } else { 152 * accept_frame = FALSE; 153 * } 154 * ... 155 */ 156 157 /* The carrier extension symbol, as received by the NIC. */ 158 #define CARRIER_EXTENSION 0x0F 159 160 #define TBI_ACCEPT(a, status, errors, length, last_byte, min_frame_size, max_frame_size) \ 161 (e1000_tbi_sbp_enabled_82543(a) && \ 162 (((errors) & E1000_RXD_ERR_FRAME_ERR_MASK) == E1000_RXD_ERR_CE) && \ 163 ((last_byte) == CARRIER_EXTENSION) && \ 164 (((status) & E1000_RXD_STAT_VP) ? \ 165 (((length) > (min_frame_size - VLAN_TAG_SIZE)) && \ 166 ((length) <= (max_frame_size + 1))) : \ 167 (((length) > min_frame_size) && \ 168 ((length) <= (max_frame_size + VLAN_TAG_SIZE + 1))))) 169 170 #endif 171