[dpdk-dev] [PATCH 1/3] doc: add skeleton for eventdevs feature metrices

[dpdk-dev] [PATCH 1/3] doc: add skeleton for eventdevs feature metrices

[Sunil Kumar Kori]

Patch adds skeleton for feature metrices for event dev
and Rx/Tx adapters.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
 doc/guides/eventdevs/index.rst                |  1 +
 doc/guides/eventdevs/overview.rst             | 19 +++++
 .../overview_adptr_feature_table.txt          | 76 +++++++++++++++++
 .../eventdevs/overview_feature_table.txt      | 82 +++++++++++++++++++
 4 files changed, 178 insertions(+)
 create mode 100644 doc/guides/eventdevs/overview.rst
 create mode 100644 doc/guides/eventdevs/overview_adptr_feature_table.txt
 create mode 100644 doc/guides/eventdevs/overview_feature_table.txt

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
diff --git a/doc/guides/eventdevs/overview_adptr_feature_table.txt b/doc/guides/eventdevs/overview_adptr_feature_table.txt
new file mode 100644
index 000000000..4f4887ea8
--- /dev/null
+++ b/doc/guides/eventdevs/overview_adptr_feature_table.txt
@@ -0,0 +1,76 @@
+
+.. raw:: html
+
+   <style>
+      .wy-nav-content {
+         opacity: .99;
+      }
+      table#id1 {
+         cursor: default;
+         overflow: hidden;
+      }
+      table#id1 th, table#id1 td {
+         text-align: center;
+      }
+      table#id1 th {
+         font-size: 72%;
+         white-space: pre-wrap;
+         vertical-align: top;
+         padding: 0.5em 0;
+         min-width: 0.9em;
+         width: 2em;
+      }
+      table#id1 col:first-child {
+         width: 0;
+      }
+      table#id1 th:first-child {
+         vertical-align: bottom;
+      }
+      table#id1 td {
+         font-size: 70%;
+         padding: 1px;
+      }
+      table#id1 td:first-child {
+         padding-left: 1em;
+         text-align: left;
+      }
+      table#id1 tr:nth-child(2n-1) td {
+         background-color: rgba(210, 210, 210, 0.2);
+      }
+      table#id1 th:not(:first-child):hover,
+      table#id1 td:not(:first-child):hover {
+         position: relative;
+      }
+      table#id1 th:not(:first-child):hover::after,
+      table#id1 td:not(:first-child):hover::after {
+         content: '';
+         height: 6000px;
+         top: -3000px;
+         width: 100%;
+         left: 0;
+         position: absolute;
+         z-index: -1;
+         background-color: #ffb;
+      }
+      table#id1 tr:hover td {
+         background-color: #ffb;
+      }
+   </style>
+
+.. table:: Features availability for adapters
+
+   ================================ = = = = = = =
+   Feature                          d d d o o o s
+                                    p p s c c p w
+                                    a a w t t d
+                                    a a   e e l
+                                      2   o o
+                                          n n
+                                          t t
+                                          x x
+                                            2
+   ================================ = = = = = = =
+   Rx/Tx on internal port
+   Multiple event queues per ethdev
+   Override flow ID
+   ================================ = = = = = = =
diff --git a/doc/guides/eventdevs/overview_feature_table.txt b/doc/guides/eventdevs/overview_feature_table.txt
new file mode 100644
index 000000000..c2e9bd289
--- /dev/null
+++ b/doc/guides/eventdevs/overview_feature_table.txt
@@ -0,0 +1,82 @@
+
+.. raw:: html
+
+   <style>
+      .wy-nav-content {
+         opacity: .99;
+      }
+      table#id1 {
+         cursor: default;
+         overflow: hidden;
+      }
+      table#id1 th, table#id1 td {
+         text-align: center;
+      }
+      table#id1 th {
+         font-size: 72%;
+         white-space: pre-wrap;
+         vertical-align: top;
+         padding: 0.5em 0;
+         min-width: 0.9em;
+         width: 2em;
+      }
+      table#id1 col:first-child {
+         width: 0;
+      }
+      table#id1 th:first-child {
+         vertical-align: bottom;
+      }
+      table#id1 td {
+         font-size: 70%;
+         padding: 1px;
+      }
+      table#id1 td:first-child {
+         padding-left: 1em;
+         text-align: left;
+      }
+      table#id1 tr:nth-child(2n-1) td {
+         background-color: rgba(210, 210, 210, 0.2);
+      }
+      table#id1 th:not(:first-child):hover,
+      table#id1 td:not(:first-child):hover {
+         position: relative;
+      }
+      table#id1 th:not(:first-child):hover::after,
+      table#id1 td:not(:first-child):hover::after {
+         content: '';
+         height: 6000px;
+         top: -3000px;
+         width: 100%;
+         left: 0;
+         position: absolute;
+         z-index: -1;
+         background-color: #ffb;
+      }
+      table#id1 tr:hover td {
+         background-color: #ffb;
+      }
+   </style>
+
+.. table:: Features availability in eventdev drivers
+
+   ===================================== = = = = = = =
+   Feature                               d d d o o o s
+                                         p p s c c p w
+                                         a a w t t d
+                                         a a   e e l
+                                           2   o o
+                                               n n
+                                               t t
+                                               x x
+                                                 2
+   ===================================== = = = = = = =
+   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
+   ===================================== = = = = = = =
-- 
2.17.1

