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
142 struct ecore_arfs_config_params {
147 bool arfs_enable; /* Enable or disable arfs mode */
150 /* Add / remove / move / remove-all unicast MAC-VLAN filters.
151 * FW will assert in the following cases, so driver should take care...:
152 * 1. Adding a filter to a full table.
153 * 2. Adding a filter which already exists on that vport.
154 * 3. Removing a filter which doesn't exist.
158 ecore_filter_ucast_cmd(struct ecore_dev *p_dev,
159 struct ecore_filter_ucast *p_filter_cmd,
160 enum spq_mode comp_mode,
161 struct ecore_spq_comp_cb *p_comp_data);
163 /* Add / remove / move multicast MAC filters. */
165 ecore_filter_mcast_cmd(struct ecore_dev *p_dev,
166 struct ecore_filter_mcast *p_filter_cmd,
167 enum spq_mode comp_mode,
168 struct ecore_spq_comp_cb *p_comp_data);
170 /* Set "accept" filters */
172 ecore_filter_accept_cmd(
173 struct ecore_dev *p_dev,
175 struct ecore_filter_accept_flags accept_flags,
176 u8 update_accept_any_vlan,
178 enum spq_mode comp_mode,
179 struct ecore_spq_comp_cb *p_comp_data);
182 * @brief ecore_eth_rx_queue_start - RX Queue Start Ramrod
184 * This ramrod initializes an RX Queue for a VPort. An Assert is generated if
185 * the VPort ID is not currently initialized.
189 * @p_params Inputs; Relative for PF [SB being an exception]
190 * @param bd_max_bytes Maximum bytes that can be placed on a BD
191 * @param bd_chain_phys_addr Physical address of BDs for receive.
192 * @param cqe_pbl_addr Physical address of the CQE PBL Table.
193 * @param cqe_pbl_size Size of the CQE PBL Table
194 * @param p_ret_params Pointed struct to be filled with outputs.
196 * @return enum _ecore_status_t
199 ecore_eth_rx_queue_start(struct ecore_hwfn *p_hwfn,
201 struct ecore_queue_start_common_params *p_params,
203 dma_addr_t bd_chain_phys_addr,
204 dma_addr_t cqe_pbl_addr,
206 struct ecore_rxq_start_ret_params *p_ret_params);
209 * @brief ecore_eth_rx_queue_stop - This ramrod closes an Rx queue
212 * @param p_rxq Handler of queue to close
213 * @param eq_completion_only If True completion will be on
214 * EQe, if False completion will be
215 * on EQe if p_hwfn opaque
216 * different from the RXQ opaque
218 * @param cqe_completion If True completion will be
220 * @return enum _ecore_status_t
223 ecore_eth_rx_queue_stop(struct ecore_hwfn *p_hwfn,
225 bool eq_completion_only,
226 bool cqe_completion);
229 * @brief - TX Queue Start Ramrod
231 * This ramrod initializes a TX Queue for a VPort. An Assert is generated if
232 * the VPort is not currently initialized.
237 * @param tc traffic class to use with this L2 txq
238 * @param pbl_addr address of the pbl array
239 * @param pbl_size number of entries in pbl
240 * @param p_ret_params Pointer to fill the return parameters in.
242 * @return enum _ecore_status_t
245 ecore_eth_tx_queue_start(struct ecore_hwfn *p_hwfn,
247 struct ecore_queue_start_common_params *p_params,
251 struct ecore_txq_start_ret_params *p_ret_params);
254 * @brief ecore_eth_tx_queue_stop - closes a Tx queue
257 * @param p_txq - handle to Tx queue needed to be closed
259 * @return enum _ecore_status_t
261 enum _ecore_status_t ecore_eth_tx_queue_stop(struct ecore_hwfn *p_hwfn,
264 enum ecore_tpa_mode {
271 struct ecore_sp_vport_start_params {
272 enum ecore_tpa_mode tpa_mode;
273 bool remove_inner_vlan; /* Inner VLAN removal is enabled */
274 bool tx_switching; /* Vport supports tx-switching */
275 bool handle_ptp_pkts; /* Handle PTP packets */
276 bool only_untagged; /* Untagged pkt control */
277 bool drop_ttl0; /* Drop packets with TTL = 0 */
278 u8 max_buffers_per_cqe;
281 u8 vport_id; /* VPORT ID */
282 u16 mtu; /* VPORT MTU */
283 bool zero_placement_offset;
287 /* Strict behavior on transmission errors */
288 bool b_err_illegal_vlan_mode;
289 bool b_err_illegal_inband_mode;
290 bool b_err_vlan_insert_with_inband;
291 bool b_err_small_pkt;
293 bool b_err_anti_spoof;
294 bool b_err_ctrl_frame;
298 * @brief ecore_sp_vport_start -
300 * This ramrod initializes a VPort. An Assert if generated if the Function ID
301 * of the VPort is not enabled.
304 * @param p_params VPORT start params
306 * @return enum _ecore_status_t
309 ecore_sp_vport_start(struct ecore_hwfn *p_hwfn,
310 struct ecore_sp_vport_start_params *p_params);
312 struct ecore_sp_vport_update_params {
315 u8 update_vport_active_rx_flg;
316 u8 vport_active_rx_flg;
317 u8 update_vport_active_tx_flg;
318 u8 vport_active_tx_flg;
319 u8 update_inner_vlan_removal_flg;
320 u8 inner_vlan_removal_flg;
321 u8 silent_vlan_removal_flg;
322 u8 update_default_vlan_enable_flg;
323 u8 default_vlan_enable_flg;
324 u8 update_default_vlan_flg;
326 u8 update_tx_switching_flg;
328 u8 update_approx_mcast_flg;
329 u8 update_anti_spoofing_en_flg;
331 u8 update_accept_any_vlan_flg;
334 struct ecore_rss_params *rss_params;
335 struct ecore_filter_accept_flags accept_flags;
336 struct ecore_sge_tpa_params *sge_tpa_params;
337 /* MTU change - notice this requires the vport to be disabled.
338 * If non-zero, value would be used.
344 * @brief ecore_sp_vport_update -
346 * This ramrod updates the parameters of the VPort. Every field can be updated
347 * independently, according to flags.
349 * This ramrod is also used to set the VPort state to active after creation.
350 * An Assert is generated if the VPort does not contain an RX queue.
355 * @return enum _ecore_status_t
358 ecore_sp_vport_update(struct ecore_hwfn *p_hwfn,
359 struct ecore_sp_vport_update_params *p_params,
360 enum spq_mode comp_mode,
361 struct ecore_spq_comp_cb *p_comp_data);
363 * @brief ecore_sp_vport_stop -
365 * This ramrod closes a VPort after all its RX and TX queues are terminated.
366 * An Assert is generated if any queues are left open.
370 * @param vport_id VPort ID
372 * @return enum _ecore_status_t
374 enum _ecore_status_t ecore_sp_vport_stop(struct ecore_hwfn *p_hwfn,
379 ecore_sp_eth_filter_ucast(struct ecore_hwfn *p_hwfn,
381 struct ecore_filter_ucast *p_filter_cmd,
382 enum spq_mode comp_mode,
383 struct ecore_spq_comp_cb *p_comp_data);
386 * @brief ecore_sp_rx_eth_queues_update -
388 * This ramrod updates an RX queue. It is used for setting the active state
389 * of the queue and updating the TPA and SGE parameters.
391 * @note Final phase API.
394 * @param pp_rxq_handlers An array of queue handlers to be updated.
395 * @param num_rxqs number of queues to update.
396 * @param complete_cqe_flg Post completion to the CQE Ring if set
397 * @param complete_event_flg Post completion to the Event Ring if set
401 * @return enum _ecore_status_t
405 ecore_sp_eth_rx_queues_update(struct ecore_hwfn *p_hwfn,
406 void **pp_rxq_handlers,
409 u8 complete_event_flg,
410 enum spq_mode comp_mode,
411 struct ecore_spq_comp_cb *p_comp_data);
413 void __ecore_get_vport_stats(struct ecore_hwfn *p_hwfn,
414 struct ecore_ptt *p_ptt,
415 struct ecore_eth_stats *stats,
416 u16 statistics_bin, bool b_get_port_stats);
418 void ecore_get_vport_stats(struct ecore_dev *p_dev,
419 struct ecore_eth_stats *stats);
421 void ecore_reset_vport_stats(struct ecore_dev *p_dev);
424 *@brief ecore_arfs_mode_configure -
426 *Enable or disable rfs mode. It must accept atleast one of tcp or udp true
427 *and atleast one of ipv4 or ipv6 true to enable rfs mode.
431 *@param p_cfg_params arfs mode configuration parameters.
434 void ecore_arfs_mode_configure(struct ecore_hwfn *p_hwfn,
435 struct ecore_ptt *p_ptt,
436 struct ecore_arfs_config_params *p_cfg_params);
439 * @brief - ecore_configure_rfs_ntuple_filter
441 * This ramrod should be used to add or remove arfs hw filter
444 * @params p_cb Used for ECORE_SPQ_MODE_CB,where client would initialize
445 * it with cookie and callback function address, if not
446 * using this mode then client must pass NULL.
447 * @params p_addr p_addr is an actual packet header that needs to be
448 * filter. It has to mapped with IO to read prior to
449 * calling this, [contains 4 tuples- src ip, dest ip,
450 * src port, dest port].
451 * @params length length of p_addr header up to past the transport header.
452 * @params qid receive packet will be directed to this queue.
454 * @params b_is_add flag to add or remove filter.
458 ecore_configure_rfs_ntuple_filter(struct ecore_hwfn *p_hwfn,
459 struct ecore_spq_comp_cb *p_cb,
460 dma_addr_t p_addr, u16 length,
461 u16 qid, u8 vport_id,