From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id B39FC440A5; Thu, 23 May 2024 13:29:10 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6267D4026C; Thu, 23 May 2024 13:29:10 +0200 (CEST) Received: from wfout1-smtp.messagingengine.com (wfout1-smtp.messagingengine.com [64.147.123.144]) by mails.dpdk.org (Postfix) with ESMTP id 77F994025C for ; Thu, 23 May 2024 13:29:08 +0200 (CEST) Received: from compute6.internal (compute6.nyi.internal [10.202.2.47]) by mailfout.west.internal (Postfix) with ESMTP id 9DDFA1C001EE; Thu, 23 May 2024 07:29:04 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute6.internal (MEProxy); Thu, 23 May 2024 07:29:05 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= cc:cc:content-transfer-encoding:content-type:date:date:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to; s=fm1; t=1716463744; x=1716550144; bh=snf0gBYuizVk4YNUHjoXk lf9XA/+5tcMaplrwby5fkY=; b=DRKi9vnsXmuVLY6JlfRbF0CL741RTuzqWReJa Y9CfehkH9z04RTnxPCjUWhyQDaN/O27fDUEegFAwtbmhlZSGJJemnMFFFU0eli0n FZVPGd+8RiBiltYUlHBPdXXsSKJGS09djvkkPshDzDju72ZY/riswK4puZ8QvnUc SdczQdqI2fqpCVtiL/Tos4+8QeRrgbnjcMWyknmlxNPUpClhYvBGM77P00PWvxgs TEVEAV3c2ZU9TN8C1KRncEz83N31Sb24NuuzSVllP9w+LFdwe+76wXw9tBPSc52c ZLSLk7CtChKPeShEzZACF1xm5ywJKHmcIx64tN7brwvoH9z5A== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:message-id:mime-version:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; t=1716463744; x=1716550144; bh=snf0gBYuizVk4YNUHjoXklf9XA/+ 5tcMaplrwby5fkY=; b=T4NN+l7k1Jlfz7E1SFFN8K5xVF7/G9Fcxy+N7QIBVWsn FucYHkW3jDV6UPjOPFikz21LfztTbR5+Y9N8m9T+EtRIgovMgtZWYWVcfsUsZ/7Y VqQkScQrtn8QFRcHBtDohYD8HLnHS6szXvfENrGPrvcLbUJrDa/NoaWRTkpYKizp ROJnlT3VGkJCa9SV6AnEWhBYBZy0h38RE47A1KMHlrSS/PAF+GMinw4+t5G6pUQe SihcBUYsPrLhNL52/WFaJDi+AU83PiTdUSUTMdrhLnsRkYmKodjdqa9C7y3z+mxg bg7NGFEGE9+xTvRn4duJPRgVMyPOoxkGGvcpGa167A== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvledrvdeiiedggedtucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvvefufffkofgggfestdekredtredttdenucfhrhhomhepvfhhohhmrghs ucfoohhnjhgrlhhonhcuoehthhhomhgrshesmhhonhhjrghlohhnrdhnvghtqeenucggtf frrghtthgvrhhnpeehueekvdejudefveekjeelgeejffeuiefgleffleefudfgkefhheet uddtleegfeenucffohhmrghinhepnhhvihguihgrrdgtohhmnecuvehluhhsthgvrhfuih iivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhho nhdrnhgvth X-ME-Proxy: Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 23 May 2024 07:29:02 -0400 (EDT) From: Thomas Monjalon To: dev@dpdk.org Cc: Dariusz Sosnowski , Viacheslav Ovsiienko , Ori Kam , Suanming Mou , Matan Azrad Subject: [PATCH] doc: add firmware update links in mlx5 guide Date: Thu, 23 May 2024 13:28:49 +0200 Message-ID: <20240523112850.1446671-1-thomas@monjalon.net> X-Mailer: git-send-email 2.45.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org If using upstream kernel and libraries, there was no direct link to download the firmware and update tool. Firmware update explanations are reorganized and include all links. Signed-off-by: Thomas Monjalon --- doc/guides/platform/mlx5.rst | 41 +++++++++++++++++++++--------------- 1 file changed, 24 insertions(+), 17 deletions(-) diff --git a/doc/guides/platform/mlx5.rst b/doc/guides/platform/mlx5.rst index e9a1f52aca..9799709a61 100644 --- a/doc/guides/platform/mlx5.rst +++ b/doc/guides/platform/mlx5.rst @@ -133,12 +133,23 @@ The following dependencies are not part of DPDK and must be installed separately - ``mlx5_ib``: InfiniBand device driver. - ``ib_uverbs``: user space driver for Verbs (entry point for ``libibverbs``). -- **Firmware update** +- **Firmware** - NVIDIA MLNX_OFED/EN releases include firmware updates. + Minimal supported firmware version: - Because each release provides new features, these updates must be applied to - match the kernel modules and libraries they come with. + - ConnectX-4: **12.21.1000** and above. + - ConnectX-4 Lx: **14.21.1000** and above. + - ConnectX-5: **16.21.1000** and above. + - ConnectX-5 Ex: **16.21.1000** and above. + - ConnectX-6: **20.27.0090** and above. + - ConnectX-6 Dx: **22.27.0090** and above. + - ConnectX-6 Lx: **26.27.0090** and above. + - ConnectX-7: **28.33.2028** and above. + - BlueField: **18.25.1010** and above. + - BlueField-2: **24.28.1002** and above. + - BlueField-3: **32.36.3126** and above. + + New features may be added in more recent firmwares. Libraries and kernel modules can be provided either by the Linux distribution, or by installing NVIDIA MLNX_OFED/EN which provides compatibility with older kernels. @@ -166,6 +177,11 @@ It is possible to build rdma-core as static libraries starting with version 21:: ninja ninja install +The firmware can be updated with `mlxup +`_. +The latest firmwares can be downloaded at +https://network.nvidia.com/support/firmware/firmware-downloads/ + NVIDIA MLNX_OFED/EN ^^^^^^^^^^^^^^^^^^^ @@ -176,19 +192,6 @@ The minimal supported versions are: - NVIDIA MLNX_OFED version: **4.5** and above. - NVIDIA MLNX_EN version: **4.5** and above. -- Firmware version: - - - ConnectX-4: **12.21.1000** and above. - - ConnectX-4 Lx: **14.21.1000** and above. - - ConnectX-5: **16.21.1000** and above. - - ConnectX-5 Ex: **16.21.1000** and above. - - ConnectX-6: **20.27.0090** and above. - - ConnectX-6 Dx: **22.27.0090** and above. - - ConnectX-6 Lx: **26.27.0090** and above. - - ConnectX-7: **28.33.2028** and above. - - BlueField: **18.25.1010** and above. - - BlueField-2: **24.28.1002** and above. - - BlueField-3: **32.36.3126** and above. The firmware, the libraries libibverbs, libmlx5, and mlnx-ofed-kernel modules are packaged in `NVIDIA MLNX_OFED @@ -208,6 +211,10 @@ After installing, the firmware version can be checked:: ibv_devinfo +The firmware updates are included in NVIDIA MLNX_OFED/EN packages. +Because each release provides new features, these updates must be applied +to match the kernel modules and libraries they come with. + .. note:: Several versions of NVIDIA MLNX_OFED/EN are available. Installing the version -- 2.45.0