From a3babbdd0fd64eda10f3967011a410faab8080a1 Mon Sep 17 00:00:00 2001 From: Jiawen Wu Date: Mon, 19 Oct 2020 16:53:18 +0800 Subject: [PATCH] net/txgbe: add build and doc infrastructure Adding bare minimum PMD library and doc build infrastructure and claim the maintainership for txgbe PMD. Signed-off-by: Jiawen Wu Reviewed-by: Ferruh Yigit --- MAINTAINERS | 7 +++++++ doc/guides/nics/features/txgbe.ini | 11 ++++++++++ doc/guides/nics/index.rst | 1 + doc/guides/nics/txgbe.rst | 28 ++++++++++++++++++++++++++ doc/guides/rel_notes/release_20_11.rst | 6 ++++++ drivers/net/meson.build | 1 + drivers/net/txgbe/meson.build | 7 +++++++ drivers/net/txgbe/txgbe_ethdev.c | 4 ++++ drivers/net/txgbe/txgbe_ethdev.h | 4 ++++ drivers/net/txgbe/version.map | 3 +++ 10 files changed, 72 insertions(+) create mode 100644 doc/guides/nics/features/txgbe.ini create mode 100644 doc/guides/nics/txgbe.rst create mode 100644 drivers/net/txgbe/meson.build create mode 100644 drivers/net/txgbe/txgbe_ethdev.c create mode 100644 drivers/net/txgbe/txgbe_ethdev.h create mode 100644 drivers/net/txgbe/version.map diff --git a/MAINTAINERS b/MAINTAINERS index 6b7619d344..4e6028efca 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -870,6 +870,13 @@ F: drivers/net/sfc/ F: doc/guides/nics/sfc_efx.rst F: doc/guides/nics/features/sfc_efx.ini +Wangxun txgbe +M: Jiawen Wu +M: Jian Wang +F: drivers/net/txgbe/ +F: doc/guides/nics/txgbe.rst +F: doc/guides/nics/features/txgbe.ini + VMware vmxnet3 M: Yong Wang F: drivers/net/vmxnet3/ diff --git a/doc/guides/nics/features/txgbe.ini b/doc/guides/nics/features/txgbe.ini new file mode 100644 index 0000000000..76c43c7f13 --- /dev/null +++ b/doc/guides/nics/features/txgbe.ini @@ -0,0 +1,11 @@ +; +; Supported features of the 'txgbe' network poll mode driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] +Linux UIO = Y +Linux VFIO = Y +ARMv8 = Y +x86-32 = Y +x86-64 = Y diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst index da5d85bcd0..3443617755 100644 --- a/doc/guides/nics/index.rst +++ b/doc/guides/nics/index.rst @@ -57,6 +57,7 @@ Network Interface Controller Drivers szedata2 tap thunderx + txgbe vdev_netvsc virtio vhost diff --git a/doc/guides/nics/txgbe.rst b/doc/guides/nics/txgbe.rst new file mode 100644 index 0000000000..730e1a298d --- /dev/null +++ b/doc/guides/nics/txgbe.rst @@ -0,0 +1,28 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2015-2020. + +TXGBE Poll Mode Driver +====================== + +The TXGBE PMD (librte_pmd_txgbe) provides poll mode driver support +for Wangxun 10 Gigabit Ethernet NICs. + +Prerequisites +------------- + +- Learning about Wangxun 10 Gigabit Ethernet NICs using + ``_. + +- Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. + +Driver compilation and testing +------------------------------ + +Refer to the document :ref:`compiling and testing a PMD for a NIC ` +for details. + +Limitations or Known issues +--------------------------- + +Build with ICC is not supported yet. +Power8, ARMv7 and BSD are not supported yet. diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst index 83295ac50c..5b73889a66 100644 --- a/doc/guides/rel_notes/release_20_11.rst +++ b/doc/guides/rel_notes/release_20_11.rst @@ -191,6 +191,12 @@ New Features * Added Alveo SN1000 SmartNICs (EF100 architecture) support including flow API transfer rules for switch HW offload +* **Added Wangxun txgbe PMD.** + + Added a new PMD driver for Wangxun 10 Gigabit Ethernet NICs. + + See the :doc:`../nics/txgbe` for more details. + * **Updated Virtio driver.** * Added support for Vhost-vDPA backend to Virtio-user PMD. diff --git a/drivers/net/meson.build b/drivers/net/meson.build index 4e4c2c976a..29f4777500 100644 --- a/drivers/net/meson.build +++ b/drivers/net/meson.build @@ -50,6 +50,7 @@ drivers = ['af_packet', 'szedata2', 'tap', 'thunderx', + 'txgbe', 'vdev_netvsc', 'vhost', 'virtio', diff --git a/drivers/net/txgbe/meson.build b/drivers/net/txgbe/meson.build new file mode 100644 index 0000000000..d5b19af316 --- /dev/null +++ b/drivers/net/txgbe/meson.build @@ -0,0 +1,7 @@ +# SPDX-License-Identifier: BSD-3-Clause +# Copyright(c) 2015-2020 + +sources = files( + 'txgbe_ethdev.c', +) + diff --git a/drivers/net/txgbe/txgbe_ethdev.c b/drivers/net/txgbe/txgbe_ethdev.c new file mode 100644 index 0000000000..cb758762d2 --- /dev/null +++ b/drivers/net/txgbe/txgbe_ethdev.c @@ -0,0 +1,4 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2015-2020 + */ + diff --git a/drivers/net/txgbe/txgbe_ethdev.h b/drivers/net/txgbe/txgbe_ethdev.h new file mode 100644 index 0000000000..cb758762d2 --- /dev/null +++ b/drivers/net/txgbe/txgbe_ethdev.h @@ -0,0 +1,4 @@ +/* SPDX-License-Identifier: BSD-3-Clause + * Copyright(c) 2015-2020 + */ + diff --git a/drivers/net/txgbe/version.map b/drivers/net/txgbe/version.map new file mode 100644 index 0000000000..4a76d1d52d --- /dev/null +++ b/drivers/net/txgbe/version.map @@ -0,0 +1,3 @@ +DPDK_21 { + local: *; +}; -- 2.20.1