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
next prev 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).