[dpdk-dev,v2] doc: add i40e update

Message ID 1515398332-78518-1-git-send-email-beilei.xing@intel.com (mailing list archive)
State Superseded, archived
Delegated to: Helin Zhang
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK

Commit Message

Xing, Beilei Jan. 8, 2018, 7:58 a.m. UTC
  Update release note to declare MPLSoUDP/MPLSoGRE/
GTP-U/GTP-C/PPPoE/PPPoL2TP steering support in i40e
driver.
Update i40e.rst to declare DDP support and input set
configuration.

Signed-off-by: Beilei Xing <beilei.xing@intel.com>
---

v2 changes:
 - Add DDP support and input set configuration in i40e.rst.

 doc/guides/nics/i40e.rst               | 47 ++++++++++++++++++++++++++++++++++
 doc/guides/rel_notes/release_18_02.rst | 31 ++++++++++++++++++++++
 2 files changed, 78 insertions(+)
  

Comments

Zhang, Helin Jan. 10, 2018, 1:32 a.m. UTC | #1
Hi Beilei

Could you help to rebase it on the latest sub tree of dpdk-next-net-intel? It shows failure duing merge. Thanks!

/Helin

> -----Original Message-----

> From: dev [mailto:dev-bounces@dpdk.org] On Behalf Of Beilei Xing

> Sent: Monday, January 8, 2018 3:59 PM

> To: Mcnamara, John

> Cc: dev@dpdk.org

> Subject: [dpdk-dev] [PATCH v2] doc: add i40e update

> 

> Update release note to declare MPLSoUDP/MPLSoGRE/ GTP-U/GTP-

> C/PPPoE/PPPoL2TP steering support in i40e driver.

> Update i40e.rst to declare DDP support and input set configuration.

> 

> Signed-off-by: Beilei Xing <beilei.xing@intel.com>

> ---

> 

> v2 changes:

>  - Add DDP support and input set configuration in i40e.rst.

> 

>  doc/guides/nics/i40e.rst               | 47 ++++++++++++++++++++++++++++++++++

>  doc/guides/rel_notes/release_18_02.rst | 31 ++++++++++++++++++++++

>  2 files changed, 78 insertions(+)

> 

> diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst index

> 2507d5f..789d6d6 100644

> --- a/doc/guides/nics/i40e.rst

> +++ b/doc/guides/nics/i40e.rst

> @@ -65,6 +65,7 @@ Features of the I40E PMD are:

>  - Hot plug

>  - IEEE1588/802.1AS timestamping

>  - VF Daemon (VFD) - EXPERIMENTAL

> +- Dynamic Device Personalization (DDP)

> 

> 

>  Prerequisites

> @@ -374,6 +375,52 @@ configuration passed on the EAL command line.

>  The floating VEB functionality requires a NIC firmware version of 5.0  or

> greater.

> 

> +Dynamic Device Personalization (DDP)

> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

> +

> +The Intel® Ethernet Controller X*710 support a feature called "Dynamic

> +Device Personalization (DDP)", which is used to configure hardware by

> +downloading a profile to support protocols/filters which are not supported by

> default.

> +The DDP functionality requires a NIC firmware version of 6.0 or greater.

> +

> +Current implementation supports

> +MPLSoUDP/MPLSoGRE/GTP-C/GTP-U/PPPoE/PPPoL2TP,

> +steering can be used with rte_flow API.

> +

> +Load a profile which supports MPLSoUDP/MPLSoGRE:

> +

> +.. code-block:: console

> +

> +   testpmd> ddp add 0 ./mpls.pkgo

> +

> +Delete a MPLS profile:

> +

> +.. code-block:: console

> +

> +   testpmd> ddp del 0 ./mpls.pkgo

> +

> +Get loaded DDP package info list:

> +

> +.. code-block:: console

> +

> +   testpmd> ddp get list 0

> +

> +Display information about a MPLS profile:

> +

> +.. code-block:: console

> +

> +   testpmd> ddp get info ./mpls.pkgo

> +

> +Input set configuration

> +~~~~~~~~~~~~~~~~~~~~~~~

> +Input set for any PCTYPE can be configured with user defined

> +configuration, For example, to use only 48bit prefix for IPv6 src address for

> IPv6 TCP RSS:

> +

> +.. code-block:: console

> +

> +   testpmd> port config 0 pctype 43 hash_inset clear all

> +   testpmd> port config 0 pctype 43 hash_inset set field 13

> +   testpmd> port config 0 pctype 43 hash_inset set field 14

> +   testpmd> port config 0 pctype 43 hash_inset set field 15

> 

>  Limitations or Known issues

>  ---------------------------

> diff --git a/doc/guides/rel_notes/release_18_02.rst

> b/doc/guides/rel_notes/release_18_02.rst

> index 621b8f5..b016c54 100644

> --- a/doc/guides/rel_notes/release_18_02.rst

> +++ b/doc/guides/rel_notes/release_18_02.rst

> @@ -47,6 +47,37 @@ New Features

>    users. According to the device configuration, it will setup TX->RX loopback

>    link or not.

> 

> +* **Updated i40e driver to support MPLSoUDP/MPLSoGRE.**

> +

> +  Updated i40e PMD to support MPLSoUDP/MPLSoGRE with

> MPLSoUDP/MPLSoGRE

> + supporting profiles which can be programmed by dynamic device

> + personalization (DDP) process:

> +