[dpdk-dev] [PATCH 2/3] doc: update eventdev feature matrix for octeontx2

[Sunil Kumar Kori]

Patch updates eventdev and adapters feature metrices for octeontx2
platform.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
 doc/guides/eventdevs/features/octeontx2.ini      | 16 ++++++++++++++++
 .../eventdevs/overview_adptr_feature_table.txt   |  4 ++--
 doc/guides/eventdevs/overview_feature_table.txt  | 12 ++++++------
 3 files changed, 24 insertions(+), 8 deletions(-)
 create mode 100644 doc/guides/eventdevs/features/octeontx2.ini

diff --git a/doc/guides/eventdevs/features/octeontx2.ini b/doc/guides/eventdevs/features/octeontx2.ini
new file mode 100644
index 000000000..05718e4ac
--- /dev/null
+++ b/doc/guides/eventdevs/features/octeontx2.ini
@@ -0,0 +1,16 @@
+;
+; Supported features of the 'octeontx2' eventdev driver.
+;
+; 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]
+Rx/Tx on internal port           = Y
+Multiple event queues per ethdev = Y
diff --git a/doc/guides/eventdevs/overview_adptr_feature_table.txt b/doc/guides/eventdevs/overview_adptr_feature_table.txt
index 4f4887ea8..11c66eb49 100644
--- a/doc/guides/eventdevs/overview_adptr_feature_table.txt
+++ b/doc/guides/eventdevs/overview_adptr_feature_table.txt
@@ -70,7 +70,7 @@
                                           x x
                                             2
    ================================ = = = = = = =
-   Rx/Tx on internal port
-   Multiple event queues per ethdev
+   Rx/Tx on internal port                   Y
+   Multiple event queues per ethdev         Y
    Override flow ID
    ================================ = = = = = = =
diff --git a/doc/guides/eventdevs/overview_feature_table.txt b/doc/guides/eventdevs/overview_feature_table.txt
index c2e9bd289..c4d3bd6d4 100644
--- a/doc/guides/eventdevs/overview_feature_table.txt
+++ b/doc/guides/eventdevs/overview_feature_table.txt
@@ -70,13 +70,13 @@
                                                x x
                                                  2
    ===================================== = = = = = = =
-   Event queue priority based scheduling
+   Event queue priority based scheduling         Y
    Event priority based scheduling
-   Event device distributed scheduling
-   Event device non sequential mode
-   Event queue all types
+   Event device distributed scheduling           Y
+   Event device non sequential mode              Y
+   Event queue all types                         Y
    Burst mode enqueue/dequeue
    Event port implicit release disable
-   Runtime event queue/port linking
-   Multi queue linking per port
+   Runtime event queue/port linking              Y
+   Multi queue linking per port                  Y
    ===================================== = = = = = = =
-- 
2.17.1

[dpdk-dev] [PATCH 3/3] doc: update eventdev feature matrix for octeontx

[Sunil Kumar Kori]

