Add minimum PMD code, doc and build infrastructure for xsc.
Signed-off-by: WanRenyong <wa...@yunsilicon.com>
---
v2:
* fix compilation error
---
.mailmap | 4 ++++
MAINTAINERS | 9 +++++++++
doc/guides/nics/features/xsc.ini | 9 +++++++++
doc/guides/nics/index.rst | 1 +
doc/guides/nics/xsc.rst | 31 +++++++++++++++++++++++++++++++
drivers/net/meson.build | 1 +
drivers/net/xsc/meson.build | 18 ++++++++++++++++++
drivers/net/xsc/xsc_ethdev.c | 3 +++
8 files changed, 76 insertions(+)
create mode 100644 doc/guides/nics/features/xsc.ini
create mode 100644 doc/guides/nics/xsc.rst
create mode 100644 drivers/net/xsc/meson.build
create mode 100644 drivers/net/xsc/xsc_ethdev.c
diff --git a/.mailmap b/.mailmap
index 09fa253e12..d09ed30e16 100644
--- a/.mailmap
+++ b/.mailmap
@@ -1034,6 +1034,7 @@ Nagadheeraj Rottela <rnagadhee...@marvell.com>
Naga Harish K S V <s.v.naga.haris...@intel.com>
Naga Suresh Somarowthu <naga.sureshx.somarow...@intel.com>
Nalla Pradeep <pna...@marvell.com>
+Na Na <n...@yunsilicon.com>
Na Na <nana...@alibaba-inc.com>
Nan Chen <whutchen...@gmail.com>
Nannan Lu <nannan...@intel.com>
@@ -1268,6 +1269,7 @@ Ronak Doshi <ronak.do...@broadcom.com> <dos...@vmware.com>
Ron Beider <rbei...@amazon.com>
Ronghua Zhang <rzh...@vmware.com>
RongQiang Xie <xie.rongqi...@zte.com.cn>
+Rong Qian <qi...@yunsilicon.com>
RongQing Li <lirongq...@baidu.com>
Rongwei Liu <rongw...@nvidia.com>
Rory Sexton <rory.sex...@intel.com>
@@ -1586,6 +1588,7 @@ Waldemar Dworakowski <waldemar.dworakow...@intel.com>
Walter Heymans <walter.heym...@corigine.com>
Wang Sheng-Hui <shh...@gmail.com>
Wangyu (Eric) <seven.wan...@huawei.com>
+WanRenyong <wa...@yunsilicon.com>
Waterman Cao <waterman....@intel.com>
Wathsala Vithanage <wathsala.vithan...@arm.com>
Weichun Chen <weichunx.c...@intel.com>
@@ -1638,6 +1641,7 @@ Xiaonan Zhang <xiaonanx.zh...@intel.com>
Xiao Wang <xiao.w.w...@intel.com>
Xiaoxiao Zeng <xiaoxiaox.z...@intel.com>
Xiaoxin Peng <xiaoxin.p...@broadcom.com>
+Xiaoxiong Zhang <zhan...@yunsilicon.com>
Xiaoyu Min <jack...@nvidia.com> <jack...@mellanox.com>
Xiaoyun Li <xiaoyun...@intel.com>
Xiaoyun Wang <cloud.wangxiao...@huawei.com>
diff --git a/MAINTAINERS b/MAINTAINERS
index c5a703b5c0..f87d802b24 100644
--- a/MAINTAINERS
+++ b/MAINTAINERS
@@ -994,6 +994,15 @@ F: drivers/net/txgbe/
F: doc/guides/nics/txgbe.rst
F: doc/guides/nics/features/txgbe.ini
+Yunsilicon xsc
+M: WanRenyong <wa...@yunsilicon.com>
+M: Na Na <n...@yunsilicon.com>
+M: Rong Qian <qi...@yunsilicon.com>
+M: Xiaoxiong Zhang <zhan...@yunsilicon.com>
+F: drivers/net/xsc/
+F: doc/guides/nics/xsc.rst
+F: doc/guides/nics/features/xsc.ini
+
VMware vmxnet3
M: Jochen Behrens <jochen.behr...@broadcom.com>
F: drivers/net/vmxnet3/
diff --git a/doc/guides/nics/features/xsc.ini b/doc/guides/nics/features/xsc.ini
new file mode 100644
index 0000000000..b5c44ce535
--- /dev/null
+++ b/doc/guides/nics/features/xsc.ini
@@ -0,0 +1,9 @@
+;
+; Supported features of the 'xsc' network poll mode driver.
+;
+; Refer to default.ini for the full list of available PMD features.
+;
+[Features]
+Linux = Y
+ARMv8 = Y
+x86-64 = Y
diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst
index c14bc7988a..9781097a21 100644
--- a/doc/guides/nics/index.rst
+++ b/doc/guides/nics/index.rst
@@ -69,3 +69,4 @@ Network Interface Controller Drivers
vhost
virtio
vmxnet3
+ xsc
diff --git a/doc/guides/nics/xsc.rst b/doc/guides/nics/xsc.rst
new file mode 100644
index 0000000000..b7643b3ce2
--- /dev/null
+++ b/doc/guides/nics/xsc.rst
@@ -0,0 +1,31 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright 2024 Yunsilicon Technology Co., Ltd
+
+XSC Poll Mode Driver
+======================
+
+The xsc PMD (**librte_net_xsc**) provides poll mode driver support for
+10/25/50/100/200 Gbps Yunsilicon metaScale Series Network Adapters.
+
+Supported NICs
+--------------
+
+The following Yunsilicon device models are supported by the same xsc driver:
+
+ - metaScale-200S
+ - metaScale-200
+ - metaScale-100Q
+ - metaScale-50
+
+Prerequisites
+--------------
+
+- Follow the DPDK :doc:`../linux_gsg/index` to setup the basic DPDK
environment.
+
+- Learning about Yunsilicon metaScale Series NICs using
+ `<https://www.yunsilicon.com/#/productInformation>`_.
+
+Limitations or Known issues
+---------------------------
+32bit ARCHs have not been tested and may not be supported.
+Windows and BSD are not supported yet.
diff --git a/drivers/net/meson.build b/drivers/net/meson.build
index fb6d34b782..67fbe81861 100644
--- a/drivers/net/meson.build
+++ b/drivers/net/meson.build
@@ -62,6 +62,7 @@ drivers = [
'vhost',
'virtio',
'vmxnet3',
+ 'xsc',
]
std_deps = ['ethdev', 'kvargs'] # 'ethdev' also pulls in mbuf, net, eal etc
std_deps += ['bus_pci'] # very many PMDs depend on PCI, so make std
diff --git a/drivers/net/xsc/meson.build b/drivers/net/xsc/meson.build
new file mode 100644
index 0000000000..7bd7a38483
--- /dev/null
+++ b/drivers/net/xsc/meson.build
@@ -0,0 +1,18 @@
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright 2024 Yunsilicon Technology Co., Ltd.
+
+if not is_linux or not dpdk_conf.get('RTE_ARCH_64')
+ build = false
+ reason = 'only supported on 64bit Linux'
+endif
+
+if dpdk_conf.get('RTE_ARCH') == 'loongarch'
+ build = false
+ reason = 'not supported on loongarch'
+endif
+
+sources = files(
+ 'xsc_ethdev.c',
+)
+
+
diff --git a/drivers/net/xsc/xsc_ethdev.c b/drivers/net/xsc/xsc_ethdev.c
new file mode 100644
index 0000000000..0e48cb76fa
--- /dev/null
+++ b/drivers/net/xsc/xsc_ethdev.c
@@ -0,0 +1,3 @@
+/* SPDX-License-Identifier: BSD-3-Clause
+ * Copyright 2024 Yunsilicon Technology Co., Ltd.
+ */
--
2.25.1
