Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/83068/?format=api
https://patches.dpdk.org/api/patches/83068/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/patch/1604101900-19657-2-git-send-email-timothy.mcdaniel@intel.com/", "project": { "id": 1, "url": "https://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<1604101900-19657-2-git-send-email-timothy.mcdaniel@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dev/1604101900-19657-2-git-send-email-timothy.mcdaniel@intel.com", "date": "2020-10-30T23:51:18", "name": "[v7,01/23] event/dlb2: add documentation and meson build infrastructure", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "adb38304ccf3b1936b5c78d9ac25720b5dcb3251", "submitter": { "id": 826, "url": "https://patches.dpdk.org/api/people/826/?format=api", "name": "Timothy McDaniel", "email": "timothy.mcdaniel@intel.com" }, "delegate": null, "mbox": "https://patches.dpdk.org/project/dpdk/patch/1604101900-19657-2-git-send-email-timothy.mcdaniel@intel.com/mbox/", "series": [ { "id": 13513, "url": "https://patches.dpdk.org/api/series/13513/?format=api", "web_url": "https://patches.dpdk.org/project/dpdk/list/?series=13513", "date": "2020-10-30T23:51:17", "name": "Add DLB2 PMD", "version": 7, "mbox": "https://patches.dpdk.org/series/13513/mbox/" } ], "comments": "https://patches.dpdk.org/api/patches/83068/comments/", "check": "warning", "checks": "https://patches.dpdk.org/api/patches/83068/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 9C9F9A04E6;\n\tSat, 31 Oct 2020 00:50:36 +0100 (CET)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id A9A65C800;\n\tSat, 31 Oct 2020 00:50:08 +0100 (CET)", "from mga17.intel.com (mga17.intel.com [192.55.52.151])\n by dpdk.org (Postfix) with ESMTP id D8B2AC748\n for <dev@dpdk.org>; Sat, 31 Oct 2020 00:49:57 +0100 (CET)", "from orsmga003.jf.intel.com ([10.7.209.27])\n by fmsmga107.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 30 Oct 2020 16:49:55 -0700", "from txasoft-yocto.an.intel.com ([10.123.72.192])\n by orsmga003.jf.intel.com with ESMTP; 30 Oct 2020 16:49:54 -0700" ], "IronPort-SDR": [ "\n fFqkIY8JLpZUEusrPlXvZcfsu96eRYFJ9kbofk77rHyaJkp1C38IOFve3FlzIktw7+PqGOgrUg\n gtRX040/YcSA==", "\n mV2a2mvDLY92mHlAFJPY5xvLT0CI5DiGUv+yidz1pODMBzEWrJzkcniSmZY3fC57acAd9QguNK\n COFjVoj9zI7Q==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9790\"; a=\"148536681\"", "E=Sophos;i=\"5.77,435,1596524400\"; d=\"scan'208\";a=\"148536681\"", "E=Sophos;i=\"5.77,435,1596524400\"; d=\"scan'208\";a=\"319474229\"" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "From": "Timothy McDaniel <timothy.mcdaniel@intel.com>", "To": "Thomas Monjalon <thomas@monjalon.net>,\n Bruce Richardson <bruce.richardson@intel.com>,\n Ray Kinsella <mdr@ashroe.eu>, Neil Horman <nhorman@tuxdriver.com>", "Cc": "dev@dpdk.org, erik.g.carrillo@intel.com, gage.eads@intel.com,\n harry.van.haaren@intel.com, jerinj@marvell.com", "Date": "Fri, 30 Oct 2020 18:51:18 -0500", "Message-Id": "<1604101900-19657-2-git-send-email-timothy.mcdaniel@intel.com>", "X-Mailer": "git-send-email 1.7.10", "In-Reply-To": "<1604101900-19657-1-git-send-email-timothy.mcdaniel@intel.com>", "References": "<1602958879-8558-2-git-send-email-timothy.mcdaniel@intel.com>\n <1604101900-19657-1-git-send-email-timothy.mcdaniel@intel.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=UTF-8", "Content-Transfer-Encoding": "8bit", "Subject": "[dpdk-dev] =?utf-8?q?=5BPATCH_v7_01/23=5D_event/dlb2=3A_add_documen?=\n\t=?utf-8?q?tation_and_meson_build_infrastructure?=", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.15", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "Adds the meson build infrastructure, which includes\ncompile-time constants in rte_config.h. DLB2 is\nonly supported on Linux 64 bit X86 platforms at this time.\n\nAdds announcement of availabililty for the new driver\nfor Intel Dynamic Load Balancer 2.0 hardware.\n\nSigned-off-by: Timothy McDaniel <timothy.mcdaniel@intel.com>\nReviewed-by: Gage Eads <gage.eads@intel.com>\n---\n MAINTAINERS | 6 ++++-\n config/rte_config.h | 7 ++++++\n doc/guides/eventdevs/dlb2.rst | 40 ++++++++++++++++++++++++++++++++++\n doc/guides/eventdevs/index.rst | 1 +\n doc/guides/rel_notes/release_20_11.rst | 5 +++++\n drivers/event/dlb2/meson.build | 13 +++++++++++\n drivers/event/dlb2/version.map | 3 +++\n drivers/event/meson.build | 3 ++-\n 8 files changed, 76 insertions(+), 2 deletions(-)\n create mode 100644 doc/guides/eventdevs/dlb2.rst\n create mode 100644 drivers/event/dlb2/meson.build\n create mode 100644 drivers/event/dlb2/version.map", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex a3d1927..727451b 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -1162,6 +1162,11 @@ Cavium OCTEON TX timvf\n M: Pavan Nikhilesh <pbhagavatula@marvell.com>\n F: drivers/event/octeontx/timvf_*\n \n+Intel DLB2\n+M: Timothy McDaniel <timothy.mcdaniel@intel.com>\n+F: drivers/event/dlb2/\n+F: doc/guides/eventdevs/dlb2.rst\n+\n Marvell OCTEON TX2\n M: Pavan Nikhilesh <pbhagavatula@marvell.com>\n M: Jerin Jacob <jerinj@marvell.com>\n@@ -1198,7 +1203,6 @@ M: Peter Mccarthy <peter.mccarthy@intel.com>\n F: drivers/event/opdl/\n F: doc/guides/eventdevs/opdl.rst\n \n-\n Rawdev Drivers\n --------------\n \ndiff --git a/config/rte_config.h b/config/rte_config.h\nindex b78c6aa..64aa333 100644\n--- a/config/rte_config.h\n+++ b/config/rte_config.h\n@@ -135,4 +135,11 @@\n /* QEDE PMD defines */\n #define RTE_LIBRTE_QEDE_FW \"\"\n \n+/* DLB2 defines */\n+#define RTE_LIBRTE_PMD_DLB2_POLL_INTERVAL 1000\n+#define RTE_LIBRTE_PMD_DLB2_UMWAIT_CTL_STATE 0\n+#undef RTE_LIBRTE_PMD_DLB2_QUELL_STATS\n+#define RTE_LIBRTE_PMD_DLB2_SW_CREDIT_QUANTA 32\n+#define RTE_PMD_DLB2_DEFAULT_DEPTH_THRESH 256\n+\n #endif /* _RTE_CONFIG_H_ */\ndiff --git a/doc/guides/eventdevs/dlb2.rst b/doc/guides/eventdevs/dlb2.rst\nnew file mode 100644\nindex 0000000..e3091c9\n--- /dev/null\n+++ b/doc/guides/eventdevs/dlb2.rst\n@@ -0,0 +1,40 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright(c) 2020 Intel Corporation.\n+\n+Driver for the Intel® Dynamic Load Balancer (DLB2)\n+==================================================\n+\n+The DPDK dlb poll mode driver supports the Intel® Dynamic Load Balancer.\n+\n+Prerequisites\n+-------------\n+\n+Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup\n+the basic DPDK environment.\n+\n+Configuration\n+-------------\n+\n+The DLB2 PF PMD is a user-space PMD that uses VFIO to gain direct\n+device access. To use this operation mode, the PCIe PF device must be bound\n+to a DPDK-compatible VFIO driver, such as vfio-pci.\n+\n+Eventdev API Notes\n+------------------\n+\n+The DLB2 provides the functions of a DPDK event device; specifically, it\n+supports atomic, ordered, and parallel scheduling events from queues to ports.\n+However, the DLB2 hardware is not a perfect match to the eventdev API. Some DLB2\n+features are abstracted by the PMD such as directed ports.\n+\n+In general the dlb PMD is designed for ease-of-use and does not require a\n+detailed understanding of the hardware, but these details are important when\n+writing high-performance code. This section describes the places where the\n+eventdev API and DLB2 misalign.\n+\n+Flow ID\n+~~~~~~~\n+\n+The flow ID field is preserved in the event when it is scheduled in the\n+DLB2.\n+\ndiff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst\nindex bb66a5e..738788d 100644\n--- a/doc/guides/eventdevs/index.rst\n+++ b/doc/guides/eventdevs/index.rst\n@@ -11,6 +11,7 @@ application through the eventdev API.\n :maxdepth: 2\n :numbered:\n \n+ dlb2\n dpaa\n dpaa2\n dsw\ndiff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst\nindex d8ac359..dbce3b1 100644\n--- a/doc/guides/rel_notes/release_20_11.rst\n+++ b/doc/guides/rel_notes/release_20_11.rst\n@@ -55,6 +55,11 @@ New Features\n Also, make sure to start the actual text at the margin.\n =======================================================\n \n+* **Added a new driver for the Intel Dynamic Load Balancer v2.0 device.**\n+\n+ Added the new ``dlb2`` eventdev driver for the Intel DLB V2.0 device. See the\n+ :doc:`../eventdevs/dlb2` eventdev guide for more details on this new driver.\n+\n * **Added write combining store APIs.**\n \n Added ``rte_write32_wc`` and ``rte_write32_wc_relaxed`` APIs\ndiff --git a/drivers/event/dlb2/meson.build b/drivers/event/dlb2/meson.build\nnew file mode 100644\nindex 0000000..5324043\n--- /dev/null\n+++ b/drivers/event/dlb2/meson.build\n@@ -0,0 +1,13 @@\n+# SPDX-License-Identifier: BSD-3-Clause\n+# Copyright(c) 2019-2020 Intel Corporation\n+\n+if not is_linux or not dpdk_conf.has('RTE_ARCH_X86_64')\n+ build = false\n+ reason = 'only supported on ARCH_X86_64 Linux'\n+ subdir_done()\n+endif\n+\n+sources = files(\n+)\n+\n+deps += ['mbuf', 'mempool', 'ring', 'pci', 'bus_pci']\ndiff --git a/drivers/event/dlb2/version.map b/drivers/event/dlb2/version.map\nnew file mode 100644\nindex 0000000..4a76d1d\n--- /dev/null\n+++ b/drivers/event/dlb2/version.map\n@@ -0,0 +1,3 @@\n+DPDK_21 {\n+\tlocal: *;\n+};\ndiff --git a/drivers/event/meson.build b/drivers/event/meson.build\nindex a7dac99..c433c10 100644\n--- a/drivers/event/meson.build\n+++ b/drivers/event/meson.build\n@@ -5,7 +5,8 @@ if is_windows\n \tsubdir_done()\n endif\n \n-drivers = ['dpaa', 'dpaa2', 'octeontx2', 'opdl', 'skeleton', 'sw', 'dsw']\n+drivers = ['dlb2', 'dpaa', 'dpaa2', 'octeontx2', 'opdl', 'skeleton', 'sw',\n+\t 'dsw']\n if not (toolchain == 'gcc' and cc.version().version_compare('<4.8.6') and\n \tdpdk_conf.has('RTE_ARCH_ARM64'))\n \tdrivers += 'octeontx'\n", "prefixes": [ "v7", "01/23" ] }{ "id": 83068, "url": "