Patch updates eventdev and adapters feature metrices for octeontx2
platform.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
 doc/guides/eventdevs/features/octeontx.ini        | 15 +++++++++++++++
 .../eventdevs/overview_adptr_feature_table.txt    |  2 +-
 doc/guides/eventdevs/overview_feature_table.txt   | 12 ++++++------
 3 files changed, 22 insertions(+), 7 deletions(-)
 create mode 100644 doc/guides/eventdevs/features/octeontx.ini

diff --git a/doc/guides/eventdevs/features/octeontx.ini b/doc/guides/eventdevs/features/octeontx.ini
new file mode 100644
index 000000000..af6700711
--- /dev/null
+++ b/doc/guides/eventdevs/features/octeontx.ini
@@ -0,0 +1,15 @@
+;
+; Supported features of the 'octeontx2' eventdev driver.
+;
+; 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]
+Rx/Tx on internal port           = Y
diff --git a/doc/guides/eventdevs/overview_adptr_feature_table.txt b/doc/guides/eventdevs/overview_adptr_feature_table.txt
index 11c66eb49..b5715713f 100644
--- a/doc/guides/eventdevs/overview_adptr_feature_table.txt
+++ b/doc/guides/eventdevs/overview_adptr_feature_table.txt
@@ -70,7 +70,7 @@
                                           x x
                                             2
    ================================ = = = = = = =
-   Rx/Tx on internal port                   Y
+   Rx/Tx on internal port                 Y Y
    Multiple event queues per ethdev         Y
    Override flow ID
    ================================ = = = = = = =
diff --git a/doc/guides/eventdevs/overview_feature_table.txt b/doc/guides/eventdevs/overview_feature_table.txt
index c4d3bd6d4..e48893378 100644
--- a/doc/guides/eventdevs/overview_feature_table.txt
+++ b/doc/guides/eventdevs/overview_feature_table.txt
@@ -70,13 +70,13 @@
                                                x x
                                                  2
    ===================================== = = = = = = =
-   Event queue priority based scheduling         Y
+   Event queue priority based scheduling       Y Y
    Event priority based scheduling
-   Event device distributed scheduling           Y
-   Event device non sequential mode              Y
-   Event queue all types                         Y
+   Event device distributed scheduling         Y Y
+   Event device non sequential mode            Y Y
+   Event queue all types                       Y Y
    Burst mode enqueue/dequeue
    Event port implicit release disable
-   Runtime event queue/port linking              Y
-   Multi queue linking per port                  Y
+   Runtime event queue/port linking            Y Y
+   Multi queue linking per port                Y Y
    ===================================== = = = = = = =
-- 
2.17.1

Re: [dpdk-dev] [PATCH 1/3] doc: add skeleton for eventdevs feature metrices

[Jerin Jacob]

On Thu, Nov 7, 2019 at 4:42 PM Sunil Kumar Kori <skori@marvell.com> wrote:
>
> Patch adds skeleton for feature metrices for event dev

s/metrices/matrices

> and Rx/Tx adapters.
>
> Signed-off-by: Sunil Kumar Kori <skori@marvell.com>

> +
> +   ================================ = = = = = = =
> +   Feature                          d d d o o o s
> +                                    p p s c c p w
> +                                    a a w t t d
> +                                    a a   e e l
> +                                      2   o o
> +                                          n n
> +                                          t t
> +                                          x x
> +                                            2
> +   ================================ = = = = = = =
> +   Rx/Tx on internal port
> +   Multiple event queues per ethdev
> +   Override flow ID
> +   ================================ = = = = = = =

I think we can have additional rows for the  Crypto Adapter, and Timer adapter.


> +   ===================================== = = = = = = =
> +   Feature                               d d d o o o s
> +                                         p p s c c p w
> +                                         a a w t t d
> +                                         a a   e e l
> +                                           2   o o
> +                                               n n
> +                                               t t
> +                                               x x
> +                                                 2
> +   ===================================== = = = = = = =
> +   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
> +   ===================================== = = = = = = =

@ All eventdev PMD maintainers.

Do you like to have any more features in the eventdev and adapter list?


> --
> 2.17.1
>

