doc: update matching list for i40e and ice driver
PATCH 1/1 doc: update matching list for i40e and ice driver
Add recommended matching list for ice PMD in DPDK 22.07 and i40e PMD in DPDK 22.07 and 21.11.
--- doc/guides/nics/i40e.rst | 8 ++++++++ doc/guides/nics/ice.rst | 2 ++ 2 files changed, 10 insertions(+)
doc/guides/nics/i40e.rst +8 -0
@@ -101,6 +101,10 @@ For X710/XL710/XXV710, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 9.01 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 8.70 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 8.30 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 8.30 |
@@ -156,6 +160,10 @@ For X722, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 6.00 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 5.60 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 5.50 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 5.30 |
doc/guides/nics/ice.rst +2 -0
@@ -64,6 +64,8 @@ The detailed information can refer to chapter Tested Platforms/Tested NICs in re +-----------+---------------+-----------------+-----------+--------------+-----------+ | 22.03 | 1.8.3 | 1.3.28 | 1.3.35 | 1.3.8 | 3.2 | +-----------+---------------+-----------------+-----------+--------------+-----------+ + | 22.07 | 1.9.11 | 1.3.30 | 1.3.37 | 1.3.10 | 4.0 | + +-----------+---------------+-----------------+-----------+--------------+-----------+ Pre-Installation Configuration ------------------------------
Signature · 1 line
2.25.1
Hi, Qi
I will prepare v2 as this patch have one typo.
Qiming
Quoted 60 lines
-----Original Message-----
From: Yang, Qiming <[email protected]>
Sent: Wednesday, November 9, 2022 9:47 AM
To: [email protected]; Zhang, Qi Z <[email protected]>
Cc: Yang, Qiming <[email protected]>
Subject: [PATCH] doc: update matching list for i40e and ice driverAdd recommended matching list for ice PMD in DPDK 22.07 and i40e PMD in DPDK 22.07 and 21.11.
Signed-off-by Qiming Yang <[email protected]>--- doc/guides/nics/i40e.rst | 8 ++++++++ doc/guides/nics/ice.rst | 2 ++ 2 files changed, 10 insertions(+)doc/guides/nics/i40e.rst index renamed from doc/guides/nics/i40e.rst +0
-0
a0992dbc6c..a6c7dbd080100644doc/guides/nics/i40e.rst +8
-0@@ -101,6 +101,10 @@ For X710/XL710/XXV710, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 9.01 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 8.70 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 8.30 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 8.30 |@@ -156,6 +160,10 @@ For X722, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 6.00 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 5.60 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 5.50 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 5.30 |doc/guides/nics/ice.rst index renamed from doc/guides/nics/ice.rst +0
-0
c7f82c261d..ce075e067c100644doc/guides/nics/ice.rst +0
-0@@ -64,6 +64,8 @@ The detailed information can refer to chapter TestedPlatforms/Tested NICs in re
+-----------+---------------+-----------------+-----------+--------------+-----------+ | 22.03 | 1.8.3 | 1.3.28 | 1.3.35 | 1.3.8 | 3.2 | +-----------+---------------+-----------------+-----------+--------------+-----------+doc/guides/nics/ice.rst +4
-1+ | 22.07 | 1.9.11 | 1.3.30 | 1.3.37 | 1.3.10 | 4.0 | + + +-----------+---------------+-----------------+-----------+----------- + ---+-----------+ Pre-Installation Configuration ------------------------------ --2.25.1
PATCH v2 1/1 doc: update matching list for i40e and ice driver
In reply to Qiming YangAdd recommended matching list for ice PMD in DPDK 22.07 and i40e PMD in DPDK 22.07 and 22.11.
--- doc/guides/nics/i40e.rst | 8 ++++++++ doc/guides/nics/ice.rst | 2 ++ 2 files changed, 10 insertions(+)
doc/guides/nics/i40e.rst +8 -0
@@ -101,6 +101,10 @@ For X710/XL710/XXV710, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 9.01 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 8.70 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 8.30 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 8.30 |
@@ -156,6 +160,10 @@ For X722, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 6.00 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 5.60 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 5.50 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 5.30 |
doc/guides/nics/ice.rst +2 -0
@@ -64,6 +64,8 @@ The detailed information can refer to chapter Tested Platforms/Tested NICs in re +-----------+---------------+-----------------+-----------+--------------+-----------+ | 22.03 | 1.8.3 | 1.3.28 | 1.3.35 | 1.3.8 | 3.2 | +-----------+---------------+-----------------+-----------+--------------+-----------+ + | 22.07 | 1.9.11 | 1.3.30 | 1.3.37 | 1.3.10 | 4.0 | + +-----------+---------------+-----------------+-----------+--------------+-----------+ Pre-Installation Configuration ------------------------------
Signature · 1 line
2.25.1
Quoted 9 lines
-----Original Message-----
From: Yang, Qiming <[email protected]>
Sent: Friday, November 11, 2022 1:27 PM
To: [email protected]; Zhang, Qi Z <[email protected]>
Cc: Yang, Qiming <[email protected]>
Subject: [PATCH v2] doc: update matching list for i40e and ice driver
Quoted 4 lines
Add recommended matching list for ice PMD in DPDK 22.07 and i40e PMD in DPDK 22.07 and 22.11.
Signed-off-by Qiming Yang <[email protected]>
Applied to dpdk-next-net-intel.
Thanks
Qi
Quoted 25 lines · Qiming Yang
Add recommended matching list for ice PMD in DPDK 22.07 and i40e PMD in DPDK 22.07 and 22.11.
Signed-off-by Qiming Yang <[email protected]>--- doc/guides/nics/i40e.rst | 8 ++++++++ doc/guides/nics/ice.rst | 2 ++ 2 files changed, 10 insertions(+)doc/guides/nics/i40e.rst +4
-0@@ -101,6 +101,10 @@ For X710/XL710/XXV710, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 9.01 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 8.70 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 8.30 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 8.30 |
doc/guides/nics/i40e.rst For X722, · line 169
Quoted 10 lines
doc/guides/nics/i40e.rst +4
-0@@ -156,6 +160,10 @@ For X722, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 6.00 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 5.60 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 5.50 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 5.30 |
The text above the table says:
"It is highly recommended to upgrade the i40e kernel driver and firmware to avoid the compatibility issues with i40e PMD. Here is the suggested matching list which has been tested and verified. The detailed information can refer to chapter Tested Platforms/Tested NICs in release notes."
The table is only showing the out-of-tree Kernel driver versions. The tested section shows that in-tree Kernel drivers are tested with as well.
The issue is that this section says "Here is the suggested matching list" and only lists out-of-tree drivers.
It is probably just a left over from when in-tree drivers had version numbers but it is causing some confusion for users as it implies that the Intel recommendation is to use out-of-tree drivers and not in-tree.
So I suggest that another column is added here to also show the in-tree kernel driver tested with.
What do you think ?
Quoted 13 lines
doc/guides/nics/ice.rst +2
-0@@ -64,6 +64,8 @@ The detailed information can refer to chapter Tested Platforms/Tested NICs in re +-----------+---------------+-----------------+-----------+--------------+-----------+ | 22.03 | 1.8.3 | 1.3.28 | 1.3.35 | 1.3.8 | 3.2 | +-----------+---------------+-----------------+-----------+--------------+-----------+ + | 22.07 | 1.9.11 | 1.3.30 | 1.3.37 | 1.3.10 | 4.0 | + +-----------+---------------+-----------------+-----------+--------------+-----------+ Pre-Installation Configuration ------------------------------
Quoted 52 lines · Kevin Traynor
Quoted 25 lines · Qiming Yang
Add recommended matching list for ice PMD in DPDK 22.07 and i40e PMD in DPDK 22.07 and 22.11.
Signed-off-by Qiming Yang <[email protected]>--- doc/guides/nics/i40e.rst | 8 ++++++++ doc/guides/nics/ice.rst | 2 ++ 2 files changed, 10 insertions(+)doc/guides/nics/i40e.rst +4
-0@@ -101,6 +101,10 @@ For X710/XL710/XXV710, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 9.01 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 8.70 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 8.30 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 8.30 |doc/guides/nics/i40e.rst For X722, · line 169
Quoted 10 lines
doc/guides/nics/i40e.rst +4
-0@@ -156,6 +160,10 @@ For X722, +--------------+-----------------------+------------------+ | DPDK version | Kernel driver version | Firmware version | +==============+=======================+==================+ + | 22.11 | 2.20.12 | 6.00 | + +--------------+-----------------------+------------------+ + | 22.07 | 2.19.3 | 5.60 | + +--------------+-----------------------+------------------+ | 22.03 | 2.17.15 | 5.50 | +--------------+-----------------------+------------------+ | 21.11 | 2.17.4 | 5.30 |The text above the table says:
"It is highly recommended to upgrade the i40e kernel driver and firmware to avoid the compatibility issues with i40e PMD. Here is the suggested matching list which has been tested and verified. The detailed information can refer to chapter Tested Platforms/Tested NICs in release notes."
The table is only showing the out-of-tree Kernel driver versions. The tested section shows that in-tree Kernel drivers are tested with as well.
The issue is that this section says "Here is the suggested matching list" and only lists out-of-tree drivers.
Quoted 9 lines
It is probably just a left over from when in-tree drivers had version numbers but it is causing some confusion for users as it implies that the Intel recommendation is to use out-of-tree drivers and not in-tree.
So I suggest that another column is added here to also show the in-tree kernel driver tested with.
What do you think ?
Any thoughts on this ?
It would be best to list both, but it might be too much when in-tree drivers are being tested on multiple kernels etc.
Removing the column could work, but may lose some info for older releases.
So I just sent a patch to update the text:
http://inbox.dpdk.org/dev/[email protected]
Quoted 14 lines
Quoted 13 lines
doc/guides/nics/ice.rst +2
-0@@ -64,6 +64,8 @@ The detailed information can refer to chapter Tested Platforms/Tested NICs in re +-----------+---------------+-----------------+-----------+--------------+-----------+ | 22.03 | 1.8.3 | 1.3.28 | 1.3.35 | 1.3.8 | 3.2 | +-----------+---------------+-----------------+-----------+--------------+-----------+ + | 22.07 | 1.9.11 | 1.3.30 | 1.3.37 | 1.3.10 | 4.0 | + +-----------+---------------+-----------------+-----------+--------------+-----------+ Pre-Installation Configuration ------------------------------