1 /* SPDX-License-Identifier: BSD-3-Clause */
2 /* Copyright (c) 2020, Intel Corporation
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions are met:
8 * 1. Redistributions of source code must retain the above copyright notice,
9 * 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.
15 * 3. Neither the name of the Intel Corporation nor the names of its
16 * contributors may be used to endorse or promote products derived from
17 * this software without specific prior written permission.
19 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
20 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
23 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
33 #ifndef _ICE_SWITCH_H_
34 #define _ICE_SWITCH_H_
36 #include "ice_common.h"
37 #include "ice_protocol_type.h"
39 #define ICE_SW_CFG_MAX_BUF_LEN 2048
40 #define ICE_MAX_SW 256
41 #define ICE_DFLT_VSI_INVAL 0xff
42 #define ICE_FLTR_RX BIT(0)
43 #define ICE_FLTR_TX BIT(1)
44 #define ICE_FLTR_TX_RX (ICE_FLTR_RX | ICE_FLTR_TX)
46 #define DUMMY_ETH_HDR_LEN 16
47 #define ICE_SW_RULE_RX_TX_ETH_HDR_SIZE \
48 (offsetof(struct ice_aqc_sw_rules_elem, pdata.lkup_tx_rx.hdr) + \
49 (DUMMY_ETH_HDR_LEN * \
50 sizeof(((struct ice_sw_rule_lkup_rx_tx *)0)->hdr[0])))
51 #define ICE_SW_RULE_RX_TX_NO_HDR_SIZE \
52 (offsetof(struct ice_aqc_sw_rules_elem, pdata.lkup_tx_rx.hdr))
53 #define ICE_SW_RULE_LG_ACT_SIZE(n) \
54 (offsetof(struct ice_aqc_sw_rules_elem, pdata.lg_act.act) + \
55 ((n) * sizeof(((struct ice_sw_rule_lg_act *)0)->act[0])))
56 #define ICE_SW_RULE_VSI_LIST_SIZE(n) \
57 (offsetof(struct ice_aqc_sw_rules_elem, pdata.vsi_list.vsi) + \
58 ((n) * sizeof(((struct ice_sw_rule_vsi_list *)0)->vsi[0])))
60 /* Worst case buffer length for ice_aqc_opc_get_res_alloc */
61 #define ICE_MAX_RES_TYPES 0x80
62 #define ICE_AQ_GET_RES_ALLOC_BUF_LEN \
63 (ICE_MAX_RES_TYPES * sizeof(struct ice_aqc_get_res_resp_elem))
65 #define ICE_VSI_INVAL_ID 0xFFFF
66 #define ICE_INVAL_Q_HANDLE 0xFFFF
68 /* VSI context structure for add/get/update/free operations */
74 struct ice_aqc_vsi_props info;
75 struct ice_sched_vsi_info sched;
78 u16 num_lan_q_entries[ICE_MAX_TRAFFIC_CLASS];
79 struct ice_q_ctx *lan_q_ctx[ICE_MAX_TRAFFIC_CLASS];
82 /* This is to be used by add/update mirror rule Admin Queue command */
83 struct ice_mir_rule_buf {
84 u16 vsi_idx; /* VSI index */
86 /* For each VSI, user can specify whether corresponding VSI
87 * should be added/removed to/from mirror rule
89 * add mirror rule: this should always be TRUE.
90 * update mirror rule: add(true) or remove(false) VSI to/from
96 /* Switch recipe ID enum values are specific to hardware */
97 enum ice_sw_lkup_type {
98 ICE_SW_LKUP_ETHERTYPE = 0,
100 ICE_SW_LKUP_MAC_VLAN = 2,
101 ICE_SW_LKUP_PROMISC = 3,
102 ICE_SW_LKUP_VLAN = 4,
103 ICE_SW_LKUP_DFLT = 5,
104 ICE_SW_LKUP_ETHERTYPE_MAC = 8,
105 ICE_SW_LKUP_PROMISC_VLAN = 9,
109 /* type of filter src ID */
111 ICE_SRC_ID_UNKNOWN = 0,
117 struct ice_fltr_info {
118 /* Look up information: how to look up packet */
119 enum ice_sw_lkup_type lkup_type;
120 /* Forward action: filter action to do after lookup */
121 enum ice_sw_fwd_act_type fltr_act;
122 /* rule ID returned by firmware once filter rule is created */
126 /* Source VSI for LOOKUP_TX or source port for LOOKUP_RX */
128 enum ice_src_id src_id;
132 u8 mac_addr[ETH_ALEN];
135 u8 mac_addr[ETH_ALEN];
141 /* Set lkup_type as ICE_SW_LKUP_ETHERTYPE
142 * if just using ethertype as filter. Set lkup_type as
143 * ICE_SW_LKUP_ETHERTYPE_MAC if MAC also needs to be
144 * passed in as filter.
148 u8 mac_addr[ETH_ALEN]; /* optional */
150 } l_data; /* Make sure to zero out the memory of l_data before using
151 * it or only set the data associated with lookup match
152 * rest everything should be zero
155 /* Depending on filter action */
157 /* queue ID in case of ICE_FWD_TO_Q and starting
158 * queue ID in case of ICE_FWD_TO_QGRP.
169 /* Set to num_queues if action is ICE_FWD_TO_QGRP. This field
170 * determines the range of queues the packet needs to be forwarded to.
171 * Note that qgrp_size must be set to a power of 2.
175 /* Rule creations populate these indicators basing on the switch type */
176 u8 lb_en; /* Indicate if packet can be looped back */
177 u8 lan_en; /* Indicate if packet can be forwarded to the uplink */
180 struct ice_adv_lkup_elem {
181 enum ice_protocol_type type;
182 union ice_prot_hdr h_u; /* Header values */
183 union ice_prot_hdr m_u; /* Mask of header values to match */
186 struct ice_sw_act_ctrl {
187 /* Source VSI for LOOKUP_TX or source port for LOOKUP_RX */
190 enum ice_sw_fwd_act_type fltr_act;
191 /* Depending on filter action */
193 /* This is a queue ID in case of ICE_FWD_TO_Q and starting
194 * queue ID in case of ICE_FWD_TO_QGRP.
201 /* software VSI handle */
206 struct ice_rule_query_data {
207 /* Recipe ID for which the requested rule was added */
209 /* Rule ID that was added or is supposed to be removed */
211 /* vsi_handle for which Rule was added or is supposed to be removed */
215 struct ice_adv_rule_info {
216 enum ice_sw_tunnel_type tun_type;
217 struct ice_sw_act_ctrl sw_act;
219 u8 rx; /* true means LOOKUP_RX otherwise LOOKUP_TX */
223 /* A collection of one or more four word recipe */
224 struct ice_sw_recipe {
225 /* For a chained recipe the root recipe is what should be used for
232 /* Number of extraction words */
234 /* Protocol ID and Offset pair (extraction word) to describe the
237 struct ice_fv_word ext_words[ICE_MAX_CHAIN_WORDS];
238 u16 word_masks[ICE_MAX_CHAIN_WORDS];
240 /* if this recipe is a collection of other recipe */
243 /* if this recipe is part of another bigger recipe then chain index
244 * corresponding to this recipe
248 /* if this recipe is a collection of other recipe then count of other
249 * recipes and recipe IDs of those recipes
253 /* Bit map specifying the IDs associated with this group of recipe */
254 ice_declare_bitmap(r_bitmap, ICE_MAX_NUM_RECIPES);
256 enum ice_sw_tunnel_type tun_type;
258 /* List of type ice_fltr_mgmt_list_entry or adv_rule */
260 struct LIST_HEAD_TYPE filt_rules;
261 struct LIST_HEAD_TYPE filt_replay_rules;
263 struct ice_lock filt_rule_lock; /* protect filter rule structure */
265 /* Profiles this recipe should be associated with */
266 struct LIST_HEAD_TYPE fv_list;
268 /* Profiles this recipe is associated with */
269 u8 num_profs, *prof_ids;
271 /* Bit map for possible result indexes */
272 ice_declare_bitmap(res_idxs, ICE_MAX_FV_WORDS);
274 /* This allows user to specify the recipe priority.
275 * For now, this becomes 'fwd_priority' when recipe
276 * is created, usually recipes can have 'fwd' and 'join'
281 struct LIST_HEAD_TYPE rg_list;
283 /* AQ buffer associated with this recipe */
284 struct ice_aqc_recipe_data_elem *root_buf;
285 /* This struct saves the fv_words for a given lookup */
286 struct ice_prot_lkup_ext lkup_exts;
289 /* Bookkeeping structure to hold bitmap of VSIs corresponding to VSI list ID */
290 struct ice_vsi_list_map_info {
291 struct LIST_ENTRY_TYPE list_entry;
292 ice_declare_bitmap(vsi_map, ICE_MAX_VSI);
294 /* counter to track how many rules are reusing this VSI list */
298 struct ice_fltr_list_entry {
299 struct LIST_ENTRY_TYPE list_entry;
300 enum ice_status status;
301 struct ice_fltr_info fltr_info;
305 * enum ice_fltr_marker - Marker for syncing OS and driver filter lists
306 * @ICE_FLTR_NOT_FOUND: initial state, indicates filter has not been found
307 * @ICE_FLTR_FOUND: set when a filter has been found in both lists
309 * This enumeration is used to help sync an operating system provided filter
310 * list with the filters previously added.
312 * This is required for FreeBSD because the operating system does not provide
313 * individual indications of whether a filter has been added or deleted, but
314 * instead just notifies the driver with the entire new list.
316 * To use this marker state, the driver shall initially reset all filters to
317 * the ICE_FLTR_NOT_FOUND state. Then, for each filter in the OS list, it
318 * shall search the driver list for the filter. If found, the filter state
319 * will be set to ICE_FLTR_FOUND. If not found, that filter will be added.
320 * Finally, the driver shall search the internal filter list for all filters
321 * still marked as ICE_FLTR_NOT_FOUND and remove them.
323 enum ice_fltr_marker {
328 /* This defines an entry in the list that maintains MAC or VLAN membership
329 * to HW list mapping, since multiple VSIs can subscribe to the same MAC or
330 * VLAN. As an optimization the VSI list should be created only when a
331 * second VSI becomes a subscriber to the same MAC address. VSI lists are always
332 * used for VLAN membership.
334 struct ice_fltr_mgmt_list_entry {
335 /* back pointer to VSI list ID to VSI list mapping */
336 struct ice_vsi_list_map_info *vsi_list_info;
338 #define ICE_INVAL_LG_ACT_INDEX 0xffff
340 #define ICE_INVAL_SW_MARKER_ID 0xffff
342 struct LIST_ENTRY_TYPE list_entry;
343 struct ice_fltr_info fltr_info;
344 #define ICE_INVAL_COUNTER_ID 0xff
346 enum ice_fltr_marker marker;
349 struct ice_adv_fltr_mgmt_list_entry {
350 struct LIST_ENTRY_TYPE list_entry;
352 struct ice_adv_lkup_elem *lkups;
353 struct ice_adv_rule_info rule_info;
355 struct ice_vsi_list_map_info *vsi_list_info;
359 enum ice_promisc_flags {
360 ICE_PROMISC_UCAST_RX = 0x1,
361 ICE_PROMISC_UCAST_TX = 0x2,
362 ICE_PROMISC_MCAST_RX = 0x4,
363 ICE_PROMISC_MCAST_TX = 0x8,
364 ICE_PROMISC_BCAST_RX = 0x10,
365 ICE_PROMISC_BCAST_TX = 0x20,
366 ICE_PROMISC_VLAN_RX = 0x40,
367 ICE_PROMISC_VLAN_TX = 0x80,
370 /* VSI related commands */
372 ice_aq_add_vsi(struct ice_hw *hw, struct ice_vsi_ctx *vsi_ctx,
373 struct ice_sq_cd *cd);
375 ice_aq_free_vsi(struct ice_hw *hw, struct ice_vsi_ctx *vsi_ctx,
376 bool keep_vsi_alloc, struct ice_sq_cd *cd);
378 ice_aq_update_vsi(struct ice_hw *hw, struct ice_vsi_ctx *vsi_ctx,
379 struct ice_sq_cd *cd);
381 ice_add_vsi(struct ice_hw *hw, u16 vsi_handle, struct ice_vsi_ctx *vsi_ctx,
382 struct ice_sq_cd *cd);
384 ice_free_vsi(struct ice_hw *hw, u16 vsi_handle, struct ice_vsi_ctx *vsi_ctx,
385 bool keep_vsi_alloc, struct ice_sq_cd *cd);
387 ice_update_vsi(struct ice_hw *hw, u16 vsi_handle, struct ice_vsi_ctx *vsi_ctx,
388 struct ice_sq_cd *cd);
389 struct ice_vsi_ctx *ice_get_vsi_ctx(struct ice_hw *hw, u16 vsi_handle);
390 void ice_clear_all_vsi_ctx(struct ice_hw *hw);
392 ice_aq_get_vsi_params(struct ice_hw *hw, struct ice_vsi_ctx *vsi_ctx,
393 struct ice_sq_cd *cd);
395 ice_aq_add_update_mir_rule(struct ice_hw *hw, u16 rule_type, u16 dest_vsi,
396 u16 count, struct ice_mir_rule_buf *mr_buf,
397 struct ice_sq_cd *cd, u16 *rule_id);
399 ice_aq_delete_mir_rule(struct ice_hw *hw, u16 rule_id, bool keep_allocd,
400 struct ice_sq_cd *cd);
402 ice_aq_get_storm_ctrl(struct ice_hw *hw, u32 *bcast_thresh, u32 *mcast_thresh,
405 ice_aq_set_storm_ctrl(struct ice_hw *hw, u32 bcast_thresh, u32 mcast_thresh,
408 enum ice_status ice_get_initial_sw_cfg(struct ice_hw *hw);
411 ice_alloc_vlan_res_counter(struct ice_hw *hw, u16 *counter_id);
413 ice_free_vlan_res_counter(struct ice_hw *hw, u16 counter_id);
415 /* Switch/bridge related commands */
416 enum ice_status ice_update_sw_rule_bridge_mode(struct ice_hw *hw);
418 ice_alloc_sw(struct ice_hw *hw, bool ena_stats, bool shared_res, u16 *sw_id,
421 ice_free_sw(struct ice_hw *hw, u16 sw_id, u16 counter_id);
423 ice_aq_get_res_alloc(struct ice_hw *hw, u16 *num_entries,
424 struct ice_aqc_get_res_resp_elem *buf, u16 buf_size,
425 struct ice_sq_cd *cd);
427 ice_aq_get_res_descs(struct ice_hw *hw, u16 num_entries,
428 struct ice_aqc_res_elem *buf, u16 buf_size, u16 res_type,
429 bool res_shared, u16 *desc_id, struct ice_sq_cd *cd);
431 ice_add_vlan(struct ice_hw *hw, struct LIST_HEAD_TYPE *m_list);
433 ice_remove_vlan(struct ice_hw *hw, struct LIST_HEAD_TYPE *v_list);
434 void ice_rem_all_sw_rules_info(struct ice_hw *hw);
435 enum ice_status ice_add_mac(struct ice_hw *hw, struct LIST_HEAD_TYPE *m_lst);
436 enum ice_status ice_remove_mac(struct ice_hw *hw, struct LIST_HEAD_TYPE *m_lst);
438 ice_add_eth_mac(struct ice_hw *hw, struct LIST_HEAD_TYPE *em_list);
440 ice_remove_eth_mac(struct ice_hw *hw, struct LIST_HEAD_TYPE *em_list);
443 ice_add_mac_with_sw_marker(struct ice_hw *hw, struct ice_fltr_info *f_info,
446 ice_add_mac_with_counter(struct ice_hw *hw, struct ice_fltr_info *f_info);
447 void ice_remove_vsi_fltr(struct ice_hw *hw, u16 vsi_handle);
449 /* Promisc/defport setup for VSIs */
451 ice_cfg_dflt_vsi(struct ice_port_info *pi, u16 vsi_handle, bool set,
454 ice_set_vsi_promisc(struct ice_hw *hw, u16 vsi_handle, u8 promisc_mask,
457 ice_clear_vsi_promisc(struct ice_hw *hw, u16 vsi_handle, u8 promisc_mask,
460 ice_set_vlan_vsi_promisc(struct ice_hw *hw, u16 vsi_handle, u8 promisc_mask,
461 bool rm_vlan_promisc);
463 /* Get VSIs Promisc/defport settings */
465 ice_get_vsi_promisc(struct ice_hw *hw, u16 vsi_handle, u8 *promisc_mask,
468 ice_get_vsi_vlan_promisc(struct ice_hw *hw, u16 vsi_handle, u8 *promisc_mask,
471 enum ice_status ice_replay_all_fltr(struct ice_hw *hw);
474 ice_init_def_sw_recp(struct ice_hw *hw, struct ice_sw_recipe **recp_list);
475 u16 ice_get_hw_vsi_num(struct ice_hw *hw, u16 vsi_handle);
476 bool ice_is_vsi_valid(struct ice_hw *hw, u16 vsi_handle);
479 ice_replay_vsi_all_fltr(struct ice_hw *hw, struct ice_port_info *pi,
481 void ice_rm_sw_replay_rule_info(struct ice_hw *hw, struct ice_switch_info *sw);
482 void ice_rm_all_sw_replay_rule_info(struct ice_hw *hw);
483 #endif /* _ICE_SWITCH_H_ */