Skip to contentSkip to conversation

doc: update BIOS setting and supported HW list for NTB

PATCH In review Junfeng Guo 4 participants 5 messages Jul 3, 2023 – Jul 20, 2023

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: update BIOS setting and supported HW list for NTB

Update BIOS settings and supported platform list for Intel NTB.

Fixes f5057be340e4 ("raw/ntb: support Intel Ice Lake")
---
 doc/guides/rawdevs/ntb.rst | 32 ++++++++++++++++++++------------
 1 file changed, 20 insertions(+), 12 deletions(-)
doc/guides/rawdevs/ntb.rst +20 -12
index 2bb115d13f..c34512177a 100644
@@ -17,18 +17,22 @@ some information by using scratchpad registers.
 BIOS setting on Intel Xeon
 --------------------------
 
-Intel Non-transparent Bridge needs special BIOS setting. The reference for
-Skylake is https://www.intel.com/content/dam/support/us/en/documents/server-products/Intel_Xeon_Processor_Scalable_Family_BIOS_User_Guide.pdf
-
-- Set the needed PCIe port as NTB to NTB mode on both hosts.
-- Enable NTB bars and set bar size of bar 23 and bar 45 as 12-29 (4K-512M)
-  on both hosts (for Ice Lake, bar size can be set as 12-51, namely 4K-128PB).
-  Note that bar size on both hosts should be the same.
-- Disable split bars for both hosts.
-- Set crosslink control override as DSD/USP on one host, USD/DSP on
+Intel Non-transparent Bridge (NTB) needs special BIOS settings on both systems.
+Note that for 4th Generation Intel® Xeon® Scalable Processors, option ``Port
+Subsystem Mode`` should be changed from ``Gen5`` to ``Gen4 Only``, then reboot.
+
+- Set ``Non-Transparent Bridge PCIe Port Definition`` for needed PCIe ports as
+  ``NTB to NTB`` mode, on both hosts.
+- Set ``Enable NTB BARs`` as ``Enabled``, on both hosts.
+- Set ``Enable SPLIT BARs`` as ``Disabled``, on both hosts.
+- Set ``Imbar1 Size``, ``Imbar2 Size``, ``Embar1 Size`` and ``Embar2 Size``, as
+  12-29 (i.e., 4K-512M) for 2nd Generation Intel® Xeon® Scalable Processors; as
+  12-51 (i.e., 4K-128PB) for 3rd and 4th Generation Intel® Xeon® Scalable
+  Processors. Note that those bar sizes on both hosts should be the same.
+- Set ``Crosslink Control override`` as ``DSD/USP`` on one host, ``USD/DSP`` on
   another host.
-- Disable PCIe PII SSC (Spread Spectrum Clocking) for both hosts. This
-  is a hardware requirement.
+- Set ``PCIe PLL SSC (Spread Spectrum Clocking)`` as ``Disabled``, on both
+  hosts. This is a hardware requirement when using Re-timer Cards.
 
 
 Device Setup
@@ -145,4 +149,8 @@ like the following:
 Limitation
 ----------
 
-- This PMD only supports Intel Skylake and Ice Lake platforms.
+This PMD is only supported on Intel Xeon Platforms:
+
+- 4th Generation Intel® Xeon® Scalable Processors.
+- 3rd Generation Intel® Xeon® Scalable Processors.
+- 2nd Generation Intel® Xeon® Scalable Processors.
Signature · 1 line
2.34.1
Acked-by on v1 1/1
#1 lore raw
Quoted 9 lines

-----Original Message-----
From: Guo, Junfeng <[email protected]>
Sent: Monday, July 3, 2023 5:25 PM
To: Wu, Jingjing <[email protected]>
Cc: [email protected]; [email protected]; Guo, Junfeng <[email protected]>
Subject: [PATCH] doc: update BIOS setting and supported HW list for NTB

Quoted 6 lines

Update BIOS settings and supported platform list for Intel NTB.

Fixes f5057be340e4 ("raw/ntb: support Intel Ice Lake")
#2 lore raw
Quoted 7 lines · Jingjing
Quoted 7 lines

-----Original Message-----
From: Guo, Junfeng <[email protected]>
Sent: Monday, July 3, 2023 5:25 PM
To: Wu, Jingjing <[email protected]>
Cc: [email protected]; [email protected]; Guo, Junfeng <[email protected]>
Subject: [PATCH] doc: update BIOS setting and supported HW list for NTB

Quoted 8 lines
Quoted 6 lines

Update BIOS settings and supported platform list for Intel NTB.

Fixes f5057be340e4 ("raw/ntb: support Intel Ice Lake")

Kind of unfortunate that the documentation does not list why non-standard settings are needed for DPDK.

#3 lore raw
Quoted 28 lines

-----Original Message-----
From: Stephen Hemminger <[email protected]>
Sent: Friday, July 7, 2023 04:30
To: Wu, Jingjing <[email protected]>
Cc: Guo, Junfeng <[email protected]>; [email protected]; [email protected]
Subject: Re: [PATCH] doc: update BIOS setting and supported HW list for NTB

Quoted 5 lines · Jingjing
Quoted 5 lines

-----Original Message-----
From: Guo, Junfeng <[email protected]>
Sent: Monday, July 3, 2023 5:25 PM
To: Wu, Jingjing <[email protected]>
Cc: [email protected]; [email protected]; Guo, Junfeng

<[email protected]>

Quoted 1 line
Quoted 1 line

Subject: [PATCH] doc: update BIOS setting and supported HW list for

NTB

Quoted 6 lines
Quoted 6 lines

Update BIOS settings and supported platform list for Intel NTB.

Fixes f5057be340e4 ("raw/ntb: support Intel Ice Lake")
Quoted 7 lines
Quoted 3 lines
Quoted 1 line

Kind of unfortunate that the documentation does not list why non- standard
settings are needed for DPDK.

Thanks for the comments!
Yes, these BIOS settings are used to enable the NTB device so that it can be used by DPDK PMD or other drivers.
I'm not quite sure about the principle of each required item. But without them, the NTB device cannot show up in the PCI buses list.
We can update them gradually once we know the purpose of each setting. Thanks!