[dpdk-dev] [PATCH v2 1/3] doc: add skeleton for eventdevs feature matrices

[Sunil Kumar Kori]

Patch adds skeleton for feature matrices for event dev
and Rx/Tx adapters.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
v2:
 - Review comments incorporated

 doc/guides/eventdevs/index.rst                |  1 +
 doc/guides/eventdevs/overview.rst             | 19 +++++
 .../overview_adptr_feature_table.txt          | 81 ++++++++++++++++++
 .../eventdevs/overview_feature_table.txt      | 82 +++++++++++++++++++
 4 files changed, 183 insertions(+)
 create mode 100644 doc/guides/eventdevs/overview.rst
 create mode 100644 doc/guides/eventdevs/overview_adptr_feature_table.txt
 create mode 100644 doc/guides/eventdevs/overview_feature_table.txt

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
diff --git a/doc/guides/eventdevs/overview_adptr_feature_table.txt b/doc/guides/eventdevs/overview_adptr_feature_table.txt
new file mode 100644
index 000000000..a2e2c0ab3
--- /dev/null
+++ b/doc/guides/eventdevs/overview_adptr_feature_table.txt
@@ -0,0 +1,81 @@
+
+.. raw:: html
+
+   <style>
+      .wy-nav-content {
+         opacity: .99;
+      }
+      table#id1 {
+         cursor: default;
+         overflow: hidden;
+      }
+      table#id1 th, table#id1 td {
+         text-align: center;
+      }
+      table#id1 th {
+         font-size: 72%;
+         white-space: pre-wrap;
+         vertical-align: top;
+         padding: 0.5em 0;
+         min-width: 0.9em;
+         width: 2em;
+      }
+      table#id1 col:first-child {
+         width: 0;
+      }
+      table#id1 th:first-child {
+         vertical-align: bottom;
+      }
+      table#id1 td {
+         font-size: 70%;
+         padding: 1px;
+      }
+      table#id1 td:first-child {
+         padding-left: 1em;
+         text-align: left;
+      }
+      table#id1 tr:nth-child(2n-1) td {
+         background-color: rgba(210, 210, 210, 0.2);
+      }
+      table#id1 th:not(:first-child):hover,
+      table#id1 td:not(:first-child):hover {
+         position: relative;
+      }
+      table#id1 th:not(:first-child):hover::after,
+      table#id1 td:not(:first-child):hover::after {
+         content: '';
+         height: 6000px;
+         top: -3000px;
+         width: 100%;
+         left: 0;
+         position: absolute;
+         z-index: -1;
+         background-color: #ffb;
+      }
+      table#id1 tr:hover td {
+         background-color: #ffb;
+      }
+   </style>
+
+.. table:: Features availability for adapters
+
+   ========================================== = = = = = = =
+   Feature                                    d d d o o o s
+                                              p p s c c p w
+                                              a a w t t d
+                                              a a   e e l
+                                                2   o o
+                                                    n n
+                                                    t t
+                                                    x x
+                                                      2
+   ========================================== = = = = = = =
+   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/overview_feature_table.txt b/doc/guides/eventdevs/overview_feature_table.txt
new file mode 100644
index 000000000..c2e9bd289
--- /dev/null
+++ b/doc/guides/eventdevs/overview_feature_table.txt
@@ -0,0 +1,82 @@
+
+.. raw:: html
+
+   <style>
+      .wy-nav-content {
+         opacity: .99;
+      }
+      table#id1 {
+         cursor: default;
+         overflow: hidden;
+      }
+      table#id1 th, table#id1 td {
+         text-align: center;
+      }
+      table#id1 th {
+         font-size: 72%;
+         white-space: pre-wrap;
+         vertical-align: top;
+         padding: 0.5em 0;
+         min-width: 0.9em;
+         width: 2em;
+      }
+      table#id1 col:first-child {
+         width: 0;
+      }
+      table#id1 th:first-child {
+         vertical-align: bottom;
+      }
+      table#id1 td {
+         font-size: 70%;
+         padding: 1px;
+      }
+      table#id1 td:first-child {
+         padding-left: 1em;
+         text-align: left;
+      }
+      table#id1 tr:nth-child(2n-1) td {
+         background-color: rgba(210, 210, 210, 0.2);
+      }
+      table#id1 th:not(:first-child):hover,
+      table#id1 td:not(:first-child):hover {
+         position: relative;
+      }
+      table#id1 th:not(:first-child):hover::after,
+      table#id1 td:not(:first-child):hover::after {
+         content: '';
+         height: 6000px;
+         top: -3000px;
+         width: 100%;
+         left: 0;
+         position: absolute;
+         z-index: -1;
+         background-color: #ffb;
+      }
+      table#id1 tr:hover td {
+         background-color: #ffb;
+      }
+   </style>
+
+.. table:: Features availability in eventdev drivers
+
+   ===================================== = = = = = = =
+   Feature                               d d d o o o s
+                                         p p s c c p w
+                                         a a w t t d
+                                         a a   e e l
+                                           2   o o
+                                               n n
+                                               t t
+                                               x x
+                                                 2
+   ===================================== = = = = = = =
+   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
+   ===================================== = = = = = = =
-- 
2.17.1