> +  * Support cloud filer of MPLSoUDP/MPLSoGRE flow based on MPLS label.

> +

> +  This feature was implemented in release_17_05.

> +

> +* **Updated i40e driver to support GTP-C/GTP-U.**

> +

> +  Updated i40e PMD to support GTP-C/GTP-U with GTP-C/GTP-U supporting

> + profiles which can be programmed by dynamic device personalization

> + (DDP)

> +  process:

> +

> +  * Support RSS of GTP-C/GTP-U flow.

> +  * Support flow director of GTP-C/GTP-U flow based on TEID.

> +  * Support cloud filer of GTP-C/GTP-U flow based on TEID.

> +

> +  This feature was implemented in release_17_11, and only GTPv1 is

> supported.

> +

> +* **Updated i40e driver to support PPPoE/PPPoL2TP.**

> +

> +  Updated i40e PMD to support PPPoE/PPPoL2TP with PPPoE/PPPoL2TP

> + supporting  profiles which can be programmed by dynamic device

> + personalization (DDP)

> +  process:

> +

> +  * Support RSS of PPPoE/PPPoL2TP flow based on user defined input set.

> +  * Support FDIR of PPPoE/PPPoL2TP flow based on user defined input set.

> +

>  API Changes

>  -----------

> 

> --

> 2.5.5
  

Patch

diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index 2507d5f..789d6d6 100644
--- a/doc/guides/nics/i40e.rst
+++ b/doc/guides/nics/i40e.rst
@@ -65,6 +65,7 @@  Features of the I40E PMD are:
 - Hot plug
 - IEEE1588/802.1AS timestamping
 - VF Daemon (VFD) - EXPERIMENTAL
+- Dynamic Device Personalization (DDP)
 
 
 Prerequisites
@@ -374,6 +375,52 @@  configuration passed on the EAL command line.
 The floating VEB functionality requires a NIC firmware version of 5.0
 or greater.
 
+Dynamic Device Personalization (DDP)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The Intel® Ethernet Controller X*710 support a feature called "Dynamic Device
+Personalization (DDP)", which is used to configure hardware by downloading
+a profile to support protocols/filters which are not supported by default.
+The DDP functionality requires a NIC firmware version of 6.0 or greater.
+
+Current implementation supports MPLSoUDP/MPLSoGRE/GTP-C/GTP-U/PPPoE/PPPoL2TP,
+steering can be used with rte_flow API.
+
+Load a profile which supports MPLSoUDP/MPLSoGRE:
+
+.. code-block:: console
+
+   testpmd> ddp add 0 ./mpls.pkgo
+
+Delete a MPLS profile:
+
+.. code-block:: console
+
+   testpmd> ddp del 0 ./mpls.pkgo
+
+Get loaded DDP package info list:
+
+.. code-block:: console
+
+   testpmd> ddp get list 0
+
+Display information about a MPLS profile:
+
+.. code-block:: console
+
+   testpmd> ddp get info ./mpls.pkgo
+
+Input set configuration
+~~~~~~~~~~~~~~~~~~~~~~~
+Input set for any PCTYPE can be configured with user defined configuration,
+For example, to use only 48bit prefix for IPv6 src address for IPv6 TCP RSS:
+
+.. code-block:: console
+
+   testpmd> port config 0 pctype 43 hash_inset clear all
+   testpmd> port config 0 pctype 43 hash_inset set field 13
+   testpmd> port config 0 pctype 43 hash_inset set field 14
+   testpmd> port config 0 pctype 43 hash_inset set field 15
 
 Limitations or Known issues
 ---------------------------
diff --git a/doc/guides/rel_notes/release_18_02.rst b/doc/guides/rel_notes/release_18_02.rst
index 621b8f5..b016c54 100644
--- a/doc/guides/rel_notes/release_18_02.rst
+++ b/doc/guides/rel_notes/release_18_02.rst
@@ -47,6 +47,37 @@  New Features
   users. According to the device configuration, it will setup TX->RX loopback
   link or not.
 
+* **Updated i40e driver to support MPLSoUDP/MPLSoGRE.**
+
+  Updated i40e PMD to support MPLSoUDP/MPLSoGRE with MPLSoUDP/MPLSoGRE
+  supporting profiles which can be programmed by dynamic device
+  personalization (DDP) process:
+
+  * Support cloud filer of MPLSoUDP/MPLSoGRE flow based on MPLS label.
+
+  This feature was implemented in release_17_05.
+
+* **Updated i40e driver to support GTP-C/GTP-U.**
+
+  Updated i40e PMD to support GTP-C/GTP-U with GTP-C/GTP-U supporting
+  profiles which can be programmed by dynamic device personalization (DDP)
+  process:
+
+  * Support RSS of GTP-C/GTP-U flow.
+  * Support flow director of GTP-C/GTP-U flow based on TEID.
+  * Support cloud filer of GTP-C/GTP-U flow based on TEID.
+
+  This feature was implemented in release_17_11, and only GTPv1 is supported.
+
+* **Updated i40e driver to support PPPoE/PPPoL2TP.**
+
+  Updated i40e PMD to support PPPoE/PPPoL2TP with PPPoE/PPPoL2TP supporting
+  profiles which can be programmed by dynamic device personalization (DDP)
+  process:
+
+  * Support RSS of PPPoE/PPPoL2TP flow based on user defined input set.
+  * Support FDIR of PPPoE/PPPoL2TP flow based on user defined input set.
+
 API Changes
 -----------