From patchwork Tue Dec 3 06:27:47 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sunil Kumar Kori X-Patchwork-Id: 63511 X-Patchwork-Delegate: jerinj@marvell.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 45E87A04B5; Tue, 3 Dec 2019 07:28:43 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7C16A2B8D; Tue, 3 Dec 2019 07:28:42 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com [67.231.148.174]) by dpdk.org (Postfix) with ESMTP id C8BCA235 for ; Tue, 3 Dec 2019 07:28:40 +0100 (CET) Received: from pps.filterd (m0045849.ppops.net [127.0.0.1]) by mx0a-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id xB36GcFn031811; Mon, 2 Dec 2019 22:28:39 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type; s=pfpt0818; bh=KsU+PkEVCcACbdBl8KJ1VnyiXov+eN2XA+z8sl6S+r0=; b=bf5uIt8dlnU5k8sHpt2mjnTJzA1s3oJHlvYsyavAMZGnxiSF+OrMtYZi2aF1p9CmChGj FuJg/36k9Haa9bJpK3uQQznrL8NygamdCX1GDwVIljWpAPQS1ie7g6nzAYvQ79tj7C1I EfrLc0QqxP6sB/jhSVWyMkjWjLw8lKwkEi+VKRaJ5gIXEui01QaMma7rs56TJfV0kxkP 8iWGavJQyJnmaFxDKtpna946aKqqfzEn0y+OMDrlftGJIO2VZhloCXyS7hQBJQpDVn/i UyZWdjOYBibzZDElKUoC3fkkvf+TH0Vbca8QVBFgotK+RXwex9jiJ/GS2DEPNcjS4xVz Tg== Received: from sc-exch03.marvell.com ([199.233.58.183]) by mx0a-0016f401.pphosted.com with ESMTP id 2wkpnwaa49-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Mon, 02 Dec 2019 22:28:39 -0800 Received: from SC-EXCH03.marvell.com (10.93.176.83) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Mon, 2 Dec 2019 22:28:38 -0800 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Mon, 2 Dec 2019 22:28:38 -0800 Received: from localhost.localdomain (unknown [10.28.34.200]) by maili.marvell.com (Postfix) with ESMTP id 41DC13F703F; Mon, 2 Dec 2019 22:28:35 -0800 (PST) From: Sunil Kumar Kori To: , , , , , , , , John McNamara , "Marko Kovacevic" CC: , Sunil Kumar Kori Date: Tue, 3 Dec 2019 11:57:47 +0530 Message-ID: <20191203062749.23319-1-skori@marvell.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20191121074452.2291-1-skori@marvell.com> References: <20191121074452.2291-1-skori@marvell.com> MIME-Version: 1.0 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.95,18.0.572 definitions=2019-12-03_01:2019-11-29,2019-12-03 signatures=0 Subject: [dpdk-dev] [PATCH v3 1/3] doc: add skeleton for eventdevs feature matrices X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Patch adds skeleton for feature matrices for event dev and Rx/Tx adapters. Along with, .ini files are added for all supported PMDs. Signed-off-by: Sunil Kumar Kori --- v3: - Removed .txt files to generate tables. - Use conf.py script to generate tables. - Add .ini file for all supported PMDs. v2: - Review comments incorporated .gitignore | 2 ++ doc/guides/conf.py | 12 ++++++++- doc/guides/eventdevs/features/default.ini | 30 +++++++++++++++++++++ doc/guides/eventdevs/features/dpaa.ini | 8 ++++++ doc/guides/eventdevs/features/dpaa2.ini | 8 ++++++ doc/guides/eventdevs/features/dsw.ini | 8 ++++++ doc/guides/eventdevs/features/octeontx.ini | 8 ++++++ doc/guides/eventdevs/features/octeontx2.ini | 8 ++++++ doc/guides/eventdevs/features/opdl.ini | 8 ++++++ doc/guides/eventdevs/features/sw.ini | 8 ++++++ doc/guides/eventdevs/index.rst | 1 + doc/guides/eventdevs/overview.rst | 19 +++++++++++++ 12 files changed, 119 insertions(+), 1 deletion(-) create mode 100644 doc/guides/eventdevs/features/default.ini create mode 100644 doc/guides/eventdevs/features/dpaa.ini create mode 100644 doc/guides/eventdevs/features/dpaa2.ini create mode 100644 doc/guides/eventdevs/features/dsw.ini create mode 100644 doc/guides/eventdevs/features/octeontx.ini create mode 100644 doc/guides/eventdevs/features/octeontx2.ini create mode 100644 doc/guides/eventdevs/features/opdl.ini create mode 100644 doc/guides/eventdevs/features/sw.ini create mode 100644 doc/guides/eventdevs/overview.rst diff --git a/.gitignore b/.gitignore index 9741ba076..e0299a2e1 100644 --- a/.gitignore +++ b/.gitignore @@ -9,6 +9,8 @@ doc/guides/cryptodevs/overview_auth_table.txt doc/guides/cryptodevs/overview_aead_table.txt doc/guides/cryptodevs/overview_asym_table.txt doc/guides/compressdevs/overview_feature_table.txt +doc/guides/eventdevs/overview_feature_table.txt +doc/guides/eventdevs/overview_adptr_feature_table.txt # ignore generated ctags/cscope files cscope.out.po diff --git a/doc/guides/conf.py b/doc/guides/conf.py index e2b52e2df..ba2833d03 100644 --- a/doc/guides/conf.py +++ b/doc/guides/conf.py @@ -47,7 +47,7 @@ master_doc = 'index' # Maximum feature description string length -feature_str_len = 25 +feature_str_len = 45 # Figures, tables and code-blocks automatically numbered if they have caption numfig = True @@ -401,6 +401,16 @@ def setup(app): 'Features', 'Features availability in compression drivers', 'Feature') + table_file = dirname(__file__) + '/eventdevs/overview_feature_table.txt' + generate_overview_table(table_file, 1, + 'Features', + 'Features availability in eventdev drivers', + 'Feature') + table_file = dirname(__file__) + '/eventdevs/overview_adptr_feature_table.txt' + generate_overview_table(table_file, 2, + 'Adapter Features', + 'Features availability for adapters', + 'Feature') if LooseVersion(sphinx_version) < LooseVersion('1.3.1'): print('Upgrade sphinx to version >= 1.3.1 for ' diff --git a/doc/guides/eventdevs/features/default.ini b/doc/guides/eventdevs/features/default.ini new file mode 100644 index 000000000..d007d7a69 --- /dev/null +++ b/doc/guides/eventdevs/features/default.ini @@ -0,0 +1,30 @@ +; +; Features of a default eventdev driver. +; +; This file defines the features that are valid for inclusion in +; the other driver files and also the order that they appear in +; the features table in the documentation. +; +[Features] +Event queue priority based scheduling = +Event priority based scheduling = +Event device distributed scheduling = +Event device non sequential mode = +Event queue all types = +Burst mode enqueue/dequeue = +Event port implicit release disable = +Runtime event queue/port linking = +Multi queue linking per port = + +; +; Features of a default adapter. +; +[Adapter Features] +Eth Rx/Tx adapter on internal port = +Multiple event queues per ethdev = +Override flow ID = +Crypto adapter new event enqueue = +Crypto adapter forwarded event enqueue = +Crypto queue pair mapping to event queue = +Crypto adapter session data store/retrieve = +Timer adapter support in H/W = diff --git a/doc/guides/eventdevs/features/dpaa.ini b/doc/guides/eventdevs/features/dpaa.ini new file mode 100644 index 000000000..3cf172f40 --- /dev/null +++ b/doc/guides/eventdevs/features/dpaa.ini @@ -0,0 +1,8 @@ +; +; Supported features of the 'dpaa' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/features/dpaa2.ini b/doc/guides/eventdevs/features/dpaa2.ini new file mode 100644 index 000000000..822a82ef3 --- /dev/null +++ b/doc/guides/eventdevs/features/dpaa2.ini @@ -0,0 +1,8 @@ +; +; Supported features of the 'dpaa2' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/features/dsw.ini b/doc/guides/eventdevs/features/dsw.ini new file mode 100644 index 000000000..230737045 --- /dev/null +++ b/doc/guides/eventdevs/features/dsw.ini @@ -0,0 +1,8 @@ +; +; Supported features of the 'distributed software' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/features/octeontx.ini b/doc/guides/eventdevs/features/octeontx.ini new file mode 100644 index 000000000..d1b1fe6d6 --- /dev/null +++ b/doc/guides/eventdevs/features/octeontx.ini @@ -0,0 +1,8 @@ +; +; Supported features of the 'octeontx' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/features/octeontx2.ini b/doc/guides/eventdevs/features/octeontx2.ini new file mode 100644 index 000000000..96f1af0dc --- /dev/null +++ b/doc/guides/eventdevs/features/octeontx2.ini @@ -0,0 +1,8 @@ +; +; Supported features of the 'octeontx2' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/features/opdl.ini b/doc/guides/eventdevs/features/opdl.ini new file mode 100644 index 000000000..020808fce --- /dev/null +++ b/doc/guides/eventdevs/features/opdl.ini @@ -0,0 +1,8 @@ +; +; Supported features of 'Ordered Packet Distribution Library' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/features/sw.ini b/doc/guides/eventdevs/features/sw.ini new file mode 100644 index 000000000..a5789f56d --- /dev/null +++ b/doc/guides/eventdevs/features/sw.ini @@ -0,0 +1,8 @@ +; +; Supported features of the 'software' eventdev driver. +; +; Refer to default.ini for the full list of available PMD features. +; +[Features] + +[Adapter Features] diff --git a/doc/guides/eventdevs/index.rst b/doc/guides/eventdevs/index.rst index 570905b81..540ac762c 100644 --- a/doc/guides/eventdevs/index.rst +++ b/doc/guides/eventdevs/index.rst @@ -11,6 +11,7 @@ application trough the eventdev API. :maxdepth: 2 :numbered: + overview dpaa dpaa2 dsw diff --git a/doc/guides/eventdevs/overview.rst b/doc/guides/eventdevs/overview.rst new file mode 100644 index 000000000..6825b9007 --- /dev/null +++ b/doc/guides/eventdevs/overview.rst @@ -0,0 +1,19 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(C) 2019 Marvell International Ltd. + +Event Device Supported Functionality Matrices +============================================= + +Event Device Supported Feature Flags +------------------------------------ + +.. _table_eventdev_pmd_features: + +.. include:: overview_feature_table.txt + +Adapter Supported Feature Flags +------------------------------- + +.. _table_adapter_features: + +.. include:: overview_adptr_feature_table.txt From patchwork Tue Dec 3 06:27:48 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sunil Kumar Kori X-Patchwork-Id: 63512 X-Patchwork-Delegate: jerinj@marvell.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 249A3A04B5; Tue, 3 Dec 2019 07:29:04 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id E60B358C4; Tue, 3 Dec 2019 07:29:03 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0a-0016f401.pphosted.com [67.231.148.174]) by dpdk.org (Postfix) with ESMTP id 7F450235 for ; Tue, 3 Dec 2019 07:29:02 +0100 (CET) Received: from pps.filterd (m0045849.ppops.net [127.0.0.1]) by mx0a-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id xB36GcOV031832; Mon, 2 Dec 2019 22:29:01 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type; s=pfpt0818; bh=cAOKpwoa3BIYpk1SxmJGQuorTKcJYm6Im4hwCuWVcZQ=; b=e0R1wfxzf9ZpoJ3nu1FAHSZD4LICP5aar5Ih4tkrMqwgL+KFtLsF7Q1E+z5QHn06XKiZ JooNcG6WGkqUtN3+gUyDtIrXrIp7LnQUX9vup7sn41sOc0jglip3XQzzdAlaJSomPeq+ VWn4x9Q0UGqsWPpRNwuHNzI14YHe0BH3LJxldnR+CBHA+tNJPvhYwMu3R17YAn7zF8bC +aUm3yf018OS9Dbsx1GRe+4wmXhuXVO6+cGVQqVvfSjLifJQBODJbBQ6+JBsyBQSxbJD 96Ij9w2oiNrAjRIYkZiRZ0rCP/4acUjvmMHa4GFi1YNkqB06uJCXShTL3YmjkBpoG4xB wA== Received: from sc-exch02.marvell.com ([199.233.58.182]) by mx0a-0016f401.pphosted.com with ESMTP id 2wkpnwaa56-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Mon, 02 Dec 2019 22:29:01 -0800 Received: from SC-EXCH01.marvell.com (10.93.176.81) by SC-EXCH02.marvell.com (10.93.176.82) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Mon, 2 Dec 2019 22:29:00 -0800 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Mon, 2 Dec 2019 22:29:00 -0800 Received: from localhost.localdomain (unknown [10.28.34.200]) by maili.marvell.com (Postfix) with ESMTP id 740DD3F703F; Mon, 2 Dec 2019 22:28:57 -0800 (PST) From: Sunil Kumar Kori To: , , , , , , , , John McNamara , "Marko Kovacevic" CC: , Sunil Kumar Kori Date: Tue, 3 Dec 2019 11:57:48 +0530 Message-ID: <20191203062749.23319-2-skori@marvell.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20191203062749.23319-1-skori@marvell.com> References: <20191121074452.2291-1-skori@marvell.com> <20191203062749.23319-1-skori@marvell.com> MIME-Version: 1.0 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.95,18.0.572 definitions=2019-12-03_01:2019-11-29,2019-12-03 signatures=0 Subject: [dpdk-dev] [PATCH v3 2/3] doc: update eventdev feature matrix for octeontx2 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Patch updates eventdev and adapters feature matrices for octeontx2 platform. Signed-off-by: Sunil Kumar Kori --- v3: - Removed .txt files to generate tables. v2: - Review comments incorporated doc/guides/eventdevs/features/octeontx2.ini | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/doc/guides/eventdevs/features/octeontx2.ini b/doc/guides/eventdevs/features/octeontx2.ini index 96f1af0dc..4c50b2125 100644 --- a/doc/guides/eventdevs/features/octeontx2.ini +++ b/doc/guides/eventdevs/features/octeontx2.ini @@ -4,5 +4,14 @@ ; Refer to default.ini for the full list of available PMD features. ; [Features] +Event queue priority based scheduling = Y +Event device distributed scheduling = Y +Event device non sequential mode = Y +Event queue all types = Y +Runtime event queue/port linking = Y +Multi queue linking per port = Y [Adapter Features] +Eth Rx/Tx adapter on internal port = Y +Multiple event queues per ethdev = Y +Timer adapter support in H/W = Y From patchwork Tue Dec 3 06:27:49 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sunil Kumar Kori X-Patchwork-Id: 63513 X-Patchwork-Delegate: jerinj@marvell.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id F0251A04B5; Tue, 3 Dec 2019 07:29:09 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A8EEB37AF; Tue, 3 Dec 2019 07:29:09 +0100 (CET) Received: from mx0b-0016f401.pphosted.com (mx0b-0016f401.pphosted.com [67.231.156.173]) by dpdk.org (Postfix) with ESMTP id 447FF4C99 for ; Tue, 3 Dec 2019 07:29:08 +0100 (CET) Received: from pps.filterd (m0045851.ppops.net [127.0.0.1]) by mx0b-0016f401.pphosted.com (8.16.0.42/8.16.0.42) with SMTP id xB36FgqT013704; Mon, 2 Dec 2019 22:29:07 -0800 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : in-reply-to : references : mime-version : content-type; s=pfpt0818; bh=KShf0DVZt2W4TvZdV8ycdKZtLwzRUoLJGMMMH1sB29U=; b=A45YnGwWfC9wkf+m9BzPqLixRfzT9qADM7BQ8fexmF7XtVsp4U+PAf1u4nB5AlzttP6V ISqm1k6hcCzj5RJ0GAiRlzPfzg6Qwvt0iIeZuMoGZB6jgiJbWYt1sJOus/jsJ1Ark6B8 zNNL7CWX2PY4O8Edn6CW7kNFznwfIM9VSavvKbPK7W3mTxkbsVhMzKKKf/UHImMMsmfu ZzF7pE7LGvWK5S/YV9EB9N6NCsMIUnBzPECPqaCxVD3tN+N6nwWq+LnpXqh0mIjogOaU 4kUW8Ls0Uq7NGGTmOe6Ofd5j9c4710ueCOfzGfQzLz9I/qtIUiZqO+HU5j4vMp00CxIE Cg== Received: from sc-exch04.marvell.com ([199.233.58.184]) by mx0b-0016f401.pphosted.com with ESMTP id 2wkrtshqft-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Mon, 02 Dec 2019 22:29:07 -0800 Received: from SC-EXCH03.marvell.com (10.93.176.83) by SC-EXCH04.marvell.com (10.93.176.84) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Mon, 2 Dec 2019 22:29:06 -0800 Received: from maili.marvell.com (10.93.176.43) by SC-EXCH03.marvell.com (10.93.176.83) with Microsoft SMTP Server id 15.0.1367.3 via Frontend Transport; Mon, 2 Dec 2019 22:29:06 -0800 Received: from localhost.localdomain (unknown [10.28.34.200]) by maili.marvell.com (Postfix) with ESMTP id C396E3F7043; Mon, 2 Dec 2019 22:29:02 -0800 (PST) From: Sunil Kumar Kori To: , , , , , , , , John McNamara , "Marko Kovacevic" CC: , Sunil Kumar Kori Date: Tue, 3 Dec 2019 11:57:49 +0530 Message-ID: <20191203062749.23319-3-skori@marvell.com> X-Mailer: git-send-email 2.17.1 In-Reply-To: <20191203062749.23319-1-skori@marvell.com> References: <20191121074452.2291-1-skori@marvell.com> <20191203062749.23319-1-skori@marvell.com> MIME-Version: 1.0 X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.95,18.0.572 definitions=2019-12-03_01:2019-11-29,2019-12-03 signatures=0 Subject: [dpdk-dev] [PATCH v3 3/3] doc: update eventdev feature matrix for octeontx X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Patch updates eventdev and adapters feature matrices for octeontx platform. Signed-off-by: Sunil Kumar Kori --- v3: - Removed .txt files to generate tables. v2: - Review comments incorporated doc/guides/eventdevs/features/octeontx.ini | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/eventdevs/features/octeontx.ini b/doc/guides/eventdevs/features/octeontx.ini index d1b1fe6d6..a116e7998 100644 --- a/doc/guides/eventdevs/features/octeontx.ini +++ b/doc/guides/eventdevs/features/octeontx.ini @@ -4,5 +4,13 @@ ; Refer to default.ini for the full list of available PMD features. ; [Features] +Event queue priority based scheduling = Y +Event device distributed scheduling = Y +Event device non sequential mode = Y +Event queue all types = Y +Runtime event queue/port linking = Y +Multi queue linking per port = Y [Adapter Features] +Eth Rx/Tx adapter on internal port = Y +Timer adapter support in H/W = Y