xref: /freebsd/sys/dev/ixgbe/ixgbe_api.h (revision 59c8e88e72633afbc47a4ace0d2170d00d51f7dc)
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 _IXGBE_API_H_
36 #define _IXGBE_API_H_
37 
38 #include "ixgbe_type.h"
39 
40 void ixgbe_dcb_get_rtrup2tc(struct ixgbe_hw *hw, u8 *map);
41 
42 s32 ixgbe_init_shared_code(struct ixgbe_hw *hw);
43 
44 extern s32 ixgbe_init_ops_82598(struct ixgbe_hw *hw);
45 extern s32 ixgbe_init_ops_82599(struct ixgbe_hw *hw);
46 extern s32 ixgbe_init_ops_X540(struct ixgbe_hw *hw);
47 extern s32 ixgbe_init_ops_X550(struct ixgbe_hw *hw);
48 extern s32 ixgbe_init_ops_X550EM(struct ixgbe_hw *hw);
49 extern s32 ixgbe_init_ops_X550EM_x(struct ixgbe_hw *hw);
50 extern s32 ixgbe_init_ops_X550EM_a(struct ixgbe_hw *hw);
51 extern s32 ixgbe_init_ops_vf(struct ixgbe_hw *hw);
52 
53 s32 ixgbe_set_mac_type(struct ixgbe_hw *hw);
54 s32 ixgbe_init_hw(struct ixgbe_hw *hw);
55 s32 ixgbe_reset_hw(struct ixgbe_hw *hw);
56 s32 ixgbe_start_hw(struct ixgbe_hw *hw);
57 void ixgbe_enable_relaxed_ordering(struct ixgbe_hw *hw);
58 s32 ixgbe_clear_hw_cntrs(struct ixgbe_hw *hw);
59 enum ixgbe_media_type ixgbe_get_media_type(struct ixgbe_hw *hw);
60 s32 ixgbe_get_mac_addr(struct ixgbe_hw *hw, u8 *mac_addr);
61 s32 ixgbe_get_bus_info(struct ixgbe_hw *hw);
62 u32 ixgbe_get_num_of_tx_queues(struct ixgbe_hw *hw);
63 u32 ixgbe_get_num_of_rx_queues(struct ixgbe_hw *hw);
64 s32 ixgbe_stop_adapter(struct ixgbe_hw *hw);
65 s32 ixgbe_read_pba_num(struct ixgbe_hw *hw, u32 *pba_num);
66 s32 ixgbe_read_pba_string(struct ixgbe_hw *hw, u8 *pba_num, u32 pba_num_size);
67 
68 s32 ixgbe_identify_phy(struct ixgbe_hw *hw);
69 s32 ixgbe_reset_phy(struct ixgbe_hw *hw);
70 s32 ixgbe_read_phy_reg(struct ixgbe_hw *hw, u32 reg_addr, u32 device_type,
71 		       u16 *phy_data);
72 s32 ixgbe_write_phy_reg(struct ixgbe_hw *hw, u32 reg_addr, u32 device_type,
73 			u16 phy_data);
74 
75 s32 ixgbe_setup_phy_link(struct ixgbe_hw *hw);
76 s32 ixgbe_setup_internal_phy(struct ixgbe_hw *hw);
77 s32 ixgbe_check_phy_link(struct ixgbe_hw *hw,
78 			 ixgbe_link_speed *speed,
79 			 bool *link_up);
80 s32 ixgbe_setup_phy_link_speed(struct ixgbe_hw *hw,
81 			       ixgbe_link_speed speed,
82 			       bool autoneg_wait_to_complete);
83 s32 ixgbe_set_phy_power(struct ixgbe_hw *, bool on);
84 void ixgbe_disable_tx_laser(struct ixgbe_hw *hw);
85 void ixgbe_enable_tx_laser(struct ixgbe_hw *hw);
86 void ixgbe_flap_tx_laser(struct ixgbe_hw *hw);
87 s32 ixgbe_setup_link(struct ixgbe_hw *hw, ixgbe_link_speed speed,
88 		     bool autoneg_wait_to_complete);
89 s32 ixgbe_setup_mac_link(struct ixgbe_hw *hw, ixgbe_link_speed speed,
90 			 bool autoneg_wait_to_complete);
91 s32 ixgbe_check_link(struct ixgbe_hw *hw, ixgbe_link_speed *speed,
92 		     bool *link_up, bool link_up_wait_to_complete);
93 s32 ixgbe_get_link_capabilities(struct ixgbe_hw *hw, ixgbe_link_speed *speed,
94 				bool *autoneg);
95 s32 ixgbe_led_on(struct ixgbe_hw *hw, u32 index);
96 s32 ixgbe_led_off(struct ixgbe_hw *hw, u32 index);
97 s32 ixgbe_blink_led_start(struct ixgbe_hw *hw, u32 index);
98 s32 ixgbe_blink_led_stop(struct ixgbe_hw *hw, u32 index);
99 
100 s32 ixgbe_init_eeprom_params(struct ixgbe_hw *hw);
101 s32 ixgbe_write_eeprom(struct ixgbe_hw *hw, u16 offset, u16 data);
102 s32 ixgbe_write_eeprom_buffer(struct ixgbe_hw *hw, u16 offset,
103 			      u16 words, u16 *data);
104 s32 ixgbe_read_eeprom(struct ixgbe_hw *hw, u16 offset, u16 *data);
105 s32 ixgbe_read_eeprom_buffer(struct ixgbe_hw *hw, u16 offset,
106 			     u16 words, u16 *data);
107 
108 s32 ixgbe_validate_eeprom_checksum(struct ixgbe_hw *hw, u16 *checksum_val);
109 s32 ixgbe_update_eeprom_checksum(struct ixgbe_hw *hw);
110 
111 s32 ixgbe_insert_mac_addr(struct ixgbe_hw *hw, u8 *addr, u32 vmdq);
112 s32 ixgbe_set_rar(struct ixgbe_hw *hw, u32 index, u8 *addr, u32 vmdq,
113 		  u32 enable_addr);
114 s32 ixgbe_clear_rar(struct ixgbe_hw *hw, u32 index);
115 s32 ixgbe_set_vmdq(struct ixgbe_hw *hw, u32 rar, u32 vmdq);
116 s32 ixgbe_set_vmdq_san_mac(struct ixgbe_hw *hw, u32 vmdq);
117 s32 ixgbe_clear_vmdq(struct ixgbe_hw *hw, u32 rar, u32 vmdq);
118 s32 ixgbe_init_rx_addrs(struct ixgbe_hw *hw);
119 u32 ixgbe_get_num_rx_addrs(struct ixgbe_hw *hw);
120 s32 ixgbe_update_uc_addr_list(struct ixgbe_hw *hw, u8 *addr_list,
121 			      u32 addr_count, ixgbe_mc_addr_itr func);
122 s32 ixgbe_update_mc_addr_list(struct ixgbe_hw *hw, u8 *mc_addr_list,
123 			      u32 mc_addr_count, ixgbe_mc_addr_itr func,
124 			      bool clear);
125 void ixgbe_add_uc_addr(struct ixgbe_hw *hw, u8 *addr_list, u32 vmdq);
126 s32 ixgbe_enable_mc(struct ixgbe_hw *hw);
127 s32 ixgbe_disable_mc(struct ixgbe_hw *hw);
128 s32 ixgbe_clear_vfta(struct ixgbe_hw *hw);
129 s32 ixgbe_set_vfta(struct ixgbe_hw *hw, u32 vlan,
130 		   u32 vind, bool vlan_on, bool vlvf_bypass);
131 s32 ixgbe_set_vlvf(struct ixgbe_hw *hw, u32 vlan, u32 vind,
132 		   bool vlan_on, u32 *vfta_delta, u32 vfta,
133 		   bool vlvf_bypass);
134 s32 ixgbe_fc_enable(struct ixgbe_hw *hw);
135 s32 ixgbe_setup_fc(struct ixgbe_hw *hw);
136 s32 ixgbe_set_fw_drv_ver(struct ixgbe_hw *hw, u8 maj, u8 min, u8 build,
137 			 u8 ver, u16 len, char *driver_ver);
138 s32 ixgbe_get_thermal_sensor_data(struct ixgbe_hw *hw);
139 s32 ixgbe_init_thermal_sensor_thresh(struct ixgbe_hw *hw);
140 void ixgbe_set_mta(struct ixgbe_hw *hw, u8 *mc_addr);
141 s32 ixgbe_get_phy_firmware_version(struct ixgbe_hw *hw,
142 				   u16 *firmware_version);
143 s32 ixgbe_read_analog_reg8(struct ixgbe_hw *hw, u32 reg, u8 *val);
144 s32 ixgbe_write_analog_reg8(struct ixgbe_hw *hw, u32 reg, u8 val);
145 s32 ixgbe_init_uta_tables(struct ixgbe_hw *hw);
146 s32 ixgbe_read_i2c_eeprom(struct ixgbe_hw *hw, u8 byte_offset, u8 *eeprom_data);
147 u64 ixgbe_get_supported_physical_layer(struct ixgbe_hw *hw);
148 s32 ixgbe_enable_rx_dma(struct ixgbe_hw *hw, u32 regval);
149 s32 ixgbe_disable_sec_rx_path(struct ixgbe_hw *hw);
150 s32 ixgbe_enable_sec_rx_path(struct ixgbe_hw *hw);
151 s32 ixgbe_mng_fw_enabled(struct ixgbe_hw *hw);
152 s32 ixgbe_reinit_fdir_tables_82599(struct ixgbe_hw *hw);
153 s32 ixgbe_init_fdir_signature_82599(struct ixgbe_hw *hw, u32 fdirctrl);
154 s32 ixgbe_init_fdir_perfect_82599(struct ixgbe_hw *hw, u32 fdirctrl,
155 					bool cloud_mode);
156 void ixgbe_fdir_add_signature_filter_82599(struct ixgbe_hw *hw,
157 					   union ixgbe_atr_hash_dword input,
158 					   union ixgbe_atr_hash_dword common,
159 					   u8 queue);
160 s32 ixgbe_fdir_set_input_mask_82599(struct ixgbe_hw *hw,
161 				    union ixgbe_atr_input *input_mask, bool cloud_mode);
162 s32 ixgbe_fdir_write_perfect_filter_82599(struct ixgbe_hw *hw,
163 					  union ixgbe_atr_input *input,
164 					  u16 soft_id, u8 queue, bool cloud_mode);
165 s32 ixgbe_fdir_erase_perfect_filter_82599(struct ixgbe_hw *hw,
166 					  union ixgbe_atr_input *input,
167 					  u16 soft_id);
168 s32 ixgbe_fdir_add_perfect_filter_82599(struct ixgbe_hw *hw,
169 					union ixgbe_atr_input *input,
170 					union ixgbe_atr_input *mask,
171 					u16 soft_id,
172 					u8 queue,
173 					bool cloud_mode);
174 void ixgbe_atr_compute_perfect_hash_82599(union ixgbe_atr_input *input,
175 					  union ixgbe_atr_input *mask);
176 u32 ixgbe_atr_compute_sig_hash_82599(union ixgbe_atr_hash_dword input,
177 				     union ixgbe_atr_hash_dword common);
178 bool ixgbe_verify_lesm_fw_enabled_82599(struct ixgbe_hw *hw);
179 s32 ixgbe_read_i2c_byte(struct ixgbe_hw *hw, u8 byte_offset, u8 dev_addr,
180 			u8 *data);
181 s32 ixgbe_read_i2c_byte_unlocked(struct ixgbe_hw *hw, u8 byte_offset,
182 				 u8 dev_addr, u8 *data);
183 s32 ixgbe_read_link(struct ixgbe_hw *hw, u8 addr, u16 reg, u16 *val);
184 s32 ixgbe_read_link_unlocked(struct ixgbe_hw *hw, u8 addr, u16 reg, u16 *val);
185 s32 ixgbe_write_i2c_byte(struct ixgbe_hw *hw, u8 byte_offset, u8 dev_addr,
186 			 u8 data);
187 void ixgbe_set_fdir_drop_queue_82599(struct ixgbe_hw *hw, u8 dropqueue);
188 s32 ixgbe_write_i2c_byte_unlocked(struct ixgbe_hw *hw, u8 byte_offset,
189 				  u8 dev_addr, u8 data);
190 s32 ixgbe_write_link(struct ixgbe_hw *hw, u8 addr, u16 reg, u16 val);
191 s32 ixgbe_write_link_unlocked(struct ixgbe_hw *hw, u8 addr, u16 reg, u16 val);
192 s32 ixgbe_write_i2c_eeprom(struct ixgbe_hw *hw, u8 byte_offset, u8 eeprom_data);
193 s32 ixgbe_get_san_mac_addr(struct ixgbe_hw *hw, u8 *san_mac_addr);
194 s32 ixgbe_set_san_mac_addr(struct ixgbe_hw *hw, u8 *san_mac_addr);
195 s32 ixgbe_get_device_caps(struct ixgbe_hw *hw, u16 *device_caps);
196 s32 ixgbe_acquire_swfw_semaphore(struct ixgbe_hw *hw, u32 mask);
197 void ixgbe_release_swfw_semaphore(struct ixgbe_hw *hw, u32 mask);
198 void ixgbe_init_swfw_semaphore(struct ixgbe_hw *hw);
199 s32 ixgbe_get_wwn_prefix(struct ixgbe_hw *hw, u16 *wwnn_prefix,
200 			 u16 *wwpn_prefix);
201 s32 ixgbe_get_fcoe_boot_status(struct ixgbe_hw *hw, u16 *bs);
202 s32 ixgbe_bypass_rw(struct ixgbe_hw *hw, u32 cmd, u32 *status);
203 s32 ixgbe_bypass_set(struct ixgbe_hw *hw, u32 cmd, u32 event, u32 action);
204 s32 ixgbe_bypass_rd_eep(struct ixgbe_hw *hw, u32 addr, u8 *value);
205 bool ixgbe_bypass_valid_rd(struct ixgbe_hw *hw, u32 in_reg, u32 out_reg);
206 s32 ixgbe_dmac_config(struct ixgbe_hw *hw);
207 s32 ixgbe_dmac_update_tcs(struct ixgbe_hw *hw);
208 s32 ixgbe_dmac_config_tcs(struct ixgbe_hw *hw);
209 s32 ixgbe_setup_eee(struct ixgbe_hw *hw, bool enable_eee);
210 void ixgbe_set_source_address_pruning(struct ixgbe_hw *hw, bool enable,
211 				      unsigned int vf);
212 void ixgbe_set_ethertype_anti_spoofing(struct ixgbe_hw *hw, bool enable,
213 				       int vf);
214 s32 ixgbe_read_iosf_sb_reg(struct ixgbe_hw *hw, u32 reg_addr,
215 			u32 device_type, u32 *phy_data);
216 s32 ixgbe_write_iosf_sb_reg(struct ixgbe_hw *hw, u32 reg_addr,
217 			u32 device_type, u32 phy_data);
218 void ixgbe_disable_mdd(struct ixgbe_hw *hw);
219 void ixgbe_enable_mdd(struct ixgbe_hw *hw);
220 void ixgbe_mdd_event(struct ixgbe_hw *hw, u32 *vf_bitmap);
221 void ixgbe_restore_mdd_vf(struct ixgbe_hw *hw, u32 vf);
222 bool ixgbe_fw_recovery_mode(struct ixgbe_hw *hw);
223 s32 ixgbe_enter_lplu(struct ixgbe_hw *hw);
224 s32 ixgbe_handle_lasi(struct ixgbe_hw *hw);
225 void ixgbe_set_rate_select_speed(struct ixgbe_hw *hw, ixgbe_link_speed speed);
226 void ixgbe_disable_rx(struct ixgbe_hw *hw);
227 void ixgbe_enable_rx(struct ixgbe_hw *hw);
228 s32 ixgbe_negotiate_fc(struct ixgbe_hw *hw, u32 adv_reg, u32 lp_reg,
229 			u32 adv_sym, u32 adv_asm, u32 lp_sym, u32 lp_asm);
230 
231 #endif /* _IXGBE_API_H_ */
232