X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fnics%2Fbnxt.rst;h=33b2f3fcc0fb684d306bf34be7f6b9731f927341;hb=9e30b88f60b2f61382fabe9f49e6683a3fc9c6ec;hp=129a16cfc7576a7a49f11d1e6c847d8531990208;hpb=82c4fb852e4287a7e6ff529d333648e52f40d451;p=dpdk.git diff --git a/doc/guides/nics/bnxt.rst b/doc/guides/nics/bnxt.rst index 129a16cfc7..33b2f3fcc0 100644 --- a/doc/guides/nics/bnxt.rst +++ b/doc/guides/nics/bnxt.rst @@ -4,7 +4,7 @@ BNXT Poll Mode Driver ===================== -The Broadcom BNXT PMD (**librte_pmd_bnxt**) implements support for adapters +The Broadcom BNXT PMD (**librte_net_bnxt**) implements support for adapters based on Ethernet controllers and SoCs belonging to the Broadcom BCM574XX/BCM575XX NetXtreme-E® Family of Ethernet Network Controllers, the Broadcom BCM588XX Stingray Family of Smart NIC Adapters, and the Broadcom @@ -385,7 +385,7 @@ The application enables multiple TX and RX queues when it is started. .. code-block:: console -   testpmd -l 1,3,5 --master-lcore 1 --txq=2 –rxq=2 --nb-cores=2 +   testpmd -l 1,3,5 --main-lcore 1 --txq=2 –rxq=2 --nb-cores=2 **TSS** @@ -565,9 +565,6 @@ The BNXT PMD supports a PTP client application to communicate with a PTP master clock using DPDK IEEE1588 APIs. Note that the PTP client application needs to run on PF and vector mode needs to be disabled. -For the PTP time synchronization support, the BNXT PMD must be compiled with -``CONFIG_RTE_LIBRTE_IEEE1588=y`` (this compilation flag is currently pending). - .. code-block:: console testpmd> set fwd ieee1588 // enable IEEE 1588 mode @@ -612,7 +609,7 @@ Basic stats include: * oerrors By default, per-queue stats for 16 queues are supported. For more than 16 -queues, BNXT PMD should be compiled with ``CONFIG_RTE_ETHDEV_QUEUE_STAT_CNTRS`` +queues, BNXT PMD should be compiled with ``RTE_ETHDEV_QUEUE_STAT_CNTRS`` set to the desired number of queues. Extended Stats @@ -734,6 +731,48 @@ Note that currently hot-plugging of representor ports is not supported so all the required representors must be specified on the creation of the PF or the trusted VF. +Representors on Stingray SoC +---------------------------- +A representor created on X86 host typically represents a VF running in the same +X86 domain. But in case of the SoC, the application can run on the CPU complex +inside the SoC. The representor can be created on the SoC to represent a PF or a +VF running in the x86 domain. Since the representator creation requires passing +the bus:device.function of the PCI device endpoint which is not necessarily in the +same host domain, additional dev args have been added to the PMD. + +* rep_is_vf - false to indicate VF representor +* rep_is_pf - true to indicate PF representor +* rep_based_pf - Physical index of the PF +* rep_q_r2f - Logical COS Queue index for the rep to endpoint direction +* rep_q_f2r - Logical COS Queue index for the endpoint to rep direction +* rep_fc_r2f - Flow control for the representor to endpoint direction +* rep_fc_f2r - Flow control for the endpoint to representor direction + +The sample command line with the new ``devargs`` looks like this:: + + -w 0000:06:02.0,host-based-truflow=1,representor=[1],rep-based-pf=8,\ + rep-is-pf=1,rep-q-r2f=1,rep-fc-r2f=0,rep-q-f2r=1,rep-fc-f2r=1 + +.. code-block:: console + + testpmd -l1-4 -n2 -w 0008:01:00.0,host-based-truflow=1,\ + representor=[0], rep-based-pf=8,rep-is-pf=0,rep-q-r2f=1,rep-fc-r2f=1,\ + rep-q-f2r=0,rep-fc-f2r=1 --log-level="pmd.*",8 -- -i --rxq=3 --txq=3 + +Number of flows supported +------------------------- +The number of flows that can be support can be changed using the devargs +parameter ``max_num_kflows``. The default number of flows supported is 16K each +in ingress and egress path. + +Selecting EM vs EEM +------------------- +Broadcom devices can support filter creation in the onchip memory or the +external memory. This is referred to as EM or EEM mode respectively. +The decision for internal/external EM support is based on the ``devargs`` +parameter ``max_num_kflows``. If this is set by the user, external EM is used. +Otherwise EM support is enabled with flows created in internal memory. + Application Support -------------------