[dpdk-dev] [PATCH v5 0/7] eventdev: cover letter: eth Rx adapter

Nikhil Rao nikhil.rao at intel.com
Fri Oct 6 23:09:54 CEST 2017

Eventdev-based networking applications require a component to dequeue
packets from NIC Rx queues and inject them into eventdev queues[1]. While
some platforms (e.g. Cavium Octeontx) do this operation in hardware, other
platforms use software.

This patchset introduces an ethernet Rx event adapter that dequeues packets
from ethernet devices and enqueues them to event devices. This patch is based on
a previous RFC[2] and supercedes [3], the main difference being that
this version implements a common abstraction for HW and SW based packet transfers.

The adapter is designed to work with the EAL service core[4] for SW based
packet transfers. An eventdev PMD callback is used to determine that SW
based packet transfer service is required. The application can discover
and configure the service with a core mask using rte_service APIs.

The adapter can service multiple ethernet devices and queues. For SW based
packet transfers each queue is  configured with a servicing weight to
control the relative frequency with which the adapter polls the queue,
and the event fields to use when constructing packet events. The adapter
has two modes for programming an event's flow ID: use a static per-queue
user-specified value or use the RSS hash.

A detailed description of the adapter is contained in the header's

[1] http://dpdk.org/ml/archives/dev/2017-May/065341.html
[2] http://dpdk.org/ml/archives/dev/2017-May/065539.html
[3] http://dpdk.org/ml/archives/dev/2017-July/070452.html
[4] http://dpdk.org/ml/archives/dev/2017-July/069782.html

- This patch extends the V2 implementation with some changes to
provide a common API across HW & SW packet transfer mechanisms from
the eth devices to the event devices.
- Introduces a caps API that is used by the apps and the Rx
adapter to configure the packet transfer path.
- Adds an API to retrieve the service ID of the service function.
(if one is used by the adapter)

- Unit test fixes (Santosh Shukla)
- Pass ethernet device pointer to eventdev callback functions
instead of ethernet port ID. (Nipun Gupta)
- Check for existence of stats callback before invocation (Nipun Gupta)
- Various code cleanups (Harry Van Haaren)

- Add header to documentation build (Jerin)
- Split patch series into smaller patches (Jerin)
- If eth_rx_adapter_caps_get PMD callback isn't implemented
return zeored caps (Jerin)
- Move rss_key_be to per adapter memory
- Various other fixes (Jerin)
- Test fixes for mempool (Santosh)
- Change order for event v/s eth port init in test app (Pavan)

Nikhil Rao (7):
  eventdev: add caps API and PMD callback for eth Rx adapter
  eventdev: add PMD callbacks for eth Rx adapter
  eventdev: add eth Rx adapter caps function to SW PMD
  eventdev: add eth Rx adapter API header
  eventdev: add event type for eth rx adapter
  eventdev: add eth Rx adapter implementation
  eventdev: add tests for eth Rx adapter APIs

 lib/librte_eventdev/rte_event_eth_rx_adapter.h |  392 ++++++++
 lib/librte_eventdev/rte_eventdev.h             |   41 +
 lib/librte_eventdev/rte_eventdev_pmd.h         |  182 ++++
 drivers/event/sw/sw_evdev.c                    |   15 +
 lib/librte_eventdev/rte_event_eth_rx_adapter.c | 1237 ++++++++++++++++++++++++
 lib/librte_eventdev/rte_eventdev.c             |   23 +
 test/test/test_event_eth_rx_adapter.c          |  453 +++++++++
 MAINTAINERS                                    |    4 +
 doc/api/doxy-api-index.md                      |    1 +
 lib/Makefile                                   |    2 +-
 lib/librte_eventdev/Makefile                   |    2 +
 lib/librte_eventdev/rte_eventdev_version.map   |   15 +
 test/test/Makefile                             |    1 +
 13 files changed, 2367 insertions(+), 1 deletion(-)
 create mode 100644 lib/librte_eventdev/rte_event_eth_rx_adapter.h
 create mode 100644 lib/librte_eventdev/rte_event_eth_rx_adapter.c
 create mode 100644 test/test/test_event_eth_rx_adapter.c


More information about the dev mailing list