From patchwork Tue Nov 23 09:29:57 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Gregory Etelson X-Patchwork-Id: 104598 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id C016BA0C47; Tue, 23 Nov 2021 10:30:27 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B012640040; Tue, 23 Nov 2021 10:30:27 +0100 (CET) Received: from NAM12-BN8-obe.outbound.protection.outlook.com (mail-bn8nam12on2052.outbound.protection.outlook.com [40.107.237.52]) by mails.dpdk.org (Postfix) with ESMTP id ADD144003C for ; Tue, 23 Nov 2021 10:30:26 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=dBSQ5ZvhSqpjD8+pfl6rapcS4gDc/8Ah3aVxMvRmBaP1thrkuAqxUFu2MHYWjKTn+JzwO4KZ9peOXIks2+0SZuujDhBQiB1DIk0g8R5/DcntTJm58MpBdLXHET7IQf9VBYoUxJ2Fk/ol4Ecn98+DxTuFSIMNLLXlt3XZ+pvXyFkoSkoHR5F9Ap+ObnIxadL1Iga81O2n5jq7DrkTg/PZfB3b5FbLHmLn8TfH4kc6TmR7QEJD3Yldwm/s4BA/6vTJhsZ8LznfxtksH/9zC/k6DW1nvs/lbsXmr5Or3DZMRo4fuJdlc0snrdi71x6Aiq6UjTlbri2hrpWisF9oWpRpTw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=E5P3qXgxOtOg7fZNcVqfDSPQ4OgKg55K2o1rzOUdxgk=; b=H+iIziYv1bMg/wDMCMJlLwKKYL00WI/HK4qnqEPVBiAayok99HanA3p6LR5aAwg3dqnb7u6rWGr6SqhxeQlLTB510zBY6kk2pMvodBTCIXiSeLBnCuOTftyoZ/zqnpuS163emqQAGhtc4gowLg7NujpHAwwJMJ45YZoQUUN5oS69stOnSBvjmMVRaQYS3CudHHpSPhVfYgC4YayLQXJrpqKSTJb0BeqKt7q7XA9VWij9rrp5l9d6mZWWpnXPEqFhGDwvQNNdp1KVHVTL3gJ09CfPC74h1QHahVTRpVBUiOqCdnlbZ/irFnQLrm68XLbtGHLqoPxEON/IzeXOHsKbjg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.112.34) smtp.rcpttodomain=intel.com smtp.mailfrom=nvidia.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=E5P3qXgxOtOg7fZNcVqfDSPQ4OgKg55K2o1rzOUdxgk=; b=reItx++hzpvGlFvoKKO5nLTYsQySN6mb2WG13KZNGjNc5CkeJBmem9L+0lpCh1M4GmK6ky/dYuqrHvfNL3zyx4OuKLML/GvDzYUnT4jX2wNEZelZSqnar6ChzGyjDUBnW7mCVdWUSfbl0vKqLOXJOpYals5o8PWbwA+r0wIC08zLaA5RL92gPefrQqQ88tg0d2OLLVc00oAYtF7OSYlJAfxRfV8pZbpvINc+RV7+VN2Ptw9Q6Y1wOhKeT6XUx/2T+wI3BiD3DhZs63byip5R19/h7xFsrg4EPej3Oaxwlo83WDxOX1qthQdvSR7rAkfZY9O2bswkLTQ9518MRmpWWw== Received: from DM5PR07CA0064.namprd07.prod.outlook.com (2603:10b6:4:ad::29) by CH0PR12MB5105.namprd12.prod.outlook.com (2603:10b6:610:bc::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4734.20; Tue, 23 Nov 2021 09:30:25 +0000 Received: from DM6NAM11FT012.eop-nam11.prod.protection.outlook.com (2603:10b6:4:ad:cafe::36) by DM5PR07CA0064.outlook.office365.com (2603:10b6:4:ad::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4713.22 via Frontend Transport; Tue, 23 Nov 2021 09:30:25 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.112.34) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 216.228.112.34 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.112.34; helo=mail.nvidia.com; Received: from mail.nvidia.com (216.228.112.34) by DM6NAM11FT012.mail.protection.outlook.com (10.13.173.109) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.4713.20 via Frontend Transport; Tue, 23 Nov 2021 09:30:24 +0000 Received: from nvidia.com (172.20.187.6) by HQMAIL107.nvidia.com (172.20.187.13) with Microsoft SMTP Server (TLS) id 15.0.1497.18; Tue, 23 Nov 2021 09:30:13 +0000 From: Gregory Etelson To: , CC: Ferruh Yigit , Viacheslav Ovsiienko , Raslan Darawsheh , Matan Azrad Subject: [PATCH v3] doc: add mlx5 PMD flex item documentation Date: Tue, 23 Nov 2021 11:29:57 +0200 Message-ID: <20211123092957.27081-1-getelson@nvidia.com> X-Mailer: git-send-email 2.34.0 In-Reply-To: <20211116154514.4029-1-getelson@nvidia.com> References: <20211116154514.4029-1-getelson@nvidia.com> MIME-Version: 1.0 X-Originating-IP: [172.20.187.6] X-ClientProxiedBy: HQMAIL105.nvidia.com (172.20.187.12) To HQMAIL107.nvidia.com (172.20.187.13) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 81cffd40-1589-42db-87a1-08d9ae63e0f0 X-MS-TrafficTypeDiagnostic: CH0PR12MB5105: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:6790; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: lwSDNIfOpW4cdxFmbu3wis5aSXRr2oH9bOeku/DWyoeksJuaa6LImyONEpXNyjAYZwji0GmhZ6TF6nwZrKHWGziw+ZmZtImTjcitexy5ZvZ/+HBTSkO6bfZzQW/7ZMKTgmZFiD9CBQR4BnQ7yfpUgPQsbBQJ50HorDBT+eRTMjKxc7xMwyuGio+s60lmiFoaEE2PUBjU79RmihkEod0bSvd35GjOoIt1T22Rddlny2eCDPm2AjzvTqIYw101wlBxbwNE0kJkjf3yC5v+vHpsAyK/frovk8kY850kI+ND0MyKYIasPmeSZeHlZVCTEfP5N+Y5ANA5GfeczlJ6/8bGp/sbrRacsVSVWJ8fDyXCqm+8dZRkeyfa+Bdp5bRVkXrrufgweEx8t/E6L03sW5+4Bbn35T0Vc/WgzT66aCsRU0UG3oVOsQyF+pPDiborRQIrcArfPPdEi//qV7WRYpQP7wo7kanD/60G6UViiMnFt3Xz2Lj0lXBskHZVeYlcynugjWYdX8sP/IvYYzMxh3rQfRl/Pz9tPjN2hDGiCk9yIBkreIA65KDFESPY+tmaO4BdP2AP+pHuBJeLo7kRd4TWGOsrX6Jxa62qMwj0M8KPsNs0zq4Cv9wabmm+D35TlbVc2WaC4MKoF3xUkqOMeCQYMF3FY+KeuT5mJKtClI1s8M8DpG3VNIHHjmUZIYt2Z/92pbNeo49DTgBtVjkYggCz7g== X-Forefront-Antispam-Report: CIP:216.228.112.34; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:schybrid03.nvidia.com; CAT:NONE; SFS:(4636009)(46966006)(36840700001)(70586007)(2906002)(70206006)(1076003)(36756003)(2616005)(8676002)(508600001)(5660300002)(8936002)(16526019)(6666004)(426003)(336012)(54906003)(47076005)(110136005)(26005)(36906005)(316002)(4326008)(186003)(6286002)(82310400004)(356005)(107886003)(55016003)(7636003)(7696005)(83380400001)(86362001)(7049001)(36860700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Nov 2021 09:30:24.6891 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 81cffd40-1589-42db-87a1-08d9ae63e0f0 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.112.34]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM11FT012.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH0PR12MB5105 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 Describe firmware configuration requirements. List mlx5 hardware and PMD limitations. Signed-off-by: Gregory Etelson Acked-by: Viacheslav Ovsiienko Acked-by: Raslan Darawsheh --- v2: Style fixes. v3: Update hardware and port support. --- doc/guides/nics/mlx5.rst | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 552e06c0db..7b2647dad6 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -494,6 +494,18 @@ Limitations from the reference "Clock Queue" completions, the scheduled send timestamps should not be specified with non-zero MSB. +- Flex item API: + + - Firmware configuration: ``FLEX_PARSER_PROFILE_ENABLE=4 PROG_PARSE_GRAPH=1``. + - Hardware support: BlueField 2. + - Flex item is supported for DPDK ports created over ECPF (Uplink representor, VF representor, + SF representor, HPF representor). + - Hardware limits ``header_length_mask_width`` up to 6 bits. + - Firmware supports 8 global sample fields. Each flex item allocates non-shared sample fields from that pool. + - Supported flex item can have 1 IN arc - ``eth`` or ``udp`` and up to 2 OUT arcs - ``ipv4`` or ``ipv6``. + - Flex item fields do not participate in RSS hash functions. + - In RTE flex item configuration, ``next_header.field_base`` value must be byte aligned (multiple of 8). + Statistics ---------- @@ -1260,6 +1272,11 @@ Below are some firmware configurations listed. REAL_TIME_CLOCK_ENABLE=1 +- enable dynamic flex parser for RTE flex item:: + + FLEX_PARSER_PROFILE_ENABLE=4 + PROG_PARSE_GRAPH=1 + Linux Prerequisites -------------------