drivers/net/sfc/sfc_tx.h

   1 /*-
   2  *   BSD LICENSE
   3  *
   4  * Copyright (c) 2016-2017 Solarflare Communications Inc.
   5  * All rights reserved.
   6  *
   7  * This software was jointly developed between OKTET Labs (under contract
   8  * for Solarflare) and Solarflare Communications, Inc.
   9  *
  10  * Redistribution and use in source and binary forms, with or without
  11  * modification, are permitted provided that the following conditions are met:
  12  *
  13  * 1. Redistributions of source code must retain the above copyright notice,
  14  *    this list of conditions and the following disclaimer.
  15  * 2. Redistributions in binary form must reproduce the above copyright notice,
  16  *    this list of conditions and the following disclaimer in the documentation
  17  *    and/or other materials provided with the distribution.
  18  *
  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,
  21  * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  22  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  23  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  24  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  25  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
  26  * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
  27  * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
  28  * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
  29  * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  30  */
  31
  32 #ifndef _SFC_TX_H
  33 #define _SFC_TX_H
  34
  35 #include <rte_mbuf.h>
  36 #include <rte_ethdev.h>
  37
  38 #include "efx.h"
  39
  40 #include "sfc_dp_tx.h"
  41
  42 #ifdef __cplusplus
  43 extern "C" {
  44 #endif
  45
  46 struct sfc_adapter;
  47 struct sfc_evq;
  48
  49 /**
  50  * Software Tx descriptor information associated with hardware Tx
  51  * descriptor.
  52  */
  53 struct sfc_efx_tx_sw_desc {
  54         struct rte_mbuf         *mbuf;
  55         uint8_t                 *tsoh;  /* Buffer to store TSO header */
  56 };
  57
  58 enum sfc_txq_state_bit {
  59         SFC_TXQ_INITIALIZED_BIT = 0,
  60 #define SFC_TXQ_INITIALIZED     (1 << SFC_TXQ_INITIALIZED_BIT)
  61         SFC_TXQ_STARTED_BIT,
  62 #define SFC_TXQ_STARTED         (1 << SFC_TXQ_STARTED_BIT)
  63         SFC_TXQ_FLUSHING_BIT,
  64 #define SFC_TXQ_FLUSHING        (1 << SFC_TXQ_FLUSHING_BIT)
  65         SFC_TXQ_FLUSHED_BIT,
  66 #define SFC_TXQ_FLUSHED         (1 << SFC_TXQ_FLUSHED_BIT)
  67         SFC_TXQ_FLUSH_FAILED_BIT,
  68 #define SFC_TXQ_FLUSH_FAILED    (1 << SFC_TXQ_FLUSH_FAILED_BIT)
  69 };
  70
  71 /**
  72  * Transmit queue control information. Not used on datapath.
  73  * Allocated on the socket specified on the queue setup.
  74  */
  75 struct sfc_txq {
  76         unsigned int                    state;
  77         unsigned int                    hw_index;
  78         struct sfc_evq                  *evq;
  79         efsys_mem_t                     mem;
  80         struct sfc_dp_txq               *dp;
  81         efx_txq_t                       *common;
  82         unsigned int                    free_thresh;
  83         unsigned int                    flags;
  84 };
  85
  86 static inline unsigned int
  87 sfc_txq_sw_index_by_hw_index(unsigned int hw_index)
  88 {
  89         return hw_index;
  90 }
  91
  92 static inline unsigned int
  93 sfc_txq_sw_index(const struct sfc_txq *txq)
  94 {
  95         return sfc_txq_sw_index_by_hw_index(txq->hw_index);
  96 }
  97
  98 struct sfc_txq *sfc_txq_by_dp_txq(const struct sfc_dp_txq *dp_txq);
  99
 100 /**
 101  * Transmit queue information used on libefx-based data path.
 102  * Allocated on the socket specified on the queue setup.
 103  */
 104 struct sfc_efx_txq {
 105         struct sfc_evq                  *evq;
 106         struct sfc_efx_tx_sw_desc       *sw_ring;
 107         unsigned int                    ptr_mask;
 108         efx_desc_t                      *pend_desc;
 109         efx_txq_t                       *common;
 110         unsigned int                    added;
 111         unsigned int                    pending;
 112         unsigned int                    completed;
 113         unsigned int                    free_thresh;
 114         uint16_t                        hw_vlan_tci;
 115         uint16_t                        dma_desc_size_max;
 116
 117         unsigned int                    hw_index;
 118         unsigned int                    flags;
 119 #define SFC_EFX_TXQ_FLAG_STARTED        0x1
 120 #define SFC_EFX_TXQ_FLAG_RUNNING        0x2
 121
 122         /* Datapath transmit queue anchor */
 123         struct sfc_dp_txq               dp;
 124 };
 125
 126 static inline struct sfc_efx_txq *
 127 sfc_efx_txq_by_dp_txq(struct sfc_dp_txq *dp_txq)
 128 {
 129         return container_of(dp_txq, struct sfc_efx_txq, dp);
 130 }
 131
 132 struct sfc_txq_info {
 133         unsigned int            entries;
 134         struct sfc_txq          *txq;
 135         boolean_t               deferred_start;
 136         boolean_t               deferred_started;
 137 };
 138
 139 int sfc_tx_configure(struct sfc_adapter *sa);
 140 void sfc_tx_close(struct sfc_adapter *sa);
 141
 142 int sfc_tx_qinit(struct sfc_adapter *sa, unsigned int sw_index,
 143                  uint16_t nb_tx_desc, unsigned int socket_id,
 144                  const struct rte_eth_txconf *tx_conf);
 145 void sfc_tx_qfini(struct sfc_adapter *sa, unsigned int sw_index);
 146
 147 void sfc_tx_qflush_done(struct sfc_txq *txq);
 148 int sfc_tx_qstart(struct sfc_adapter *sa, unsigned int sw_index);
 149 void sfc_tx_qstop(struct sfc_adapter *sa, unsigned int sw_index);
 150 int sfc_tx_start(struct sfc_adapter *sa);
 151 void sfc_tx_stop(struct sfc_adapter *sa);
 152
 153 /* From 'sfc_tso.c' */
 154 int sfc_efx_tso_alloc_tsoh_objs(struct sfc_efx_tx_sw_desc *sw_ring,
 155                                 unsigned int txq_entries,
 156                                 unsigned int socket_id);
 157 void sfc_efx_tso_free_tsoh_objs(struct sfc_efx_tx_sw_desc *sw_ring,
 158                                 unsigned int txq_entries);
 159 int sfc_efx_tso_do(struct sfc_efx_txq *txq, unsigned int idx,
 160                    struct rte_mbuf **in_seg, size_t *in_off, efx_desc_t **pend,
 161                    unsigned int *pkt_descs, size_t *pkt_len);
 162
 163 #ifdef __cplusplus
 164 }
 165 #endif
 166 #endif  /* _SFC_TX_H */