1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2017 Intel Corporation
9 #include <rte_compat.h>
10 #include <rte_common.h>
11 #include <rte_errno.h>
13 #include <rte_debug.h>
15 #include <rte_malloc.h>
16 #include <rte_mempool.h>
17 #include <rte_memzone.h>
18 #include <rte_lcore.h>
20 #include <rte_spinlock.h>
21 #include <rte_tailq.h>
22 #include <rte_interrupts.h>
24 #include "rte_bbdev_op.h"
25 #include "rte_bbdev.h"
26 #include "rte_bbdev_pmd.h"
28 #define DEV_NAME "BBDEV"
31 /* Helper macro to check dev_id is valid */
32 #define VALID_DEV_OR_RET_ERR(dev, dev_id) do { \
34 rte_bbdev_log(ERR, "device %u is invalid", dev_id); \
39 /* Helper macro to check dev_ops is valid */
40 #define VALID_DEV_OPS_OR_RET_ERR(dev, dev_id) do { \
41 if (dev->dev_ops == NULL) { \
42 rte_bbdev_log(ERR, "NULL dev_ops structure in device %u", \
48 /* Helper macro to check that driver implements required function pointer */
49 #define VALID_FUNC_OR_RET_ERR(func, dev_id) do { \
51 rte_bbdev_log(ERR, "device %u does not support %s", \
57 /* Helper macro to check that queue is valid */
58 #define VALID_QUEUE_OR_RET_ERR(queue_id, dev) do { \
59 if (queue_id >= dev->data->num_queues) { \
60 rte_bbdev_log(ERR, "Invalid queue_id %u for device %u", \
61 queue_id, dev->data->dev_id); \
66 /* List of callback functions registered by an application */
67 struct rte_bbdev_callback {
68 TAILQ_ENTRY(rte_bbdev_callback) next; /* Callbacks list */
69 rte_bbdev_cb_fn cb_fn; /* Callback address */
70 void *cb_arg; /* Parameter for callback */
71 void *ret_param; /* Return parameter */
72 enum rte_bbdev_event_type event; /* Interrupt event type */
73 uint32_t active; /* Callback is executing */
76 /* spinlock for bbdev device callbacks */
77 static rte_spinlock_t rte_bbdev_cb_lock = RTE_SPINLOCK_INITIALIZER;
80 * Global array of all devices. This is not static because it's used by the
81 * inline enqueue and dequeue functions
83 struct rte_bbdev rte_bbdev_devices[RTE_BBDEV_MAX_DEVS];
85 /* Global array with rte_bbdev_data structures */
86 static struct rte_bbdev_data *rte_bbdev_data;
88 /* Memzone name for global bbdev data pool */
89 static const char *MZ_RTE_BBDEV_DATA = "rte_bbdev_data";
91 /* Number of currently valid devices */
92 static uint16_t num_devs;
94 /* Return pointer to device structure, with validity check */
95 static struct rte_bbdev *
96 get_dev(uint16_t dev_id)
98 if (rte_bbdev_is_valid(dev_id))
99 return &rte_bbdev_devices[dev_id];
103 /* Allocate global data array */
105 rte_bbdev_data_alloc(void)
107 const unsigned int flags = 0;
108 const struct rte_memzone *mz;
110 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
111 mz = rte_memzone_reserve(MZ_RTE_BBDEV_DATA,
112 RTE_BBDEV_MAX_DEVS * sizeof(*rte_bbdev_data),
113 rte_socket_id(), flags);
115 mz = rte_memzone_lookup(MZ_RTE_BBDEV_DATA);
118 "Cannot allocate memzone for bbdev port data");
122 rte_bbdev_data = mz->addr;
123 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
124 memset(rte_bbdev_data, 0,
125 RTE_BBDEV_MAX_DEVS * sizeof(*rte_bbdev_data));
130 * Find data alocated for the device or if not found return first unused bbdev
131 * data. If all structures are in use and none is used by the device return
134 static struct rte_bbdev_data *
135 find_bbdev_data(const char *name)
139 for (data_id = 0; data_id < RTE_BBDEV_MAX_DEVS; ++data_id) {
140 if (strlen(rte_bbdev_data[data_id].name) == 0) {
141 memset(&rte_bbdev_data[data_id], 0,
142 sizeof(struct rte_bbdev_data));
143 return &rte_bbdev_data[data_id];
144 } else if (strncmp(rte_bbdev_data[data_id].name, name,
145 RTE_BBDEV_NAME_MAX_LEN) == 0)
146 return &rte_bbdev_data[data_id];
152 /* Find lowest device id with no attached device */
154 find_free_dev_id(void)
157 for (i = 0; i < RTE_BBDEV_MAX_DEVS; i++) {
158 if (rte_bbdev_devices[i].state == RTE_BBDEV_UNUSED)
161 return RTE_BBDEV_MAX_DEVS;
164 struct rte_bbdev * __rte_experimental
165 rte_bbdev_allocate(const char *name)
168 struct rte_bbdev *bbdev;
172 rte_bbdev_log(ERR, "Invalid null device name");
176 if (rte_bbdev_get_named_dev(name) != NULL) {
177 rte_bbdev_log(ERR, "Device \"%s\" is already allocated", name);
181 dev_id = find_free_dev_id();
182 if (dev_id == RTE_BBDEV_MAX_DEVS) {
183 rte_bbdev_log(ERR, "Reached maximum number of devices");
187 bbdev = &rte_bbdev_devices[dev_id];
189 if (rte_bbdev_data == NULL) {
190 ret = rte_bbdev_data_alloc();
195 bbdev->data = find_bbdev_data(name);
196 if (bbdev->data == NULL) {
198 "Max BBDevs already allocated in multi-process environment!");
202 rte_atomic16_inc(&bbdev->data->process_cnt);
203 bbdev->data->dev_id = dev_id;
204 bbdev->state = RTE_BBDEV_INITIALIZED;
206 ret = snprintf(bbdev->data->name, RTE_BBDEV_NAME_MAX_LEN, "%s", name);
207 if ((ret < 0) || (ret >= RTE_BBDEV_NAME_MAX_LEN)) {
208 rte_bbdev_log(ERR, "Copying device name \"%s\" failed", name);
212 /* init user callbacks */
213 TAILQ_INIT(&(bbdev->list_cbs));
217 rte_bbdev_log_debug("Initialised device %s (id = %u). Num devices = %u",
218 name, dev_id, num_devs);
223 int __rte_experimental
224 rte_bbdev_release(struct rte_bbdev *bbdev)
227 struct rte_bbdev_callback *cb, *next;
230 rte_bbdev_log(ERR, "NULL bbdev");
233 dev_id = bbdev->data->dev_id;
235 /* free all callbacks from the device's list */
236 for (cb = TAILQ_FIRST(&bbdev->list_cbs); cb != NULL; cb = next) {
238 next = TAILQ_NEXT(cb, next);
239 TAILQ_REMOVE(&(bbdev->list_cbs), cb, next);
243 /* clear shared BBDev Data if no process is using the device anymore */
244 if (rte_atomic16_dec_and_test(&bbdev->data->process_cnt))
245 memset(bbdev->data, 0, sizeof(*bbdev->data));
247 memset(bbdev, 0, sizeof(*bbdev));
249 bbdev->state = RTE_BBDEV_UNUSED;
252 "Un-initialised device id = %u. Num devices = %u",
257 struct rte_bbdev * __rte_experimental
258 rte_bbdev_get_named_dev(const char *name)
263 rte_bbdev_log(ERR, "NULL driver name");
267 for (i = 0; i < RTE_BBDEV_MAX_DEVS; i++) {
268 struct rte_bbdev *dev = get_dev(i);
269 if (dev && (strncmp(dev->data->name,
270 name, RTE_BBDEV_NAME_MAX_LEN) == 0))
277 uint16_t __rte_experimental
278 rte_bbdev_count(void)
283 bool __rte_experimental
284 rte_bbdev_is_valid(uint16_t dev_id)
286 if ((dev_id < RTE_BBDEV_MAX_DEVS) &&
287 rte_bbdev_devices[dev_id].state == RTE_BBDEV_INITIALIZED)
292 uint16_t __rte_experimental
293 rte_bbdev_find_next(uint16_t dev_id)
296 for (; dev_id < RTE_BBDEV_MAX_DEVS; dev_id++)
297 if (rte_bbdev_is_valid(dev_id))
302 int __rte_experimental
303 rte_bbdev_setup_queues(uint16_t dev_id, uint16_t num_queues, int socket_id)
307 struct rte_bbdev_driver_info dev_info;
308 struct rte_bbdev *dev = get_dev(dev_id);
309 VALID_DEV_OR_RET_ERR(dev, dev_id);
311 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
313 if (dev->data->started) {
315 "Device %u cannot be configured when started",
320 /* Get device driver information to get max number of queues */
321 VALID_FUNC_OR_RET_ERR(dev->dev_ops->info_get, dev_id);
322 memset(&dev_info, 0, sizeof(dev_info));
323 dev->dev_ops->info_get(dev, &dev_info);
325 if ((num_queues == 0) || (num_queues > dev_info.max_num_queues)) {
327 "Device %u supports 0 < N <= %u queues, not %u",
328 dev_id, dev_info.max_num_queues, num_queues);
332 /* If re-configuration, get driver to free existing internal memory */
333 if (dev->data->queues != NULL) {
334 VALID_FUNC_OR_RET_ERR(dev->dev_ops->queue_release, dev_id);
335 for (i = 0; i < dev->data->num_queues; i++) {
336 int ret = dev->dev_ops->queue_release(dev, i);
339 "Device %u queue %u release failed",
344 /* Call optional device close */
345 if (dev->dev_ops->close) {
346 ret = dev->dev_ops->close(dev);
349 "Device %u couldn't be closed",
354 rte_free(dev->data->queues);
357 /* Allocate queue pointers */
358 dev->data->queues = rte_calloc_socket(DEV_NAME, num_queues,
359 sizeof(dev->data->queues[0]), RTE_CACHE_LINE_SIZE,
360 dev->data->socket_id);
361 if (dev->data->queues == NULL) {
363 "calloc of %u queues for device %u on socket %i failed",
364 num_queues, dev_id, dev->data->socket_id);
368 dev->data->num_queues = num_queues;
370 /* Call optional device configuration */
371 if (dev->dev_ops->setup_queues) {
372 ret = dev->dev_ops->setup_queues(dev, num_queues, socket_id);
375 "Device %u memory configuration failed",
381 rte_bbdev_log_debug("Device %u set up with %u queues", dev_id,
386 dev->data->num_queues = 0;
387 rte_free(dev->data->queues);
388 dev->data->queues = NULL;
392 int __rte_experimental
393 rte_bbdev_intr_enable(uint16_t dev_id)
396 struct rte_bbdev *dev = get_dev(dev_id);
397 VALID_DEV_OR_RET_ERR(dev, dev_id);
399 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
401 if (dev->data->started) {
403 "Device %u cannot be configured when started",
408 if (dev->dev_ops->intr_enable) {
409 ret = dev->dev_ops->intr_enable(dev);
412 "Device %u interrupts configuration failed",
416 rte_bbdev_log_debug("Enabled interrupts for dev %u", dev_id);
420 rte_bbdev_log(ERR, "Device %u doesn't support interrupts", dev_id);
424 int __rte_experimental
425 rte_bbdev_queue_configure(uint16_t dev_id, uint16_t queue_id,
426 const struct rte_bbdev_queue_conf *conf)
429 struct rte_bbdev_driver_info dev_info;
430 struct rte_bbdev *dev = get_dev(dev_id);
431 const struct rte_bbdev_op_cap *p;
432 struct rte_bbdev_queue_conf *stored_conf;
433 const char *op_type_str;
434 VALID_DEV_OR_RET_ERR(dev, dev_id);
436 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
438 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
440 if (dev->data->queues[queue_id].started || dev->data->started) {
442 "Queue %u of device %u cannot be configured when started",
447 VALID_FUNC_OR_RET_ERR(dev->dev_ops->queue_release, dev_id);
448 VALID_FUNC_OR_RET_ERR(dev->dev_ops->queue_setup, dev_id);
450 /* Get device driver information to verify config is valid */
451 VALID_FUNC_OR_RET_ERR(dev->dev_ops->info_get, dev_id);
452 memset(&dev_info, 0, sizeof(dev_info));
453 dev->dev_ops->info_get(dev, &dev_info);
455 /* Check configuration is valid */
457 if ((conf->op_type == RTE_BBDEV_OP_NONE) &&
458 (dev_info.capabilities[0].type ==
459 RTE_BBDEV_OP_NONE)) {
462 for (p = dev_info.capabilities;
463 p->type != RTE_BBDEV_OP_NONE; p++) {
464 if (conf->op_type == p->type) {
471 rte_bbdev_log(ERR, "Invalid operation type");
474 if (conf->queue_size > dev_info.queue_size_lim) {
476 "Size (%u) of queue %u of device %u must be: <= %u",
477 conf->queue_size, queue_id, dev_id,
478 dev_info.queue_size_lim);
481 if (!rte_is_power_of_2(conf->queue_size)) {
483 "Size (%u) of queue %u of device %u must be a power of 2",
484 conf->queue_size, queue_id, dev_id);
487 if (conf->priority > dev_info.max_queue_priority) {
489 "Priority (%u) of queue %u of bdev %u must be <= %u",
490 conf->priority, queue_id, dev_id,
491 dev_info.max_queue_priority);
496 /* Release existing queue (in case of queue reconfiguration) */
497 if (dev->data->queues[queue_id].queue_private != NULL) {
498 ret = dev->dev_ops->queue_release(dev, queue_id);
500 rte_bbdev_log(ERR, "Device %u queue %u release failed",
506 /* Get driver to setup the queue */
507 ret = dev->dev_ops->queue_setup(dev, queue_id, (conf != NULL) ?
508 conf : &dev_info.default_queue_conf);
511 "Device %u queue %u setup failed", dev_id,
516 /* Store configuration */
517 stored_conf = &dev->data->queues[queue_id].conf;
519 (conf != NULL) ? conf : &dev_info.default_queue_conf,
520 sizeof(*stored_conf));
522 op_type_str = rte_bbdev_op_type_str(stored_conf->op_type);
523 if (op_type_str == NULL)
526 rte_bbdev_log_debug("Configured dev%uq%u (size=%u, type=%s, prio=%u)",
527 dev_id, queue_id, stored_conf->queue_size, op_type_str,
528 stored_conf->priority);
533 int __rte_experimental
534 rte_bbdev_start(uint16_t dev_id)
537 struct rte_bbdev *dev = get_dev(dev_id);
538 VALID_DEV_OR_RET_ERR(dev, dev_id);
540 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
542 if (dev->data->started) {
543 rte_bbdev_log_debug("Device %u is already started", dev_id);
547 if (dev->dev_ops->start) {
548 int ret = dev->dev_ops->start(dev);
550 rte_bbdev_log(ERR, "Device %u start failed", dev_id);
555 /* Store new state */
556 for (i = 0; i < dev->data->num_queues; i++)
557 if (!dev->data->queues[i].conf.deferred_start)
558 dev->data->queues[i].started = true;
559 dev->data->started = true;
561 rte_bbdev_log_debug("Started device %u", dev_id);
565 int __rte_experimental
566 rte_bbdev_stop(uint16_t dev_id)
568 struct rte_bbdev *dev = get_dev(dev_id);
569 VALID_DEV_OR_RET_ERR(dev, dev_id);
571 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
573 if (!dev->data->started) {
574 rte_bbdev_log_debug("Device %u is already stopped", dev_id);
578 if (dev->dev_ops->stop)
579 dev->dev_ops->stop(dev);
580 dev->data->started = false;
582 rte_bbdev_log_debug("Stopped device %u", dev_id);
586 int __rte_experimental
587 rte_bbdev_close(uint16_t dev_id)
591 struct rte_bbdev *dev = get_dev(dev_id);
592 VALID_DEV_OR_RET_ERR(dev, dev_id);
594 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
596 if (dev->data->started) {
597 ret = rte_bbdev_stop(dev_id);
599 rte_bbdev_log(ERR, "Device %u stop failed", dev_id);
604 /* Free memory used by queues */
605 for (i = 0; i < dev->data->num_queues; i++) {
606 ret = dev->dev_ops->queue_release(dev, i);
608 rte_bbdev_log(ERR, "Device %u queue %u release failed",
613 rte_free(dev->data->queues);
615 if (dev->dev_ops->close) {
616 ret = dev->dev_ops->close(dev);
618 rte_bbdev_log(ERR, "Device %u close failed", dev_id);
623 /* Clear configuration */
624 dev->data->queues = NULL;
625 dev->data->num_queues = 0;
627 rte_bbdev_log_debug("Closed device %u", dev_id);
631 int __rte_experimental
632 rte_bbdev_queue_start(uint16_t dev_id, uint16_t queue_id)
634 struct rte_bbdev *dev = get_dev(dev_id);
635 VALID_DEV_OR_RET_ERR(dev, dev_id);
637 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
639 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
641 if (dev->data->queues[queue_id].started) {
642 rte_bbdev_log_debug("Queue %u of device %u already started",
647 if (dev->dev_ops->queue_start) {
648 int ret = dev->dev_ops->queue_start(dev, queue_id);
650 rte_bbdev_log(ERR, "Device %u queue %u start failed",
655 dev->data->queues[queue_id].started = true;
657 rte_bbdev_log_debug("Started queue %u of device %u", queue_id, dev_id);
661 int __rte_experimental
662 rte_bbdev_queue_stop(uint16_t dev_id, uint16_t queue_id)
664 struct rte_bbdev *dev = get_dev(dev_id);
665 VALID_DEV_OR_RET_ERR(dev, dev_id);
667 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
669 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
671 if (!dev->data->queues[queue_id].started) {
672 rte_bbdev_log_debug("Queue %u of device %u already stopped",
677 if (dev->dev_ops->queue_stop) {
678 int ret = dev->dev_ops->queue_stop(dev, queue_id);
680 rte_bbdev_log(ERR, "Device %u queue %u stop failed",
685 dev->data->queues[queue_id].started = false;
687 rte_bbdev_log_debug("Stopped queue %u of device %u", queue_id, dev_id);
691 /* Get device statistics */
693 get_stats_from_queues(struct rte_bbdev *dev, struct rte_bbdev_stats *stats)
696 for (q_id = 0; q_id < dev->data->num_queues; q_id++) {
697 struct rte_bbdev_stats *q_stats =
698 &dev->data->queues[q_id].queue_stats;
700 stats->enqueued_count += q_stats->enqueued_count;
701 stats->dequeued_count += q_stats->dequeued_count;
702 stats->enqueue_err_count += q_stats->enqueue_err_count;
703 stats->dequeue_err_count += q_stats->dequeue_err_count;
705 rte_bbdev_log_debug("Got stats on %u", dev->data->dev_id);
709 reset_stats_in_queues(struct rte_bbdev *dev)
712 for (q_id = 0; q_id < dev->data->num_queues; q_id++) {
713 struct rte_bbdev_stats *q_stats =
714 &dev->data->queues[q_id].queue_stats;
716 memset(q_stats, 0, sizeof(*q_stats));
718 rte_bbdev_log_debug("Reset stats on %u", dev->data->dev_id);
721 int __rte_experimental
722 rte_bbdev_stats_get(uint16_t dev_id, struct rte_bbdev_stats *stats)
724 struct rte_bbdev *dev = get_dev(dev_id);
725 VALID_DEV_OR_RET_ERR(dev, dev_id);
727 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
730 rte_bbdev_log(ERR, "NULL stats structure");
734 memset(stats, 0, sizeof(*stats));
735 if (dev->dev_ops->stats_get != NULL)
736 dev->dev_ops->stats_get(dev, stats);
738 get_stats_from_queues(dev, stats);
740 rte_bbdev_log_debug("Retrieved stats of device %u", dev_id);
744 int __rte_experimental
745 rte_bbdev_stats_reset(uint16_t dev_id)
747 struct rte_bbdev *dev = get_dev(dev_id);
748 VALID_DEV_OR_RET_ERR(dev, dev_id);
750 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
752 if (dev->dev_ops->stats_reset != NULL)
753 dev->dev_ops->stats_reset(dev);
755 reset_stats_in_queues(dev);
757 rte_bbdev_log_debug("Reset stats of device %u", dev_id);
761 int __rte_experimental
762 rte_bbdev_info_get(uint16_t dev_id, struct rte_bbdev_info *dev_info)
764 struct rte_bbdev *dev = get_dev(dev_id);
765 VALID_DEV_OR_RET_ERR(dev, dev_id);
767 VALID_FUNC_OR_RET_ERR(dev->dev_ops->info_get, dev_id);
769 if (dev_info == NULL) {
770 rte_bbdev_log(ERR, "NULL dev info structure");
774 /* Copy data maintained by device interface layer */
775 memset(dev_info, 0, sizeof(*dev_info));
776 dev_info->dev_name = dev->data->name;
777 dev_info->num_queues = dev->data->num_queues;
778 dev_info->bus = rte_bus_find_by_device(dev->device);
779 dev_info->socket_id = dev->data->socket_id;
780 dev_info->started = dev->data->started;
782 /* Copy data maintained by device driver layer */
783 dev->dev_ops->info_get(dev, &dev_info->drv);
785 rte_bbdev_log_debug("Retrieved info of device %u", dev_id);
789 int __rte_experimental
790 rte_bbdev_queue_info_get(uint16_t dev_id, uint16_t queue_id,
791 struct rte_bbdev_queue_info *queue_info)
793 struct rte_bbdev *dev = get_dev(dev_id);
794 VALID_DEV_OR_RET_ERR(dev, dev_id);
796 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
798 if (queue_info == NULL) {
799 rte_bbdev_log(ERR, "NULL queue info structure");
803 /* Copy data to output */
804 memset(queue_info, 0, sizeof(*queue_info));
805 queue_info->conf = dev->data->queues[queue_id].conf;
806 queue_info->started = dev->data->queues[queue_id].started;
808 rte_bbdev_log_debug("Retrieved info of queue %u of device %u",
813 /* Calculate size needed to store bbdev_op, depending on type */
815 get_bbdev_op_size(enum rte_bbdev_op_type type)
817 unsigned int result = 0;
819 case RTE_BBDEV_OP_NONE:
820 result = RTE_MAX(sizeof(struct rte_bbdev_dec_op),
821 sizeof(struct rte_bbdev_enc_op));
823 case RTE_BBDEV_OP_TURBO_DEC:
824 result = sizeof(struct rte_bbdev_dec_op);
826 case RTE_BBDEV_OP_TURBO_ENC:
827 result = sizeof(struct rte_bbdev_enc_op);
836 /* Initialise a bbdev_op structure */
838 bbdev_op_init(struct rte_mempool *mempool, void *arg, void *element,
839 __rte_unused unsigned int n)
841 enum rte_bbdev_op_type type = *(enum rte_bbdev_op_type *)arg;
843 if (type == RTE_BBDEV_OP_TURBO_DEC) {
844 struct rte_bbdev_dec_op *op = element;
845 memset(op, 0, mempool->elt_size);
846 op->mempool = mempool;
847 } else if (type == RTE_BBDEV_OP_TURBO_ENC) {
848 struct rte_bbdev_enc_op *op = element;
849 memset(op, 0, mempool->elt_size);
850 op->mempool = mempool;
854 struct rte_mempool * __rte_experimental
855 rte_bbdev_op_pool_create(const char *name, enum rte_bbdev_op_type type,
856 unsigned int num_elements, unsigned int cache_size,
859 struct rte_bbdev_op_pool_private *priv;
860 struct rte_mempool *mp;
861 const char *op_type_str;
864 rte_bbdev_log(ERR, "NULL name for op pool");
868 if (type >= RTE_BBDEV_OP_TYPE_COUNT) {
870 "Invalid op type (%u), should be less than %u",
871 type, RTE_BBDEV_OP_TYPE_COUNT);
875 mp = rte_mempool_create(name, num_elements, get_bbdev_op_size(type),
876 cache_size, sizeof(struct rte_bbdev_op_pool_private),
877 NULL, NULL, bbdev_op_init, &type, socket_id, 0);
880 "Failed to create op pool %s (num ops=%u, op size=%u) with error: %s",
881 name, num_elements, get_bbdev_op_size(type),
882 rte_strerror(rte_errno));
886 op_type_str = rte_bbdev_op_type_str(type);
887 if (op_type_str == NULL)
891 "Op pool %s created for %u ops (type=%s, cache=%u, socket=%u, size=%u)",
892 name, num_elements, op_type_str, cache_size, socket_id,
893 get_bbdev_op_size(type));
895 priv = (struct rte_bbdev_op_pool_private *)rte_mempool_get_priv(mp);
901 int __rte_experimental
902 rte_bbdev_callback_register(uint16_t dev_id, enum rte_bbdev_event_type event,
903 rte_bbdev_cb_fn cb_fn, void *cb_arg)
905 struct rte_bbdev_callback *user_cb;
906 struct rte_bbdev *dev = get_dev(dev_id);
907 VALID_DEV_OR_RET_ERR(dev, dev_id);
909 if (event >= RTE_BBDEV_EVENT_MAX) {
911 "Invalid event type (%u), should be less than %u",
912 event, RTE_BBDEV_EVENT_MAX);
917 rte_bbdev_log(ERR, "NULL callback function");
921 rte_spinlock_lock(&rte_bbdev_cb_lock);
923 TAILQ_FOREACH(user_cb, &(dev->list_cbs), next) {
924 if (user_cb->cb_fn == cb_fn &&
925 user_cb->cb_arg == cb_arg &&
926 user_cb->event == event)
930 /* create a new callback. */
931 if (user_cb == NULL) {
932 user_cb = rte_zmalloc("INTR_USER_CALLBACK",
933 sizeof(struct rte_bbdev_callback), 0);
934 if (user_cb != NULL) {
935 user_cb->cb_fn = cb_fn;
936 user_cb->cb_arg = cb_arg;
937 user_cb->event = event;
938 TAILQ_INSERT_TAIL(&(dev->list_cbs), user_cb, next);
942 rte_spinlock_unlock(&rte_bbdev_cb_lock);
943 return (user_cb == NULL) ? -ENOMEM : 0;
946 int __rte_experimental
947 rte_bbdev_callback_unregister(uint16_t dev_id, enum rte_bbdev_event_type event,
948 rte_bbdev_cb_fn cb_fn, void *cb_arg)
951 struct rte_bbdev_callback *cb, *next;
952 struct rte_bbdev *dev = get_dev(dev_id);
953 VALID_DEV_OR_RET_ERR(dev, dev_id);
955 if (event >= RTE_BBDEV_EVENT_MAX) {
957 "Invalid event type (%u), should be less than %u",
958 event, RTE_BBDEV_EVENT_MAX);
964 "NULL callback function cannot be unregistered");
968 dev = &rte_bbdev_devices[dev_id];
969 rte_spinlock_lock(&rte_bbdev_cb_lock);
971 for (cb = TAILQ_FIRST(&dev->list_cbs); cb != NULL; cb = next) {
973 next = TAILQ_NEXT(cb, next);
975 if (cb->cb_fn != cb_fn || cb->event != event ||
976 (cb_arg != (void *)-1 && cb->cb_arg != cb_arg))
979 /* If this callback is not executing right now, remove it. */
980 if (cb->active == 0) {
981 TAILQ_REMOVE(&(dev->list_cbs), cb, next);
987 rte_spinlock_unlock(&rte_bbdev_cb_lock);
991 void __rte_experimental
992 rte_bbdev_pmd_callback_process(struct rte_bbdev *dev,
993 enum rte_bbdev_event_type event, void *ret_param)
995 struct rte_bbdev_callback *cb_lst;
996 struct rte_bbdev_callback dev_cb;
999 rte_bbdev_log(ERR, "NULL device");
1003 if (dev->data == NULL) {
1004 rte_bbdev_log(ERR, "NULL data structure");
1008 if (event >= RTE_BBDEV_EVENT_MAX) {
1010 "Invalid event type (%u), should be less than %u",
1011 event, RTE_BBDEV_EVENT_MAX);
1015 rte_spinlock_lock(&rte_bbdev_cb_lock);
1016 TAILQ_FOREACH(cb_lst, &(dev->list_cbs), next) {
1017 if (cb_lst->cb_fn == NULL || cb_lst->event != event)
1021 if (ret_param != NULL)
1022 dev_cb.ret_param = ret_param;
1024 rte_spinlock_unlock(&rte_bbdev_cb_lock);
1025 dev_cb.cb_fn(dev->data->dev_id, dev_cb.event,
1026 dev_cb.cb_arg, dev_cb.ret_param);
1027 rte_spinlock_lock(&rte_bbdev_cb_lock);
1030 rte_spinlock_unlock(&rte_bbdev_cb_lock);
1033 int __rte_experimental
1034 rte_bbdev_queue_intr_enable(uint16_t dev_id, uint16_t queue_id)
1036 struct rte_bbdev *dev = get_dev(dev_id);
1037 VALID_DEV_OR_RET_ERR(dev, dev_id);
1038 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
1039 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
1040 VALID_FUNC_OR_RET_ERR(dev->dev_ops->queue_intr_enable, dev_id);
1041 return dev->dev_ops->queue_intr_enable(dev, queue_id);
1044 int __rte_experimental
1045 rte_bbdev_queue_intr_disable(uint16_t dev_id, uint16_t queue_id)
1047 struct rte_bbdev *dev = get_dev(dev_id);
1048 VALID_DEV_OR_RET_ERR(dev, dev_id);
1049 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
1050 VALID_DEV_OPS_OR_RET_ERR(dev, dev_id);
1051 VALID_FUNC_OR_RET_ERR(dev->dev_ops->queue_intr_disable, dev_id);
1052 return dev->dev_ops->queue_intr_disable(dev, queue_id);
1055 int __rte_experimental
1056 rte_bbdev_queue_intr_ctl(uint16_t dev_id, uint16_t queue_id, int epfd, int op,
1060 struct rte_bbdev *dev = get_dev(dev_id);
1061 struct rte_intr_handle *intr_handle;
1064 VALID_DEV_OR_RET_ERR(dev, dev_id);
1065 VALID_QUEUE_OR_RET_ERR(queue_id, dev);
1067 intr_handle = dev->intr_handle;
1068 if (!intr_handle || !intr_handle->intr_vec) {
1069 rte_bbdev_log(ERR, "Device %u intr handle unset\n", dev_id);
1073 if (queue_id >= RTE_MAX_RXTX_INTR_VEC_ID) {
1074 rte_bbdev_log(ERR, "Device %u queue_id %u is too big\n",
1079 vec = intr_handle->intr_vec[queue_id];
1080 ret = rte_intr_rx_ctl(intr_handle, epfd, op, vec, data);
1081 if (ret && (ret != -EEXIST)) {
1083 "dev %u q %u int ctl error op %d epfd %d vec %u\n",
1084 dev_id, queue_id, op, epfd, vec);
1092 const char * __rte_experimental
1093 rte_bbdev_op_type_str(enum rte_bbdev_op_type op_type)
1095 static const char * const op_types[] = {
1096 "RTE_BBDEV_OP_NONE",
1097 "RTE_BBDEV_OP_TURBO_DEC",
1098 "RTE_BBDEV_OP_TURBO_ENC",
1101 if (op_type < RTE_BBDEV_OP_TYPE_COUNT)
1102 return op_types[op_type];
1104 rte_bbdev_log(ERR, "Invalid operation type");
1111 RTE_INIT(rte_bbdev_init_log);
1113 rte_bbdev_init_log(void)
1115 bbdev_logtype = rte_log_register("lib.bbdev");
1116 if (bbdev_logtype >= 0)
1117 rte_log_set_level(bbdev_logtype, RTE_LOG_NOTICE);