1/*
2 * Copyright (c) 2017-2018 Cavium, 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
7 *  are met:
8 *
9 *  1. Redistributions of source code must retain the above copyright
10 *     notice, this list of conditions and the following disclaimer.
11 *  2. Redistributions in binary form must reproduce the above copyright
12 *     notice, this list of conditions and the following disclaimer in the
13 *     documentation and/or other materials provided with the distribution.
14 *
15 *  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
16 *  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 *  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 *  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
19 *  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
20 *  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
21 *  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
22 *  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
23 *  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
24 *  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
25 *  POSSIBILITY OF SUCH DAMAGE.
26 *
27 * $FreeBSD: stable/11/sys/dev/qlnx/qlnxe/eth_common.h 337517 2018-08-09 01:17:35Z davidcs $
28 *
29 */
30
31
32#ifndef __ETH_COMMON__
33#define __ETH_COMMON__
34/********************/
35/* ETH FW CONSTANTS */
36/********************/
37
38/* FP HSI version. FP HSI is compatible if (fwVer.major == drvVer.major && fwVer.minor >= drvVer.minor) */
39#define ETH_HSI_VER_MAJOR                   3    /* ETH FP HSI Major version */
40#define ETH_HSI_VER_MINOR                   10   /* ETH FP HSI Minor version */
41
42#define ETH_HSI_VER_NO_PKT_LEN_TUNN         5  /* Alias for 8.7.x.x/8.8.x.x ETH FP HSI MINOR version. In this version driver is not required to set pkt_len field in eth_tx_1st_bd struct, and tunneling offload is not supported. */
43
44#define ETH_CACHE_LINE_SIZE                 64
45#define ETH_RX_CQE_GAP                      32
46#define ETH_MAX_RAMROD_PER_CON              8
47#define ETH_TX_BD_PAGE_SIZE_BYTES           4096
48#define ETH_RX_BD_PAGE_SIZE_BYTES           4096
49#define ETH_RX_CQE_PAGE_SIZE_BYTES          4096
50#define ETH_RX_NUM_NEXT_PAGE_BDS            2
51
52/* Limitation for Tunneled LSO Packets on the offset (in bytes) of the inner IP header (relevant to LSO for tunneled packet): */
53#define ETH_MAX_TUNN_LSO_INNER_IPV4_OFFSET          253 /* Offset is limited to 253 bytes (inclusive). */
54#define ETH_MAX_TUNN_LSO_INNER_IPV6_OFFSET          251 /* Offset is limited to 251 bytes (inclusive). */
55
56#define ETH_TX_MIN_BDS_PER_NON_LSO_PKT              1
57#define ETH_TX_MAX_BDS_PER_NON_LSO_PACKET           18
58#define ETH_TX_MAX_BDS_PER_LSO_PACKET               255
59#define ETH_TX_MAX_LSO_HDR_NBD                      4
60#define ETH_TX_MIN_BDS_PER_LSO_PKT                  3
61#define ETH_TX_MIN_BDS_PER_TUNN_IPV6_WITH_EXT_PKT   3
62#define ETH_TX_MIN_BDS_PER_IPV6_WITH_EXT_PKT        2
63#define ETH_TX_MIN_BDS_PER_PKT_W_LOOPBACK_MODE      2
64#define ETH_TX_MAX_NON_LSO_PKT_LEN                  (9700 - (4 + 4 + 12 + 8)) /* (QM_REG_TASKBYTECRDCOST_0, QM_VOQ_BYTE_CRD_TASK_COST) - (VLAN-TAG + CRC + IPG + PREAMBLE) */
65#define ETH_TX_MAX_LSO_HDR_BYTES                    510
66#define ETH_TX_LSO_WINDOW_BDS_NUM                   (18 - 1)    /* Number of BDs to consider for LSO sliding window restriction is (ETH_TX_LSO_WINDOW_BDS_NUM - hdr_nbd) */
67#define ETH_TX_LSO_WINDOW_MIN_LEN                   9700  /* Minimum data length (in bytes) in LSO sliding window */
68#define ETH_TX_MAX_LSO_PAYLOAD_LEN                  0xFE000  /* Maximum LSO packet TCP payload length (in bytes) */
69#define ETH_TX_NUM_SAME_AS_LAST_ENTRIES             320 /* Number of same-as-last resources in tx switching */
70#define ETH_TX_INACTIVE_SAME_AS_LAST                0xFFFF /* Value for a connection for which same as last feature is disabled */
71
72#define ETH_NUM_STATISTIC_COUNTERS                  MAX_NUM_VPORTS                                     /* Maximum number of statistics counters */
73#define ETH_NUM_STATISTIC_COUNTERS_DOUBLE_VF_ZONE   (ETH_NUM_STATISTIC_COUNTERS - MAX_NUM_VFS/2)       /* Maximum number of statistics counters when doubled VF zone used */
74#define ETH_NUM_STATISTIC_COUNTERS_QUAD_VF_ZONE     (ETH_NUM_STATISTIC_COUNTERS - 3*MAX_NUM_VFS/4)     /* Maximum number of statistics counters when quad VF zone used */
75
76#define ETH_RX_MAX_BUFF_PER_PKT             5       /* Maximum number of buffers, used for RX packet placement */
77#define ETH_RX_BD_THRESHOLD                12       /* Minimum number of free BDs in RX ring, that guarantee receiving of at least one RX packet. */
78
79/* num of MAC/VLAN filters */
80#define ETH_NUM_MAC_FILTERS                 512
81#define ETH_NUM_VLAN_FILTERS                512
82
83/* approx. multicast constants */
84#define ETH_MULTICAST_BIN_FROM_MAC_SEED     0     /* CRC seed for multicast bin calculation */
85#define ETH_MULTICAST_MAC_BINS              256
86#define ETH_MULTICAST_MAC_BINS_IN_REGS      (ETH_MULTICAST_MAC_BINS / 32)
87
88/*  ethernet vport update constants */
89#define ETH_FILTER_RULES_COUNT              10
90#define ETH_RSS_IND_TABLE_ENTRIES_NUM       128  /* number of RSS indirection table entries, per Vport) */
91#define ETH_RSS_KEY_SIZE_REGS               10  /* Length of RSS key (in regs) */
92#define ETH_RSS_ENGINE_NUM_K2               207 /* number of available RSS engines in K2 */
93#define ETH_RSS_ENGINE_NUM_BB               127 /* number of available RSS engines in BB */
94
95/* TPA constants */
96#define ETH_TPA_MAX_AGGS_NUM              64      /* Maximum number of open TPA aggregations */
97#define ETH_TPA_CQE_START_LEN_LIST_SIZE   ETH_RX_MAX_BUFF_PER_PKT   /* Maximum number of additional buffers, reported by TPA-start CQE */
98#define ETH_TPA_CQE_CONT_LEN_LIST_SIZE    6       /* Maximum number of buffers, reported by TPA-continue CQE */
99#define ETH_TPA_CQE_END_LEN_LIST_SIZE     4       /* Maximum number of buffers, reported by TPA-end CQE */
100
101/* Control frame check constants */
102#define ETH_CTL_FRAME_ETH_TYPE_NUM              4        /* Number of etherType values configured by the driver for control frame check */
103
104/* GFS constants */
105#define ETH_GFT_TRASHCAN_VPORT         0x1FF          /* GFT drop flow vport number */
106
107
108
109/*
110 * Destination port mode
111 */
112enum dest_port_mode
113{
114	DEST_PORT_PHY /* Send to physical port. */,
115	DEST_PORT_LOOPBACK /* Send to loopback port. */,
116	DEST_PORT_PHY_LOOPBACK /* Send to physical and loopback port. */,
117	DEST_PORT_DROP /* Drop the packet in PBF. */,
118	MAX_DEST_PORT_MODE
119};
120
121
122/*
123 * Ethernet address type
124 */
125enum eth_addr_type
126{
127	BROADCAST_ADDRESS,
128	MULTICAST_ADDRESS,
129	UNICAST_ADDRESS,
130	UNKNOWN_ADDRESS,
131	MAX_ETH_ADDR_TYPE
132};
133
134
135struct eth_tx_1st_bd_flags
136{
137	u8 bitfields;
138#define ETH_TX_1ST_BD_FLAGS_START_BD_MASK         0x1 /* Set to 1 in the first BD. (for debug) */
139#define ETH_TX_1ST_BD_FLAGS_START_BD_SHIFT        0
140#define ETH_TX_1ST_BD_FLAGS_FORCE_VLAN_MODE_MASK  0x1 /* Do not allow additional VLAN manipulations on this packet. */
141#define ETH_TX_1ST_BD_FLAGS_FORCE_VLAN_MODE_SHIFT 1
142#define ETH_TX_1ST_BD_FLAGS_IP_CSUM_MASK          0x1 /* Recalculate IP checksum. For tunneled packet - relevant to inner header. */
143#define ETH_TX_1ST_BD_FLAGS_IP_CSUM_SHIFT         2
144#define ETH_TX_1ST_BD_FLAGS_L4_CSUM_MASK          0x1 /* Recalculate TCP/UDP checksum. For tunneled packet - relevant to inner header. */
145#define ETH_TX_1ST_BD_FLAGS_L4_CSUM_SHIFT         3
146#define ETH_TX_1ST_BD_FLAGS_VLAN_INSERTION_MASK   0x1 /* If set, insert VLAN tag from vlan field to the packet. For tunneled packet - relevant to outer header. */
147#define ETH_TX_1ST_BD_FLAGS_VLAN_INSERTION_SHIFT  4
148#define ETH_TX_1ST_BD_FLAGS_LSO_MASK              0x1 /* If set, this is an LSO packet. Note: For Tunneled LSO packets, the offset of the inner IPV4 (and IPV6) header is limited to 253 (and 251 respectively) bytes, inclusive. */
149#define ETH_TX_1ST_BD_FLAGS_LSO_SHIFT             5
150#define ETH_TX_1ST_BD_FLAGS_TUNN_IP_CSUM_MASK     0x1 /* Recalculate Tunnel IP Checksum (if Tunnel IP Header is IPv4) */
151#define ETH_TX_1ST_BD_FLAGS_TUNN_IP_CSUM_SHIFT    6
152#define ETH_TX_1ST_BD_FLAGS_TUNN_L4_CSUM_MASK     0x1 /* Recalculate Tunnel UDP/GRE Checksum (Depending on Tunnel Type) */
153#define ETH_TX_1ST_BD_FLAGS_TUNN_L4_CSUM_SHIFT    7
154};
155
156/*
157 * The parsing information data for the first tx bd of a given packet.
158 */
159struct eth_tx_data_1st_bd
160{
161	__le16 vlan /* VLAN tag to insert to packet (if enabled by vlan_insertion flag). */;
162	u8 nbds /* Number of BDs in packet. Should be at least 1 in non-LSO packet and at least 3 in LSO (or Tunnel with IPv6+ext) packet. */;
163	struct eth_tx_1st_bd_flags bd_flags;
164	__le16 bitfields;
165#define ETH_TX_DATA_1ST_BD_TUNN_FLAG_MASK  0x1 /* Indicates a tunneled packet. Must be set for encapsulated packet. */
166#define ETH_TX_DATA_1ST_BD_TUNN_FLAG_SHIFT 0
167#define ETH_TX_DATA_1ST_BD_RESERVED0_MASK  0x1
168#define ETH_TX_DATA_1ST_BD_RESERVED0_SHIFT 1
169#define ETH_TX_DATA_1ST_BD_PKT_LEN_MASK    0x3FFF /* Total packet length - must be filled for non-LSO packets. */
170#define ETH_TX_DATA_1ST_BD_PKT_LEN_SHIFT   2
171};
172
173/*
174 * The parsing information data for the second tx bd of a given packet.
175 */
176struct eth_tx_data_2nd_bd
177{
178	__le16 tunn_ip_size /* For tunnel with IPv6+ext - Tunnel header IP datagram length (in BYTEs) */;
179	__le16 bitfields1;
180#define ETH_TX_DATA_2ND_BD_TUNN_INNER_L2_HDR_SIZE_W_MASK  0xF /* For Tunnel header with IPv6 ext. - Inner L2 Header Size (in 2-byte WORDs) */
181#define ETH_TX_DATA_2ND_BD_TUNN_INNER_L2_HDR_SIZE_W_SHIFT 0
182#define ETH_TX_DATA_2ND_BD_TUNN_INNER_ETH_TYPE_MASK       0x3 /* For Tunnel header with IPv6 ext. - Inner L2 Header MAC DA Type (use enum eth_addr_type) */
183#define ETH_TX_DATA_2ND_BD_TUNN_INNER_ETH_TYPE_SHIFT      4
184#define ETH_TX_DATA_2ND_BD_DEST_PORT_MODE_MASK            0x3 /* Destination port mode. (use enum dest_port_mode) */
185#define ETH_TX_DATA_2ND_BD_DEST_PORT_MODE_SHIFT           6
186#define ETH_TX_DATA_2ND_BD_START_BD_MASK                  0x1 /* Should be 0 in all the BDs, except the first one. (for debug) */
187#define ETH_TX_DATA_2ND_BD_START_BD_SHIFT                 8
188#define ETH_TX_DATA_2ND_BD_TUNN_TYPE_MASK                 0x3 /* For Tunnel header with IPv6 ext. - Tunnel Type (use enum eth_tx_tunn_type) */
189#define ETH_TX_DATA_2ND_BD_TUNN_TYPE_SHIFT                9
190#define ETH_TX_DATA_2ND_BD_TUNN_INNER_IPV6_MASK           0x1 /* For LSO / Tunnel header with IPv6+ext - Set if inner header is IPv6 */
191#define ETH_TX_DATA_2ND_BD_TUNN_INNER_IPV6_SHIFT          11
192#define ETH_TX_DATA_2ND_BD_IPV6_EXT_MASK                  0x1 /* In tunneling mode - Set to 1 when the Inner header is IPv6 with extension. Otherwise set to 1 if the header is IPv6 with extension. */
193#define ETH_TX_DATA_2ND_BD_IPV6_EXT_SHIFT                 12
194#define ETH_TX_DATA_2ND_BD_TUNN_IPV6_EXT_MASK             0x1 /* Set to 1 if Tunnel (outer = encapsulating) header has IPv6 ext. (Note: 3rd BD is required, hence EDPM does not support Tunnel [outer] header with Ipv6Ext) */
195#define ETH_TX_DATA_2ND_BD_TUNN_IPV6_EXT_SHIFT            13
196#define ETH_TX_DATA_2ND_BD_L4_UDP_MASK                    0x1 /* Set if (inner) L4 protocol is UDP. (Required when IPv6+ext (or tunnel with inner or outer Ipv6+ext) and l4_csum is set) */
197#define ETH_TX_DATA_2ND_BD_L4_UDP_SHIFT                   14
198#define ETH_TX_DATA_2ND_BD_L4_PSEUDO_CSUM_MODE_MASK       0x1 /* The pseudo header checksum type in the L4 checksum field. Required when IPv6+ext and l4_csum is set. (use enum eth_l4_pseudo_checksum_mode) */
199#define ETH_TX_DATA_2ND_BD_L4_PSEUDO_CSUM_MODE_SHIFT      15
200	__le16 bitfields2;
201#define ETH_TX_DATA_2ND_BD_L4_HDR_START_OFFSET_W_MASK     0x1FFF /* For inner/outer header IPv6+ext - (inner) L4 header offset (in 2-byte WORDs). For regular packet - offset from the beginning of the packet. For tunneled packet - offset from the beginning of the inner header */
202#define ETH_TX_DATA_2ND_BD_L4_HDR_START_OFFSET_W_SHIFT    0
203#define ETH_TX_DATA_2ND_BD_RESERVED0_MASK                 0x7
204#define ETH_TX_DATA_2ND_BD_RESERVED0_SHIFT                13
205};
206
207/*
208 * Firmware data for L2-EDPM packet.
209 */
210struct eth_edpm_fw_data
211{
212	struct eth_tx_data_1st_bd data_1st_bd /* Parsing information data from the 1st BD. */;
213	struct eth_tx_data_2nd_bd data_2nd_bd /* Parsing information data from the 2nd BD. */;
214	__le32 reserved;
215};
216
217
218/*
219 * tunneling parsing flags
220 */
221struct eth_tunnel_parsing_flags
222{
223	u8 flags;
224#define ETH_TUNNEL_PARSING_FLAGS_TYPE_MASK              0x3 /* 0 - no tunneling, 1 - GENEVE, 2 - GRE, 3 - VXLAN (use enum eth_rx_tunn_type) */
225#define ETH_TUNNEL_PARSING_FLAGS_TYPE_SHIFT             0
226#define ETH_TUNNEL_PARSING_FLAGS_TENNANT_ID_EXIST_MASK  0x1 /*  If it s not an encapsulated packet then put 0x0. If it s an encapsulated packet but the tenant-id doesn t exist then put 0x0. Else put 0x1 */
227#define ETH_TUNNEL_PARSING_FLAGS_TENNANT_ID_EXIST_SHIFT 2
228#define ETH_TUNNEL_PARSING_FLAGS_NEXT_PROTOCOL_MASK     0x3 /* Type of the next header above the tunneling: 0 - unknown, 1 - L2, 2 - Ipv4, 3 - IPv6 (use enum tunnel_next_protocol) */
229#define ETH_TUNNEL_PARSING_FLAGS_NEXT_PROTOCOL_SHIFT    3
230#define ETH_TUNNEL_PARSING_FLAGS_FIRSTHDRIPMATCH_MASK   0x1 /* The result of comparing the DA-ip of the tunnel header. */
231#define ETH_TUNNEL_PARSING_FLAGS_FIRSTHDRIPMATCH_SHIFT  5
232#define ETH_TUNNEL_PARSING_FLAGS_IPV4_FRAGMENT_MASK     0x1
233#define ETH_TUNNEL_PARSING_FLAGS_IPV4_FRAGMENT_SHIFT    6
234#define ETH_TUNNEL_PARSING_FLAGS_IPV4_OPTIONS_MASK      0x1
235#define ETH_TUNNEL_PARSING_FLAGS_IPV4_OPTIONS_SHIFT     7
236};
237
238/*
239 * PMD flow control bits
240 */
241struct eth_pmd_flow_flags
242{
243	u8 flags;
244#define ETH_PMD_FLOW_FLAGS_VALID_MASK     0x1 /* CQE valid bit */
245#define ETH_PMD_FLOW_FLAGS_VALID_SHIFT    0
246#define ETH_PMD_FLOW_FLAGS_TOGGLE_MASK    0x1 /* CQE ring toggle bit */
247#define ETH_PMD_FLOW_FLAGS_TOGGLE_SHIFT   1
248#define ETH_PMD_FLOW_FLAGS_RESERVED_MASK  0x3F
249#define ETH_PMD_FLOW_FLAGS_RESERVED_SHIFT 2
250};
251
252/*
253 * Regular ETH Rx FP CQE.
254 */
255struct eth_fast_path_rx_reg_cqe
256{
257	u8 type /* CQE type (use enum eth_rx_cqe_type) */;
258	u8 bitfields;
259#define ETH_FAST_PATH_RX_REG_CQE_RSS_HASH_TYPE_MASK  0x7 /* Type of calculated RSS hash (use enum rss_hash_type) */
260#define ETH_FAST_PATH_RX_REG_CQE_RSS_HASH_TYPE_SHIFT 0
261#define ETH_FAST_PATH_RX_REG_CQE_TC_MASK             0xF /* Traffic Class */
262#define ETH_FAST_PATH_RX_REG_CQE_TC_SHIFT            3
263#define ETH_FAST_PATH_RX_REG_CQE_RESERVED0_MASK      0x1
264#define ETH_FAST_PATH_RX_REG_CQE_RESERVED0_SHIFT     7
265	__le16 pkt_len /* Total packet length (from the parser) */;
266	struct parsing_and_err_flags pars_flags /* Parsing and error flags from the parser */;
267	__le16 vlan_tag /* 802.1q VLAN tag */;
268	__le32 rss_hash /* RSS hash result */;
269	__le16 len_on_first_bd /* Number of bytes placed on first BD */;
270	u8 placement_offset /* Offset of placement from BD start */;
271	struct eth_tunnel_parsing_flags tunnel_pars_flags /* Tunnel Parsing Flags */;
272	u8 bd_num /* Number of BDs, used for packet */;
273	u8 reserved;
274	__le16 flow_id /* aRFS flow ID. */;
275	u8 reserved1[11];
276	struct eth_pmd_flow_flags pmd_flags /* CQE valid and toggle bits */;
277};
278
279
280/*
281 * TPA-continue ETH Rx FP CQE.
282 */
283struct eth_fast_path_rx_tpa_cont_cqe
284{
285	u8 type /* CQE type (use enum eth_rx_cqe_type) */;
286	u8 tpa_agg_index /* TPA aggregation index */;
287	__le16 len_list[ETH_TPA_CQE_CONT_LEN_LIST_SIZE] /* List of the segment sizes */;
288	u8 reserved;
289	u8 reserved1 /* FW reserved. */;
290	__le16 reserved2[ETH_TPA_CQE_CONT_LEN_LIST_SIZE] /* FW reserved. */;
291	u8 reserved3[3];
292	struct eth_pmd_flow_flags pmd_flags /* CQE valid and toggle bits */;
293};
294
295
296/*
297 * TPA-end ETH Rx FP CQE .
298 */
299struct eth_fast_path_rx_tpa_end_cqe
300{
301	u8 type /* CQE type (use enum eth_rx_cqe_type) */;
302	u8 tpa_agg_index /* TPA aggregation index */;
303	__le16 total_packet_len /* Total aggregated packet length */;
304	u8 num_of_bds /* Total number of BDs comprising the packet */;
305	u8 end_reason /* Aggregation end reason. Use enum eth_tpa_end_reason */;
306	__le16 num_of_coalesced_segs /* Number of coalesced TCP segments */;
307	__le32 ts_delta /* TCP timestamp delta */;
308	__le16 len_list[ETH_TPA_CQE_END_LEN_LIST_SIZE] /* List of the segment sizes */;
309	__le16 reserved3[ETH_TPA_CQE_END_LEN_LIST_SIZE] /* FW reserved. */;
310	__le16 reserved1;
311	u8 reserved2 /* FW reserved. */;
312	struct eth_pmd_flow_flags pmd_flags /* CQE valid and toggle bits */;
313};
314
315
316/*
317 * TPA-start ETH Rx FP CQE.
318 */
319struct eth_fast_path_rx_tpa_start_cqe
320{
321	u8 type /* CQE type (use enum eth_rx_cqe_type) */;
322	u8 bitfields;
323#define ETH_FAST_PATH_RX_TPA_START_CQE_RSS_HASH_TYPE_MASK  0x7 /* Type of calculated RSS hash (use enum rss_hash_type) */
324#define ETH_FAST_PATH_RX_TPA_START_CQE_RSS_HASH_TYPE_SHIFT 0
325#define ETH_FAST_PATH_RX_TPA_START_CQE_TC_MASK             0xF /* Traffic Class */
326#define ETH_FAST_PATH_RX_TPA_START_CQE_TC_SHIFT            3
327#define ETH_FAST_PATH_RX_TPA_START_CQE_RESERVED0_MASK      0x1
328#define ETH_FAST_PATH_RX_TPA_START_CQE_RESERVED0_SHIFT     7
329	__le16 seg_len /* Segment length (packetLen from the parser) */;
330	struct parsing_and_err_flags pars_flags /* Parsing and error flags from the parser */;
331	__le16 vlan_tag /* 802.1q VLAN tag */;
332	__le32 rss_hash /* RSS hash result */;
333	__le16 len_on_first_bd /* Number of bytes placed on first BD */;
334	u8 placement_offset /* Offset of placement from BD start */;
335	struct eth_tunnel_parsing_flags tunnel_pars_flags /* Tunnel Parsing Flags */;
336	u8 tpa_agg_index /* TPA aggregation index */;
337	u8 header_len /* Packet L2+L3+L4 header length */;
338	__le16 ext_bd_len_list[ETH_TPA_CQE_START_LEN_LIST_SIZE] /* Additional BDs length list. */;
339	__le16 flow_id /* aRFS flow ID. */;
340	u8 reserved;
341	struct eth_pmd_flow_flags pmd_flags /* CQE valid and toggle bits */;
342};
343
344
345/*
346 * The L4 pseudo checksum mode for Ethernet
347 */
348enum eth_l4_pseudo_checksum_mode
349{
350	ETH_L4_PSEUDO_CSUM_CORRECT_LENGTH /* Pseudo Header checksum on packet is calculated with the correct packet length field. */,
351	ETH_L4_PSEUDO_CSUM_ZERO_LENGTH /* Pseudo Header checksum on packet is calculated with zero length field. */,
352	MAX_ETH_L4_PSEUDO_CHECKSUM_MODE
353};
354
355
356
357struct eth_rx_bd
358{
359	struct regpair addr /* single continues buffer */;
360};
361
362
363/*
364 * regular ETH Rx SP CQE
365 */
366struct eth_slow_path_rx_cqe
367{
368	u8 type /* CQE type (use enum eth_rx_cqe_type) */;
369	u8 ramrod_cmd_id;
370	u8 error_flag;
371	u8 reserved[25];
372	__le16 echo;
373	u8 reserved1;
374	struct eth_pmd_flow_flags pmd_flags /* CQE valid and toggle bits */;
375};
376
377/*
378 * union for all ETH Rx CQE types
379 */
380union eth_rx_cqe
381{
382	struct eth_fast_path_rx_reg_cqe fast_path_regular /* Regular FP CQE */;
383	struct eth_fast_path_rx_tpa_start_cqe fast_path_tpa_start /* TPA-start CQE */;
384	struct eth_fast_path_rx_tpa_cont_cqe fast_path_tpa_cont /* TPA-continue CQE */;
385	struct eth_fast_path_rx_tpa_end_cqe fast_path_tpa_end /* TPA-end CQE */;
386	struct eth_slow_path_rx_cqe slow_path /* SP CQE */;
387};
388
389
390/*
391 * ETH Rx CQE type
392 */
393enum eth_rx_cqe_type
394{
395	ETH_RX_CQE_TYPE_UNUSED,
396	ETH_RX_CQE_TYPE_REGULAR /* Regular FP ETH Rx CQE */,
397	ETH_RX_CQE_TYPE_SLOW_PATH /* Slow path ETH Rx CQE */,
398	ETH_RX_CQE_TYPE_TPA_START /* TPA start ETH Rx CQE */,
399	ETH_RX_CQE_TYPE_TPA_CONT /* TPA Continue ETH Rx CQE */,
400	ETH_RX_CQE_TYPE_TPA_END /* TPA end ETH Rx CQE */,
401	MAX_ETH_RX_CQE_TYPE
402};
403
404
405/*
406 * Wrapper for PD RX CQE - used in order to cover full cache line when writing CQE
407 */
408struct eth_rx_pmd_cqe
409{
410	union eth_rx_cqe cqe /* CQE data itself */;
411	u8 reserved[ETH_RX_CQE_GAP];
412};
413
414
415/*
416 * Eth RX Tunnel Type
417 */
418enum eth_rx_tunn_type
419{
420	ETH_RX_NO_TUNN /* No Tunnel. */,
421	ETH_RX_TUNN_GENEVE /* GENEVE Tunnel. */,
422	ETH_RX_TUNN_GRE /* GRE Tunnel. */,
423	ETH_RX_TUNN_VXLAN /* VXLAN Tunnel. */,
424	MAX_ETH_RX_TUNN_TYPE
425};
426
427
428
429/*
430 * Aggregation end reason.
431 */
432enum eth_tpa_end_reason
433{
434	ETH_AGG_END_UNUSED,
435	ETH_AGG_END_SP_UPDATE /* SP configuration update */,
436	ETH_AGG_END_MAX_LEN /* Maximum aggregation length or maximum buffer number used. */,
437	ETH_AGG_END_LAST_SEG /* TCP PSH flag or TCP payload length below continue threshold. */,
438	ETH_AGG_END_TIMEOUT /* Timeout expiration. */,
439	ETH_AGG_END_NOT_CONSISTENT /* Packet header not consistency: different IPv4 TOS, TTL or flags, IPv6 TC, Hop limit or Flow label, TCP header length or TS options. In GRO different TS value, SMAC, DMAC, ackNum, windowSize or VLAN */,
440	ETH_AGG_END_OUT_OF_ORDER /* Out of order or retransmission packet: sequence, ack or timestamp not consistent with previous segment. */,
441	ETH_AGG_END_NON_TPA_SEG /* Next segment cant be aggregated due to LLC/SNAP, IP error, IP fragment, IPv4 options, IPv6 extension, IP ECN = CE, TCP errors, TCP options, zero TCP payload length , TCP flags or not supported tunnel header options.  */,
442	MAX_ETH_TPA_END_REASON
443};
444
445
446
447/*
448 * The first tx bd of a given packet
449 */
450struct eth_tx_1st_bd
451{
452	struct regpair addr /* Single continuous buffer */;
453	__le16 nbytes /* Number of bytes in this BD. */;
454	struct eth_tx_data_1st_bd data /* Parsing information data. */;
455};
456
457
458
459/*
460 * The second tx bd of a given packet
461 */
462struct eth_tx_2nd_bd
463{
464	struct regpair addr /* Single continuous buffer */;
465	__le16 nbytes /* Number of bytes in this BD. */;
466	struct eth_tx_data_2nd_bd data /* Parsing information data. */;
467};
468
469
470/*
471 * The parsing information data for the third tx bd of a given packet.
472 */
473struct eth_tx_data_3rd_bd
474{
475	__le16 lso_mss /* For LSO packet - the MSS in bytes. */;
476	__le16 bitfields;
477#define ETH_TX_DATA_3RD_BD_TCP_HDR_LEN_DW_MASK  0xF /* For LSO with inner/outer IPv6+ext - TCP header length (in 4-byte WORDs) */
478#define ETH_TX_DATA_3RD_BD_TCP_HDR_LEN_DW_SHIFT 0
479#define ETH_TX_DATA_3RD_BD_HDR_NBD_MASK         0xF /* LSO - number of BDs which contain headers. value should be in range (1..ETH_TX_MAX_LSO_HDR_NBD). */
480#define ETH_TX_DATA_3RD_BD_HDR_NBD_SHIFT        4
481#define ETH_TX_DATA_3RD_BD_START_BD_MASK        0x1 /* Should be 0 in all the BDs, except the first one. (for debug) */
482#define ETH_TX_DATA_3RD_BD_START_BD_SHIFT       8
483#define ETH_TX_DATA_3RD_BD_RESERVED0_MASK       0x7F
484#define ETH_TX_DATA_3RD_BD_RESERVED0_SHIFT      9
485	u8 tunn_l4_hdr_start_offset_w /* For tunnel with IPv6+ext - Pointer to the tunnel L4 Header (in 2-byte WORDs) */;
486	u8 tunn_hdr_size_w /* For tunnel with IPv6+ext - Total size of the Tunnel Header (in 2-byte WORDs) */;
487};
488
489/*
490 * The third tx bd of a given packet
491 */
492struct eth_tx_3rd_bd
493{
494	struct regpair addr /* Single continuous buffer */;
495	__le16 nbytes /* Number of bytes in this BD. */;
496	struct eth_tx_data_3rd_bd data /* Parsing information data. */;
497};
498
499
500/*
501 * Complementary information for the regular tx bd of a given packet.
502 */
503struct eth_tx_data_bd
504{
505	__le16 reserved0;
506	__le16 bitfields;
507#define ETH_TX_DATA_BD_RESERVED1_MASK  0xFF
508#define ETH_TX_DATA_BD_RESERVED1_SHIFT 0
509#define ETH_TX_DATA_BD_START_BD_MASK   0x1 /* Should be 0 in all the BDs, except the first one. (for debug) */
510#define ETH_TX_DATA_BD_START_BD_SHIFT  8
511#define ETH_TX_DATA_BD_RESERVED2_MASK  0x7F
512#define ETH_TX_DATA_BD_RESERVED2_SHIFT 9
513	__le16 reserved3;
514};
515
516/*
517 * The common regular TX BD ring element
518 */
519struct eth_tx_bd
520{
521	struct regpair addr /* Single continuous buffer */;
522	__le16 nbytes /* Number of bytes in this BD. */;
523	struct eth_tx_data_bd data /* Complementary information. */;
524};
525
526
527union eth_tx_bd_types
528{
529	struct eth_tx_1st_bd first_bd /* The first tx bd of a given packet */;
530	struct eth_tx_2nd_bd second_bd /* The second tx bd of a given packet */;
531	struct eth_tx_3rd_bd third_bd /* The third tx bd of a given packet */;
532	struct eth_tx_bd reg_bd /* The common non-special bd */;
533};
534
535
536
537
538
539
540/*
541 * Eth Tx Tunnel Type
542 */
543enum eth_tx_tunn_type
544{
545	ETH_TX_TUNN_GENEVE /* GENEVE Tunnel. */,
546	ETH_TX_TUNN_TTAG /* T-Tag Tunnel. */,
547	ETH_TX_TUNN_GRE /* GRE Tunnel. */,
548	ETH_TX_TUNN_VXLAN /* VXLAN Tunnel. */,
549	MAX_ETH_TX_TUNN_TYPE
550};
551
552
553/*
554 * Ystorm Queue Zone
555 */
556struct xstorm_eth_queue_zone
557{
558	struct coalescing_timeset int_coalescing_timeset /* Tx interrupt coalescing TimeSet */;
559	u8 reserved[7];
560};
561
562
563/*
564 * ETH doorbell data
565 */
566struct eth_db_data
567{
568	u8 params;
569#define ETH_DB_DATA_DEST_MASK         0x3 /* destination of doorbell (use enum db_dest) */
570#define ETH_DB_DATA_DEST_SHIFT        0
571#define ETH_DB_DATA_AGG_CMD_MASK      0x3 /* aggregative command to CM (use enum db_agg_cmd_sel) */
572#define ETH_DB_DATA_AGG_CMD_SHIFT     2
573#define ETH_DB_DATA_BYPASS_EN_MASK    0x1 /* enable QM bypass */
574#define ETH_DB_DATA_BYPASS_EN_SHIFT   4
575#define ETH_DB_DATA_RESERVED_MASK     0x1
576#define ETH_DB_DATA_RESERVED_SHIFT    5
577#define ETH_DB_DATA_AGG_VAL_SEL_MASK  0x3 /* aggregative value selection */
578#define ETH_DB_DATA_AGG_VAL_SEL_SHIFT 6
579	u8 agg_flags /* bit for every DQ counter flags in CM context that DQ can increment */;
580	__le16 bd_prod;
581};
582
583
584/*
585 * RSS hash type
586 */
587enum rss_hash_type
588{
589	RSS_HASH_TYPE_DEFAULT=0,
590	RSS_HASH_TYPE_IPV4=1,
591	RSS_HASH_TYPE_TCP_IPV4=2,
592	RSS_HASH_TYPE_IPV6=3,
593	RSS_HASH_TYPE_TCP_IPV6=4,
594	RSS_HASH_TYPE_UDP_IPV4=5,
595	RSS_HASH_TYPE_UDP_IPV6=6,
596	MAX_RSS_HASH_TYPE
597};
598
599#endif /* __ETH_COMMON__ */
600