From: Amit Prakash Shukla <amitprakashs@marvell.com>
To: Vamsi Attunuru <vattunuru@marvell.com>
Cc: <dev@dpdk.org>, <jerinj@marvell.com>,
Amit Prakash Shukla <amitprakashs@marvell.com>
Subject: [PATCH] doc: add cnxk dmadev performance tuning details
Date: Fri, 29 Sep 2023 19:18:46 +0530 [thread overview]
Message-ID: <20230929134846.625979-1-amitprakashs@marvell.com> (raw)
Updated cnxk DMA driver document to explain about performance tuning
parameters for kernel module.
Signed-off-by: Amit Prakash Shukla <amitprakashs@marvell.com>
---
doc/guides/dmadevs/cnxk.rst | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)
diff --git a/doc/guides/dmadevs/cnxk.rst b/doc/guides/dmadevs/cnxk.rst
index 418b9a9d63..8d841b1f12 100644
--- a/doc/guides/dmadevs/cnxk.rst
+++ b/doc/guides/dmadevs/cnxk.rst
@@ -56,3 +56,33 @@ Performing Data Copies
Refer to the :ref:`Enqueue / Dequeue APIs <dmadev_enqueue_dequeue>` section
of the dmadev library documentation
for details on operation enqueue and submission API usage.
+
+Performance Tuning Parameters
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+To achieve higher performance, DMA device needs to be tuned using PF kernel driver
+module params. The PF kernel driver is part of the octeon sdk. Module params shall be
+configured during module insert as in below example::
+
+ $ sudo insmod octeontx2_dpi.ko mps=128 mrrs=128 eng_fifo_buf=0x101008080808
+
+* ``mps``
+ Maximum payload size. MPS size shall not exceed the size selected by PCI config.
+ Max size that shall be configured can be found on executing ``lspci`` command
+ for the device.
+
+* ``mrrs``
+ Maximum read request size. MRRS size shall not exceed the size selected by PCI
+ config. Max size that shall be configured can be found on executing ``lspci``
+ command for the device.
+
+* ``eng_fifo_buf``
+ CNXK supports 6 DMA engines and each engine has an associated FIFO. By-default
+ all engine's FIFO is configured to 8 KB. Engine FIFO size can be tuned using this
+ 64 bit variable, where each byte represents an engine. In the example above engine
+ 0-3 FIFO are configure as 8 KB and engine 4-5 are configured as 16 KB.
+
+.. note::
+ MPS and MRRS performance tuning parameters helps achieve higher performance
+ only for Inbound and Outbound DMA transfers. The parameter has no effect for
+ Internal only DMA transfer.
--
2.25.1
next reply other threads:[~2023-09-29 13:48 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2023-09-29 13:48 Amit Prakash Shukla [this message]
2023-11-10 8:15 ` Vamsi Krishna Attunuru
2023-11-27 14:20 ` Thomas Monjalon
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20230929134846.625979-1-amitprakashs@marvell.com \
--to=amitprakashs@marvell.com \
--cc=dev@dpdk.org \
--cc=jerinj@marvell.com \
--cc=vattunuru@marvell.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).