[v3] doc: update matching versions in i40e guide

Message ID 20220516055557.21226-1-qiming.yang@intel.com (mailing list archive)
State Superseded, archived
Delegated to: Qi Zhang
Headers
Series [v3] doc: update matching versions in i40e guide |

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation success Compilation OK
ci/intel-Testing success Testing PASS
ci/iol-intel-Functional success Functional Testing PASS
ci/iol-intel-Performance success Performance Testing PASS
ci/github-robot: build success github build: passed
ci/iol-abi-testing success Testing PASS
ci/iol-x86_64-compile-testing fail Testing issues
ci/iol-aarch64-unit-testing success Testing PASS
ci/iol-x86_64-unit-testing success Testing PASS
ci/iol-aarch64-compile-testing success Testing PASS

Commit Message

Qiming Yang May 16, 2022, 5:55 a.m. UTC
  Add recommended matching list for i40e PMD in DPDK 21.05,
21.08, 21.11 and 22.03. And add a known issue when FW upgrade
to a version higher than 8.4.

Cc: stable@dpdk.org

Signed-off-by: Qiming Yang <qiming.yang@intel.com>
---
v2:
* added known issue in FW 8.4+
v3:
* updated x722 FW version
---
 doc/guides/nics/i40e.rst | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)
  

Comments

Kevin Traynor May 16, 2022, 10:29 a.m. UTC | #1
On 16/05/2022 06:55, Qiming Yang wrote:
> Add recommended matching list for i40e PMD in DPDK 21.05,
> 21.08, 21.11 and 22.03. And add a known issue when FW upgrade
> to a version higher than 8.4.
> 

Just a minor thing on the wording, 'version higher than 8.4' suggests 
that 8.4 is not impacted by this known issue.

If 8.4 is impacted then it would be better to say
'version 8.4 and higher.'

> Cc: stable@dpdk.org
> 
> Signed-off-by: Qiming Yang <qiming.yang@intel.com>
> ---
> v2:
> * added known issue in FW 8.4+
> v3:
> * updated x722 FW version
> ---
>   doc/guides/nics/i40e.rst | 23 +++++++++++++++++++++++
>   1 file changed, 23 insertions(+)
> 
> diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
> index ef91b3a1ac..11e0901c56 100644
> --- a/doc/guides/nics/i40e.rst
> +++ b/doc/guides/nics/i40e.rst
> @@ -101,6 +101,14 @@ For X710/XL710/XXV710,
>      +--------------+-----------------------+------------------+
>      | DPDK version | Kernel driver version | Firmware version |
>      +==============+=======================+==================+
> +   |    22.03     |         2.17.15       |       8.30       |
> +   +--------------+-----------------------+------------------+
> +   |    21.11     |         2.17.4        |       8.30       |
> +   +--------------+-----------------------+------------------+
> +   |    21.08     |         2.15.9        |       8.30       |
> +   +--------------+-----------------------+------------------+
> +   |    21.05     |         2.15.9        |       8.30       |
> +   +--------------+-----------------------+------------------+
>      |    21.02     |         2.14.13       |       8.00       |
>      +--------------+-----------------------+------------------+
>      |    20.11     |         2.14.13       |       8.00       |
> @@ -148,6 +156,14 @@ For X722,
>      +--------------+-----------------------+------------------+
>      | DPDK version | Kernel driver version | Firmware version |
>      +==============+=======================+==================+
> +   |    22.03     |         2.17.15       |       5.50       |
> +   +--------------+-----------------------+------------------+
> +   |    21.11     |         2.17.4        |       5.30       |
> +   +--------------+-----------------------+------------------+
> +   |    21.08     |         2.15.9        |       5.30       |
> +   +--------------+-----------------------+------------------+
> +   |    21.05     |         2.15.9        |       5.30       |
> +   +--------------+-----------------------+------------------+
>      |    21.02     |         2.14.13       |       5.00       |
>      +--------------+-----------------------+------------------+
>      |    20.11     |         2.13.10       |       5.00       |
> @@ -771,6 +787,13 @@ it will fail and return the info "Conflict with the first rule's input set",
>   which means the current rule's input set conflicts with the first rule's.
>   Remove the first rule if want to change the input set of the PCTYPE.
>   
> +PF reset fail after QinQ set with FW >= 8.4
> +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> +
> +If upgrade FW to a version higher than 8.4, after set MAC VLAN filter and configure outer VLAN on PF, kill
> +DPDK process will cause the card crash.

s/version higher than 8.4/version 8.4 and higher/

> +
> +
>   Example of getting best performance with l3fwd example
>   ------------------------------------------------------
>
  
Qiming Yang May 20, 2022, 2:30 a.m. UTC | #2
Hi,

> -----Original Message-----
> From: Kevin Traynor <ktraynor@redhat.com>
> Sent: 2022年5月16日 18:30
> To: Yang, Qiming <qiming.yang@intel.com>; dev@dpdk.org
> Cc: Zhang, Qi Z <qi.z.zhang@intel.com>; stable@dpdk.org
> Subject: Re: [PATCH v3] doc: update matching versions in i40e guide
> 
> On 16/05/2022 06:55, Qiming Yang wrote:
> > Add recommended matching list for i40e PMD in DPDK 21.05, 21.08, 21.11
> > and 22.03. And add a known issue when FW upgrade to a version higher
> > than 8.4.
> >
> 
> Just a minor thing on the wording, 'version higher than 8.4' suggests that
> 8.4 is not impacted by this known issue.
> 
> If 8.4 is impacted then it would be better to say 'version 8.4 and higher.'
Thank you for your remind, 8.4 is also impacted, I'll modify this express in v4

