[v1,1/6] eventdev: add power monitoring API on event port
Checks
Commit Message
A new API to allow power monitoring condition on event port to
optimize power when no events are arriving on an event port for
the worker core to process in an eventdev based pipelined application.
Signed-off-by: Sivaprasad Tummala <sivaprasad.tummala@amd.com>
---
lib/eventdev/eventdev_pmd.h | 22 ++++++++++++++++++++++
lib/eventdev/rte_eventdev.c | 24 ++++++++++++++++++++++++
lib/eventdev/rte_eventdev.h | 25 +++++++++++++++++++++++++
lib/eventdev/version.map | 1 +
4 files changed, 72 insertions(+)
@@ -525,6 +525,26 @@ typedef int (*eventdev_port_unlink_profile_t)(struct rte_eventdev *dev, void *po
typedef int (*eventdev_port_unlinks_in_progress_t)(struct rte_eventdev *dev,
void *port);
+/**
+ * @internal
+ * Get address of memory location whose contents will change whenever there is
+ * new data to be received on an Event port.
+ *
+ * @param port
+ * Eventdev port pointer.
+ * @param pmc
+ * The pointer to power-optimized monitoring condition structure.
+ * @return
+ * Negative errno value on error, 0 on success.
+ *
+ * @retval 0
+ * Success
+ * @retval -EINVAL
+ * Invalid parameters
+ */
+typedef int (*event_get_monitor_addr_t)(void *port,
+ struct rte_power_monitor_cond *pmc);
+
/**
* Converts nanoseconds to *timeout_ticks* value for rte_event_dequeue()
*
@@ -1564,6 +1584,8 @@ struct eventdev_ops {
eventdev_dump_t dump;
/* Dump internal information */
+ event_get_monitor_addr_t get_monitor_addr;
+ /** Get power monitoring condition for event port */
eventdev_xstats_get_t xstats_get;
/**< Get extended device statistics. */
eventdev_xstats_get_names_t xstats_get_names;
@@ -884,6 +884,30 @@ rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id,
return 0;
}
+int
+rte_event_port_get_monitor_addr(uint8_t dev_id, uint8_t port_id,
+ struct rte_power_monitor_cond *pmc)
+{
+ struct rte_eventdev *dev;
+
+ RTE_EVENTDEV_VALID_DEVID_OR_ERR_RET(dev_id, -EINVAL);
+ dev = &rte_eventdevs[dev_id];
+ if (!is_valid_port(dev, port_id)) {
+ RTE_EDEV_LOG_ERR("Invalid port_id=%" PRIu8, port_id);
+ return -EINVAL;
+ }
+
+ if (pmc == NULL) {
+ RTE_EDEV_LOG_ERR("devid %u port %u power monitor condition is NULL\n",
+ dev_id, port_id);
+ return -EINVAL;
+ }
+
+ if (*dev->dev_ops->get_monitor_addr == NULL)
+ return -ENOTSUP;
+ return (*dev->dev_ops->get_monitor_addr)(dev->data->ports[port_id], pmc);
+}
+
int
rte_event_queue_attr_get(uint8_t dev_id, uint8_t queue_id, uint32_t attr_id,
uint32_t *attr_value)
@@ -214,6 +214,7 @@ extern "C" {
#include <rte_errno.h>
#include <rte_mbuf_pool_ops.h>
#include <rte_mempool.h>
+#include <rte_power_intrinsics.h>
#include "rte_eventdev_trace_fp.h"
@@ -990,6 +991,30 @@ int
rte_event_port_attr_get(uint8_t dev_id, uint8_t port_id, uint32_t attr_id,
uint32_t *attr_value);
+/**
+ * @warning
+ * @b EXPERIMENTAL: this API may change without prior notice.
+ *
+ * Retrieve the monitor condition for a given event port.
+ *
+ * @param dev_id
+ * Eventdev id
+ * @param port_id
+ * Eventdev port id
+ * @param pmc
+ * The pointer to power-optimized monitoring condition structure.
+ *
+ * @return
+ * - 0: Success.
+ * -ENOTSUP: Operation not supported.
+ * -EINVAL: Invalid parameters.
+ * -ENODEV: Invalid device ID.
+ */
+__rte_experimental
+int
+rte_event_port_get_monitor_addr(uint8_t dev_id, uint8_t port_id,
+ struct rte_power_monitor_cond *pmc);
+
/**
* Start an event device.
*
@@ -154,6 +154,7 @@ EXPERIMENTAL {
rte_event_port_profile_links_set;
rte_event_port_profile_unlink;
rte_event_port_profile_links_get;
+ rte_event_port_get_monitor_addr;
__rte_eventdev_trace_port_profile_switch;
};