time granularity of 2.5us.
- Up to 256 TIM rings aka event timer adapters.
- Up to 8 rings traversed in parallel.
+- HW managed packets enqueued from ethdev to eventdev exposed through event eth
+ RX adapter.
+- N:1 ethernet device Rx queue to Event queue mapping.
+- Lockfree Tx from event eth Tx adapter using ``DEV_TX_OFFLOAD_MT_LOCKFREE``
+ capability while maintaining receive packet order.
+- Full Rx/Tx offload support defined through ethdev queue config.
Prerequisites and Compilation procedure
---------------------------------------
See :doc:`../platform/octeontx2` for setup information.
-Pre-Installation Configuration
-------------------------------
-
-Compile time Config Options
-~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-The following option can be modified in the ``config`` file.
-
-- ``CONFIG_RTE_LIBRTE_PMD_OCTEONTX2_EVENTDEV`` (default ``y``)
-
- Toggle compilation of the ``librte_pmd_octeontx2_event`` driver.
Runtime Config Options
-~~~~~~~~~~~~~~~~~~~~~~
+----------------------
- ``Maximum number of in-flight events`` (default ``8192``)
upper limit for in-flight events.
For example::
- --dev "0002:0e:00.0,xae_cnt=16384"
+ -w 0002:0e:00.0,xae_cnt=16384
- ``Force legacy mode``
single workslot mode in SSO and disable the default dual workslot mode.
For example::
- --dev "0002:0e:00.0,single_ws=1"
+ -w 0002:0e:00.0,single_ws=1
- ``Event Group QoS support``
default.
For example::
- --dev "0002:0e:00.0,qos=[1-50-50-50]"
+ -w 0002:0e:00.0,qos=[1-50-50-50]
- ``Selftest``
The tests are run once the vdev creation is successfully complete.
For example::
- --dev "0002:0e:00.0,selftest=1"
+ -w 0002:0e:00.0,selftest=1
- ``TIM disable NPA``
parameter disables NPA and uses software mempool to manage chunks
For example::
- --dev "0002:0e:00.0,tim_disable_npa=1"
+ -w 0002:0e:00.0,tim_disable_npa=1
- ``TIM modify chunk slots``
to SSO. The default value is 255 and the max value is 4095.
For example::
- --dev "0002:0e:00.0,tim_chnk_slots=1023"
+ -w 0002:0e:00.0,tim_chnk_slots=1023
- ``TIM enable arm/cancel statistics``
event timer adapter.
For example::
- --dev "0002:0e:00.0,tim_stats_ena=1"
+ -w 0002:0e:00.0,tim_stats_ena=1
- ``TIM limit max rings reserved``
rings.
For example::
- --dev "0002:0e:00.0,tim_rings_lmt=5"
+ -w 0002:0e:00.0,tim_rings_lmt=5
- ``TIM ring control internal parameters``
default values.
For Example::
- --dev "0002:0e:00.0,tim_ring_ctl=[2-1023-1-0]"
+ -w 0002:0e:00.0,tim_ring_ctl=[2-1023-1-0]
+
+- ``Lock NPA contexts in NDC``
+
+ Lock NPA aura and pool contexts in NDC cache.
+ The device args take hexadecimal bitmask where each bit represent the
+ corresponding aura/pool id.
+
+ For example::
+
+ -w 0002:0e:00.0,npa_lock_mask=0xf
Debugging Options
-~~~~~~~~~~~~~~~~~
+-----------------
.. _table_octeontx2_event_debug_options: