numam-dpdk/app/test-eventdev
Timothy McDaniel 75d113136f eventdev: express DLB/DLB2 PMD constraints
This commit implements the eventdev ABI changes required by
the DLB/DLB2 PMDs.  Several data structures and constants are modified
or added in this patch, thereby requiring modifications to the
dependent apps and examples.

The DLB/DLB2 hardware does not conform exactly to the eventdev interface.
1) It has a limit on the number of queues that may be linked to a port.
2) Some ports a further restricted to a maximum of 1 linked queue.
3) DLB does not have the ability to carry the flow_id as part
   of the event (QE) payload. Note that the DLB2 hardware is capable of
   carrying the flow_id.

Following is a detailed description of the changes that have been made.

1) Add new fields to the rte_event_dev_info struct. These fields allow
the device to advertise its capabilities so that applications can take
the appropriate actions based on those capabilities.

    struct rte_event_dev_info {
	uint32_t max_event_port_links;
	/**< Maximum number of queues that can be linked to a single event
	 * port by this device.
	 */

	uint8_t max_single_link_event_port_queue_pairs;
	/**< Maximum number of event ports and queues that are optimized for
	 * (and only capable of) single-link configurations supported by this
	 * device. These ports and queues are not accounted for in
	 * max_event_ports or max_event_queues.
	 */
    }

2) Add a new field to the rte_event_dev_config struct. This field allows
the application to specify how many of its ports are limited to a single
link, or will be used in single link mode.

    /** Event device configuration structure */
    struct rte_event_dev_config {
	uint8_t nb_single_link_event_port_queues;
	/**< Number of event ports and queues that will be singly-linked to
	 * each other. These are a subset of the overall event ports and
	 * queues; this value cannot exceed *nb_event_ports* or
	 * *nb_event_queues*. If the device has ports and queues that are
	 * optimized for single-link usage, this field is a hint for how many
	 * to allocate; otherwise, regular event ports and queues can be used.
	 */
    }

3) Replace the dedicated implicit_release_disabled field with a bit field
of explicit port capabilities. The implicit_release_disable functionality
is assigned to one bit, and a port-is-single-link-only  attribute is
assigned to other, with the remaining bits available for future assignment.

	* Event port configuration bitmap flags */
	#define RTE_EVENT_PORT_CFG_DISABLE_IMPL_REL    (1ULL << 0)
	/**< Configure the port not to release outstanding events in
	 * rte_event_dev_dequeue_burst(). If set, all events received through
	 * the port must be explicitly released with RTE_EVENT_OP_RELEASE or
	 * RTE_EVENT_OP_FORWARD. Must be unset if the device is not
	 * RTE_EVENT_DEV_CAP_IMPLICIT_RELEASE_DISABLE capable.
	 */
	#define RTE_EVENT_PORT_CFG_SINGLE_LINK         (1ULL << 1)

	/**< This event port links only to a single event queue.
	 *
	 *  @see rte_event_port_setup(), rte_event_port_link()
	 */

	#define RTE_EVENT_PORT_ATTR_IMPLICIT_RELEASE_DISABLE 3
	/**
	 * The implicit release disable attribute of the port
	 */

	struct rte_event_port_conf {
		uint32_t event_port_cfg;
		/**< Port cfg flags(EVENT_PORT_CFG_) */
	}

This patch also removes the depreciation notice and announce
the new eventdev ABI changes in release note.

Signed-off-by: Timothy McDaniel <timothy.mcdaniel@intel.com>
Acked-by: Harry van Haaren <harry.van.haaren@intel.com>
Acked-by: Pavan Nikhilesh <pbhagavatula@marvell.com>
Acked-by: Jerin Jacob <jerinj@marvell.com>
2020-10-15 23:16:07 +02:00
..
evt_common.h eventdev: express DLB/DLB2 PMD constraints 2020-10-15 23:16:07 +02:00
evt_main.c app/eventdev: use proper teardown sequence 2018-07-25 14:29:55 +02:00
evt_options.c app/eventdev: add options for mbuf and packet sizes 2019-10-05 15:39:31 +02:00
evt_options.h app/eventdev: validate producer type 2020-04-04 17:11:23 +02:00
evt_test.c app: use SPDX tag for Cavium copyright files 2018-01-09 16:19:01 +01:00
evt_test.h remove useless constructor headers 2018-07-12 00:00:35 +02:00
meson.build app/eventdev: fix pipeline test with meson build 2020-02-15 08:50:35 +01:00
parser.c app/eventdev: replace license text with SPDX tag 2019-07-29 13:31:45 +02:00
parser.h app: use SPDX tag for Intel copyright files 2018-01-04 22:41:39 +01:00
test_order_atq.c eventdev: express DLB/DLB2 PMD constraints 2020-10-15 23:16:07 +02:00
test_order_common.c eventdev: express DLB/DLB2 PMD constraints 2020-10-15 23:16:07 +02:00
test_order_common.h replace always-inline attributes 2020-04-16 18:16:46 +02:00
test_order_queue.c eventdev: express DLB/DLB2 PMD constraints 2020-10-15 23:16:07 +02:00
test_perf_atq.c replace always-inline attributes 2020-04-16 18:16:46 +02:00
test_perf_common.c app/eventdev: fix divide by zero 2019-11-26 07:49:31 +01:00
test_perf_common.h replace always-inline attributes 2020-04-16 18:16:46 +02:00
test_perf_queue.c replace always-inline attributes 2020-04-16 18:16:46 +02:00
test_pipeline_atq.c app/eventdev: fix capability check in pipeline ATQ test 2020-07-24 07:22:41 +02:00
test_pipeline_common.c app/eventdev: enable fast free offload 2020-10-15 23:03:49 +02:00
test_pipeline_common.h eventdev: add Tx flag for packets with same destination 2019-10-18 10:03:08 +02:00
test_pipeline_queue.c app/eventdev: add option for global dequeue timeout 2019-04-02 03:11:08 +02:00