X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Frawdevs%2Fntb.rst;h=2c5fa7690c8161ab2e1bb899c72ef0ebfe24e1dc;hb=a8f0df6bf98d295668b429f65884af887c2c5b77;hp=58472135f5b73686036849f73e34e0795ffc6d4d;hpb=11b5c7daf01993b1582e048d217bde2b0e075afa;p=dpdk.git diff --git a/doc/guides/rawdevs/ntb.rst b/doc/guides/rawdevs/ntb.rst index 58472135f5..2c5fa7690c 100644 --- a/doc/guides/rawdevs/ntb.rst +++ b/doc/guides/rawdevs/ntb.rst @@ -14,28 +14,22 @@ allocation for the peer to access and read/write allocated memory from peer. Also, the PMD allows to use doorbell registers to notify the peer and share some information by using scratchpad registers. -BIOS setting on Intel Skylake ------------------------------ +BIOS setting on Intel Xeon +-------------------------- -Intel Non-transparent Bridge needs special BIOS setting. Since the PMD only -supports Intel Skylake platform, introduce BIOS setting here. The referencce -is https://www.intel.com/content/dam/support/us/en/documents/server-products/Intel_Xeon_Processor_Scalable_Family_BIOS_User_Guide.pdf +Intel Non-transparent Bridge needs special BIOS setting. The referencce 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 (2K-512M) - on both hosts. Note that bar size on both hosts should be the same. +- 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 another host. - Disable PCIe PII SSC (Spread Spectrum Clocking) for both hosts. This is a hardware requirement. -Build Options -------------- - -- ``CONFIG_RTE_LIBRTE_PMD_NTB_RAWDEV`` (default ``y``) - - Toggle compilation of the ``ntb`` driver. Device Setup ------------ @@ -52,11 +46,11 @@ NTB PMD needs kernel PCI driver to support write combining (WC) to get better performance. The difference will be more than 10 times. To enable WC, there are 2 ways. -- Insert igb_uio with ``wc_active=1`` flag if use igb_uio driver. +- Insert igb_uio with ``wc_activate=1`` flag if use igb_uio driver. .. code-block:: console - insmod igb_uio.ko wc_active=1 + insmod igb_uio.ko wc_activate=1 - Enable WC for NTB device's Bar 2 and Bar 4 (Mapped memory) manually. The reference is https://www.kernel.org/doc/html/latest/x86/mtrr.html @@ -151,4 +145,4 @@ like the following: Limitation ---------- -- This PMD only supports Intel Skylake platform. +- This PMD only supports Intel Skylake and Ice Lake platforms.