> 
> > Cc: stable@dpdk.org
> >
> > Signed-off-by: Qiming Yang <qiming.yang@intel.com>
> > ---
> > v2:
> > * added known issue in FW 8.4+
> > v3:
> > * updated x722 FW version
> > ---
> >   doc/guides/nics/i40e.rst | 23 +++++++++++++++++++++++
> >   1 file changed, 23 insertions(+)
> >
> > diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst index
> > ef91b3a1ac..11e0901c56 100644
> > --- a/doc/guides/nics/i40e.rst
> > +++ b/doc/guides/nics/i40e.rst
> > @@ -101,6 +101,14 @@ For X710/XL710/XXV710,
> >      +--------------+-----------------------+------------------+
> >      | DPDK version | Kernel driver version | Firmware version |
> >      +==============+=======================+==================+
> > +   |    22.03     |         2.17.15       |       8.30       |
> > +   +--------------+-----------------------+------------------+
> > +   |    21.11     |         2.17.4        |       8.30       |
> > +   +--------------+-----------------------+------------------+
> > +   |    21.08     |         2.15.9        |       8.30       |
> > +   +--------------+-----------------------+------------------+
> > +   |    21.05     |         2.15.9        |       8.30       |
> > +   +--------------+-----------------------+------------------+
> >      |    21.02     |         2.14.13       |       8.00       |
> >      +--------------+-----------------------+------------------+
> >      |    20.11     |         2.14.13       |       8.00       |
> > @@ -148,6 +156,14 @@ For X722,
> >      +--------------+-----------------------+------------------+
> >      | DPDK version | Kernel driver version | Firmware version |
> >      +==============+=======================+==================+
> > +   |    22.03     |         2.17.15       |       5.50       |
> > +   +--------------+-----------------------+------------------+
> > +   |    21.11     |         2.17.4        |       5.30       |
> > +   +--------------+-----------------------+------------------+
> > +   |    21.08     |         2.15.9        |       5.30       |
> > +   +--------------+-----------------------+------------------+
> > +   |    21.05     |         2.15.9        |       5.30       |
> > +   +--------------+-----------------------+------------------+
> >      |    21.02     |         2.14.13       |       5.00       |
> >      +--------------+-----------------------+------------------+
> >      |    20.11     |         2.13.10       |       5.00       |
> > @@ -771,6 +787,13 @@ it will fail and return the info "Conflict with the
> first rule's input set",
> >   which means the current rule's input set conflicts with the first rule's.
> >   Remove the first rule if want to change the input set of the PCTYPE.
> >
> > +PF reset fail after QinQ set with FW >= 8.4
> > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
> > +
> > +If upgrade FW to a version higher than 8.4, after set MAC VLAN filter
> > +and configure outer VLAN on PF, kill DPDK process will cause the card
> crash.
> 
> s/version higher than 8.4/version 8.4 and higher/
> 
> > +
> > +
> >   Example of getting best performance with l3fwd example
> >   ------------------------------------------------------
> >
  

Patch

diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst
index ef91b3a1ac..11e0901c56 100644
--- a/doc/guides/nics/i40e.rst
+++ b/doc/guides/nics/i40e.rst
@@ -101,6 +101,14 @@  For X710/XL710/XXV710,
    +--------------+-----------------------+------------------+
    | DPDK version | Kernel driver version | Firmware version |
    +==============+=======================+==================+
+   |    22.03     |         2.17.15       |       8.30       |
+   +--------------+-----------------------+------------------+
+   |    21.11     |         2.17.4        |       8.30       |
+   +--------------+-----------------------+------------------+
+   |    21.08     |         2.15.9        |       8.30       |
+   +--------------+-----------------------+------------------+
+   |    21.05     |         2.15.9        |       8.30       |
+   +--------------+-----------------------+------------------+
    |    21.02     |         2.14.13       |       8.00       |
    +--------------+-----------------------+------------------+
    |    20.11     |         2.14.13       |       8.00       |
@@ -148,6 +156,14 @@  For X722,
    +--------------+-----------------------+------------------+
    | DPDK version | Kernel driver version | Firmware version |
    +==============+=======================+==================+
+   |    22.03     |         2.17.15       |       5.50       |
+   +--------------+-----------------------+------------------+
+   |    21.11     |         2.17.4        |       5.30       |
+   +--------------+-----------------------+------------------+
+   |    21.08     |         2.15.9        |       5.30       |
+   +--------------+-----------------------+------------------+
+   |    21.05     |         2.15.9        |       5.30       |
+   +--------------+-----------------------+------------------+
    |    21.02     |         2.14.13       |       5.00       |
    +--------------+-----------------------+------------------+
    |    20.11     |         2.13.10       |       5.00       |
@@ -771,6 +787,13 @@  it will fail and return the info "Conflict with the first rule's input set",
 which means the current rule's input set conflicts with the first rule's.
 Remove the first rule if want to change the input set of the PCTYPE.
 
+PF reset fail after QinQ set with FW >= 8.4
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If upgrade FW to a version higher than 8.4, after set MAC VLAN filter and configure outer VLAN on PF, kill
+DPDK process will cause the card crash.
+
+
 Example of getting best performance with l3fwd example
 ------------------------------------------------------