DPDK patches and discussions
 help / color / mirror / Atom feed
From: Zaiyu Wang <zaiyuwang@trustnetic.com>
To: dev@dpdk.org
Cc: Zaiyu Wang <zaiyuwang@trustnetic.com>,
	Jiawen Wu <jiawenwu@trustnetic.com>,
	Jian Wang <jianwang@trustnetic.com>
Subject: [PATCH v5 20/21] doc: update for txgbe guides
Date: Thu, 16 Oct 2025 19:17:34 +0800	[thread overview]
Message-ID: <20251016111736.25372-21-zaiyuwang@trustnetic.com> (raw)
In-Reply-To: <20251016111736.25372-1-zaiyuwang@trustnetic.com>

Add new types of Wangxun NICs(Amber-Lite NIC models) into txgbe
supported NICs list, and supplement usage instructions.

Signed-off-by: Zaiyu Wang <zaiyuwang@trustnetic.com>
---
 doc/guides/nics/txgbe.rst | 31 +++++++++++++++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/doc/guides/nics/txgbe.rst b/doc/guides/nics/txgbe.rst
index 93fb592759..3c741689a7 100644
--- a/doc/guides/nics/txgbe.rst
+++ b/doc/guides/nics/txgbe.rst
@@ -4,8 +4,12 @@
 TXGBE Poll Mode Driver
 ======================
 
-The TXGBE PMD (librte_pmd_txgbe) provides poll mode driver support
-for Wangxun 10 Gigabit Ethernet NICs.
+Supported NICs
+--------------
+
+- Wangxun 10 Gigabit Ethernet NICs
+- Wangxun 25 Gigabit Ethernet NICs
+- Wangxun 40 Gigabit Ethernet NICs
 
 Features
 --------
@@ -30,6 +34,7 @@ Features
 - FW version
 - LRO
 - Generic flow API
+- Forward Error Correction (FEC) (only for 25G NICs)
 
 Prerequisites
 -------------
@@ -37,6 +42,9 @@ Prerequisites
 - Learning about Wangxun 10 Gigabit Ethernet NICs using
   `<https://www.net-swift.com/a/383.html>`_.
 
+- Learning about Wangxun 25 Gigabit Ethernet NICs using
+  `<https://www.net-swift.com/a/25GbE-tong-yong-lei-FF5025.html>`_.
+
 - Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
 
 Configuration
@@ -139,6 +147,25 @@ Please note that following ``devargs`` are only set for backplane NICs.
   PHY parameter used for user debugging. Setting other values to
   take effect requires setting the ``ffe_set``.
 
+Please note that following ``devargs`` are only set for Amber-Lite NICs.
+
+- ``tx_headwb`` (default **1**)
+
+  Use to enable the TX Head Write-Back mode. In this mode, the hardware
+  merges and writes back a group of TX descriptors together to reduce
+  memory access times, which helps improve performance.
+
+- ``tx_headwb_size`` (default **16**)
+
+  Tx head write-back length. It is recommended to use the default values.
+  Setting other values to take effect requires setting the ``tx_headwb``.
+
+- ``rx_desc_merge`` (default **1**)
+
+  Use to enable the RX descriptor merge mode. In this mode, the hardware
+  merges and writes back a group of RX descriptors together to reduce
+  memory access times, which helps improve performance.
+
 Driver compilation and testing
 ------------------------------
 
-- 
2.21.0.windows.1


  parent reply	other threads:[~2025-10-16 11:21 UTC|newest]

