doc/guides/eventdevs/octeontx.rst

   1 ..  SPDX-License-Identifier: BSD-3-Clause
   2     Copyright(c) 2017 Cavium, Inc
   3
   4 OCTEONTX SSOVF Eventdev Driver
   5 ==============================
   6
   7 The OCTEONTX SSOVF PMD (**librte_pmd_octeontx_ssovf**) provides poll mode
   8 eventdev driver support for the inbuilt event device found in the **Cavium OCTEONTX**
   9 SoC family as well as their virtual functions (VF) in SR-IOV context.
  10
  11 More information can be found at `Cavium, Inc Official Website
  12 <http://www.cavium.com/OCTEON-TX_ARM_Processors.html>`_.
  13
  14 Features
  15 --------
  16
  17 Features of the OCTEONTX SSOVF PMD are:
  18
  19 - 64 Event queues
  20 - 32 Event ports
  21 - HW event scheduler
  22 - Supports 1M flows per event queue
  23 - Flow based event pipelining
  24 - Flow pinning support in flow based event pipelining
  25 - Queue based event pipelining
  26 - Supports ATOMIC, ORDERED, PARALLEL schedule types per flow
  27 - Event scheduling QoS based on event queue priority
  28 - Open system with configurable amount of outstanding events
  29 - HW accelerated dequeue timeout support to enable power management
  30 - SR-IOV VF
  31 - HW managed event timers support through TIMVF, with high precision and
  32   time granularity of 1us.
  33 - Up to 64 event timer adapters.
  34
  35 Supported OCTEONTX SoCs
  36 -----------------------
  37 - CN83xx
  38
  39 Prerequisites
  40 -------------
  41
  42 See :doc: `../platform/octeontx` for setup information.
  43
  44 Pre-Installation Configuration
  45 ------------------------------
  46
  47 Config File Options
  48 ~~~~~~~~~~~~~~~~~~~
  49
  50 The following options can be modified in the ``config`` file.
  51 Please note that enabling debugging options may affect system performance.
  52
  53 - ``CONFIG_RTE_LIBRTE_PMD_OCTEONTX_SSOVF`` (default ``y``)
  54
  55   Toggle compilation of the ``librte_pmd_octeontx_ssovf`` driver.
  56
  57 Driver Compilation
  58 ~~~~~~~~~~~~~~~~~~
  59
  60 To compile the OCTEONTX SSOVF PMD for Linux arm64 gcc target, run the
  61 following ``make`` command:
  62
  63 .. code-block:: console
  64
  65    cd <DPDK-source-directory>
  66    make config T=arm64-thunderx-linuxapp-gcc install
  67
  68
  69 Initialization
  70 --------------
  71
  72 The octeontx eventdev is exposed as a vdev device which consists of a set
  73 of SSO group and work-slot PCIe VF devices. On EAL initialization,
  74 SSO PCIe VF devices will be probed and then the vdev device can be created
  75 from the application code, or from the EAL command line based on
  76 the number of probed/bound SSO PCIe VF device to DPDK by
  77
  78 * Invoking ``rte_vdev_init("event_octeontx")`` from the application
  79
  80 * Using ``--vdev="event_octeontx"`` in the EAL options, which will call
  81   rte_vdev_init() internally
  82
  83 Example:
  84
  85 .. code-block:: console
  86
  87     ./your_eventdev_application --vdev="event_octeontx"
  88
  89
  90 Selftest
  91 --------
  92
  93 The functionality of octeontx eventdev can be verified using this option,
  94 various unit and functional tests are run to verify the sanity.
  95 The tests are run once the vdev creation is successfully complete.
  96
  97 .. code-block:: console
  98
  99     --vdev="event_octeontx,self_test=1"
 100
 101
 102 Limitations
 103 -----------
 104
 105 Burst mode support
 106 ~~~~~~~~~~~~~~~~~~
 107
 108 Burst mode is not supported. Dequeue and Enqueue functions accepts only single
 109 event at a time.
 110
 111 Rx adapter support
 112 ~~~~~~~~~~~~~~~~~~
 113
 114 When eth_octeontx is used as Rx adapter event schedule type
 115 ``RTE_SCHED_TYPE_PARALLEL`` is not supported.