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 C935341CE4; Mon, 20 Feb 2023 09:42:31 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id CB22A42FBC; Mon, 20 Feb 2023 09:42:18 +0100 (CET) Received: from NAM02-DM3-obe.outbound.protection.outlook.com (mail-dm3nam02on2108.outbound.protection.outlook.com [40.107.95.108]) by mails.dpdk.org (Postfix) with ESMTP id CCF6442FD6 for ; Mon, 20 Feb 2023 09:42:15 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=kGXBkqOH7ohOvYqs6T0ngUMiA5L6YDkB9Fj8+qThTKGh+b8OZjLmjvjYSGkZ6O0+r1uuUHemDNZIFzV2mAcKXi4T1XnvsBx3PeuyQFIiWVjFgtVdNMZUUS3Vd1QoJL3gQ+o7JrzZtkHo6Y2bwJVp2hETlY44KFo55yF7e+d+ZGjkAGcU8ikj3dfX6u3ibD2/S/z3udVzfKONH80xXEEveA0g1OZ65DmzvfkhBQYtGmH4zmhqsMq82+aQsXrvnSK6FHS0JPb2z7SPGgQkSI0VM7R10EkPFgvXh9Q6pkGitsNU3k9K5SQ2Uog1CuQYjnVMwTr/6Syqp34/IYKXmr/sTg== 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=WC7xX0IzIQk99LT6iBK6TtI5/tDifF+WACxNNWu/ZDQ=; b=VI3fsjrEvIQ4AlSwsA1LnEnfqs08hFgxHjA+S/gyG0sP7OL055IcmV3lQFZR4uJ5abO/Behnt9MUW+B8bJ5SHI0SSbdfrotf4JaVSarieKdEi2n++Kgc7f+QPlw2yYYO7QBEZvNHJtjRKx/CoZs4Va42E0c/hqy5Gu+DMSVnLIPUNdILigxNj4EqoICPMd9r7sf0J24E0xA5Gn/fpfKFbgfe8aYkvGx1LRT1BU+ITDO0lWwG4n2t/CjUyXZ3Kcl65HyjFu31CFt66VRb4QiA7m06Eya4yY/HLX74EeY28cz4q+KTTH3N34aX5XZ8pYdxIO53qb++sBeN84JWa34mBQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=corigine.com; dmarc=pass action=none header.from=corigine.com; dkim=pass header.d=corigine.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=corigine.onmicrosoft.com; s=selector2-corigine-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=WC7xX0IzIQk99LT6iBK6TtI5/tDifF+WACxNNWu/ZDQ=; b=KRECIG516QruKKuYnEW7ir7fapIm5iMnXRksUBhoUqrBoDtgo46DJKX8w4z0BU56cX708xZZHo/ILDeGsn+6ch03tQYv3udkegqfpU1DE/SAPZ6LBUu/OtuKaKf/4GWSgb8v4+c1+B8R0k2abj1Wn/nH8H3fZe+KDOFPI774Krc= Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=corigine.com; Received: from SJ0PR13MB5545.namprd13.prod.outlook.com (2603:10b6:a03:424::5) by SA0PR13MB3966.namprd13.prod.outlook.com (2603:10b6:806:9e::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6111.20; Mon, 20 Feb 2023 08:42:14 +0000 Received: from SJ0PR13MB5545.namprd13.prod.outlook.com ([fe80::7ea4:e421:5dd5:9f4d]) by SJ0PR13MB5545.namprd13.prod.outlook.com ([fe80::7ea4:e421:5dd5:9f4d%5]) with mapi id 15.20.6111.018; Mon, 20 Feb 2023 08:42:14 +0000 From: Chaoyong He To: dev@dpdk.org Cc: oss-drivers@corigine.com, niklas.soderlund@corigine.com, Walter Heymans , Chaoyong He Subject: [PATCH v2 3/3] doc: add Corigine information to nfp documentation Date: Mon, 20 Feb 2023 16:41:11 +0800 Message-Id: <20230220084111.40531-4-chaoyong.he@corigine.com> X-Mailer: git-send-email 2.29.3 In-Reply-To: <20230220084111.40531-1-chaoyong.he@corigine.com> References: <20230203080845.24126-1-chaoyong.he@corigine.com> <20230220084111.40531-1-chaoyong.he@corigine.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-ClientProxiedBy: SG2PR04CA0158.apcprd04.prod.outlook.com (2603:1096:4::20) To SJ0PR13MB5545.namprd13.prod.outlook.com (2603:10b6:a03:424::5) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: SJ0PR13MB5545:EE_|SA0PR13MB3966:EE_ X-MS-Office365-Filtering-Correlation-Id: 11223491-8d73-4105-5d79-08db131e5d32 X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: QNVBC5jfn7nFb5h1LmYxI2GFjTdG1KwgpqQ4nWssQtW0yA3Mqe9p0ZT9HZZcoywRvee38SVa4hhm3JVQrCPFzMbeAiViuzOW8+RrBsslV8+mWGNmQ1VutWCKtsLK0kApe8JRjZaA++/SNZQZnY6C+oHxbHEkbSh/j91djPioV9CIwW7zUYCb/uxJOmGqRWDw/tjVaKRGX0uka4FAsZcd3aaEwacWuFrxSot5DR9mjn305w44gfdRX/8TOSU3sn4ibZ38KEtzIwruRCEqLYysfq1zMgQHFDezaJBkJBbDGBz8EYevpm8xZ+oLwdroivHZh3e6q8JzJYZtSDmvv5zrFexKYLDKvpcBuU0FaqHQ8G/DJN84hZRiaBX8uNV9MMEaTuBoaa7axdJRmlmYmCom8UeE1/FYVr0vZOywaL9WwlT8BubDY8QoF7h3D3AaP7bkeiHXl4p0SkqWGwaPK9CmiOkM7GyI/Sqz1yOqsPIahSAYHhZdC+DSErfD7V4f/zz/abBk1GFSpbUemAQZe6RmZifZRyDpmcF27gTP0QESdPoTleMjmZ5f2uGoDWiN4ItAgwWBFoDHFiC0XpVv9Pdpon2PGhBGd/bFTjUCdpB83O9hObHZWgLz2/IdxMGpExufoYeDvFA6AYsqLxrpBLDprntPt5eEn30FeeBL0dTwLU67+yZ5hldgOh5nPl9scWfN X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SJ0PR13MB5545.namprd13.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230025)(4636009)(346002)(39840400004)(376002)(396003)(366004)(136003)(451199018)(83380400001)(8936002)(5660300002)(66574015)(41300700001)(86362001)(44832011)(2906002)(52116002)(4326008)(6486002)(966005)(6666004)(6512007)(186003)(26005)(1076003)(6506007)(107886003)(316002)(8676002)(66946007)(66476007)(6916009)(66556008)(478600001)(2616005)(54906003)(38350700002)(36756003)(38100700002); DIR:OUT; SFP:1102; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?B?UW5BazVzbG5ncC9VMXc5WlJQZllYY2Joank1ckMxeFNqSE9FUmlFRXUwelg1?= =?utf-8?B?M05DZkhZN1BER3hYc0dBNjh4RkJuSzREMU9jZVdnd2RYTVNRSXlDbG0yWVFG?= =?utf-8?B?aUtMT3lUSURpMVZENWd3TDFaOE1NNVBtYjZjcGFTaHgxb09HbTRrcjdCSzAw?= =?utf-8?B?YUV5Y2IyU2tLV0Z4M0p5T2Fjc0djdWpUTlRkcFp4Y2tBdEFrY2hZaGJ4U1h4?= =?utf-8?B?YVoxQytuOHI5ejU0M2dTYUdZT0JYUy9nek1lY2FCV2xYRjYvYkluVTBGTXVX?= =?utf-8?B?YkVVMWhCTFc2cjZhQXVCcVRpN3JZUlZsdmI5eVpuOWJaMExmNzcvVzQ2eVBu?= =?utf-8?B?b2ZDZUo3T0RsMlltSVhhTi9xdUlQbWZpcTg1RDdHZUxZMDZLajZzajkySzZV?= =?utf-8?B?Q09GQnNCdHRiYlB3U1c3MURyTy9kYUFwVk1SL01qaGgwOWdXUFpVbG9mVlph?= =?utf-8?B?WnlJdUNYTW9aeUZiS0dtZzg3OXR5dVNEbWxpT0FIT0pkR3BmL3RvZ3JLTjF1?= =?utf-8?B?OGdzUGJaYzlocUJZdUJmR3hTUUZwK1lRNmdxQ2dQYkFIMVB2TmdnMHlxYkha?= =?utf-8?B?VVJGNlFvUFM0SFpUOGpZNkdJRWE0WDc2bWlHTW16M1o1Yk10MnJKZVRzZlhw?= =?utf-8?B?NTIxbzI0MVY3UXJyVXpVUmMxRC9mNGRwSG1pUVMrQ1lXSXlXWFVrWmdoOGpH?= =?utf-8?B?OWptUERBVFlYdDREWVZTS1dROWcxeHg1OVhHYzZxOFFBZVp3SmVJNkRGN3Ba?= =?utf-8?B?anBOTllBZnU3SmxWODU2blkvd1hBaEpEWEZJeUZVNDluaXhLaEdKa1pyMng0?= =?utf-8?B?NmwvbGo2SXJFNkZMNERYdkcxZExPYmw4WE1ha3NKcXhzYmdNT05PanJXWHBs?= =?utf-8?B?dEJvNnpQcHd2VlVVN3RoNzA1dEVFZjdvR2hiNzhnVDhtTUREWmVDZXV2RlRk?= =?utf-8?B?TTEyS0hsVmtoSkZkYXB3VG5wbGJSRi9rZHFDUHUvVHhyTG9mQ2hoZk4zZzRK?= =?utf-8?B?U3gvMEEvaE53azArclFSdzlGbVIvcjltWmpkOG9WdW5OenF5WHlJbjNnQ2dT?= =?utf-8?B?ZVZwZTIvcVZJMzlrY2NIRzlwelVXVGFzZS9sRDRVdkcxaG5GV1pvZGtwSjdD?= =?utf-8?B?cFZVWXdIa2h0MjNuR3pvbTBoTCtZYWJvMkVtcUxOc0lIM2hYV1N6VzN3YkY3?= =?utf-8?B?ZkpHeWR3QnhDNGNIelEreG5sVnh3UlV5eUNSTm1HK0JnTVp2VnhNRi9qUlZE?= =?utf-8?B?K1hSQmVXY3NZUkhGMXFYUnhBcHJZeERIdTB3bzVITnNFOTRjRFZXQTFENkJ6?= =?utf-8?B?MVA4STBTZE5YT1ZIWmhBc2hEZ0tUTVRmSm1jZnhVTnJEcVpBcmQyRFdVNzI3?= =?utf-8?B?b01IakhmM0l2bGVkR2RpekdlWGErejhGV0xIa0o4WTNRTFhZWVlXVjl2WEwr?= =?utf-8?B?ZjZMa2JyRU1KS3FOMkQ0UmlqTGNVbU10M1p5TVI0V0lFKzhxMUZ3c1lIVXk2?= =?utf-8?B?cGk3bnBQRHlBUzN4cEN5R1lPb0tKYmNIb2FXY1BYQzYwT0I2cEFia01uYTFC?= =?utf-8?B?QTY2d1lpSWg3b1VKaVNYbjIzcU5ScmxyRWRreEh4UUtDQkQwZElMbkhvWHNu?= =?utf-8?B?QjdENGM1UkZaWlBETkd2ekNYNjFvVXlueEtrSTVycFk5cXN6S1lvZklJUG5Y?= =?utf-8?B?em5hNTFpL2pBcHZHU1NpSmpjSmNTU0pXbGNXS1AzbGlpNmpRZ0RnZUF4Z09O?= =?utf-8?B?ZzBsaE1sdFhiSFVZY0x5NmMza0xyMzloMzV1K3NBUW1KaTMzL0taZWhxcW1E?= =?utf-8?B?SWwrWExVRHRJNFVEN28wYVNpSWdidUZvSVJDSWZ4cjhnVzN1bEFSeXBxS3JT?= =?utf-8?B?cXdSV2xYcmhhM2FqdUg1T2xwcS93UHlsbm4yWEZtVm9Rc09zWGpCTHhiUUo1?= =?utf-8?B?T1VMZER6QTVvUlRxblEyZFQ4Z1pmUlVlTnF5YVQrTXdQcVZMK2FhUUdGTGIx?= =?utf-8?B?VWdTTlkwVnBFK01ucXo4cTZ0Y3hLTUdYL3ZRQVR1WmQzSFV0TW9hT3VaTkJ4?= =?utf-8?B?UGJiZG84Vjg2NUxLTEdqRFgza1lIZWduSm9vdEEzSE5UMENFbUpXVVZzaVhk?= =?utf-8?B?b0xIMVVwU2VDY0NucXEyTzhtWWhMbk4zbGdLcFcvbm41MTJxLzYzS0lQMUxh?= =?utf-8?B?M2c9PQ==?= X-OriginatorOrg: corigine.com X-MS-Exchange-CrossTenant-Network-Message-Id: 11223491-8d73-4105-5d79-08db131e5d32 X-MS-Exchange-CrossTenant-AuthSource: SJ0PR13MB5545.namprd13.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Feb 2023 08:42:13.9085 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: fe128f2c-073b-4c20-818e-7246a585940c X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: QxJEGbz2hE3KAu4dD0Sgd3Jx+2vOOUF24fRRwqPHpVq5m4a6ELFH5kYPy5hTwaq+UeDRwSvmwvHE1JcY73GToUSsLGxLhjrrSlPpqoJTJSE= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA0PR13MB3966 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 From: Walter Heymans Add Corigine information to the nfp documentation. The Network Flow Processor (NFP) PMD is used by products from both Netronome and Corigine. Signed-off-by: Walter Heymans Reviewed-by: Chaoyong He Reviewed-by: Niklas Söderlund --- doc/guides/nics/nfp.rst | 78 +++++++++++++++++++++++++---------------- 1 file changed, 47 insertions(+), 31 deletions(-) diff --git a/doc/guides/nics/nfp.rst b/doc/guides/nics/nfp.rst index d133b6385c..f102238a28 100644 --- a/doc/guides/nics/nfp.rst +++ b/doc/guides/nics/nfp.rst @@ -1,19 +1,18 @@ .. SPDX-License-Identifier: BSD-3-Clause Copyright(c) 2015-2017 Netronome Systems, Inc. All rights reserved. - All rights reserved. + Copyright(c) 2021 Corigine, Inc. All rights reserved. NFP poll mode driver library ============================ -Netronome's sixth generation of flow processors pack 216 programmable -cores and over 100 hardware accelerators that uniquely combine packet, -flow, security and content processing in a single device that scales +Netronome and Corigine's sixth generation of flow processors pack 216 +programmable cores and over 100 hardware accelerators that uniquely combine +packet, flow, security and content processing in a single device that scales up to 400-Gb/s. -This document explains how to use DPDK with the Netronome Poll Mode -Driver (PMD) supporting Netronome's Network Flow Processor 6xxx -(NFP-6xxx), Netronome's Network Flow Processor 4xxx (NFP-4xxx) and -Netronome's Network Flow Processor 38xx (NFP-38xx). +This document explains how to use DPDK with the Network Flow Processor (NFP) +Poll Mode Driver (PMD) supporting Netronome and Corigine's NFP-6xxx, NFP-4xxx +and NFP-38xx product lines. NFP is a SR-IOV capable device and the PMD supports the physical function (PF) and the virtual functions (VFs). @@ -21,15 +20,16 @@ function (PF) and the virtual functions (VFs). Dependencies ------------ -Before using the Netronome's DPDK PMD some NFP configuration, +Before using the NFP DPDK PMD some NFP configuration, which is not related to DPDK, is required. The system requires -installation of **Netronome's BSP (Board Support Package)** along -with a specific NFP firmware application. Netronome's NSP ABI +installation of the **nfp-bsp (Board Support Package)** along +with a specific NFP firmware application. The NSP ABI version should be 0.20 or higher. -If you have a NFP device you should already have the code and -documentation for this configuration. Contact -**support@netronome.com** to obtain the latest available firmware. +If you have a NFP device you should already have the documentation to perform +this configuration. Contact **support@netronome.com** (for Netronome products) +or **smartnic-support@corigine.com** (for Corigine products) to obtain the +latest available firmware. The NFP Linux netdev kernel driver for VFs has been a part of the vanilla kernel since kernel version 4.5, and support for the PF @@ -44,9 +44,9 @@ Linux kernel driver. Building the software --------------------- -Netronome's PMD code is provided in the **drivers/net/nfp** directory. -Although NFP PMD has Netronome´s BSP dependencies, it is possible to -compile it along with other DPDK PMDs even if no BSP was installed previously. +The NFP PMD code is provided in the **drivers/net/nfp** directory. Although +NFP PMD has BSP dependencies, it is possible to compile it along with other +DPDK PMDs even if no BSP was installed previously. Of course, a DPDK app will require such a BSP installed for using the NFP PMD, along with a specific NFP firmware application. @@ -68,9 +68,9 @@ like uploading the firmware and configure the Link state properly when starting or stopping a PF port. Since DPDK 18.05 the firmware upload happens when a PF is initialized, which was not always true with older DPDK versions. -Depending on the Netronome product installed in the system, firmware files -should be available under ``/lib/firmware/netronome``. DPDK PMD supporting the -PF looks for a firmware file in this order: +Depending on the product installed in the system, firmware files should be +available under ``/lib/firmware/netronome``. DPDK PMD supporting the PF looks +for a firmware file in this order: 1) First try to find a firmware image specific for this device using the NFP serial number: @@ -85,19 +85,22 @@ PF looks for a firmware file in this order: nic_AMDA0099-0001_2x25.nffw -Netronome's software packages install firmware files under -``/lib/firmware/netronome`` to support all the Netronome's SmartNICs and -different firmware applications. This is usually done using file names based on -SmartNIC type and media and with a directory per firmware application. Options -1 and 2 for firmware filenames allow more than one SmartNIC, same type of -SmartNIC or different ones, and to upload a different firmware to each +Netronome and Corigine's software packages install firmware files under +``/lib/firmware/netronome`` to support all the Netronome and Corigine SmartNICs +and different firmware applications. This is usually done using file names +based on SmartNIC type and media and with a directory per firmware application. +Options 1 and 2 for firmware filenames allow more than one SmartNIC, same type +of SmartNIC or different ones, and to upload a different firmware to each SmartNIC. .. Note:: Currently the NFP PMD supports using the PF with Agilio Firmware with NFD3 and Agilio Firmware with NFDk. See - https://help.netronome.com/support/solutions for more information on the - various firmwares supported by the Netronome Agilio CX smartNIC. + `Netronome Support `_. + for more information on the various firmwares supported by the Netronome + Agilio SmartNIC range, or + `Corigine Support `_. + for more information about Corigine's range. PF multiport support -------------------- @@ -164,6 +167,12 @@ System configuration lspci -d 19ee: + and on Corigine SmartNICs using: + + .. code-block:: console + + lspci -d 1da8: + Now, for example, to configure two virtual functions on a NFP device whose PCI system identity is "0000:03:00.0": @@ -171,12 +180,19 @@ System configuration echo 2 > /sys/bus/pci/devices/0000:03:00.0/sriov_numvfs - The result of this command may be shown using lspci again: + The result of this command may be shown using lspci again on Netronome + SmartNICs: .. code-block:: console lspci -kd 19ee: + and on Corigine SmartNICs: + + .. code-block:: console + + lspci -kd 1da8: + Two new PCI devices should appear in the output of the above command. The -k option shows the device driver, if any, that the devices are bound to. Depending on the modules loaded, at this point the new PCI devices may be @@ -186,8 +202,8 @@ System configuration Flow offload ------------ -Use the flower firmware application, some type of Netronome's SmartNICs can -offload the flow into cards. +Using the flower firmware application, some types of Netronome or Corigine +SmartNICs can offload the flows onto the cards. The flower firmware application requires the PMD running two services: -- 2.29.3