From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 83290459C3; Wed, 18 Sep 2024 08:09:55 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id CB7D742DD6; Wed, 18 Sep 2024 08:09:50 +0200 (CEST) Received: from lf-2-53.ptr.blmpb.com (lf-2-53.ptr.blmpb.com [101.36.218.53]) by mails.dpdk.org (Postfix) with ESMTP id 803874027C for ; Wed, 18 Sep 2024 08:09:47 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; s=feishu2403070942; d=yunsilicon.com; t=1726639780; h=from:subject: mime-version:from:date:message-id:subject:to:cc:reply-to:content-type: mime-version:in-reply-to:message-id; bh=3Xdf8Ui3nMgoJNseMAKenfi9chvjnm+UBK4MXG4/ZMA=; b=YS+cm8y69Ei/x3sCNfCvSEdHHvZ74aBfnyrQLswYti+eGUKtM82+NwyAygwEaNhqUKMaD7 9yfTyhVAUSQxO9vPmFnlhp4VPoLyRrvxvPx5FIGuG0TSSkBvjDcdPC3QQ2a3Y7sk8f2Vr0 QkAfGqUp9XOeDo1UKUFmsNTAA0UE8ENWGv9gfFrQYfKIX/pAHXepb2kOiaE7fs3Xzv5rQ6 fQ8Nl4dE7x9/cJ2QQUcGf5dfZRhBDXJKJ3gazO+cXClN5f6Oxqw1w0cmDnANV5yPNc5XWn skQJuXL+X4ZDYW1HHKMBYjIk9HYwo2/MzL+2jnglpnk0t8zHqDpyL/h0kJZVlw== Message-Id: <20240918060936.1231758-2-wanry@yunsilicon.com> Subject: [PATCH v3 01/19] net/xsc: add doc and minimum build framework X-Original-From: WanRenyong Received: from ubuntu-liun.yunsilicon.com ([58.34.192.114]) by smtp.feishu.cn with ESMTPS; Wed, 18 Sep 2024 14:09:38 +0800 Content-Transfer-Encoding: 7bit Date: Wed, 18 Sep 2024 14:09:18 +0800 Cc: , "WanRenyong" From: "WanRenyong" X-Mailer: git-send-email 2.25.1 X-Lms-Return-Path: Content-Type: text/plain; charset=UTF-8 To: Mime-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Add minimum PMD code, doc and build infrastructure for xsc. Signed-off-by: WanRenyong --- 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 Naga Harish K S V Naga Suresh Somarowthu Nalla Pradeep +Na Na Na Na Nan Chen Nannan Lu @@ -1268,6 +1269,7 @@ Ronak Doshi Ron Beider Ronghua Zhang RongQiang Xie +Rong Qian RongQing Li Rongwei Liu Rory Sexton @@ -1586,6 +1588,7 @@ Waldemar Dworakowski Walter Heymans Wang Sheng-Hui Wangyu (Eric) +WanRenyong Waterman Cao Wathsala Vithanage Weichun Chen @@ -1638,6 +1641,7 @@ Xiaonan Zhang Xiao Wang Xiaoxiao Zeng Xiaoxin Peng +Xiaoxiong Zhang Xiaoyu Min Xiaoyun Li Xiaoyun Wang 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 +M: Na Na +M: Rong Qian +M: Xiaoxiong Zhang +F: drivers/net/xsc/ +F: doc/guides/nics/xsc.rst +F: doc/guides/nics/features/xsc.ini + VMware vmxnet3 M: Jochen Behrens 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 + ``_. + +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