1 /*-
2  * Copyright (c) 2006-2016 Solarflare Communications Inc.
3  * All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright notice,
9  *    this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright notice,
11  *    this list of conditions and the following disclaimer in the documentation
12  *    and/or other materials provided with the distribution.
13  *
14  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
15  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
16  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
18  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
21  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
22  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
23  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
24  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25  *
26  * The views and conclusions contained in the software and documentation are
27  * those of the authors and should not be interpreted as representing official
28  * policies, either expressed or implied, of the FreeBSD Project.
29  *
30  * $FreeBSD: stable/10/sys/dev/sfxge/common/efx.h 342524 2018-12-26 10:37:06Z arybchik $
31  */
32 
33 #ifndef	_SYS_EFX_H
34 #define	_SYS_EFX_H
35 
36 #include "efsys.h"
37 #include "efx_check.h"
38 #include "efx_phy_ids.h"
39 
40 #ifdef	__cplusplus
41 extern "C" {
42 #endif
43 
44 #define	EFX_STATIC_ASSERT(_cond)		\
45 	((void)sizeof(char[(_cond) ? 1 : -1]))
46 
47 #define	EFX_ARRAY_SIZE(_array)			\
48 	(sizeof(_array) / sizeof((_array)[0]))
49 
50 #define	EFX_FIELD_OFFSET(_type, _field)		\
51 	((size_t) &(((_type *)0)->_field))
52 
53 /* Return codes */
54 
55 typedef __success(return == 0) int efx_rc_t;
56 
57 
58 /* Chip families */
59 
60 typedef enum efx_family_e {
61 	EFX_FAMILY_INVALID,
62 	EFX_FAMILY_FALCON,	/* Obsolete and not supported */
63 	EFX_FAMILY_SIENA,
64 	EFX_FAMILY_HUNTINGTON,
65 	EFX_FAMILY_MEDFORD,
66 	EFX_FAMILY_NTYPES
67 } efx_family_t;
68 
69 extern	__checkReturn	efx_rc_t
70 efx_family(
71 	__in		uint16_t venid,
72 	__in		uint16_t devid,
73 	__out		efx_family_t *efp);
74 
75 
76 #define	EFX_PCI_VENID_SFC			0x1924
77 
78 #define	EFX_PCI_DEVID_FALCON			0x0710	/* SFC4000 */
79 
80 #define	EFX_PCI_DEVID_BETHPAGE			0x0803	/* SFC9020 */
81 #define	EFX_PCI_DEVID_SIENA			0x0813	/* SFL9021 */
82 #define	EFX_PCI_DEVID_SIENA_F1_UNINIT		0x0810
83 
84 #define	EFX_PCI_DEVID_HUNTINGTON_PF_UNINIT	0x0901
85 #define	EFX_PCI_DEVID_FARMINGDALE		0x0903	/* SFC9120 PF */
86 #define	EFX_PCI_DEVID_GREENPORT			0x0923	/* SFC9140 PF */
87 
88 #define	EFX_PCI_DEVID_FARMINGDALE_VF		0x1903	/* SFC9120 VF */
89 #define	EFX_PCI_DEVID_GREENPORT_VF		0x1923	/* SFC9140 VF */
90 
91 #define	EFX_PCI_DEVID_MEDFORD_PF_UNINIT		0x0913
92 #define	EFX_PCI_DEVID_MEDFORD			0x0A03	/* SFC9240 PF */
93 #define	EFX_PCI_DEVID_MEDFORD_VF		0x1A03	/* SFC9240 VF */
94 
95 #define	EFX_MEM_BAR	2
96 
97 /* Error codes */
98 
99 enum {
100 	EFX_ERR_INVALID,
101 	EFX_ERR_SRAM_OOB,
102 	EFX_ERR_BUFID_DC_OOB,
103 	EFX_ERR_MEM_PERR,
104 	EFX_ERR_RBUF_OWN,
105 	EFX_ERR_TBUF_OWN,
106 	EFX_ERR_RDESQ_OWN,
107 	EFX_ERR_TDESQ_OWN,
108 	EFX_ERR_EVQ_OWN,
109 	EFX_ERR_EVFF_OFLO,
110 	EFX_ERR_ILL_ADDR,
111 	EFX_ERR_SRAM_PERR,
112 	EFX_ERR_NCODES
113 };
114 
115 /* Calculate the IEEE 802.3 CRC32 of a MAC addr */
116 extern	__checkReturn		uint32_t
117 efx_crc32_calculate(
118 	__in			uint32_t crc_init,
119 	__in_ecount(length)	uint8_t const *input,
120 	__in			int length);
121 
122 
123 /* Type prototypes */
124 
125 typedef struct efx_rxq_s	efx_rxq_t;
126 
127 /* NIC */
128 
129 typedef struct efx_nic_s	efx_nic_t;
130 
131 extern	__checkReturn	efx_rc_t
132 efx_nic_create(
133 	__in		efx_family_t family,
134 	__in		efsys_identifier_t *esip,
135 	__in		efsys_bar_t *esbp,
136 	__in		efsys_lock_t *eslp,
137 	__deref_out	efx_nic_t **enpp);
138 
139 extern	__checkReturn	efx_rc_t
140 efx_nic_probe(
141 	__in		efx_nic_t *enp);
142 
143 extern	__checkReturn	efx_rc_t
144 efx_nic_init(
145 	__in		efx_nic_t *enp);
146 
147 extern	__checkReturn	efx_rc_t
148 efx_nic_reset(
149 	__in		efx_nic_t *enp);
150 
151 #if EFSYS_OPT_DIAG
152 
153 extern	__checkReturn	efx_rc_t
154 efx_nic_register_test(
155 	__in		efx_nic_t *enp);
156 
157 #endif	/* EFSYS_OPT_DIAG */
158 
159 extern		void
160 efx_nic_fini(
161 	__in		efx_nic_t *enp);
162 
163 extern		void
164 efx_nic_unprobe(
165 	__in		efx_nic_t *enp);
166 
167 extern		void
168 efx_nic_destroy(
169 	__in	efx_nic_t *enp);
170 
171 #define	EFX_PCIE_LINK_SPEED_GEN1		1
172 #define	EFX_PCIE_LINK_SPEED_GEN2		2
173 #define	EFX_PCIE_LINK_SPEED_GEN3		3
174 
175 typedef enum efx_pcie_link_performance_e {
176 	EFX_PCIE_LINK_PERFORMANCE_UNKNOWN_BANDWIDTH,
177 	EFX_PCIE_LINK_PERFORMANCE_SUBOPTIMAL_BANDWIDTH,
178 	EFX_PCIE_LINK_PERFORMANCE_SUBOPTIMAL_LATENCY,
179 	EFX_PCIE_LINK_PERFORMANCE_OPTIMAL
180 } efx_pcie_link_performance_t;
181 
182 extern	__checkReturn	efx_rc_t
183 efx_nic_calculate_pcie_link_bandwidth(
184 	__in		uint32_t pcie_link_width,
185 	__in		uint32_t pcie_link_gen,
186 	__out		uint32_t *bandwidth_mbpsp);
187 
188 extern	__checkReturn	efx_rc_t
189 efx_nic_check_pcie_link_speed(
190 	__in		efx_nic_t *enp,
191 	__in		uint32_t pcie_link_width,
192 	__in		uint32_t pcie_link_gen,
193 	__out		efx_pcie_link_performance_t *resultp);
194 
195 #if EFSYS_OPT_MCDI
196 
197 #if EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD
198 /* Huntington and Medford require MCDIv2 commands */
199 #define	WITH_MCDI_V2 1
200 #endif
201 
202 typedef struct efx_mcdi_req_s efx_mcdi_req_t;
203 
204 typedef enum efx_mcdi_exception_e {
205 	EFX_MCDI_EXCEPTION_MC_REBOOT,
206 	EFX_MCDI_EXCEPTION_MC_BADASSERT,
207 } efx_mcdi_exception_t;
208 
209 #if EFSYS_OPT_MCDI_LOGGING
210 typedef enum efx_log_msg_e {
211 	EFX_LOG_INVALID,
212 	EFX_LOG_MCDI_REQUEST,
213 	EFX_LOG_MCDI_RESPONSE,
214 } efx_log_msg_t;
215 #endif /* EFSYS_OPT_MCDI_LOGGING */
216 
217 typedef struct efx_mcdi_transport_s {
218 	void		*emt_context;
219 	efsys_mem_t	*emt_dma_mem;
220 	void		(*emt_execute)(void *, efx_mcdi_req_t *);
221 	void		(*emt_ev_cpl)(void *);
222 	void		(*emt_exception)(void *, efx_mcdi_exception_t);
223 #if EFSYS_OPT_MCDI_LOGGING
224 	void		(*emt_logger)(void *, efx_log_msg_t,
225 					void *, size_t, void *, size_t);
226 #endif /* EFSYS_OPT_MCDI_LOGGING */
227 #if EFSYS_OPT_MCDI_PROXY_AUTH
228 	void		(*emt_ev_proxy_response)(void *, uint32_t, efx_rc_t);
229 #endif /* EFSYS_OPT_MCDI_PROXY_AUTH */
230 } efx_mcdi_transport_t;
231 
232 extern	__checkReturn	efx_rc_t
233 efx_mcdi_init(
234 	__in		efx_nic_t *enp,
235 	__in		const efx_mcdi_transport_t *mtp);
236 
237 extern	__checkReturn	efx_rc_t
238 efx_mcdi_reboot(
239 	__in		efx_nic_t *enp);
240 
241 			void
242 efx_mcdi_new_epoch(
243 	__in		efx_nic_t *enp);
244 
245 extern			void
246 efx_mcdi_get_timeout(
247 	__in		efx_nic_t *enp,
248 	__in		efx_mcdi_req_t *emrp,
249 	__out		uint32_t *usec_timeoutp);
250 
251 extern			void
252 efx_mcdi_request_start(
253 	__in		efx_nic_t *enp,
254 	__in		efx_mcdi_req_t *emrp,
255 	__in		boolean_t ev_cpl);
256 
257 extern	__checkReturn	boolean_t
258 efx_mcdi_request_poll(
259 	__in		efx_nic_t *enp);
260 
261 extern	__checkReturn	boolean_t
262 efx_mcdi_request_abort(
263 	__in		efx_nic_t *enp);
264 
265 extern			void
266 efx_mcdi_fini(
267 	__in		efx_nic_t *enp);
268 
269 #endif	/* EFSYS_OPT_MCDI */
270 
271 /* INTR */
272 
273 #define	EFX_NINTR_SIENA 1024
274 
275 typedef enum efx_intr_type_e {
276 	EFX_INTR_INVALID = 0,
277 	EFX_INTR_LINE,
278 	EFX_INTR_MESSAGE,
279 	EFX_INTR_NTYPES
280 } efx_intr_type_t;
281 
282 #define	EFX_INTR_SIZE	(sizeof (efx_oword_t))
283 
284 extern	__checkReturn	efx_rc_t
285 efx_intr_init(
286 	__in		efx_nic_t *enp,
287 	__in		efx_intr_type_t type,
288 	__in		efsys_mem_t *esmp);
289 
290 extern			void
291 efx_intr_enable(
292 	__in		efx_nic_t *enp);
293 
294 extern			void
295 efx_intr_disable(
296 	__in		efx_nic_t *enp);
297 
298 extern			void
299 efx_intr_disable_unlocked(
300 	__in		efx_nic_t *enp);
301 
302 #define	EFX_INTR_NEVQS	32
303 
304 extern	__checkReturn	efx_rc_t
305 efx_intr_trigger(
306 	__in		efx_nic_t *enp,
307 	__in		unsigned int level);
308 
309 extern			void
310 efx_intr_status_line(
311 	__in		efx_nic_t *enp,
312 	__out		boolean_t *fatalp,
313 	__out		uint32_t *maskp);
314 
315 extern			void
316 efx_intr_status_message(
317 	__in		efx_nic_t *enp,
318 	__in		unsigned int message,
319 	__out		boolean_t *fatalp);
320 
321 extern			void
322 efx_intr_fatal(
323 	__in		efx_nic_t *enp);
324 
325 extern			void
326 efx_intr_fini(
327 	__in		efx_nic_t *enp);
328 
329 /* MAC */
330 
331 #if EFSYS_OPT_MAC_STATS
332 
333 /* START MKCONFIG GENERATED EfxHeaderMacBlock e323546097fd7c65 */
334 typedef enum efx_mac_stat_e {
335 	EFX_MAC_RX_OCTETS,
336 	EFX_MAC_RX_PKTS,
337 	EFX_MAC_RX_UNICST_PKTS,
338 	EFX_MAC_RX_MULTICST_PKTS,
339 	EFX_MAC_RX_BRDCST_PKTS,
340 	EFX_MAC_RX_PAUSE_PKTS,
341 	EFX_MAC_RX_LE_64_PKTS,
342 	EFX_MAC_RX_65_TO_127_PKTS,
343 	EFX_MAC_RX_128_TO_255_PKTS,
344 	EFX_MAC_RX_256_TO_511_PKTS,
345 	EFX_MAC_RX_512_TO_1023_PKTS,
346 	EFX_MAC_RX_1024_TO_15XX_PKTS,
347 	EFX_MAC_RX_GE_15XX_PKTS,
348 	EFX_MAC_RX_ERRORS,
349 	EFX_MAC_RX_FCS_ERRORS,
350 	EFX_MAC_RX_DROP_EVENTS,
351 	EFX_MAC_RX_FALSE_CARRIER_ERRORS,
352 	EFX_MAC_RX_SYMBOL_ERRORS,
353 	EFX_MAC_RX_ALIGN_ERRORS,
354 	EFX_MAC_RX_INTERNAL_ERRORS,
355 	EFX_MAC_RX_JABBER_PKTS,
356 	EFX_MAC_RX_LANE0_CHAR_ERR,
357 	EFX_MAC_RX_LANE1_CHAR_ERR,
358 	EFX_MAC_RX_LANE2_CHAR_ERR,
359 	EFX_MAC_RX_LANE3_CHAR_ERR,
360 	EFX_MAC_RX_LANE0_DISP_ERR,
361 	EFX_MAC_RX_LANE1_DISP_ERR,
362 	EFX_MAC_RX_LANE2_DISP_ERR,
363 	EFX_MAC_RX_LANE3_DISP_ERR,
364 	EFX_MAC_RX_MATCH_FAULT,
365 	EFX_MAC_RX_NODESC_DROP_CNT,
366 	EFX_MAC_TX_OCTETS,
367 	EFX_MAC_TX_PKTS,
368 	EFX_MAC_TX_UNICST_PKTS,
369 	EFX_MAC_TX_MULTICST_PKTS,
370 	EFX_MAC_TX_BRDCST_PKTS,
371 	EFX_MAC_TX_PAUSE_PKTS,
372 	EFX_MAC_TX_LE_64_PKTS,
373 	EFX_MAC_TX_65_TO_127_PKTS,
374 	EFX_MAC_TX_128_TO_255_PKTS,
375 	EFX_MAC_TX_256_TO_511_PKTS,
376 	EFX_MAC_TX_512_TO_1023_PKTS,
377 	EFX_MAC_TX_1024_TO_15XX_PKTS,
378 	EFX_MAC_TX_GE_15XX_PKTS,
379 	EFX_MAC_TX_ERRORS,
380 	EFX_MAC_TX_SGL_COL_PKTS,
381 	EFX_MAC_TX_MULT_COL_PKTS,
382 	EFX_MAC_TX_EX_COL_PKTS,
383 	EFX_MAC_TX_LATE_COL_PKTS,
384 	EFX_MAC_TX_DEF_PKTS,
385 	EFX_MAC_TX_EX_DEF_PKTS,
386 	EFX_MAC_PM_TRUNC_BB_OVERFLOW,
387 	EFX_MAC_PM_DISCARD_BB_OVERFLOW,
388 	EFX_MAC_PM_TRUNC_VFIFO_FULL,
389 	EFX_MAC_PM_DISCARD_VFIFO_FULL,
390 	EFX_MAC_PM_TRUNC_QBB,
391 	EFX_MAC_PM_DISCARD_QBB,
392 	EFX_MAC_PM_DISCARD_MAPPING,
393 	EFX_MAC_RXDP_Q_DISABLED_PKTS,
394 	EFX_MAC_RXDP_DI_DROPPED_PKTS,
395 	EFX_MAC_RXDP_STREAMING_PKTS,
396 	EFX_MAC_RXDP_HLB_FETCH,
397 	EFX_MAC_RXDP_HLB_WAIT,
398 	EFX_MAC_VADAPTER_RX_UNICAST_PACKETS,
399 	EFX_MAC_VADAPTER_RX_UNICAST_BYTES,
400 	EFX_MAC_VADAPTER_RX_MULTICAST_PACKETS,
401 	EFX_MAC_VADAPTER_RX_MULTICAST_BYTES,
402 	EFX_MAC_VADAPTER_RX_BROADCAST_PACKETS,
403 	EFX_MAC_VADAPTER_RX_BROADCAST_BYTES,
404 	EFX_MAC_VADAPTER_RX_BAD_PACKETS,
405 	EFX_MAC_VADAPTER_RX_BAD_BYTES,
406 	EFX_MAC_VADAPTER_RX_OVERFLOW,
407 	EFX_MAC_VADAPTER_TX_UNICAST_PACKETS,
408 	EFX_MAC_VADAPTER_TX_UNICAST_BYTES,
409 	EFX_MAC_VADAPTER_TX_MULTICAST_PACKETS,
410 	EFX_MAC_VADAPTER_TX_MULTICAST_BYTES,
411 	EFX_MAC_VADAPTER_TX_BROADCAST_PACKETS,
412 	EFX_MAC_VADAPTER_TX_BROADCAST_BYTES,
413 	EFX_MAC_VADAPTER_TX_BAD_PACKETS,
414 	EFX_MAC_VADAPTER_TX_BAD_BYTES,
415 	EFX_MAC_VADAPTER_TX_OVERFLOW,
416 	EFX_MAC_NSTATS
417 } efx_mac_stat_t;
418 
419 /* END MKCONFIG GENERATED EfxHeaderMacBlock */
420 
421 #endif	/* EFSYS_OPT_MAC_STATS */
422 
423 typedef enum efx_link_mode_e {
424 	EFX_LINK_UNKNOWN = 0,
425 	EFX_LINK_DOWN,
426 	EFX_LINK_10HDX,
427 	EFX_LINK_10FDX,
428 	EFX_LINK_100HDX,
429 	EFX_LINK_100FDX,
430 	EFX_LINK_1000HDX,
431 	EFX_LINK_1000FDX,
432 	EFX_LINK_10000FDX,
433 	EFX_LINK_40000FDX,
434 	EFX_LINK_NMODES
435 } efx_link_mode_t;
436 
437 #define	EFX_MAC_ADDR_LEN 6
438 
439 #define	EFX_MAC_ADDR_IS_MULTICAST(_address) (((uint8_t *)_address)[0] & 0x01)
440 
441 #define	EFX_MAC_MULTICAST_LIST_MAX	256
442 
443 #define	EFX_MAC_SDU_MAX	9202
444 
445 #define	EFX_MAC_PDU_ADJUSTMENT					\
446 	(/* EtherII */ 14					\
447 	    + /* VLAN */ 4					\
448 	    + /* CRC */ 4					\
449 	    + /* bug16011 */ 16)				\
450 
451 #define	EFX_MAC_PDU(_sdu)					\
452 	P2ROUNDUP((_sdu) + EFX_MAC_PDU_ADJUSTMENT, 8)
453 
454 /*
455  * Due to the P2ROUNDUP in EFX_MAC_PDU(), EFX_MAC_SDU_FROM_PDU() may give
456  * the SDU rounded up slightly.
457  */
458 #define	EFX_MAC_SDU_FROM_PDU(_pdu)	((_pdu) - EFX_MAC_PDU_ADJUSTMENT)
459 
460 #define	EFX_MAC_PDU_MIN	60
461 #define	EFX_MAC_PDU_MAX	EFX_MAC_PDU(EFX_MAC_SDU_MAX)
462 
463 extern	__checkReturn	efx_rc_t
464 efx_mac_pdu_get(
465 	__in		efx_nic_t *enp,
466 	__out		size_t *pdu);
467 
468 extern	__checkReturn	efx_rc_t
469 efx_mac_pdu_set(
470 	__in		efx_nic_t *enp,
471 	__in		size_t pdu);
472 
473 extern	__checkReturn	efx_rc_t
474 efx_mac_addr_set(
475 	__in		efx_nic_t *enp,
476 	__in		uint8_t *addr);
477 
478 extern	__checkReturn			efx_rc_t
479 efx_mac_filter_set(
480 	__in				efx_nic_t *enp,
481 	__in				boolean_t all_unicst,
482 	__in				boolean_t mulcst,
483 	__in				boolean_t all_mulcst,
484 	__in				boolean_t brdcst);
485 
486 extern	__checkReturn	efx_rc_t
487 efx_mac_multicast_list_set(
488 	__in				efx_nic_t *enp,
489 	__in_ecount(6*count)		uint8_t const *addrs,
490 	__in				int count);
491 
492 extern	__checkReturn	efx_rc_t
493 efx_mac_filter_default_rxq_set(
494 	__in		efx_nic_t *enp,
495 	__in		efx_rxq_t *erp,
496 	__in		boolean_t using_rss);
497 
498 extern			void
499 efx_mac_filter_default_rxq_clear(
500 	__in		efx_nic_t *enp);
501 
502 extern	__checkReturn	efx_rc_t
503 efx_mac_drain(
504 	__in		efx_nic_t *enp,
505 	__in		boolean_t enabled);
506 
507 extern	__checkReturn	efx_rc_t
508 efx_mac_up(
509 	__in		efx_nic_t *enp,
510 	__out		boolean_t *mac_upp);
511 
512 #define	EFX_FCNTL_RESPOND	0x00000001
513 #define	EFX_FCNTL_GENERATE	0x00000002
514 
515 extern	__checkReturn	efx_rc_t
516 efx_mac_fcntl_set(
517 	__in		efx_nic_t *enp,
518 	__in		unsigned int fcntl,
519 	__in		boolean_t autoneg);
520 
521 extern			void
522 efx_mac_fcntl_get(
523 	__in		efx_nic_t *enp,
524 	__out		unsigned int *fcntl_wantedp,
525 	__out		unsigned int *fcntl_linkp);
526 
527 
528 #if EFSYS_OPT_MAC_STATS
529 
530 #if EFSYS_OPT_NAMES
531 
532 extern	__checkReturn			const char *
533 efx_mac_stat_name(
534 	__in				efx_nic_t *enp,
535 	__in				unsigned int id);
536 
537 #endif	/* EFSYS_OPT_NAMES */
538 
539 #define	EFX_MAC_STATS_MASK_BITS_PER_PAGE	(8 * sizeof (uint32_t))
540 
541 #define	EFX_MAC_STATS_MASK_NPAGES	\
542 	(P2ROUNDUP(EFX_MAC_NSTATS, EFX_MAC_STATS_MASK_BITS_PER_PAGE) / \
543 	    EFX_MAC_STATS_MASK_BITS_PER_PAGE)
544 
545 /*
546  * Get mask of MAC statistics supported by the hardware.
547  *
548  * If mask_size is insufficient to return the mask, EINVAL error is
549  * returned. EFX_MAC_STATS_MASK_NPAGES multiplied by size of the page
550  * (which is sizeof (uint32_t)) is sufficient.
551  */
552 extern	__checkReturn			efx_rc_t
553 efx_mac_stats_get_mask(
554 	__in				efx_nic_t *enp,
555 	__out_bcount(mask_size)		uint32_t *maskp,
556 	__in				size_t mask_size);
557 
558 #define	EFX_MAC_STAT_SUPPORTED(_mask, _stat)	\
559 	((_mask)[(_stat) / EFX_MAC_STATS_MASK_BITS_PER_PAGE] &	\
560 	 (1ULL << ((_stat) & (EFX_MAC_STATS_MASK_BITS_PER_PAGE - 1))))
561 
562 #define	EFX_MAC_STATS_SIZE 0x400
563 
564 /*
565  * Upload mac statistics supported by the hardware into the given buffer.
566  *
567  * The reference buffer must be at least %EFX_MAC_STATS_SIZE bytes,
568  * and page aligned.
569  *
570  * The hardware will only DMA statistics that it understands (of course).
571  * Drivers should not make any assumptions about which statistics are
572  * supported, especially when the statistics are generated by firmware.
573  *
574  * Thus, drivers should zero this buffer before use, so that not-understood
575  * statistics read back as zero.
576  */
577 extern	__checkReturn			efx_rc_t
578 efx_mac_stats_upload(
579 	__in				efx_nic_t *enp,
580 	__in				efsys_mem_t *esmp);
581 
582 extern	__checkReturn			efx_rc_t
583 efx_mac_stats_periodic(
584 	__in				efx_nic_t *enp,
585 	__in				efsys_mem_t *esmp,
586 	__in				uint16_t period_ms,
587 	__in				boolean_t events);
588 
589 extern	__checkReturn			efx_rc_t
590 efx_mac_stats_update(
591 	__in				efx_nic_t *enp,
592 	__in				efsys_mem_t *esmp,
593 	__inout_ecount(EFX_MAC_NSTATS)	efsys_stat_t *stat,
594 	__inout_opt			uint32_t *generationp);
595 
596 #endif	/* EFSYS_OPT_MAC_STATS */
597 
598 /* MON */
599 
600 typedef enum efx_mon_type_e {
601 	EFX_MON_INVALID = 0,
602 	EFX_MON_SFC90X0,
603 	EFX_MON_SFC91X0,
604 	EFX_MON_SFC92X0,
605 	EFX_MON_NTYPES
606 } efx_mon_type_t;
607 
608 #if EFSYS_OPT_NAMES
609 
610 extern		const char *
611 efx_mon_name(
612 	__in	efx_nic_t *enp);
613 
614 #endif	/* EFSYS_OPT_NAMES */
615 
616 extern	__checkReturn	efx_rc_t
617 efx_mon_init(
618 	__in		efx_nic_t *enp);
619 
620 #if EFSYS_OPT_MON_STATS
621 
622 #define	EFX_MON_STATS_PAGE_SIZE 0x100
623 #define	EFX_MON_MASK_ELEMENT_SIZE 32
624 
625 /* START MKCONFIG GENERATED MonitorHeaderStatsBlock 5d4ee5185e419abe */
626 typedef enum efx_mon_stat_e {
627 	EFX_MON_STAT_2_5V,
628 	EFX_MON_STAT_VCCP1,
629 	EFX_MON_STAT_VCC,
630 	EFX_MON_STAT_5V,
631 	EFX_MON_STAT_12V,
632 	EFX_MON_STAT_VCCP2,
633 	EFX_MON_STAT_EXT_TEMP,
634 	EFX_MON_STAT_INT_TEMP,
635 	EFX_MON_STAT_AIN1,
636 	EFX_MON_STAT_AIN2,
637 	EFX_MON_STAT_INT_COOLING,
638 	EFX_MON_STAT_EXT_COOLING,
639 	EFX_MON_STAT_1V,
640 	EFX_MON_STAT_1_2V,
641 	EFX_MON_STAT_1_8V,
642 	EFX_MON_STAT_3_3V,
643 	EFX_MON_STAT_1_2VA,
644 	EFX_MON_STAT_VREF,
645 	EFX_MON_STAT_VAOE,
646 	EFX_MON_STAT_AOE_TEMP,
647 	EFX_MON_STAT_PSU_AOE_TEMP,
648 	EFX_MON_STAT_PSU_TEMP,
649 	EFX_MON_STAT_FAN0,
650 	EFX_MON_STAT_FAN1,
651 	EFX_MON_STAT_FAN2,
652 	EFX_MON_STAT_FAN3,
653 	EFX_MON_STAT_FAN4,
654 	EFX_MON_STAT_VAOE_IN,
655 	EFX_MON_STAT_IAOE,
656 	EFX_MON_STAT_IAOE_IN,
657 	EFX_MON_STAT_NIC_POWER,
658 	EFX_MON_STAT_0_9V,
659 	EFX_MON_STAT_I0_9V,
660 	EFX_MON_STAT_I1_2V,
661 	EFX_MON_STAT_0_9V_ADC,
662 	EFX_MON_STAT_INT_TEMP2,
663 	EFX_MON_STAT_VREG_TEMP,
664 	EFX_MON_STAT_VREG_0_9V_TEMP,
665 	EFX_MON_STAT_VREG_1_2V_TEMP,
666 	EFX_MON_STAT_INT_VPTAT,
667 	EFX_MON_STAT_INT_ADC_TEMP,
668 	EFX_MON_STAT_EXT_VPTAT,
669 	EFX_MON_STAT_EXT_ADC_TEMP,
670 	EFX_MON_STAT_AMBIENT_TEMP,
671 	EFX_MON_STAT_AIRFLOW,
672 	EFX_MON_STAT_VDD08D_VSS08D_CSR,
673 	EFX_MON_STAT_VDD08D_VSS08D_CSR_EXTADC,
674 	EFX_MON_STAT_HOTPOINT_TEMP,
675 	EFX_MON_STAT_PHY_POWER_SWITCH_PORT0,
676 	EFX_MON_STAT_PHY_POWER_SWITCH_PORT1,
677 	EFX_MON_STAT_MUM_VCC,
678 	EFX_MON_STAT_0V9_A,
679 	EFX_MON_STAT_I0V9_A,
680 	EFX_MON_STAT_0V9_A_TEMP,
681 	EFX_MON_STAT_0V9_B,
682 	EFX_MON_STAT_I0V9_B,
683 	EFX_MON_STAT_0V9_B_TEMP,
684 	EFX_MON_STAT_CCOM_AVREG_1V2_SUPPLY,
685 	EFX_MON_STAT_CCOM_AVREG_1V2_SUPPLY_EXT_ADC,
686 	EFX_MON_STAT_CCOM_AVREG_1V8_SUPPLY,
687 	EFX_MON_STAT_CCOM_AVREG_1V8_SUPPLY_EXT_ADC,
688 	EFX_MON_STAT_CONTROLLER_MASTER_VPTAT,
689 	EFX_MON_STAT_CONTROLLER_MASTER_INTERNAL_TEMP,
690 	EFX_MON_STAT_CONTROLLER_MASTER_VPTAT_EXT_ADC,
691 	EFX_MON_STAT_CONTROLLER_MASTER_INTERNAL_TEMP_EXT_ADC,
692 	EFX_MON_STAT_CONTROLLER_SLAVE_VPTAT,
693 	EFX_MON_STAT_CONTROLLER_SLAVE_INTERNAL_TEMP,
694 	EFX_MON_STAT_CONTROLLER_SLAVE_VPTAT_EXT_ADC,
695 	EFX_MON_STAT_CONTROLLER_SLAVE_INTERNAL_TEMP_EXT_ADC,
696 	EFX_MON_STAT_SODIMM_VOUT,
697 	EFX_MON_STAT_SODIMM_0_TEMP,
698 	EFX_MON_STAT_SODIMM_1_TEMP,
699 	EFX_MON_STAT_PHY0_VCC,
700 	EFX_MON_STAT_PHY1_VCC,
701 	EFX_MON_STAT_CONTROLLER_TDIODE_TEMP,
702 	EFX_MON_STAT_BOARD_FRONT_TEMP,
703 	EFX_MON_STAT_BOARD_BACK_TEMP,
704 	EFX_MON_NSTATS
705 } efx_mon_stat_t;
706 
707 /* END MKCONFIG GENERATED MonitorHeaderStatsBlock */
708 
709 typedef enum efx_mon_stat_state_e {
710 	EFX_MON_STAT_STATE_OK = 0,
711 	EFX_MON_STAT_STATE_WARNING = 1,
712 	EFX_MON_STAT_STATE_FATAL = 2,
713 	EFX_MON_STAT_STATE_BROKEN = 3,
714 	EFX_MON_STAT_STATE_NO_READING = 4,
715 } efx_mon_stat_state_t;
716 
717 typedef struct efx_mon_stat_value_s {
718 	uint16_t	emsv_value;
719 	uint16_t	emsv_state;
720 } efx_mon_stat_value_t;
721 
722 #if EFSYS_OPT_NAMES
723 
724 extern					const char *
725 efx_mon_stat_name(
726 	__in				efx_nic_t *enp,
727 	__in				efx_mon_stat_t id);
728 
729 #endif	/* EFSYS_OPT_NAMES */
730 
731 extern	__checkReturn			efx_rc_t
732 efx_mon_stats_update(
733 	__in				efx_nic_t *enp,
734 	__in				efsys_mem_t *esmp,
735 	__inout_ecount(EFX_MON_NSTATS)	efx_mon_stat_value_t *values);
736 
737 #endif	/* EFSYS_OPT_MON_STATS */
738 
739 extern		void
740 efx_mon_fini(
741 	__in	efx_nic_t *enp);
742 
743 /* PHY */
744 
745 extern	__checkReturn	efx_rc_t
746 efx_phy_verify(
747 	__in		efx_nic_t *enp);
748 
749 #if EFSYS_OPT_PHY_LED_CONTROL
750 
751 typedef enum efx_phy_led_mode_e {
752 	EFX_PHY_LED_DEFAULT = 0,
753 	EFX_PHY_LED_OFF,
754 	EFX_PHY_LED_ON,
755 	EFX_PHY_LED_FLASH,
756 	EFX_PHY_LED_NMODES
757 } efx_phy_led_mode_t;
758 
759 extern	__checkReturn	efx_rc_t
760 efx_phy_led_set(
761 	__in	efx_nic_t *enp,
762 	__in	efx_phy_led_mode_t mode);
763 
764 #endif	/* EFSYS_OPT_PHY_LED_CONTROL */
765 
766 extern	__checkReturn	efx_rc_t
767 efx_port_init(
768 	__in		efx_nic_t *enp);
769 
770 #if EFSYS_OPT_LOOPBACK
771 
772 typedef enum efx_loopback_type_e {
773 	EFX_LOOPBACK_OFF = 0,
774 	EFX_LOOPBACK_DATA = 1,
775 	EFX_LOOPBACK_GMAC = 2,
776 	EFX_LOOPBACK_XGMII = 3,
777 	EFX_LOOPBACK_XGXS = 4,
778 	EFX_LOOPBACK_XAUI = 5,
779 	EFX_LOOPBACK_GMII = 6,
780 	EFX_LOOPBACK_SGMII = 7,
781 	EFX_LOOPBACK_XGBR = 8,
782 	EFX_LOOPBACK_XFI = 9,
783 	EFX_LOOPBACK_XAUI_FAR = 10,
784 	EFX_LOOPBACK_GMII_FAR = 11,
785 	EFX_LOOPBACK_SGMII_FAR = 12,
786 	EFX_LOOPBACK_XFI_FAR = 13,
787 	EFX_LOOPBACK_GPHY = 14,
788 	EFX_LOOPBACK_PHY_XS = 15,
789 	EFX_LOOPBACK_PCS = 16,
790 	EFX_LOOPBACK_PMA_PMD = 17,
791 	EFX_LOOPBACK_XPORT = 18,
792 	EFX_LOOPBACK_XGMII_WS = 19,
793 	EFX_LOOPBACK_XAUI_WS = 20,
794 	EFX_LOOPBACK_XAUI_WS_FAR = 21,
795 	EFX_LOOPBACK_XAUI_WS_NEAR = 22,
796 	EFX_LOOPBACK_GMII_WS = 23,
797 	EFX_LOOPBACK_XFI_WS = 24,
798 	EFX_LOOPBACK_XFI_WS_FAR = 25,
799 	EFX_LOOPBACK_PHYXS_WS = 26,
800 	EFX_LOOPBACK_PMA_INT = 27,
801 	EFX_LOOPBACK_SD_NEAR = 28,
802 	EFX_LOOPBACK_SD_FAR = 29,
803 	EFX_LOOPBACK_PMA_INT_WS = 30,
804 	EFX_LOOPBACK_SD_FEP2_WS = 31,
805 	EFX_LOOPBACK_SD_FEP1_5_WS = 32,
806 	EFX_LOOPBACK_SD_FEP_WS = 33,
807 	EFX_LOOPBACK_SD_FES_WS = 34,
808 	EFX_LOOPBACK_NTYPES
809 } efx_loopback_type_t;
810 
811 typedef enum efx_loopback_kind_e {
812 	EFX_LOOPBACK_KIND_OFF = 0,
813 	EFX_LOOPBACK_KIND_ALL,
814 	EFX_LOOPBACK_KIND_MAC,
815 	EFX_LOOPBACK_KIND_PHY,
816 	EFX_LOOPBACK_NKINDS
817 } efx_loopback_kind_t;
818 
819 extern			void
820 efx_loopback_mask(
821 	__in	efx_loopback_kind_t loopback_kind,
822 	__out	efx_qword_t *maskp);
823 
824 extern	__checkReturn	efx_rc_t
825 efx_port_loopback_set(
826 	__in	efx_nic_t *enp,
827 	__in	efx_link_mode_t link_mode,
828 	__in	efx_loopback_type_t type);
829 
830 #if EFSYS_OPT_NAMES
831 
832 extern	__checkReturn	const char *
833 efx_loopback_type_name(
834 	__in		efx_nic_t *enp,
835 	__in		efx_loopback_type_t type);
836 
837 #endif	/* EFSYS_OPT_NAMES */
838 
839 #endif	/* EFSYS_OPT_LOOPBACK */
840 
841 extern	__checkReturn	efx_rc_t
842 efx_port_poll(
843 	__in		efx_nic_t *enp,
844 	__out_opt	efx_link_mode_t	*link_modep);
845 
846 extern		void
847 efx_port_fini(
848 	__in	efx_nic_t *enp);
849 
850 typedef enum efx_phy_cap_type_e {
851 	EFX_PHY_CAP_INVALID = 0,
852 	EFX_PHY_CAP_10HDX,
853 	EFX_PHY_CAP_10FDX,
854 	EFX_PHY_CAP_100HDX,
855 	EFX_PHY_CAP_100FDX,
856 	EFX_PHY_CAP_1000HDX,
857 	EFX_PHY_CAP_1000FDX,
858 	EFX_PHY_CAP_10000FDX,
859 	EFX_PHY_CAP_PAUSE,
860 	EFX_PHY_CAP_ASYM,
861 	EFX_PHY_CAP_AN,
862 	EFX_PHY_CAP_40000FDX,
863 	EFX_PHY_CAP_NTYPES
864 } efx_phy_cap_type_t;
865 
866 
867 #define	EFX_PHY_CAP_CURRENT	0x00000000
868 #define	EFX_PHY_CAP_DEFAULT	0x00000001
869 #define	EFX_PHY_CAP_PERM	0x00000002
870 
871 extern		void
872 efx_phy_adv_cap_get(
873 	__in		efx_nic_t *enp,
874 	__in		uint32_t flag,
875 	__out		uint32_t *maskp);
876 
877 extern	__checkReturn	efx_rc_t
878 efx_phy_adv_cap_set(
879 	__in		efx_nic_t *enp,
880 	__in		uint32_t mask);
881 
882 extern			void
883 efx_phy_lp_cap_get(
884 	__in		efx_nic_t *enp,
885 	__out		uint32_t *maskp);
886 
887 extern	__checkReturn	efx_rc_t
888 efx_phy_oui_get(
889 	__in		efx_nic_t *enp,
890 	__out		uint32_t *ouip);
891 
892 typedef enum efx_phy_media_type_e {
893 	EFX_PHY_MEDIA_INVALID = 0,
894 	EFX_PHY_MEDIA_XAUI,
895 	EFX_PHY_MEDIA_CX4,
896 	EFX_PHY_MEDIA_KX4,
897 	EFX_PHY_MEDIA_XFP,
898 	EFX_PHY_MEDIA_SFP_PLUS,
899 	EFX_PHY_MEDIA_BASE_T,
900 	EFX_PHY_MEDIA_QSFP_PLUS,
901 	EFX_PHY_MEDIA_NTYPES
902 } efx_phy_media_type_t;
903 
904 /* Get the type of medium currently used.  If the board has ports for
905  * modules, a module is present, and we recognise the media type of
906  * the module, then this will be the media type of the module.
907  * Otherwise it will be the media type of the port.
908  */
909 extern			void
910 efx_phy_media_type_get(
911 	__in		efx_nic_t *enp,
912 	__out		efx_phy_media_type_t *typep);
913 
914 extern	__checkReturn		efx_rc_t
915 efx_phy_module_get_info(
916 	__in			efx_nic_t *enp,
917 	__in			uint8_t dev_addr,
918 	__in			uint8_t offset,
919 	__in			uint8_t len,
920 	__out_bcount(len)	uint8_t *data);
921 
922 #if EFSYS_OPT_PHY_STATS
923 
924 /* START MKCONFIG GENERATED PhyHeaderStatsBlock 30ed56ad501f8e36 */
925 typedef enum efx_phy_stat_e {
926 	EFX_PHY_STAT_OUI,
927 	EFX_PHY_STAT_PMA_PMD_LINK_UP,
928 	EFX_PHY_STAT_PMA_PMD_RX_FAULT,
929 	EFX_PHY_STAT_PMA_PMD_TX_FAULT,
930 	EFX_PHY_STAT_PMA_PMD_REV_A,
931 	EFX_PHY_STAT_PMA_PMD_REV_B,
932 	EFX_PHY_STAT_PMA_PMD_REV_C,
933 	EFX_PHY_STAT_PMA_PMD_REV_D,
934 	EFX_PHY_STAT_PCS_LINK_UP,
935 	EFX_PHY_STAT_PCS_RX_FAULT,
936 	EFX_PHY_STAT_PCS_TX_FAULT,
937 	EFX_PHY_STAT_PCS_BER,
938 	EFX_PHY_STAT_PCS_BLOCK_ERRORS,
939 	EFX_PHY_STAT_PHY_XS_LINK_UP,
940 	EFX_PHY_STAT_PHY_XS_RX_FAULT,
941 	EFX_PHY_STAT_PHY_XS_TX_FAULT,
942 	EFX_PHY_STAT_PHY_XS_ALIGN,
943 	EFX_PHY_STAT_PHY_XS_SYNC_A,
944 	EFX_PHY_STAT_PHY_XS_SYNC_B,
945 	EFX_PHY_STAT_PHY_XS_SYNC_C,
946 	EFX_PHY_STAT_PHY_XS_SYNC_D,
947 	EFX_PHY_STAT_AN_LINK_UP,
948 	EFX_PHY_STAT_AN_MASTER,
949 	EFX_PHY_STAT_AN_LOCAL_RX_OK,
950 	EFX_PHY_STAT_AN_REMOTE_RX_OK,
951 	EFX_PHY_STAT_CL22EXT_LINK_UP,
952 	EFX_PHY_STAT_SNR_A,
953 	EFX_PHY_STAT_SNR_B,
954 	EFX_PHY_STAT_SNR_C,
955 	EFX_PHY_STAT_SNR_D,
956 	EFX_PHY_STAT_PMA_PMD_SIGNAL_A,
957 	EFX_PHY_STAT_PMA_PMD_SIGNAL_B,
958 	EFX_PHY_STAT_PMA_PMD_SIGNAL_C,
959 	EFX_PHY_STAT_PMA_PMD_SIGNAL_D,
960 	EFX_PHY_STAT_AN_COMPLETE,
961 	EFX_PHY_STAT_PMA_PMD_REV_MAJOR,
962 	EFX_PHY_STAT_PMA_PMD_REV_MINOR,
963 	EFX_PHY_STAT_PMA_PMD_REV_MICRO,
964 	EFX_PHY_STAT_PCS_FW_VERSION_0,
965 	EFX_PHY_STAT_PCS_FW_VERSION_1,
966 	EFX_PHY_STAT_PCS_FW_VERSION_2,
967 	EFX_PHY_STAT_PCS_FW_VERSION_3,
968 	EFX_PHY_STAT_PCS_FW_BUILD_YY,
969 	EFX_PHY_STAT_PCS_FW_BUILD_MM,
970 	EFX_PHY_STAT_PCS_FW_BUILD_DD,
971 	EFX_PHY_STAT_PCS_OP_MODE,
972 	EFX_PHY_NSTATS
973 } efx_phy_stat_t;
974 
975 /* END MKCONFIG GENERATED PhyHeaderStatsBlock */
976 
977 #if EFSYS_OPT_NAMES
978 
979 extern					const char *
980 efx_phy_stat_name(
981 	__in				efx_nic_t *enp,
982 	__in				efx_phy_stat_t stat);
983 
984 #endif	/* EFSYS_OPT_NAMES */
985 
986 #define	EFX_PHY_STATS_SIZE 0x100
987 
988 extern	__checkReturn			efx_rc_t
989 efx_phy_stats_update(
990 	__in				efx_nic_t *enp,
991 	__in				efsys_mem_t *esmp,
992 	__inout_ecount(EFX_PHY_NSTATS)	uint32_t *stat);
993 
994 #endif	/* EFSYS_OPT_PHY_STATS */
995 
996 
997 #if EFSYS_OPT_BIST
998 
999 typedef enum efx_bist_type_e {
1000 	EFX_BIST_TYPE_UNKNOWN,
1001 	EFX_BIST_TYPE_PHY_NORMAL,
1002 	EFX_BIST_TYPE_PHY_CABLE_SHORT,
1003 	EFX_BIST_TYPE_PHY_CABLE_LONG,
1004 	EFX_BIST_TYPE_MC_MEM,	/* Test the MC DMEM and IMEM */
1005 	EFX_BIST_TYPE_SAT_MEM,	/* Test the DMEM and IMEM of satellite cpus*/
1006 	EFX_BIST_TYPE_REG,	/* Test the register memories */
1007 	EFX_BIST_TYPE_NTYPES,
1008 } efx_bist_type_t;
1009 
1010 typedef enum efx_bist_result_e {
1011 	EFX_BIST_RESULT_UNKNOWN,
1012 	EFX_BIST_RESULT_RUNNING,
1013 	EFX_BIST_RESULT_PASSED,
1014 	EFX_BIST_RESULT_FAILED,
1015 } efx_bist_result_t;
1016 
1017 typedef enum efx_phy_cable_status_e {
1018 	EFX_PHY_CABLE_STATUS_OK,
1019 	EFX_PHY_CABLE_STATUS_INVALID,
1020 	EFX_PHY_CABLE_STATUS_OPEN,
1021 	EFX_PHY_CABLE_STATUS_INTRAPAIRSHORT,
1022 	EFX_PHY_CABLE_STATUS_INTERPAIRSHORT,
1023 	EFX_PHY_CABLE_STATUS_BUSY,
1024 } efx_phy_cable_status_t;
1025 
1026 typedef enum efx_bist_value_e {
1027 	EFX_BIST_PHY_CABLE_LENGTH_A,
1028 	EFX_BIST_PHY_CABLE_LENGTH_B,
1029 	EFX_BIST_PHY_CABLE_LENGTH_C,
1030 	EFX_BIST_PHY_CABLE_LENGTH_D,
1031 	EFX_BIST_PHY_CABLE_STATUS_A,
1032 	EFX_BIST_PHY_CABLE_STATUS_B,
1033 	EFX_BIST_PHY_CABLE_STATUS_C,
1034 	EFX_BIST_PHY_CABLE_STATUS_D,
1035 	EFX_BIST_FAULT_CODE,
1036 	/* Memory BIST specific values. These match to the MC_CMD_BIST_POLL
1037 	 * response. */
1038 	EFX_BIST_MEM_TEST,
1039 	EFX_BIST_MEM_ADDR,
1040 	EFX_BIST_MEM_BUS,
1041 	EFX_BIST_MEM_EXPECT,
1042 	EFX_BIST_MEM_ACTUAL,
1043 	EFX_BIST_MEM_ECC,
1044 	EFX_BIST_MEM_ECC_PARITY,
1045 	EFX_BIST_MEM_ECC_FATAL,
1046 	EFX_BIST_NVALUES,
1047 } efx_bist_value_t;
1048 
1049 extern	__checkReturn		efx_rc_t
1050 efx_bist_enable_offline(
1051 	__in			efx_nic_t *enp);
1052 
1053 extern	__checkReturn		efx_rc_t
1054 efx_bist_start(
1055 	__in			efx_nic_t *enp,
1056 	__in			efx_bist_type_t type);
1057 
1058 extern	__checkReturn		efx_rc_t
1059 efx_bist_poll(
1060 	__in			efx_nic_t *enp,
1061 	__in			efx_bist_type_t type,
1062 	__out			efx_bist_result_t *resultp,
1063 	__out_opt		uint32_t *value_maskp,
1064 	__out_ecount_opt(count)	unsigned long *valuesp,
1065 	__in			size_t count);
1066 
1067 extern				void
1068 efx_bist_stop(
1069 	__in			efx_nic_t *enp,
1070 	__in			efx_bist_type_t type);
1071 
1072 #endif	/* EFSYS_OPT_BIST */
1073 
1074 #define	EFX_FEATURE_IPV6		0x00000001
1075 #define	EFX_FEATURE_LFSR_HASH_INSERT	0x00000002
1076 #define	EFX_FEATURE_LINK_EVENTS		0x00000004
1077 #define	EFX_FEATURE_PERIODIC_MAC_STATS	0x00000008
1078 #define	EFX_FEATURE_MCDI		0x00000020
1079 #define	EFX_FEATURE_LOOKAHEAD_SPLIT	0x00000040
1080 #define	EFX_FEATURE_MAC_HEADER_FILTERS	0x00000080
1081 #define	EFX_FEATURE_TURBO		0x00000100
1082 #define	EFX_FEATURE_MCDI_DMA		0x00000200
1083 #define	EFX_FEATURE_TX_SRC_FILTERS	0x00000400
1084 #define	EFX_FEATURE_PIO_BUFFERS		0x00000800
1085 #define	EFX_FEATURE_FW_ASSISTED_TSO	0x00001000
1086 #define	EFX_FEATURE_FW_ASSISTED_TSO_V2	0x00002000
1087 #define	EFX_FEATURE_TXQ_CKSUM_OP_DESC	0x00008000
1088 
1089 typedef enum efx_tunnel_protocol_e {
1090 	EFX_TUNNEL_PROTOCOL_NONE = 0,
1091 	EFX_TUNNEL_PROTOCOL_VXLAN,
1092 	EFX_TUNNEL_PROTOCOL_GENEVE,
1093 	EFX_TUNNEL_PROTOCOL_NVGRE,
1094 	EFX_TUNNEL_NPROTOS
1095 } efx_tunnel_protocol_t;
1096 
1097 typedef struct efx_nic_cfg_s {
1098 	uint32_t		enc_board_type;
1099 	uint32_t		enc_phy_type;
1100 #if EFSYS_OPT_NAMES
1101 	char			enc_phy_name[21];
1102 #endif
1103 	char			enc_phy_revision[21];
1104 	efx_mon_type_t		enc_mon_type;
1105 #if EFSYS_OPT_MON_STATS
1106 	uint32_t		enc_mon_stat_dma_buf_size;
1107 	uint32_t		enc_mon_stat_mask[(EFX_MON_NSTATS + 31) / 32];
1108 #endif
1109 	unsigned int		enc_features;
1110 	uint8_t			enc_mac_addr[6];
1111 	uint8_t			enc_port;	/* PHY port number */
1112 	uint32_t		enc_intr_vec_base;
1113 	uint32_t		enc_intr_limit;
1114 	uint32_t		enc_evq_limit;
1115 	uint32_t		enc_txq_limit;
1116 	uint32_t		enc_rxq_limit;
1117 	uint32_t		enc_txq_max_ndescs;
1118 	uint32_t		enc_buftbl_limit;
1119 	uint32_t		enc_piobuf_limit;
1120 	uint32_t		enc_piobuf_size;
1121 	uint32_t		enc_piobuf_min_alloc_size;
1122 	uint32_t		enc_evq_timer_quantum_ns;
1123 	uint32_t		enc_evq_timer_max_us;
1124 	uint32_t		enc_clk_mult;
1125 	uint32_t		enc_rx_prefix_size;
1126 	uint32_t		enc_rx_buf_align_start;
1127 	uint32_t		enc_rx_buf_align_end;
1128 #if EFSYS_OPT_LOOPBACK
1129 	efx_qword_t		enc_loopback_types[EFX_LINK_NMODES];
1130 #endif	/* EFSYS_OPT_LOOPBACK */
1131 #if EFSYS_OPT_PHY_FLAGS
1132 	uint32_t		enc_phy_flags_mask;
1133 #endif	/* EFSYS_OPT_PHY_FLAGS */
1134 #if EFSYS_OPT_PHY_LED_CONTROL
1135 	uint32_t		enc_led_mask;
1136 #endif	/* EFSYS_OPT_PHY_LED_CONTROL */
1137 #if EFSYS_OPT_PHY_STATS
1138 	uint64_t		enc_phy_stat_mask;
1139 #endif	/* EFSYS_OPT_PHY_STATS */
1140 #if EFSYS_OPT_MCDI
1141 	uint8_t			enc_mcdi_mdio_channel;
1142 #if EFSYS_OPT_PHY_STATS
1143 	uint32_t		enc_mcdi_phy_stat_mask;
1144 #endif	/* EFSYS_OPT_PHY_STATS */
1145 #if EFSYS_OPT_MON_STATS
1146 	uint32_t		*enc_mcdi_sensor_maskp;
1147 	uint32_t		enc_mcdi_sensor_mask_size;
1148 #endif	/* EFSYS_OPT_MON_STATS */
1149 #endif	/* EFSYS_OPT_MCDI */
1150 #if EFSYS_OPT_BIST
1151 	uint32_t		enc_bist_mask;
1152 #endif	/* EFSYS_OPT_BIST */
1153 #if EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD
1154 	uint32_t		enc_pf;
1155 	uint32_t		enc_vf;
1156 	uint32_t		enc_privilege_mask;
1157 #endif /* EFSYS_OPT_HUNTINGTON || EFSYS_OPT_MEDFORD */
1158 	boolean_t		enc_bug26807_workaround;
1159 	boolean_t		enc_bug35388_workaround;
1160 	boolean_t		enc_bug41750_workaround;
1161 	boolean_t		enc_bug61265_workaround;
1162 	boolean_t		enc_rx_batching_enabled;
1163 	/* Maximum number of descriptors completed in an rx event. */
1164 	uint32_t		enc_rx_batch_max;
1165 	/* Number of rx descriptors the hardware requires for a push. */
1166 	uint32_t		enc_rx_push_align;
1167 	/* Maximum amount of data in DMA descriptor */
1168 	uint32_t		enc_tx_dma_desc_size_max;
1169 	/*
1170 	 * Boundary which DMA descriptor data must not cross or 0 if no
1171 	 * limitation.
1172 	 */
1173 	uint32_t		enc_tx_dma_desc_boundary;
1174 	/*
1175 	 * Maximum number of bytes into the packet the TCP header can start for
1176 	 * the hardware to apply TSO packet edits.
1177 	 */
1178 	uint32_t		enc_tx_tso_tcp_header_offset_limit;
1179 	boolean_t		enc_fw_assisted_tso_enabled;
1180 	boolean_t		enc_fw_assisted_tso_v2_enabled;
1181 	/* Number of TSO contexts on the NIC (FATSOv2) */
1182 	uint32_t		enc_fw_assisted_tso_v2_n_contexts;
1183 	boolean_t		enc_hw_tx_insert_vlan_enabled;
1184 	/* Number of PFs on the NIC */
1185 	uint32_t		enc_hw_pf_count;
1186 	/* Datapath firmware vadapter/vport/vswitch support */
1187 	boolean_t		enc_datapath_cap_evb;
1188 	boolean_t		enc_rx_disable_scatter_supported;
1189 	boolean_t		enc_allow_set_mac_with_installed_filters;
1190 	boolean_t		enc_enhanced_set_mac_supported;
1191 	boolean_t		enc_init_evq_v2_supported;
1192 	boolean_t		enc_pm_and_rxdp_counters;
1193 	boolean_t		enc_mac_stats_40g_tx_size_bins;
1194 	uint32_t		enc_tunnel_encapsulations_supported;
1195 	/* External port identifier */
1196 	uint8_t			enc_external_port;
1197 	uint32_t		enc_mcdi_max_payload_length;
1198 	/* VPD may be per-PF or global */
1199 	boolean_t		enc_vpd_is_global;
1200 	/* Minimum unidirectional bandwidth in Mb/s to max out all ports */
1201 	uint32_t		enc_required_pcie_bandwidth_mbps;
1202 	uint32_t		enc_max_pcie_link_gen;
1203 	/* Firmware verifies integrity of NVRAM updates */
1204 	uint32_t		enc_fw_verified_nvram_update_required;
1205 } efx_nic_cfg_t;
1206 
1207 #define	EFX_PCI_FUNCTION_IS_PF(_encp)	((_encp)->enc_vf == 0xffff)
1208 #define	EFX_PCI_FUNCTION_IS_VF(_encp)	((_encp)->enc_vf != 0xffff)
1209 
1210 #define	EFX_PCI_FUNCTION(_encp)	\
1211 	(EFX_PCI_FUNCTION_IS_PF(_encp) ? (_encp)->enc_pf : (_encp)->enc_vf)
1212 
1213 #define	EFX_PCI_VF_PARENT(_encp)	((_encp)->enc_pf)
1214 
1215 extern			const efx_nic_cfg_t *
1216 efx_nic_cfg_get(
1217 	__in		efx_nic_t *enp);
1218 
1219 /* Driver resource limits (minimum required/maximum usable). */
1220 typedef struct efx_drv_limits_s {
1221 	uint32_t	edl_min_evq_count;
1222 	uint32_t	edl_max_evq_count;
1223 
1224 	uint32_t	edl_min_rxq_count;
1225 	uint32_t	edl_max_rxq_count;
1226 
1227 	uint32_t	edl_min_txq_count;
1228 	uint32_t	edl_max_txq_count;
1229 
1230 	/* PIO blocks (sub-allocated from piobuf) */
1231 	uint32_t	edl_min_pio_alloc_size;
1232 	uint32_t	edl_max_pio_alloc_count;
1233 } efx_drv_limits_t;
1234 
1235 extern	__checkReturn	efx_rc_t
1236 efx_nic_set_drv_limits(
1237 	__inout		efx_nic_t *enp,
1238 	__in		efx_drv_limits_t *edlp);
1239 
1240 typedef enum efx_nic_region_e {
1241 	EFX_REGION_VI,			/* Memory BAR UC mapping */
1242 	EFX_REGION_PIO_WRITE_VI,	/* Memory BAR WC mapping */
1243 } efx_nic_region_t;
1244 
1245 extern	__checkReturn	efx_rc_t
1246 efx_nic_get_bar_region(
1247 	__in		efx_nic_t *enp,
1248 	__in		efx_nic_region_t region,
1249 	__out		uint32_t *offsetp,
1250 	__out		size_t *sizep);
1251 
1252 extern	__checkReturn	efx_rc_t
1253 efx_nic_get_vi_pool(
1254 	__in		efx_nic_t *enp,
1255 	__out		uint32_t *evq_countp,
1256 	__out		uint32_t *rxq_countp,
1257 	__out		uint32_t *txq_countp);
1258 
1259 
1260 #if EFSYS_OPT_VPD
1261 
1262 typedef enum efx_vpd_tag_e {
1263 	EFX_VPD_ID = 0x02,
1264 	EFX_VPD_END = 0x0f,
1265 	EFX_VPD_RO = 0x10,
1266 	EFX_VPD_RW = 0x11,
1267 } efx_vpd_tag_t;
1268 
1269 typedef uint16_t efx_vpd_keyword_t;
1270 
1271 typedef struct efx_vpd_value_s {
1272 	efx_vpd_tag_t		evv_tag;
1273 	efx_vpd_keyword_t	evv_keyword;
1274 	uint8_t			evv_length;
1275 	uint8_t			evv_value[0x100];
1276 } efx_vpd_value_t;
1277 
1278 
1279 #define	EFX_VPD_KEYWORD(x, y) ((x) | ((y) << 8))
1280 
1281 extern	__checkReturn		efx_rc_t
1282 efx_vpd_init(
1283 	__in			efx_nic_t *enp);
1284 
1285 extern	__checkReturn		efx_rc_t
1286 efx_vpd_size(
1287 	__in			efx_nic_t *enp,
1288 	__out			size_t *sizep);
1289 
1290 extern	__checkReturn		efx_rc_t
1291 efx_vpd_read(
1292 	__in			efx_nic_t *enp,
1293 	__out_bcount(size)	caddr_t data,
1294 	__in			size_t size);
1295 
1296 extern	__checkReturn		efx_rc_t
1297 efx_vpd_verify(
1298 	__in			efx_nic_t *enp,
1299 	__in_bcount(size)	caddr_t data,
1300 	__in			size_t size);
1301 
1302 extern	__checkReturn		efx_rc_t
1303 efx_vpd_reinit(
1304 	__in			efx_nic_t *enp,
1305 	__in_bcount(size)	caddr_t data,
1306 	__in			size_t size);
1307 
1308 extern	__checkReturn		efx_rc_t
1309 efx_vpd_get(
1310 	__in			efx_nic_t *enp,
1311 	__in_bcount(size)	caddr_t data,
1312 	__in			size_t size,
1313 	__inout			efx_vpd_value_t *evvp);
1314 
1315 extern	__checkReturn		efx_rc_t
1316 efx_vpd_set(
1317 	__in			efx_nic_t *enp,
1318 	__inout_bcount(size)	caddr_t data,
1319 	__in			size_t size,
1320 	__in			efx_vpd_value_t *evvp);
1321 
1322 extern	__checkReturn		efx_rc_t
1323 efx_vpd_next(
1324 	__in			efx_nic_t *enp,
1325 	__inout_bcount(size)	caddr_t data,
1326 	__in			size_t size,
1327 	__out			efx_vpd_value_t *evvp,
1328 	__inout			unsigned int *contp);
1329 
1330 extern	__checkReturn		efx_rc_t
1331 efx_vpd_write(
1332 	__in			efx_nic_t *enp,
1333 	__in_bcount(size)	caddr_t data,
1334 	__in			size_t size);
1335 
1336 extern				void
1337 efx_vpd_fini(
1338 	__in			efx_nic_t *enp);
1339 
1340 #endif	/* EFSYS_OPT_VPD */
1341 
1342 /* NVRAM */
1343 
1344 #if EFSYS_OPT_NVRAM
1345 
1346 typedef enum efx_nvram_type_e {
1347 	EFX_NVRAM_INVALID = 0,
1348 	EFX_NVRAM_BOOTROM,
1349 	EFX_NVRAM_BOOTROM_CFG,
1350 	EFX_NVRAM_MC_FIRMWARE,
1351 	EFX_NVRAM_MC_GOLDEN,
1352 	EFX_NVRAM_PHY,
1353 	EFX_NVRAM_NULLPHY,
1354 	EFX_NVRAM_FPGA,
1355 	EFX_NVRAM_FCFW,
1356 	EFX_NVRAM_CPLD,
1357 	EFX_NVRAM_FPGA_BACKUP,
1358 	EFX_NVRAM_DYNAMIC_CFG,
1359 	EFX_NVRAM_LICENSE,
1360 	EFX_NVRAM_UEFIROM,
1361 	EFX_NVRAM_NTYPES,
1362 } efx_nvram_type_t;
1363 
1364 extern	__checkReturn		efx_rc_t
1365 efx_nvram_init(
1366 	__in			efx_nic_t *enp);
1367 
1368 #if EFSYS_OPT_DIAG
1369 
1370 extern	__checkReturn		efx_rc_t
1371 efx_nvram_test(
1372 	__in			efx_nic_t *enp);
1373 
1374 #endif	/* EFSYS_OPT_DIAG */
1375 
1376 extern	__checkReturn		efx_rc_t
1377 efx_nvram_size(
1378 	__in			efx_nic_t *enp,
1379 	__in			efx_nvram_type_t type,
1380 	__out			size_t *sizep);
1381 
1382 extern	__checkReturn		efx_rc_t
1383 efx_nvram_rw_start(
1384 	__in			efx_nic_t *enp,
1385 	__in			efx_nvram_type_t type,
1386 	__out_opt		size_t *pref_chunkp);
1387 
1388 extern	__checkReturn		efx_rc_t
1389 efx_nvram_rw_finish(
1390 	__in			efx_nic_t *enp,
1391 	__in			efx_nvram_type_t type);
1392 
1393 extern	__checkReturn		efx_rc_t
1394 efx_nvram_get_version(
1395 	__in			efx_nic_t *enp,
1396 	__in			efx_nvram_type_t type,
1397 	__out			uint32_t *subtypep,
1398 	__out_ecount(4)		uint16_t version[4]);
1399 
1400 extern	__checkReturn		efx_rc_t
1401 efx_nvram_read_chunk(
1402 	__in			efx_nic_t *enp,
1403 	__in			efx_nvram_type_t type,
1404 	__in			unsigned int offset,
1405 	__out_bcount(size)	caddr_t data,
1406 	__in			size_t size);
1407 
1408 extern	__checkReturn		efx_rc_t
1409 efx_nvram_set_version(
1410 	__in			efx_nic_t *enp,
1411 	__in			efx_nvram_type_t type,
1412 	__in_ecount(4)		uint16_t version[4]);
1413 
1414 extern	__checkReturn		efx_rc_t
1415 efx_nvram_validate(
1416 	__in			efx_nic_t *enp,
1417 	__in			efx_nvram_type_t type,
1418 	__in_bcount(partn_size)	caddr_t partn_data,
1419 	__in			size_t partn_size);
1420 
1421 extern	 __checkReturn		efx_rc_t
1422 efx_nvram_erase(
1423 	__in			efx_nic_t *enp,
1424 	__in			efx_nvram_type_t type);
1425 
1426 extern	__checkReturn		efx_rc_t
1427 efx_nvram_write_chunk(
1428 	__in			efx_nic_t *enp,
1429 	__in			efx_nvram_type_t type,
1430 	__in			unsigned int offset,
1431 	__in_bcount(size)	caddr_t data,
1432 	__in			size_t size);
1433 
1434 extern				void
1435 efx_nvram_fini(
1436 	__in			efx_nic_t *enp);
1437 
1438 #endif	/* EFSYS_OPT_NVRAM */
1439 
1440 #if EFSYS_OPT_BOOTCFG
1441 
1442 /* Report size and offset of bootcfg sector in NVRAM partition. */
1443 extern	__checkReturn		efx_rc_t
1444 efx_bootcfg_sector_info(
1445 	__in			efx_nic_t *enp,
1446 	__in			uint32_t pf,
1447 	__out_opt		uint32_t *sector_countp,
1448 	__out			size_t *offsetp,
1449 	__out			size_t *max_sizep);
1450 
1451 /*
1452  * Copy bootcfg sector data to a target buffer which may differ in size.
1453  * Optionally corrects format errors in source buffer.
1454  */
1455 extern				efx_rc_t
1456 efx_bootcfg_copy_sector(
1457 	__in			efx_nic_t *enp,
1458 	__inout_bcount(sector_length)
1459 				uint8_t *sector,
1460 	__in			size_t sector_length,
1461 	__out_bcount(data_size)	uint8_t *data,
1462 	__in			size_t data_size,
1463 	__in			boolean_t handle_format_errors);
1464 
1465 extern				efx_rc_t
1466 efx_bootcfg_read(
1467 	__in			efx_nic_t *enp,
1468 	__out_bcount(size)	uint8_t *data,
1469 	__in			size_t size);
1470 
1471 extern				efx_rc_t
1472 efx_bootcfg_write(
1473 	__in			efx_nic_t *enp,
1474 	__in_bcount(size)	uint8_t *data,
1475 	__in			size_t size);
1476 
1477 #endif	/* EFSYS_OPT_BOOTCFG */
1478 
1479 #if EFSYS_OPT_DIAG
1480 
1481 typedef enum efx_pattern_type_t {
1482 	EFX_PATTERN_BYTE_INCREMENT = 0,
1483 	EFX_PATTERN_ALL_THE_SAME,
1484 	EFX_PATTERN_BIT_ALTERNATE,
1485 	EFX_PATTERN_BYTE_ALTERNATE,
1486 	EFX_PATTERN_BYTE_CHANGING,
1487 	EFX_PATTERN_BIT_SWEEP,
1488 	EFX_PATTERN_NTYPES
1489 } efx_pattern_type_t;
1490 
1491 typedef			void
1492 (*efx_sram_pattern_fn_t)(
1493 	__in		size_t row,
1494 	__in		boolean_t negate,
1495 	__out		efx_qword_t *eqp);
1496 
1497 extern	__checkReturn	efx_rc_t
1498 efx_sram_test(
1499 	__in		efx_nic_t *enp,
1500 	__in		efx_pattern_type_t type);
1501 
1502 #endif	/* EFSYS_OPT_DIAG */
1503 
1504 extern	__checkReturn	efx_rc_t
1505 efx_sram_buf_tbl_set(
1506 	__in		efx_nic_t *enp,
1507 	__in		uint32_t id,
1508 	__in		efsys_mem_t *esmp,
1509 	__in		size_t n);
1510 
1511 extern		void
1512 efx_sram_buf_tbl_clear(
1513 	__in	efx_nic_t *enp,
1514 	__in	uint32_t id,
1515 	__in	size_t n);
1516 
1517 #define	EFX_BUF_TBL_SIZE	0x20000
1518 
1519 #define	EFX_BUF_SIZE		4096
1520 
1521 /* EV */
1522 
1523 typedef struct efx_evq_s	efx_evq_t;
1524 
1525 #if EFSYS_OPT_QSTATS
1526 
1527 /* START MKCONFIG GENERATED EfxHeaderEventQueueBlock 6f3843f5fe7cc843 */
1528 typedef enum efx_ev_qstat_e {
1529 	EV_ALL,
1530 	EV_RX,
1531 	EV_RX_OK,
1532 	EV_RX_FRM_TRUNC,
1533 	EV_RX_TOBE_DISC,
1534 	EV_RX_PAUSE_FRM_ERR,
1535 	EV_RX_BUF_OWNER_ID_ERR,
1536 	EV_RX_IPV4_HDR_CHKSUM_ERR,
1537 	EV_RX_TCP_UDP_CHKSUM_ERR,
1538 	EV_RX_ETH_CRC_ERR,
1539 	EV_RX_IP_FRAG_ERR,
1540 	EV_RX_MCAST_PKT,
1541 	EV_RX_MCAST_HASH_MATCH,
1542 	EV_RX_TCP_IPV4,
1543 	EV_RX_TCP_IPV6,
1544 	EV_RX_UDP_IPV4,
1545 	EV_RX_UDP_IPV6,
1546 	EV_RX_OTHER_IPV4,
1547 	EV_RX_OTHER_IPV6,
1548 	EV_RX_NON_IP,
1549 	EV_RX_BATCH,
1550 	EV_TX,
1551 	EV_TX_WQ_FF_FULL,
1552 	EV_TX_PKT_ERR,
1553 	EV_TX_PKT_TOO_BIG,
1554 	EV_TX_UNEXPECTED,
1555 	EV_GLOBAL,
1556 	EV_GLOBAL_MNT,
1557 	EV_DRIVER,
1558 	EV_DRIVER_SRM_UPD_DONE,
1559 	EV_DRIVER_TX_DESCQ_FLS_DONE,
1560 	EV_DRIVER_RX_DESCQ_FLS_DONE,
1561 	EV_DRIVER_RX_DESCQ_FLS_FAILED,
1562 	EV_DRIVER_RX_DSC_ERROR,
1563 	EV_DRIVER_TX_DSC_ERROR,
1564 	EV_DRV_GEN,
1565 	EV_MCDI_RESPONSE,
1566 	EV_NQSTATS
1567 } efx_ev_qstat_t;
1568 
1569 /* END MKCONFIG GENERATED EfxHeaderEventQueueBlock */
1570 
1571 #endif	/* EFSYS_OPT_QSTATS */
1572 
1573 extern	__checkReturn	efx_rc_t
1574 efx_ev_init(
1575 	__in		efx_nic_t *enp);
1576 
1577 extern		void
1578 efx_ev_fini(
1579 	__in		efx_nic_t *enp);
1580 
1581 #define	EFX_EVQ_MAXNEVS		32768
1582 #define	EFX_EVQ_MINNEVS		512
1583 
1584 #define	EFX_EVQ_SIZE(_nevs)	((_nevs) * sizeof (efx_qword_t))
1585 #define	EFX_EVQ_NBUFS(_nevs)	(EFX_EVQ_SIZE(_nevs) / EFX_BUF_SIZE)
1586 
1587 #define	EFX_EVQ_FLAGS_TYPE_MASK		(0x3)
1588 #define	EFX_EVQ_FLAGS_TYPE_AUTO		(0x0)
1589 #define	EFX_EVQ_FLAGS_TYPE_THROUGHPUT	(0x1)
1590 #define	EFX_EVQ_FLAGS_TYPE_LOW_LATENCY	(0x2)
1591 
1592 #define	EFX_EVQ_FLAGS_NOTIFY_MASK	(0xC)
1593 #define	EFX_EVQ_FLAGS_NOTIFY_INTERRUPT	(0x0)	/* Interrupting (default) */
1594 #define	EFX_EVQ_FLAGS_NOTIFY_DISABLED	(0x4)	/* Non-interrupting */
1595 
1596 extern	__checkReturn	efx_rc_t
1597 efx_ev_qcreate(
1598 	__in		efx_nic_t *enp,
1599 	__in		unsigned int index,
1600 	__in		efsys_mem_t *esmp,
1601 	__in		size_t n,
1602 	__in		uint32_t id,
1603 	__in		uint32_t us,
1604 	__in		uint32_t flags,
1605 	__deref_out	efx_evq_t **eepp);
1606 
1607 extern		void
1608 efx_ev_qpost(
1609 	__in		efx_evq_t *eep,
1610 	__in		uint16_t data);
1611 
1612 typedef __checkReturn	boolean_t
1613 (*efx_initialized_ev_t)(
1614 	__in_opt	void *arg);
1615 
1616 #define	EFX_PKT_UNICAST		0x0004
1617 #define	EFX_PKT_START		0x0008
1618 
1619 #define	EFX_PKT_VLAN_TAGGED	0x0010
1620 #define	EFX_CKSUM_TCPUDP	0x0020
1621 #define	EFX_CKSUM_IPV4		0x0040
1622 #define	EFX_PKT_CONT		0x0080
1623 
1624 #define	EFX_CHECK_VLAN		0x0100
1625 #define	EFX_PKT_TCP		0x0200
1626 #define	EFX_PKT_UDP		0x0400
1627 #define	EFX_PKT_IPV4		0x0800
1628 
1629 #define	EFX_PKT_IPV6		0x1000
1630 #define	EFX_PKT_PREFIX_LEN	0x2000
1631 #define	EFX_ADDR_MISMATCH	0x4000
1632 #define	EFX_DISCARD		0x8000
1633 
1634 #define	EFX_EV_RX_NLABELS	32
1635 #define	EFX_EV_TX_NLABELS	32
1636 
1637 typedef	__checkReturn	boolean_t
1638 (*efx_rx_ev_t)(
1639 	__in_opt	void *arg,
1640 	__in		uint32_t label,
1641 	__in		uint32_t id,
1642 	__in		uint32_t size,
1643 	__in		uint16_t flags);
1644 
1645 typedef	__checkReturn	boolean_t
1646 (*efx_tx_ev_t)(
1647 	__in_opt	void *arg,
1648 	__in		uint32_t label,
1649 	__in		uint32_t id);
1650 
1651 #define	EFX_EXCEPTION_RX_RECOVERY	0x00000001
1652 #define	EFX_EXCEPTION_RX_DSC_ERROR	0x00000002
1653 #define	EFX_EXCEPTION_TX_DSC_ERROR	0x00000003
1654 #define	EFX_EXCEPTION_UNKNOWN_SENSOREVT	0x00000004
1655 #define	EFX_EXCEPTION_FWALERT_SRAM	0x00000005
1656 #define	EFX_EXCEPTION_UNKNOWN_FWALERT	0x00000006
1657 #define	EFX_EXCEPTION_RX_ERROR		0x00000007
1658 #define	EFX_EXCEPTION_TX_ERROR		0x00000008
1659 #define	EFX_EXCEPTION_EV_ERROR		0x00000009
1660 
1661 typedef	__checkReturn	boolean_t
1662 (*efx_exception_ev_t)(
1663 	__in_opt	void *arg,
1664 	__in		uint32_t label,
1665 	__in		uint32_t data);
1666 
1667 typedef	__checkReturn	boolean_t
1668 (*efx_rxq_flush_done_ev_t)(
1669 	__in_opt	void *arg,
1670 	__in		uint32_t rxq_index);
1671 
1672 typedef	__checkReturn	boolean_t
1673 (*efx_rxq_flush_failed_ev_t)(
1674 	__in_opt	void *arg,
1675 	__in		uint32_t rxq_index);
1676 
1677 typedef	__checkReturn	boolean_t
1678 (*efx_txq_flush_done_ev_t)(
1679 	__in_opt	void *arg,
1680 	__in		uint32_t txq_index);
1681 
1682 typedef	__checkReturn	boolean_t
1683 (*efx_software_ev_t)(
1684 	__in_opt	void *arg,
1685 	__in		uint16_t magic);
1686 
1687 typedef	__checkReturn	boolean_t
1688 (*efx_sram_ev_t)(
1689 	__in_opt	void *arg,
1690 	__in		uint32_t code);
1691 
1692 #define	EFX_SRAM_CLEAR		0
1693 #define	EFX_SRAM_UPDATE		1
1694 #define	EFX_SRAM_ILLEGAL_CLEAR	2
1695 
1696 typedef	__checkReturn	boolean_t
1697 (*efx_wake_up_ev_t)(
1698 	__in_opt	void *arg,
1699 	__in		uint32_t label);
1700 
1701 typedef	__checkReturn	boolean_t
1702 (*efx_timer_ev_t)(
1703 	__in_opt	void *arg,
1704 	__in		uint32_t label);
1705 
1706 typedef __checkReturn	boolean_t
1707 (*efx_link_change_ev_t)(
1708 	__in_opt	void *arg,
1709 	__in		efx_link_mode_t	link_mode);
1710 
1711 #if EFSYS_OPT_MON_STATS
1712 
1713 typedef __checkReturn	boolean_t
1714 (*efx_monitor_ev_t)(
1715 	__in_opt	void *arg,
1716 	__in		efx_mon_stat_t id,
1717 	__in		efx_mon_stat_value_t value);
1718 
1719 #endif	/* EFSYS_OPT_MON_STATS */
1720 
1721 #if EFSYS_OPT_MAC_STATS
1722 
1723 typedef __checkReturn	boolean_t
1724 (*efx_mac_stats_ev_t)(
1725 	__in_opt	void *arg,
1726 	__in		uint32_t generation
1727 	);
1728 
1729 #endif	/* EFSYS_OPT_MAC_STATS */
1730 
1731 typedef struct efx_ev_callbacks_s {
1732 	efx_initialized_ev_t		eec_initialized;
1733 	efx_rx_ev_t			eec_rx;
1734 	efx_tx_ev_t			eec_tx;
1735 	efx_exception_ev_t		eec_exception;
1736 	efx_rxq_flush_done_ev_t		eec_rxq_flush_done;
1737 	efx_rxq_flush_failed_ev_t	eec_rxq_flush_failed;
1738 	efx_txq_flush_done_ev_t		eec_txq_flush_done;
1739 	efx_software_ev_t		eec_software;
1740 	efx_sram_ev_t			eec_sram;
1741 	efx_wake_up_ev_t		eec_wake_up;
1742 	efx_timer_ev_t			eec_timer;
1743 	efx_link_change_ev_t		eec_link_change;
1744 #if EFSYS_OPT_MON_STATS
1745 	efx_monitor_ev_t		eec_monitor;
1746 #endif	/* EFSYS_OPT_MON_STATS */
1747 #if EFSYS_OPT_MAC_STATS
1748 	efx_mac_stats_ev_t		eec_mac_stats;
1749 #endif	/* EFSYS_OPT_MAC_STATS */
1750 } efx_ev_callbacks_t;
1751 
1752 extern	__checkReturn	boolean_t
1753 efx_ev_qpending(
1754 	__in		efx_evq_t *eep,
1755 	__in		unsigned int count);
1756 
1757 #if EFSYS_OPT_EV_PREFETCH
1758 
1759 extern			void
1760 efx_ev_qprefetch(
1761 	__in		efx_evq_t *eep,
1762 	__in		unsigned int count);
1763 
1764 #endif	/* EFSYS_OPT_EV_PREFETCH */
1765 
1766 extern			void
1767 efx_ev_qpoll(
1768 	__in		efx_evq_t *eep,
1769 	__inout		unsigned int *countp,
1770 	__in		const efx_ev_callbacks_t *eecp,
1771 	__in_opt	void *arg);
1772 
1773 extern	__checkReturn	efx_rc_t
1774 efx_ev_usecs_to_ticks(
1775 	__in		efx_nic_t *enp,
1776 	__in		unsigned int usecs,
1777 	__out		unsigned int *ticksp);
1778 
1779 extern	__checkReturn	efx_rc_t
1780 efx_ev_qmoderate(
1781 	__in		efx_evq_t *eep,
1782 	__in		unsigned int us);
1783 
1784 extern	__checkReturn	efx_rc_t
1785 efx_ev_qprime(
1786 	__in		efx_evq_t *eep,
1787 	__in		unsigned int count);
1788 
1789 #if EFSYS_OPT_QSTATS
1790 
1791 #if EFSYS_OPT_NAMES
1792 
1793 extern		const char *
1794 efx_ev_qstat_name(
1795 	__in	efx_nic_t *enp,
1796 	__in	unsigned int id);
1797 
1798 #endif	/* EFSYS_OPT_NAMES */
1799 
1800 extern					void
1801 efx_ev_qstats_update(
1802 	__in				efx_evq_t *eep,
1803 	__inout_ecount(EV_NQSTATS)	efsys_stat_t *stat);
1804 
1805 #endif	/* EFSYS_OPT_QSTATS */
1806 
1807 extern		void
1808 efx_ev_qdestroy(
1809 	__in	efx_evq_t *eep);
1810 
1811 /* RX */
1812 
1813 extern	__checkReturn	efx_rc_t
1814 efx_rx_init(
1815 	__inout		efx_nic_t *enp);
1816 
1817 extern		void
1818 efx_rx_fini(
1819 	__in		efx_nic_t *enp);
1820 
1821 #if EFSYS_OPT_RX_SCATTER
1822 	__checkReturn	efx_rc_t
1823 efx_rx_scatter_enable(
1824 	__in		efx_nic_t *enp,
1825 	__in		unsigned int buf_size);
1826 #endif	/* EFSYS_OPT_RX_SCATTER */
1827 
1828 /* Handle to represent use of the default RSS context. */
1829 #define	EFX_RSS_CONTEXT_DEFAULT	0xffffffff
1830 
1831 #if EFSYS_OPT_RX_SCALE
1832 
1833 typedef enum efx_rx_hash_alg_e {
1834 	EFX_RX_HASHALG_LFSR = 0,
1835 	EFX_RX_HASHALG_TOEPLITZ
1836 } efx_rx_hash_alg_t;
1837 
1838 #define	EFX_RX_HASH_IPV4	(1U << 0)
1839 #define	EFX_RX_HASH_TCPIPV4	(1U << 1)
1840 #define	EFX_RX_HASH_IPV6	(1U << 2)
1841 #define	EFX_RX_HASH_TCPIPV6	(1U << 3)
1842 
1843 typedef unsigned int efx_rx_hash_type_t;
1844 
1845 typedef enum efx_rx_hash_support_e {
1846 	EFX_RX_HASH_UNAVAILABLE = 0,	/* Hardware hash not inserted */
1847 	EFX_RX_HASH_AVAILABLE		/* Insert hash with/without RSS */
1848 } efx_rx_hash_support_t;
1849 
1850 #define	EFX_RSS_TBL_SIZE	128	/* Rows in RX indirection table */
1851 #define	EFX_MAXRSS		64	/* RX indirection entry range */
1852 #define	EFX_MAXRSS_LEGACY	16	/* See bug16611 and bug17213 */
1853 
1854 typedef enum efx_rx_scale_support_e {
1855 	EFX_RX_SCALE_UNAVAILABLE = 0,	/* Not supported */
1856 	EFX_RX_SCALE_EXCLUSIVE,		/* Writable key/indirection table */
1857 	EFX_RX_SCALE_SHARED		/* Read-only key/indirection table */
1858 } efx_rx_scale_support_t;
1859 
1860 extern	__checkReturn	efx_rc_t
1861 efx_rx_hash_support_get(
1862 	__in		efx_nic_t *enp,
1863 	__out		efx_rx_hash_support_t *supportp);
1864 
1865 
1866 extern	__checkReturn	efx_rc_t
1867 efx_rx_scale_support_get(
1868 	__in		efx_nic_t *enp,
1869 	__out		efx_rx_scale_support_t *supportp);
1870 
1871 extern	__checkReturn	efx_rc_t
1872 efx_rx_scale_mode_set(
1873 	__in	efx_nic_t *enp,
1874 	__in	efx_rx_hash_alg_t alg,
1875 	__in	efx_rx_hash_type_t type,
1876 	__in	boolean_t insert);
1877 
1878 extern	__checkReturn	efx_rc_t
1879 efx_rx_scale_tbl_set(
1880 	__in		efx_nic_t *enp,
1881 	__in_ecount(n)	unsigned int *table,
1882 	__in		size_t n);
1883 
1884 extern	__checkReturn	efx_rc_t
1885 efx_rx_scale_key_set(
1886 	__in		efx_nic_t *enp,
1887 	__in_ecount(n)	uint8_t *key,
1888 	__in		size_t n);
1889 
1890 extern	__checkReturn	uint32_t
1891 efx_pseudo_hdr_hash_get(
1892 	__in		efx_rxq_t *erp,
1893 	__in		efx_rx_hash_alg_t func,
1894 	__in		uint8_t *buffer);
1895 
1896 #endif	/* EFSYS_OPT_RX_SCALE */
1897 
1898 extern	__checkReturn	efx_rc_t
1899 efx_pseudo_hdr_pkt_length_get(
1900 	__in		efx_rxq_t *erp,
1901 	__in		uint8_t *buffer,
1902 	__out		uint16_t *pkt_lengthp);
1903 
1904 #define	EFX_RXQ_MAXNDESCS		4096
1905 #define	EFX_RXQ_MINNDESCS		512
1906 
1907 #define	EFX_RXQ_SIZE(_ndescs)		((_ndescs) * sizeof (efx_qword_t))
1908 #define	EFX_RXQ_NBUFS(_ndescs)		(EFX_RXQ_SIZE(_ndescs) / EFX_BUF_SIZE)
1909 #define	EFX_RXQ_LIMIT(_ndescs)		((_ndescs) - 16)
1910 #define	EFX_RXQ_DC_NDESCS(_dcsize)	(8 << _dcsize)
1911 
1912 typedef enum efx_rxq_type_e {
1913 	EFX_RXQ_TYPE_DEFAULT,
1914 	EFX_RXQ_TYPE_SCATTER,
1915 	EFX_RXQ_NTYPES
1916 } efx_rxq_type_t;
1917 
1918 extern	__checkReturn	efx_rc_t
1919 efx_rx_qcreate(
1920 	__in		efx_nic_t *enp,
1921 	__in		unsigned int index,
1922 	__in		unsigned int label,
1923 	__in		efx_rxq_type_t type,
1924 	__in		efsys_mem_t *esmp,
1925 	__in		size_t n,
1926 	__in		uint32_t id,
1927 	__in		efx_evq_t *eep,
1928 	__deref_out	efx_rxq_t **erpp);
1929 
1930 typedef struct efx_buffer_s {
1931 	efsys_dma_addr_t	eb_addr;
1932 	size_t			eb_size;
1933 	boolean_t		eb_eop;
1934 } efx_buffer_t;
1935 
1936 typedef struct efx_desc_s {
1937 	efx_qword_t ed_eq;
1938 } efx_desc_t;
1939 
1940 extern			void
1941 efx_rx_qpost(
1942 	__in		efx_rxq_t *erp,
1943 	__in_ecount(n)	efsys_dma_addr_t *addrp,
1944 	__in		size_t size,
1945 	__in		unsigned int n,
1946 	__in		unsigned int completed,
1947 	__in		unsigned int added);
1948 
1949 extern		void
1950 efx_rx_qpush(
1951 	__in	efx_rxq_t *erp,
1952 	__in	unsigned int added,
1953 	__inout	unsigned int *pushedp);
1954 
1955 extern	__checkReturn	efx_rc_t
1956 efx_rx_qflush(
1957 	__in	efx_rxq_t *erp);
1958 
1959 extern		void
1960 efx_rx_qenable(
1961 	__in	efx_rxq_t *erp);
1962 
1963 extern		void
1964 efx_rx_qdestroy(
1965 	__in	efx_rxq_t *erp);
1966 
1967 /* TX */
1968 
1969 typedef struct efx_txq_s	efx_txq_t;
1970 
1971 #if EFSYS_OPT_QSTATS
1972 
1973 /* START MKCONFIG GENERATED EfxHeaderTransmitQueueBlock 12dff8778598b2db */
1974 typedef enum efx_tx_qstat_e {
1975 	TX_POST,
1976 	TX_POST_PIO,
1977 	TX_NQSTATS
1978 } efx_tx_qstat_t;
1979 
1980 /* END MKCONFIG GENERATED EfxHeaderTransmitQueueBlock */
1981 
1982 #endif	/* EFSYS_OPT_QSTATS */
1983 
1984 extern	__checkReturn	efx_rc_t
1985 efx_tx_init(
1986 	__in		efx_nic_t *enp);
1987 
1988 extern		void
1989 efx_tx_fini(
1990 	__in	efx_nic_t *enp);
1991 
1992 #define	EFX_TXQ_MINNDESCS		512
1993 
1994 #define	EFX_TXQ_SIZE(_ndescs)		((_ndescs) * sizeof (efx_qword_t))
1995 #define	EFX_TXQ_NBUFS(_ndescs)		(EFX_TXQ_SIZE(_ndescs) / EFX_BUF_SIZE)
1996 #define	EFX_TXQ_LIMIT(_ndescs)		((_ndescs) - 16)
1997 #define	EFX_TXQ_DC_NDESCS(_dcsize)	(8 << _dcsize)
1998 
1999 #define	EFX_TXQ_MAX_BUFS 8 /* Maximum independent of EFX_BUG35388_WORKAROUND. */
2000 
2001 #define	EFX_TXQ_CKSUM_IPV4		0x0001
2002 #define	EFX_TXQ_CKSUM_TCPUDP		0x0002
2003 #define	EFX_TXQ_FATSOV2			0x0004
2004 #define	EFX_TXQ_CKSUM_INNER_IPV4	0x0008
2005 #define	EFX_TXQ_CKSUM_INNER_TCPUDP	0x0010
2006 
2007 extern	__checkReturn	efx_rc_t
2008 efx_tx_qcreate(
2009 	__in		efx_nic_t *enp,
2010 	__in		unsigned int index,
2011 	__in		unsigned int label,
2012 	__in		efsys_mem_t *esmp,
2013 	__in		size_t n,
2014 	__in		uint32_t id,
2015 	__in		uint16_t flags,
2016 	__in		efx_evq_t *eep,
2017 	__deref_out	efx_txq_t **etpp,
2018 	__out		unsigned int *addedp);
2019 
2020 extern	__checkReturn	efx_rc_t
2021 efx_tx_qpost(
2022 	__in		efx_txq_t *etp,
2023 	__in_ecount(n)	efx_buffer_t *eb,
2024 	__in		unsigned int n,
2025 	__in		unsigned int completed,
2026 	__inout		unsigned int *addedp);
2027 
2028 extern	__checkReturn	efx_rc_t
2029 efx_tx_qpace(
2030 	__in		efx_txq_t *etp,
2031 	__in		unsigned int ns);
2032 
2033 extern			void
2034 efx_tx_qpush(
2035 	__in		efx_txq_t *etp,
2036 	__in		unsigned int added,
2037 	__in		unsigned int pushed);
2038 
2039 extern	__checkReturn	efx_rc_t
2040 efx_tx_qflush(
2041 	__in		efx_txq_t *etp);
2042 
2043 extern			void
2044 efx_tx_qenable(
2045 	__in		efx_txq_t *etp);
2046 
2047 extern	__checkReturn	efx_rc_t
2048 efx_tx_qpio_enable(
2049 	__in		efx_txq_t *etp);
2050 
2051 extern			void
2052 efx_tx_qpio_disable(
2053 	__in		efx_txq_t *etp);
2054 
2055 extern	__checkReturn	efx_rc_t
2056 efx_tx_qpio_write(
2057 	__in			efx_txq_t *etp,
2058 	__in_ecount(buf_length)	uint8_t *buffer,
2059 	__in			size_t buf_length,
2060 	__in			size_t pio_buf_offset);
2061 
2062 extern	__checkReturn	efx_rc_t
2063 efx_tx_qpio_post(
2064 	__in			efx_txq_t *etp,
2065 	__in			size_t pkt_length,
2066 	__in			unsigned int completed,
2067 	__inout			unsigned int *addedp);
2068 
2069 extern	__checkReturn	efx_rc_t
2070 efx_tx_qdesc_post(
2071 	__in		efx_txq_t *etp,
2072 	__in_ecount(n)	efx_desc_t *ed,
2073 	__in		unsigned int n,
2074 	__in		unsigned int completed,
2075 	__inout		unsigned int *addedp);
2076 
2077 extern	void
2078 efx_tx_qdesc_dma_create(
2079 	__in	efx_txq_t *etp,
2080 	__in	efsys_dma_addr_t addr,
2081 	__in	size_t size,
2082 	__in	boolean_t eop,
2083 	__out	efx_desc_t *edp);
2084 
2085 extern	void
2086 efx_tx_qdesc_tso_create(
2087 	__in	efx_txq_t *etp,
2088 	__in	uint16_t ipv4_id,
2089 	__in	uint32_t tcp_seq,
2090 	__in	uint8_t  tcp_flags,
2091 	__out	efx_desc_t *edp);
2092 
2093 /* Number of FATSOv2 option descriptors */
2094 #define	EFX_TX_FATSOV2_OPT_NDESCS		2
2095 
2096 /* Maximum number of DMA segments per TSO packet (not superframe) */
2097 #define	EFX_TX_FATSOV2_DMA_SEGS_PER_PKT_MAX	24
2098 
2099 extern	void
2100 efx_tx_qdesc_tso2_create(
2101 	__in			efx_txq_t *etp,
2102 	__in			uint16_t ipv4_id,
2103 	__in			uint32_t tcp_seq,
2104 	__in			uint16_t tcp_mss,
2105 	__out_ecount(count)	efx_desc_t *edp,
2106 	__in			int count);
2107 
2108 extern	void
2109 efx_tx_qdesc_vlantci_create(
2110 	__in	efx_txq_t *etp,
2111 	__in	uint16_t tci,
2112 	__out	efx_desc_t *edp);
2113 
2114 extern	void
2115 efx_tx_qdesc_checksum_create(
2116 	__in	efx_txq_t *etp,
2117 	__in	uint16_t flags,
2118 	__out	efx_desc_t *edp);
2119 
2120 #if EFSYS_OPT_QSTATS
2121 
2122 #if EFSYS_OPT_NAMES
2123 
2124 extern		const char *
2125 efx_tx_qstat_name(
2126 	__in	efx_nic_t *etp,
2127 	__in	unsigned int id);
2128 
2129 #endif	/* EFSYS_OPT_NAMES */
2130 
2131 extern					void
2132 efx_tx_qstats_update(
2133 	__in				efx_txq_t *etp,
2134 	__inout_ecount(TX_NQSTATS)	efsys_stat_t *stat);
2135 
2136 #endif	/* EFSYS_OPT_QSTATS */
2137 
2138 extern		void
2139 efx_tx_qdestroy(
2140 	__in	efx_txq_t *etp);
2141 
2142 
2143 /* FILTER */
2144 
2145 #if EFSYS_OPT_FILTER
2146 
2147 #define	EFX_ETHER_TYPE_IPV4 0x0800
2148 #define	EFX_ETHER_TYPE_IPV6 0x86DD
2149 
2150 #define	EFX_IPPROTO_TCP 6
2151 #define	EFX_IPPROTO_UDP 17
2152 #define	EFX_IPPROTO_GRE	47
2153 
2154 /* Use RSS to spread across multiple queues */
2155 #define	EFX_FILTER_FLAG_RX_RSS		0x01
2156 /* Enable RX scatter */
2157 #define	EFX_FILTER_FLAG_RX_SCATTER	0x02
2158 /*
2159  * Override an automatic filter (priority EFX_FILTER_PRI_AUTO).
2160  * May only be set by the filter implementation for each type.
2161  * A removal request will restore the automatic filter in its place.
2162  */
2163 #define	EFX_FILTER_FLAG_RX_OVER_AUTO	0x04
2164 /* Filter is for RX */
2165 #define	EFX_FILTER_FLAG_RX		0x08
2166 /* Filter is for TX */
2167 #define	EFX_FILTER_FLAG_TX		0x10
2168 
2169 typedef uint8_t efx_filter_flags_t;
2170 
2171 /*
2172  * Flags which specify the fields to match on. The values are the same as in the
2173  * MC_CMD_FILTER_OP/MC_CMD_FILTER_OP_EXT commands.
2174  */
2175 
2176 /* Match by remote IP host address */
2177 #define	EFX_FILTER_MATCH_REM_HOST		0x00000001
2178 /* Match by local IP host address */
2179 #define	EFX_FILTER_MATCH_LOC_HOST		0x00000002
2180 /* Match by remote MAC address */
2181 #define	EFX_FILTER_MATCH_REM_MAC		0x00000004
2182 /* Match by remote TCP/UDP port */
2183 #define	EFX_FILTER_MATCH_REM_PORT		0x00000008
2184 /* Match by remote TCP/UDP port */
2185 #define	EFX_FILTER_MATCH_LOC_MAC		0x00000010
2186 /* Match by local TCP/UDP port */
2187 #define	EFX_FILTER_MATCH_LOC_PORT		0x00000020
2188 /* Match by Ether-type */
2189 #define	EFX_FILTER_MATCH_ETHER_TYPE		0x00000040
2190 /* Match by inner VLAN ID */
2191 #define	EFX_FILTER_MATCH_INNER_VID		0x00000080
2192 /* Match by outer VLAN ID */
2193 #define	EFX_FILTER_MATCH_OUTER_VID		0x00000100
2194 /* Match by IP transport protocol */
2195 #define	EFX_FILTER_MATCH_IP_PROTO		0x00000200
2196 /* For encapsulated packets, match all multicast inner frames */
2197 #define	EFX_FILTER_MATCH_IFRM_UNKNOWN_MCAST_DST	0x01000000
2198 /* For encapsulated packets, match all unicast inner frames */
2199 #define	EFX_FILTER_MATCH_IFRM_UNKNOWN_UCAST_DST	0x02000000
2200 /* Match otherwise-unmatched multicast and broadcast packets */
2201 #define	EFX_FILTER_MATCH_UNKNOWN_MCAST_DST	0x40000000
2202 /* Match otherwise-unmatched unicast packets */
2203 #define	EFX_FILTER_MATCH_UNKNOWN_UCAST_DST	0x80000000
2204 
2205 typedef uint32_t efx_filter_match_flags_t;
2206 
2207 typedef enum efx_filter_priority_s {
2208 	EFX_FILTER_PRI_HINT = 0,	/* Performance hint */
2209 	EFX_FILTER_PRI_AUTO,		/* Automatic filter based on device
2210 					 * address list or hardware
2211 					 * requirements. This may only be used
2212 					 * by the filter implementation for
2213 					 * each NIC type. */
2214 	EFX_FILTER_PRI_MANUAL,		/* Manually configured filter */
2215 	EFX_FILTER_PRI_REQUIRED,	/* Required for correct behaviour of the
2216 					 * client (e.g. SR-IOV, HyperV VMQ etc.)
2217 					 */
2218 } efx_filter_priority_t;
2219 
2220 /*
2221  * FIXME: All these fields are assumed to be in little-endian byte order.
2222  * It may be better for some to be big-endian. See bug42804.
2223  */
2224 
2225 typedef struct efx_filter_spec_s {
2226 	efx_filter_match_flags_t	efs_match_flags;
2227 	uint8_t				efs_priority;
2228 	efx_filter_flags_t		efs_flags;
2229 	uint16_t			efs_dmaq_id;
2230 	uint32_t			efs_rss_context;
2231 	uint16_t			efs_outer_vid;
2232 	uint16_t			efs_inner_vid;
2233 	uint8_t				efs_loc_mac[EFX_MAC_ADDR_LEN];
2234 	uint8_t				efs_rem_mac[EFX_MAC_ADDR_LEN];
2235 	uint16_t			efs_ether_type;
2236 	uint8_t				efs_ip_proto;
2237 	efx_tunnel_protocol_t		efs_encap_type;
2238 	uint16_t			efs_loc_port;
2239 	uint16_t			efs_rem_port;
2240 	efx_oword_t			efs_rem_host;
2241 	efx_oword_t			efs_loc_host;
2242 } efx_filter_spec_t;
2243 
2244 
2245 /* Default values for use in filter specifications */
2246 #define	EFX_FILTER_SPEC_RX_DMAQ_ID_DROP		0xfff
2247 #define	EFX_FILTER_SPEC_VID_UNSPEC		0xffff
2248 
2249 extern	__checkReturn	efx_rc_t
2250 efx_filter_init(
2251 	__in		efx_nic_t *enp);
2252 
2253 extern			void
2254 efx_filter_fini(
2255 	__in		efx_nic_t *enp);
2256 
2257 extern	__checkReturn	efx_rc_t
2258 efx_filter_insert(
2259 	__in		efx_nic_t *enp,
2260 	__inout		efx_filter_spec_t *spec);
2261 
2262 extern	__checkReturn	efx_rc_t
2263 efx_filter_remove(
2264 	__in		efx_nic_t *enp,
2265 	__inout		efx_filter_spec_t *spec);
2266 
2267 extern	__checkReturn	efx_rc_t
2268 efx_filter_restore(
2269 	__in		efx_nic_t *enp);
2270 
2271 extern	__checkReturn	efx_rc_t
2272 efx_filter_supported_filters(
2273 	__in				efx_nic_t *enp,
2274 	__out_ecount(buffer_length)	uint32_t *buffer,
2275 	__in				size_t buffer_length,
2276 	__out				size_t *list_lengthp);
2277 
2278 extern			void
2279 efx_filter_spec_init_rx(
2280 	__out		efx_filter_spec_t *spec,
2281 	__in		efx_filter_priority_t priority,
2282 	__in		efx_filter_flags_t flags,
2283 	__in		efx_rxq_t *erp);
2284 
2285 extern			void
2286 efx_filter_spec_init_tx(
2287 	__out		efx_filter_spec_t *spec,
2288 	__in		efx_txq_t *etp);
2289 
2290 extern	__checkReturn	efx_rc_t
2291 efx_filter_spec_set_ipv4_local(
2292 	__inout		efx_filter_spec_t *spec,
2293 	__in		uint8_t proto,
2294 	__in		uint32_t host,
2295 	__in		uint16_t port);
2296 
2297 extern	__checkReturn	efx_rc_t
2298 efx_filter_spec_set_ipv4_full(
2299 	__inout		efx_filter_spec_t *spec,
2300 	__in		uint8_t proto,
2301 	__in		uint32_t lhost,
2302 	__in		uint16_t lport,
2303 	__in		uint32_t rhost,
2304 	__in		uint16_t rport);
2305 
2306 extern	__checkReturn	efx_rc_t
2307 efx_filter_spec_set_eth_local(
2308 	__inout		efx_filter_spec_t *spec,
2309 	__in		uint16_t vid,
2310 	__in		const uint8_t *addr);
2311 
2312 extern			void
2313 efx_filter_spec_set_ether_type(
2314 	__inout		efx_filter_spec_t *spec,
2315 	__in		uint16_t ether_type);
2316 
2317 extern	__checkReturn	efx_rc_t
2318 efx_filter_spec_set_uc_def(
2319 	__inout		efx_filter_spec_t *spec);
2320 
2321 extern	__checkReturn	efx_rc_t
2322 efx_filter_spec_set_mc_def(
2323 	__inout		efx_filter_spec_t *spec);
2324 
2325 typedef enum efx_filter_inner_frame_match_e {
2326 	EFX_FILTER_INNER_FRAME_MATCH_OTHER = 0,
2327 	EFX_FILTER_INNER_FRAME_MATCH_UNKNOWN_MCAST_DST,
2328 	EFX_FILTER_INNER_FRAME_MATCH_UNKNOWN_UCAST_DST
2329 } efx_filter_inner_frame_match_t;
2330 
2331 extern	__checkReturn	efx_rc_t
2332 efx_filter_spec_set_encap_type(
2333 	__inout		efx_filter_spec_t *spec,
2334 	__in		efx_tunnel_protocol_t encap_type,
2335 	__in		efx_filter_inner_frame_match_t inner_frame_match);
2336 
2337 
2338 #endif	/* EFSYS_OPT_FILTER */
2339 
2340 /* HASH */
2341 
2342 extern	__checkReturn		uint32_t
2343 efx_hash_dwords(
2344 	__in_ecount(count)	uint32_t const *input,
2345 	__in			size_t count,
2346 	__in			uint32_t init);
2347 
2348 extern	__checkReturn		uint32_t
2349 efx_hash_bytes(
2350 	__in_ecount(length)	uint8_t const *input,
2351 	__in			size_t length,
2352 	__in			uint32_t init);
2353 
2354 #if EFSYS_OPT_LICENSING
2355 
2356 /* LICENSING */
2357 
2358 typedef struct efx_key_stats_s {
2359 	uint32_t	eks_valid;
2360 	uint32_t	eks_invalid;
2361 	uint32_t	eks_blacklisted;
2362 	uint32_t	eks_unverifiable;
2363 	uint32_t	eks_wrong_node;
2364 	uint32_t	eks_licensed_apps_lo;
2365 	uint32_t	eks_licensed_apps_hi;
2366 	uint32_t	eks_licensed_features_lo;
2367 	uint32_t	eks_licensed_features_hi;
2368 } efx_key_stats_t;
2369 
2370 extern	__checkReturn		efx_rc_t
2371 efx_lic_init(
2372 	__in			efx_nic_t *enp);
2373 
2374 extern				void
2375 efx_lic_fini(
2376 	__in			efx_nic_t *enp);
2377 
2378 extern	__checkReturn	boolean_t
2379 efx_lic_check_support(
2380 	__in			efx_nic_t *enp);
2381 
2382 extern	__checkReturn	efx_rc_t
2383 efx_lic_update_licenses(
2384 	__in		efx_nic_t *enp);
2385 
2386 extern	__checkReturn	efx_rc_t
2387 efx_lic_get_key_stats(
2388 	__in		efx_nic_t *enp,
2389 	__out		efx_key_stats_t *ksp);
2390 
2391 extern	__checkReturn	efx_rc_t
2392 efx_lic_app_state(
2393 	__in		efx_nic_t *enp,
2394 	__in		uint64_t app_id,
2395 	__out		boolean_t *licensedp);
2396 
2397 extern	__checkReturn	efx_rc_t
2398 efx_lic_get_id(
2399 	__in		efx_nic_t *enp,
2400 	__in		size_t buffer_size,
2401 	__out		uint32_t *typep,
2402 	__out		size_t *lengthp,
2403 	__out_opt	uint8_t *bufferp);
2404 
2405 
2406 extern	__checkReturn		efx_rc_t
2407 efx_lic_find_start(
2408 	__in			efx_nic_t *enp,
2409 	__in_bcount(buffer_size)
2410 				caddr_t bufferp,
2411 	__in			size_t buffer_size,
2412 	__out			uint32_t *startp
2413 	);
2414 
2415 extern	__checkReturn		efx_rc_t
2416 efx_lic_find_end(
2417 	__in			efx_nic_t *enp,
2418 	__in_bcount(buffer_size)
2419 				caddr_t bufferp,
2420 	__in			size_t buffer_size,
2421 	__in			uint32_t offset,
2422 	__out			uint32_t *endp
2423 	);
2424 
2425 extern	__checkReturn	__success(return != B_FALSE)	boolean_t
2426 efx_lic_find_key(
2427 	__in			efx_nic_t *enp,
2428 	__in_bcount(buffer_size)
2429 				caddr_t bufferp,
2430 	__in			size_t buffer_size,
2431 	__in			uint32_t offset,
2432 	__out			uint32_t *startp,
2433 	__out			uint32_t *lengthp
2434 	);
2435 
2436 extern	__checkReturn	__success(return != B_FALSE)	boolean_t
2437 efx_lic_validate_key(
2438 	__in			efx_nic_t *enp,
2439 	__in_bcount(length)	caddr_t keyp,
2440 	__in			uint32_t length
2441 	);
2442 
2443 extern	__checkReturn		efx_rc_t
2444 efx_lic_read_key(
2445 	__in			efx_nic_t *enp,
2446 	__in_bcount(buffer_size)
2447 				caddr_t bufferp,
2448 	__in			size_t buffer_size,
2449 	__in			uint32_t offset,
2450 	__in			uint32_t length,
2451 	__out_bcount_part(key_max_size, *lengthp)
2452 				caddr_t keyp,
2453 	__in			size_t key_max_size,
2454 	__out			uint32_t *lengthp
2455 	);
2456 
2457 extern	__checkReturn		efx_rc_t
2458 efx_lic_write_key(
2459 	__in			efx_nic_t *enp,
2460 	__in_bcount(buffer_size)
2461 				caddr_t bufferp,
2462 	__in			size_t buffer_size,
2463 	__in			uint32_t offset,
2464 	__in_bcount(length)	caddr_t keyp,
2465 	__in			uint32_t length,
2466 	__out			uint32_t *lengthp
2467 	);
2468 
2469 	__checkReturn		efx_rc_t
2470 efx_lic_delete_key(
2471 	__in			efx_nic_t *enp,
2472 	__in_bcount(buffer_size)
2473 				caddr_t bufferp,
2474 	__in			size_t buffer_size,
2475 	__in			uint32_t offset,
2476 	__in			uint32_t length,
2477 	__in			uint32_t end,
2478 	__out			uint32_t *deltap
2479 	);
2480 
2481 extern	__checkReturn		efx_rc_t
2482 efx_lic_create_partition(
2483 	__in			efx_nic_t *enp,
2484 	__in_bcount(buffer_size)
2485 				caddr_t bufferp,
2486 	__in			size_t buffer_size
2487 	);
2488 
2489 extern	__checkReturn		efx_rc_t
2490 efx_lic_finish_partition(
2491 	__in			efx_nic_t *enp,
2492 	__in_bcount(buffer_size)
2493 				caddr_t bufferp,
2494 	__in			size_t buffer_size
2495 	);
2496 
2497 #endif	/* EFSYS_OPT_LICENSING */
2498 
2499 
2500 
2501 #ifdef	__cplusplus
2502 }
2503 #endif
2504 
2505 #endif	/* _SYS_EFX_H */
2506