xref: /dpdk/drivers/net/qede/base/ecore_dev_api.h (revision 25d11a86c56d50947af33d0b79ede622809bd8b9)
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright (c) 2016 - 2018 Cavium Inc.
3  * All rights reserved.
4  * www.cavium.com
5  */
6 
7 #ifndef __ECORE_DEV_API_H__
8 #define __ECORE_DEV_API_H__
9 
10 #include "ecore_status.h"
11 #include "ecore_chain.h"
12 #include "ecore_int_api.h"
13 
14 /**
15  * @brief ecore_init_dp - initialize the debug level
16  *
17  * @param p_dev
18  * @param dp_module
19  * @param dp_level
20  * @param dp_ctx
21  */
22 void ecore_init_dp(struct ecore_dev *p_dev,
23 		   u32 dp_module,
24 		   u8 dp_level,
25 		   void *dp_ctx);
26 
27 /**
28  * @brief ecore_init_struct - initialize the device structure to
29  *        its defaults
30  *
31  * @param p_dev
32  */
33 enum _ecore_status_t ecore_init_struct(struct ecore_dev *p_dev);
34 
35 /**
36  * @brief ecore_resc_free -
37  *
38  * @param p_dev
39  */
40 void ecore_resc_free(struct ecore_dev *p_dev);
41 
42 /**
43  * @brief ecore_resc_alloc -
44  *
45  * @param p_dev
46  *
47  * @return enum _ecore_status_t
48  */
49 enum _ecore_status_t ecore_resc_alloc(struct ecore_dev *p_dev);
50 
51 /**
52  * @brief ecore_resc_setup -
53  *
54  * @param p_dev
55  */
56 void ecore_resc_setup(struct ecore_dev *p_dev);
57 
58 enum ecore_mfw_timeout_fallback {
59 	ECORE_TO_FALLBACK_TO_NONE,
60 	ECORE_TO_FALLBACK_TO_DEFAULT,
61 	ECORE_TO_FALLBACK_FAIL_LOAD,
62 };
63 
64 enum ecore_override_force_load {
65 	ECORE_OVERRIDE_FORCE_LOAD_NONE,
66 	ECORE_OVERRIDE_FORCE_LOAD_ALWAYS,
67 	ECORE_OVERRIDE_FORCE_LOAD_NEVER,
68 };
69 
70 struct ecore_drv_load_params {
71 	/* Indicates whether the driver is running over a crash kernel.
72 	 * As part of the load request, this will be used for providing the
73 	 * driver role to the MFW.
74 	 * In case of a crash kernel over PDA - this should be set to false.
75 	 */
76 	bool is_crash_kernel;
77 
78 	/* The timeout value that the MFW should use when locking the engine for
79 	 * the driver load process.
80 	 * A value of '0' means the default value, and '255' means no timeout.
81 	 */
82 	u8 mfw_timeout_val;
83 #define ECORE_LOAD_REQ_LOCK_TO_DEFAULT	0
84 #define ECORE_LOAD_REQ_LOCK_TO_NONE	255
85 
86 	/* Action to take in case the MFW doesn't support timeout values other
87 	 * than default and none.
88 	 */
89 	enum ecore_mfw_timeout_fallback mfw_timeout_fallback;
90 
91 	/* Avoid engine reset when first PF loads on it */
92 	bool avoid_eng_reset;
93 
94 	/* Allow overriding the default force load behavior */
95 	enum ecore_override_force_load override_force_load;
96 };
97 
98 struct ecore_hw_init_params {
99 	/* Tunneling parameters */
100 	struct ecore_tunnel_info *p_tunn;
101 
102 	bool b_hw_start;
103 
104 	/* Interrupt mode [msix, inta, etc.] to use */
105 	enum ecore_int_mode int_mode;
106 
107 	/* NPAR tx switching to be used for vports configured for tx-switching
108 	 */
109 	bool allow_npar_tx_switch;
110 
111 	/* Binary fw data pointer in binary fw file */
112 	const u8 *bin_fw_data;
113 
114 	/* Driver load parameters */
115 	struct ecore_drv_load_params *p_drv_load_params;
116 
117 	/* Avoid engine affinity for RoCE/storage in case of CMT mode */
118 	bool avoid_eng_affin;
119 
120 	/* SPQ block timeout in msec */
121 	u32 spq_timeout_ms;
122 };
123 
124 /**
125  * @brief ecore_hw_init -
126  *
127  * @param p_dev
128  * @param p_params
129  *
130  * @return enum _ecore_status_t
131  */
132 enum _ecore_status_t ecore_hw_init(struct ecore_dev *p_dev,
133 				   struct ecore_hw_init_params *p_params);
134 
135 /**
136  * @brief ecore_hw_timers_stop_all -
137  *
138  * @param p_dev
139  *
140  * @return void
141  */
142 void ecore_hw_timers_stop_all(struct ecore_dev *p_dev);
143 
144 /**
145  * @brief ecore_hw_stop -
146  *
147  * @param p_dev
148  *
149  * @return enum _ecore_status_t
150  */
151 enum _ecore_status_t ecore_hw_stop(struct ecore_dev *p_dev);
152 
153 /**
154  * @brief ecore_hw_stop_fastpath -should be called incase
155  *        slowpath is still required for the device,
156  *        but fastpath is not.
157  *
158  * @param p_dev
159  *
160  * @return enum _ecore_status_t
161  */
162 enum _ecore_status_t ecore_hw_stop_fastpath(struct ecore_dev *p_dev);
163 
164 #ifndef LINUX_REMOVE
165 /**
166  * @brief ecore_prepare_hibernate -should be called when
167  *        the system is going into the hibernate state
168  *
169  * @param p_dev
170  *
171  */
172 void ecore_prepare_hibernate(struct ecore_dev *p_dev);
173 
174 enum ecore_db_rec_width {
175 	DB_REC_WIDTH_32B,
176 	DB_REC_WIDTH_64B,
177 };
178 
179 enum ecore_db_rec_space {
180 	DB_REC_KERNEL,
181 	DB_REC_USER,
182 };
183 
184 /**
185  * @brief db_recovery_add - add doorbell information to the doorbell
186  * recovery mechanism.
187  *
188  * @param p_dev
189  * @param db_addr - doorbell address
190  * @param db_data - address of where db_data is stored
191  * @param db_width - doorbell is 32b pr 64b
192  * @param db_space - doorbell recovery addresses are user or kernel space
193  */
194 enum _ecore_status_t ecore_db_recovery_add(struct ecore_dev *p_dev,
195 					   void OSAL_IOMEM *db_addr,
196 					   void *db_data,
197 					   enum ecore_db_rec_width db_width,
198 					   enum ecore_db_rec_space db_space);
199 
200 /**
201  * @brief db_recovery_del - remove doorbell information from the doorbell
202  * recovery mechanism. db_data serves as key (db_addr is not unique).
203  *
204  * @param cdev
205  * @param db_addr - doorbell address
206  * @param db_data - address where db_data is stored. Serves as key for the
207  *                  entry to delete.
208  */
209 enum _ecore_status_t ecore_db_recovery_del(struct ecore_dev *p_dev,
210 					   void OSAL_IOMEM *db_addr,
211 					   void *db_data);
212 
213 static OSAL_INLINE bool ecore_is_mf_ufp(struct ecore_hwfn *p_hwfn)
214 {
215 	return !!OSAL_TEST_BIT(ECORE_MF_UFP_SPECIFIC, &p_hwfn->p_dev->mf_bits);
216 }
217 
218 #endif
219 
220 /**
221  * @brief ecore_hw_start_fastpath -restart fastpath traffic,
222  *        only if hw_stop_fastpath was called
223 
224  * @param p_hwfn
225  *
226  * @return enum _ecore_status_t
227  */
228 enum _ecore_status_t ecore_hw_start_fastpath(struct ecore_hwfn *p_hwfn);
229 
230 enum ecore_hw_prepare_result {
231 	ECORE_HW_PREPARE_SUCCESS,
232 
233 	/* FAILED results indicate probe has failed & cleaned up */
234 	ECORE_HW_PREPARE_FAILED_ENG2,
235 	ECORE_HW_PREPARE_FAILED_ME,
236 	ECORE_HW_PREPARE_FAILED_MEM,
237 	ECORE_HW_PREPARE_FAILED_DEV,
238 	ECORE_HW_PREPARE_FAILED_NVM,
239 
240 	/* BAD results indicate probe is passed even though some wrongness
241 	 * has occurred; Trying to actually use [I.e., hw_init()] might have
242 	 * dire reprecautions.
243 	 */
244 	ECORE_HW_PREPARE_BAD_IOV,
245 	ECORE_HW_PREPARE_BAD_MCP,
246 	ECORE_HW_PREPARE_BAD_IGU,
247 };
248 
249 struct ecore_hw_prepare_params {
250 	/* Personality to initialize */
251 	int personality;
252 
253 	/* Force the driver's default resource allocation */
254 	bool drv_resc_alloc;
255 
256 	/* Check the reg_fifo after any register access */
257 	bool chk_reg_fifo;
258 
259 	/* Request the MFW to initiate PF FLR */
260 	bool initiate_pf_flr;
261 
262 	/* The OS Epoch time in seconds */
263 	u32 epoch;
264 
265 	/* Allow the MFW to collect a crash dump */
266 	bool allow_mdump;
267 
268 	/* Allow prepare to pass even if some initializations are failing.
269 	 * If set, the `p_prepare_res' field would be set with the return,
270 	 * and might allow probe to pass even if there are certain issues.
271 	 */
272 	bool b_relaxed_probe;
273 	enum ecore_hw_prepare_result p_relaxed_res;
274 
275 	/* Enable/disable request by ecore client for pacing */
276 	bool b_en_pacing;
277 
278 	/* Indicates whether this PF serves a storage target */
279 	bool b_is_target;
280 };
281 
282 /**
283  * @brief ecore_hw_prepare -
284  *
285  * @param p_dev
286  * @param p_params
287  *
288  * @return enum _ecore_status_t
289  */
290 enum _ecore_status_t ecore_hw_prepare(struct ecore_dev *p_dev,
291 				      struct ecore_hw_prepare_params *p_params);
292 
293 /**
294  * @brief ecore_hw_remove -
295  *
296  * @param p_dev
297  */
298 void ecore_hw_remove(struct ecore_dev *p_dev);
299 
300 /**
301  * @brief ecore_ptt_acquire - Allocate a PTT window
302  *
303  * Should be called at the entry point to the driver (at the beginning of an
304  * exported function)
305  *
306  * @param p_hwfn
307  *
308  * @return struct ecore_ptt
309  */
310 struct ecore_ptt *ecore_ptt_acquire(struct ecore_hwfn *p_hwfn);
311 
312 /**
313  * @brief ecore_ptt_release - Release PTT Window
314  *
315  * Should be called at the end of a flow - at the end of the function that
316  * acquired the PTT.
317  *
318  *
319  * @param p_hwfn
320  * @param p_ptt
321  */
322 void ecore_ptt_release(struct ecore_hwfn *p_hwfn,
323 		       struct ecore_ptt *p_ptt);
324 
325 struct ecore_eth_stats_common {
326 	u64 no_buff_discards;
327 	u64 packet_too_big_discard;
328 	u64 ttl0_discard;
329 	u64 rx_ucast_bytes;
330 	u64 rx_mcast_bytes;
331 	u64 rx_bcast_bytes;
332 	u64 rx_ucast_pkts;
333 	u64 rx_mcast_pkts;
334 	u64 rx_bcast_pkts;
335 	u64 mftag_filter_discards;
336 	u64 mac_filter_discards;
337 	u64 tx_ucast_bytes;
338 	u64 tx_mcast_bytes;
339 	u64 tx_bcast_bytes;
340 	u64 tx_ucast_pkts;
341 	u64 tx_mcast_pkts;
342 	u64 tx_bcast_pkts;
343 	u64 tx_err_drop_pkts;
344 	u64 tpa_coalesced_pkts;
345 	u64 tpa_coalesced_events;
346 	u64 tpa_aborts_num;
347 	u64 tpa_not_coalesced_pkts;
348 	u64 tpa_coalesced_bytes;
349 
350 	/* port */
351 	u64 rx_64_byte_packets;
352 	u64 rx_65_to_127_byte_packets;
353 	u64 rx_128_to_255_byte_packets;
354 	u64 rx_256_to_511_byte_packets;
355 	u64 rx_512_to_1023_byte_packets;
356 	u64 rx_1024_to_1518_byte_packets;
357 	u64 rx_crc_errors;
358 	u64 rx_mac_crtl_frames;
359 	u64 rx_pause_frames;
360 	u64 rx_pfc_frames;
361 	u64 rx_align_errors;
362 	u64 rx_carrier_errors;
363 	u64 rx_oversize_packets;
364 	u64 rx_jabbers;
365 	u64 rx_undersize_packets;
366 	u64 rx_fragments;
367 	u64 tx_64_byte_packets;
368 	u64 tx_65_to_127_byte_packets;
369 	u64 tx_128_to_255_byte_packets;
370 	u64 tx_256_to_511_byte_packets;
371 	u64 tx_512_to_1023_byte_packets;
372 	u64 tx_1024_to_1518_byte_packets;
373 	u64 tx_pause_frames;
374 	u64 tx_pfc_frames;
375 	u64 brb_truncates;
376 	u64 brb_discards;
377 	u64 rx_mac_bytes;
378 	u64 rx_mac_uc_packets;
379 	u64 rx_mac_mc_packets;
380 	u64 rx_mac_bc_packets;
381 	u64 rx_mac_frames_ok;
382 	u64 tx_mac_bytes;
383 	u64 tx_mac_uc_packets;
384 	u64 tx_mac_mc_packets;
385 	u64 tx_mac_bc_packets;
386 	u64 tx_mac_ctrl_frames;
387 	u64 link_change_count;
388 };
389 
390 struct ecore_eth_stats_bb {
391 	u64 rx_1519_to_1522_byte_packets;
392 	u64 rx_1519_to_2047_byte_packets;
393 	u64 rx_2048_to_4095_byte_packets;
394 	u64 rx_4096_to_9216_byte_packets;
395 	u64 rx_9217_to_16383_byte_packets;
396 	u64 tx_1519_to_2047_byte_packets;
397 	u64 tx_2048_to_4095_byte_packets;
398 	u64 tx_4096_to_9216_byte_packets;
399 	u64 tx_9217_to_16383_byte_packets;
400 	u64 tx_lpi_entry_count;
401 	u64 tx_total_collisions;
402 };
403 
404 struct ecore_eth_stats_ah {
405 	u64 rx_1519_to_max_byte_packets;
406 	u64 tx_1519_to_max_byte_packets;
407 };
408 
409 struct ecore_eth_stats {
410 	struct ecore_eth_stats_common common;
411 	union {
412 		struct ecore_eth_stats_bb bb;
413 		struct ecore_eth_stats_ah ah;
414 	};
415 };
416 
417 enum ecore_dmae_address_type_t {
418 	ECORE_DMAE_ADDRESS_HOST_VIRT,
419 	ECORE_DMAE_ADDRESS_HOST_PHYS,
420 	ECORE_DMAE_ADDRESS_GRC
421 };
422 
423 /* value of flags If ECORE_DMAE_FLAG_RW_REPL_SRC flag is set and the
424  * source is a block of length DMAE_MAX_RW_SIZE and the
425  * destination is larger, the source block will be duplicated as
426  * many times as required to fill the destination block. This is
427  * used mostly to write a zeroed buffer to destination address
428  * using DMA
429  */
430 #define ECORE_DMAE_FLAG_RW_REPL_SRC	0x00000001
431 #define ECORE_DMAE_FLAG_VF_SRC		0x00000002
432 #define ECORE_DMAE_FLAG_VF_DST		0x00000004
433 #define ECORE_DMAE_FLAG_COMPLETION_DST	0x00000008
434 #define ECORE_DMAE_FLAG_PORT		0x00000010
435 #define ECORE_DMAE_FLAG_PF_SRC		0x00000020
436 #define ECORE_DMAE_FLAG_PF_DST		0x00000040
437 
438 struct ecore_dmae_params {
439 	u32 flags; /* consists of ECORE_DMAE_FLAG_* values */
440 	u8 src_vfid;
441 	u8 dst_vfid;
442 	u8 port_id;
443 	u8 src_pfid;
444 	u8 dst_pfid;
445 };
446 
447 /**
448  * @brief ecore_dmae_host2grc - copy data from source addr to
449  * dmae registers using the given ptt
450  *
451  * @param p_hwfn
452  * @param p_ptt
453  * @param source_addr
454  * @param grc_addr (dmae_data_offset)
455  * @param size_in_dwords
456  * @param p_params (default parameters will be used in case of OSAL_NULL)
457  *
458  * @return enum _ecore_status_t
459  */
460 enum _ecore_status_t
461 ecore_dmae_host2grc(struct ecore_hwfn *p_hwfn,
462 		    struct ecore_ptt *p_ptt,
463 		    u64 source_addr,
464 		    u32 grc_addr,
465 		    u32 size_in_dwords,
466 		    struct ecore_dmae_params *p_params);
467 
468 /**
469  * @brief ecore_dmae_grc2host - Read data from dmae data offset
470  * to source address using the given ptt
471  *
472  * @param p_ptt
473  * @param grc_addr (dmae_data_offset)
474  * @param dest_addr
475  * @param size_in_dwords
476  * @param p_params (default parameters will be used in case of OSAL_NULL)
477  *
478  * @return enum _ecore_status_t
479  */
480 enum _ecore_status_t
481 ecore_dmae_grc2host(struct ecore_hwfn *p_hwfn,
482 		    struct ecore_ptt *p_ptt,
483 		    u32 grc_addr,
484 		    dma_addr_t dest_addr,
485 		    u32 size_in_dwords,
486 		    struct ecore_dmae_params *p_params);
487 
488 /**
489  * @brief ecore_dmae_host2host - copy data from to source address
490  * to a destination address (for SRIOV) using the given ptt
491  *
492  * @param p_hwfn
493  * @param p_ptt
494  * @param source_addr
495  * @param dest_addr
496  * @param size_in_dwords
497  * @param p_params (default parameters will be used in case of OSAL_NULL)
498  *
499  * @return enum _ecore_status_t
500  */
501 enum _ecore_status_t
502 ecore_dmae_host2host(struct ecore_hwfn *p_hwfn,
503 		     struct ecore_ptt *p_ptt,
504 		     dma_addr_t source_addr,
505 		     dma_addr_t dest_addr,
506 		     u32 size_in_dwords,
507 		     struct ecore_dmae_params *p_params);
508 
509 /**
510  * @brief ecore_chain_alloc - Allocate and initialize a chain
511  *
512  * @param p_hwfn
513  * @param intended_use
514  * @param mode
515  * @param num_elems
516  * @param elem_size
517  * @param p_chain
518  *
519  * @return enum _ecore_status_t
520  */
521 enum _ecore_status_t
522 ecore_chain_alloc(struct ecore_dev *p_dev,
523 		  enum ecore_chain_use_mode intended_use,
524 		  enum ecore_chain_mode mode,
525 		  enum ecore_chain_cnt_type cnt_type,
526 		  u32 num_elems,
527 		  osal_size_t elem_size,
528 		  struct ecore_chain *p_chain,
529 		  struct ecore_chain_ext_pbl *ext_pbl);
530 
531 /**
532  * @brief ecore_chain_free - Free chain DMA memory
533  *
534  * @param p_hwfn
535  * @param p_chain
536  */
537 void ecore_chain_free(struct ecore_dev *p_dev,
538 		      struct ecore_chain *p_chain);
539 
540 /**
541  * @@brief ecore_fw_l2_queue - Get absolute L2 queue ID
542  *
543  *  @param p_hwfn
544  *  @param src_id - relative to p_hwfn
545  *  @param dst_id - absolute per engine
546  *
547  *  @return enum _ecore_status_t
548  */
549 enum _ecore_status_t ecore_fw_l2_queue(struct ecore_hwfn *p_hwfn,
550 				       u16 src_id,
551 				       u16 *dst_id);
552 
553 /**
554  * @@brief ecore_fw_vport - Get absolute vport ID
555  *
556  *  @param p_hwfn
557  *  @param src_id - relative to p_hwfn
558  *  @param dst_id - absolute per engine
559  *
560  *  @return enum _ecore_status_t
561  */
562 enum _ecore_status_t ecore_fw_vport(struct ecore_hwfn *p_hwfn,
563 				    u8 src_id,
564 				    u8 *dst_id);
565 
566 /**
567  * @@brief ecore_fw_rss_eng - Get absolute RSS engine ID
568  *
569  *  @param p_hwfn
570  *  @param src_id - relative to p_hwfn
571  *  @param dst_id - absolute per engine
572  *
573  *  @return enum _ecore_status_t
574  */
575 enum _ecore_status_t ecore_fw_rss_eng(struct ecore_hwfn *p_hwfn,
576 				      u8 src_id,
577 				      u8 *dst_id);
578 
579 /**
580  * @brief ecore_llh_get_num_ppfid - Return the allocated number of LLH filter
581  *	banks that are allocated to the PF.
582  *
583  * @param p_dev
584  *
585  * @return u8 - Number of LLH filter banks
586  */
587 u8 ecore_llh_get_num_ppfid(struct ecore_dev *p_dev);
588 
589 enum ecore_eng {
590 	ECORE_ENG0,
591 	ECORE_ENG1,
592 	ECORE_BOTH_ENG,
593 };
594 
595 /**
596  * @brief ecore_llh_get_l2_affinity_hint - Return the hint for the L2 affinity
597  *
598  * @param p_dev
599  *
600  * @return enum ecore_eng - L2 affintiy hint
601  */
602 enum ecore_eng ecore_llh_get_l2_affinity_hint(struct ecore_dev *p_dev);
603 
604 /**
605  * @brief ecore_llh_set_ppfid_affinity - Set the engine affinity for the given
606  *	LLH filter bank.
607  *
608  * @param p_dev
609  * @param ppfid - relative within the allocated ppfids ('0' is the default one).
610  * @param eng
611  *
612  * @return enum _ecore_status_t
613  */
614 enum _ecore_status_t ecore_llh_set_ppfid_affinity(struct ecore_dev *p_dev,
615 						  u8 ppfid, enum ecore_eng eng);
616 
617 /**
618  * @brief ecore_llh_set_roce_affinity - Set the RoCE engine affinity
619  *
620  * @param p_dev
621  * @param eng
622  *
623  * @return enum _ecore_status_t
624  */
625 enum _ecore_status_t ecore_llh_set_roce_affinity(struct ecore_dev *p_dev,
626 						 enum ecore_eng eng);
627 
628 /**
629  * @brief ecore_llh_add_mac_filter - Add a LLH MAC filter into the given filter
630  *	bank.
631  *
632  * @param p_dev
633  * @param ppfid - relative within the allocated ppfids ('0' is the default one).
634  * @param mac_addr - MAC to add
635  *
636  * @return enum _ecore_status_t
637  */
638 enum _ecore_status_t ecore_llh_add_mac_filter(struct ecore_dev *p_dev, u8 ppfid,
639 					      u8 mac_addr[ETH_ALEN]);
640 
641 /**
642  * @brief ecore_llh_remove_mac_filter - Remove a LLH MAC filter from the given
643  *	filter bank.
644  *
645  * @param p_dev
646  * @param ppfid - relative within the allocated ppfids ('0' is the default one).
647  * @param mac_addr - MAC to remove
648  */
649 void ecore_llh_remove_mac_filter(struct ecore_dev *p_dev, u8 ppfid,
650 				 u8 mac_addr[ETH_ALEN]);
651 
652 enum ecore_llh_prot_filter_type_t {
653 	ECORE_LLH_FILTER_ETHERTYPE,
654 	ECORE_LLH_FILTER_TCP_SRC_PORT,
655 	ECORE_LLH_FILTER_TCP_DEST_PORT,
656 	ECORE_LLH_FILTER_TCP_SRC_AND_DEST_PORT,
657 	ECORE_LLH_FILTER_UDP_SRC_PORT,
658 	ECORE_LLH_FILTER_UDP_DEST_PORT,
659 	ECORE_LLH_FILTER_UDP_SRC_AND_DEST_PORT
660 };
661 
662 /**
663  * @brief ecore_llh_add_protocol_filter - Add a LLH protocol filter into the
664  *	given filter bank.
665  *
666  * @param p_dev
667  * @param ppfid - relative within the allocated ppfids ('0' is the default one).
668  * @param type - type of filters and comparing
669  * @param source_port_or_eth_type - source port or ethertype to add
670  * @param dest_port - destination port to add
671  *
672  * @return enum _ecore_status_t
673  */
674 enum _ecore_status_t
675 ecore_llh_add_protocol_filter(struct ecore_dev *p_dev, u8 ppfid,
676 			      enum ecore_llh_prot_filter_type_t type,
677 			      u16 source_port_or_eth_type, u16 dest_port);
678 
679 /**
680  * @brief ecore_llh_remove_protocol_filter - Remove a LLH protocol filter from
681  *	the given filter bank.
682  *
683  * @param p_dev
684  * @param ppfid - relative within the allocated ppfids ('0' is the default one).
685  * @param type - type of filters and comparing
686  * @param source_port_or_eth_type - source port or ethertype to add
687  * @param dest_port - destination port to add
688  */
689 void ecore_llh_remove_protocol_filter(struct ecore_dev *p_dev, u8 ppfid,
690 				      enum ecore_llh_prot_filter_type_t type,
691 				      u16 source_port_or_eth_type,
692 				      u16 dest_port);
693 
694 /**
695  * @brief ecore_llh_clear_ppfid_filters - Remove all LLH filters from the given
696  *	filter bank.
697  *
698  * @param p_dev
699  * @param ppfid - relative within the allocated ppfids ('0' is the default one).
700  */
701 void ecore_llh_clear_ppfid_filters(struct ecore_dev *p_dev, u8 ppfid);
702 
703 /**
704  * @brief ecore_llh_clear_all_filters - Remove all LLH filters
705  *
706  * @param p_dev
707  */
708 void ecore_llh_clear_all_filters(struct ecore_dev *p_dev);
709 
710 /**
711  * @brief ecore_llh_set_function_as_default - set function as default per port
712  *
713  * @param p_hwfn
714  * @param p_ptt
715  */
716 enum _ecore_status_t
717 ecore_llh_set_function_as_default(struct ecore_hwfn *p_hwfn,
718 				  struct ecore_ptt *p_ptt);
719 
720 /**
721  *@brief Cleanup of previous driver remains prior to load
722  *
723  * @param p_hwfn
724  * @param p_ptt
725  * @param id - For PF, engine-relative. For VF, PF-relative.
726  * @param is_vf - true iff cleanup is made for a VF.
727  *
728  * @return enum _ecore_status_t
729  */
730 enum _ecore_status_t ecore_final_cleanup(struct ecore_hwfn	*p_hwfn,
731 					 struct ecore_ptt	*p_ptt,
732 					 u16			id,
733 					 bool			is_vf);
734 
735 /**
736  * @brief ecore_get_queue_coalesce - Retrieve coalesce value for a given queue.
737  *
738  * @param p_hwfn
739  * @param p_coal - store coalesce value read from the hardware.
740  * @param p_handle
741  *
742  * @return enum _ecore_status_t
743  **/
744 enum _ecore_status_t
745 ecore_get_queue_coalesce(struct ecore_hwfn *p_hwfn, u16 *coal,
746 			 void *handle);
747 
748 /**
749  * @brief ecore_set_queue_coalesce - Configure coalesce parameters for Rx and
750  *    Tx queue. The fact that we can configure coalescing to up to 511, but on
751  *    varying accuracy [the bigger the value the less accurate] up to a mistake
752  *    of 3usec for the highest values.
753  *    While the API allows setting coalescing per-qid, all queues sharing a SB
754  *    should be in same range [i.e., either 0-0x7f, 0x80-0xff or 0x100-0x1ff]
755  *    otherwise configuration would break.
756  *
757  * @param p_hwfn
758  * @param rx_coal - Rx Coalesce value in micro seconds.
759  * @param tx_coal - TX Coalesce value in micro seconds.
760  * @param p_handle
761  *
762  * @return enum _ecore_status_t
763  **/
764 enum _ecore_status_t
765 ecore_set_queue_coalesce(struct ecore_hwfn *p_hwfn, u16 rx_coal,
766 			 u16 tx_coal, void *p_handle);
767 
768 /**
769  * @brief ecore_pglueb_set_pfid_enable - Enable or disable PCI BUS MASTER
770  *
771  * @param p_hwfn
772  * @param p_ptt
773  * @param b_enable - true/false
774  *
775  * @return enum _ecore_status_t
776  */
777 enum _ecore_status_t ecore_pglueb_set_pfid_enable(struct ecore_hwfn *p_hwfn,
778 						  struct ecore_ptt *p_ptt,
779 						  bool b_enable);
780 
781 /**
782  * @brief Whether FIP discovery fallback special mode is enabled or not.
783  *
784  * @param cdev
785  *
786  * @return true if device is in FIP special mode, false otherwise.
787  */
788 bool ecore_is_mf_fip_special(struct ecore_dev *p_dev);
789 #endif
790