From: Jerin Jacob <jer...@marvell.com>
Add Marvell OCTEON TX2 mempool documentation.
This patch also updates the MAINTAINERS file and
updates shared library versions in release_19_08.rst.
Cc: John McNamara <john.mcnam...@intel.com>
Cc: Thomas Monjalon <tho...@monjalon.net>
Signed-off-by: Jerin Jacob <jer...@marvell.com>
Signed-off-by: Vivek Sharma <viveksha...@marvell.com>
Signed-off-by: Vamsi Attunuru <vattun...@marvell.com>
Signed-off-by: Nithin Dabilpuram <ndabilpu...@marvell.com>
---
MAINTAINERS | 10 +++
doc/guides/mempool/index.rst | 1 +
doc/guides/mempool/octeontx2.rst | 90 ++++++++++++++++++++++++++
doc/guides/platform/octeontx2.rst | 2 +
doc/guides/rel_notes/release_19_08.rst | 2 +
5 files changed, 105 insertions(+)
create mode 100644 doc/guides/mempool/octeontx2.rst
diff --git a/MAINTAINERS b/MAINTAINERS
index 0212fe6d0..4ea759197 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -444,6 +444,16 @@ M: Artem V. Andreev <artem.andr...@oktetlabs.ru>
M: Andrew Rybchenko <arybche...@solarflare.com>
F: drivers/mempool/bucket/
+Marvell OCTEON TX2
+M: Jerin Jacob <jer...@marvell.com>
+M: Nithin Dabilpuram <ndabilpu...@marvell.com>
+M: Vamsi Attunuru <vattun...@marvell.com>
+F: drivers/common/octeontx2/
+F: drivers/mempool/octeontx2/
+F: doc/guides/platform/img/octeontx2_*
+F: doc/guides/platform/octeontx2.rst
+F: doc/guides/mempool/octeontx2.rst
+
Bus Drivers
-----------
diff --git a/doc/guides/mempool/index.rst b/doc/guides/mempool/index.rst
index 2ccf91633..756610264 100644
--- a/doc/guides/mempool/index.rst
+++ b/doc/guides/mempool/index.rst
@@ -12,3 +12,4 @@ application through the mempool API.
:numbered:
octeontx
+ octeontx2
diff --git a/doc/guides/mempool/octeontx2.rst b/doc/guides/mempool/octeontx2.rst
new file mode 100644
index 000000000..2c9a0953b
--- /dev/null
+++ b/doc/guides/mempool/octeontx2.rst
@@ -0,0 +1,90 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2019 Marvell International Ltd.
+
+OCTEON TX2 NPA Mempool Driver
+=============================
+
+The OCTEON TX2 NPA PMD (**librte_mempool_octeontx2**) provides mempool
+driver support for the integrated mempool device found in **Marvell OCTEON
TX2** SoC family.
+
+More information about OCTEON TX2 SoC can be found at `Marvell Official Website
+<https://www.marvell.com/embedded-processors/infrastructure-processors/>`_.
+
+Features
+--------
+
+OCTEON TX2 NPA PMD supports:
+
+- Up to 128 NPA LFs
+- 1M Pools per LF
+- HW mempool manager
+- Ethdev Rx buffer allocation in HW to save CPU cycles in the Rx path.
+- Ethdev Tx buffer recycling in HW to save CPU cycles in the Tx path.
+
+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_OCTEONTX2_MEMPOOL`` (default ``y``)
+
+ Toggle compilation of the ``librte_mempool_octeontx2`` driver.
+
+Runtime Config Options
+~~~~~~~~~~~~~~~~~~~~~~
+
+- ``Maximum number of mempools per application`` (default ``128``)
+
+ The maximum number of mempools per application needs to be configured on
+ HW during mempool driver initialization. HW can support up to 1M mempools,
+ Since each mempool costs set of HW resources, the ``max_pools`` ``devargs``
+ parameter is being introduced to configure the number of mempools required
+ for the application.
+ For example::
+
+ -w 0002:02:00.0,max_pools=512
+
+ With the above configuration, the driver will set up only 512 mempools for
+ the given application to save HW resources.
+
+.. note::
+
+ Since this configuration is per application, the end user needs to
+ provide ``max_pools`` parameter to the first PCIe device probed by the given
+ application.
+
+Debugging Options
+~~~~~~~~~~~~~~~~~
+
+.. _table_octeontx2_mempool_debug_options:
+
+.. table:: OCTEON TX2 mempool debug options
+
+ +---+------------+-------------------------------------------------------+
+ | # | Component | EAL log command |
+ +===+============+=======================================================+
+ | 1 | NPA | --log-level='pmd\.mempool.octeontx2,8' |
+ +---+------------+-------------------------------------------------------+
+
+Standalone mempool device
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+ The ``usertools/dpdk-devbind.py`` script shall enumerate all the mempool
devices
+ available in the system. In order to avoid, the end user to bind the mempool
+ device prior to use ethdev and/or eventdev device, the respective driver
+ configures an NPA LF and attach to the first probed ethdev or eventdev
device.
+ In case, if end user need to run mempool as a standalone device
+ (without ethdev or eventdev), end user needs to bind a mempool device using
+ ``usertools/dpdk-devbind.py``
+
+ Example command to run ``mempool_autotest`` test with standalone OCTEONTX2
NPA device::
+
+ echo "mempool_autotest" | build/app/test -c 0xf0
--mbuf-pool-ops-name="octeontx2_npa"
diff --git a/doc/guides/platform/octeontx2.rst
b/doc/guides/platform/octeontx2.rst
index 3a5e03050..c9ea45647 100644
--- a/doc/guides/platform/octeontx2.rst
+++ b/doc/guides/platform/octeontx2.rst
@@ -98,6 +98,8 @@ HW Offload Drivers
This section lists dataplane H/W block(s) available in OCTEON TX2 SoC.
+#. **Mempool Driver**
+ See :doc:`../mempool/octeontx2` for NPA mempool driver information.
Procedure to Setup Platform
---------------------------
diff --git a/doc/guides/rel_notes/release_19_08.rst
b/doc/guides/rel_notes/release_19_08.rst
index 8c3932d06..118d8fbe6 100644
--- a/doc/guides/rel_notes/release_19_08.rst
+++ b/doc/guides/rel_notes/release_19_08.rst
@@ -171,6 +171,7 @@ The libraries prepended with a plus sign were incremented
in this version.
librte_cfgfile.so.2
librte_cmdline.so.2
librte_compressdev.so.1
+ + librte_common_octeontx2.so.1
librte_cryptodev.so.7
librte_distributor.so.1
librte_eal.so.10
@@ -191,6 +192,7 @@ The libraries prepended with a plus sign were incremented
in this version.
librte_mbuf.so.5
librte_member.so.1
librte_mempool.so.5
+ + librte_mempool_octeontx2.so.1
librte_meter.so.3
librte_metrics.so.1
librte_net.so.1
--
2.21.0
