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

Message ID 1515549715-3566-1-git-send-email-beilei.xing@intel.com (mailing list archive)
State Accepted, 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. 10, 2018, 2:01 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>
Acked-by: John McNamara <john.mcnamara@intel.com>
---

v3 changes:
 - Rebase on the latest sub tree of dpdk-next-net-intel.

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, 2:44 a.m. UTC | #1
> -----Original Message-----

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

> Sent: Wednesday, January 10, 2018 10:02 AM

> To: Mcnamara, John

> Cc: dev@dpdk.org

> Subject: [dpdk-dev] [PATCH v3] 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>

> Acked-by: John McNamara <john.mcnamara@intel.com>

Applied to dpdk-next-net-intel, thanks!

/Helin
  
Thomas Monjalon Jan. 16, 2018, 10:01 p.m. UTC | #2
10/01/2018 03:01, Beilei Xing:
> --- a/doc/guides/rel_notes/release_18_02.rst
> +++ b/doc/guides/rel_notes/release_18_02.rst
> +* **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.

It is mixing features implemented in 17.11 and 17.05.
They should be added in their respective release notes if still relevant.

This part of the patch is removed when pulling next-net in master.
  

Patch

diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index c4c10d3..50d5e36 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
@@ -382,6 +383,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 2e0e796..1440828 100644
--- a/doc/guides/rel_notes/release_18_02.rst
+++ b/doc/guides/rel_notes/release_18_02.rst
@@ -77,6 +77,37 @@  New Features
   1, 2, 4, 8 or 16. If no such parameter is configured, the number of queues
   per VF is 4 by default.
 
+* **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
 -----------