drivers/net/sfc/sfc_rx.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_RX_H
  33 #define _SFC_RX_H
  34
  35 #include <rte_mbuf.h>
  36 #include <rte_mempool.h>
  37 #include <rte_ethdev.h>
  38
  39 #include "efx.h"
  40
  41 #ifdef __cplusplus
  42 extern "C" {
  43 #endif
  44
  45 struct sfc_adapter;
  46 struct sfc_evq;
  47
  48 /**
  49  * Software Rx descriptor information associated with hardware Rx
  50  * descriptor.
  51  */
  52 struct sfc_rx_sw_desc {
  53         struct rte_mbuf         *mbuf;
  54         unsigned int            flags;
  55         unsigned int            size;
  56 };
  57
  58 /** Receive queue state bits */
  59 enum sfc_rxq_state_bit {
  60         SFC_RXQ_INITIALIZED_BIT = 0,
  61 #define SFC_RXQ_INITIALIZED     (1 << SFC_RXQ_INITIALIZED_BIT)
  62         SFC_RXQ_STARTED_BIT,
  63 #define SFC_RXQ_STARTED         (1 << SFC_RXQ_STARTED_BIT)
  64         SFC_RXQ_RUNNING_BIT,
  65 #define SFC_RXQ_RUNNING         (1 << SFC_RXQ_RUNNING_BIT)
  66         SFC_RXQ_FLUSHING_BIT,
  67 #define SFC_RXQ_FLUSHING        (1 << SFC_RXQ_FLUSHING_BIT)
  68         SFC_RXQ_FLUSHED_BIT,
  69 #define SFC_RXQ_FLUSHED         (1 << SFC_RXQ_FLUSHED_BIT)
  70         SFC_RXQ_FLUSH_FAILED_BIT,
  71 #define SFC_RXQ_FLUSH_FAILED    (1 << SFC_RXQ_FLUSH_FAILED_BIT)
  72 };
  73
  74 /**
  75  * Receive queue information used on data path.
  76  * Allocated on the socket specified on the queue setup.
  77  */
  78 struct sfc_rxq {
  79         /* Used on data path */
  80         struct sfc_evq          *evq;
  81         struct sfc_rx_sw_desc   *sw_desc;
  82         unsigned int            state;
  83         unsigned int            ptr_mask;
  84         unsigned int            pending;
  85         unsigned int            completed;
  86         uint16_t                batch_max;
  87         uint16_t                prefix_size;
  88 #if EFSYS_OPT_RX_SCALE
  89         unsigned int            flags;
  90 #define SFC_RXQ_FLAG_RSS_HASH   0x1
  91 #endif
  92
  93         /* Used on refill */
  94         unsigned int            added;
  95         unsigned int            pushed;
  96         unsigned int            refill_threshold;
  97         uint8_t                 port_id;
  98         uint16_t                buf_size;
  99         struct rte_mempool      *refill_mb_pool;
 100         efx_rxq_t               *common;
 101         efsys_mem_t             mem;
 102
 103         /* Not used on data path */
 104         unsigned int            hw_index;
 105 };
 106
 107 static inline unsigned int
 108 sfc_rxq_sw_index_by_hw_index(unsigned int hw_index)
 109 {
 110         return hw_index;
 111 }
 112
 113 static inline unsigned int
 114 sfc_rxq_sw_index(const struct sfc_rxq *rxq)
 115 {
 116         return sfc_rxq_sw_index_by_hw_index(rxq->hw_index);
 117 }
 118
 119 /**
 120  * Receive queue information used during setup/release only.
 121  * Allocated on the same socket as adapter data.
 122  */
 123 struct sfc_rxq_info {
 124         unsigned int            max_entries;
 125         unsigned int            entries;
 126         efx_rxq_type_t          type;
 127         struct sfc_rxq          *rxq;
 128         boolean_t               deferred_start;
 129         boolean_t               deferred_started;
 130 };
 131
 132 int sfc_rx_init(struct sfc_adapter *sa);
 133 void sfc_rx_fini(struct sfc_adapter *sa);
 134 int sfc_rx_start(struct sfc_adapter *sa);
 135 void sfc_rx_stop(struct sfc_adapter *sa);
 136
 137 int sfc_rx_qinit(struct sfc_adapter *sa, unsigned int rx_queue_id,
 138                  uint16_t nb_rx_desc, unsigned int socket_id,
 139                  const struct rte_eth_rxconf *rx_conf,
 140                  struct rte_mempool *mb_pool);
 141 void sfc_rx_qfini(struct sfc_adapter *sa, unsigned int sw_index);
 142 int sfc_rx_qstart(struct sfc_adapter *sa, unsigned int sw_index);
 143 void sfc_rx_qstop(struct sfc_adapter *sa, unsigned int sw_index);
 144
 145 void sfc_rx_qflush_done(struct sfc_rxq *rxq);
 146 void sfc_rx_qflush_failed(struct sfc_rxq *rxq);
 147
 148 uint16_t sfc_recv_pkts(void *rx_queue, struct rte_mbuf **rx_pkts,
 149                        uint16_t nb_pkts);
 150
 151 unsigned int sfc_rx_qdesc_npending(struct sfc_adapter *sa,
 152                                    unsigned int sw_index);
 153 int sfc_rx_qdesc_done(struct sfc_rxq *rxq, unsigned int offset);
 154
 155 #if EFSYS_OPT_RX_SCALE
 156 efx_rx_hash_type_t sfc_rte_to_efx_hash_type(uint64_t rss_hf);
 157 uint64_t sfc_efx_to_rte_hash_type(efx_rx_hash_type_t efx_hash_types);
 158 #endif
 159
 160 #ifdef __cplusplus
 161 }
 162 #endif
 163 #endif  /* _SFC_RX_H */