net/ngbe: support flow control
[dpdk.git] / drivers / net / ngbe / ngbe_ethdev.h
1 /* SPDX-License-Identifier: BSD-3-Clause
2  * Copyright(c) 2018-2021 Beijing WangXun Technology Co., Ltd.
3  * Copyright(c) 2010-2017 Intel Corporation
4  */
5
6 #ifndef _NGBE_ETHDEV_H_
7 #define _NGBE_ETHDEV_H_
8
9 #include "ngbe_ptypes.h"
10 #include <rte_ethdev.h>
11 #include <rte_ethdev_core.h>
12
13 /* need update link, bit flag */
14 #define NGBE_FLAG_NEED_LINK_UPDATE  ((uint32_t)(1 << 0))
15 #define NGBE_FLAG_MAILBOX           ((uint32_t)(1 << 1))
16 #define NGBE_FLAG_PHY_INTERRUPT     ((uint32_t)(1 << 2))
17 #define NGBE_FLAG_MACSEC            ((uint32_t)(1 << 3))
18 #define NGBE_FLAG_NEED_LINK_CONFIG  ((uint32_t)(1 << 4))
19
20 #define NGBE_VFTA_SIZE 128
21 #define NGBE_VLAN_TAG_SIZE 4
22 #define NGBE_HKEY_MAX_INDEX 10
23 /*Default value of Max Rx Queue*/
24 #define NGBE_MAX_RX_QUEUE_NUM   8
25
26 #ifndef NBBY
27 #define NBBY    8       /* number of bits in a byte */
28 #endif
29 #define NGBE_HWSTRIP_BITMAP_SIZE \
30         (NGBE_MAX_RX_QUEUE_NUM / (sizeof(uint32_t) * NBBY))
31
32 #define NGBE_QUEUE_ITR_INTERVAL_DEFAULT 500 /* 500us */
33
34 /* The overhead from MTU to max frame size. */
35 #define NGBE_ETH_OVERHEAD (RTE_ETHER_HDR_LEN + RTE_ETHER_CRC_LEN)
36
37 #define NGBE_RSS_OFFLOAD_ALL ( \
38         RTE_ETH_RSS_IPV4 | \
39         RTE_ETH_RSS_NONFRAG_IPV4_TCP | \
40         RTE_ETH_RSS_NONFRAG_IPV4_UDP | \
41         RTE_ETH_RSS_IPV6 | \
42         RTE_ETH_RSS_NONFRAG_IPV6_TCP | \
43         RTE_ETH_RSS_NONFRAG_IPV6_UDP | \
44         RTE_ETH_RSS_IPV6_EX | \
45         RTE_ETH_RSS_IPV6_TCP_EX | \
46         RTE_ETH_RSS_IPV6_UDP_EX)
47
48 #define NGBE_MISC_VEC_ID               RTE_INTR_VEC_ZERO_OFFSET
49 #define NGBE_RX_VEC_START              RTE_INTR_VEC_RXTX_OFFSET
50
51 /* structure for interrupt relative data */
52 struct ngbe_interrupt {
53         uint32_t flags;
54         uint32_t mask_misc;
55         uint32_t mask_misc_orig; /* save mask during delayed handler */
56         uint64_t mask;
57         uint64_t mask_orig; /* save mask during delayed handler */
58 };
59
60 #define NGBE_NB_STAT_MAPPING  32
61 #define NB_QMAP_FIELDS_PER_QSM_REG 4
62 #define QMAP_FIELD_RESERVED_BITS_MASK 0x0f
63 struct ngbe_stat_mappings {
64         uint32_t tqsm[NGBE_NB_STAT_MAPPING];
65         uint32_t rqsm[NGBE_NB_STAT_MAPPING];
66 };
67
68 struct ngbe_vfta {
69         uint32_t vfta[NGBE_VFTA_SIZE];
70 };
71
72 struct ngbe_hwstrip {
73         uint32_t bitmap[NGBE_HWSTRIP_BITMAP_SIZE];
74 };
75
76 /**
77  * Response sent back to ngbe driver from user app after callback
78  */
79 enum ngbe_mb_event_rsp {
80         NGBE_MB_EVENT_NOOP_ACK,  /**< skip mbox request and ACK */
81         NGBE_MB_EVENT_NOOP_NACK, /**< skip mbox request and NACK */
82         NGBE_MB_EVENT_PROCEED,  /**< proceed with mbox request  */
83         NGBE_MB_EVENT_MAX       /**< max value of this enum */
84 };
85
86 /**
87  * Data sent to the user application when the callback is executed.
88  */
89 struct ngbe_mb_event_param {
90         uint16_t vfid;     /**< Virtual Function number */
91         uint16_t msg_type; /**< VF to PF message type, defined in ngbe_mbx.h */
92         uint16_t retval;   /**< return value */
93         void *msg;         /**< pointer to message */
94 };
95
96 /*
97  * VF data which used by PF host only
98  */
99 #define NGBE_MAX_VF_MC_ENTRIES      30
100
101 struct ngbe_uta_info {
102         uint8_t  uc_filter_type;
103         uint16_t uta_in_use;
104         uint32_t uta_shadow[NGBE_MAX_UTA];
105 };
106
107 struct ngbe_vf_info {
108         uint8_t vf_mac_addresses[RTE_ETHER_ADDR_LEN];
109         uint16_t vf_mc_hashes[NGBE_MAX_VF_MC_ENTRIES];
110         uint16_t num_vf_mc_hashes;
111         bool clear_to_send;
112         uint16_t vlan_count;
113         uint8_t api_version;
114         uint16_t switch_domain_id;
115         uint16_t xcast_mode;
116         uint16_t mac_count;
117 };
118
119 /*
120  * Structure to store private data for each driver instance (for each port).
121  */
122 struct ngbe_adapter {
123         struct ngbe_hw             hw;
124         struct ngbe_hw_stats       stats;
125         struct ngbe_interrupt      intr;
126         struct ngbe_stat_mappings  stat_mappings;
127         struct ngbe_vfta           shadow_vfta;
128         struct ngbe_hwstrip        hwstrip;
129         struct ngbe_vf_info        *vfdata;
130         struct ngbe_uta_info       uta_info;
131         bool                       rx_bulk_alloc_allowed;
132
133         /* For RSS reta table update */
134         uint8_t rss_reta_updated;
135 };
136
137 static inline struct ngbe_adapter *
138 ngbe_dev_adapter(struct rte_eth_dev *dev)
139 {
140         struct ngbe_adapter *ad = dev->data->dev_private;
141
142         return ad;
143 }
144
145 static inline struct ngbe_hw *
146 ngbe_dev_hw(struct rte_eth_dev *dev)
147 {
148         struct ngbe_adapter *ad = ngbe_dev_adapter(dev);
149         struct ngbe_hw *hw = &ad->hw;
150
151         return hw;
152 }
153
154 #define NGBE_DEV_STATS(dev) \
155         (&((struct ngbe_adapter *)(dev)->data->dev_private)->stats)
156
157 static inline struct ngbe_interrupt *
158 ngbe_dev_intr(struct rte_eth_dev *dev)
159 {
160         struct ngbe_adapter *ad = ngbe_dev_adapter(dev);
161         struct ngbe_interrupt *intr = &ad->intr;
162
163         return intr;
164 }
165
166 #define NGBE_DEV_STAT_MAPPINGS(dev) \
167         (&((struct ngbe_adapter *)(dev)->data->dev_private)->stat_mappings)
168
169 #define NGBE_DEV_VFTA(dev) \
170         (&((struct ngbe_adapter *)(dev)->data->dev_private)->shadow_vfta)
171
172 #define NGBE_DEV_HWSTRIP(dev) \
173         (&((struct ngbe_adapter *)(dev)->data->dev_private)->hwstrip)
174
175 #define NGBE_DEV_VFDATA(dev) \
176         (&((struct ngbe_adapter *)(dev)->data->dev_private)->vfdata)
177
178 #define NGBE_DEV_UTA_INFO(dev) \
179         (&((struct ngbe_adapter *)(dev)->data->dev_private)->uta_info)
180
181 /*
182  * Rx/Tx function prototypes
183  */
184 void ngbe_dev_clear_queues(struct rte_eth_dev *dev);
185
186 void ngbe_dev_free_queues(struct rte_eth_dev *dev);
187
188 void ngbe_dev_rx_queue_release(struct rte_eth_dev *dev, uint16_t qid);
189
190 void ngbe_dev_tx_queue_release(struct rte_eth_dev *dev, uint16_t qid);
191
192 int  ngbe_dev_rx_queue_setup(struct rte_eth_dev *dev, uint16_t rx_queue_id,
193                 uint16_t nb_rx_desc, unsigned int socket_id,
194                 const struct rte_eth_rxconf *rx_conf,
195                 struct rte_mempool *mb_pool);
196
197 int  ngbe_dev_tx_queue_setup(struct rte_eth_dev *dev, uint16_t tx_queue_id,
198                 uint16_t nb_tx_desc, unsigned int socket_id,
199                 const struct rte_eth_txconf *tx_conf);
200
201 int ngbe_dev_rx_init(struct rte_eth_dev *dev);
202
203 void ngbe_dev_tx_init(struct rte_eth_dev *dev);
204
205 int ngbe_dev_rxtx_start(struct rte_eth_dev *dev);
206
207 void ngbe_dev_save_rx_queue(struct ngbe_hw *hw, uint16_t rx_queue_id);
208 void ngbe_dev_store_rx_queue(struct ngbe_hw *hw, uint16_t rx_queue_id);
209 void ngbe_dev_save_tx_queue(struct ngbe_hw *hw, uint16_t tx_queue_id);
210 void ngbe_dev_store_tx_queue(struct ngbe_hw *hw, uint16_t tx_queue_id);
211
212 int ngbe_dev_rx_queue_start(struct rte_eth_dev *dev, uint16_t rx_queue_id);
213
214 int ngbe_dev_rx_queue_stop(struct rte_eth_dev *dev, uint16_t rx_queue_id);
215
216 int ngbe_dev_tx_queue_start(struct rte_eth_dev *dev, uint16_t tx_queue_id);
217
218 int ngbe_dev_tx_queue_stop(struct rte_eth_dev *dev, uint16_t tx_queue_id);
219
220 int
221 ngbe_rx_burst_mode_get(struct rte_eth_dev *dev, __rte_unused uint16_t queue_id,
222                       struct rte_eth_burst_mode *mode);
223 int
224 ngbe_tx_burst_mode_get(struct rte_eth_dev *dev, __rte_unused uint16_t queue_id,
225                       struct rte_eth_burst_mode *mode);
226
227 uint16_t ngbe_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,
228                 uint16_t nb_pkts);
229
230 uint16_t ngbe_recv_pkts_bulk_alloc(void *rx_queue, struct rte_mbuf **rx_pkts,
231                                     uint16_t nb_pkts);
232
233 uint16_t ngbe_recv_pkts_sc_single_alloc(void *rx_queue,
234                 struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
235 uint16_t ngbe_recv_pkts_sc_bulk_alloc(void *rx_queue,
236                 struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
237
238 uint16_t ngbe_xmit_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,
239                 uint16_t nb_pkts);
240
241 uint16_t ngbe_xmit_pkts_simple(void *tx_queue, struct rte_mbuf **tx_pkts,
242                 uint16_t nb_pkts);
243
244 uint16_t ngbe_prep_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,
245                 uint16_t nb_pkts);
246
247 int ngbe_dev_rss_hash_update(struct rte_eth_dev *dev,
248                               struct rte_eth_rss_conf *rss_conf);
249
250 int ngbe_dev_rss_hash_conf_get(struct rte_eth_dev *dev,
251                                 struct rte_eth_rss_conf *rss_conf);
252
253 void ngbe_set_ivar_map(struct ngbe_hw *hw, int8_t direction,
254                                uint8_t queue, uint8_t msix_vector);
255
256 void ngbe_configure_port(struct rte_eth_dev *dev);
257
258 int
259 ngbe_dev_link_update_share(struct rte_eth_dev *dev,
260                 int wait_to_complete);
261
262 /*
263  * misc function prototypes
264  */
265 void ngbe_vlan_hw_filter_enable(struct rte_eth_dev *dev);
266
267 void ngbe_vlan_hw_filter_disable(struct rte_eth_dev *dev);
268
269 void ngbe_vlan_hw_strip_config(struct rte_eth_dev *dev);
270
271 int ngbe_pf_host_init(struct rte_eth_dev *eth_dev);
272
273 void ngbe_pf_host_uninit(struct rte_eth_dev *eth_dev);
274
275 void ngbe_pf_mbx_process(struct rte_eth_dev *eth_dev);
276
277 int ngbe_pf_host_configure(struct rte_eth_dev *eth_dev);
278
279 /* High threshold controlling when to start sending XOFF frames. */
280 #define NGBE_FC_XOFF_HITH              128 /*KB*/
281 /* Low threshold controlling when to start sending XON frames. */
282 #define NGBE_FC_XON_LOTH               64 /*KB*/
283
284 /* Timer value included in XOFF frames. */
285 #define NGBE_FC_PAUSE_TIME 0x680
286
287 #define NGBE_LINK_DOWN_CHECK_TIMEOUT 4000 /* ms */
288 #define NGBE_LINK_UP_CHECK_TIMEOUT   1000 /* ms */
289 #define NGBE_VMDQ_NUM_UC_MAC         4096 /* Maximum nb. of UC MAC addr. */
290
291 /*
292  *  Default values for Rx/Tx configuration
293  */
294 #define NGBE_DEFAULT_RX_FREE_THRESH  32
295 #define NGBE_DEFAULT_RX_PTHRESH      8
296 #define NGBE_DEFAULT_RX_HTHRESH      8
297 #define NGBE_DEFAULT_RX_WTHRESH      0
298
299 #define NGBE_DEFAULT_TX_FREE_THRESH  32
300 #define NGBE_DEFAULT_TX_PTHRESH      32
301 #define NGBE_DEFAULT_TX_HTHRESH      0
302 #define NGBE_DEFAULT_TX_WTHRESH      0
303
304 /* store statistics names and its offset in stats structure */
305 struct rte_ngbe_xstats_name_off {
306         char name[RTE_ETH_XSTATS_NAME_SIZE];
307         unsigned int offset;
308 };
309
310 const uint32_t *ngbe_dev_supported_ptypes_get(struct rte_eth_dev *dev);
311 int ngbe_dev_set_mc_addr_list(struct rte_eth_dev *dev,
312                                       struct rte_ether_addr *mc_addr_set,
313                                       uint32_t nb_mc_addr);
314 int ngbe_dev_rss_reta_update(struct rte_eth_dev *dev,
315                         struct rte_eth_rss_reta_entry64 *reta_conf,
316                         uint16_t reta_size);
317 int ngbe_dev_rss_reta_query(struct rte_eth_dev *dev,
318                         struct rte_eth_rss_reta_entry64 *reta_conf,
319                         uint16_t reta_size);
320 void ngbe_vlan_hw_strip_bitmap_set(struct rte_eth_dev *dev,
321                 uint16_t queue, bool on);
322 void ngbe_config_vlan_strip_on_all_queues(struct rte_eth_dev *dev,
323                                                   int mask);
324 void ngbe_read_stats_registers(struct ngbe_hw *hw,
325                            struct ngbe_hw_stats *hw_stats);
326
327 #endif /* _NGBE_ETHDEV_H_ */