dpdk/drivers/net/ngbe/ngbe_ethdev.h
<<
>>
Prefs
   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_time.h>
  11#include <rte_ethdev.h>
  12#include <rte_ethdev_core.h>
  13
  14/* need update link, bit flag */
  15#define NGBE_FLAG_NEED_LINK_UPDATE  ((uint32_t)(1 << 0))
  16#define NGBE_FLAG_MAILBOX           ((uint32_t)(1 << 1))
  17#define NGBE_FLAG_PHY_INTERRUPT     ((uint32_t)(1 << 2))
  18#define NGBE_FLAG_MACSEC            ((uint32_t)(1 << 3))
  19#define NGBE_FLAG_NEED_LINK_CONFIG  ((uint32_t)(1 << 4))
  20
  21#define NGBE_VFTA_SIZE 128
  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 */
  52struct 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
  63struct ngbe_stat_mappings {
  64        uint32_t tqsm[NGBE_NB_STAT_MAPPING];
  65        uint32_t rqsm[NGBE_NB_STAT_MAPPING];
  66};
  67
  68struct ngbe_vfta {
  69        uint32_t vfta[NGBE_VFTA_SIZE];
  70};
  71
  72struct 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 */
  79enum 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 */
  89struct 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
 101struct 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
 107struct 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 */
 122struct 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        struct rte_timecounter     systime_tc;
 133        struct rte_timecounter     rx_tstamp_tc;
 134        struct rte_timecounter     tx_tstamp_tc;
 135
 136        /* For RSS reta table update */
 137        uint8_t rss_reta_updated;
 138};
 139
 140static inline struct ngbe_adapter *
 141ngbe_dev_adapter(struct rte_eth_dev *dev)
 142{
 143        struct ngbe_adapter *ad = dev->data->dev_private;
 144
 145        return ad;
 146}
 147
 148static inline struct ngbe_hw *
 149ngbe_dev_hw(struct rte_eth_dev *dev)
 150{
 151        struct ngbe_adapter *ad = ngbe_dev_adapter(dev);
 152        struct ngbe_hw *hw = &ad->hw;
 153
 154        return hw;
 155}
 156
 157#define NGBE_DEV_STATS(dev) \
 158        (&((struct ngbe_adapter *)(dev)->data->dev_private)->stats)
 159
 160static inline struct ngbe_interrupt *
 161ngbe_dev_intr(struct rte_eth_dev *dev)
 162{
 163        struct ngbe_adapter *ad = ngbe_dev_adapter(dev);
 164        struct ngbe_interrupt *intr = &ad->intr;
 165
 166        return intr;
 167}
 168
 169#define NGBE_DEV_STAT_MAPPINGS(dev) \
 170        (&((struct ngbe_adapter *)(dev)->data->dev_private)->stat_mappings)
 171
 172#define NGBE_DEV_VFTA(dev) \
 173        (&((struct ngbe_adapter *)(dev)->data->dev_private)->shadow_vfta)
 174
 175#define NGBE_DEV_HWSTRIP(dev) \
 176        (&((struct ngbe_adapter *)(dev)->data->dev_private)->hwstrip)
 177
 178#define NGBE_DEV_VFDATA(dev) \
 179        (&((struct ngbe_adapter *)(dev)->data->dev_private)->vfdata)
 180
 181#define NGBE_DEV_UTA_INFO(dev) \
 182        (&((struct ngbe_adapter *)(dev)->data->dev_private)->uta_info)
 183
 184/*
 185 * Rx/Tx function prototypes
 186 */
 187void ngbe_dev_clear_queues(struct rte_eth_dev *dev);
 188
 189void ngbe_dev_free_queues(struct rte_eth_dev *dev);
 190
 191void ngbe_dev_rx_queue_release(struct rte_eth_dev *dev, uint16_t qid);
 192
 193void ngbe_dev_tx_queue_release(struct rte_eth_dev *dev, uint16_t qid);
 194
 195int  ngbe_dev_rx_queue_setup(struct rte_eth_dev *dev, uint16_t rx_queue_id,
 196                uint16_t nb_rx_desc, unsigned int socket_id,
 197                const struct rte_eth_rxconf *rx_conf,
 198                struct rte_mempool *mb_pool);
 199
 200int  ngbe_dev_tx_queue_setup(struct rte_eth_dev *dev, uint16_t tx_queue_id,
 201                uint16_t nb_tx_desc, unsigned int socket_id,
 202                const struct rte_eth_txconf *tx_conf);
 203
 204uint32_t ngbe_dev_rx_queue_count(void *rx_queue);
 205
 206int ngbe_dev_rx_descriptor_status(void *rx_queue, uint16_t offset);
 207int ngbe_dev_tx_descriptor_status(void *tx_queue, uint16_t offset);
 208
 209int ngbe_dev_rx_init(struct rte_eth_dev *dev);
 210
 211void ngbe_dev_tx_init(struct rte_eth_dev *dev);
 212
 213int ngbe_dev_rxtx_start(struct rte_eth_dev *dev);
 214
 215void ngbe_dev_save_rx_queue(struct ngbe_hw *hw, uint16_t rx_queue_id);
 216void ngbe_dev_store_rx_queue(struct ngbe_hw *hw, uint16_t rx_queue_id);
 217void ngbe_dev_save_tx_queue(struct ngbe_hw *hw, uint16_t tx_queue_id);
 218void ngbe_dev_store_tx_queue(struct ngbe_hw *hw, uint16_t tx_queue_id);
 219
 220int ngbe_dev_rx_queue_start(struct rte_eth_dev *dev, uint16_t rx_queue_id);
 221
 222int ngbe_dev_rx_queue_stop(struct rte_eth_dev *dev, uint16_t rx_queue_id);
 223
 224int ngbe_dev_tx_queue_start(struct rte_eth_dev *dev, uint16_t tx_queue_id);
 225
 226int ngbe_dev_tx_queue_stop(struct rte_eth_dev *dev, uint16_t tx_queue_id);
 227
 228void ngbe_rxq_info_get(struct rte_eth_dev *dev, uint16_t queue_id,
 229        struct rte_eth_rxq_info *qinfo);
 230
 231void ngbe_txq_info_get(struct rte_eth_dev *dev, uint16_t queue_id,
 232        struct rte_eth_txq_info *qinfo);
 233
 234int
 235ngbe_rx_burst_mode_get(struct rte_eth_dev *dev, __rte_unused uint16_t queue_id,
 236                      struct rte_eth_burst_mode *mode);
 237int
 238ngbe_tx_burst_mode_get(struct rte_eth_dev *dev, __rte_unused uint16_t queue_id,
 239                      struct rte_eth_burst_mode *mode);
 240
 241uint16_t ngbe_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,
 242                uint16_t nb_pkts);
 243
 244uint16_t ngbe_recv_pkts_bulk_alloc(void *rx_queue, struct rte_mbuf **rx_pkts,
 245                                    uint16_t nb_pkts);
 246
 247uint16_t ngbe_recv_pkts_sc_single_alloc(void *rx_queue,
 248                struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
 249uint16_t ngbe_recv_pkts_sc_bulk_alloc(void *rx_queue,
 250                struct rte_mbuf **rx_pkts, uint16_t nb_pkts);
 251
 252uint16_t ngbe_xmit_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,
 253                uint16_t nb_pkts);
 254
 255uint16_t ngbe_xmit_pkts_simple(void *tx_queue, struct rte_mbuf **tx_pkts,
 256                uint16_t nb_pkts);
 257
 258uint16_t ngbe_prep_pkts(void *tx_queue, struct rte_mbuf **tx_pkts,
 259                uint16_t nb_pkts);
 260
 261int ngbe_dev_rss_hash_update(struct rte_eth_dev *dev,
 262                              struct rte_eth_rss_conf *rss_conf);
 263
 264int ngbe_dev_rss_hash_conf_get(struct rte_eth_dev *dev,
 265                                struct rte_eth_rss_conf *rss_conf);
 266
 267void ngbe_set_ivar_map(struct ngbe_hw *hw, int8_t direction,
 268                               uint8_t queue, uint8_t msix_vector);
 269
 270void ngbe_configure_port(struct rte_eth_dev *dev);
 271
 272int
 273ngbe_dev_link_update_share(struct rte_eth_dev *dev,
 274                int wait_to_complete);
 275
 276/*
 277 * misc function prototypes
 278 */
 279void ngbe_vlan_hw_filter_enable(struct rte_eth_dev *dev);
 280
 281void ngbe_vlan_hw_filter_disable(struct rte_eth_dev *dev);
 282
 283void ngbe_vlan_hw_strip_config(struct rte_eth_dev *dev);
 284
 285int ngbe_pf_host_init(struct rte_eth_dev *eth_dev);
 286
 287void ngbe_pf_host_uninit(struct rte_eth_dev *eth_dev);
 288
 289void ngbe_pf_mbx_process(struct rte_eth_dev *eth_dev);
 290
 291int ngbe_pf_host_configure(struct rte_eth_dev *eth_dev);
 292
 293/* High threshold controlling when to start sending XOFF frames. */
 294#define NGBE_FC_XOFF_HITH              128 /*KB*/
 295/* Low threshold controlling when to start sending XON frames. */
 296#define NGBE_FC_XON_LOTH               64 /*KB*/
 297
 298/* Timer value included in XOFF frames. */
 299#define NGBE_FC_PAUSE_TIME 0x680
 300
 301#define NGBE_LINK_DOWN_CHECK_TIMEOUT 4000 /* ms */
 302#define NGBE_LINK_UP_CHECK_TIMEOUT   1000 /* ms */
 303#define NGBE_VMDQ_NUM_UC_MAC         4096 /* Maximum nb. of UC MAC addr. */
 304
 305/*
 306 *  Default values for Rx/Tx configuration
 307 */
 308#define NGBE_DEFAULT_RX_FREE_THRESH  32
 309#define NGBE_DEFAULT_RX_PTHRESH      8
 310#define NGBE_DEFAULT_RX_HTHRESH      8
 311#define NGBE_DEFAULT_RX_WTHRESH      0
 312
 313#define NGBE_DEFAULT_TX_FREE_THRESH  32
 314#define NGBE_DEFAULT_TX_PTHRESH      32
 315#define NGBE_DEFAULT_TX_HTHRESH      0
 316#define NGBE_DEFAULT_TX_WTHRESH      0
 317
 318/* Additional timesync values. */
 319#define NGBE_INCVAL_1GB         0x2000000 /* all speed is same in Emerald */
 320#define NGBE_INCVAL_SHIFT_1GB   22 /* all speed is same in Emerald */
 321
 322#define NGBE_CYCLECOUNTER_MASK   0xffffffffffffffffULL
 323
 324/* store statistics names and its offset in stats structure */
 325struct rte_ngbe_xstats_name_off {
 326        char name[RTE_ETH_XSTATS_NAME_SIZE];
 327        unsigned int offset;
 328};
 329
 330const uint32_t *ngbe_dev_supported_ptypes_get(struct rte_eth_dev *dev);
 331int ngbe_dev_set_mc_addr_list(struct rte_eth_dev *dev,
 332                                      struct rte_ether_addr *mc_addr_set,
 333                                      uint32_t nb_mc_addr);
 334int ngbe_dev_rss_reta_update(struct rte_eth_dev *dev,
 335                        struct rte_eth_rss_reta_entry64 *reta_conf,
 336                        uint16_t reta_size);
 337int ngbe_dev_rss_reta_query(struct rte_eth_dev *dev,
 338                        struct rte_eth_rss_reta_entry64 *reta_conf,
 339                        uint16_t reta_size);
 340void ngbe_vlan_hw_strip_bitmap_set(struct rte_eth_dev *dev,
 341                uint16_t queue, bool on);
 342void ngbe_config_vlan_strip_on_all_queues(struct rte_eth_dev *dev,
 343                                                  int mask);
 344void ngbe_dev_setup_link_alarm_handler(void *param);
 345void ngbe_read_stats_registers(struct ngbe_hw *hw,
 346                           struct ngbe_hw_stats *hw_stats);
 347
 348#endif /* _NGBE_ETHDEV_H_ */
 349