1 /* SPDX-License-Identifier: GPL-2.0 */
2 /* Copyright(c) 2013 - 2021 Intel Corporation. */
3 
4 #ifndef _I40E_PROTOTYPE_H_
5 #define _I40E_PROTOTYPE_H_
6 
7 #include <linux/ethtool.h>
8 #include <linux/avf/virtchnl.h>
9 #include "i40e_debug.h"
10 #include "i40e_type.h"
11 
12 /* Prototypes for shared code functions that are not in
13  * the standard function pointer structures.  These are
14  * mostly because they are needed even before the init
15  * has happened and will assist in the early SW and FW
16  * setup.
17  */
18 
19 /* adminq functions */
20 int i40e_init_adminq(struct i40e_hw *hw);
21 void i40e_shutdown_adminq(struct i40e_hw *hw);
22 int i40e_clean_arq_element(struct i40e_hw *hw,
23 			   struct i40e_arq_event_info *e,
24 			   u16 *events_pending);
25 int
26 i40e_asq_send_command(struct i40e_hw *hw, struct i40e_aq_desc *desc,
27 		      void *buff, /* can be NULL */ u16  buff_size,
28 		      struct i40e_asq_cmd_details *cmd_details);
29 int
30 i40e_asq_send_command_v2(struct i40e_hw *hw,
31 			 struct i40e_aq_desc *desc,
32 			 void *buff, /* can be NULL */
33 			 u16  buff_size,
34 			 struct i40e_asq_cmd_details *cmd_details,
35 			 enum i40e_admin_queue_err *aq_status);
36 int
37 i40e_asq_send_command_atomic(struct i40e_hw *hw, struct i40e_aq_desc *desc,
38 			     void *buff, /* can be NULL */ u16  buff_size,
39 			     struct i40e_asq_cmd_details *cmd_details,
40 			     bool is_atomic_context);
41 int
42 i40e_asq_send_command_atomic_v2(struct i40e_hw *hw,
43 				struct i40e_aq_desc *desc,
44 				void *buff, /* can be NULL */
45 				u16  buff_size,
46 				struct i40e_asq_cmd_details *cmd_details,
47 				bool is_atomic_context,
48 				enum i40e_admin_queue_err *aq_status);
49 
50 /* debug function for adminq */
51 void i40e_debug_aq(struct i40e_hw *hw, enum i40e_debug_mask mask,
52 		   void *desc, void *buffer, u16 buf_len);
53 
54 bool i40e_check_asq_alive(struct i40e_hw *hw);
55 int i40e_aq_queue_shutdown(struct i40e_hw *hw, bool unloading);
56 const char *i40e_aq_str(struct i40e_hw *hw, enum i40e_admin_queue_err aq_err);
57 
58 int i40e_aq_get_rss_lut(struct i40e_hw *hw, u16 seid,
59 			bool pf_lut, u8 *lut, u16 lut_size);
60 int i40e_aq_set_rss_lut(struct i40e_hw *hw, u16 seid,
61 			bool pf_lut, u8 *lut, u16 lut_size);
62 int i40e_aq_get_rss_key(struct i40e_hw *hw,
63 			u16 seid,
64 			struct i40e_aqc_get_set_rss_key_data *key);
65 int i40e_aq_set_rss_key(struct i40e_hw *hw,
66 			u16 seid,
67 			struct i40e_aqc_get_set_rss_key_data *key);
68 
69 u32 i40e_led_get(struct i40e_hw *hw);
70 void i40e_led_set(struct i40e_hw *hw, u32 mode, bool blink);
71 int i40e_led_set_phy(struct i40e_hw *hw, bool on,
72 		     u16 led_addr, u32 mode);
73 int i40e_led_get_phy(struct i40e_hw *hw, u16 *led_addr,
74 		     u16 *val);
75 int i40e_blink_phy_link_led(struct i40e_hw *hw,
76 			    u32 time, u32 interval);
77 
78 /* admin send queue commands */
79 
80 int i40e_aq_get_firmware_version(struct i40e_hw *hw,
81 				 u16 *fw_major_version, u16 *fw_minor_version,
82 				 u32 *fw_build,
83 				 u16 *api_major_version, u16 *api_minor_version,
84 				 struct i40e_asq_cmd_details *cmd_details);
85 int i40e_aq_debug_write_register(struct i40e_hw *hw,
86 				 u32 reg_addr, u64 reg_val,
87 				 struct i40e_asq_cmd_details *cmd_details);
88 int i40e_aq_debug_read_register(struct i40e_hw *hw,
89 				u32  reg_addr, u64 *reg_val,
90 				struct i40e_asq_cmd_details *cmd_details);
91 int i40e_aq_set_phy_debug(struct i40e_hw *hw, u8 cmd_flags,
92 			  struct i40e_asq_cmd_details *cmd_details);
93 int i40e_aq_set_default_vsi(struct i40e_hw *hw, u16 vsi_id,
94 			    struct i40e_asq_cmd_details *cmd_details);
95 int i40e_aq_clear_default_vsi(struct i40e_hw *hw, u16 vsi_id,
96 			      struct i40e_asq_cmd_details *cmd_details);
97 int i40e_aq_get_phy_capabilities(struct i40e_hw *hw,
98 				 bool qualified_modules, bool report_init,
99 				 struct i40e_aq_get_phy_abilities_resp *abilities,
100 				 struct i40e_asq_cmd_details *cmd_details);
101 int i40e_aq_set_phy_config(struct i40e_hw *hw,
102 			   struct i40e_aq_set_phy_config *config,
103 			   struct i40e_asq_cmd_details *cmd_details);
104 int i40e_set_fc(struct i40e_hw *hw, u8 *aq_failures,
105 		bool atomic_reset);
106 int i40e_aq_set_mac_loopback(struct i40e_hw *hw,
107 			     bool ena_lpbk,
108 			     struct i40e_asq_cmd_details *cmd_details);
109 int i40e_aq_set_phy_int_mask(struct i40e_hw *hw, u16 mask,
110 			     struct i40e_asq_cmd_details *cmd_details);
111 int i40e_aq_clear_pxe_mode(struct i40e_hw *hw,
112 			   struct i40e_asq_cmd_details *cmd_details);
113 int i40e_aq_set_link_restart_an(struct i40e_hw *hw,
114 				bool enable_link,
115 				struct i40e_asq_cmd_details *cmd_details);
116 int i40e_aq_get_link_info(struct i40e_hw *hw,
117 			  bool enable_lse, struct i40e_link_status *link,
118 			  struct i40e_asq_cmd_details *cmd_details);
119 int i40e_aq_send_driver_version(struct i40e_hw *hw,
120 				struct i40e_driver_version *dv,
121 				struct i40e_asq_cmd_details *cmd_details);
122 int i40e_aq_add_vsi(struct i40e_hw *hw,
123 		    struct i40e_vsi_context *vsi_ctx,
124 		    struct i40e_asq_cmd_details *cmd_details);
125 int i40e_aq_set_vsi_broadcast(struct i40e_hw *hw,
126 			      u16 vsi_id, bool set_filter,
127 			      struct i40e_asq_cmd_details *cmd_details);
128 int i40e_aq_set_vsi_unicast_promiscuous(struct i40e_hw *hw, u16 vsi_id, bool set,
129 					struct i40e_asq_cmd_details *cmd_details,
130 					bool rx_only_promisc);
131 int i40e_aq_set_vsi_multicast_promiscuous(struct i40e_hw *hw, u16 vsi_id, bool set,
132 					  struct i40e_asq_cmd_details *cmd_details);
133 int i40e_aq_set_vsi_mc_promisc_on_vlan(struct i40e_hw *hw,
134 				       u16 seid, bool enable,
135 				       u16 vid,
136 				       struct i40e_asq_cmd_details *cmd_details);
137 int i40e_aq_set_vsi_uc_promisc_on_vlan(struct i40e_hw *hw,
138 				       u16 seid, bool enable,
139 				       u16 vid,
140 				       struct i40e_asq_cmd_details *cmd_details);
141 int i40e_aq_set_vsi_bc_promisc_on_vlan(struct i40e_hw *hw,
142 				       u16 seid, bool enable, u16 vid,
143 				       struct i40e_asq_cmd_details *cmd_details);
144 int i40e_aq_set_vsi_vlan_promisc(struct i40e_hw *hw,
145 				 u16 seid, bool enable,
146 				 struct i40e_asq_cmd_details *cmd_details);
147 int i40e_aq_get_vsi_params(struct i40e_hw *hw,
148 			   struct i40e_vsi_context *vsi_ctx,
149 			   struct i40e_asq_cmd_details *cmd_details);
150 int i40e_aq_update_vsi_params(struct i40e_hw *hw,
151 			      struct i40e_vsi_context *vsi_ctx,
152 			      struct i40e_asq_cmd_details *cmd_details);
153 int i40e_aq_add_veb(struct i40e_hw *hw, u16 uplink_seid,
154 		    u16 downlink_seid, u8 enabled_tc,
155 		    bool default_port, u16 *pveb_seid,
156 		    bool enable_stats,
157 		    struct i40e_asq_cmd_details *cmd_details);
158 int i40e_aq_get_veb_parameters(struct i40e_hw *hw,
159 			       u16 veb_seid, u16 *switch_id, bool *floating,
160 			       u16 *statistic_index, u16 *vebs_used,
161 			       u16 *vebs_free,
162 			       struct i40e_asq_cmd_details *cmd_details);
163 int i40e_aq_add_macvlan(struct i40e_hw *hw, u16 vsi_id,
164 			struct i40e_aqc_add_macvlan_element_data *mv_list,
165 			u16 count, struct i40e_asq_cmd_details *cmd_details);
166 int
167 i40e_aq_add_macvlan_v2(struct i40e_hw *hw, u16 seid,
168 		       struct i40e_aqc_add_macvlan_element_data *mv_list,
169 		       u16 count, struct i40e_asq_cmd_details *cmd_details,
170 		       enum i40e_admin_queue_err *aq_status);
171 int i40e_aq_remove_macvlan(struct i40e_hw *hw, u16 vsi_id,
172 			   struct i40e_aqc_remove_macvlan_element_data *mv_list,
173 			   u16 count, struct i40e_asq_cmd_details *cmd_details);
174 int
175 i40e_aq_remove_macvlan_v2(struct i40e_hw *hw, u16 seid,
176 			  struct i40e_aqc_remove_macvlan_element_data *mv_list,
177 			  u16 count, struct i40e_asq_cmd_details *cmd_details,
178 			  enum i40e_admin_queue_err *aq_status);
179 int i40e_aq_add_mirrorrule(struct i40e_hw *hw, u16 sw_seid,
180 			   u16 rule_type, u16 dest_vsi, u16 count, __le16 *mr_list,
181 			   struct i40e_asq_cmd_details *cmd_details,
182 			   u16 *rule_id, u16 *rules_used, u16 *rules_free);
183 int i40e_aq_delete_mirrorrule(struct i40e_hw *hw, u16 sw_seid,
184 			      u16 rule_type, u16 rule_id, u16 count, __le16 *mr_list,
185 			      struct i40e_asq_cmd_details *cmd_details,
186 			      u16 *rules_used, u16 *rules_free);
187 
188 int i40e_aq_send_msg_to_vf(struct i40e_hw *hw, u16 vfid,
189 			   u32 v_opcode, u32 v_retval, u8 *msg, u16 msglen,
190 			   struct i40e_asq_cmd_details *cmd_details);
191 int i40e_aq_get_switch_config(struct i40e_hw *hw,
192 			      struct i40e_aqc_get_switch_config_resp *buf,
193 			      u16 buf_size, u16 *start_seid,
194 			      struct i40e_asq_cmd_details *cmd_details);
195 int i40e_aq_set_switch_config(struct i40e_hw *hw,
196 			      u16 flags,
197 			      u16 valid_flags, u8 mode,
198 			      struct i40e_asq_cmd_details *cmd_details);
199 int i40e_aq_request_resource(struct i40e_hw *hw,
200 			     enum i40e_aq_resources_ids resource,
201 			     enum i40e_aq_resource_access_type access,
202 			     u8 sdp_number, u64 *timeout,
203 			     struct i40e_asq_cmd_details *cmd_details);
204 int i40e_aq_release_resource(struct i40e_hw *hw,
205 			     enum i40e_aq_resources_ids resource,
206 			     u8 sdp_number,
207 			     struct i40e_asq_cmd_details *cmd_details);
208 int i40e_aq_read_nvm(struct i40e_hw *hw, u8 module_pointer,
209 		     u32 offset, u16 length, void *data,
210 		     bool last_command,
211 		     struct i40e_asq_cmd_details *cmd_details);
212 int i40e_aq_erase_nvm(struct i40e_hw *hw, u8 module_pointer,
213 		      u32 offset, u16 length, bool last_command,
214 		      struct i40e_asq_cmd_details *cmd_details);
215 int i40e_aq_discover_capabilities(struct i40e_hw *hw,
216 				  void *buff, u16 buff_size, u16 *data_size,
217 				  enum i40e_admin_queue_opc list_type_opc,
218 				  struct i40e_asq_cmd_details *cmd_details);
219 int i40e_aq_update_nvm(struct i40e_hw *hw, u8 module_pointer,
220 		       u32 offset, u16 length, void *data,
221 		       bool last_command, u8 preservation_flags,
222 		       struct i40e_asq_cmd_details *cmd_details);
223 int i40e_aq_rearrange_nvm(struct i40e_hw *hw,
224 			  u8 rearrange_nvm,
225 			  struct i40e_asq_cmd_details *cmd_details);
226 int i40e_aq_get_lldp_mib(struct i40e_hw *hw, u8 bridge_type,
227 			 u8 mib_type, void *buff, u16 buff_size,
228 			 u16 *local_len, u16 *remote_len,
229 			 struct i40e_asq_cmd_details *cmd_details);
230 int
231 i40e_aq_set_lldp_mib(struct i40e_hw *hw,
232 		     u8 mib_type, void *buff, u16 buff_size,
233 		     struct i40e_asq_cmd_details *cmd_details);
234 int i40e_aq_cfg_lldp_mib_change_event(struct i40e_hw *hw,
235 				      bool enable_update,
236 				      struct i40e_asq_cmd_details *cmd_details);
237 int
238 i40e_aq_restore_lldp(struct i40e_hw *hw, u8 *setting, bool restore,
239 		     struct i40e_asq_cmd_details *cmd_details);
240 int i40e_aq_stop_lldp(struct i40e_hw *hw, bool shutdown_agent,
241 		      bool persist,
242 		      struct i40e_asq_cmd_details *cmd_details);
243 int i40e_aq_set_dcb_parameters(struct i40e_hw *hw,
244 			       bool dcb_enable,
245 			       struct i40e_asq_cmd_details
246 			       *cmd_details);
247 int i40e_aq_start_lldp(struct i40e_hw *hw, bool persist,
248 		       struct i40e_asq_cmd_details *cmd_details);
249 int i40e_aq_get_cee_dcb_config(struct i40e_hw *hw,
250 			       void *buff, u16 buff_size,
251 			       struct i40e_asq_cmd_details *cmd_details);
252 int i40e_aq_add_udp_tunnel(struct i40e_hw *hw,
253 			   u16 udp_port, u8 protocol_index,
254 			   u8 *filter_index,
255 			   struct i40e_asq_cmd_details *cmd_details);
256 int i40e_aq_del_udp_tunnel(struct i40e_hw *hw, u8 index,
257 			   struct i40e_asq_cmd_details *cmd_details);
258 int i40e_aq_delete_element(struct i40e_hw *hw, u16 seid,
259 			   struct i40e_asq_cmd_details *cmd_details);
260 int i40e_aq_mac_address_write(struct i40e_hw *hw,
261 			      u16 flags, u8 *mac_addr,
262 			      struct i40e_asq_cmd_details *cmd_details);
263 int i40e_aq_config_vsi_bw_limit(struct i40e_hw *hw,
264 				u16 seid, u16 credit, u8 max_credit,
265 				struct i40e_asq_cmd_details *cmd_details);
266 int i40e_aq_dcb_updated(struct i40e_hw *hw,
267 			struct i40e_asq_cmd_details *cmd_details);
268 int i40e_aq_config_vsi_tc_bw(struct i40e_hw *hw, u16 seid,
269 			     struct i40e_aqc_configure_vsi_tc_bw_data *bw_data,
270 			     struct i40e_asq_cmd_details *cmd_details);
271 int
272 i40e_aq_config_switch_comp_ets(struct i40e_hw *hw,
273 			       u16 seid,
274 			       struct i40e_aqc_configure_switching_comp_ets_data *ets_data,
275 			       enum i40e_admin_queue_opc opcode,
276 			       struct i40e_asq_cmd_details *cmd_details);
277 int i40e_aq_config_switch_comp_bw_config(struct i40e_hw *hw,
278 	u16 seid,
279 	struct i40e_aqc_configure_switching_comp_bw_config_data *bw_data,
280 	struct i40e_asq_cmd_details *cmd_details);
281 int i40e_aq_query_vsi_bw_config(struct i40e_hw *hw,
282 				u16 seid,
283 				struct i40e_aqc_query_vsi_bw_config_resp *bw_data,
284 				struct i40e_asq_cmd_details *cmd_details);
285 int
286 i40e_aq_query_vsi_ets_sla_config(struct i40e_hw *hw,
287 				 u16 seid,
288 				 struct i40e_aqc_query_vsi_ets_sla_config_resp *bw_data,
289 				 struct i40e_asq_cmd_details *cmd_details);
290 int
291 i40e_aq_query_switch_comp_ets_config(struct i40e_hw *hw,
292 				     u16 seid,
293 				     struct i40e_aqc_query_switching_comp_ets_config_resp *bw_data,
294 				     struct i40e_asq_cmd_details *cmd_details);
295 int
296 i40e_aq_query_port_ets_config(struct i40e_hw *hw,
297 			      u16 seid,
298 			      struct i40e_aqc_query_port_ets_config_resp *bw_data,
299 			      struct i40e_asq_cmd_details *cmd_details);
300 int
301 i40e_aq_query_switch_comp_bw_config(struct i40e_hw *hw,
302 				    u16 seid,
303 				    struct i40e_aqc_query_switching_comp_bw_config_resp *bw_data,
304 				    struct i40e_asq_cmd_details *cmd_details);
305 int i40e_aq_resume_port_tx(struct i40e_hw *hw,
306 			   struct i40e_asq_cmd_details *cmd_details);
307 int
308 i40e_aq_add_cloud_filters_bb(struct i40e_hw *hw, u16 seid,
309 			     struct i40e_aqc_cloud_filters_element_bb *filters,
310 			     u8 filter_count);
311 int
312 i40e_aq_add_cloud_filters(struct i40e_hw *hw, u16 vsi,
313 			  struct i40e_aqc_cloud_filters_element_data *filters,
314 			  u8 filter_count);
315 int
316 i40e_aq_rem_cloud_filters(struct i40e_hw *hw, u16 vsi,
317 			  struct i40e_aqc_cloud_filters_element_data *filters,
318 			  u8 filter_count);
319 int
320 i40e_aq_rem_cloud_filters_bb(struct i40e_hw *hw, u16 seid,
321 			     struct i40e_aqc_cloud_filters_element_bb *filters,
322 			     u8 filter_count);
323 int i40e_read_lldp_cfg(struct i40e_hw *hw,
324 		       struct i40e_lldp_variables *lldp_cfg);
325 int
326 i40e_aq_suspend_port_tx(struct i40e_hw *hw, u16 seid,
327 			struct i40e_asq_cmd_details *cmd_details);
328 /* i40e_common */
329 int i40e_init_shared_code(struct i40e_hw *hw);
330 int i40e_pf_reset(struct i40e_hw *hw);
331 void i40e_clear_hw(struct i40e_hw *hw);
332 void i40e_clear_pxe_mode(struct i40e_hw *hw);
333 int i40e_get_link_status(struct i40e_hw *hw, bool *link_up);
334 int i40e_update_link_info(struct i40e_hw *hw);
335 int i40e_get_mac_addr(struct i40e_hw *hw, u8 *mac_addr);
336 int i40e_read_bw_from_alt_ram(struct i40e_hw *hw,
337 			      u32 *max_bw, u32 *min_bw, bool *min_valid,
338 			      bool *max_valid);
339 int
340 i40e_aq_configure_partition_bw(struct i40e_hw *hw,
341 			       struct i40e_aqc_configure_partition_bw_data *bw_data,
342 			       struct i40e_asq_cmd_details *cmd_details);
343 int i40e_get_port_mac_addr(struct i40e_hw *hw, u8 *mac_addr);
344 void i40e_get_pba_string(struct i40e_hw *hw);
345 void i40e_pre_tx_queue_cfg(struct i40e_hw *hw, u32 queue, bool enable);
346 /* prototype for functions used for NVM access */
347 int i40e_init_nvm(struct i40e_hw *hw);
348 int i40e_acquire_nvm(struct i40e_hw *hw,
349 		     enum i40e_aq_resource_access_type access);
350 void i40e_release_nvm(struct i40e_hw *hw);
351 int i40e_read_nvm_word(struct i40e_hw *hw, u16 offset,
352 		       u16 *data);
353 int i40e_read_nvm_module_data(struct i40e_hw *hw,
354 			      u8 module_ptr,
355 			      u16 module_offset,
356 			      u16 data_offset,
357 			      u16 words_data_size,
358 			      u16 *data_ptr);
359 int i40e_read_nvm_buffer(struct i40e_hw *hw, u16 offset,
360 			 u16 *words, u16 *data);
361 int i40e_update_nvm_checksum(struct i40e_hw *hw);
362 int i40e_validate_nvm_checksum(struct i40e_hw *hw,
363 			       u16 *checksum);
364 int i40e_nvmupd_command(struct i40e_hw *hw,
365 			struct i40e_nvm_access *cmd,
366 			u8 *bytes, int *errno);
367 void i40e_nvmupd_check_wait_event(struct i40e_hw *hw, u16 opcode,
368 				  struct i40e_aq_desc *desc);
369 void i40e_nvmupd_clear_wait_state(struct i40e_hw *hw);
370 void i40e_set_pci_config_data(struct i40e_hw *hw, u16 link_status);
371 
372 int i40e_set_mac_type(struct i40e_hw *hw);
373 
374 extern struct i40e_rx_ptype_decoded i40e_ptype_lookup[];
375 
376 static inline struct i40e_rx_ptype_decoded decode_rx_desc_ptype(u8 ptype)
377 {
378 	return i40e_ptype_lookup[ptype];
379 }
380 
381 /**
382  * i40e_virtchnl_link_speed - Convert AdminQ link_speed to virtchnl definition
383  * @link_speed: the speed to convert
384  *
385  * Returns the link_speed in terms of the virtchnl interface, for use in
386  * converting link_speed as reported by the AdminQ into the format used for
387  * talking to virtchnl devices. If we can't represent the link speed properly,
388  * report LINK_SPEED_UNKNOWN.
389  **/
390 static inline enum virtchnl_link_speed
391 i40e_virtchnl_link_speed(enum i40e_aq_link_speed link_speed)
392 {
393 	switch (link_speed) {
394 	case I40E_LINK_SPEED_100MB:
395 		return VIRTCHNL_LINK_SPEED_100MB;
396 	case I40E_LINK_SPEED_1GB:
397 		return VIRTCHNL_LINK_SPEED_1GB;
398 	case I40E_LINK_SPEED_2_5GB:
399 		return VIRTCHNL_LINK_SPEED_2_5GB;
400 	case I40E_LINK_SPEED_5GB:
401 		return VIRTCHNL_LINK_SPEED_5GB;
402 	case I40E_LINK_SPEED_10GB:
403 		return VIRTCHNL_LINK_SPEED_10GB;
404 	case I40E_LINK_SPEED_40GB:
405 		return VIRTCHNL_LINK_SPEED_40GB;
406 	case I40E_LINK_SPEED_20GB:
407 		return VIRTCHNL_LINK_SPEED_20GB;
408 	case I40E_LINK_SPEED_25GB:
409 		return VIRTCHNL_LINK_SPEED_25GB;
410 	case I40E_LINK_SPEED_UNKNOWN:
411 	default:
412 		return VIRTCHNL_LINK_SPEED_UNKNOWN;
413 	}
414 }
415 
416 /* prototype for functions used for SW locks */
417 
418 /* i40e_common for VF drivers*/
419 int i40e_set_filter_control(struct i40e_hw *hw,
420 			    struct i40e_filter_control_settings *settings);
421 int i40e_aq_add_rem_control_packet_filter(struct i40e_hw *hw,
422 					  u8 *mac_addr, u16 ethtype, u16 flags,
423 					  u16 vsi_seid, u16 queue, bool is_add,
424 					  struct i40e_control_filter_stats *stats,
425 					  struct i40e_asq_cmd_details *cmd_details);
426 int i40e_aq_debug_dump(struct i40e_hw *hw, u8 cluster_id,
427 		       u8 table_id, u32 start_index, u16 buff_size,
428 		       void *buff, u16 *ret_buff_size,
429 		       u8 *ret_next_table, u32 *ret_next_index,
430 		       struct i40e_asq_cmd_details *cmd_details);
431 void i40e_add_filter_to_drop_tx_flow_control_frames(struct i40e_hw *hw,
432 						    u16 vsi_seid);
433 int i40e_aq_rx_ctl_read_register(struct i40e_hw *hw,
434 				 u32 reg_addr, u32 *reg_val,
435 				 struct i40e_asq_cmd_details *cmd_details);
436 u32 i40e_read_rx_ctl(struct i40e_hw *hw, u32 reg_addr);
437 int i40e_aq_rx_ctl_write_register(struct i40e_hw *hw,
438 				  u32 reg_addr, u32 reg_val,
439 				  struct i40e_asq_cmd_details *cmd_details);
440 void i40e_write_rx_ctl(struct i40e_hw *hw, u32 reg_addr, u32 reg_val);
441 int
442 i40e_aq_set_phy_register_ext(struct i40e_hw *hw,
443 			     u8 phy_select, u8 dev_addr, bool page_change,
444 			     bool set_mdio, u8 mdio_num,
445 			     u32 reg_addr, u32 reg_val,
446 			     struct i40e_asq_cmd_details *cmd_details);
447 int
448 i40e_aq_get_phy_register_ext(struct i40e_hw *hw,
449 			     u8 phy_select, u8 dev_addr, bool page_change,
450 			     bool set_mdio, u8 mdio_num,
451 			     u32 reg_addr, u32 *reg_val,
452 			     struct i40e_asq_cmd_details *cmd_details);
453 
454 /* Convenience wrappers for most common use case */
455 #define i40e_aq_set_phy_register(hw, ps, da, pc, ra, rv, cd)		\
456 	i40e_aq_set_phy_register_ext(hw, ps, da, pc, false, 0, ra, rv, cd)
457 #define i40e_aq_get_phy_register(hw, ps, da, pc, ra, rv, cd)		\
458 	i40e_aq_get_phy_register_ext(hw, ps, da, pc, false, 0, ra, rv, cd)
459 
460 int i40e_read_phy_register_clause22(struct i40e_hw *hw,
461 				    u16 reg, u8 phy_addr, u16 *value);
462 int i40e_write_phy_register_clause22(struct i40e_hw *hw,
463 				     u16 reg, u8 phy_addr, u16 value);
464 int i40e_read_phy_register_clause45(struct i40e_hw *hw,
465 				    u8 page, u16 reg, u8 phy_addr, u16 *value);
466 int i40e_write_phy_register_clause45(struct i40e_hw *hw,
467 				     u8 page, u16 reg, u8 phy_addr, u16 value);
468 int i40e_read_phy_register(struct i40e_hw *hw, u8 page, u16 reg,
469 			   u8 phy_addr, u16 *value);
470 int i40e_write_phy_register(struct i40e_hw *hw, u8 page, u16 reg,
471 			    u8 phy_addr, u16 value);
472 u8 i40e_get_phy_address(struct i40e_hw *hw, u8 dev_num);
473 int i40e_blink_phy_link_led(struct i40e_hw *hw,
474 			    u32 time, u32 interval);
475 int i40e_aq_write_ddp(struct i40e_hw *hw, void *buff,
476 		      u16 buff_size, u32 track_id,
477 		      u32 *error_offset, u32 *error_info,
478 		      struct i40e_asq_cmd_details *
479 		      cmd_details);
480 int i40e_aq_get_ddp_list(struct i40e_hw *hw, void *buff,
481 			 u16 buff_size, u8 flags,
482 			 struct i40e_asq_cmd_details *
483 			 cmd_details);
484 struct i40e_generic_seg_header *
485 i40e_find_segment_in_package(u32 segment_type,
486 			     struct i40e_package_header *pkg_header);
487 struct i40e_profile_section_header *
488 i40e_find_section_in_profile(u32 section_type,
489 			     struct i40e_profile_segment *profile);
490 int
491 i40e_write_profile(struct i40e_hw *hw, struct i40e_profile_segment *i40e_seg,
492 		   u32 track_id);
493 int
494 i40e_rollback_profile(struct i40e_hw *hw, struct i40e_profile_segment *i40e_seg,
495 		      u32 track_id);
496 int
497 i40e_add_pinfo_to_list(struct i40e_hw *hw,
498 		       struct i40e_profile_segment *profile,
499 		       u8 *profile_info_sec, u32 track_id);
500 
501 /* i40e_ddp */
502 int i40e_ddp_flash(struct net_device *netdev, struct ethtool_flash *flash);
503 
504 /* Firmware and AdminQ version check helpers */
505 
506 /**
507  * i40e_is_aq_api_ver_ge
508  * @hw: pointer to i40e_hw structure
509  * @maj: API major value to compare
510  * @min: API minor value to compare
511  *
512  * Assert whether current HW API version is greater/equal than provided.
513  **/
514 static inline bool i40e_is_aq_api_ver_ge(struct i40e_hw *hw, u16 maj, u16 min)
515 {
516 	return (hw->aq.api_maj_ver > maj ||
517 		(hw->aq.api_maj_ver == maj && hw->aq.api_min_ver >= min));
518 }
519 
520 /**
521  * i40e_is_aq_api_ver_lt
522  * @hw: pointer to i40e_hw structure
523  * @maj: API major value to compare
524  * @min: API minor value to compare
525  *
526  * Assert whether current HW API version is less than provided.
527  **/
528 static inline bool i40e_is_aq_api_ver_lt(struct i40e_hw *hw, u16 maj, u16 min)
529 {
530 	return !i40e_is_aq_api_ver_ge(hw, maj, min);
531 }
532 
533 /**
534  * i40e_is_fw_ver_ge
535  * @hw: pointer to i40e_hw structure
536  * @maj: API major value to compare
537  * @min: API minor value to compare
538  *
539  * Assert whether current firmware version is greater/equal than provided.
540  **/
541 static inline bool i40e_is_fw_ver_ge(struct i40e_hw *hw, u16 maj, u16 min)
542 {
543 	return (hw->aq.fw_maj_ver > maj ||
544 		(hw->aq.fw_maj_ver == maj && hw->aq.fw_min_ver >= min));
545 }
546 
547 /**
548  * i40e_is_fw_ver_lt
549  * @hw: pointer to i40e_hw structure
550  * @maj: API major value to compare
551  * @min: API minor value to compare
552  *
553  * Assert whether current firmware version is less than provided.
554  **/
555 static inline bool i40e_is_fw_ver_lt(struct i40e_hw *hw, u16 maj, u16 min)
556 {
557 	return !i40e_is_fw_ver_ge(hw, maj, min);
558 }
559 
560 /**
561  * i40e_is_fw_ver_eq
562  * @hw: pointer to i40e_hw structure
563  * @maj: API major value to compare
564  * @min: API minor value to compare
565  *
566  * Assert whether current firmware version is equal to provided.
567  **/
568 static inline bool i40e_is_fw_ver_eq(struct i40e_hw *hw, u16 maj, u16 min)
569 {
570 	return (hw->aq.fw_maj_ver > maj ||
571 		(hw->aq.fw_maj_ver == maj && hw->aq.fw_min_ver == min));
572 }
573 
574 #endif /* _I40E_PROTOTYPE_H_ */
575