New upstream version 18.02upstream/18.02

Change-Id: I89ed24cb2a49b78fe5be6970b99dd46c1499fcc3
Signed-off-by: Luca Boccassi <luca.boccassi@gmail.com>

3 files changed, 1234 insertions, 0 deletions

diff --git a/examples/bbdev_app/Makefile b/examples/bbdev_app/Makefile
new file mode 100644
index 00000000..18dd99db
--- /dev/null
+++ b/examples/bbdev_app/Makefile
@@ -0,0 +1,59 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2017 Intel Corporation
+
+# binary name
+APP = bbdev
+
+# all source are stored in SRCS-y
+SRCS-y := main.c
+
+# Build using pkg-config variables if possible
+$(shell pkg-config --exists libdpdk)
+ifeq ($(.SHELLSTATUS),0)
+
+all: shared
+.PHONY: shared static
+shared: build/$(APP)-shared
+	ln -sf $(APP)-shared build/$(APP)
+static: build/$(APP)-static
+	ln -sf $(APP)-static build/$(APP)
+
+PC_FILE := $(shell pkg-config --path libdpdk)
+CFLAGS += -O3 $(shell pkg-config --cflags libdpdk)
+LDFLAGS_SHARED = $(shell pkg-config --libs libdpdk)
+LDFLAGS_STATIC = -Wl,-Bstatic $(shell pkg-config --static --libs libdpdk)
+
+CFLAGS += -DALLOW_EXPERIMENTAL_API
+
+build/$(APP)-shared: $(SRCS-y) Makefile $(PC_FILE) | build
+	$(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS) $(LDFLAGS_SHARED)
+
+build/$(APP)-static: $(SRCS-y) Makefile $(PC_FILE) | build
+	$(CC) $(CFLAGS) $(SRCS-y) -o $@ $(LDFLAGS) $(LDFLAGS_STATIC)
+
+build:
+	@mkdir -p $@
+
+.PHONY: clean
+clean:
+	rm -f build/$(APP) build/$(APP)-static build/$(APP)-shared
+	rmdir --ignore-fail-on-non-empty build
+
+else
+
+ifeq ($(RTE_SDK),)
+$(error "Please define RTE_SDK environment variable")
+endif
+
+# Default target, can be overridden by command line or environment
+RTE_TARGET ?= x86_64-native-linuxapp-gcc
+
+include $(RTE_SDK)/mk/rte.vars.mk
+
+CFLAGS += -DALLOW_EXPERIMENTAL_API
+CFLAGS += -O3
+CFLAGS += $(WERROR_FLAGS)
+
+include $(RTE_SDK)/mk/rte.extapp.mk
+
+endif
diff --git a/examples/bbdev_app/main.c b/examples/bbdev_app/main.c
new file mode 100644
index 00000000..3c452569
--- /dev/null
+++ b/examples/bbdev_app/main.c
@@ -0,0 +1,1162 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ * Copyright(c) 2017 Intel Corporation
+ */
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdint.h>
+#include <inttypes.h>
+#include <sys/types.h>
+#include <sys/unistd.h>
+#include <sys/queue.h>
+#include <stdarg.h>
+#include <ctype.h>
+#include <errno.h>
+#include <math.h>
+#include <assert.h>
+#include <getopt.h>
+#include <signal.h>
+
+#include "rte_atomic.h"
+#include "rte_common.h"
+#include "rte_eal.h"
+#include "rte_cycles.h"
+#include "rte_ether.h"
+#include "rte_ethdev.h"
+#include "rte_ip.h"
+#include "rte_lcore.h"
+#include "rte_malloc.h"
+#include "rte_mbuf.h"
+#include "rte_memory.h"
+#include "rte_mempool.h"
+#include "rte_log.h"
+#include "rte_bbdev.h"
+#include "rte_bbdev_op.h"
+
+/* LLR values - negative value for '1' bit */
+#define LLR_1_BIT 0x81
+#define LLR_0_BIT 0x7F
+
+#define MAX_PKT_BURST 32
+#define NB_MBUF 8191
+#define MEMPOOL_CACHE_SIZE 256
+
+/* Hardcoded K value */
+#define K 40
+#define NCB (3 * RTE_ALIGN_CEIL(K + 4, 32))
+
+#define CRC_24B_LEN 3
+
+/* Configurable number of RX/TX ring descriptors */
+#define RTE_TEST_RX_DESC_DEFAULT 128
+#define RTE_TEST_TX_DESC_DEFAULT 512
+
+#define BBDEV_ASSERT(a) do { \
+	if (!(a)) { \
+		usage(prgname); \
+		return -1; \
+	} \
+} while (0)
+
+static const struct rte_eth_conf port_conf = {
+	.rxmode = {
+		.mq_mode = ETH_MQ_RX_NONE,
+		.max_rx_pkt_len = ETHER_MAX_LEN,
+		.split_hdr_size = 0,
+		.header_split = 0, /**< Header Split disabled */
+		.hw_ip_checksum = 0, /**< IP checksum offload disabled */
+		.hw_vlan_filter = 0, /**< VLAN filtering disabled */
+		.jumbo_frame = 0, /**< Jumbo Frame Support disabled */
+		.hw_strip_crc = 0, /**< CRC stripped by hardware */
+	},
+	.txmode = {
+		.mq_mode = ETH_MQ_TX_NONE,
+	},
+};
+
+struct rte_bbdev_op_turbo_enc def_op_enc = {
+	/* These values are arbitrarily put, and does not map to the real
+	 * values for the data received from ethdev ports
+	 */
+	.rv_index = 0,
+	.code_block_mode = 1,
+	.cb_params = {
+		.k = K,
+	},
+	.op_flags = RTE_BBDEV_TURBO_CRC_24A_ATTACH
+};
+
+struct rte_bbdev_op_turbo_dec def_op_dec = {
+	/* These values are arbitrarily put, and does not map to the real
+	 * values for the data received from ethdev ports
+	 */
+	.code_block_mode = 1,
+	.cb_params = {
+		.k = K,
+	},
+	.rv_index = 0,
+	.iter_max = 8,
+	.iter_min = 4,
+	.ext_scale = 15,
+	.num_maps = 0,
+	.op_flags = RTE_BBDEV_TURBO_NEG_LLR_1_BIT_IN
+};
+
+struct app_config_params {
+	/* Placeholders for app params */
+	uint16_t port_id;
+	uint16_t bbdev_id;
+	uint64_t enc_core_mask;
+	uint64_t dec_core_mask;
+
+	/* Values filled during init time */
+	uint16_t enc_queue_ids[RTE_MAX_LCORE];
+	uint16_t dec_queue_ids[RTE_MAX_LCORE];
+	uint16_t num_enc_cores;
+	uint16_t num_dec_cores;
+};
+
+struct lcore_statistics {
+	unsigned int enqueued;
+	unsigned int dequeued;
+	unsigned int rx_lost_packets;
+	unsigned int enc_to_dec_lost_packets;
+	unsigned int tx_lost_packets;
+} __rte_cache_aligned;
+
+/** each lcore configuration */
+struct lcore_conf {
+	uint64_t core_type;
+
+	unsigned int port_id;
+	unsigned int rx_queue_id;
+	unsigned int tx_queue_id;
+
+	unsigned int bbdev_id;
+	unsigned int enc_queue_id;
+	unsigned int dec_queue_id;
+
+	uint8_t llr_temp_buf[NCB];
+
+	struct rte_mempool *bbdev_dec_op_pool;
+	struct rte_mempool *bbdev_enc_op_pool;
+	struct rte_mempool *enc_out_pool;
+	struct rte_ring *enc_to_dec_ring;
+
+	struct lcore_statistics *lcore_stats;
+} __rte_cache_aligned;
+
+struct stats_lcore_params {
+	struct lcore_conf *lconf;
+	struct app_config_params *app_params;
+};
+
+
+static const struct app_config_params def_app_config = {
+	.port_id = 0,
+	.bbdev_id = 0,
+	.enc_core_mask = 0x2,
+	.dec_core_mask = 0x4,
+	.num_enc_cores = 1,
+	.num_dec_cores = 1,
+};
+
+static rte_atomic16_t global_exit_flag;
+
+/* display usage */
+static inline void
+usage(const char *prgname)
+{
+	printf("%s [EAL options] "
+			"  --\n"
+			"  --enc_cores - number of encoding cores (default = 0x2)\n"
+			"  --dec_cores - number of decoding cores (default = 0x4)\n"
+			"  --port_id - Ethernet port ID (default = 0)\n"
+			"  --bbdev_id - BBDev ID (default = 0)\n"
+			"\n", prgname);
+}
+
+/* parse core mask */
+static inline
+uint16_t bbdev_parse_mask(const char *mask)
+{
+	char *end = NULL;
+	unsigned long pm;
+
+	/* parse hexadecimal string */
+	pm = strtoul(mask, &end, 16);
+	if ((mask[0] == '\0') || (end == NULL) || (*end != '\0'))
+		return 0;
+
+	return pm;
+}
+
+/* parse core mask */
+static inline
+uint16_t bbdev_parse_number(const char *mask)
+{
+	char *end = NULL;
+	unsigned long pm;
+
+	/* parse hexadecimal string */
+	pm = strtoul(mask, &end, 10);
+	if ((mask[0] == '\0') || (end == NULL) || (*end != '\0'))
+		return 0;
+
+	return pm;
+}
+
+static int
+bbdev_parse_args(int argc, char **argv,
+		struct app_config_params *app_params)
+{
+	int optind = 0;
+	int opt;
+	int opt_indx = 0;
+	char *prgname = argv[0];
+
+	static struct option lgopts[] = {
+		{ "enc_core_mask", required_argument, 0, 'e' },
+		{ "dec_core_mask", required_argument, 0, 'd' },
+		{ "port_id", required_argument, 0, 'p' },
+		{ "bbdev_id", required_argument, 0, 'b' },
+		{ NULL, 0, 0, 0 }
+	};
+
+	BBDEV_ASSERT(argc != 0);
+	BBDEV_ASSERT(argv != NULL);
+	BBDEV_ASSERT(app_params != NULL);
+
+	while ((opt = getopt_long(argc, argv, "e:d:p:b:", lgopts, &opt_indx)) !=
+		EOF) {
+		switch (opt) {
+		case 'e':
+			app_params->enc_core_mask =
+				bbdev_parse_mask(optarg);
+			if (app_params->enc_core_mask == 0) {
+				usage(prgname);
+				return -1;
+			}
+			app_params->num_enc_cores =
+				__builtin_popcount(app_params->enc_core_mask);
+			break;
+
+		case 'd':
+			app_params->dec_core_mask =
+				bbdev_parse_mask(optarg);
+			if (app_params->dec_core_mask == 0) {
+				usage(prgname);
+				return -1;
+			}
+			app_params->num_dec_cores =
+				__builtin_popcount(app_params->dec_core_mask);
+			break;
+
+		case 'p':
+			app_params->port_id = bbdev_parse_number(optarg);
+			break;
+
+		case 'b':
+			app_params->bbdev_id = bbdev_parse_number(optarg);
+			break;
+
+		default:
+			usage(prgname);
+			return -1;
+		}
+	}
+	optind = 0;
+	return optind;
+}
+
+static void
+signal_handler(int signum)
+{
+	printf("\nSignal %d received\n", signum);
+	rte_atomic16_set(&global_exit_flag, 1);
+}
+
+static void
+print_mac(unsigned int portid, struct ether_addr *bbdev_ports_eth_address)
+{
+	printf("Port %u, MAC address: %02X:%02X:%02X:%02X:%02X:%02X\n\n",
+			(unsigned int) portid,
+			bbdev_ports_eth_address->addr_bytes[0],
+			bbdev_ports_eth_address->addr_bytes[1],
+			bbdev_ports_eth_address->addr_bytes[2],
+			bbdev_ports_eth_address->addr_bytes[3],
+			bbdev_ports_eth_address->addr_bytes[4],
+			bbdev_ports_eth_address->addr_bytes[5]);
+}
+
+static inline void
+pktmbuf_free_bulk(struct rte_mbuf **mbufs, unsigned int nb_to_free)
+{
+	unsigned int i;
+	for (i = 0; i < nb_to_free; ++i)
+		rte_pktmbuf_free(mbufs[i]);
+}
+
+static inline void
+pktmbuf_userdata_free_bulk(struct rte_mbuf **mbufs, unsigned int nb_to_free)
+{
+	unsigned int i;
+	for (i = 0; i < nb_to_free; ++i) {
+		struct rte_mbuf *rx_pkt = mbufs[i]->userdata;
+		rte_pktmbuf_free(rx_pkt);
+		rte_pktmbuf_free(mbufs[i]);
+	}
+}
+
+/* Check the link status of all ports in up to 9s, and print them finally */
+static int
+check_port_link_status(uint16_t port_id)
+{
+#define CHECK_INTERVAL 100 /* 100ms */
+#define MAX_CHECK_TIME 90 /* 9s (90 * 100ms) in total */
+	uint8_t count;
+	struct rte_eth_link link;
+
+	printf("\nChecking link status.");
+	fflush(stdout);
+
+	for (count = 0; count <= MAX_CHECK_TIME &&
+			!rte_atomic16_read(&global_exit_flag); count++) {
+		memset(&link, 0, sizeof(link));
+		rte_eth_link_get_nowait(port_id, &link);
+
+		if (link.link_status) {
+			const char *dp = (link.link_duplex ==
+				ETH_LINK_FULL_DUPLEX) ?
+				"full-duplex" : "half-duplex";
+			printf("\nPort %u Link Up - speed %u Mbps - %s\n",
+				port_id, link.link_speed, dp);
+			return 0;
+		}
+		printf(".");
+		fflush(stdout);
+		rte_delay_ms(CHECK_INTERVAL);
+	}
+
+	printf("\nPort %d Link Down\n", port_id);
+	return 0;
+}
+
+static inline void
+add_ether_hdr(struct rte_mbuf *pkt_src, struct rte_mbuf *pkt_dst)
+{
+	struct ether_hdr *eth_from;
+	struct ether_hdr *eth_to;
+
+	eth_from = rte_pktmbuf_mtod(pkt_src, struct ether_hdr *);
+	eth_to = rte_pktmbuf_mtod(pkt_dst, struct ether_hdr *);
+
+	/* copy header */
+	rte_memcpy(eth_to, eth_from, sizeof(struct ether_hdr));
+}
+
+static inline void
+add_awgn(struct rte_mbuf **mbufs, uint16_t num_pkts)
+{
+	RTE_SET_USED(mbufs);
+	RTE_SET_USED(num_pkts);
+}
+
+/* Encoder output to Decoder input adapter. The Decoder accepts only soft input
+ * so each bit of the encoder output must be translated into one byte of LLR. If
+ * Sub-block Deinterleaver is bypassed, which is the case, the padding bytes
+ * must additionally be insterted at the end of each sub-block.
+ */
+static inline void
+transform_enc_out_dec_in(struct rte_mbuf **mbufs, uint8_t *temp_buf,
+		uint16_t num_pkts, uint16_t k)
+{
+	uint16_t i, l, j;
+	uint16_t start_bit_idx;
+	uint16_t out_idx;
+	uint16_t d = k + 4;
+	uint16_t kpi = RTE_ALIGN_CEIL(d, 32);
+	uint16_t nd = kpi - d;
+	uint16_t ncb = 3 * kpi;
+
+	for (i = 0; i < num_pkts; ++i) {
+		uint16_t pkt_data_len = rte_pktmbuf_data_len(mbufs[i]) -
+				sizeof(struct ether_hdr);
+
+		/* Resize the packet if needed */
+		if (pkt_data_len < ncb) {
+			char *data = rte_pktmbuf_append(mbufs[i],
+					ncb - pkt_data_len);
+			if (data == NULL)
+				printf(
+					"Not enough space in decoder input packet");
+		}
+
+		/* Translate each bit into 1 LLR byte. */
+		start_bit_idx = 0;
+		out_idx = 0;
+		for (j = 0; j < 3; ++j) {
+			for (l = start_bit_idx; l < start_bit_idx + d; ++l) {
+				uint8_t *data = rte_pktmbuf_mtod_offset(
+					mbufs[i], uint8_t *,
+					sizeof(struct ether_hdr) + (l >> 3));
+				if (*data & (0x80 >> (l & 7)))
+					temp_buf[out_idx] = LLR_1_BIT;
+				else
+					temp_buf[out_idx] = LLR_0_BIT;
+				++out_idx;
+			}
+			/* Padding bytes should be at the end of the sub-block.
+			 */
+			memset(&temp_buf[out_idx], 0, nd);
+			out_idx += nd;
+			start_bit_idx += d;
+		}
+
+		rte_memcpy(rte_pktmbuf_mtod_offset(mbufs[i], uint8_t *,
+				sizeof(struct ether_hdr)), temp_buf, ncb);
+	}
+}
+
+static inline void
+verify_data(struct rte_mbuf **mbufs, uint16_t num_pkts)
+{
+	uint16_t i;
+	for (i = 0; i < num_pkts; ++i) {
+		struct rte_mbuf *out = mbufs[i];
+		struct rte_mbuf *in = out->userdata;
+
+		if (memcmp(rte_pktmbuf_mtod_offset(in, uint8_t *,
+				sizeof(struct ether_hdr)),
+				rte_pktmbuf_mtod_offset(out, uint8_t *,
+				sizeof(struct ether_hdr)),
+				K / 8 - CRC_24B_LEN))
+			printf("Input and output buffers are not equal!\n");
+	}
+}
+
+static int
+initialize_ports(struct app_config_params *app_params,
+		struct rte_mempool *ethdev_mbuf_mempool)
+{
+	int ret;
+	uint16_t port_id = app_params->port_id;
+	uint16_t q;
+	/* ethernet addresses of ports */
+	struct ether_addr bbdev_port_eth_addr;
+
+	/* initialize ports */
+	printf("\nInitializing port %u...\n", app_params->port_id);
+	ret = rte_eth_dev_configure(port_id, app_params->num_enc_cores,
+		app_params->num_dec_cores, &port_conf);
+
+	if (ret < 0) {
+		printf("Cannot configure device: err=%d, port=%u\n",
+			ret, port_id);
+		return -1;
+	}
+
+	/* initialize RX queues for encoder */
+	for (q = 0; q < app_params->num_enc_cores; q++) {
+		ret = rte_eth_rx_queue_setup(port_id, q,
+			RTE_TEST_RX_DESC_DEFAULT,
+			rte_eth_dev_socket_id(port_id),
+			NULL, ethdev_mbuf_mempool);
+		if (ret < 0) {
+			printf("rte_eth_rx_queue_setup: err=%d, queue=%u\n",
+				ret, q);
+			return -1;
+		}
+	}
+	/* initialize TX queues for decoder */
+	for (q = 0; q < app_params->num_dec_cores; q++) {
+		ret = rte_eth_tx_queue_setup(port_id, q,
+			RTE_TEST_TX_DESC_DEFAULT,
+			rte_eth_dev_socket_id(port_id), NULL);
+		if (ret < 0) {
+			printf("rte_eth_tx_queue_setup: err=%d, queue=%u\n",
+				ret, q);
+			return -1;
+		}
+	}
+
+	rte_eth_promiscuous_enable(port_id);
+
+	rte_eth_macaddr_get(port_id, &bbdev_port_eth_addr);
+	print_mac(port_id, &bbdev_port_eth_addr);
+
+	return 0;
+}
+
+static void
+lcore_conf_init(struct app_config_params *app_params,
+		struct lcore_conf *lcore_conf,
+		struct rte_mempool **bbdev_op_pools,
+		struct rte_mempool *bbdev_mbuf_mempool,
+		struct rte_ring *enc_to_dec_ring,
+		struct lcore_statistics *lcore_stats)
+{
+	unsigned int lcore_id;
+	struct lcore_conf *lconf;
+	uint16_t rx_queue_id = 0;
+	uint16_t tx_queue_id = 0;
+	uint16_t enc_q_id = 0;
+	uint16_t dec_q_id = 0;
+
+	/* Configure lcores */
+	for (lcore_id = 0; lcore_id < 8 * sizeof(uint64_t); ++lcore_id) {
+		lconf = &lcore_conf[lcore_id];
+		lconf->core_type = 0;
+
+		if ((1ULL << lcore_id) & app_params->enc_core_mask) {
+			lconf->core_type |= (1 << RTE_BBDEV_OP_TURBO_ENC);
+			lconf->rx_queue_id = rx_queue_id++;
+			lconf->enc_queue_id =
+					app_params->enc_queue_ids[enc_q_id++];
+		}
+
+		if ((1ULL << lcore_id) & app_params->dec_core_mask) {
+			lconf->core_type |= (1 << RTE_BBDEV_OP_TURBO_DEC);
+			lconf->tx_queue_id = tx_queue_id++;
+			lconf->dec_queue_id =
+					app_params->dec_queue_ids[dec_q_id++];
+		}
+
+		lconf->bbdev_enc_op_pool =
+				bbdev_op_pools[RTE_BBDEV_OP_TURBO_ENC];
+		lconf->bbdev_dec_op_pool =
+				bbdev_op_pools[RTE_BBDEV_OP_TURBO_DEC];
+		lconf->bbdev_id = app_params->bbdev_id;
+		lconf->port_id = app_params->port_id;
+		lconf->enc_out_pool = bbdev_mbuf_mempool;
+		lconf->enc_to_dec_ring = enc_to_dec_ring;
+		lconf->lcore_stats = &lcore_stats[lcore_id];
+	}
+}
+
+static void
+print_lcore_stats(struct lcore_statistics *lstats, unsigned int lcore_id)
+{
+	static const char *stats_border = "_______";
+
+	printf("\nLcore %d: %s enqueued count:\t\t%u\n",
+			lcore_id, stats_border, lstats->enqueued);
+	printf("Lcore %d: %s dequeued count:\t\t%u\n",
+			lcore_id, stats_border, lstats->dequeued);
+	printf("Lcore %d: %s RX lost packets count:\t\t%u\n",
+			lcore_id, stats_border, lstats->rx_lost_packets);
+	printf("Lcore %d: %s encoder-to-decoder lost count:\t%u\n",
+			lcore_id, stats_border,
+			lstats->enc_to_dec_lost_packets);
+	printf("Lcore %d: %s TX lost packets count:\t\t%u\n",
+			lcore_id, stats_border, lstats->tx_lost_packets);
+}
+
+static void
+print_stats(struct stats_lcore_params *stats_lcore)
+{
+	unsigned int l_id;
+	unsigned int bbdev_id = stats_lcore->app_params->bbdev_id;
+	unsigned int port_id = stats_lcore->app_params->port_id;
+	int len, ret, i;
+
+	struct rte_eth_xstat *xstats;
+	struct rte_eth_xstat_name *xstats_names;
+	struct rte_bbdev_stats bbstats;
+	static const char *stats_border = "_______";
+
+	const char clr[] = { 27, '[', '2', 'J', '\0' };
+	const char topLeft[] = { 27, '[', '1', ';', '1', 'H', '\0' };
+
+	/* Clear screen and move to top left */
+	printf("%s%s", clr, topLeft);
+
+	printf("PORT STATISTICS:\n================\n");
+	len = rte_eth_xstats_get(port_id, NULL, 0);
+	if (len < 0)
+		rte_exit(EXIT_FAILURE,
+				"rte_eth_xstats_get(%u) failed: %d", port_id,
+				len);
+
+	xstats = calloc(len, sizeof(*xstats));
+	if (xstats == NULL)
+		rte_exit(EXIT_FAILURE,
+				"Failed to calloc memory for xstats");
+
+	ret = rte_eth_xstats_get(port_id, xstats, len);
+	if (ret < 0 || ret > len) {
+		free(xstats);
+		rte_exit(EXIT_FAILURE,
+				"rte_eth_xstats_get(%u) len%i failed: %d",
+				port_id, len, ret);
+	}
+
+	xstats_names = calloc(len, sizeof(*xstats_names));
+	if (xstats_names == NULL) {
+		free(xstats);
+		rte_exit(EXIT_FAILURE,
+				"Failed to calloc memory for xstats_names");
+	}
+
+	ret = rte_eth_xstats_get_names(port_id, xstats_names, len);
+	if (ret < 0 || ret > len) {
+		free(xstats);
+		free(xstats_names);
+		rte_exit(EXIT_FAILURE,
+				"rte_eth_xstats_get_names(%u) len%i failed: %d",
+				port_id, len, ret);
+	}
+
+	for (i = 0; i < len; i++) {
+		if (xstats[i].value > 0)
+			printf("Port %u: %s %s:\t\t%"PRIu64"\n",
+					port_id, stats_border,
+					xstats_names[i].name,
+					xstats[i].value);
+	}
+
+	ret = rte_bbdev_stats_get(bbdev_id, &bbstats);
+	if (ret < 0) {
+		free(xstats);
+		free(xstats_names);
+		rte_exit(EXIT_FAILURE,
+				"ERROR(%d): Failure to get BBDEV %u statistics\n",
+				ret, bbdev_id);
+	}
+
+	printf("\nBBDEV STATISTICS:\n=================\n");
+	printf("BBDEV %u: %s enqueue count:\t\t%"PRIu64"\n",
+			bbdev_id, stats_border,
+			bbstats.enqueued_count);
+	printf("BBDEV %u: %s dequeue count:\t\t%"PRIu64"\n",
+			bbdev_id, stats_border,
+			bbstats.dequeued_count);
+	printf("BBDEV %u: %s enqueue error count:\t\t%"PRIu64"\n",
+			bbdev_id, stats_border,
+			bbstats.enqueue_err_count);
+	printf("BBDEV %u: %s dequeue error count:\t\t%"PRIu64"\n\n",
+			bbdev_id, stats_border,
+			bbstats.dequeue_err_count);
+
+	printf("LCORE STATISTICS:\n=================\n");
+	for (l_id = 0; l_id < RTE_MAX_LCORE; ++l_id) {
+		if (stats_lcore->lconf[l_id].core_type == 0)
+			continue;
+		print_lcore_stats(stats_lcore->lconf[l_id].lcore_stats, l_id);
+	}
+
+	free(xstats);
+	free(xstats_names);
+}
+
+static int
+stats_loop(void *arg)
+{
+	struct stats_lcore_params *stats_lcore = arg;
+
+	while (!rte_atomic16_read(&global_exit_flag)) {
+		print_stats(stats_lcore);
+		rte_delay_ms(500);
+	}
+
+	return 0;
+}
+
+static inline void
+run_encoding(struct lcore_conf *lcore_conf)
+{
+	uint16_t i;
+	uint16_t port_id, rx_queue_id;
+	uint16_t bbdev_id, enc_queue_id;
+	uint16_t nb_rx, nb_enq, nb_deq, nb_sent;
+	struct rte_mbuf *rx_pkts_burst[MAX_PKT_BURST];
+	struct rte_mbuf *enc_out_pkts[MAX_PKT_BURST];
+	struct rte_bbdev_enc_op *bbdev_ops_burst[MAX_PKT_BURST];
+	struct lcore_statistics *lcore_stats;
+	struct rte_mempool *bbdev_op_pool, *enc_out_pool;
+	struct rte_ring *enc_to_dec_ring;
+	const int in_data_len = (def_op_enc.cb_params.k / 8) - CRC_24B_LEN;
+
+	lcore_stats = lcore_conf->lcore_stats;
+	port_id = lcore_conf->port_id;
+	rx_queue_id = lcore_conf->rx_queue_id;
+	bbdev_id = lcore_conf->bbdev_id;
+	enc_queue_id = lcore_conf->enc_queue_id;
+	bbdev_op_pool = lcore_conf->bbdev_enc_op_pool;
+	enc_out_pool = lcore_conf->enc_out_pool;
+	enc_to_dec_ring = lcore_conf->enc_to_dec_ring;
+
+	/* Read packet from RX queues*/
+	nb_rx = rte_eth_rx_burst(port_id, rx_queue_id, rx_pkts_burst,
+			MAX_PKT_BURST);
+	if (!nb_rx)
+		return;
+
+	if (unlikely(rte_mempool_get_bulk(enc_out_pool, (void **)enc_out_pkts,
+			nb_rx) != 0)) {
+		pktmbuf_free_bulk(rx_pkts_burst, nb_rx);
+		lcore_stats->rx_lost_packets += nb_rx;
+		return;
+	}
+
+	if (unlikely(rte_bbdev_enc_op_alloc_bulk(bbdev_op_pool, bbdev_ops_burst,
+			nb_rx) != 0)) {
+		pktmbuf_free_bulk(enc_out_pkts, nb_rx);
+		pktmbuf_free_bulk(rx_pkts_burst, nb_rx);
+		lcore_stats->rx_lost_packets += nb_rx;
+		return;
+	}
+
+	for (i = 0; i < nb_rx; i++) {
+		char *data;
+		const uint16_t pkt_data_len =
+				rte_pktmbuf_data_len(rx_pkts_burst[i]) -
+				sizeof(struct ether_hdr);
+		/* save input mbuf pointer for later comparison */
+		enc_out_pkts[i]->userdata = rx_pkts_burst[i];
+
+		/* copy ethernet header */
+		rte_pktmbuf_reset(enc_out_pkts[i]);
+		data = rte_pktmbuf_append(enc_out_pkts[i],
+				sizeof(struct ether_hdr));
+		if (data == NULL) {
+			printf(
+				"Not enough space for ethernet header in encoder output mbuf\n");
+			continue;
+		}
+		add_ether_hdr(rx_pkts_burst[i], enc_out_pkts[i]);
+
+		/* set op */
+		bbdev_ops_burst[i]->turbo_enc = def_op_enc;
+
+		bbdev_ops_burst[i]->turbo_enc.input.data =
+				rx_pkts_burst[i];
+		bbdev_ops_burst[i]->turbo_enc.input.offset =
+				sizeof(struct ether_hdr);
+		/* Encoder will attach the CRC24B, adjust the length */
+		bbdev_ops_burst[i]->turbo_enc.input.length = in_data_len;
+
+		if (in_data_len < pkt_data_len)
+			rte_pktmbuf_trim(rx_pkts_burst[i], pkt_data_len -
+					in_data_len);
+		else if (in_data_len > pkt_data_len) {
+			data = rte_pktmbuf_append(rx_pkts_burst[i],
+					in_data_len - pkt_data_len);
+			if (data == NULL)
+				printf(
+					"Not enough storage in mbuf to perform the encoding\n");
+		}
+
+		bbdev_ops_burst[i]->turbo_enc.output.data =
+				enc_out_pkts[i];
+		bbdev_ops_burst[i]->turbo_enc.output.offset =
+				sizeof(struct ether_hdr);
+	}
+
+	/* Enqueue packets on BBDevice */
+	nb_enq = rte_bbdev_enqueue_enc_ops(bbdev_id, enc_queue_id,
+			bbdev_ops_burst, nb_rx);
+	if (unlikely(nb_enq < nb_rx)) {
+		pktmbuf_userdata_free_bulk(&enc_out_pkts[nb_enq],
+				nb_rx - nb_enq);
+		rte_bbdev_enc_op_free_bulk(&bbdev_ops_burst[nb_enq],
+				nb_rx - nb_enq);
+		lcore_stats->rx_lost_packets += nb_rx - nb_enq;
+
+		if (!nb_enq)
+			return;
+	}
+
+	lcore_stats->enqueued += nb_enq;
+
+	/* Dequeue packets from bbdev device*/
+	nb_deq = 0;
+	do {
+		nb_deq += rte_bbdev_dequeue_enc_ops(bbdev_id, enc_queue_id,
+				&bbdev_ops_burst[nb_deq], nb_enq - nb_deq);
+	} while (unlikely(nb_deq < nb_enq));
+
+	lcore_stats->dequeued += nb_deq;
+
+	/* Generate and add AWGN */
+	add_awgn(enc_out_pkts, nb_deq);
+
+	rte_bbdev_enc_op_free_bulk(bbdev_ops_burst, nb_deq);
+
+	/* Enqueue packets to encoder-to-decoder ring */
+	nb_sent = rte_ring_enqueue_burst(enc_to_dec_ring, (void **)enc_out_pkts,
+			nb_deq, NULL);
+	if (unlikely(nb_sent < nb_deq)) {
+		pktmbuf_userdata_free_bulk(&enc_out_pkts[nb_sent],
+				nb_deq - nb_sent);
+		lcore_stats->enc_to_dec_lost_packets += nb_deq - nb_sent;
+	}
+}
+
+static void
+run_decoding(struct lcore_conf *lcore_conf)
+{
+	uint16_t i;
+	uint16_t port_id, tx_queue_id;
+	uint16_t bbdev_id, bbdev_queue_id;
+	uint16_t nb_recv, nb_enq, nb_deq, nb_tx;
+	uint8_t *llr_temp_buf;
+	struct rte_mbuf *recv_pkts_burst[MAX_PKT_BURST];
+	struct rte_bbdev_dec_op *bbdev_ops_burst[MAX_PKT_BURST];
+	struct lcore_statistics *lcore_stats;
+	struct rte_mempool *bbdev_op_pool;
+	struct rte_ring *enc_to_dec_ring;
+
+	lcore_stats = lcore_conf->lcore_stats;
+	port_id = lcore_conf->port_id;
+	tx_queue_id = lcore_conf->tx_queue_id;
+	bbdev_id = lcore_conf->bbdev_id;
+	bbdev_queue_id = lcore_conf->dec_queue_id;
+	bbdev_op_pool = lcore_conf->bbdev_dec_op_pool;
+	enc_to_dec_ring = lcore_conf->enc_to_dec_ring;
+	llr_temp_buf = lcore_conf->llr_temp_buf;
+
+	/* Dequeue packets from the ring */
+	nb_recv = rte_ring_dequeue_burst(enc_to_dec_ring,
+			(void **)recv_pkts_burst, MAX_PKT_BURST, NULL);
+	if (!nb_recv)
+		return;
+
+	if (unlikely(rte_bbdev_dec_op_alloc_bulk(bbdev_op_pool, bbdev_ops_burst,
+			nb_recv) != 0)) {
+		pktmbuf_userdata_free_bulk(recv_pkts_burst, nb_recv);
+		lcore_stats->rx_lost_packets += nb_recv;
+		return;
+	}
+
+	transform_enc_out_dec_in(recv_pkts_burst, llr_temp_buf, nb_recv,
+			def_op_dec.cb_params.k);
+
+	for (i = 0; i < nb_recv; i++) {
+		/* set op */
+		bbdev_ops_burst[i]->turbo_dec = def_op_dec;
+
+		bbdev_ops_burst[i]->turbo_dec.input.data = recv_pkts_burst[i];
+		bbdev_ops_burst[i]->turbo_dec.input.offset =
+				sizeof(struct ether_hdr);
+		bbdev_ops_burst[i]->turbo_dec.input.length =
+				rte_pktmbuf_data_len(recv_pkts_burst[i])
+				- sizeof(struct ether_hdr);
+
+		bbdev_ops_burst[i]->turbo_dec.hard_output.data =
+				recv_pkts_burst[i];
+		bbdev_ops_burst[i]->turbo_dec.hard_output.offset =
+				sizeof(struct ether_hdr);
+	}
+
+	/* Enqueue packets on BBDevice */
+	nb_enq = rte_bbdev_enqueue_dec_ops(bbdev_id, bbdev_queue_id,
+			bbdev_ops_burst, nb_recv);
+	if (unlikely(nb_enq < nb_recv)) {
+		pktmbuf_userdata_free_bulk(&recv_pkts_burst[nb_enq],
+				nb_recv - nb_enq);
+		rte_bbdev_dec_op_free_bulk(&bbdev_ops_burst[nb_enq],
+				nb_recv - nb_enq);
+		lcore_stats->rx_lost_packets += nb_recv - nb_enq;
+
+		if (!nb_enq)
+			return;
+	}
+
+	lcore_stats->enqueued += nb_enq;
+
+	/* Dequeue packets from BBDevice */
+	nb_deq = 0;
+	do {
+		nb_deq += rte_bbdev_dequeue_dec_ops(bbdev_id, bbdev_queue_id,
+				&bbdev_ops_burst[nb_deq], nb_enq - nb_deq);
+	} while (unlikely(nb_deq < nb_enq));
+
+	lcore_stats->dequeued += nb_deq;
+
+	rte_bbdev_dec_op_free_bulk(bbdev_ops_burst, nb_deq);
+
+	verify_data(recv_pkts_burst, nb_deq);
+
+	/* Free the RX mbufs after verification */
+	for (i = 0; i < nb_deq; ++i)
+		rte_pktmbuf_free(recv_pkts_burst[i]->userdata);
+
+	/* Transmit the packets */
+	nb_tx = rte_eth_tx_burst(port_id, tx_queue_id, recv_pkts_burst, nb_deq);
+	if (unlikely(nb_tx < nb_deq)) {
+		pktmbuf_userdata_free_bulk(&recv_pkts_burst[nb_tx],
+				nb_deq - nb_tx);
+		lcore_stats->tx_lost_packets += nb_deq - nb_tx;
+	}
+}
+
+static int
+processing_loop(void *arg)
+{
+	struct lcore_conf *lcore_conf = arg;
+	const bool run_encoder = (lcore_conf->core_type &
+			(1 << RTE_BBDEV_OP_TURBO_ENC));
+	const bool run_decoder = (lcore_conf->core_type &
+			(1 << RTE_BBDEV_OP_TURBO_DEC));
+
+	while (!rte_atomic16_read(&global_exit_flag)) {
+		if (run_encoder)
+			run_encoding(lcore_conf);
+		if (run_decoder)
+			run_decoding(lcore_conf);
+	}
+
+	return 0;
+}
+
+static int
+prepare_bbdev_device(unsigned int dev_id, struct rte_bbdev_info *info,
+		struct app_config_params *app_params)
+{
+	int ret;
+	unsigned int q_id, dec_q_id, enc_q_id;
+	struct rte_bbdev_queue_conf qconf = {0};
+	uint16_t dec_qs_nb = app_params->num_dec_cores;
+	uint16_t enc_qs_nb = app_params->num_enc_cores;
+	uint16_t tot_qs = dec_qs_nb + enc_qs_nb;
+
+	ret = rte_bbdev_setup_queues(dev_id, tot_qs, info->socket_id);
+	if (ret < 0)
+		rte_exit(EXIT_FAILURE,
+				"ERROR(%d): BBDEV %u not configured properly\n",
+				ret, dev_id);
+
+	/* setup device DEC queues */
+	qconf.socket = info->socket_id;
+	qconf.queue_size = info->drv.queue_size_lim;
+	qconf.op_type = RTE_BBDEV_OP_TURBO_DEC;
+
+	for (q_id = 0, dec_q_id = 0; q_id < dec_qs_nb; q_id++) {
+		ret = rte_bbdev_queue_configure(dev_id, q_id, &qconf);
+		if (ret < 0)
+			rte_exit(EXIT_FAILURE,
+					"ERROR(%d): BBDEV %u DEC queue %u not configured properly\n",
+					ret, dev_id, q_id);
+		app_params->dec_queue_ids[dec_q_id++] = q_id;
+	}
+
+	/* setup device ENC queues */
+	qconf.op_type = RTE_BBDEV_OP_TURBO_ENC;
+
+	for (q_id = dec_qs_nb, enc_q_id = 0; q_id < tot_qs; q_id++) {
+		ret = rte_bbdev_queue_configure(dev_id, q_id, &qconf);
+		if (ret < 0)
+			rte_exit(EXIT_FAILURE,
+					"ERROR(%d): BBDEV %u ENC queue %u not configured properly\n",
+					ret, dev_id, q_id);
+		app_params->enc_queue_ids[enc_q_id++] = q_id;
+	}
+
+	ret = rte_bbdev_start(dev_id);
+
+	if (ret != 0)
+		rte_exit(EXIT_FAILURE, "ERROR(%d): BBDEV %u not started\n",
+			ret, dev_id);
+
+	printf("BBdev %u started\n", dev_id);
+
+	return 0;
+}
+
+static inline bool
+check_matching_capabilities(uint64_t mask, uint64_t required_mask)
+{
+	return (mask & required_mask) == required_mask;
+}
+
+static void
+enable_bbdev(struct app_config_params *app_params)
+{
+	struct rte_bbdev_info dev_info;
+	const struct rte_bbdev_op_cap *op_cap;
+	uint16_t bbdev_id = app_params->bbdev_id;
+	bool encoder_capable = false;
+	bool decoder_capable = false;
+
+	rte_bbdev_info_get(bbdev_id, &dev_info);
+	op_cap = dev_info.drv.capabilities;
+
+	while (op_cap->type != RTE_BBDEV_OP_NONE) {
+		if (op_cap->type == RTE_BBDEV_OP_TURBO_ENC) {
+			if (check_matching_capabilities(
+					op_cap->cap.turbo_enc.capability_flags,
+					def_op_enc.op_flags))
+				encoder_capable = true;
+		}
+
+		if (op_cap->type == RTE_BBDEV_OP_TURBO_DEC) {
+			if (check_matching_capabilities(
+					op_cap->cap.turbo_dec.capability_flags,
+					def_op_dec.op_flags))
+				decoder_capable = true;
+		}
+
+		op_cap++;
+	}
+
+	if (encoder_capable == false)
+		rte_exit(EXIT_FAILURE,
+			"The specified BBDev %u doesn't have required encoder capabilities!\n",
+			bbdev_id);
+	if (decoder_capable == false)
+		rte_exit(EXIT_FAILURE,
+			"The specified BBDev %u doesn't have required decoder capabilities!\n",
+			bbdev_id);
+
+	prepare_bbdev_device(bbdev_id, &dev_info, app_params);
+}
+
+int
+main(int argc, char **argv)
+{
+	int ret;
+	unsigned int nb_bbdevs, nb_ports, flags, lcore_id;
+	void *sigret;
+	struct app_config_params app_params = def_app_config;
+	struct rte_mempool *ethdev_mbuf_mempool, *bbdev_mbuf_mempool;
+	struct rte_mempool *bbdev_op_pools[RTE_BBDEV_OP_TYPE_COUNT];
+	struct lcore_conf lcore_conf[RTE_MAX_LCORE] = { {0} };
+	struct lcore_statistics lcore_stats[RTE_MAX_LCORE] = { {0} };
+	struct stats_lcore_params stats_lcore;
+	struct rte_ring *enc_to_dec_ring;
+	bool stats_thread_started = false;
+	unsigned int master_lcore_id = rte_get_master_lcore();
+
+	rte_atomic16_init(&global_exit_flag);
+
+	sigret = signal(SIGTERM, signal_handler);
+	if (sigret == SIG_ERR)
+		rte_exit(EXIT_FAILURE, "signal(%d, ...) failed", SIGTERM);
+
+	sigret = signal(SIGINT, signal_handler);
+	if (sigret == SIG_ERR)
+		rte_exit(EXIT_FAILURE, "signal(%d, ...) failed", SIGINT);
+
+	ret = rte_eal_init(argc, argv);
+	if (ret < 0)
+		rte_exit(EXIT_FAILURE, "Invalid EAL arguments\n");
+
+	argc -= ret;
+	argv += ret;
+
+	/* parse application arguments (after the EAL ones) */
+	ret = bbdev_parse_args(argc, argv, &app_params);
+	if (ret < 0)
+		rte_exit(EXIT_FAILURE, "Invalid BBDEV arguments\n");
+
+	/*create bbdev op pools*/
+	bbdev_op_pools[RTE_BBDEV_OP_TURBO_DEC] =
+			rte_bbdev_op_pool_create("bbdev_op_pool_dec",
+			RTE_BBDEV_OP_TURBO_DEC, NB_MBUF, 128, rte_socket_id());
+	bbdev_op_pools[RTE_BBDEV_OP_TURBO_ENC] =
+			rte_bbdev_op_pool_create("bbdev_op_pool_enc",
+			RTE_BBDEV_OP_TURBO_ENC, NB_MBUF, 128, rte_socket_id());
+
+	if ((bbdev_op_pools[RTE_BBDEV_OP_TURBO_DEC] == NULL) ||
+			(bbdev_op_pools[RTE_BBDEV_OP_TURBO_ENC] == NULL))
+		rte_exit(EXIT_FAILURE, "Cannot create bbdev op pools\n");
+
+	/* Create encoder to decoder ring */
+	flags = (app_params.num_enc_cores == 1) ? RING_F_SP_ENQ : 0;
+	if (app_params.num_dec_cores == 1)
+		flags |= RING_F_SC_DEQ;
+
+	enc_to_dec_ring = rte_ring_create("enc_to_dec_ring",
+		rte_align32pow2(NB_MBUF), rte_socket_id(), flags);
+
+	/* Get the number of available bbdev devices */
+	nb_bbdevs = rte_bbdev_count();
+	if (nb_bbdevs <= app_params.bbdev_id)
+		rte_exit(EXIT_FAILURE,
+				"%u BBDevs detected, cannot use BBDev with ID %u!\n",
+				nb_bbdevs, app_params.bbdev_id);
+	printf("Number of bbdevs detected: %d\n", nb_bbdevs);
+
+	/* Get the number of available ethdev devices */
+	nb_ports = rte_eth_dev_count();
+	if (nb_ports <= app_params.port_id)
+		rte_exit(EXIT_FAILURE,
+				"%u ports detected, cannot use port with ID %u!\n",
+				nb_ports, app_params.port_id);
+
+	/* create the mbuf mempool for ethdev pkts */
+	ethdev_mbuf_mempool = rte_pktmbuf_pool_create("ethdev_mbuf_pool",
+			NB_MBUF, MEMPOOL_CACHE_SIZE, 0,
+			RTE_MBUF_DEFAULT_BUF_SIZE, rte_socket_id());
+	if (ethdev_mbuf_mempool == NULL)
+		rte_exit(EXIT_FAILURE, "Cannot create ethdev mbuf mempool\n");
+
+	/* create the mbuf mempool for encoder output */
+	bbdev_mbuf_mempool = rte_pktmbuf_pool_create("bbdev_mbuf_pool",
+			NB_MBUF, MEMPOOL_CACHE_SIZE, 0,
+			RTE_MBUF_DEFAULT_BUF_SIZE, rte_socket_id());
+	if (bbdev_mbuf_mempool == NULL)
+		rte_exit(EXIT_FAILURE, "Cannot create ethdev mbuf mempool\n");
+
+	/* initialize ports */
+	ret = initialize_ports(&app_params, ethdev_mbuf_mempool);
+
+	/* Check if all requested lcores are available */
+	for (lcore_id = 0; lcore_id < 8 * sizeof(uint64_t); ++lcore_id)
+		if (((1ULL << lcore_id) & app_params.enc_core_mask) ||
+				((1ULL << lcore_id) & app_params.dec_core_mask))
+			if (!rte_lcore_is_enabled(lcore_id))
+				rte_exit(EXIT_FAILURE,
+						"Requested lcore_id %u is not enabled!\n",
+						lcore_id);
+
+	/* Start ethernet port */
+	ret = rte_eth_dev_start(app_params.port_id);
+	if (ret < 0)
+		rte_exit(EXIT_FAILURE, "rte_eth_dev_start:err=%d, port=%u\n",
+				ret, app_params.port_id);
+
+	ret = check_port_link_status(app_params.port_id);
+	if (ret < 0)
+		exit(EXIT_FAILURE);
+
+	/* start BBDevice and save BBDev queue IDs */
+	enable_bbdev(&app_params);
+
+	/* Initialize the port/queue configuration of each logical core */
+	lcore_conf_init(&app_params, lcore_conf, bbdev_op_pools,
+			bbdev_mbuf_mempool, enc_to_dec_ring, lcore_stats);
+
+	stats_lcore.app_params = &app_params;
+	stats_lcore.lconf = lcore_conf;
+
+	RTE_LCORE_FOREACH_SLAVE(lcore_id) {
+		if (lcore_conf[lcore_id].core_type != 0)
+			/* launch per-lcore processing loop on slave lcores */
+			rte_eal_remote_launch(processing_loop,
+					&lcore_conf[lcore_id], lcore_id);
+		else if (!stats_thread_started) {
+			/* launch statistics printing loop */
+			rte_eal_remote_launch(stats_loop, &stats_lcore,
+					lcore_id);
+			stats_thread_started = true;
+		}
+	}
+
+	if (!stats_thread_started &&
+			lcore_conf[master_lcore_id].core_type != 0)
+		rte_exit(EXIT_FAILURE,
+				"Not enough lcores to run the statistics printing loop!");
+	else if (lcore_conf[master_lcore_id].core_type != 0)
+		processing_loop(&lcore_conf[master_lcore_id]);
+	else if (!stats_thread_started)
+		stats_loop(&stats_lcore);
+
+	RTE_LCORE_FOREACH_SLAVE(lcore_id) {
+		ret |= rte_eal_wait_lcore(lcore_id);
+	}
+
+	return ret;
+}
diff --git a/examples/bbdev_app/meson.build b/examples/bbdev_app/meson.build
new file mode 100644
index 00000000..8e06a8a2
--- /dev/null
+++ b/examples/bbdev_app/meson.build
@@ -0,0 +1,13 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2017 Intel Corporation
+
+# meson file, for building this example as part of a main DPDK build.
+#
+# To build this example as a standalone application with an already-installed
+# DPDK instance, use 'make'
+
+deps += 'bbdev'
+allow_experimental_apis = true
+sources = files(
+	'main.c'
+)