[V5 01/18] doc: add some basic files to describe the hinic3 driver.

[Feifei Wang]

From: Yi Chen <chenyi221 at huawei.com>

This patch adds some basic files to describe the hinic3 driver.

Signed-off-by: Feifei Wang <wangfeifei40 at huawei.com>
Signed-off-by: Yi Chen <chenyi221 at huawei.com>
Reviewed-by: Xin Wang <wangxin679 at h-partners.com>
---
 .mailmap                               |  4 +-
 MAINTAINERS                            |  6 +++
 doc/guides/nics/hinic3.rst             | 51 ++++++++++++++++++++++++++
 doc/guides/nics/index.rst              |  1 +
 doc/guides/rel_notes/release_25_07.rst |  4 ++
 5 files changed, 65 insertions(+), 1 deletion(-)
 create mode 100644 doc/guides/nics/hinic3.rst

diff --git a/.mailmap b/.mailmap
index 8e898e303e..ecd7fe5805 100644
--- a/.mailmap
+++ b/.mailmap
@@ -434,7 +434,7 @@ Fang TongHao <fangtonghao at sangfor.com.cn>
 Fan Zhang <fanzhang.oss at gmail.com> <roy.fan.zhang at intel.com>
 Farah Smith <farah.smith at broadcom.com>
 Fei Chen <chenwei.0515 at bytedance.com>
-Feifei Wang <feifei.wang2 at arm.com> <feifei.wang at arm.com>
+Feifei Wang <wangfeifei40 at huawei.com> <feifei.wang1218 at gmail.com> <feifei.wang2 at arm.com> <feifei.wang at arm.com> <wff_light at vip.163.com>
 Fei Qin <fei.qin at corigine.com>
 Fengjiang Liu <liufengjiang.0426 at bytedance.com>
 Fengnan Chang <changfengnan at bytedance.com>
@@ -1735,6 +1735,7 @@ Xingguang He <xingguang.he at intel.com>
 Xingyou Chen <niatlantice at gmail.com>
 Xing Wang <xing_wang at realsil.com.cn>
 Xinying Yu <xinying.yu at corigine.com>
+Xin Wang <wangxin679 at h-partners.com>
 Xin Long <longxin.xl at alibaba-inc.com>
 Xi Zhang <xix.zhang at intel.com>
 Xuan Ding <xuan.ding at intel.com>
@@ -1769,6 +1770,7 @@ Yelena Krivosheev <yelena at marvell.com>
 Yerden Zhumabekov <e_zhumabekov at sts.kz> <yerden.zhumabekov at sts.kz>
 Yevgeny Kliteynik <kliteyn at nvidia.com>
 Yicai Lu <luyicai at huawei.com>
+Yi Chen <chenyi221 at huawei.com>
 Yiding Zhou <yidingx.zhou at intel.com>
 Yi Li <liyi1 at chinatelecom.cn>
 Yi Liu <yi.liu at nxp.com>
diff --git a/MAINTAINERS b/MAINTAINERS
index 0e9357f3a3..eeb735679e 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -780,6 +780,12 @@ F: drivers/net/hinic/
 F: doc/guides/nics/hinic.rst
 F: doc/guides/nics/features/hinic.ini
 
+Huawei hinic3
+M: Feifei Wang <wangfeifei40 at huawei.com>
+F: drivers/net/hinic3/
+F: doc/guides/nics/hinic3.rst
+F: doc/guides/nics/features/hinic3.ini
+
 Intel Network Common Code
 M: Bruce Richardson <bruce.richardson at intel.com>
 T: git://dpdk.org/next/dpdk-next-net-intel
diff --git a/doc/guides/nics/hinic3.rst b/doc/guides/nics/hinic3.rst
new file mode 100644
index 0000000000..c9e49a2be2
--- /dev/null
+++ b/doc/guides/nics/hinic3.rst
@@ -0,0 +1,51 @@
+..  SPDX-License-Identifier: BSD-3-Clause
+    Copyright(c) 2025 Huawei Technologies Co., Ltd
+
+HINIC Poll Mode Driver
+======================
+
+The hinic3 PMD (**librte_net_hinic3**) provides poll mode driver support
+for 25Gbps/100Gbps/200Gbps Huawei SPx series Network Adapters.
+
+Features
+--------
+
+- Multi arch support: x86_64, ARMv8.
+- Multiple queues for TX and RX
+- Receiver Side Scaling (RSS)
+- flow filtering
+- Checksum offload
+- TSO offload
+- Promiscuous mode
+- Port hardware statistics
+- Link state information
+- Link flow control
+- Scattered and gather for TX and RX
+- Allmulticast mode
+- MTU update
+- Multicast MAC filter
+- Flow API
+- Set Link down or up
+- VLAN filter and VLAN offload
+- SR-IOV - Partially supported at this point, VFIO only
+- FW version
+- LRO
+
+Prerequisites
+-------------
+
+- Learning about Huawei Hi1823 Series Intelligent NICs using
+  `<https://www.hikunpeng.com/compute/component/nic>`_.
+
+- Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.
+
+
+Driver compilation and testing
+------------------------------
+
+Refer to the document :ref:`compiling and testing a PMD for a NIC <pmd_build_and_test>`
+for details.
+
+Limitations or Known issues
+---------------------------
+X86-32, Windows, and BSD are not supported yet.
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index 57d161c526..1a1e3a6825 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -33,6 +33,7 @@ Network Interface Controller Drivers
     fm10k
     gve
     hinic
+    hinic3
     hns3
     i40e
     ice
diff --git a/doc/guides/rel_notes/release_25_07.rst b/doc/guides/rel_notes/release_25_07.rst
index b75405edf6..0821ca8b63 100644
--- a/doc/guides/rel_notes/release_25_07.rst
+++ b/doc/guides/rel_notes/release_25_07.rst
@@ -160,6 +160,10 @@ New Features
   (including out-of-tree nodes).
   This minimizes footprint of node specific mbuf dynamic field.
 
+* **Added Huawei hinic3 net driver.**
+
+  * Added network driver for the Huawei SPx series Network Adapters.
+
 
 Removed Items
 -------------
-- 
2.45.1.windows.1