From patchwork Wed Jul 3 11:42:47 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Lance Richardson X-Patchwork-Id: 56018 X-Patchwork-Delegate: ferruh.yigit@amd.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 1A2C52C38; Wed, 3 Jul 2019 13:42:54 +0200 (CEST) Received: from mail-pl1-f193.google.com (mail-pl1-f193.google.com [209.85.214.193]) by dpdk.org (Postfix) with ESMTP id 1DA732BC8 for ; Wed, 3 Jul 2019 13:42:53 +0200 (CEST) Received: by mail-pl1-f193.google.com with SMTP id w24so1115274plp.2 for ; Wed, 03 Jul 2019 04:42:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=broadcom.com; s=google; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=AJCs11f2nGART8sL3pH18BhM84/xjXFsKirF4eyMa6A=; b=EPwOAW73yqzc5eh/HVsZZ02i4EzOAJp1FRSQR1KKkbPwmv+l2MmBTffGC0j2hWnj1o iYusc/DtzWueNkmwRAY8V6Yn6Mv0zqW8EEChyLuNdJYvExmFQPzb+Qsn7T/+5Jvn3m14 FoZwZfJmqmxor57YC0l6tRMwaum9ErcqukvJ4= 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=AJCs11f2nGART8sL3pH18BhM84/xjXFsKirF4eyMa6A=; b=iH0s75hDCxs2r6KpzBzouMOYJfLYknWyIl4hNxIUdU4O4dAtPAveMSJ0v7GS0JyBL6 7S0vhE5fhq1cCOf6Y7ACmgUKIOFx9etJvJbZri2AeHnYvDhXnMMHdd4ywISTLckguVEn DymljAbKKw2n9cw6WqnI+5vl237/6PJMTfMNRsakBtbxDkxSRVCpXYxB1oXLxlidYl3O RcSrmbTfU+wYKnYEujLTRBWF8ix/a2vjI07Y3D3tYVcrjAuwyZrWMJ+GQWYklsLn5V2/ /r0Pu7UzETByB99ZK8OZjMKZ+SL3feiwtXc/HbEXOUGZ0LUf4Om1eiR5ck3RNsNSvFT5 bhuw== X-Gm-Message-State: APjAAAUqlCbXY5wqBkNqPZR0iWoXnTWDo+vmD20jJHXiLwc4FnzK/fCM x3PMEVadDwzbNaOAQx4wJ3tsPvWcyM26ih0J/zP31O6KnXDWvbd+pKUn11VmHVWr1g6VNnaBE0a lZY1tKhabTjZvE9fYRRvvZOKdSWjp+0g9y1GFqMcwfMzK+XJRZ4T157JHlq96G6/z X-Google-Smtp-Source: APXvYqxVLlUaB7CjNxrmnfVffg/ECl2bIk7SrfQqItOt3SaZO3VDtN/8P6oipoYKE/7lDL0ugpSxpg== X-Received: by 2002:a17:902:8203:: with SMTP id x3mr42363123pln.304.1562154171961; Wed, 03 Jul 2019 04:42:51 -0700 (PDT) Received: from localhost.localdomain ([192.19.231.250]) by smtp.gmail.com with ESMTPSA id u65sm9478603pjb.1.2019.07.03.04.42.50 (version=TLS1_3 cipher=AEAD-AES256-GCM-SHA384 bits=256/256); Wed, 03 Jul 2019 04:42:51 -0700 (PDT) From: Lance Richardson To: dev@dpdk.org Cc: ajit.khaparde@broadcom.com, Lance Richardson Date: Wed, 3 Jul 2019 07:42:47 -0400 Message-Id: <20190703114247.13597-1-lance.richardson@broadcom.com> X-Mailer: git-send-email 2.17.1 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: update bnxt PMD guide 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" - Include list of supported adapters. - Include list of supported features. - Document requirements for vector mode PMD. - Remove obsolete limitation (scatter rx has been supported for some time). - Fixed broken links. Acked-by: Ajit Khaparde Signed-off-by: Lance Richardson --- doc/guides/nics/bnxt.rst | 140 +++++++++++++++++++++++++++++++++------ 1 file changed, 120 insertions(+), 20 deletions(-) diff --git a/doc/guides/nics/bnxt.rst b/doc/guides/nics/bnxt.rst index d88e02116..434ba9d6c 100644 --- a/doc/guides/nics/bnxt.rst +++ b/doc/guides/nics/bnxt.rst @@ -1,20 +1,126 @@ .. SPDX-License-Identifier: BSD-3-Clause - Copyright 2016-2018 Broadcom + Copyright 2016-2019 Broadcom BNXT Poll Mode Driver ===================== -The bnxt poll mode library (**librte_pmd_bnxt**) implements support for: +The BNXT PMD (**librte_pmd_bnxt**) implements support for adapters based on +Ethernet controllers and SoCs belonging to the **Broadcom BCM5730X NetXtreme-C® +Family of Ethernet Network Controllers**, the **Broadcom BCM574XX/BCM575XX +NetXtreme-E® Family of Ethernet Network Controllers**, the **Broadcom BCM588XX +Stingray Family of SmartNIC Adapters**, and the **Broadcom StrataGX® BCM5871X +Series of Communications Processors**. A complete list with links to reference +material is included below. - * **Broadcom NetXtreme-C®/NetXtreme-E®/NetXtreme-S® - BCM5730X / BCM574XX / BCM58000 / BCM575XX family of Ethernet Network Controllers** - Adapters based on this family of controllers support standards-compliant Ethernet - operation with link speeds of 10/25/50/100/200Gbps. +BNXT PMD Features +----------------- - Information about the NetXtreme family of adapters can be found in the - `NetXtreme® Brand section - `_ +The BNXT PMD includes support for the following features: + + * Multiple transmit and receive queues + * Queue start/stop + * RSS hash + * RSS key configuration + * RSS reta configuration + * VMDq + * Packet type parsing + * Configurable RX CRC stripping + * L3/L4 checksum offload + * LRO offload + * TSO offload + * VLAN offload + * SR-IOV VF + * Basic and extended port statistics + * Link state reporting + * Flow control + * Ethertype filtering + * N-tuple filtering + * Promiscuous mode + * Unicast and multicast MAC filtering + * Scatter/gather transmit and receive + * Jumbo frames + * Vector PMD + +BNXT Vector PMD +--------------- + +The BNXT PMD includes support for SSE vector mode on x86 platforms. Vector +provides significantly improved performance over the base implementation, +however it does not support all of the features that are supported by the +base (non-vector) implementation. Vector mode will be selected and enabled +automatically when the port is started if allowed by the current configuration. + +RX Requirements for Vector Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Vector mode receive will be enabled if the following constrainsts are met: + * Packets must fit within a single mbuf (no scatter RX). + * LRO offload must be disabled. + +TX Requirements for Vector Mode +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Vector mode transmit will be enabled if the following constrainsts are met: + * Packets must be contained within a single mbuf (no gather TX). + * All transmit offloads other than VLAN insertion must be disabled. + +BNXT PMD Supported Chipsets and Adapters +---------------------------------------- + +Chipsets and adapters supported by the bnxt PMD include: + + * **Broadcom BCM5730X NetXtreme-C® Family of Ethernet Network Controllers** + + * M150c - Single-port 40/50 Gigabit Ethernet Adapter + * P150c - Single-port 40/50 Gigabit Ethernet Adapter + * P225c - Dual-port 10/25 Gigabit Ethernet Adapter + + * **Broadcom BCM574XX/BCM575XX NetXtreme-E® Family of Ethernet Network Controllers** + + * M125P - Single-port OCP 2.0 10/25 Gigabit Ethernet Adapter + * M150P - Single-port OCP 2.0 50 Gigabit Ethernet Adapter + * M150PM - Single-port OCP 2.0 Multi-Host 50 Gigabit Ethernet Adapter + * M210P - Dual-port OCP 2.0 10 Gigabit Ethernet Adapter + * M210TP - Dual-port OCP 2.0 10 Gigabit Ethernet Adapter + * M11000G - Single-port OCP 2.0 10/25/50/100 Gigabit Ethernet Adapter + * N150G - Single-port OCP 3.0 50 Gigabit Ethernet Adapter + * M225P - Dual-port OCP 2.0 10/25 Gigabit Ethernet Adapter + * N210P - Dual-port OCP 3.0 10 Gigabit Ethernet Adapter + * N210TP - Dual-port OCP 3.0 10 Gigabit Ethernet Adapter + * N225P - Dual-port OCP 3.0 10/25 Gigabit Ethernet Adapter + * N250G - Dual-port OCP 3.0 50 Gigabit Ethernet Adapter + * N410SG - Quad-port OCP 3.0 10 Gigabit Ethernet Adapter + * N410SGBT - Quad-port OCP 3.0 10 Gigabit Ethernet Adapter + * N425G - Quad-port OCP 3.0 10/25 Gigabit Ethernet Adapter + * N1100G - Single-port OCP 3.0 10/25/50/100 Gigabit Ethernet Adapter + * N2100G - Dual-port OCP 3.0 10/25/50/100 Gigabit Ethernet Adapter + * N2200G - Dual-port OCP 3.0 10/25/50/100/200 Gigabit Ethernet Adapter + * P150P - Single-port 50 Gigabit Ethernet Adapter + * P210P - Dual-port 10 Gigabit Ethernet Adapter + * P210TP - Dual-port 10 Gigabit Ethernet Adapter + * P225P - Dual-port 10/25 Gigabit Ethernet Adapter + * P410SG - Quad-port 10 Gigabit Ethernet Adapter + * P410SGBT - Quad-port 10 Gigabit Ethernet Adapter + * P425G - Quad-port 10/25 Gigabit Ethernet Adapter + * P1100G - Single-port 10/25/50/100 Gigabit Ethernet Adapter + * P2100G - Dual-port 10/25/50/100 Gigabit Ethernet Adapter + * P2200G - Dual-port 10/25/50/100/200 Gigabit Ethernet Adapter + + Information about Ethernet adapters in the NetXtreme family of + adapters can be found in the `NetXtreme® Brand section + `_ + of the `Broadcom website `_. + + * **Broadcom BCM588XX Stingray Family of SmartNIC Adapters** + + * PS410T - Quad-port 10 Gigabit Ethernet SmartNIC + * PS225 - Dual-port 25 Gigabit Ethernet SmartNIC + * PS250 - Dual-Port 50 Gigabit Ethernet SmartNIC + + Information about the Stingray family of SmartNIC adapters can be found in the + `Stingray® Brand section + `_ of the `Broadcom website `_. * **Broadcom StrataGX® BCM5871X Series of Communucations Processors** @@ -25,14 +131,8 @@ The bnxt poll mode library (**librte_pmd_bnxt**) implements support for: attached storage (NAS). Information about the StrataGX family of adapters can be found in the - `StrataGX® BCM5871X Series section - `_ - of the `Broadcom website `_. - -Limitations ------------ - -With the current driver, allocated mbufs must be large enough to hold -the entire received frame. If the mbufs are not large enough, the -packets will be dropped. This is most limiting when jumbo frames are -used. + `StrataGX® BCM58712 + `_ + and `StrataGX® BCM58713 + `_ + sections of the `Broadcom website `_.