drivers/net/sfc/sfc_tx.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  *
   3  * Copyright (c) 2016-2018 Solarflare Communications Inc.
   4  * All rights reserved.
   5  *
   6  * This software was jointly developed between OKTET Labs (under contract
   7  * for Solarflare) and Solarflare Communications, Inc.
   8  */
   9
  10 #ifndef _SFC_TX_H
  11 #define _SFC_TX_H
  12
  13 #include <rte_mbuf.h>
  14 #include <rte_ethdev.h>
  15
  16 #include "efx.h"
  17
  18 #include "sfc_dp_tx.h"
  19
  20 #ifdef __cplusplus
  21 extern "C" {
  22 #endif
  23
  24 struct sfc_adapter;
  25 struct sfc_evq;
  26
  27 /**
  28  * Software Tx descriptor information associated with hardware Tx
  29  * descriptor.
  30  */
  31 struct sfc_efx_tx_sw_desc {
  32         struct rte_mbuf         *mbuf;
  33         uint8_t                 *tsoh;  /* Buffer to store TSO header */
  34 };
  35
  36 enum sfc_txq_state_bit {
  37         SFC_TXQ_INITIALIZED_BIT = 0,
  38 #define SFC_TXQ_INITIALIZED     (1 << SFC_TXQ_INITIALIZED_BIT)
  39         SFC_TXQ_STARTED_BIT,
  40 #define SFC_TXQ_STARTED         (1 << SFC_TXQ_STARTED_BIT)
  41         SFC_TXQ_FLUSHING_BIT,
  42 #define SFC_TXQ_FLUSHING        (1 << SFC_TXQ_FLUSHING_BIT)
  43         SFC_TXQ_FLUSHED_BIT,
  44 #define SFC_TXQ_FLUSHED         (1 << SFC_TXQ_FLUSHED_BIT)
  45         SFC_TXQ_FLUSH_FAILED_BIT,
  46 #define SFC_TXQ_FLUSH_FAILED    (1 << SFC_TXQ_FLUSH_FAILED_BIT)
  47 };
  48
  49 /**
  50  * Transmit queue control information. Not used on datapath.
  51  * Allocated on the socket specified on the queue setup.
  52  */
  53 struct sfc_txq {
  54         unsigned int                    state;
  55         unsigned int                    hw_index;
  56         struct sfc_evq                  *evq;
  57         efsys_mem_t                     mem;
  58         struct sfc_dp_txq               *dp;
  59         efx_txq_t                       *common;
  60         unsigned int                    free_thresh;
  61         unsigned int                    flags;
  62 };
  63
  64 static inline unsigned int
  65 sfc_txq_sw_index_by_hw_index(unsigned int hw_index)
  66 {
  67         return hw_index;
  68 }
  69
  70 static inline unsigned int
  71 sfc_txq_sw_index(const struct sfc_txq *txq)
  72 {
  73         return sfc_txq_sw_index_by_hw_index(txq->hw_index);
  74 }
  75
  76 struct sfc_txq *sfc_txq_by_dp_txq(const struct sfc_dp_txq *dp_txq);
  77
  78 /**
  79  * Transmit queue information used on libefx-based data path.
  80  * Allocated on the socket specified on the queue setup.
  81  */
  82 struct sfc_efx_txq {
  83         struct sfc_evq                  *evq;
  84         struct sfc_efx_tx_sw_desc       *sw_ring;
  85         unsigned int                    ptr_mask;
  86         efx_desc_t                      *pend_desc;
  87         efx_txq_t                       *common;
  88         unsigned int                    added;
  89         unsigned int                    pending;
  90         unsigned int                    completed;
  91         unsigned int                    max_fill_level;
  92         unsigned int                    free_thresh;
  93         uint16_t                        hw_vlan_tci;
  94         uint16_t                        dma_desc_size_max;
  95
  96         unsigned int                    hw_index;
  97         unsigned int                    flags;
  98 #define SFC_EFX_TXQ_FLAG_STARTED        0x1
  99 #define SFC_EFX_TXQ_FLAG_RUNNING        0x2
 100
 101         /* Datapath transmit queue anchor */
 102         struct sfc_dp_txq               dp;
 103 };
 104
 105 static inline struct sfc_efx_txq *
 106 sfc_efx_txq_by_dp_txq(struct sfc_dp_txq *dp_txq)
 107 {
 108         return container_of(dp_txq, struct sfc_efx_txq, dp);
 109 }
 110
 111 struct sfc_txq_info {
 112         unsigned int            entries;
 113         struct sfc_txq          *txq;
 114         boolean_t               deferred_start;
 115         boolean_t               deferred_started;
 116 };
 117
 118 int sfc_tx_configure(struct sfc_adapter *sa);
 119 void sfc_tx_close(struct sfc_adapter *sa);
 120
 121 int sfc_tx_qinit(struct sfc_adapter *sa, unsigned int sw_index,
 122                  uint16_t nb_tx_desc, unsigned int socket_id,
 123                  const struct rte_eth_txconf *tx_conf);
 124 void sfc_tx_qfini(struct sfc_adapter *sa, unsigned int sw_index);
 125
 126 void sfc_tx_qflush_done(struct sfc_txq *txq);
 127 int sfc_tx_qstart(struct sfc_adapter *sa, unsigned int sw_index);
 128 void sfc_tx_qstop(struct sfc_adapter *sa, unsigned int sw_index);
 129 int sfc_tx_start(struct sfc_adapter *sa);
 130 void sfc_tx_stop(struct sfc_adapter *sa);
 131
 132 /* From 'sfc_tso.c' */
 133 int sfc_efx_tso_alloc_tsoh_objs(struct sfc_efx_tx_sw_desc *sw_ring,
 134                                 unsigned int txq_entries,
 135                                 unsigned int socket_id);
 136 void sfc_efx_tso_free_tsoh_objs(struct sfc_efx_tx_sw_desc *sw_ring,
 137                                 unsigned int txq_entries);
 138 int sfc_efx_tso_do(struct sfc_efx_txq *txq, unsigned int idx,
 139                    struct rte_mbuf **in_seg, size_t *in_off, efx_desc_t **pend,
 140                    unsigned int *pkt_descs, size_t *pkt_len);
 141
 142 #ifdef __cplusplus
 143 }
 144 #endif
 145 #endif  /* _SFC_TX_H */