event/dlb2: add delayed token pop logic
[dpdk.git] / drivers / event / dlb2 / dlb2.c
index a7e9a4c..8672486 100644 (file)
@@ -26,6 +26,7 @@
 #include <rte_log.h>
 #include <rte_malloc.h>
 #include <rte_mbuf.h>
+#include <rte_power_intrinsics.h>
 #include <rte_prefetch.h>
 #include <rte_ring.h>
 #include <rte_string_fns.h>
@@ -70,21 +71,6 @@ static struct rte_event_dev_info evdev_dlb2_default_info = {
 struct process_local_port_data
 dlb2_port[DLB2_MAX_NUM_PORTS][DLB2_NUM_PORT_TYPES];
 
-/*
- * DUMMY - added so that xstats path will compile/link.
- * Will be replaced by real version in a subsequent
- * patch.
- */
-uint32_t
-dlb2_get_queue_depth(struct dlb2_eventdev *dlb2,
-                    struct dlb2_eventdev_queue *queue)
-{
-       RTE_SET_USED(dlb2);
-       RTE_SET_USED(queue);
-
-       return 0;
-}
-
 static void
 dlb2_free_qe_mem(struct dlb2_port *qm_port)
 {
@@ -1096,6 +1082,25 @@ error_exit:
        return ret;
 }
 
+static inline uint16_t
+dlb2_event_enqueue_delayed(void *event_port,
+                          const struct rte_event events[]);
+
+static inline uint16_t
+dlb2_event_enqueue_burst_delayed(void *event_port,
+                                const struct rte_event events[],
+                                uint16_t num);
+
+static inline uint16_t
+dlb2_event_enqueue_new_burst_delayed(void *event_port,
+                                    const struct rte_event events[],
+                                    uint16_t num);
+
+static inline uint16_t
+dlb2_event_enqueue_forward_burst_delayed(void *event_port,
+                                        const struct rte_event events[],
+                                        uint16_t num);
+
 static int
 dlb2_hw_create_ldb_port(struct dlb2_eventdev *dlb2,
                        struct dlb2_eventdev_port *ev_port,
@@ -1211,6 +1216,20 @@ dlb2_hw_create_ldb_port(struct dlb2_eventdev *dlb2,
        qm_port->qid_mappings = &dlb2->qm_ldb_to_ev_queue_id[0];
 
        qm_port->dequeue_depth = dequeue_depth;
+       qm_port->token_pop_thresh = dequeue_depth;
+
+       /* The default enqueue functions do not include delayed-pop support for
+        * performance reasons.
+        */
+       if (qm_port->token_pop_mode == DELAYED_POP) {
+               dlb2->event_dev->enqueue = dlb2_event_enqueue_delayed;
+               dlb2->event_dev->enqueue_burst =
+                       dlb2_event_enqueue_burst_delayed;
+               dlb2->event_dev->enqueue_new_burst =
+                       dlb2_event_enqueue_new_burst_delayed;
+               dlb2->event_dev->enqueue_forward_burst =
+                       dlb2_event_enqueue_forward_burst_delayed;
+       }
 
        qm_port->owed_tokens = 0;
        qm_port->issued_releases = 0;
@@ -1379,6 +1398,8 @@ dlb2_hw_create_dir_port(struct dlb2_eventdev *dlb2,
 
        qm_port->dequeue_depth = dequeue_depth;
 
+       /* Directed ports are auto-pop, by default. */
+       qm_port->token_pop_mode = AUTO_POP;
        qm_port->owed_tokens = 0;
        qm_port->issued_releases = 0;
 
@@ -1797,84 +1818,2082 @@ dlb2_eventdev_port_link(struct rte_eventdev *dev, void *event_port,
        return i;
 }
 
-static void
-dlb2_entry_points_init(struct rte_eventdev *dev)
+static int16_t
+dlb2_hw_unmap_ldb_qid_from_port(struct dlb2_hw_dev *handle,
+                               uint32_t qm_port_id,
+                               uint16_t qm_qid)
 {
-       /* Expose PMD's eventdev interface */
-       static struct rte_eventdev_ops dlb2_eventdev_entry_ops = {
-               .dev_infos_get    = dlb2_eventdev_info_get,
-               .dev_configure    = dlb2_eventdev_configure,
-               .queue_def_conf   = dlb2_eventdev_queue_default_conf_get,
-               .queue_setup      = dlb2_eventdev_queue_setup,
-               .port_def_conf    = dlb2_eventdev_port_default_conf_get,
-               .port_setup       = dlb2_eventdev_port_setup,
-               .port_link        = dlb2_eventdev_port_link,
-               .dump             = dlb2_eventdev_dump,
-               .xstats_get       = dlb2_eventdev_xstats_get,
-               .xstats_get_names = dlb2_eventdev_xstats_get_names,
-               .xstats_get_by_name = dlb2_eventdev_xstats_get_by_name,
-               .xstats_reset       = dlb2_eventdev_xstats_reset,
-       };
+       struct dlb2_unmap_qid_args cfg;
+       int32_t ret;
 
-       dev->dev_ops = &dlb2_eventdev_entry_ops;
+       if (handle == NULL)
+               return -EINVAL;
+
+       cfg.port_id = qm_port_id;
+       cfg.qid = qm_qid;
+
+       ret = dlb2_iface_unmap_qid(handle, &cfg);
+       if (ret < 0)
+               DLB2_LOG_ERR("dlb2: unmap qid error, ret=%d (driver status: %s)\n",
+                            ret, dlb2_error_strings[cfg.response.status]);
+
+       return ret;
 }
 
-int
-dlb2_primary_eventdev_probe(struct rte_eventdev *dev,
-                           const char *name,
-                           struct dlb2_devargs *dlb2_args)
+static int
+dlb2_event_queue_detach_ldb(struct dlb2_eventdev *dlb2,
+                           struct dlb2_eventdev_port *ev_port,
+                           struct dlb2_eventdev_queue *ev_queue)
+{
+       int ret, i;
+
+       /* Don't unlink until start time. */
+       if (dlb2->run_state == DLB2_RUN_STATE_STOPPED)
+               return 0;
+
+       for (i = 0; i < DLB2_MAX_NUM_QIDS_PER_LDB_CQ; i++) {
+               if (ev_port->link[i].valid &&
+                   ev_port->link[i].queue_id == ev_queue->id)
+                       break; /* found */
+       }
+
+       /* This is expected with eventdev API!
+        * It blindly attemmpts to unmap all queues.
+        */
+       if (i == DLB2_MAX_NUM_QIDS_PER_LDB_CQ) {
+               DLB2_LOG_DBG("dlb2: ignoring LB QID %d not mapped for qm_port %d.\n",
+                            ev_queue->qm_queue.id,
+                            ev_port->qm_port.id);
+               return 0;
+       }
+
+       ret = dlb2_hw_unmap_ldb_qid_from_port(&dlb2->qm_instance,
+                                             ev_port->qm_port.id,
+                                             ev_queue->qm_queue.id);
+       if (!ret)
+               ev_port->link[i].mapped = false;
+
+       return ret;
+}
+
+static int
+dlb2_eventdev_port_unlink(struct rte_eventdev *dev, void *event_port,
+                         uint8_t queues[], uint16_t nb_unlinks)
 {
+       struct dlb2_eventdev_port *ev_port = event_port;
        struct dlb2_eventdev *dlb2;
-       int err;
+       int i;
 
-       dlb2 = dev->data->dev_private;
+       RTE_SET_USED(dev);
 
-       dlb2->event_dev = dev; /* backlink */
+       if (!ev_port->setup_done) {
+               DLB2_LOG_ERR("dlb2: evport %d is not configured\n",
+                            ev_port->id);
+               rte_errno = -EINVAL;
+               return 0;
+       }
 
-       evdev_dlb2_default_info.driver_name = name;
+       if (queues == NULL || nb_unlinks == 0) {
+               DLB2_LOG_DBG("dlb2: queues is NULL or nb_unlinks is 0\n");
+               return 0; /* Ignore and return success */
+       }
 
-       dlb2->max_num_events_override = dlb2_args->max_num_events;
-       dlb2->num_dir_credits_override = dlb2_args->num_dir_credits_override;
-       dlb2->qm_instance.cos_id = dlb2_args->cos_id;
+       if (ev_port->qm_port.is_directed) {
+               DLB2_LOG_DBG("dlb2: ignore unlink from dir port %d\n",
+                            ev_port->id);
+               rte_errno = 0;
+               return nb_unlinks; /* as if success */
+       }
 
-       err = dlb2_iface_open(&dlb2->qm_instance, name);
-       if (err < 0) {
-               DLB2_LOG_ERR("could not open event hardware device, err=%d\n",
-                            err);
-               return err;
+       dlb2 = ev_port->dlb2;
+
+       for (i = 0; i < nb_unlinks; i++) {
+               struct dlb2_eventdev_queue *ev_queue;
+               int ret, j;
+
+               if (queues[i] >= dlb2->num_queues) {
+                       DLB2_LOG_ERR("dlb2: invalid queue id %d\n", queues[i]);
+                       rte_errno = -EINVAL;
+                       return i; /* return index of offending queue */
+               }
+
+               ev_queue = &dlb2->ev_queues[queues[i]];
+
+               /* Does a link exist? */
+               for (j = 0; j < DLB2_MAX_NUM_QIDS_PER_LDB_CQ; j++)
+                       if (ev_port->link[j].queue_id == queues[i] &&
+                           ev_port->link[j].valid)
+                               break;
+
+               if (j == DLB2_MAX_NUM_QIDS_PER_LDB_CQ)
+                       continue;
+
+               ret = dlb2_event_queue_detach_ldb(dlb2, ev_port, ev_queue);
+               if (ret) {
+                       DLB2_LOG_ERR("unlink err=%d for port %d queue %d\n",
+                                    ret, ev_port->id, queues[i]);
+                       rte_errno = -ENOENT;
+                       return i; /* return index of offending queue */
+               }
+
+               ev_port->link[j].valid = false;
+               ev_port->num_links--;
+               ev_queue->num_links--;
        }
 
-       err = dlb2_iface_get_device_version(&dlb2->qm_instance,
-                                           &dlb2->revision);
-       if (err < 0) {
-               DLB2_LOG_ERR("dlb2: failed to get the device version, err=%d\n",
-                            err);
-               return err;
+       return nb_unlinks;
+}
+
+static int
+dlb2_eventdev_port_unlinks_in_progress(struct rte_eventdev *dev,
+                                      void *event_port)
+{
+       struct dlb2_eventdev_port *ev_port = event_port;
+       struct dlb2_eventdev *dlb2;
+       struct dlb2_hw_dev *handle;
+       struct dlb2_pending_port_unmaps_args cfg;
+       int ret;
+
+       RTE_SET_USED(dev);
+
+       if (!ev_port->setup_done) {
+               DLB2_LOG_ERR("dlb2: evport %d is not configured\n",
+                            ev_port->id);
+               rte_errno = -EINVAL;
+               return 0;
        }
 
-       err = dlb2_hw_query_resources(dlb2);
-       if (err) {
-               DLB2_LOG_ERR("get resources err=%d for %s\n",
-                            err, name);
-               return err;
+       cfg.port_id = ev_port->qm_port.id;
+       dlb2 = ev_port->dlb2;
+       handle = &dlb2->qm_instance;
+       ret = dlb2_iface_pending_port_unmaps(handle, &cfg);
+
+       if (ret < 0) {
+               DLB2_LOG_ERR("dlb2: num_unlinks_in_progress ret=%d (driver status: %s)\n",
+                            ret, dlb2_error_strings[cfg.response.status]);
+               return ret;
        }
 
-       dlb2_iface_hardware_init(&dlb2->qm_instance);
+       return cfg.response.id;
+}
 
-       err = dlb2_iface_get_cq_poll_mode(&dlb2->qm_instance, &dlb2->poll_mode);
-       if (err < 0) {
-               DLB2_LOG_ERR("dlb2: failed to get the poll mode, err=%d\n",
-                            err);
-               return err;
+static int
+dlb2_eventdev_reapply_configuration(struct rte_eventdev *dev)
+{
+       struct dlb2_eventdev *dlb2 = dlb2_pmd_priv(dev);
+       int ret, i;
+
+       /* If an event queue or port was previously configured, but hasn't been
+        * reconfigured, reapply its original configuration.
+        */
+       for (i = 0; i < dlb2->num_queues; i++) {
+               struct dlb2_eventdev_queue *ev_queue;
+
+               ev_queue = &dlb2->ev_queues[i];
+
+               if (ev_queue->qm_queue.config_state != DLB2_PREV_CONFIGURED)
+                       continue;
+
+               ret = dlb2_eventdev_queue_setup(dev, i, &ev_queue->conf);
+               if (ret < 0) {
+                       DLB2_LOG_ERR("dlb2: failed to reconfigure queue %d", i);
+                       return ret;
+               }
        }
 
-       /* Complete xtstats runtime initialization */
-       err = dlb2_xstats_init(dlb2);
-       if (err) {
-               DLB2_LOG_ERR("dlb2: failed to init xstats, err=%d\n", err);
-               return err;
+       for (i = 0; i < dlb2->num_ports; i++) {
+               struct dlb2_eventdev_port *ev_port = &dlb2->ev_ports[i];
+
+               if (ev_port->qm_port.config_state != DLB2_PREV_CONFIGURED)
+                       continue;
+
+               ret = dlb2_eventdev_port_setup(dev, i, &ev_port->conf);
+               if (ret < 0) {
+                       DLB2_LOG_ERR("dlb2: failed to reconfigure ev_port %d",
+                                    i);
+                       return ret;
+               }
+       }
+
+       return 0;
+}
+
+static int
+dlb2_eventdev_apply_port_links(struct rte_eventdev *dev)
+{
+       struct dlb2_eventdev *dlb2 = dlb2_pmd_priv(dev);
+       int i;
+
+       /* Perform requested port->queue links */
+       for (i = 0; i < dlb2->num_ports; i++) {
+               struct dlb2_eventdev_port *ev_port = &dlb2->ev_ports[i];
+               int j;
+
+               for (j = 0; j < DLB2_MAX_NUM_QIDS_PER_LDB_CQ; j++) {
+                       struct dlb2_eventdev_queue *ev_queue;
+                       uint8_t prio, queue_id;
+
+                       if (!ev_port->link[j].valid)
+                               continue;
+
+                       prio = ev_port->link[j].priority;
+                       queue_id = ev_port->link[j].queue_id;
+
+                       if (dlb2_validate_port_link(ev_port, queue_id, true, j))
+                               return -EINVAL;
+
+                       ev_queue = &dlb2->ev_queues[queue_id];
+
+                       if (dlb2_do_port_link(dev, ev_queue, ev_port, prio))
+                               return -EINVAL;
+               }
+       }
+
+       return 0;
+}
+
+static int
+dlb2_eventdev_start(struct rte_eventdev *dev)
+{
+       struct dlb2_eventdev *dlb2 = dlb2_pmd_priv(dev);
+       struct dlb2_hw_dev *handle = &dlb2->qm_instance;
+       struct dlb2_start_domain_args cfg;
+       int ret, i;
+
+       rte_spinlock_lock(&dlb2->qm_instance.resource_lock);
+       if (dlb2->run_state != DLB2_RUN_STATE_STOPPED) {
+               DLB2_LOG_ERR("bad state %d for dev_start\n",
+                            (int)dlb2->run_state);
+               rte_spinlock_unlock(&dlb2->qm_instance.resource_lock);
+               return -EINVAL;
+       }
+       dlb2->run_state = DLB2_RUN_STATE_STARTING;
+       rte_spinlock_unlock(&dlb2->qm_instance.resource_lock);
+
+       /* If the device was configured more than once, some event ports and/or
+        * queues may need to be reconfigured.
+        */
+       ret = dlb2_eventdev_reapply_configuration(dev);
+       if (ret)
+               return ret;
+
+       /* The DLB PMD delays port links until the device is started. */
+       ret = dlb2_eventdev_apply_port_links(dev);
+       if (ret)
+               return ret;
+
+       for (i = 0; i < dlb2->num_ports; i++) {
+               if (!dlb2->ev_ports[i].setup_done) {
+                       DLB2_LOG_ERR("dlb2: port %d not setup", i);
+                       return -ESTALE;
+               }
+       }
+
+       for (i = 0; i < dlb2->num_queues; i++) {
+               if (dlb2->ev_queues[i].num_links == 0) {
+                       DLB2_LOG_ERR("dlb2: queue %d is not linked", i);
+                       return -ENOLINK;
+               }
+       }
+
+       ret = dlb2_iface_sched_domain_start(handle, &cfg);
+       if (ret < 0) {
+               DLB2_LOG_ERR("dlb2: sched_domain_start ret=%d (driver status: %s)\n",
+                            ret, dlb2_error_strings[cfg.response.status]);
+               return ret;
+       }
+
+       dlb2->run_state = DLB2_RUN_STATE_STARTED;
+       DLB2_LOG_DBG("dlb2: sched_domain_start completed OK\n");
+
+       return 0;
+}
+
+static uint8_t cmd_byte_map[DLB2_NUM_PORT_TYPES][DLB2_NUM_HW_SCHED_TYPES] = {
+       {
+               /* Load-balanced cmd bytes */
+               [RTE_EVENT_OP_NEW] = DLB2_NEW_CMD_BYTE,
+               [RTE_EVENT_OP_FORWARD] = DLB2_FWD_CMD_BYTE,
+               [RTE_EVENT_OP_RELEASE] = DLB2_COMP_CMD_BYTE,
+       },
+       {
+               /* Directed cmd bytes */
+               [RTE_EVENT_OP_NEW] = DLB2_NEW_CMD_BYTE,
+               [RTE_EVENT_OP_FORWARD] = DLB2_NEW_CMD_BYTE,
+               [RTE_EVENT_OP_RELEASE] = DLB2_NOOP_CMD_BYTE,
+       },
+};
+
+static inline uint32_t
+dlb2_port_credits_get(struct dlb2_port *qm_port,
+                     enum dlb2_hw_queue_types type)
+{
+       uint32_t credits = *qm_port->credit_pool[type];
+       uint32_t batch_size = DLB2_SW_CREDIT_BATCH_SZ;
+
+       if (unlikely(credits < batch_size))
+               batch_size = credits;
+
+       if (likely(credits &&
+                  __atomic_compare_exchange_n(
+                       qm_port->credit_pool[type],
+                       &credits, credits - batch_size, false,
+                       __ATOMIC_SEQ_CST, __ATOMIC_SEQ_CST)))
+               return batch_size;
+       else
+               return 0;
+}
+
+static inline void
+dlb2_replenish_sw_credits(struct dlb2_eventdev *dlb2,
+                         struct dlb2_eventdev_port *ev_port)
+{
+       uint16_t quanta = ev_port->credit_update_quanta;
+
+       if (ev_port->inflight_credits >= quanta * 2) {
+               /* Replenish credits, saving one quanta for enqueues */
+               uint16_t val = ev_port->inflight_credits - quanta;
+
+               __atomic_fetch_sub(&dlb2->inflights, val, __ATOMIC_SEQ_CST);
+               ev_port->inflight_credits -= val;
+       }
+}
+
+static inline int
+dlb2_check_enqueue_sw_credits(struct dlb2_eventdev *dlb2,
+                             struct dlb2_eventdev_port *ev_port)
+{
+       uint32_t sw_inflights = __atomic_load_n(&dlb2->inflights,
+                                               __ATOMIC_SEQ_CST);
+       const int num = 1;
+
+       if (unlikely(ev_port->inflight_max < sw_inflights)) {
+               DLB2_INC_STAT(ev_port->stats.traffic.tx_nospc_inflight_max, 1);
+               rte_errno = -ENOSPC;
+               return 1;
        }
 
+       if (ev_port->inflight_credits < num) {
+               /* check if event enqueue brings ev_port over max threshold */
+               uint32_t credit_update_quanta = ev_port->credit_update_quanta;
+
+               if (sw_inflights + credit_update_quanta >
+                               dlb2->new_event_limit) {
+                       DLB2_INC_STAT(
+                       ev_port->stats.traffic.tx_nospc_new_event_limit,
+                       1);
+                       rte_errno = -ENOSPC;
+                       return 1;
+               }
+
+               __atomic_fetch_add(&dlb2->inflights, credit_update_quanta,
+                                  __ATOMIC_SEQ_CST);
+               ev_port->inflight_credits += (credit_update_quanta);
+
+               if (ev_port->inflight_credits < num) {
+                       DLB2_INC_STAT(
+                       ev_port->stats.traffic.tx_nospc_inflight_credits,
+                       1);
+                       rte_errno = -ENOSPC;
+                       return 1;
+               }
+       }
+
+       return 0;
+}
+
+static inline int
+dlb2_check_enqueue_hw_ldb_credits(struct dlb2_port *qm_port)
+{
+       if (unlikely(qm_port->cached_ldb_credits == 0)) {
+               qm_port->cached_ldb_credits =
+                       dlb2_port_credits_get(qm_port,
+                                             DLB2_LDB_QUEUE);
+               if (unlikely(qm_port->cached_ldb_credits == 0)) {
+                       DLB2_INC_STAT(
+                       qm_port->ev_port->stats.traffic.tx_nospc_ldb_hw_credits,
+                       1);
+                       DLB2_LOG_DBG("ldb credits exhausted\n");
+                       return 1; /* credits exhausted */
+               }
+       }
+
+       return 0;
+}
+
+static inline int
+dlb2_check_enqueue_hw_dir_credits(struct dlb2_port *qm_port)
+{
+       if (unlikely(qm_port->cached_dir_credits == 0)) {
+               qm_port->cached_dir_credits =
+                       dlb2_port_credits_get(qm_port,
+                                             DLB2_DIR_QUEUE);
+               if (unlikely(qm_port->cached_dir_credits == 0)) {
+                       DLB2_INC_STAT(
+                       qm_port->ev_port->stats.traffic.tx_nospc_dir_hw_credits,
+                       1);
+                       DLB2_LOG_DBG("dir credits exhausted\n");
+                       return 1; /* credits exhausted */
+               }
+       }
+
+       return 0;
+}
+
+static __rte_always_inline void
+dlb2_pp_write(struct dlb2_enqueue_qe *qe4,
+             struct process_local_port_data *port_data)
+{
+       dlb2_movdir64b(port_data->pp_addr, qe4);
+}
+
+static inline int
+dlb2_consume_qe_immediate(struct dlb2_port *qm_port, int num)
+{
+       struct process_local_port_data *port_data;
+       struct dlb2_cq_pop_qe *qe;
+
+       RTE_ASSERT(qm_port->config_state == DLB2_CONFIGURED);
+
+       qe = qm_port->consume_qe;
+
+       qe->tokens = num - 1;
+
+       /* No store fence needed since no pointer is being sent, and CQ token
+        * pops can be safely reordered with other HCWs.
+        */
+       port_data = &dlb2_port[qm_port->id][PORT_TYPE(qm_port)];
+
+       dlb2_movntdq_single(port_data->pp_addr, qe);
+
+       DLB2_LOG_DBG("dlb2: consume immediate - %d QEs\n", num);
+
+       qm_port->owed_tokens = 0;
+
+       return 0;
+}
+
+static inline void
+dlb2_hw_do_enqueue(struct dlb2_port *qm_port,
+                  bool do_sfence,
+                  struct process_local_port_data *port_data)
+{
+       /* Since MOVDIR64B is weakly-ordered, use an SFENCE to ensure that
+        * application writes complete before enqueueing the QE.
+        */
+       if (do_sfence)
+               rte_wmb();
+
+       dlb2_pp_write(qm_port->qe4, port_data);
+}
+
+static inline void
+dlb2_construct_token_pop_qe(struct dlb2_port *qm_port, int idx)
+{
+       struct dlb2_cq_pop_qe *qe = (void *)qm_port->qe4;
+       int num = qm_port->owed_tokens;
+
+       qe[idx].cmd_byte = DLB2_POP_CMD_BYTE;
+       qe[idx].tokens = num - 1;
+
+       qm_port->owed_tokens = 0;
+}
+
+static inline void
+dlb2_event_build_hcws(struct dlb2_port *qm_port,
+                     const struct rte_event ev[],
+                     int num,
+                     uint8_t *sched_type,
+                     uint8_t *queue_id)
+{
+       struct dlb2_enqueue_qe *qe;
+       uint16_t sched_word[4];
+       __m128i sse_qe[2];
+       int i;
+
+       qe = qm_port->qe4;
+
+       sse_qe[0] = _mm_setzero_si128();
+       sse_qe[1] = _mm_setzero_si128();
+
+       switch (num) {
+       case 4:
+               /* Construct the metadata portion of two HCWs in one 128b SSE
+                * register. HCW metadata is constructed in the SSE registers
+                * like so:
+                * sse_qe[0][63:0]:   qe[0]'s metadata
+                * sse_qe[0][127:64]: qe[1]'s metadata
+                * sse_qe[1][63:0]:   qe[2]'s metadata
+                * sse_qe[1][127:64]: qe[3]'s metadata
+                */
+
+               /* Convert the event operation into a command byte and store it
+                * in the metadata:
+                * sse_qe[0][63:56]   = cmd_byte_map[is_directed][ev[0].op]
+                * sse_qe[0][127:120] = cmd_byte_map[is_directed][ev[1].op]
+                * sse_qe[1][63:56]   = cmd_byte_map[is_directed][ev[2].op]
+                * sse_qe[1][127:120] = cmd_byte_map[is_directed][ev[3].op]
+                */
+#define DLB2_QE_CMD_BYTE 7
+               sse_qe[0] = _mm_insert_epi8(sse_qe[0],
+                               cmd_byte_map[qm_port->is_directed][ev[0].op],
+                               DLB2_QE_CMD_BYTE);
+               sse_qe[0] = _mm_insert_epi8(sse_qe[0],
+                               cmd_byte_map[qm_port->is_directed][ev[1].op],
+                               DLB2_QE_CMD_BYTE + 8);
+               sse_qe[1] = _mm_insert_epi8(sse_qe[1],
+                               cmd_byte_map[qm_port->is_directed][ev[2].op],
+                               DLB2_QE_CMD_BYTE);
+               sse_qe[1] = _mm_insert_epi8(sse_qe[1],
+                               cmd_byte_map[qm_port->is_directed][ev[3].op],
+                               DLB2_QE_CMD_BYTE + 8);
+
+               /* Store priority, scheduling type, and queue ID in the sched
+                * word array because these values are re-used when the
+                * destination is a directed queue.
+                */
+               sched_word[0] = EV_TO_DLB2_PRIO(ev[0].priority) << 10 |
+                               sched_type[0] << 8 |
+                               queue_id[0];
+               sched_word[1] = EV_TO_DLB2_PRIO(ev[1].priority) << 10 |
+                               sched_type[1] << 8 |
+                               queue_id[1];
+               sched_word[2] = EV_TO_DLB2_PRIO(ev[2].priority) << 10 |
+                               sched_type[2] << 8 |
+                               queue_id[2];
+               sched_word[3] = EV_TO_DLB2_PRIO(ev[3].priority) << 10 |
+                               sched_type[3] << 8 |
+                               queue_id[3];
+
+               /* Store the event priority, scheduling type, and queue ID in
+                * the metadata:
+                * sse_qe[0][31:16] = sched_word[0]
+                * sse_qe[0][95:80] = sched_word[1]
+                * sse_qe[1][31:16] = sched_word[2]
+                * sse_qe[1][95:80] = sched_word[3]
+                */
+#define DLB2_QE_QID_SCHED_WORD 1
+               sse_qe[0] = _mm_insert_epi16(sse_qe[0],
+                                            sched_word[0],
+                                            DLB2_QE_QID_SCHED_WORD);
+               sse_qe[0] = _mm_insert_epi16(sse_qe[0],
+                                            sched_word[1],
+                                            DLB2_QE_QID_SCHED_WORD + 4);
+               sse_qe[1] = _mm_insert_epi16(sse_qe[1],
+                                            sched_word[2],
+                                            DLB2_QE_QID_SCHED_WORD);
+               sse_qe[1] = _mm_insert_epi16(sse_qe[1],
+                                            sched_word[3],
+                                            DLB2_QE_QID_SCHED_WORD + 4);
+
+               /* If the destination is a load-balanced queue, store the lock
+                * ID. If it is a directed queue, DLB places this field in
+                * bytes 10-11 of the received QE, so we format it accordingly:
+                * sse_qe[0][47:32]  = dir queue ? sched_word[0] : flow_id[0]
+                * sse_qe[0][111:96] = dir queue ? sched_word[1] : flow_id[1]
+                * sse_qe[1][47:32]  = dir queue ? sched_word[2] : flow_id[2]
+                * sse_qe[1][111:96] = dir queue ? sched_word[3] : flow_id[3]
+                */
+#define DLB2_QE_LOCK_ID_WORD 2
+               sse_qe[0] = _mm_insert_epi16(sse_qe[0],
+                               (sched_type[0] == DLB2_SCHED_DIRECTED) ?
+                                       sched_word[0] : ev[0].flow_id,
+                               DLB2_QE_LOCK_ID_WORD);
+               sse_qe[0] = _mm_insert_epi16(sse_qe[0],
+                               (sched_type[1] == DLB2_SCHED_DIRECTED) ?
+                                       sched_word[1] : ev[1].flow_id,
+                               DLB2_QE_LOCK_ID_WORD + 4);
+               sse_qe[1] = _mm_insert_epi16(sse_qe[1],
+                               (sched_type[2] == DLB2_SCHED_DIRECTED) ?
+                                       sched_word[2] : ev[2].flow_id,
+                               DLB2_QE_LOCK_ID_WORD);
+               sse_qe[1] = _mm_insert_epi16(sse_qe[1],
+                               (sched_type[3] == DLB2_SCHED_DIRECTED) ?
+                                       sched_word[3] : ev[3].flow_id,
+                               DLB2_QE_LOCK_ID_WORD + 4);
+
+               /* Store the event type and sub event type in the metadata:
+                * sse_qe[0][15:0]  = flow_id[0]
+                * sse_qe[0][79:64] = flow_id[1]
+                * sse_qe[1][15:0]  = flow_id[2]
+                * sse_qe[1][79:64] = flow_id[3]
+                */
+#define DLB2_QE_EV_TYPE_WORD 0
+               sse_qe[0] = _mm_insert_epi16(sse_qe[0],
+                                            ev[0].sub_event_type << 8 |
+                                               ev[0].event_type,
+                                            DLB2_QE_EV_TYPE_WORD);
+               sse_qe[0] = _mm_insert_epi16(sse_qe[0],
+                                            ev[1].sub_event_type << 8 |
+                                               ev[1].event_type,
+                                            DLB2_QE_EV_TYPE_WORD + 4);
+               sse_qe[1] = _mm_insert_epi16(sse_qe[1],
+                                            ev[2].sub_event_type << 8 |
+                                               ev[2].event_type,
+                                            DLB2_QE_EV_TYPE_WORD);
+               sse_qe[1] = _mm_insert_epi16(sse_qe[1],
+                                            ev[3].sub_event_type << 8 |
+                                               ev[3].event_type,
+                                            DLB2_QE_EV_TYPE_WORD + 4);
+
+               /* Store the metadata to memory (use the double-precision
+                * _mm_storeh_pd because there is no integer function for
+                * storing the upper 64b):
+                * qe[0] metadata = sse_qe[0][63:0]
+                * qe[1] metadata = sse_qe[0][127:64]
+                * qe[2] metadata = sse_qe[1][63:0]
+                * qe[3] metadata = sse_qe[1][127:64]
+                */
+               _mm_storel_epi64((__m128i *)&qe[0].u.opaque_data, sse_qe[0]);
+               _mm_storeh_pd((double *)&qe[1].u.opaque_data,
+                             (__m128d)sse_qe[0]);
+               _mm_storel_epi64((__m128i *)&qe[2].u.opaque_data, sse_qe[1]);
+               _mm_storeh_pd((double *)&qe[3].u.opaque_data,
+                             (__m128d)sse_qe[1]);
+
+               qe[0].data = ev[0].u64;
+               qe[1].data = ev[1].u64;
+               qe[2].data = ev[2].u64;
+               qe[3].data = ev[3].u64;
+
+               break;
+       case 3:
+       case 2:
+       case 1:
+               for (i = 0; i < num; i++) {
+                       qe[i].cmd_byte =
+                               cmd_byte_map[qm_port->is_directed][ev[i].op];
+                       qe[i].sched_type = sched_type[i];
+                       qe[i].data = ev[i].u64;
+                       qe[i].qid = queue_id[i];
+                       qe[i].priority = EV_TO_DLB2_PRIO(ev[i].priority);
+                       qe[i].lock_id = ev[i].flow_id;
+                       if (sched_type[i] == DLB2_SCHED_DIRECTED) {
+                               struct dlb2_msg_info *info =
+                                       (struct dlb2_msg_info *)&qe[i].lock_id;
+
+                               info->qid = queue_id[i];
+                               info->sched_type = DLB2_SCHED_DIRECTED;
+                               info->priority = qe[i].priority;
+                       }
+                       qe[i].u.event_type.major = ev[i].event_type;
+                       qe[i].u.event_type.sub = ev[i].sub_event_type;
+               }
+               break;
+       case 0:
+               break;
+       }
+}
+
+static inline int
+dlb2_event_enqueue_prep(struct dlb2_eventdev_port *ev_port,
+                       struct dlb2_port *qm_port,
+                       const struct rte_event ev[],
+                       uint8_t *sched_type,
+                       uint8_t *queue_id)
+{
+       struct dlb2_eventdev *dlb2 = ev_port->dlb2;
+       struct dlb2_eventdev_queue *ev_queue;
+       uint16_t *cached_credits = NULL;
+       struct dlb2_queue *qm_queue;
+
+       ev_queue = &dlb2->ev_queues[ev->queue_id];
+       qm_queue = &ev_queue->qm_queue;
+       *queue_id = qm_queue->id;
+
+       /* Ignore sched_type and hardware credits on release events */
+       if (ev->op == RTE_EVENT_OP_RELEASE)
+               goto op_check;
+
+       if (!qm_queue->is_directed) {
+               /* Load balanced destination queue */
+
+               if (dlb2_check_enqueue_hw_ldb_credits(qm_port)) {
+                       rte_errno = -ENOSPC;
+                       return 1;
+               }
+               cached_credits = &qm_port->cached_ldb_credits;
+
+               switch (ev->sched_type) {
+               case RTE_SCHED_TYPE_ORDERED:
+                       DLB2_LOG_DBG("dlb2: put_qe: RTE_SCHED_TYPE_ORDERED\n");
+                       if (qm_queue->sched_type != RTE_SCHED_TYPE_ORDERED) {
+                               DLB2_LOG_ERR("dlb2: tried to send ordered event to unordered queue %d\n",
+                                            *queue_id);
+                               rte_errno = -EINVAL;
+                               return 1;
+                       }
+                       *sched_type = DLB2_SCHED_ORDERED;
+                       break;
+               case RTE_SCHED_TYPE_ATOMIC:
+                       DLB2_LOG_DBG("dlb2: put_qe: RTE_SCHED_TYPE_ATOMIC\n");
+                       *sched_type = DLB2_SCHED_ATOMIC;
+                       break;
+               case RTE_SCHED_TYPE_PARALLEL:
+                       DLB2_LOG_DBG("dlb2: put_qe: RTE_SCHED_TYPE_PARALLEL\n");
+                       if (qm_queue->sched_type == RTE_SCHED_TYPE_ORDERED)
+                               *sched_type = DLB2_SCHED_ORDERED;
+                       else
+                               *sched_type = DLB2_SCHED_UNORDERED;
+                       break;
+               default:
+                       DLB2_LOG_ERR("Unsupported LDB sched type in put_qe\n");
+                       DLB2_INC_STAT(ev_port->stats.tx_invalid, 1);
+                       rte_errno = -EINVAL;
+                       return 1;
+               }
+       } else {
+               /* Directed destination queue */
+
+               if (dlb2_check_enqueue_hw_dir_credits(qm_port)) {
+                       rte_errno = -ENOSPC;
+                       return 1;
+               }
+               cached_credits = &qm_port->cached_dir_credits;
+
+               DLB2_LOG_DBG("dlb2: put_qe: RTE_SCHED_TYPE_DIRECTED\n");
+
+               *sched_type = DLB2_SCHED_DIRECTED;
+       }
+
+op_check:
+       switch (ev->op) {
+       case RTE_EVENT_OP_NEW:
+               /* Check that a sw credit is available */
+               if (dlb2_check_enqueue_sw_credits(dlb2, ev_port)) {
+                       rte_errno = -ENOSPC;
+                       return 1;
+               }
+               ev_port->inflight_credits--;
+               (*cached_credits)--;
+               break;
+       case RTE_EVENT_OP_FORWARD:
+               /* Check for outstanding_releases underflow. If this occurs,
+                * the application is not using the EVENT_OPs correctly; for
+                * example, forwarding or releasing events that were not
+                * dequeued.
+                */
+               RTE_ASSERT(ev_port->outstanding_releases > 0);
+               ev_port->outstanding_releases--;
+               qm_port->issued_releases++;
+               (*cached_credits)--;
+               break;
+       case RTE_EVENT_OP_RELEASE:
+               ev_port->inflight_credits++;
+               /* Check for outstanding_releases underflow. If this occurs,
+                * the application is not using the EVENT_OPs correctly; for
+                * example, forwarding or releasing events that were not
+                * dequeued.
+                */
+               RTE_ASSERT(ev_port->outstanding_releases > 0);
+               ev_port->outstanding_releases--;
+               qm_port->issued_releases++;
+
+               /* Replenish s/w credits if enough are cached */
+               dlb2_replenish_sw_credits(dlb2, ev_port);
+               break;
+       }
+
+       DLB2_INC_STAT(ev_port->stats.tx_op_cnt[ev->op], 1);
+       DLB2_INC_STAT(ev_port->stats.traffic.tx_ok, 1);
+
+#ifndef RTE_LIBRTE_PMD_DLB2_QUELL_STATS
+       if (ev->op != RTE_EVENT_OP_RELEASE) {
+               DLB2_INC_STAT(ev_port->stats.queue[ev->queue_id].enq_ok, 1);
+               DLB2_INC_STAT(ev_port->stats.tx_sched_cnt[*sched_type], 1);
+       }
+#endif
+
+       return 0;
+}
+
+static inline uint16_t
+__dlb2_event_enqueue_burst(void *event_port,
+                          const struct rte_event events[],
+                          uint16_t num,
+                          bool use_delayed)
+{
+       struct dlb2_eventdev_port *ev_port = event_port;
+       struct dlb2_port *qm_port = &ev_port->qm_port;
+       struct process_local_port_data *port_data;
+       int i;
+
+       RTE_ASSERT(ev_port->enq_configured);
+       RTE_ASSERT(events != NULL);
+
+       i = 0;
+
+       port_data = &dlb2_port[qm_port->id][PORT_TYPE(qm_port)];
+
+       while (i < num) {
+               uint8_t sched_types[DLB2_NUM_QES_PER_CACHE_LINE];
+               uint8_t queue_ids[DLB2_NUM_QES_PER_CACHE_LINE];
+               int pop_offs = 0;
+               int j = 0;
+
+               memset(qm_port->qe4,
+                      0,
+                      DLB2_NUM_QES_PER_CACHE_LINE *
+                      sizeof(struct dlb2_enqueue_qe));
+
+               for (; j < DLB2_NUM_QES_PER_CACHE_LINE && (i + j) < num; j++) {
+                       const struct rte_event *ev = &events[i + j];
+                       int16_t thresh = qm_port->token_pop_thresh;
+
+                       if (use_delayed &&
+                           qm_port->token_pop_mode == DELAYED_POP &&
+                           (ev->op == RTE_EVENT_OP_FORWARD ||
+                            ev->op == RTE_EVENT_OP_RELEASE) &&
+                           qm_port->issued_releases >= thresh - 1) {
+                               /* Insert the token pop QE and break out. This
+                                * may result in a partial HCW, but that is
+                                * simpler than supporting arbitrary QE
+                                * insertion.
+                                */
+                               dlb2_construct_token_pop_qe(qm_port, j);
+
+                               /* Reset the releases for the next QE batch */
+                               qm_port->issued_releases -= thresh;
+
+                               pop_offs = 1;
+                               j++;
+                               break;
+                       }
+
+                       if (dlb2_event_enqueue_prep(ev_port, qm_port, ev,
+                                                   &sched_types[j],
+                                                   &queue_ids[j]))
+                               break;
+               }
+
+               if (j == 0)
+                       break;
+
+               dlb2_event_build_hcws(qm_port, &events[i], j - pop_offs,
+                                     sched_types, queue_ids);
+
+               dlb2_hw_do_enqueue(qm_port, i == 0, port_data);
+
+               /* Don't include the token pop QE in the enqueue count */
+               i += j - pop_offs;
+
+               /* Don't interpret j < DLB2_NUM_... as out-of-credits if
+                * pop_offs != 0
+                */
+               if (j < DLB2_NUM_QES_PER_CACHE_LINE && pop_offs == 0)
+                       break;
+       }
+
+       return i;
+}
+
+static uint16_t
+dlb2_event_enqueue_burst(void *event_port,
+                            const struct rte_event events[],
+                            uint16_t num)
+{
+       return __dlb2_event_enqueue_burst(event_port, events, num, false);
+}
+
+static uint16_t
+dlb2_event_enqueue_burst_delayed(void *event_port,
+                                    const struct rte_event events[],
+                                    uint16_t num)
+{
+       return __dlb2_event_enqueue_burst(event_port, events, num, true);
+}
+
+static inline uint16_t
+dlb2_event_enqueue(void *event_port,
+                  const struct rte_event events[])
+{
+       return __dlb2_event_enqueue_burst(event_port, events, 1, false);
+}
+
+static inline uint16_t
+dlb2_event_enqueue_delayed(void *event_port,
+                          const struct rte_event events[])
+{
+       return __dlb2_event_enqueue_burst(event_port, events, 1, true);
+}
+
+static uint16_t
+dlb2_event_enqueue_new_burst(void *event_port,
+                            const struct rte_event events[],
+                            uint16_t num)
+{
+       return __dlb2_event_enqueue_burst(event_port, events, num, false);
+}
+
+static uint16_t
+dlb2_event_enqueue_new_burst_delayed(void *event_port,
+                                    const struct rte_event events[],
+                                    uint16_t num)
+{
+       return __dlb2_event_enqueue_burst(event_port, events, num, true);
+}
+
+static uint16_t
+dlb2_event_enqueue_forward_burst(void *event_port,
+                                const struct rte_event events[],
+                                uint16_t num)
+{
+       return __dlb2_event_enqueue_burst(event_port, events, num, false);
+}
+
+static uint16_t
+dlb2_event_enqueue_forward_burst_delayed(void *event_port,
+                                        const struct rte_event events[],
+                                        uint16_t num)
+{
+       return __dlb2_event_enqueue_burst(event_port, events, num, true);
+}
+
+static void
+dlb2_event_release(struct dlb2_eventdev *dlb2,
+                  uint8_t port_id,
+                  int n)
+{
+       struct process_local_port_data *port_data;
+       struct dlb2_eventdev_port *ev_port;
+       struct dlb2_port *qm_port;
+       int i;
+
+       if (port_id > dlb2->num_ports) {
+               DLB2_LOG_ERR("Invalid port id %d in dlb2-event_release\n",
+                            port_id);
+               rte_errno = -EINVAL;
+               return;
+       }
+
+       ev_port = &dlb2->ev_ports[port_id];
+       qm_port = &ev_port->qm_port;
+       port_data = &dlb2_port[qm_port->id][PORT_TYPE(qm_port)];
+
+       i = 0;
+
+       if (qm_port->is_directed) {
+               i = n;
+               goto sw_credit_update;
+       }
+
+       while (i < n) {
+               int pop_offs = 0;
+               int j = 0;
+
+               /* Zero-out QEs */
+               qm_port->qe4[0].cmd_byte = 0;
+               qm_port->qe4[1].cmd_byte = 0;
+               qm_port->qe4[2].cmd_byte = 0;
+               qm_port->qe4[3].cmd_byte = 0;
+
+               for (; j < DLB2_NUM_QES_PER_CACHE_LINE && (i + j) < n; j++) {
+                       int16_t thresh = qm_port->token_pop_thresh;
+
+                       if (qm_port->token_pop_mode == DELAYED_POP &&
+                           qm_port->issued_releases >= thresh - 1) {
+                               /* Insert the token pop QE */
+                               dlb2_construct_token_pop_qe(qm_port, j);
+
+                               /* Reset the releases for the next QE batch */
+                               qm_port->issued_releases -= thresh;
+
+                               pop_offs = 1;
+                               j++;
+                               break;
+                       }
+
+                       qm_port->qe4[j].cmd_byte = DLB2_COMP_CMD_BYTE;
+                       qm_port->issued_releases++;
+               }
+
+               dlb2_hw_do_enqueue(qm_port, i == 0, port_data);
+
+               /* Don't include the token pop QE in the release count */
+               i += j - pop_offs;
+       }
+
+sw_credit_update:
+       /* each release returns one credit */
+       if (!ev_port->outstanding_releases) {
+               DLB2_LOG_ERR("%s: Outstanding releases underflowed.\n",
+                            __func__);
+               return;
+       }
+       ev_port->outstanding_releases -= i;
+       ev_port->inflight_credits += i;
+
+       /* Replenish s/w credits if enough releases are performed */
+       dlb2_replenish_sw_credits(dlb2, ev_port);
+}
+
+static inline void
+dlb2_port_credits_inc(struct dlb2_port *qm_port, int num)
+{
+       uint32_t batch_size = DLB2_SW_CREDIT_BATCH_SZ;
+
+       /* increment port credits, and return to pool if exceeds threshold */
+       if (!qm_port->is_directed) {
+               qm_port->cached_ldb_credits += num;
+               if (qm_port->cached_ldb_credits >= 2 * batch_size) {
+                       __atomic_fetch_add(
+                               qm_port->credit_pool[DLB2_LDB_QUEUE],
+                               batch_size, __ATOMIC_SEQ_CST);
+                       qm_port->cached_ldb_credits -= batch_size;
+               }
+       } else {
+               qm_port->cached_dir_credits += num;
+               if (qm_port->cached_dir_credits >= 2 * batch_size) {
+                       __atomic_fetch_add(
+                               qm_port->credit_pool[DLB2_DIR_QUEUE],
+                               batch_size, __ATOMIC_SEQ_CST);
+                       qm_port->cached_dir_credits -= batch_size;
+               }
+       }
+}
+
+static inline int
+dlb2_dequeue_wait(struct dlb2_eventdev *dlb2,
+                 struct dlb2_eventdev_port *ev_port,
+                 struct dlb2_port *qm_port,
+                 uint64_t timeout,
+                 uint64_t start_ticks)
+{
+       struct process_local_port_data *port_data;
+       uint64_t elapsed_ticks;
+
+       port_data = &dlb2_port[qm_port->id][PORT_TYPE(qm_port)];
+
+       elapsed_ticks = rte_get_timer_cycles() - start_ticks;
+
+       /* Wait/poll time expired */
+       if (elapsed_ticks >= timeout) {
+               return 1;
+       } else if (dlb2->umwait_allowed) {
+               volatile struct dlb2_dequeue_qe *cq_base;
+               union {
+                       uint64_t raw_qe[2];
+                       struct dlb2_dequeue_qe qe;
+               } qe_mask;
+               uint64_t expected_value;
+               volatile uint64_t *monitor_addr;
+
+               qe_mask.qe.cq_gen = 1; /* set mask */
+
+               cq_base = port_data->cq_base;
+               monitor_addr = (volatile uint64_t *)(volatile void *)
+                       &cq_base[qm_port->cq_idx];
+               monitor_addr++; /* cq_gen bit is in second 64bit location */
+
+               if (qm_port->gen_bit)
+                       expected_value = qe_mask.raw_qe[1];
+               else
+                       expected_value = 0;
+
+               rte_power_monitor(monitor_addr, expected_value,
+                                 qe_mask.raw_qe[1], timeout + start_ticks,
+                                 sizeof(uint64_t));
+
+               DLB2_INC_STAT(ev_port->stats.traffic.rx_umonitor_umwait, 1);
+       } else {
+               uint64_t poll_interval = RTE_LIBRTE_PMD_DLB2_POLL_INTERVAL;
+               uint64_t curr_ticks = rte_get_timer_cycles();
+               uint64_t init_ticks = curr_ticks;
+
+               while ((curr_ticks - start_ticks < timeout) &&
+                      (curr_ticks - init_ticks < poll_interval))
+                       curr_ticks = rte_get_timer_cycles();
+       }
+
+       return 0;
+}
+
+static inline int
+dlb2_process_dequeue_qes(struct dlb2_eventdev_port *ev_port,
+                        struct dlb2_port *qm_port,
+                        struct rte_event *events,
+                        struct dlb2_dequeue_qe *qes,
+                        int cnt)
+{
+       uint8_t *qid_mappings = qm_port->qid_mappings;
+       int i, num, evq_id;
+
+       for (i = 0, num = 0; i < cnt; i++) {
+               struct dlb2_dequeue_qe *qe = &qes[i];
+               int sched_type_map[DLB2_NUM_HW_SCHED_TYPES] = {
+                       [DLB2_SCHED_ATOMIC] = RTE_SCHED_TYPE_ATOMIC,
+                       [DLB2_SCHED_UNORDERED] = RTE_SCHED_TYPE_PARALLEL,
+                       [DLB2_SCHED_ORDERED] = RTE_SCHED_TYPE_ORDERED,
+                       [DLB2_SCHED_DIRECTED] = RTE_SCHED_TYPE_ATOMIC,
+               };
+
+               /* Fill in event information.
+                * Note that flow_id must be embedded in the data by
+                * the app, such as the mbuf RSS hash field if the data
+                * buffer is a mbuf.
+                */
+               if (unlikely(qe->error)) {
+                       DLB2_LOG_ERR("QE error bit ON\n");
+                       DLB2_INC_STAT(ev_port->stats.traffic.rx_drop, 1);
+                       dlb2_consume_qe_immediate(qm_port, 1);
+                       continue; /* Ignore */
+               }
+
+               events[num].u64 = qe->data;
+               events[num].flow_id = qe->flow_id;
+               events[num].priority = DLB2_TO_EV_PRIO((uint8_t)qe->priority);
+               events[num].event_type = qe->u.event_type.major;
+               events[num].sub_event_type = qe->u.event_type.sub;
+               events[num].sched_type = sched_type_map[qe->sched_type];
+               events[num].impl_opaque = qe->qid_depth;
+
+               /* qid not preserved for directed queues */
+               if (qm_port->is_directed)
+                       evq_id = ev_port->link[0].queue_id;
+               else
+                       evq_id = qid_mappings[qe->qid];
+
+               events[num].queue_id = evq_id;
+               DLB2_INC_STAT(
+                       ev_port->stats.queue[evq_id].qid_depth[qe->qid_depth],
+                       1);
+               DLB2_INC_STAT(ev_port->stats.rx_sched_cnt[qe->sched_type], 1);
+               num++;
+       }
+
+       DLB2_INC_STAT(ev_port->stats.traffic.rx_ok, num);
+
+       return num;
+}
+
+static inline int
+dlb2_process_dequeue_four_qes(struct dlb2_eventdev_port *ev_port,
+                             struct dlb2_port *qm_port,
+                             struct rte_event *events,
+                             struct dlb2_dequeue_qe *qes)
+{
+       int sched_type_map[] = {
+               [DLB2_SCHED_ATOMIC] = RTE_SCHED_TYPE_ATOMIC,
+               [DLB2_SCHED_UNORDERED] = RTE_SCHED_TYPE_PARALLEL,
+               [DLB2_SCHED_ORDERED] = RTE_SCHED_TYPE_ORDERED,
+               [DLB2_SCHED_DIRECTED] = RTE_SCHED_TYPE_ATOMIC,
+       };
+       const int num_events = DLB2_NUM_QES_PER_CACHE_LINE;
+       uint8_t *qid_mappings = qm_port->qid_mappings;
+       __m128i sse_evt[2];
+
+       /* In the unlikely case that any of the QE error bits are set, process
+        * them one at a time.
+        */
+       if (unlikely(qes[0].error || qes[1].error ||
+                    qes[2].error || qes[3].error))
+               return dlb2_process_dequeue_qes(ev_port, qm_port, events,
+                                                qes, num_events);
+
+       events[0].u64 = qes[0].data;
+       events[1].u64 = qes[1].data;
+       events[2].u64 = qes[2].data;
+       events[3].u64 = qes[3].data;
+
+       /* Construct the metadata portion of two struct rte_events
+        * in one 128b SSE register. Event metadata is constructed in the SSE
+        * registers like so:
+        * sse_evt[0][63:0]:   event[0]'s metadata
+        * sse_evt[0][127:64]: event[1]'s metadata
+        * sse_evt[1][63:0]:   event[2]'s metadata
+        * sse_evt[1][127:64]: event[3]'s metadata
+        */
+       sse_evt[0] = _mm_setzero_si128();
+       sse_evt[1] = _mm_setzero_si128();
+
+       /* Convert the hardware queue ID to an event queue ID and store it in
+        * the metadata:
+        * sse_evt[0][47:40]   = qid_mappings[qes[0].qid]
+        * sse_evt[0][111:104] = qid_mappings[qes[1].qid]
+        * sse_evt[1][47:40]   = qid_mappings[qes[2].qid]
+        * sse_evt[1][111:104] = qid_mappings[qes[3].qid]
+        */
+#define DLB_EVENT_QUEUE_ID_BYTE 5
+       sse_evt[0] = _mm_insert_epi8(sse_evt[0],
+                                    qid_mappings[qes[0].qid],
+                                    DLB_EVENT_QUEUE_ID_BYTE);
+       sse_evt[0] = _mm_insert_epi8(sse_evt[0],
+                                    qid_mappings[qes[1].qid],
+                                    DLB_EVENT_QUEUE_ID_BYTE + 8);
+       sse_evt[1] = _mm_insert_epi8(sse_evt[1],
+                                    qid_mappings[qes[2].qid],
+                                    DLB_EVENT_QUEUE_ID_BYTE);
+       sse_evt[1] = _mm_insert_epi8(sse_evt[1],
+                                    qid_mappings[qes[3].qid],
+                                    DLB_EVENT_QUEUE_ID_BYTE + 8);
+
+       /* Convert the hardware priority to an event priority and store it in
+        * the metadata, while also returning the queue depth status
+        * value captured by the hardware, storing it in impl_opaque, which can
+        * be read by the application but not modified
+        * sse_evt[0][55:48]   = DLB2_TO_EV_PRIO(qes[0].priority)
+        * sse_evt[0][63:56]   = qes[0].qid_depth
+        * sse_evt[0][119:112] = DLB2_TO_EV_PRIO(qes[1].priority)
+        * sse_evt[0][127:120] = qes[1].qid_depth
+        * sse_evt[1][55:48]   = DLB2_TO_EV_PRIO(qes[2].priority)
+        * sse_evt[1][63:56]   = qes[2].qid_depth
+        * sse_evt[1][119:112] = DLB2_TO_EV_PRIO(qes[3].priority)
+        * sse_evt[1][127:120] = qes[3].qid_depth
+        */
+#define DLB_EVENT_PRIO_IMPL_OPAQUE_WORD 3
+#define DLB_BYTE_SHIFT 8
+       sse_evt[0] =
+               _mm_insert_epi16(sse_evt[0],
+                       DLB2_TO_EV_PRIO((uint8_t)qes[0].priority) |
+                       (qes[0].qid_depth << DLB_BYTE_SHIFT),
+                       DLB_EVENT_PRIO_IMPL_OPAQUE_WORD);
+       sse_evt[0] =
+               _mm_insert_epi16(sse_evt[0],
+                       DLB2_TO_EV_PRIO((uint8_t)qes[1].priority) |
+                       (qes[1].qid_depth << DLB_BYTE_SHIFT),
+                       DLB_EVENT_PRIO_IMPL_OPAQUE_WORD + 4);
+       sse_evt[1] =
+               _mm_insert_epi16(sse_evt[1],
+                       DLB2_TO_EV_PRIO((uint8_t)qes[2].priority) |
+                       (qes[2].qid_depth << DLB_BYTE_SHIFT),
+                       DLB_EVENT_PRIO_IMPL_OPAQUE_WORD);
+       sse_evt[1] =
+               _mm_insert_epi16(sse_evt[1],
+                       DLB2_TO_EV_PRIO((uint8_t)qes[3].priority) |
+                       (qes[3].qid_depth << DLB_BYTE_SHIFT),
+                       DLB_EVENT_PRIO_IMPL_OPAQUE_WORD + 4);
+
+       /* Write the event type, sub event type, and flow_id to the event
+        * metadata.
+        * sse_evt[0][31:0]   = qes[0].flow_id |
+        *                      qes[0].u.event_type.major << 28 |
+        *                      qes[0].u.event_type.sub << 20;
+        * sse_evt[0][95:64]  = qes[1].flow_id |
+        *                      qes[1].u.event_type.major << 28 |
+        *                      qes[1].u.event_type.sub << 20;
+        * sse_evt[1][31:0]   = qes[2].flow_id |
+        *                      qes[2].u.event_type.major << 28 |
+        *                      qes[2].u.event_type.sub << 20;
+        * sse_evt[1][95:64]  = qes[3].flow_id |
+        *                      qes[3].u.event_type.major << 28 |
+        *                      qes[3].u.event_type.sub << 20;
+        */
+#define DLB_EVENT_EV_TYPE_DW 0
+#define DLB_EVENT_EV_TYPE_SHIFT 28
+#define DLB_EVENT_SUB_EV_TYPE_SHIFT 20
+       sse_evt[0] = _mm_insert_epi32(sse_evt[0],
+                       qes[0].flow_id |
+                       qes[0].u.event_type.major << DLB_EVENT_EV_TYPE_SHIFT |
+                       qes[0].u.event_type.sub <<  DLB_EVENT_SUB_EV_TYPE_SHIFT,
+                       DLB_EVENT_EV_TYPE_DW);
+       sse_evt[0] = _mm_insert_epi32(sse_evt[0],
+                       qes[1].flow_id |
+                       qes[1].u.event_type.major << DLB_EVENT_EV_TYPE_SHIFT |
+                       qes[1].u.event_type.sub <<  DLB_EVENT_SUB_EV_TYPE_SHIFT,
+                       DLB_EVENT_EV_TYPE_DW + 2);
+       sse_evt[1] = _mm_insert_epi32(sse_evt[1],
+                       qes[2].flow_id |
+                       qes[2].u.event_type.major << DLB_EVENT_EV_TYPE_SHIFT |
+                       qes[2].u.event_type.sub <<  DLB_EVENT_SUB_EV_TYPE_SHIFT,
+                       DLB_EVENT_EV_TYPE_DW);
+       sse_evt[1] = _mm_insert_epi32(sse_evt[1],
+                       qes[3].flow_id |
+                       qes[3].u.event_type.major << DLB_EVENT_EV_TYPE_SHIFT  |
+                       qes[3].u.event_type.sub << DLB_EVENT_SUB_EV_TYPE_SHIFT,
+                       DLB_EVENT_EV_TYPE_DW + 2);
+
+       /* Write the sched type to the event metadata. 'op' and 'rsvd' are not
+        * set:
+        * sse_evt[0][39:32]  = sched_type_map[qes[0].sched_type] << 6
+        * sse_evt[0][103:96] = sched_type_map[qes[1].sched_type] << 6
+        * sse_evt[1][39:32]  = sched_type_map[qes[2].sched_type] << 6
+        * sse_evt[1][103:96] = sched_type_map[qes[3].sched_type] << 6
+        */
+#define DLB_EVENT_SCHED_TYPE_BYTE 4
+#define DLB_EVENT_SCHED_TYPE_SHIFT 6
+       sse_evt[0] = _mm_insert_epi8(sse_evt[0],
+               sched_type_map[qes[0].sched_type] << DLB_EVENT_SCHED_TYPE_SHIFT,
+               DLB_EVENT_SCHED_TYPE_BYTE);
+       sse_evt[0] = _mm_insert_epi8(sse_evt[0],
+               sched_type_map[qes[1].sched_type] << DLB_EVENT_SCHED_TYPE_SHIFT,
+               DLB_EVENT_SCHED_TYPE_BYTE + 8);
+       sse_evt[1] = _mm_insert_epi8(sse_evt[1],
+               sched_type_map[qes[2].sched_type] << DLB_EVENT_SCHED_TYPE_SHIFT,
+               DLB_EVENT_SCHED_TYPE_BYTE);
+       sse_evt[1] = _mm_insert_epi8(sse_evt[1],
+               sched_type_map[qes[3].sched_type] << DLB_EVENT_SCHED_TYPE_SHIFT,
+               DLB_EVENT_SCHED_TYPE_BYTE + 8);
+
+       /* Store the metadata to the event (use the double-precision
+        * _mm_storeh_pd because there is no integer function for storing the
+        * upper 64b):
+        * events[0].event = sse_evt[0][63:0]
+        * events[1].event = sse_evt[0][127:64]
+        * events[2].event = sse_evt[1][63:0]
+        * events[3].event = sse_evt[1][127:64]
+        */
+       _mm_storel_epi64((__m128i *)&events[0].event, sse_evt[0]);
+       _mm_storeh_pd((double *)&events[1].event, (__m128d) sse_evt[0]);
+       _mm_storel_epi64((__m128i *)&events[2].event, sse_evt[1]);
+       _mm_storeh_pd((double *)&events[3].event, (__m128d) sse_evt[1]);
+
+       DLB2_INC_STAT(ev_port->stats.rx_sched_cnt[qes[0].sched_type], 1);
+       DLB2_INC_STAT(ev_port->stats.rx_sched_cnt[qes[1].sched_type], 1);
+       DLB2_INC_STAT(ev_port->stats.rx_sched_cnt[qes[2].sched_type], 1);
+       DLB2_INC_STAT(ev_port->stats.rx_sched_cnt[qes[3].sched_type], 1);
+
+       DLB2_INC_STAT(
+               ev_port->stats.queue[events[0].queue_id].
+                       qid_depth[qes[0].qid_depth],
+               1);
+       DLB2_INC_STAT(
+               ev_port->stats.queue[events[1].queue_id].
+                       qid_depth[qes[1].qid_depth],
+               1);
+       DLB2_INC_STAT(
+               ev_port->stats.queue[events[2].queue_id].
+                       qid_depth[qes[2].qid_depth],
+               1);
+       DLB2_INC_STAT(
+               ev_port->stats.queue[events[3].queue_id].
+                       qid_depth[qes[3].qid_depth],
+               1);
+
+       DLB2_INC_STAT(ev_port->stats.traffic.rx_ok, num_events);
+
+       return num_events;
+}
+
+static __rte_always_inline int
+dlb2_recv_qe_sparse(struct dlb2_port *qm_port, struct dlb2_dequeue_qe *qe)
+{
+       volatile struct dlb2_dequeue_qe *cq_addr;
+       uint8_t xor_mask[2] = {0x0F, 0x00};
+       const uint8_t and_mask = 0x0F;
+       __m128i *qes = (__m128i *)qe;
+       uint8_t gen_bits, gen_bit;
+       uintptr_t addr[4];
+       uint16_t idx;
+
+       cq_addr = dlb2_port[qm_port->id][PORT_TYPE(qm_port)].cq_base;
+
+       idx = qm_port->cq_idx;
+
+       /* Load the next 4 QEs */
+       addr[0] = (uintptr_t)&cq_addr[idx];
+       addr[1] = (uintptr_t)&cq_addr[(idx +  4) & qm_port->cq_depth_mask];
+       addr[2] = (uintptr_t)&cq_addr[(idx +  8) & qm_port->cq_depth_mask];
+       addr[3] = (uintptr_t)&cq_addr[(idx + 12) & qm_port->cq_depth_mask];
+
+       /* Prefetch next batch of QEs (all CQs occupy minimum 8 cache lines) */
+       rte_prefetch0(&cq_addr[(idx + 16) & qm_port->cq_depth_mask]);
+       rte_prefetch0(&cq_addr[(idx + 20) & qm_port->cq_depth_mask]);
+       rte_prefetch0(&cq_addr[(idx + 24) & qm_port->cq_depth_mask]);
+       rte_prefetch0(&cq_addr[(idx + 28) & qm_port->cq_depth_mask]);
+
+       /* Correct the xor_mask for wrap-around QEs */
+       gen_bit = qm_port->gen_bit;
+       xor_mask[gen_bit] ^= !!((idx +  4) > qm_port->cq_depth_mask) << 1;
+       xor_mask[gen_bit] ^= !!((idx +  8) > qm_port->cq_depth_mask) << 2;
+       xor_mask[gen_bit] ^= !!((idx + 12) > qm_port->cq_depth_mask) << 3;
+
+       /* Read the cache lines backwards to ensure that if QE[N] (N > 0) is
+        * valid, then QEs[0:N-1] are too.
+        */
+       qes[3] = _mm_load_si128((__m128i *)(void *)addr[3]);
+       rte_compiler_barrier();
+       qes[2] = _mm_load_si128((__m128i *)(void *)addr[2]);
+       rte_compiler_barrier();
+       qes[1] = _mm_load_si128((__m128i *)(void *)addr[1]);
+       rte_compiler_barrier();
+       qes[0] = _mm_load_si128((__m128i *)(void *)addr[0]);
+
+       /* Extract and combine the gen bits */
+       gen_bits = ((_mm_extract_epi8(qes[0], 15) & 0x1) << 0) |
+                  ((_mm_extract_epi8(qes[1], 15) & 0x1) << 1) |
+                  ((_mm_extract_epi8(qes[2], 15) & 0x1) << 2) |
+                  ((_mm_extract_epi8(qes[3], 15) & 0x1) << 3);
+
+       /* XOR the combined bits such that a 1 represents a valid QE */
+       gen_bits ^= xor_mask[gen_bit];
+
+       /* Mask off gen bits we don't care about */
+       gen_bits &= and_mask;
+
+       return __builtin_popcount(gen_bits);
+}
+
+static inline void
+dlb2_inc_cq_idx(struct dlb2_port *qm_port, int cnt)
+{
+       uint16_t idx = qm_port->cq_idx_unmasked + cnt;
+
+       qm_port->cq_idx_unmasked = idx;
+       qm_port->cq_idx = idx & qm_port->cq_depth_mask;
+       qm_port->gen_bit = (~(idx >> qm_port->gen_bit_shift)) & 0x1;
+}
+
+static inline int16_t
+dlb2_hw_dequeue_sparse(struct dlb2_eventdev *dlb2,
+                      struct dlb2_eventdev_port *ev_port,
+                      struct rte_event *events,
+                      uint16_t max_num,
+                      uint64_t dequeue_timeout_ticks)
+{
+       uint64_t timeout;
+       uint64_t start_ticks = 0ULL;
+       struct dlb2_port *qm_port;
+       int num = 0;
+
+       qm_port = &ev_port->qm_port;
+
+       /* We have a special implementation for waiting. Wait can be:
+        * 1) no waiting at all
+        * 2) busy poll only
+        * 3) wait for interrupt. If wakeup and poll time
+        * has expired, then return to caller
+        * 4) umonitor/umwait repeatedly up to poll time
+        */
+
+       /* If configured for per dequeue wait, then use wait value provided
+        * to this API. Otherwise we must use the global
+        * value from eventdev config time.
+        */
+       if (!dlb2->global_dequeue_wait)
+               timeout = dequeue_timeout_ticks;
+       else
+               timeout = dlb2->global_dequeue_wait_ticks;
+
+       start_ticks = rte_get_timer_cycles();
+
+       while (num < max_num) {
+               struct dlb2_dequeue_qe qes[DLB2_NUM_QES_PER_CACHE_LINE];
+               int num_avail;
+
+               /* Copy up to 4 QEs from the current cache line into qes */
+               num_avail = dlb2_recv_qe_sparse(qm_port, qes);
+
+               /* But don't process more than the user requested */
+               num_avail = RTE_MIN(num_avail, max_num - num);
+
+               dlb2_inc_cq_idx(qm_port, num_avail << 2);
+
+               if (num_avail == DLB2_NUM_QES_PER_CACHE_LINE)
+                       num += dlb2_process_dequeue_four_qes(ev_port,
+                                                             qm_port,
+                                                             &events[num],
+                                                             &qes[0]);
+               else if (num_avail)
+                       num += dlb2_process_dequeue_qes(ev_port,
+                                                        qm_port,
+                                                        &events[num],
+                                                        &qes[0],
+                                                        num_avail);
+               else if ((timeout == 0) || (num > 0))
+                       /* Not waiting in any form, or 1+ events received? */
+                       break;
+               else if (dlb2_dequeue_wait(dlb2, ev_port, qm_port,
+                                          timeout, start_ticks))
+                       break;
+       }
+
+       qm_port->owed_tokens += num;
+
+       if (num) {
+               if (qm_port->token_pop_mode == AUTO_POP)
+                       dlb2_consume_qe_immediate(qm_port, num);
+
+               ev_port->outstanding_releases += num;
+
+               dlb2_port_credits_inc(qm_port, num);
+       }
+
+       return num;
+}
+
+static __rte_always_inline int
+dlb2_recv_qe(struct dlb2_port *qm_port, struct dlb2_dequeue_qe *qe,
+            uint8_t *offset)
+{
+       uint8_t xor_mask[2][4] = { {0x0F, 0x0E, 0x0C, 0x08},
+                                  {0x00, 0x01, 0x03, 0x07} };
+       uint8_t and_mask[4] = {0x0F, 0x0E, 0x0C, 0x08};
+       volatile struct dlb2_dequeue_qe *cq_addr;
+       __m128i *qes = (__m128i *)qe;
+       uint64_t *cache_line_base;
+       uint8_t gen_bits;
+
+       cq_addr = dlb2_port[qm_port->id][PORT_TYPE(qm_port)].cq_base;
+       cq_addr = &cq_addr[qm_port->cq_idx];
+
+       cache_line_base = (void *)(((uintptr_t)cq_addr) & ~0x3F);
+       *offset = ((uintptr_t)cq_addr & 0x30) >> 4;
+
+       /* Load the next CQ cache line from memory. Pack these reads as tight
+        * as possible to reduce the chance that DLB invalidates the line while
+        * the CPU is reading it. Read the cache line backwards to ensure that
+        * if QE[N] (N > 0) is valid, then QEs[0:N-1] are too.
+        *
+        * (Valid QEs start at &qe[offset])
+        */
+       qes[3] = _mm_load_si128((__m128i *)&cache_line_base[6]);
+       qes[2] = _mm_load_si128((__m128i *)&cache_line_base[4]);
+       qes[1] = _mm_load_si128((__m128i *)&cache_line_base[2]);
+       qes[0] = _mm_load_si128((__m128i *)&cache_line_base[0]);
+
+       /* Evict the cache line ASAP */
+       rte_cldemote(cache_line_base);
+
+       /* Extract and combine the gen bits */
+       gen_bits = ((_mm_extract_epi8(qes[0], 15) & 0x1) << 0) |
+                  ((_mm_extract_epi8(qes[1], 15) & 0x1) << 1) |
+                  ((_mm_extract_epi8(qes[2], 15) & 0x1) << 2) |
+                  ((_mm_extract_epi8(qes[3], 15) & 0x1) << 3);
+
+       /* XOR the combined bits such that a 1 represents a valid QE */
+       gen_bits ^= xor_mask[qm_port->gen_bit][*offset];
+
+       /* Mask off gen bits we don't care about */
+       gen_bits &= and_mask[*offset];
+
+       return __builtin_popcount(gen_bits);
+}
+
+static inline int16_t
+dlb2_hw_dequeue(struct dlb2_eventdev *dlb2,
+               struct dlb2_eventdev_port *ev_port,
+               struct rte_event *events,
+               uint16_t max_num,
+               uint64_t dequeue_timeout_ticks)
+{
+       uint64_t timeout;
+       uint64_t start_ticks = 0ULL;
+       struct dlb2_port *qm_port;
+       int num = 0;
+
+       qm_port = &ev_port->qm_port;
+
+       /* We have a special implementation for waiting. Wait can be:
+        * 1) no waiting at all
+        * 2) busy poll only
+        * 3) wait for interrupt. If wakeup and poll time
+        * has expired, then return to caller
+        * 4) umonitor/umwait repeatedly up to poll time
+        */
+
+       /* If configured for per dequeue wait, then use wait value provided
+        * to this API. Otherwise we must use the global
+        * value from eventdev config time.
+        */
+       if (!dlb2->global_dequeue_wait)
+               timeout = dequeue_timeout_ticks;
+       else
+               timeout = dlb2->global_dequeue_wait_ticks;
+
+       start_ticks = rte_get_timer_cycles();
+
+       while (num < max_num) {
+               struct dlb2_dequeue_qe qes[DLB2_NUM_QES_PER_CACHE_LINE];
+               uint8_t offset;
+               int num_avail;
+
+               /* Copy up to 4 QEs from the current cache line into qes */
+               num_avail = dlb2_recv_qe(qm_port, qes, &offset);
+
+               /* But don't process more than the user requested */
+               num_avail = RTE_MIN(num_avail, max_num - num);
+
+               dlb2_inc_cq_idx(qm_port, num_avail);
+
+               if (num_avail == DLB2_NUM_QES_PER_CACHE_LINE)
+                       num += dlb2_process_dequeue_four_qes(ev_port,
+                                                            qm_port,
+                                                            &events[num],
+                                                            &qes[offset]);
+               else if (num_avail)
+                       num += dlb2_process_dequeue_qes(ev_port,
+                                                       qm_port,
+                                                       &events[num],
+                                                       &qes[offset],
+                                                       num_avail);
+               else if ((timeout == 0) || (num > 0))
+                       /* Not waiting in any form, or 1+ events received? */
+                       break;
+               else if (dlb2_dequeue_wait(dlb2, ev_port, qm_port,
+                                          timeout, start_ticks))
+                       break;
+       }
+
+       qm_port->owed_tokens += num;
+
+       if (num) {
+               if (qm_port->token_pop_mode == AUTO_POP)
+                       dlb2_consume_qe_immediate(qm_port, num);
+
+               ev_port->outstanding_releases += num;
+
+               dlb2_port_credits_inc(qm_port, num);
+       }
+
+       return num;
+}
+
+static uint16_t
+dlb2_event_dequeue_burst(void *event_port, struct rte_event *ev, uint16_t num,
+                        uint64_t wait)
+{
+       struct dlb2_eventdev_port *ev_port = event_port;
+       struct dlb2_port *qm_port = &ev_port->qm_port;
+       struct dlb2_eventdev *dlb2 = ev_port->dlb2;
+       uint16_t cnt;
+
+       RTE_ASSERT(ev_port->setup_done);
+       RTE_ASSERT(ev != NULL);
+
+       if (ev_port->implicit_release && ev_port->outstanding_releases > 0) {
+               uint16_t out_rels = ev_port->outstanding_releases;
+
+               dlb2_event_release(dlb2, ev_port->id, out_rels);
+
+               DLB2_INC_STAT(ev_port->stats.tx_implicit_rel, out_rels);
+       }
+
+       if (qm_port->token_pop_mode == DEFERRED_POP && qm_port->owed_tokens)
+               dlb2_consume_qe_immediate(qm_port, qm_port->owed_tokens);
+
+       cnt = dlb2_hw_dequeue(dlb2, ev_port, ev, num, wait);
+
+       DLB2_INC_STAT(ev_port->stats.traffic.total_polls, 1);
+       DLB2_INC_STAT(ev_port->stats.traffic.zero_polls, ((cnt == 0) ? 1 : 0));
+
+       return cnt;
+}
+
+static uint16_t
+dlb2_event_dequeue(void *event_port, struct rte_event *ev, uint64_t wait)
+{
+       return dlb2_event_dequeue_burst(event_port, ev, 1, wait);
+}
+
+static uint16_t
+dlb2_event_dequeue_burst_sparse(void *event_port, struct rte_event *ev,
+                               uint16_t num, uint64_t wait)
+{
+       struct dlb2_eventdev_port *ev_port = event_port;
+       struct dlb2_port *qm_port = &ev_port->qm_port;
+       struct dlb2_eventdev *dlb2 = ev_port->dlb2;
+       uint16_t cnt;
+
+       RTE_ASSERT(ev_port->setup_done);
+       RTE_ASSERT(ev != NULL);
+
+       if (ev_port->implicit_release && ev_port->outstanding_releases > 0) {
+               uint16_t out_rels = ev_port->outstanding_releases;
+
+               dlb2_event_release(dlb2, ev_port->id, out_rels);
+
+               DLB2_INC_STAT(ev_port->stats.tx_implicit_rel, out_rels);
+       }
+
+       if (qm_port->token_pop_mode == DEFERRED_POP && qm_port->owed_tokens)
+               dlb2_consume_qe_immediate(qm_port, qm_port->owed_tokens);
+
+       cnt = dlb2_hw_dequeue_sparse(dlb2, ev_port, ev, num, wait);
+
+       DLB2_INC_STAT(ev_port->stats.traffic.total_polls, 1);
+       DLB2_INC_STAT(ev_port->stats.traffic.zero_polls, ((cnt == 0) ? 1 : 0));
+       return cnt;
+}
+
+static uint16_t
+dlb2_event_dequeue_sparse(void *event_port, struct rte_event *ev,
+                         uint64_t wait)
+{
+       return dlb2_event_dequeue_burst_sparse(event_port, ev, 1, wait);
+}
+
+static void
+dlb2_flush_port(struct rte_eventdev *dev, int port_id)
+{
+       struct dlb2_eventdev *dlb2 = dlb2_pmd_priv(dev);
+       eventdev_stop_flush_t flush;
+       struct rte_event ev;
+       uint8_t dev_id;
+       void *arg;
+       int i;
+
+       flush = dev->dev_ops->dev_stop_flush;
+       dev_id = dev->data->dev_id;
+       arg = dev->data->dev_stop_flush_arg;
+
+       while (rte_event_dequeue_burst(dev_id, port_id, &ev, 1, 0)) {
+               if (flush)
+                       flush(dev_id, ev, arg);
+
+               if (dlb2->ev_ports[port_id].qm_port.is_directed)
+                       continue;
+
+               ev.op = RTE_EVENT_OP_RELEASE;
+
+               rte_event_enqueue_burst(dev_id, port_id, &ev, 1);
+       }
+
+       /* Enqueue any additional outstanding releases */
+       ev.op = RTE_EVENT_OP_RELEASE;
+
+       for (i = dlb2->ev_ports[port_id].outstanding_releases; i > 0; i--)
+               rte_event_enqueue_burst(dev_id, port_id, &ev, 1);
+}
+
+static uint32_t
+dlb2_get_ldb_queue_depth(struct dlb2_eventdev *dlb2,
+                        struct dlb2_eventdev_queue *queue)
+{
+       struct dlb2_hw_dev *handle = &dlb2->qm_instance;
+       struct dlb2_get_ldb_queue_depth_args cfg;
+       int ret;
+
+       cfg.queue_id = queue->qm_queue.id;
+
+       ret = dlb2_iface_get_ldb_queue_depth(handle, &cfg);
+       if (ret < 0) {
+               DLB2_LOG_ERR("dlb2: get_ldb_queue_depth ret=%d (driver status: %s)\n",
+                            ret, dlb2_error_strings[cfg.response.status]);
+               return ret;
+       }
+
+       return cfg.response.id;
+}
+
+static uint32_t
+dlb2_get_dir_queue_depth(struct dlb2_eventdev *dlb2,
+                        struct dlb2_eventdev_queue *queue)
+{
+       struct dlb2_hw_dev *handle = &dlb2->qm_instance;
+       struct dlb2_get_dir_queue_depth_args cfg;
+       int ret;
+
+       cfg.queue_id = queue->qm_queue.id;
+
+       ret = dlb2_iface_get_dir_queue_depth(handle, &cfg);
+       if (ret < 0) {
+               DLB2_LOG_ERR("dlb2: get_dir_queue_depth ret=%d (driver status: %s)\n",
+                            ret, dlb2_error_strings[cfg.response.status]);
+               return ret;
+       }
+
+       return cfg.response.id;
+}
+
+uint32_t
+dlb2_get_queue_depth(struct dlb2_eventdev *dlb2,
+                    struct dlb2_eventdev_queue *queue)
+{
+       if (queue->qm_queue.is_directed)
+               return dlb2_get_dir_queue_depth(dlb2, queue);
+       else
+               return dlb2_get_ldb_queue_depth(dlb2, queue);
+}
+
+static bool
+dlb2_queue_is_empty(struct dlb2_eventdev *dlb2,
+                   struct dlb2_eventdev_queue *queue)
+{
+       return dlb2_get_queue_depth(dlb2, queue) == 0;
+}
+
+static bool
+dlb2_linked_queues_empty(struct dlb2_eventdev *dlb2)
+{
+       int i;
+
+       for (i = 0; i < dlb2->num_queues; i++) {
+               if (dlb2->ev_queues[i].num_links == 0)
+                       continue;
+               if (!dlb2_queue_is_empty(dlb2, &dlb2->ev_queues[i]))
+                       return false;
+       }
+
+       return true;
+}
+
+static bool
+dlb2_queues_empty(struct dlb2_eventdev *dlb2)
+{
+       int i;
+
+       for (i = 0; i < dlb2->num_queues; i++) {
+               if (!dlb2_queue_is_empty(dlb2, &dlb2->ev_queues[i]))
+                       return false;
+       }
+
+       return true;
+}
+
+static void
+dlb2_drain(struct rte_eventdev *dev)
+{
+       struct dlb2_eventdev *dlb2 = dlb2_pmd_priv(dev);
+       struct dlb2_eventdev_port *ev_port = NULL;
+       uint8_t dev_id;
+       int i;
+
+       dev_id = dev->data->dev_id;
+
+       while (!dlb2_linked_queues_empty(dlb2)) {
+               /* Flush all the ev_ports, which will drain all their connected
+                * queues.
+                */
+               for (i = 0; i < dlb2->num_ports; i++)
+                       dlb2_flush_port(dev, i);
+       }
+
+       /* The queues are empty, but there may be events left in the ports. */
+       for (i = 0; i < dlb2->num_ports; i++)
+               dlb2_flush_port(dev, i);
+
+       /* If the domain's queues are empty, we're done. */
+       if (dlb2_queues_empty(dlb2))
+               return;
+
+       /* Else, there must be at least one unlinked load-balanced queue.
+        * Select a load-balanced port with which to drain the unlinked
+        * queue(s).
+        */
+       for (i = 0; i < dlb2->num_ports; i++) {
+               ev_port = &dlb2->ev_ports[i];
+
+               if (!ev_port->qm_port.is_directed)
+                       break;
+       }
+
+       if (i == dlb2->num_ports) {
+               DLB2_LOG_ERR("internal error: no LDB ev_ports\n");
+               return;
+       }
+
+       rte_errno = 0;
+       rte_event_port_unlink(dev_id, ev_port->id, NULL, 0);
+
+       if (rte_errno) {
+               DLB2_LOG_ERR("internal error: failed to unlink ev_port %d\n",
+                            ev_port->id);
+               return;
+       }
+
+       for (i = 0; i < dlb2->num_queues; i++) {
+               uint8_t qid, prio;
+               int ret;
+
+               if (dlb2_queue_is_empty(dlb2, &dlb2->ev_queues[i]))
+                       continue;
+
+               qid = i;
+               prio = 0;
+
+               /* Link the ev_port to the queue */
+               ret = rte_event_port_link(dev_id, ev_port->id, &qid, &prio, 1);
+               if (ret != 1) {
+                       DLB2_LOG_ERR("internal error: failed to link ev_port %d to queue %d\n",
+                                    ev_port->id, qid);
+                       return;
+               }
+
+               /* Flush the queue */
+               while (!dlb2_queue_is_empty(dlb2, &dlb2->ev_queues[i]))
+                       dlb2_flush_port(dev, ev_port->id);
+
+               /* Drain any extant events in the ev_port. */
+               dlb2_flush_port(dev, ev_port->id);
+
+               /* Unlink the ev_port from the queue */
+               ret = rte_event_port_unlink(dev_id, ev_port->id, &qid, 1);
+               if (ret != 1) {
+                       DLB2_LOG_ERR("internal error: failed to unlink ev_port %d to queue %d\n",
+                                    ev_port->id, qid);
+                       return;
+               }
+       }
+}
+
+static void
+dlb2_eventdev_stop(struct rte_eventdev *dev)
+{
+       struct dlb2_eventdev *dlb2 = dlb2_pmd_priv(dev);
+
+       rte_spinlock_lock(&dlb2->qm_instance.resource_lock);
+
+       if (dlb2->run_state == DLB2_RUN_STATE_STOPPED) {
+               DLB2_LOG_DBG("Internal error: already stopped\n");
+               rte_spinlock_unlock(&dlb2->qm_instance.resource_lock);
+               return;
+       } else if (dlb2->run_state != DLB2_RUN_STATE_STARTED) {
+               DLB2_LOG_ERR("Internal error: bad state %d for dev_stop\n",
+                            (int)dlb2->run_state);
+               rte_spinlock_unlock(&dlb2->qm_instance.resource_lock);
+               return;
+       }
+
+       dlb2->run_state = DLB2_RUN_STATE_STOPPING;
+
+       rte_spinlock_unlock(&dlb2->qm_instance.resource_lock);
+
+       dlb2_drain(dev);
+
+       dlb2->run_state = DLB2_RUN_STATE_STOPPED;
+}
+
+static int
+dlb2_eventdev_close(struct rte_eventdev *dev)
+{
+       dlb2_hw_reset_sched_domain(dev, false);
+
+       return 0;
+}
+
+static void
+dlb2_eventdev_queue_release(struct rte_eventdev *dev, uint8_t id)
+{
+       RTE_SET_USED(dev);
+       RTE_SET_USED(id);
+
+       /* This function intentionally left blank. */
+}
+
+static void
+dlb2_eventdev_port_release(void *port)
+{
+       struct dlb2_eventdev_port *ev_port = port;
+       struct dlb2_port *qm_port;
+
+       if (ev_port) {
+               qm_port = &ev_port->qm_port;
+               if (qm_port->config_state == DLB2_CONFIGURED)
+                       dlb2_free_qe_mem(qm_port);
+       }
+}
+
+static int
+dlb2_eventdev_timeout_ticks(struct rte_eventdev *dev, uint64_t ns,
+                           uint64_t *timeout_ticks)
+{
+       RTE_SET_USED(dev);
+       uint64_t cycles_per_ns = rte_get_timer_hz() / 1E9;
+
+       *timeout_ticks = ns * cycles_per_ns;
+
+       return 0;
+}
+
+static void
+dlb2_entry_points_init(struct rte_eventdev *dev)
+{
+       struct dlb2_eventdev *dlb2;
+
+       /* Expose PMD's eventdev interface */
+       static struct rte_eventdev_ops dlb2_eventdev_entry_ops = {
+               .dev_infos_get    = dlb2_eventdev_info_get,
+               .dev_configure    = dlb2_eventdev_configure,
+               .dev_start        = dlb2_eventdev_start,
+               .dev_stop         = dlb2_eventdev_stop,
+               .dev_close        = dlb2_eventdev_close,
+               .queue_def_conf   = dlb2_eventdev_queue_default_conf_get,
+               .queue_setup      = dlb2_eventdev_queue_setup,
+               .queue_release    = dlb2_eventdev_queue_release,
+               .port_def_conf    = dlb2_eventdev_port_default_conf_get,
+               .port_setup       = dlb2_eventdev_port_setup,
+               .port_release     = dlb2_eventdev_port_release,
+               .port_link        = dlb2_eventdev_port_link,
+               .port_unlink      = dlb2_eventdev_port_unlink,
+               .port_unlinks_in_progress =
+                                   dlb2_eventdev_port_unlinks_in_progress,
+               .timeout_ticks    = dlb2_eventdev_timeout_ticks,
+               .dump             = dlb2_eventdev_dump,
+               .xstats_get       = dlb2_eventdev_xstats_get,
+               .xstats_get_names = dlb2_eventdev_xstats_get_names,
+               .xstats_get_by_name = dlb2_eventdev_xstats_get_by_name,
+               .xstats_reset       = dlb2_eventdev_xstats_reset,
+               .dev_selftest     = test_dlb2_eventdev,
+       };
+
+       /* Expose PMD's eventdev interface */
+
+       dev->dev_ops = &dlb2_eventdev_entry_ops;
+       dev->enqueue = dlb2_event_enqueue;
+       dev->enqueue_burst = dlb2_event_enqueue_burst;
+       dev->enqueue_new_burst = dlb2_event_enqueue_new_burst;
+       dev->enqueue_forward_burst = dlb2_event_enqueue_forward_burst;
+
+       dlb2 = dev->data->dev_private;
+       if (dlb2->poll_mode == DLB2_CQ_POLL_MODE_SPARSE) {
+               dev->dequeue = dlb2_event_dequeue_sparse;
+               dev->dequeue_burst = dlb2_event_dequeue_burst_sparse;
+       } else {
+               dev->dequeue = dlb2_event_dequeue;
+               dev->dequeue_burst = dlb2_event_dequeue_burst;
+       }
+}
+
+int
+dlb2_primary_eventdev_probe(struct rte_eventdev *dev,
+                           const char *name,
+                           struct dlb2_devargs *dlb2_args)
+{
+       struct dlb2_eventdev *dlb2;
+       int err, i;
+
+       dlb2 = dev->data->dev_private;
+
+       dlb2->event_dev = dev; /* backlink */
+
+       evdev_dlb2_default_info.driver_name = name;
+
+       dlb2->max_num_events_override = dlb2_args->max_num_events;
+       dlb2->num_dir_credits_override = dlb2_args->num_dir_credits_override;
+       dlb2->qm_instance.cos_id = dlb2_args->cos_id;
+
+       err = dlb2_iface_open(&dlb2->qm_instance, name);
+       if (err < 0) {
+               DLB2_LOG_ERR("could not open event hardware device, err=%d\n",
+                            err);
+               return err;
+       }
+
+       err = dlb2_iface_get_device_version(&dlb2->qm_instance,
+                                           &dlb2->revision);
+       if (err < 0) {
+               DLB2_LOG_ERR("dlb2: failed to get the device version, err=%d\n",
+                            err);
+               return err;
+       }
+
+       err = dlb2_hw_query_resources(dlb2);
+       if (err) {
+               DLB2_LOG_ERR("get resources err=%d for %s\n",
+                            err, name);
+               return err;
+       }
+
+       dlb2_iface_hardware_init(&dlb2->qm_instance);
+
+       err = dlb2_iface_get_cq_poll_mode(&dlb2->qm_instance, &dlb2->poll_mode);
+       if (err < 0) {
+               DLB2_LOG_ERR("dlb2: failed to get the poll mode, err=%d\n",
+                            err);
+               return err;
+       }
+
+       /* Complete xtstats runtime initialization */
+       err = dlb2_xstats_init(dlb2);
+       if (err) {
+               DLB2_LOG_ERR("dlb2: failed to init xstats, err=%d\n", err);
+               return err;
+       }
+
+       /* Initialize each port's token pop mode */
+       for (i = 0; i < DLB2_MAX_NUM_PORTS; i++)
+               dlb2->ev_ports[i].qm_port.token_pop_mode = AUTO_POP;
+
        rte_spinlock_init(&dlb2->qm_instance.resource_lock);
 
        dlb2_iface_low_level_io_init();