[dpdk-dev] [PATCH v2 2/3] doc: update eventdev feature matrix for octeontx2

[Sunil Kumar Kori]

Patch updates eventdev and adapters feature matrices for octeontx2
platform.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
v2:
 - Review comments incorporated

 doc/guides/eventdevs/features/octeontx2.ini     | 17 +++++++++++++++++
 .../eventdevs/overview_adptr_feature_table.txt  |  6 +++---
 doc/guides/eventdevs/overview_feature_table.txt | 12 ++++++------
 3 files changed, 26 insertions(+), 9 deletions(-)
 create mode 100644 doc/guides/eventdevs/features/octeontx2.ini

diff --git a/doc/guides/eventdevs/features/octeontx2.ini b/doc/guides/eventdevs/features/octeontx2.ini
new file mode 100644
index 000000000..4c50b2125
--- /dev/null
+++ b/doc/guides/eventdevs/features/octeontx2.ini
@@ -0,0 +1,17 @@
+;
+; Supported features of the 'octeontx2' eventdev driver.
+;
+; 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
diff --git a/doc/guides/eventdevs/overview_adptr_feature_table.txt b/doc/guides/eventdevs/overview_adptr_feature_table.txt
index a2e2c0ab3..9aac52069 100644
--- a/doc/guides/eventdevs/overview_adptr_feature_table.txt
+++ b/doc/guides/eventdevs/overview_adptr_feature_table.txt
@@ -70,12 +70,12 @@
                                                     x x
                                                       2
    ========================================== = = = = = = =
-   Eth Rx/Tx adapter on internal port
-   Multiple event queues per ethdev
+   Eth Rx/Tx adapter on internal port                 Y
+   Multiple event queues per ethdev                   Y
    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
+   Timer adapter support in H/W                       Y
    ========================================== = = = = = = =
diff --git a/doc/guides/eventdevs/overview_feature_table.txt b/doc/guides/eventdevs/overview_feature_table.txt
index c2e9bd289..c4d3bd6d4 100644
--- a/doc/guides/eventdevs/overview_feature_table.txt
+++ b/doc/guides/eventdevs/overview_feature_table.txt
@@ -70,13 +70,13 @@
                                                x x
                                                  2
    ===================================== = = = = = = =
-   Event queue priority based scheduling
+   Event queue priority based scheduling         Y
    Event priority based scheduling
-   Event device distributed scheduling
-   Event device non sequential mode
-   Event queue all types
+   Event device distributed scheduling           Y
+   Event device non sequential mode              Y
+   Event queue all types                         Y
    Burst mode enqueue/dequeue
    Event port implicit release disable
-   Runtime event queue/port linking
-   Multi queue linking per port
+   Runtime event queue/port linking              Y
+   Multi queue linking per port                  Y
    ===================================== = = = = = = =
-- 
2.17.1

[dpdk-dev] [PATCH v2 3/3] doc: update eventdev feature matrix for octeontx

[Sunil Kumar Kori]

