From 6c21c88736798a71321bd4e045f914ddd7e578a8 Mon Sep 17 00:00:00 2001 From: Raslan Darawsheh Date: Tue, 24 Nov 2020 12:30:35 +0200 Subject: [PATCH] doc: add ConnectX-6 Lx and BlueField-2 in mlx5 guide This adds ConnectX-6 Lx and BlueField-2 to the list of NICs supported by mlx5 PMD. Signed-off-by: Raslan Darawsheh --- doc/guides/nics/mlx5.rst | 47 +++++++++++++++++++++++----------------- 1 file changed, 27 insertions(+), 20 deletions(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index ab43ccef22..3bda0f8417 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -9,9 +9,10 @@ MLX5 poll mode driver The MLX5 poll mode driver library (**librte_net_mlx5**) provides support for **Mellanox ConnectX-4**, **Mellanox ConnectX-4 Lx** , **Mellanox -ConnectX-5**, **Mellanox ConnectX-6**, **Mellanox ConnectX-6 Dx** and -**Mellanox BlueField** families of 10/25/40/50/100/200 Gb/s adapters -as well as their virtual functions (VF) in SR-IOV context. +ConnectX-5**, **Mellanox ConnectX-6**, **Mellanox ConnectX-6 Dx**, **Mellanox +ConnectX-6 Lx**, **Mellanox BlueField** and **Mellanox BlueField-2** families +of 10/25/40/50/100/200 Gb/s adapters as well as their virtual functions (VF) +in SR-IOV context. Information and documentation about these adapters can be found on the `Mellanox website `__. Help is also provided by the @@ -316,7 +317,7 @@ Limitations - CRC: - ``DEV_RX_OFFLOAD_KEEP_CRC`` cannot be supported with decapsulation - for some NICs (such as ConnectX-6 Dx and BlueField 2). + for some NICs (such as ConnectX-6 Dx, ConnectX-6 Lx, and BlueField-2). The capability bit ``scatter_fcs_w_decap_disable`` shows NIC support. - Sample flow: @@ -442,10 +443,10 @@ Driver options Supported on: - - x86_64 with ConnectX-4, ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx - and BlueField. - - POWER9 and ARMv8 with ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx - and BlueField. + - x86_64 with ConnectX-4, ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx, + ConnectX-6 Lx, BlueField and BlueField-2. + - POWER9 and ARMv8 with ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx, + ConnectX-6 Lx, BlueField and BlueField-2. - ``rxq_cqe_pad_en`` parameter [int] @@ -475,10 +476,10 @@ Driver options Supported on: - - x86_64 with ConnectX-4, ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx - and BlueField. - - POWER8 and ARMv8 with ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx - and BlueField. + - x86_64 with ConnectX-4, ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx, + ConnectX-6 Lx, BlueField and BlueField-2. + - POWER8 and ARMv8 with ConnectX-4 Lx, ConnectX-5, ConnectX-6, ConnectX-6 Dx, + ConnectX-6 Lx, BlueField and BlueField-2. - ``mprq_en`` parameter [int] @@ -683,11 +684,13 @@ Driver options - ``txq_mpw_en`` parameter [int] A nonzero value enables Enhanced Multi-Packet Write (eMPW) for ConnectX-5, - ConnectX-6, ConnectX-6 Dx and BlueField. eMPW allows the TX burst function to pack - up multiple packets in a single descriptor session in order to save PCI bandwidth - and improve performance at the cost of a slightly higher CPU usage. When - ``txq_inline_mpw`` is set along with ``txq_mpw_en``, TX burst function copies - entire packet data on to TX descriptor instead of including pointer of packet. + ConnectX-6, ConnectX-6 Dx, ConnectX-6 Lx, BlueField, BlueField-2. + eMPW allows the Tx burst function to pack up multiple packets + in a single descriptor session in order to save PCI bandwidth + and improve performance at the cost of a slightly higher CPU usage. + When ``txq_inline_mpw`` is set along with ``txq_mpw_en``, + Tx burst function copies entire packet data on to Tx descriptor + instead of including pointer of packet. The Enhanced Multi-Packet Write feature is enabled by default if NIC supports it, can be disabled by explicit specifying 0 value for ``txq_mpw_en`` option. @@ -749,9 +752,10 @@ Driver options - ``tx_vec_en`` parameter [int] - A nonzero value enables Tx vector on ConnectX-5, ConnectX-6, ConnectX-6 Dx - and BlueField NICs if the number of global Tx queues on the port is less than - ``txqs_max_vec``. The parameter is deprecated and ignored. + A nonzero value enables Tx vector on ConnectX-5, ConnectX-6, ConnectX-6 Dx, + ConnectX-6 Lx, BlueField and BlueField-2 NICs + if the number of global Tx queues on the port is less than ``txqs_max_vec``. + The parameter is deprecated and ignored. - ``rx_vec_en`` parameter [int] @@ -1154,7 +1158,9 @@ The following Mellanox device families are supported by the same mlx5 driver: - ConnectX-5 Ex - ConnectX-6 - ConnectX-6 Dx + - ConnectX-6 Lx - BlueField + - BlueField-2 Below are detailed device names: @@ -1183,6 +1189,7 @@ Below are detailed device names: * Mellanox\ |reg| ConnectX\ |reg|-6 200G MCX654106A-HCAT (2x200G) * Mellanox\ |reg| ConnectX\ |reg|-6 Dx EN 100G MCX623106AN-CDAT (2x100G) * Mellanox\ |reg| ConnectX\ |reg|-6 Dx EN 200G MCX623105AN-VDAT (1x200G) +* Mellanox\ |reg| ConnectX\ |reg|-6 Lx EN 25G MCX631102AN-ADAT (2x25G) Quick Start Guide on OFED/EN ---------------------------- -- 2.20.1