From patchwork Thu Sep 3 11:23:51 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Heinrich Kuhn X-Patchwork-Id: 76405 X-Patchwork-Delegate: ferruh.yigit@amd.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 151A3A04C5; Thu, 3 Sep 2020 13:24:10 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id D36EB1C0B2; Thu, 3 Sep 2020 13:24:08 +0200 (CEST) Received: from mail-ej1-f65.google.com (mail-ej1-f65.google.com [209.85.218.65]) by dpdk.org (Postfix) with ESMTP id A28F4E07 for ; Thu, 3 Sep 2020 13:24:07 +0200 (CEST) Received: by mail-ej1-f65.google.com with SMTP id i22so3331305eja.5 for ; Thu, 03 Sep 2020 04:24:07 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=netronome-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=a3OY/8WduuEATGY1IT5cy9IPbFtB0ZgMBfq/kEBaGII=; b=Xo2+tsx6YIuA7EeiD9A8mcXm5oRHo2oLz/xB30UuDV6qwtthY6JjO7jSzbB80f9YcF tRnDi6OhjfB36Avxq9sLNPYG7fTQx6eM9zYSA72uPjen38XXGk06ilY9wlZhn6UM1x4k hqLLvLfSE+6sfYgdNr9frqqlMUJ+YUoMz3kiuO1S1VsdyBpy/his61x7TQbqIte3uBWJ EUzHLUUqt1Ecy40c0cvuavm2kbX9P2aJLOeujSWidRDR2Azk277XorhrBfe+sITE+YMP 2kwhowf4kbP1521pqpi64LHQMuY+nN8B+SlS5iduHYI3cQaKrjab7Ko/uPJDZzdlqmZM b+4Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=a3OY/8WduuEATGY1IT5cy9IPbFtB0ZgMBfq/kEBaGII=; b=gko7Tt4eXpZJHfOJK6JJobYWtELb3UcJW5BGam694TSq0lJtb3OOeVLd9Cm+RmQqkk fj5SWJ1a8Eo5AvelG+Mune0rtWPPyR/skhvw0st5RnrJRj4zeVdlUA8nHKqZZ4TW7dP8 z9klTA/af6ek+ldfCpuE3zKZ3Bkg45jHtVw0KBPdTXG95BWEvcAJqWUlwPH51eQNg1+H PxcDupsVXKhtYkCJNGA21WY44HRwlJm1J0tMnktar+xJNeoFz3ya9wMy9SjORqB+y3P0 9a9rlFvlY6YH84qhcx6znRU1Ibn8SZp3dIXvJTirH2cOKRXtlaOXcu8ZmwsPLTHtzwVp f+PA== X-Gm-Message-State: AOAM532F4vjEgFENKVgMF7QorUatirsO0ZApM7fKH+MX+Tg3vdZL24lQ upAf3OXyf1CJ98ZvJ4n7kvgrcIUtkWJG1fM+GTa9IQSZc8dI1ljik54dFx+oTFWScSoKO4yRVLM msweUcg7wJt7VkgH4uKlN0F0Or4SONPLMfT4BXAKC/zET9DdpsAdzTpre1eQ0ricydas= X-Google-Smtp-Source: ABdhPJxhxo1+bv9TuZxUvsc7j/1VYvNQwFWbjR6t5ZfWxso1kFSWDEAMfNGfUO9QbpHIiT3qeGIWag== X-Received: by 2002:a17:906:819:: with SMTP id e25mr1655764ejd.95.1599132247016; Thu, 03 Sep 2020 04:24:07 -0700 (PDT) Received: from kuhn-fedora.netronome.com (dsl-197-245-84-176.voxdsl.co.za. [197.245.84.176]) by smtp.gmail.com with ESMTPSA id n26sm2727210eds.71.2020.09.03.04.24.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 03 Sep 2020 04:24:06 -0700 (PDT) From: Heinrich Kuhn To: dev@dpdk.org Cc: Heinrich Kuhn , stable@dpdk.org, Simon Horman Date: Thu, 3 Sep 2020 13:23:51 +0200 Message-Id: <20200903112351.45880-1-heinrich.kuhn@netronome.com> X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: improve NFP PMD multiport PF documentation 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" The Agilio CX family of smartNIC's generally have a 1:many mapping of PF to physical ports. Elaborate on this mapping in the PF multiport section of the NFP PMD documentation. Fixes: d625beafc8be ("doc: update NFP with PF support information") Cc: stable@dpdk.org Signed-off-by: Heinrich Kuhn Signed-off-by: Simon Horman --- doc/guides/nics/nfp.rst | 37 +++++++++++++++++++++++++++---------- 1 file changed, 27 insertions(+), 10 deletions(-) diff --git a/doc/guides/nics/nfp.rst b/doc/guides/nics/nfp.rst index 5f2a0698f..020e37d13 100644 --- a/doc/guides/nics/nfp.rst +++ b/doc/guides/nics/nfp.rst @@ -102,22 +102,39 @@ 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 Basic Firmware. See + https://help.netronome.com/support/solutions for more information on the + various firmwares supported by the Netronome Agilio CX smartNIC. PF multiport support -------------------- -Some NFP cards support several physical ports with just one single PCI device. -The DPDK core is designed with a 1:1 relationship between PCI devices and DPDK -ports, so NFP PMD PF support requires handling the multiport case specifically. -During NFP PF initialization, the PMD will extract the information about the -number of PF ports from the firmware and will create as many DPDK ports as -needed. +The NFP PMD can work with up to 8 ports on the same PF device. The number of +available ports is firmware and hardware dependent, and the driver looks for a +firmware symbol during initialization to know how many can be used. -Because the unusual relationship between a single PCI device and several DPDK -ports, there are some limitations when using more than one PF DPDK port: there -is no support for RX interrupts and it is not possible either to use those PF -ports with the device hotplug functionality. +DPDK apps work with ports, and a port is usually a PF or a VF PCI device. +However, with the NFP PF multiport there is just one PF PCI device. Supporting +this particular configuration requires the PMD to create ports in a special way, +although once they are created, DPDK apps should be able to use them as normal +PCI ports. +NFP ports belonging to same PF can be seen inside PMD initialization with a +suffix added to the PCI ID: wwww:xx:yy.z_port_n. For example, a PF with PCI ID +0000:03:00.0 and four ports is seen by the PMD code as: + + .. code-block:: console + + 0000:03:00.0_port_0 + 0000:03:00.0_port_1 + 0000:03:00.0_port_2 + 0000:03:00.0_port_3 + + .. Note:: + + There are some limitations with multiport support: RX interrupts and + device hot-plugging are not supported. PF multiprocess support -----------------------