ba641f2076
The setup and configuration of the PMD is not performance sensitive, but is not thread safe either. It is possible that the multiple read/writes during PMD setup and configuration could be corrupted in a multi-thread environment. Since this is not performance sensitive, the developer can choose to add their own layer to provide thread-safe setup and configuration. It is expected that, in most applications, the initial configuration of the network ports would be done by a single thread at startup. In the case of exception on the event queue, the event queue and corresponding Rx/Tx queue should be restarted in the Rx/Tx queue polling context. These operations require access to the device control which should be serialized. The device level lock will do the job. Signed-off-by: Andrew Rybchenko <arybchenko@solarflare.com> Reviewed-by: Andy Moreton <amoreton@solarflare.com> Reviewed-by: Ferruh Yigit <ferruh.yigit@intel.com>
157 lines
4.0 KiB
C
157 lines
4.0 KiB
C
/*-
|
|
* Copyright (c) 2016 Solarflare Communications Inc.
|
|
* All rights reserved.
|
|
*
|
|
* This software was jointly developed between OKTET Labs (under contract
|
|
* for Solarflare) and Solarflare Communications, Inc.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright notice,
|
|
* this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright notice,
|
|
* this list of conditions and the following disclaimer in the documentation
|
|
* and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
|
|
* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
|
|
* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
|
|
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
|
|
* EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
|
|
* PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
|
|
* OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
|
|
* WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
|
|
* OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
|
|
* EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
*/
|
|
|
|
#ifndef _SFC_H
|
|
#define _SFC_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <rte_ethdev.h>
|
|
#include <rte_kvargs.h>
|
|
#include <rte_spinlock.h>
|
|
|
|
#include "efx.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define SFC_DEV_TO_PCI(eth_dev) \
|
|
RTE_DEV_TO_PCI((eth_dev)->device)
|
|
|
|
/*
|
|
* +---------------+
|
|
* | UNINITIALIZED |<-----------+
|
|
* +---------------+ |
|
|
* |.eth_dev_init |.eth_dev_uninit
|
|
* V |
|
|
* +---------------+------------+
|
|
* | INITIALIZED |
|
|
* +---------------+
|
|
*/
|
|
enum sfc_adapter_state {
|
|
SFC_ADAPTER_UNINITIALIZED = 0,
|
|
SFC_ADAPTER_INITIALIZED,
|
|
|
|
SFC_ADAPTER_NSTATES
|
|
};
|
|
|
|
enum sfc_mcdi_state {
|
|
SFC_MCDI_UNINITIALIZED = 0,
|
|
SFC_MCDI_INITIALIZED,
|
|
SFC_MCDI_BUSY,
|
|
SFC_MCDI_COMPLETED,
|
|
|
|
SFC_MCDI_NSTATES
|
|
};
|
|
|
|
struct sfc_mcdi {
|
|
rte_spinlock_t lock;
|
|
efsys_mem_t mem;
|
|
enum sfc_mcdi_state state;
|
|
efx_mcdi_transport_t transport;
|
|
};
|
|
|
|
/* Adapter private data */
|
|
struct sfc_adapter {
|
|
/*
|
|
* PMD setup and configuration is not thread safe.
|
|
* Since it is not performance sensitive, it is better to guarantee
|
|
* thread-safety and add device level lock.
|
|
* Adapter control operations which change its state should
|
|
* acquire the lock.
|
|
*/
|
|
rte_spinlock_t lock;
|
|
enum sfc_adapter_state state;
|
|
struct rte_eth_dev *eth_dev;
|
|
struct rte_kvargs *kvargs;
|
|
bool debug_init;
|
|
int socket_id;
|
|
efsys_bar_t mem_bar;
|
|
efx_family_t family;
|
|
efx_nic_t *nic;
|
|
rte_spinlock_t nic_lock;
|
|
|
|
struct sfc_mcdi mcdi;
|
|
|
|
unsigned int rxq_max;
|
|
unsigned int txq_max;
|
|
};
|
|
|
|
/*
|
|
* Add wrapper functions to acquire/release lock to be able to remove or
|
|
* change the lock in one place.
|
|
*/
|
|
|
|
static inline void
|
|
sfc_adapter_lock_init(struct sfc_adapter *sa)
|
|
{
|
|
rte_spinlock_init(&sa->lock);
|
|
}
|
|
|
|
static inline int
|
|
sfc_adapter_is_locked(struct sfc_adapter *sa)
|
|
{
|
|
return rte_spinlock_is_locked(&sa->lock);
|
|
}
|
|
|
|
static inline void
|
|
sfc_adapter_lock(struct sfc_adapter *sa)
|
|
{
|
|
rte_spinlock_lock(&sa->lock);
|
|
}
|
|
|
|
static inline void
|
|
sfc_adapter_unlock(struct sfc_adapter *sa)
|
|
{
|
|
rte_spinlock_unlock(&sa->lock);
|
|
}
|
|
|
|
static inline void
|
|
sfc_adapter_lock_fini(__rte_unused struct sfc_adapter *sa)
|
|
{
|
|
/* Just for symmetry of the API */
|
|
}
|
|
|
|
int sfc_dma_alloc(const struct sfc_adapter *sa, const char *name, uint16_t id,
|
|
size_t len, int socket_id, efsys_mem_t *esmp);
|
|
void sfc_dma_free(const struct sfc_adapter *sa, efsys_mem_t *esmp);
|
|
|
|
int sfc_attach(struct sfc_adapter *sa);
|
|
void sfc_detach(struct sfc_adapter *sa);
|
|
|
|
int sfc_mcdi_init(struct sfc_adapter *sa);
|
|
void sfc_mcdi_fini(struct sfc_adapter *sa);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif /* _SFC_H */
|