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_EV_H_ 33 #define _SFC_EV_H_ 34 35 #include <rte_ethdev.h> 36 37 #include "efx.h" 38 39 #include "sfc.h" 40 41 #ifdef __cplusplus 42 extern "C" { 43 #endif 44 45 /* Number of entries in the management event queue */ 46 #define SFC_MGMT_EVQ_ENTRIES (EFX_EVQ_MINNEVS) 47 48 struct sfc_adapter; 49 struct sfc_dp_rxq; 50 struct sfc_dp_txq; 51 52 enum sfc_evq_state { 53 SFC_EVQ_UNINITIALIZED = 0, 54 SFC_EVQ_INITIALIZED, 55 SFC_EVQ_STARTING, 56 SFC_EVQ_STARTED, 57 58 SFC_EVQ_NSTATES 59 }; 60 61 struct sfc_evq { 62 /* Used on datapath */ 63 efx_evq_t *common; 64 const efx_ev_callbacks_t *callbacks; 65 unsigned int read_ptr; 66 boolean_t exception; 67 efsys_mem_t mem; 68 struct sfc_dp_rxq *dp_rxq; 69 struct sfc_dp_txq *dp_txq; 70 71 /* Not used on datapath */ 72 struct sfc_adapter *sa; 73 unsigned int evq_index; 74 enum sfc_evq_state init_state; 75 }; 76 77 struct sfc_evq_info { 78 /* Maximum number of EVQ entries taken into account when buffer 79 * table space is allocated. 80 */ 81 unsigned int max_entries; 82 /* Real number of EVQ entries, less or equal to max_entries */ 83 unsigned int entries; 84 /* Event queue creation flags */ 85 uint32_t flags; 86 /* NUMA-aware EVQ data structure used on datapath */ 87 struct sfc_evq *evq; 88 }; 89 90 /* 91 * Functions below define event queue to transmit/receive queue and vice 92 * versa mapping. 93 */ 94 95 static inline unsigned int 96 sfc_ev_qcount(struct sfc_adapter *sa) 97 { 98 const struct rte_eth_dev_data *dev_data = sa->eth_dev->data; 99 100 /* 101 * One management EVQ for global events. 102 * Own EVQ for each Tx and Rx queue. 103 */ 104 return 1 + dev_data->nb_rx_queues + dev_data->nb_tx_queues; 105 } 106 107 static inline unsigned int 108 sfc_evq_max_entries(struct sfc_adapter *sa, unsigned int sw_index) 109 { 110 unsigned int max_entries; 111 112 if (sw_index == sa->mgmt_evq_index) 113 max_entries = SFC_MGMT_EVQ_ENTRIES; 114 else if (sw_index <= sa->eth_dev->data->nb_rx_queues) 115 max_entries = EFX_RXQ_MAXNDESCS; 116 else 117 max_entries = efx_nic_cfg_get(sa->nic)->enc_txq_max_ndescs; 118 119 return max_entries; 120 } 121 122 static inline unsigned int 123 sfc_evq_index_by_rxq_sw_index(__rte_unused struct sfc_adapter *sa, 124 unsigned int rxq_sw_index) 125 { 126 return 1 + rxq_sw_index; 127 } 128 129 static inline unsigned int 130 sfc_evq_index_by_txq_sw_index(struct sfc_adapter *sa, unsigned int txq_sw_index) 131 { 132 return 1 + sa->eth_dev->data->nb_rx_queues + txq_sw_index; 133 } 134 135 int sfc_ev_init(struct sfc_adapter *sa); 136 void sfc_ev_fini(struct sfc_adapter *sa); 137 int sfc_ev_start(struct sfc_adapter *sa); 138 void sfc_ev_stop(struct sfc_adapter *sa); 139 140 int sfc_ev_qinit(struct sfc_adapter *sa, unsigned int sw_index, 141 unsigned int entries, int socket_id); 142 void sfc_ev_qfini(struct sfc_adapter *sa, unsigned int sw_index); 143 int sfc_ev_qstart(struct sfc_adapter *sa, unsigned int sw_index); 144 void sfc_ev_qstop(struct sfc_adapter *sa, unsigned int sw_index); 145 146 int sfc_ev_qprime(struct sfc_evq *evq); 147 void sfc_ev_qpoll(struct sfc_evq *evq); 148 149 void sfc_ev_mgmt_qpoll(struct sfc_adapter *sa); 150 151 #ifdef __cplusplus 152 } 153 #endif 154 #endif /* _SFC_EV_H_ */ 155