21a8b7c0c5
Remove unused debug config options for thunder nicvf and octeontx as they are now controlled by dynamic logging. Signed-off-by: Pavan Nikhilesh <pbhagavatula@caviumnetworks.com> Acked-by: Stephen Hemminger <stephen@networkplumber.org>
100 lines
2.7 KiB
ReStructuredText
100 lines
2.7 KiB
ReStructuredText
.. SPDX-License-Identifier: BSD-3-Clause
|
|
Copyright(c) 2017 Cavium, Inc
|
|
|
|
OCTEONTX SSOVF Eventdev Driver
|
|
==============================
|
|
|
|
The OCTEONTX SSOVF PMD (**librte_pmd_octeontx_ssovf**) provides poll mode
|
|
eventdev driver support for the inbuilt event device found in the **Cavium OCTEONTX**
|
|
SoC family as well as their virtual functions (VF) in SR-IOV context.
|
|
|
|
More information can be found at `Cavium, Inc Official Website
|
|
<http://www.cavium.com/OCTEON-TX_ARM_Processors.html>`_.
|
|
|
|
Features
|
|
--------
|
|
|
|
Features of the OCTEONTX SSOVF PMD are:
|
|
|
|
- 64 Event queues
|
|
- 32 Event ports
|
|
- HW event scheduler
|
|
- Supports 1M flows per event queue
|
|
- Flow based event pipelining
|
|
- Flow pinning support in flow based event pipelining
|
|
- Queue based event pipelining
|
|
- Supports ATOMIC, ORDERED, PARALLEL schedule types per flow
|
|
- Event scheduling QoS based on event queue priority
|
|
- Open system with configurable amount of outstanding events
|
|
- HW accelerated dequeue timeout support to enable power management
|
|
- SR-IOV VF
|
|
|
|
Supported OCTEONTX SoCs
|
|
-----------------------
|
|
- CN83xx
|
|
|
|
Prerequisites
|
|
-------------
|
|
|
|
See :doc: `../platform/octeontx` for setup information.
|
|
|
|
Pre-Installation Configuration
|
|
------------------------------
|
|
|
|
Config File Options
|
|
~~~~~~~~~~~~~~~~~~~
|
|
|
|
The following options can be modified in the ``config`` file.
|
|
Please note that enabling debugging options may affect system performance.
|
|
|
|
- ``CONFIG_RTE_LIBRTE_PMD_OCTEONTX_SSOVF`` (default ``y``)
|
|
|
|
Toggle compilation of the ``librte_pmd_octeontx_ssovf`` driver.
|
|
|
|
Driver Compilation
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
To compile the OCTEONTX SSOVF PMD for Linux arm64 gcc target, run the
|
|
following ``make`` command:
|
|
|
|
.. code-block:: console
|
|
|
|
cd <DPDK-source-directory>
|
|
make config T=arm64-thunderx-linuxapp-gcc install
|
|
|
|
|
|
Initialization
|
|
--------------
|
|
|
|
The octeontx eventdev is exposed as a vdev device which consists of a set
|
|
of SSO group and work-slot PCIe VF devices. On EAL initialization,
|
|
SSO PCIe VF devices will be probed and then the vdev device can be created
|
|
from the application code, or from the EAL command line based on
|
|
the number of probed/bound SSO PCIe VF device to DPDK by
|
|
|
|
* Invoking ``rte_vdev_init("event_octeontx")`` from the application
|
|
|
|
* Using ``--vdev="event_octeontx"`` in the EAL options, which will call
|
|
rte_vdev_init() internally
|
|
|
|
Example:
|
|
|
|
.. code-block:: console
|
|
|
|
./your_eventdev_application --vdev="event_octeontx"
|
|
|
|
Limitations
|
|
-----------
|
|
|
|
Burst mode support
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
Burst mode is not supported. Dequeue and Enqueue functions accepts only single
|
|
event at a time.
|
|
|
|
Rx adapter support
|
|
~~~~~~~~~~~~~~~~~~
|
|
|
|
When eth_octeontx is used as Rx adapter event schedule type
|
|
``RTE_SCHED_TYPE_PARALLEL`` is not supported.
|