Patch updates eventdev and adapters feature matrices for octeontx
platform.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
v2:
 - Review comments incorporated

 doc/guides/eventdevs/features/octeontx.ini       | 16 ++++++++++++++++
 .../eventdevs/overview_adptr_feature_table.txt   |  4 ++--
 doc/guides/eventdevs/overview_feature_table.txt  | 12 ++++++------
 3 files changed, 24 insertions(+), 8 deletions(-)
 create mode 100644 doc/guides/eventdevs/features/octeontx.ini

diff --git a/doc/guides/eventdevs/features/octeontx.ini b/doc/guides/eventdevs/features/octeontx.ini
new file mode 100644
index 000000000..27cde77cd
--- /dev/null
+++ b/doc/guides/eventdevs/features/octeontx.ini
@@ -0,0 +1,16 @@
+;
+; Supported features of the 'octeontx2' eventdev driver.
+;
+; 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
diff --git a/doc/guides/eventdevs/overview_adptr_feature_table.txt b/doc/guides/eventdevs/overview_adptr_feature_table.txt
index 9aac52069..6ebdc098f 100644
--- a/doc/guides/eventdevs/overview_adptr_feature_table.txt
+++ b/doc/guides/eventdevs/overview_adptr_feature_table.txt
@@ -70,12 +70,12 @@
                                                     x x
                                                       2
    ========================================== = = = = = = =
-   Eth Rx/Tx adapter on internal port                 Y
+   Eth Rx/Tx adapter on internal port               Y Y
    Multiple event queues per ethdev                   Y
    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                       Y
+   Timer adapter support in H/W                     Y Y
    ========================================== = = = = = = =
diff --git a/doc/guides/eventdevs/overview_feature_table.txt b/doc/guides/eventdevs/overview_feature_table.txt
index c4d3bd6d4..e48893378 100644
--- a/doc/guides/eventdevs/overview_feature_table.txt
+++ b/doc/guides/eventdevs/overview_feature_table.txt
@@ -70,13 +70,13 @@
                                                x x
                                                  2
    ===================================== = = = = = = =
-   Event queue priority based scheduling         Y
+   Event queue priority based scheduling       Y Y
    Event priority based scheduling
-   Event device distributed scheduling           Y
-   Event device non sequential mode              Y
-   Event queue all types                         Y
+   Event device distributed scheduling         Y Y
+   Event device non sequential mode            Y Y
+   Event queue all types                       Y Y
    Burst mode enqueue/dequeue
    Event port implicit release disable
-   Runtime event queue/port linking              Y
-   Multi queue linking per port                  Y
+   Runtime event queue/port linking            Y Y
+   Multi queue linking per port                Y Y
    ===================================== = = = = = = =
-- 
2.17.1

Re: [dpdk-dev] [PATCH v2 1/3] doc: add skeleton for eventdevs feature matrices

[Thomas Monjalon]

21/11/2019 08:44, Sunil Kumar Kori:
> Patch adds skeleton for feature matrices for event dev
> and Rx/Tx adapters.
[...]
> +.. table:: Features availability in eventdev drivers
> +
> +   ===================================== = = = = = = =
> +   Feature                               d d d o o o s
> +                                         p p s c c p w
> +                                         a a w t t d
> +                                         a a   e e l
> +                                           2   o o
> +                                               n n
> +                                               t t
> +                                               x x
> +                                                 2
> +   ===================================== = = = = = = =
> +   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
> +   ===================================== = = = = = = =

This table should be automatically generated from conf.py.

(Ideally we should have a custom sphinx class for it)

Please rework and do not commit such .txt file, thanks

[dpdk-dev] [PATCH v3 1/3] doc: add skeleton for eventdevs feature matrices

[Sunil Kumar Kori]

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 <skori@marvell.com>
---
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
-- 
2.17.1

[dpdk-dev] [PATCH v3 2/3] doc: update eventdev feature matrix for octeontx2

[Sunil Kumar Kori]

Patch updates eventdev and adapters feature matrices for octeontx2
platform.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
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
-- 
2.17.1

[dpdk-dev] [PATCH v3 3/3] doc: update eventdev feature matrix for octeontx

[Sunil Kumar Kori]

Patch updates eventdev and adapters feature matrices for octeontx
platform.

Signed-off-by: Sunil Kumar Kori <skori@marvell.com>
---
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
-- 
2.17.1