Thread overview: 91+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-04-18  9:41 [PATCH 0/2] *** Wangxun new NIC support *** Zaiyu Wang
2025-04-18  9:41 ` [PATCH 1/2] net/txgbe: add support for Wangxun new NIC Amber-Lite 25g/40g Zaiyu Wang
2025-04-18  9:41 ` [PATCH 2/2] net/txgbe: add basic code for Amber-Liter NIC configuration Zaiyu Wang
2025-06-25 12:50 ` [PATCH v2 00/15] Wangxun new NIC support Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 01/15] net/txgbe: add basic information for Amber-Lite 25G/40G NICs Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 02/15] net/txgbe: add new SW-FW mailbox interface Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 03/15] net/txgbe: add identification support for new SFP/QSFP modules Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 04/15] net/txgbe: add basic link configuration for Amber-Lite NICs Zaiyu Wang
2025-08-04  6:34     ` Jiawen Wu
2025-06-25 12:50   ` [PATCH v2 05/15] net/txgbe: add support for PHY configuration via SW-FW mailbox Zaiyu Wang
2025-08-04  6:51     ` Jiawen Wu
2025-06-25 12:50   ` [PATCH v2 06/15] net/txgbe: add RX&TX support for Amber-Lite NICs Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 07/15] net/txgbe: add hardware reset change " Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 08/15] net/txgbe: add MAC reconfiguration to avoid packet loss Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 09/15] net/txgbe: add TX head Write-Back mode for Amber-Lite NICs Zaiyu Wang
2025-08-04  7:15     ` Jiawen Wu
2025-06-25 12:50   ` [PATCH v2 10/15] net/txgbe: add RX desc merge " Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 11/15] net/txgbe: add FEC support for Amber-Lite 25G NICs Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 12/15] net/txgbe: add GPIO configuration Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 13/15] net/txgbe: disable unstable features Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 14/15] net/txgbe: add other hardware-related changes Zaiyu Wang
2025-06-25 12:50   ` [PATCH v2 15/15] doc: update for txgbe Zaiyu Wang
2025-06-26  8:02 ` [PATCH v3 00/15] Wangxun new NIC support Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 01/15] net/txgbe: add basic information for Amber-Lite 25G/40G NICs Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 02/15] net/txgbe: add new SW-FW mailbox interface Zaiyu Wang
2025-08-04  6:12     ` Jiawen Wu
2025-06-26  8:02   ` [PATCH v3 03/15] net/txgbe: add identification support for new SFP/QSFP modules Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 04/15] net/txgbe: add basic link configuration for Amber-Lite NICs Zaiyu Wang
2025-08-03 16:42     ` Stephen Hemminger
2025-10-14  9:34       ` Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 05/15] net/txgbe: add support for PHY configuration via SW-FW mailbox Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 06/15] net/txgbe: add RX&TX support for Amber-Lite NICs Zaiyu Wang
2025-08-04  7:07     ` Jiawen Wu
2025-06-26  8:02   ` [PATCH v3 07/15] net/txgbe: add hardware reset change " Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 08/15] net/txgbe: add MAC reconfiguration to avoid packet loss Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 09/15] net/txgbe: add TX head Write-Back mode for Amber-Lite NICs Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 10/15] net/txgbe: add RX desc merge " Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 11/15] net/txgbe: add FEC support for Amber-Lite 25G NICs Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 12/15] net/txgbe: add GPIO configuration Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 13/15] net/txgbe: disable unstable features Zaiyu Wang
2025-06-26  8:02   ` [PATCH v3 14/15] net/txgbe: add other hardware-related changes Zaiyu Wang
2025-08-04  7:23     ` Jiawen Wu
2025-06-26  8:02   ` [PATCH v3 15/15] doc: update for txgbe Zaiyu Wang
2025-06-30 19:40   ` [PATCH v3 00/15] Wangxun new NIC support Stephen Hemminger
2025-09-30  9:59 ` [PATCH v4 00/20] " Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 01/20] net/txgbe: add basic information for Amber-Lite 25G/40G NICs Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 02/20] net/txgbe: add new SW-FW mailbox interface Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 03/20] net/txgbe: add identification support for new SFP/QSFP modules Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 04/20] net/txgbe: rename raptor to sp for Sapphire-specific code Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 05/20] net/txgbe: add basic link configuration for Amber-Lite NICs Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 06/20] net/txgbe: add support for PHY configuration via SW-FW mailbox Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 07/20] net/txgbe: add RX&TX support for Amber-Lite NICs Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 08/20] net/txgbe: add hardware reset change " Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 09/20] net/txgbe: add MAC reconfiguration to avoid packet loss Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 10/20] net/txgbe: add TX head Write-Back mode for Amber-Lite NICs Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 11/20] net/txgbe: add RX desc merge " Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 12/20] net/txgbe: add FEC support for Amber-Lite 25G NICs Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 13/20] net/txgbe: add GPIO configuration Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 14/20] net/txgbe: disable unstable features Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 15/20] net/txgbe: add support for TX laser enable/disable Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 16/20] net/txgbe: add support for TX queue rate limiting Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 17/20] net/txgbe: add support for getting PHY ID Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 18/20] net/txgbe: add thermal sensor configuration for Amber-Lite NICs Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 19/20] net/txgbe: add RSS " Zaiyu Wang
2025-09-30  9:59   ` [PATCH v4 20/20] doc: update for txgbe Zaiyu Wang
2025-10-15 22:04   ` [PATCH v4 00/20] Wangxun new NIC support Stephen Hemminger
2025-10-16  6:13     ` Zaiyu Wang
2025-10-16 11:17 ` [PATCH v5 00/21] " Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 01/21] net/txgbe: add basic information for Amber-Lite 25G/40G NICs Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 02/21] net/txgbe: add new SW-FW mailbox interface Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 03/21] net/txgbe: add identification support for new SFP/QSFP modules Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 04/21] net/txgbe: rename raptor to sp for Sapphire-specific code Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 05/21] net/txgbe: add basic link configuration for Amber-Lite NICs Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 06/21] net/txgbe: add support for PHY configuration via SW-FW mailbox Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 07/21] net/txgbe: add RX&TX support for Amber-Lite NICs Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 08/21] net/txgbe: add hardware reset change " Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 09/21] net/txgbe: add MAC reconfiguration to avoid packet loss Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 10/21] net/txgbe: add TX head Write-Back mode for Amber-Lite NICs Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 11/21] net/txgbe: add RX desc merge " Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 12/21] net/txgbe: add FEC support for Amber-Lite 25G NICs Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 13/21] net/txgbe: add GPIO configuration Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 14/21] net/txgbe: disable unstable features Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 15/21] net/txgbe: add support for TX laser enable/disable Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 16/21] net/txgbe: add support for TX queue rate limiting Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 17/21] net/txgbe: add support for getting PHY ID Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 18/21] net/txgbe: add thermal sensor configuration for Amber-Lite NICs Zaiyu Wang
2025-10-16 11:17   ` [PATCH v5 19/21] net/txgbe: add RSS " Zaiyu Wang
2025-10-16 11:17   ` Zaiyu Wang [this message]
2025-10-16 11:17   ` [PATCH v5 21/21] doc: update release notes for Wangxun txgbe driver Zaiyu Wang
2025-10-16 16:59   ` [PATCH v5 00/21] Wangxun new NIC support Stephen Hemminger
2025-10-17  2:08     ` Zaiyu Wang

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=20251016111736.25372-21-zaiyuwang@trustnetic.com \
    --to=zaiyuwang@trustnetic.com \
    --cc=dev@dpdk.org \
    --cc=jianwang@trustnetic.com \
    --cc=jiawenwu@trustnetic.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).