X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fvdpadevs%2Fmlx5.rst;h=2c7a550afcd24dff66a80ede1c32f3634921699c;hb=91c78e090eed7a2cfcc7945d8bc14532ce273e43;hp=ce7c8a74151c0d5fe3116aef70642896c1e6f196;hpb=95276abaaf0a3e605e99a306f1923f46c3037a64;p=dpdk.git diff --git a/doc/guides/vdpadevs/mlx5.rst b/doc/guides/vdpadevs/mlx5.rst index ce7c8a7415..2c7a550afc 100644 --- a/doc/guides/vdpadevs/mlx5.rst +++ b/doc/guides/vdpadevs/mlx5.rst @@ -1,12 +1,14 @@ .. SPDX-License-Identifier: BSD-3-Clause Copyright 2019 Mellanox Technologies, Ltd +.. include:: + MLX5 vDPA driver ================ The MLX5 vDPA (vhost data path acceleration) driver library (**librte_pmd_mlx5_vdpa**) provides support for **Mellanox ConnectX-6**, -**Mellanox ConnectX-6DX** and **Mellanox BlueField** families of +**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. @@ -48,15 +50,16 @@ By default, the mlx5 device will be probed by the net/mlx5 driver. Supported NICs -------------- -* Mellanox(R) ConnectX(R)-6 200G MCX654106A-HCAT (4x200G) -* Mellanox(R) ConnectX(R)-6DX EN 100G MCX623106AN-CDAT (2*100G) -* Mellanox(R) ConnectX(R)-6DX EN 200G MCX623105AN-VDAT (1*200G) -* Mellanox(R) BlueField SmartNIC 25G MBF1M332A-ASCAT (2*25G) +* Mellanox\ |reg| ConnectX\ |reg|-6 200G MCX654106A-HCAT (2x200G) +* Mellanox\ |reg| ConnectX\ |reg|-6 Dx EN 25G MCX621102AN-ADAT (2x25G) +* Mellanox\ |reg| ConnectX\ |reg|-6 Dx EN 100G MCX623106AN-CDAT (2x100G) +* Mellanox\ |reg| ConnectX\ |reg|-6 Dx EN 200G MCX623105AN-VDAT (1x200G) +* Mellanox\ |reg| BlueField SmartNIC 25G MBF1M332A-ASCAT (2x25G) Prerequisites ------------- -- Mellanox OFED version: **4.7** +- Mellanox OFED version: **5.0** see :doc:`../../nics/mlx5` guide for more Mellanox OFED details. Compilation options @@ -104,8 +107,40 @@ Run-time configuration - **ethtool** operations on related kernel interfaces also affect the PMD. +Driver options +^^^^^^^^^^^^^^ + - ``class`` parameter [string] Select the class of the driver that should probe the device. `vdpa` for the mlx5 vDPA driver. +- ``event_mode`` parameter [int] + + - 0, Completion queue scheduling will be managed by a timer thread which + automatically adjusts its delays to the coming traffic rate. + + - 1, Completion queue scheduling will be managed by a timer thread with fixed + delay time. + + - 2, Completion queue scheduling will be managed by interrupts. Each CQ burst + arms the CQ in order to get an interrupt event in the next traffic burst. + + - Default mode is 0. + +- ``event_us`` parameter [int] + + Per mode micro-seconds parameter - relevant only for event mode 0 and 1: + + - 0, A nonzero value to set timer step in micro-seconds. The timer thread + dynamic delay change steps according to this value. Default value is 1us. + + - 1, A nonzero value to set fixed timer delay in micro-seconds. Default value + is 100us. + +- ``no_traffic_time`` parameter [int] + + A nonzero value defines the traffic off time, in seconds, that moves the + driver to no-traffic mode. In this mode the timer events are stopped and + interrupts are configured to the device in order to notify traffic for the + driver. Default value is 2s.