1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright (c) 2016 - 2018 Cavium Inc.
7 #ifndef __ECORE_L2_API_H__
8 #define __ECORE_L2_API_H__
10 #include "ecore_status.h"
11 #include "ecore_sp_api.h"
12 #include "ecore_int_api.h"
14 #ifndef __EXTRACT__LINUX__
18 ECORE_RSS_IPV4_TCP = 0x4,
19 ECORE_RSS_IPV6_TCP = 0x8,
20 ECORE_RSS_IPV4_UDP = 0x10,
21 ECORE_RSS_IPV6_UDP = 0x20,
24 /* Should be the same as ETH_RSS_IND_TABLE_ENTRIES_NUM */
25 #define ECORE_RSS_IND_TABLE_SIZE 128
26 #define ECORE_RSS_KEY_SIZE 10 /* size in 32b chunks */
29 struct ecore_queue_start_common_params {
30 /* Should always be relative to entity sending this. */
34 /* Relative, but relevant only for PFs */
37 struct ecore_sb_info *p_sb;
41 struct ecore_rxq_start_ret_params {
42 void OSAL_IOMEM *p_prod;
46 struct ecore_txq_start_ret_params {
47 void OSAL_IOMEM *p_doorbell;
51 struct ecore_rss_params {
55 u8 update_rss_capabilities;
56 u8 update_rss_ind_table;
59 u8 rss_table_size_log; /* The table size is 2 ^ rss_table_size_log */
61 /* Indirection table consist of rx queue handles */
62 void *rss_ind_table[ECORE_RSS_IND_TABLE_SIZE];
63 u32 rss_key[ECORE_RSS_KEY_SIZE];
66 struct ecore_sge_tpa_params {
67 u8 max_buffers_per_cqe;
72 u8 tpa_ipv4_tunn_en_flg;
73 u8 tpa_ipv6_tunn_en_flg;
75 u8 update_tpa_param_flg;
77 u8 tpa_hdr_data_split_flg;
78 u8 tpa_gro_consistent_flg;
81 u16 tpa_min_size_to_start;
82 u16 tpa_min_size_to_cont;
85 enum ecore_filter_opcode {
89 ECORE_FILTER_REPLACE, /* Delete all MACs and add new one instead */
90 ECORE_FILTER_FLUSH, /* Removes all filters */
93 enum ecore_filter_ucast_type {
96 ECORE_FILTER_MAC_VLAN,
97 ECORE_FILTER_INNER_MAC,
98 ECORE_FILTER_INNER_VLAN,
99 ECORE_FILTER_INNER_PAIR,
100 ECORE_FILTER_INNER_MAC_VNI_PAIR,
101 ECORE_FILTER_MAC_VNI_PAIR,
103 ECORE_FILTER_UNUSED, /* @DPDK */
106 struct ecore_filter_ucast {
107 enum ecore_filter_opcode opcode;
108 enum ecore_filter_ucast_type type;
112 u8 vport_to_remove_from;
113 unsigned char mac[ETH_ALEN];
119 struct ecore_filter_mcast {
120 /* MOVE is not supported for multicast */
121 enum ecore_filter_opcode opcode;
123 u8 vport_to_remove_from;
125 #define ECORE_MAX_MC_ADDRS 64
126 unsigned char mac[ECORE_MAX_MC_ADDRS][ETH_ALEN];
129 struct ecore_filter_accept_flags {
130 u8 update_rx_mode_config;
131 u8 update_tx_mode_config;
134 #define ECORE_ACCEPT_NONE 0x01
135 #define ECORE_ACCEPT_UCAST_MATCHED 0x02
136 #define ECORE_ACCEPT_UCAST_UNMATCHED 0x04
137 #define ECORE_ACCEPT_MCAST_MATCHED 0x08
138 #define ECORE_ACCEPT_MCAST_UNMATCHED 0x10
139 #define ECORE_ACCEPT_BCAST 0x20
140 #define ECORE_ACCEPT_ANY_VNI 0x40
143 enum ecore_filter_config_mode {
144 ECORE_FILTER_CONFIG_MODE_DISABLE,
145 ECORE_FILTER_CONFIG_MODE_5_TUPLE,
146 ECORE_FILTER_CONFIG_MODE_L4_PORT,
147 ECORE_FILTER_CONFIG_MODE_IP_DEST,
148 ECORE_FILTER_CONFIG_MODE_TUNN_TYPE,
149 ECORE_FILTER_CONFIG_MODE_IP_SRC,
152 struct ecore_arfs_config_params {
157 enum ecore_filter_config_mode mode;
160 /* Add / remove / move / remove-all unicast MAC-VLAN filters.
161 * FW will assert in the following cases, so driver should take care...:
162 * 1. Adding a filter to a full table.
163 * 2. Adding a filter which already exists on that vport.
164 * 3. Removing a filter which doesn't exist.
168 ecore_filter_ucast_cmd(struct ecore_dev *p_dev,
169 struct ecore_filter_ucast *p_filter_cmd,
170 enum spq_mode comp_mode,
171 struct ecore_spq_comp_cb *p_comp_data);
173 /* Add / remove / move multicast MAC filters. */
175 ecore_filter_mcast_cmd(struct ecore_dev *p_dev,
176 struct ecore_filter_mcast *p_filter_cmd,
177 enum spq_mode comp_mode,
178 struct ecore_spq_comp_cb *p_comp_data);
180 /* Set "accept" filters */
182 ecore_filter_accept_cmd(
183 struct ecore_dev *p_dev,
185 struct ecore_filter_accept_flags accept_flags,
186 u8 update_accept_any_vlan,
188 enum spq_mode comp_mode,
189 struct ecore_spq_comp_cb *p_comp_data);
192 * @brief ecore_eth_rx_queue_start - RX Queue Start Ramrod
194 * This ramrod initializes an RX Queue for a VPort. An Assert is generated if
195 * the VPort ID is not currently initialized.
199 * @p_params Inputs; Relative for PF [SB being an exception]
200 * @param bd_max_bytes Maximum bytes that can be placed on a BD
201 * @param bd_chain_phys_addr Physical address of BDs for receive.
202 * @param cqe_pbl_addr Physical address of the CQE PBL Table.
203 * @param cqe_pbl_size Size of the CQE PBL Table
204 * @param p_ret_params Pointed struct to be filled with outputs.
206 * @return enum _ecore_status_t
209 ecore_eth_rx_queue_start(struct ecore_hwfn *p_hwfn,
211 struct ecore_queue_start_common_params *p_params,
213 dma_addr_t bd_chain_phys_addr,
214 dma_addr_t cqe_pbl_addr,
216 struct ecore_rxq_start_ret_params *p_ret_params);
219 * @brief ecore_eth_rx_queue_stop - This ramrod closes an Rx queue
222 * @param p_rxq Handler of queue to close
223 * @param eq_completion_only If True completion will be on
224 * EQe, if False completion will be
225 * on EQe if p_hwfn opaque
226 * different from the RXQ opaque
228 * @param cqe_completion If True completion will be
230 * @return enum _ecore_status_t
233 ecore_eth_rx_queue_stop(struct ecore_hwfn *p_hwfn,
235 bool eq_completion_only,
236 bool cqe_completion);
239 * @brief - TX Queue Start Ramrod
241 * This ramrod initializes a TX Queue for a VPort. An Assert is generated if
242 * the VPort is not currently initialized.
247 * @param tc traffic class to use with this L2 txq
248 * @param pbl_addr address of the pbl array
249 * @param pbl_size number of entries in pbl
250 * @param p_ret_params Pointer to fill the return parameters in.
252 * @return enum _ecore_status_t
255 ecore_eth_tx_queue_start(struct ecore_hwfn *p_hwfn,
257 struct ecore_queue_start_common_params *p_params,
261 struct ecore_txq_start_ret_params *p_ret_params);
264 * @brief ecore_eth_tx_queue_stop - closes a Tx queue
267 * @param p_txq - handle to Tx queue needed to be closed
269 * @return enum _ecore_status_t
271 enum _ecore_status_t ecore_eth_tx_queue_stop(struct ecore_hwfn *p_hwfn,
274 enum ecore_tpa_mode {
281 struct ecore_sp_vport_start_params {
282 enum ecore_tpa_mode tpa_mode;
283 bool remove_inner_vlan; /* Inner VLAN removal is enabled */
284 bool tx_switching; /* Vport supports tx-switching */
285 bool handle_ptp_pkts; /* Handle PTP packets */
286 bool only_untagged; /* Untagged pkt control */
287 bool drop_ttl0; /* Drop packets with TTL = 0 */
288 u8 max_buffers_per_cqe;
291 u8 vport_id; /* VPORT ID */
292 u16 mtu; /* VPORT MTU */
293 bool zero_placement_offset;
297 /* Strict behavior on transmission errors */
298 bool b_err_illegal_vlan_mode;
299 bool b_err_illegal_inband_mode;
300 bool b_err_vlan_insert_with_inband;
301 bool b_err_small_pkt;
303 bool b_err_anti_spoof;
304 bool b_err_ctrl_frame;
308 * @brief ecore_sp_vport_start -
310 * This ramrod initializes a VPort. An Assert if generated if the Function ID
311 * of the VPort is not enabled.
314 * @param p_params VPORT start params
316 * @return enum _ecore_status_t
319 ecore_sp_vport_start(struct ecore_hwfn *p_hwfn,
320 struct ecore_sp_vport_start_params *p_params);
322 struct ecore_sp_vport_update_params {
325 u8 update_vport_active_rx_flg;
326 u8 vport_active_rx_flg;
327 u8 update_vport_active_tx_flg;
328 u8 vport_active_tx_flg;
329 u8 update_inner_vlan_removal_flg;
330 u8 inner_vlan_removal_flg;
331 u8 silent_vlan_removal_flg;
332 u8 update_default_vlan_enable_flg;
333 u8 default_vlan_enable_flg;
334 u8 update_default_vlan_flg;
336 u8 update_tx_switching_flg;
338 u8 update_approx_mcast_flg;
339 u8 update_anti_spoofing_en_flg;
341 u8 update_accept_any_vlan_flg;
344 struct ecore_rss_params *rss_params;
345 struct ecore_filter_accept_flags accept_flags;
346 struct ecore_sge_tpa_params *sge_tpa_params;
347 /* MTU change - notice this requires the vport to be disabled.
348 * If non-zero, value would be used.
354 * @brief ecore_sp_vport_update -
356 * This ramrod updates the parameters of the VPort. Every field can be updated
357 * independently, according to flags.
359 * This ramrod is also used to set the VPort state to active after creation.
360 * An Assert is generated if the VPort does not contain an RX queue.
365 * @return enum _ecore_status_t
368 ecore_sp_vport_update(struct ecore_hwfn *p_hwfn,
369 struct ecore_sp_vport_update_params *p_params,
370 enum spq_mode comp_mode,
371 struct ecore_spq_comp_cb *p_comp_data);
373 * @brief ecore_sp_vport_stop -
375 * This ramrod closes a VPort after all its RX and TX queues are terminated.
376 * An Assert is generated if any queues are left open.
380 * @param vport_id VPort ID
382 * @return enum _ecore_status_t
384 enum _ecore_status_t ecore_sp_vport_stop(struct ecore_hwfn *p_hwfn,
389 ecore_sp_eth_filter_ucast(struct ecore_hwfn *p_hwfn,
391 struct ecore_filter_ucast *p_filter_cmd,
392 enum spq_mode comp_mode,
393 struct ecore_spq_comp_cb *p_comp_data);
396 * @brief ecore_sp_rx_eth_queues_update -
398 * This ramrod updates an RX queue. It is used for setting the active state
399 * of the queue and updating the TPA and SGE parameters.
401 * @note Final phase API.
404 * @param pp_rxq_handlers An array of queue handlers to be updated.
405 * @param num_rxqs number of queues to update.
406 * @param complete_cqe_flg Post completion to the CQE Ring if set
407 * @param complete_event_flg Post completion to the Event Ring if set
411 * @return enum _ecore_status_t
415 ecore_sp_eth_rx_queues_update(struct ecore_hwfn *p_hwfn,
416 void **pp_rxq_handlers,
419 u8 complete_event_flg,
420 enum spq_mode comp_mode,
421 struct ecore_spq_comp_cb *p_comp_data);
423 void __ecore_get_vport_stats(struct ecore_hwfn *p_hwfn,
424 struct ecore_ptt *p_ptt,
425 struct ecore_eth_stats *stats,
426 u16 statistics_bin, bool b_get_port_stats);
428 void ecore_get_vport_stats(struct ecore_dev *p_dev,
429 struct ecore_eth_stats *stats);
431 void ecore_reset_vport_stats(struct ecore_dev *p_dev);
434 *@brief ecore_arfs_mode_configure -
436 *Enable or disable rfs mode. It must accept atleast one of tcp or udp true
437 *and atleast one of ipv4 or ipv6 true to enable rfs mode.
441 *@param p_cfg_params arfs mode configuration parameters.
444 void ecore_arfs_mode_configure(struct ecore_hwfn *p_hwfn,
445 struct ecore_ptt *p_ptt,
446 struct ecore_arfs_config_params *p_cfg_params);
449 * @brief - ecore_configure_rfs_ntuple_filter
451 * This ramrod should be used to add or remove arfs hw filter
454 * @params p_cb Used for ECORE_SPQ_MODE_CB,where client would initialize
455 * it with cookie and callback function address, if not
456 * using this mode then client must pass NULL.
457 * @params p_addr p_addr is an actual packet header that needs to be
458 * filter. It has to mapped with IO to read prior to
459 * calling this, [contains 4 tuples- src ip, dest ip,
460 * src port, dest port].
461 * @params length length of p_addr header up to past the transport header.
462 * @params qid receive packet will be directed to this queue.
464 * @params b_is_add flag to add or remove filter.
468 ecore_configure_rfs_ntuple_filter(struct ecore_hwfn *p_hwfn,
469 struct ecore_spq_comp_cb *p_cb,
470 dma_addr_t p_addr, u16 length,
471 u16 qid, u8 vport_id,