From patchwork Mon Aug 5 15:32:22 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Monjalon X-Patchwork-Id: 57462 X-Patchwork-Delegate: rasland@nvidia.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7519D1BE16; Mon, 5 Aug 2019 17:32:55 +0200 (CEST) Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by dpdk.org (Postfix) with ESMTP id 0AE171BDFD for ; Mon, 5 Aug 2019 17:32:54 +0200 (CEST) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id ABFBB21A97; Mon, 5 Aug 2019 11:32:53 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Mon, 05 Aug 2019 11:32:53 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; s=mesmtp; bh=Ixdsd+Gku0 +nEeLv+69Kz2RFk8MCEHw+QrCHcBCQi4M=; b=ifgaNbPJg18pc1tT21Z5JvfZPb FwdsDJGGy/5sjYXZc/Bacpna/js1obUDXfRYljr1S1TFBgDD5MvWxikX4RKB92ES JdSq/273ehizZRSOP1vzRaxzouBQhhlL/8yOovOf/z5ZFHo8RLyZ8hVX4biLQjUR uFhQRoYfGx/RiL0yQ= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :in-reply-to:message-id:mime-version:references:subject:to :x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=Ixdsd+Gku0+nEeLv+69Kz2RFk8MCEHw+QrCHcBCQi4M=; b=CAsplX+G otytX+XPGIJshlZmmiABFM73vXFDmVJqwNbC5tAO/nyoKOTjV6/c1pjn7WHmXsv0 PG32qq4ZsgqZHUm1junhH6i4sfQ/5sN8mBjM0krh7hvWNQZ86DeLoCpeHYsSwrFS iKAeB+T7oKLVWcJ11IcZ4l6ahpO9NhYveR9mD0AWkye5nlKFENSThiY0vwVA6goc wISknCBLujfHJr98V/wZgFqlOASJd6t/S+Ys6P3CKkyWTYUj8jvYI0VSNXla2f8/ /Cgc4JPWq2ERpJo6Bdc935qSZGb1pzhKA9PuFykwDkvyI3wGNAD2E9tXub0Q7fJb 1VeKC6CeMeDGQw== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddruddtjedgkeelucetufdoteggodetrfdotf fvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfqfgfvpdfurfetoffkrfgpnffqhgen uceurghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmne cujfgurhephffvufffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecukf hppeejjedrudefgedrvddtfedrudekgeenucfrrghrrghmpehmrghilhhfrhhomhepthhh ohhmrghssehmohhnjhgrlhhonhdrnhgvthenucevlhhushhtvghrufhiiigvpedv X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id AD7D980068; Mon, 5 Aug 2019 11:32:52 -0400 (EDT) From: Thomas Monjalon To: Shahaf Shuler , Yongseok Koh , Viacheslav Ovsiienko , John McNamara , Marko Kovacevic Cc: dev@dpdk.org Date: Mon, 5 Aug 2019 17:32:22 +0200 Message-Id: <20190805153222.29593-6-thomas@monjalon.net> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190805153222.29593-1-thomas@monjalon.net> References: <20190805153222.29593-1-thomas@monjalon.net> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH 5/5] doc: add more details about mlx5 offloads X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Add firmware config for MPLS and DevX (required by LRO and DR). Add a table for queue offloads requirements. Signed-off-by: Thomas Monjalon --- doc/guides/nics/mlx5.rst | 35 ++++++++++++++++++++++++++++++----- 1 file changed, 30 insertions(+), 5 deletions(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index b9cabfe96..0f92100e1 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -172,10 +172,13 @@ Limitations - can be applied to VF ports only. - must specify PF port action (packet redirection from VF to PF). -- ICMP/ICMP6 code/type matching cannot be supported togeter with IP-in-IP tunnel. +- ICMP/ICMP6 code/type matching, IP-in-IP and MPLS flow matching are all + mutually exclusive features which cannot be supported together + (see :ref:`mlx5_firmware_config`). - LRO: + - Requires DevX to be enabled. - KEEP_CRC offload cannot be supported with LRO. - The first mbuf length, without head-room, must be big enough to include the TCP header (122B). @@ -582,6 +585,8 @@ Run-time configuration If this parameter is not specified, by default PMD will set the smallest value supported by HW. +.. _mlx5_firmware_config: + Firmware configuration ~~~~~~~~~~~~~~~~~~~~~~ @@ -616,6 +621,10 @@ Below are some firmware configurations listed. NUM_OF_VFS= +- enable DevX (required by Direct Rules and other features):: + + UCTX_EN=1 + - aggressive CQE zipping:: CQE_COMPRESSION=1 @@ -629,6 +638,10 @@ Below are some firmware configurations listed. FLEX_PARSER_PROFILE_ENABLE=0 +- enable MPLS flow matching:: + + FLEX_PARSER_PROFILE_ENABLE=1 + - enable ICMP/ICMP6 code/type fields matching:: FLEX_PARSER_PROFILE_ENABLE=2 @@ -940,10 +953,22 @@ Performance tuning .. _mlx5_offloads_support: -Supported hardware offloads using rte_flow API ----------------------------------------------- +Supported hardware offloads +--------------------------- -.. table:: Supported hardware offloads using rte_flow API +.. table:: Minimal SW/HW versions for queue offloads + + ============== ===== ===== ========= ===== ========== ========== + Offload DPDK Linux rdma-core OFED firmware hardware + ============== ===== ===== ========= ===== ========== ========== + common base 17.11 4.14 16 4.2-1 12.21.1000 ConnectX-4 + checksums 17.11 4.14 16 4.2-1 12.21.1000 ConnectX-4 + Rx timestamp 17.11 4.14 16 4.2-1 12.21.1000 ConnectX-4 + TSO 17.11 4.14 16 4.2-1 12.21.1000 ConnectX-4 + LRO 19.08 N/A N/A 4.6-4 16.25.6406 ConnectX-5 + ============== ===== ===== ========= ===== ========== ========== + +.. table:: Minimal SW/HW versions for rte_flow offloads +-----------------------+-----------------+-----------------+ | Offload | with E-Switch | with vNIC | @@ -976,7 +1001,7 @@ Supported hardware offloads using rte_flow API | | set_mac_dst) | | | +-----------------------+-----------------+-----------------+ | Jump | | DPDK 19.05 | | DPDK 19.02 | - | | | OFED 4.6-2 | | OFED 4.6-2 | + | | | OFED 4.6-4 | | OFED 4.6-4 | | | | rdma-core 24 | | N/A | | | | ConnectX-5 | | ConnectX-5 | +-----------------------+-----------------+-----------------+