e1000_api.h revision 176667 
1/*******************************************************************************
2
3  Copyright (c) 2001-2008, 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: head/sys/dev/em/e1000_api.h 176667 2008-02-29 21:50:11Z jfv $ */
34
35
36#ifndef _E1000_API_H_
37#define _E1000_API_H_
38
39#include "e1000_hw.h"
40
41#ifndef NO_82542_SUPPORT
42extern void    e1000_init_function_pointers_82542(struct e1000_hw *hw);
43#endif
44extern void    e1000_init_function_pointers_82543(struct e1000_hw *hw);
45extern void    e1000_init_function_pointers_82540(struct e1000_hw *hw);
46extern void    e1000_init_function_pointers_82571(struct e1000_hw *hw);
47extern void    e1000_init_function_pointers_82541(struct e1000_hw *hw);
48extern void    e1000_init_function_pointers_80003es2lan(struct e1000_hw *hw);
49extern void    e1000_init_function_pointers_ich8lan(struct e1000_hw *hw);
50
51s32  e1000_set_mac_type(struct e1000_hw *hw);
52s32  e1000_setup_init_funcs(struct e1000_hw *hw, bool init_device);
53s32  e1000_init_mac_params(struct e1000_hw *hw);
54s32  e1000_init_nvm_params(struct e1000_hw *hw);
55s32  e1000_init_phy_params(struct e1000_hw *hw);
56void e1000_remove_device(struct e1000_hw *hw);
57s32  e1000_get_bus_info(struct e1000_hw *hw);
58void e1000_clear_vfta(struct e1000_hw *hw);
59void e1000_write_vfta(struct e1000_hw *hw, u32 offset, u32 value);
60s32  e1000_force_mac_fc(struct e1000_hw *hw);
61s32  e1000_check_for_link(struct e1000_hw *hw);
62s32  e1000_reset_hw(struct e1000_hw *hw);
63s32  e1000_init_hw(struct e1000_hw *hw);
64s32  e1000_setup_link(struct e1000_hw *hw);
65s32  e1000_get_speed_and_duplex(struct e1000_hw *hw, u16 *speed,
66                                u16 *duplex);
67s32  e1000_disable_pcie_master(struct e1000_hw *hw);
68void e1000_config_collision_dist(struct e1000_hw *hw);
69void e1000_rar_set(struct e1000_hw *hw, u8 *addr, u32 index);
70void e1000_mta_set(struct e1000_hw *hw, u32 hash_value);
71u32  e1000_hash_mc_addr(struct e1000_hw *hw, u8 *mc_addr);
72void e1000_update_mc_addr_list(struct e1000_hw *hw,
73                               u8 *mc_addr_list, u32 mc_addr_count,
74                               u32 rar_used_count, u32 rar_count);
75s32  e1000_setup_led(struct e1000_hw *hw);
76s32  e1000_cleanup_led(struct e1000_hw *hw);
77s32  e1000_check_reset_block(struct e1000_hw *hw);
78s32  e1000_blink_led(struct e1000_hw *hw);
79s32  e1000_led_on(struct e1000_hw *hw);
80s32  e1000_led_off(struct e1000_hw *hw);
81void e1000_reset_adaptive(struct e1000_hw *hw);
82void e1000_update_adaptive(struct e1000_hw *hw);
83s32  e1000_get_cable_length(struct e1000_hw *hw);
84s32  e1000_validate_mdi_setting(struct e1000_hw *hw);
85s32  e1000_read_phy_reg(struct e1000_hw *hw, u32 offset, u16 *data);
86s32  e1000_write_phy_reg(struct e1000_hw *hw, u32 offset, u16 data);
87s32  e1000_write_8bit_ctrl_reg(struct e1000_hw *hw, u32 reg,
88                               u32 offset, u8 data);
89s32  e1000_get_phy_info(struct e1000_hw *hw);
90s32  e1000_phy_hw_reset(struct e1000_hw *hw);
91s32  e1000_phy_commit(struct e1000_hw *hw);
92void e1000_power_up_phy(struct e1000_hw *hw);
93void e1000_power_down_phy(struct e1000_hw *hw);
94s32  e1000_read_mac_addr(struct e1000_hw *hw);
95s32  e1000_read_pba_num(struct e1000_hw *hw, u32 *part_num);
96void e1000_reload_nvm(struct e1000_hw *hw);
97s32  e1000_update_nvm_checksum(struct e1000_hw *hw);
98s32  e1000_validate_nvm_checksum(struct e1000_hw *hw);
99s32  e1000_read_nvm(struct e1000_hw *hw, u16 offset, u16 words, u16 *data);
100s32  e1000_read_kmrn_reg(struct e1000_hw *hw, u32 offset, u16 *data);
101s32  e1000_write_kmrn_reg(struct e1000_hw *hw, u32 offset, u16 data);
102s32  e1000_write_nvm(struct e1000_hw *hw, u16 offset, u16 words,
103                     u16 *data);
104s32  e1000_wait_autoneg(struct e1000_hw *hw);
105s32  e1000_set_d3_lplu_state(struct e1000_hw *hw, bool active);
106s32  e1000_set_d0_lplu_state(struct e1000_hw *hw, bool active);
107bool e1000_check_mng_mode(struct e1000_hw *hw);
108bool e1000_enable_mng_pass_thru(struct e1000_hw *hw);
109bool e1000_enable_tx_pkt_filtering(struct e1000_hw *hw);
110s32  e1000_mng_enable_host_if(struct e1000_hw *hw);
111s32  e1000_mng_host_if_write(struct e1000_hw *hw,
112                             u8 *buffer, u16 length, u16 offset, u8 *sum);
113s32  e1000_mng_write_cmd_header(struct e1000_hw *hw,
114                                struct e1000_host_mng_command_header *hdr);
115s32  e1000_mng_write_dhcp_info(struct e1000_hw * hw,
116                                    u8 *buffer, u16 length);
117void e1000_tbi_adjust_stats_82543(struct e1000_hw *hw,
118                                  struct e1000_hw_stats *stats,
119                                  u32 frame_len, u8 *mac_addr,
120                                  u32 max_frame_size);
121void e1000_set_tbi_compatibility_82543(struct e1000_hw *hw,
122                                       bool state);
123bool e1000_tbi_sbp_enabled_82543(struct e1000_hw *hw);
124#ifndef NO_82542_SUPPORT
125u32  e1000_translate_register_82542(u32 reg);
126#endif
127void e1000_init_script_state_82541(struct e1000_hw *hw, bool state);
128bool e1000_get_laa_state_82571(struct e1000_hw *hw);
129void e1000_set_laa_state_82571(struct e1000_hw *hw, bool state);
130void e1000_set_kmrn_lock_loss_workaround_ich8lan(struct e1000_hw *hw,
131                                                 bool state);
132void e1000_igp3_phy_powerdown_workaround_ich8lan(struct e1000_hw *hw);
133void e1000_gig_downshift_workaround_ich8lan(struct e1000_hw *hw);
134void e1000_disable_gig_wol_ich8lan(struct e1000_hw *hw);
135
136
137/*
138 * TBI_ACCEPT macro definition:
139 *
140 * This macro requires:
141 *      adapter = a pointer to struct e1000_hw
142 *      status = the 8 bit status field of the Rx descriptor with EOP set
143 *      error = the 8 bit error field of the Rx descriptor with EOP set
144 *      length = the sum of all the length fields of the Rx descriptors that
145 *               make up the current frame
146 *      last_byte = the last byte of the frame DMAed by the hardware
147 *      max_frame_length = the maximum frame length we want to accept.
148 *      min_frame_length = the minimum frame length we want to accept.
149 *
150 * This macro is a conditional that should be used in the interrupt
151 * handler's Rx processing routine when RxErrors have been detected.
152 *
153 * Typical use:
154 *  ...
155 *  if (TBI_ACCEPT) {
156 *      accept_frame = TRUE;
157 *      e1000_tbi_adjust_stats(adapter, MacAddress);
158 *      frame_length--;
159 *  } else {
160 *      accept_frame = FALSE;
161 *  }
162 *  ...
163 */
164
165/* The carrier extension symbol, as received by the NIC. */
166#define CARRIER_EXTENSION   0x0F
167
168#define TBI_ACCEPT(a, status, errors, length, last_byte, min_frame_size, max_frame_size) \
169    (e1000_tbi_sbp_enabled_82543(a) && \
170     (((errors) & E1000_RXD_ERR_FRAME_ERR_MASK) == E1000_RXD_ERR_CE) && \
171     ((last_byte) == CARRIER_EXTENSION) && \
172     (((status) & E1000_RXD_STAT_VP) ? \
173          (((length) > (min_frame_size - VLAN_TAG_SIZE)) && \
174           ((length) <= (max_frame_size + 1))) : \
175          (((length) > min_frame_size) && \
176           ((length) <= (max_frame_size + VLAN_TAG_SIZE + 1)))))
177
178#endif
179