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
,