/* SPDX-License-Identifier: BSD-3-Clause
 *
 * Copyright(c) 2019-2021 Xilinx, Inc.
 * Copyright(c) 2017-2019 Solarflare Communications Inc.
 *
 * This software was jointly developed between OKTET Labs (under contract
 * for Solarflare) and Solarflare Communications, Inc.
 */

#ifndef _SFC_DP_H
#define _SFC_DP_H

#include <stdbool.h>
#include <sys/queue.h>

#include <rte_pci.h>

#include "sfc_log.h"
#include "sfc_stats.h"

#ifdef __cplusplus
extern "C" {
#endif

#define SFC_DIV_ROUND_UP(a, b) \
	__extension__ ({		\
		typeof(a) _a = (a);	\
		typeof(b) _b = (b);	\
					\
		(_a + (_b - 1)) / _b;	\
	})

/**
 * Datapath exception handler to be provided by the control path.
 */
typedef void (sfc_dp_exception_t)(void *ctrl);

enum sfc_dp_type {
	SFC_DP_RX = 0,	/**< Receive datapath */
	SFC_DP_TX,	/**< Transmit datapath */
};


/** Datapath queue run-time information */
struct sfc_dp_queue {
	/*
	 * Typically the structure is located at the end of Rx/Tx queue
	 * data structure and not used on datapath. So, it is not a
	 * problem to have extra fields even if not used. However,
	 * put stats at top of the structure to be closer to fields
	 * used on datapath or reap to have more chances to be cache-hot.
	 */
	union sfc_pkts_bytes		stats;
	uint32_t			dbells;

	uint16_t			port_id;
	uint16_t			queue_id;
	struct rte_pci_addr		pci_addr;
};

void sfc_dp_queue_init(struct sfc_dp_queue *dpq,
		       uint16_t port_id, uint16_t queue_id,
		       const struct rte_pci_addr *pci_addr);

/* Maximum datapath log level to be included in build. */
#ifndef SFC_DP_LOG_LEVEL
#define SFC_DP_LOG_LEVEL	RTE_LOG_NOTICE
#endif

/*
 * Helper macro to define datapath logging macros and have uniform
 * logging.
 */
#define SFC_DP_LOG(dp_name, level, dpq, ...) \
	do {								\
		const struct sfc_dp_queue *_dpq = (dpq);		\
		const struct rte_pci_addr *_addr = &(_dpq)->pci_addr;	\
									\
		if (RTE_LOG_ ## level > SFC_DP_LOG_LEVEL)		\
			break;						\
		SFC_GENERIC_LOG(level,					\
			RTE_FMT("%s " PCI_PRI_FMT			\
				" #%" PRIu16 ".%" PRIu16 ": "		\
				RTE_FMT_HEAD(__VA_ARGS__ ,),		\
				dp_name,				\
				_addr->domain, _addr->bus,		\
				_addr->devid, _addr->function,		\
				_dpq->port_id, _dpq->queue_id,		\
				RTE_FMT_TAIL(__VA_ARGS__,)));		\
	} while (0)


/** Datapath definition */
struct sfc_dp {
	TAILQ_ENTRY(sfc_dp)		links;
	const char			*name;
	enum sfc_dp_type		type;
	/* Mask of required hardware/firmware capabilities */
	unsigned int			hw_fw_caps;
#define SFC_DP_HW_FW_CAP_EF10				0x1
#define SFC_DP_HW_FW_CAP_RX_ES_SUPER_BUFFER		0x2
#define SFC_DP_HW_FW_CAP_RX_EFX				0x4
#define SFC_DP_HW_FW_CAP_TX_EFX				0x8
#define SFC_DP_HW_FW_CAP_EF100				0x10
};

/** List of datapath variants */
TAILQ_HEAD(sfc_dp_list, sfc_dp);

typedef unsigned int sfc_sw_index_t;
#define SFC_SW_INDEX_INVALID	((sfc_sw_index_t)(UINT_MAX))

typedef int32_t	sfc_ethdev_qid_t;
#define SFC_ETHDEV_QID_INVALID	((sfc_ethdev_qid_t)(-1))

/* Check if available HW/FW capabilities are sufficient for the datapath */
static inline bool
sfc_dp_match_hw_fw_caps(const struct sfc_dp *dp, unsigned int avail_caps)
{
	return (dp->hw_fw_caps & avail_caps) == dp->hw_fw_caps;
}

struct sfc_dp *sfc_dp_find_by_name(struct sfc_dp_list *head,
				   enum sfc_dp_type type, const char *name);
struct sfc_dp *sfc_dp_find_by_caps(struct sfc_dp_list *head,
				   enum sfc_dp_type type,
				   unsigned int avail_caps);
int sfc_dp_register(struct sfc_dp_list *head, struct sfc_dp *entry);

/**
 * Dynamically registered mbuf flag "mport_override" (as a bitmask).
 *
 * If this flag is set in an mbuf then the dynamically registered
 * mbuf field "mport" holds a valid value. This is used to direct
 * port representor transmit traffic to the correct target port.
 */
extern uint64_t sfc_dp_mport_override;

/**
 * Dynamically registered mbuf field "mport" (mbuf byte offset).
 *
 * If the dynamically registered "mport_override" flag is set in
 * an mbuf then the mbuf "mport" field holds a valid value. This
 * is used to direct port representor transmit traffic to the
 * correct target port.
 */
extern int sfc_dp_mport_offset;

/**
 * Register dynamic mbuf flag and field which can be used to require Tx override
 * prefix descriptor with egress mport set.
 */
int sfc_dp_mport_register(void);

/** Dynamically registered mbuf "ft_ctx_id" validity flag (as a bitmask). */
extern uint64_t sfc_dp_ft_ctx_id_valid;

/** Dynamically registered mbuf field "ft_ctx_id" (mbuf byte offset). */
extern int sfc_dp_ft_ctx_id_offset;

/** Register dynamic mbuf field "ft_ctx_id" and its validity flag. */
int sfc_dp_ft_ctx_id_register(void);

#ifdef __cplusplus
}
#endif
#endif /* _SFC_DP_H */