X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fnics%2Fthunderx.rst;h=98f23a2b2a3d51ade2d0aa300608e88156bb65f7;hb=34fd4373ce76efd0236e59397c495762c2ec9e64;hp=f42133e5464d9b7a5368b48151b28270b9b88238;hpb=5d24d6a55025c58ae9e890851e21cb861839cb66;p=dpdk.git diff --git a/doc/guides/nics/thunderx.rst b/doc/guides/nics/thunderx.rst index f42133e546..98f23a2b2a 100644 --- a/doc/guides/nics/thunderx.rst +++ b/doc/guides/nics/thunderx.rst @@ -4,7 +4,7 @@ ThunderX NICVF Poll Mode Driver =============================== -The ThunderX NICVF PMD (**librte_pmd_thunderx_nicvf**) provides poll mode driver +The ThunderX NICVF PMD (**librte_net_thunderx**) provides poll mode driver support for the inbuilt NIC found in the **Cavium ThunderX** SoC family as well as their virtual functions (VF) in SR-IOV context. @@ -43,26 +43,6 @@ Prerequisites ------------- - Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. -Pre-Installation Configuration ------------------------------- - -Config File Options -~~~~~~~~~~~~~~~~~~~ - -The following options can be modified in the ``config`` file. -Please note that enabling debugging options may affect system performance. - -- ``CONFIG_RTE_LIBRTE_THUNDERX_NICVF_PMD`` (default ``y``) - - Toggle compilation of the ``librte_pmd_thunderx_nicvf`` driver. - -- ``CONFIG_RTE_LIBRTE_THUNDERX_NICVF_DEBUG_RX`` (default ``n``) - - Toggle asserts of receive fast path. - -- ``CONFIG_RTE_LIBRTE_THUNDERX_NICVF_DEBUG_TX`` (default ``n``) - - Toggle asserts of transmit fast path. Driver compilation and testing ------------------------------ @@ -70,8 +50,7 @@ Driver compilation and testing Refer to the document :ref:`compiling and testing a PMD for a NIC ` for details. -To compile the ThunderX NICVF PMD for Linux arm64 gcc, -use arm64-thunderx-linux-gcc as target. +Use config/arm/arm64-thunderx-linux-gcc as a meson cross-file when cross-compiling. Linux ----- @@ -156,7 +135,7 @@ This section provides instructions to configure SR-IOV with Linux OS. -netdev tap,id=net0,ifname=tap0,script=/etc/qemu-ifup_thunder \ -device virtio-net-device,netdev=net0 \ -serial stdio \ - -mem-path /dev/huge + -mem-path /dev/hugepages #. Enable **VFIO-NOIOMMU** mode (optional): @@ -178,13 +157,13 @@ This section provides instructions to configure SR-IOV with Linux OS. .. code-block:: console - ./arm64-thunderx-linux-gcc/app/testpmd -l 0-3 -n 4 -w 0002:01:00.2 \ + .//app/dpdk-testpmd -l 0-3 -n 4 -a 0002:01:00.2 \ -- -i --no-flush-rx \ --port-topology=loop ... - PMD: rte_nicvf_pmd_init(): librte_pmd_thunderx nicvf version 1.0 + PMD: rte_nicvf_pmd_init(): librte_net_thunderx nicvf version 1.0 ... EAL: probe driver: 177d:11 rte_nicvf_pmd @@ -398,7 +377,7 @@ This scheme is useful when application would like to insert vlan header without Example: .. code-block:: console - -w 0002:01:00.2,skip_data_bytes=8 + -a 0002:01:00.2,skip_data_bytes=8 Limitations ----------- @@ -413,7 +392,7 @@ Maximum packet length ~~~~~~~~~~~~~~~~~~~~~ The ThunderX SoC family NICs support a maximum of a 9K jumbo frame. The value -is fixed and cannot be changed. So, even when the ``rxmode.max_rx_pkt_len`` +is fixed and cannot be changed. So, even when the ``rxmode.mtu`` member of ``struct rte_eth_conf`` is set to a value lower than 9200, frames up to 9200 bytes can still reach the host interface.