From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga17.intel.com (mga17.intel.com [192.55.52.151]) by dpdk.org (Postfix) with ESMTP id 282855A6E for ; Wed, 6 Mar 2019 13:45:11 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga004.jf.intel.com ([10.7.209.38]) by fmsmga107.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 06 Mar 2019 04:45:11 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.58,447,1544515200"; d="scan'208";a="280221864" Received: from fyigit-mobl.ger.corp.intel.com (HELO [10.252.14.113]) ([10.252.14.113]) by orsmga004.jf.intel.com with ESMTP; 06 Mar 2019 04:45:08 -0800 To: Rosen Xu , dev@dpdk.org Cc: tianfei.zhang@intel.com, dan.wei@intel.com, andy.pei@intel.com, qiming.yang@intel.com, haiyue.wang@intel.com, santos.chen@intel.com, zhang.zhang@intel.com References: <1551338000-120348-1-git-send-email-rosen.xu@intel.com> <1551338000-120348-11-git-send-email-rosen.xu@intel.com> From: Ferruh Yigit Openpgp: preference=signencrypt Autocrypt: addr=ferruh.yigit@intel.com; prefer-encrypt=mutual; keydata= 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 vM8= Message-ID: <7e3d20a9-b3c1-da61-a7f8-2aa105a33d7f@intel.com> Date: Wed, 6 Mar 2019 12:45:07 +0000 User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.5.2 MIME-Version: 1.0 In-Reply-To: <1551338000-120348-11-git-send-email-rosen.xu@intel.com> Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: 8bit Subject: Re: [dpdk-dev] [PATCH v1 10/11] doc: add IPN3KE document 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: , X-List-Received-Date: Wed, 06 Mar 2019 12:45:12 -0000 On 2/28/2019 7:13 AM, Rosen Xu wrote: > Add Intel FPGA Acceleration NIC IPN3KE document. No need to separate the doc patch, can merge into the one that adds the driver. > > Signed-off-by: Rosen Xu > Signed-off-by: Dan Wei > --- > doc/guides/nics/features/ipn3ke.ini | 57 ++++++++++++++++++++++ > doc/guides/nics/index.rst | 1 + > doc/guides/nics/ipn3ke.rst | 97 +++++++++++++++++++++++++++++++++++++ > 3 files changed, 155 insertions(+) > create mode 100644 doc/guides/nics/features/ipn3ke.ini > create mode 100644 doc/guides/nics/ipn3ke.rst > > diff --git a/doc/guides/nics/features/ipn3ke.ini b/doc/guides/nics/features/ipn3ke.ini > new file mode 100644 > index 0000000..06cfaf5 > --- /dev/null > +++ b/doc/guides/nics/features/ipn3ke.ini > @@ -0,0 +1,57 @@ > +; > +; Supported features of the 'ipn3ke' network poll mode driver. > +; > +; Refer to default.ini for the full list of available PMD features. > +; > +[Features] > +Speed capabilities = Y > +Link status = Y > +Link status event = Y > +Rx interrupt = Y > +Queue start/stop = Y > +Runtime Rx queue setup = Y > +Runtime Tx queue setup = Y > +Jumbo frame = Y > +Scattered Rx = Y > +TSO = Y > +Promiscuous mode = Y > +Allmulticast mode = Y > +Unicast MAC filter = Y > +Multicast MAC filter = Y > +RSS hash = Y > +RSS key update = Y > +RSS reta update = Y > +VMDq = Y > +SR-IOV = Y > +DCB = Y > +VLAN filter = Y > +Ethertype filter = Y > +Tunnel filter = Y > +Hash filter = Y > +Flow director = Y > +Flow control = Y > +Flow API = Y > +Traffic mirroring = Y > +CRC offload = Y > +VLAN offload = Y > +QinQ offload = Y > +L3 checksum offload = Y > +L4 checksum offload = Y > +Inner L3 checksum = Y > +Inner L4 checksum = Y > +Packet type parsing = Y > +Timesync = Y > +Rx descriptor status = Y > +Tx descriptor status = Y > +Basic stats = Y > +Extended stats = Y > +FW version = Y > +Module EEPROM dump = Y > +Multiprocess aware = Y > +BSD nic_uio = Y > +Linux UIO = Y > +Linux VFIO = Y > +x86-32 = Y > +x86-64 = Y > +ARMv8 = Y > +Power8 = Y Are these all marked to 'Y' because the underlying PMD is i40e? Is ipn3ke really verified with Power8, arm etc? > diff --git a/doc/guides/nics/index.rst b/doc/guides/nics/index.rst > index 5c80e3b..6671481 100644 > --- a/doc/guides/nics/index.rst > +++ b/doc/guides/nics/index.rst > @@ -28,6 +28,7 @@ Network Interface Controller Drivers > fm10k > i40e > ice > + ipn3ke Please add alphabetically sorted. > ifc > igb > ixgbe > diff --git a/doc/guides/nics/ipn3ke.rst b/doc/guides/nics/ipn3ke.rst > new file mode 100644 > index 0000000..7386075 > --- /dev/null > +++ b/doc/guides/nics/ipn3ke.rst > @@ -0,0 +1,97 @@ > +.. SPDX-License-Identifier: BSD-3-Clause > + Copyright(c) 2019 Intel Corporation. > + > +IPN3KE Poll Mode Driver > +======================= > + > +The ipn3ke PMD (librte_pmd_ipn3ke) provides poll mode driver support > +for Intel® FPGA PAC(Programmable Acceleration Card) N3000 based on > +the Intel Ethernet Controller X710/XXV710 and Intel Arria 10 FPGA. > + > +In this card, FPGA is an acceleration bridge between network interface > +and the Intel Ethernet Controller. Although both FPGA and Ethernet > +Controllers are connected to CPU with PCIe Gen3x16 Switch, all the > +packet RX/TX is handled by Intel Ethernet Controller. So from application > +point of view the data path is still the legacy Intel Ethernet Controller > +X710/XXV710 PMD. Besides this, users can enable more acceleration > +features by FPGA IP. > + > +Prerequisites > +------------- > + > +- Identifying your adapter using `Intel Support > + `_ and get the latest NVM/FW images. > + > +- Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. > + > +- To get better performance on Intel platforms, please follow the "How to get best performance with NICs on Intel platforms" > + section of the :ref:`Getting Started Guide for Linux `. > + > + > +Pre-Installation Configuration > +------------------------------ > + > +Config File Options > +~~~~~~~~~~~~~~~~~~~ > + > +The following options can be modified in the ``config`` file. > +Please note that enabling debugging options may affect system performance. > + > +- ``CONFIG_RTE_LIBRTE_IPN3KE_PMD`` (default ``n``) > + > + Toggle compilation of the ``librte_pmd_ipn3ke`` driver. > + > +- ``CONFIG_RTE_LIBRTE_IPN3KE_DEBUG_*`` (default ``n``) The name is wrong, there is no DEBUG_*, also it seems not used, if so please remove. > + > + Toggle display of generic debugging messages. > + > +Runtime Config Options > +~~~~~~~~~~~~~~~~~~~~~~ > + > +- ``Maximum Number of Queue Pairs`` > + > + The maximum number of queue pairs is decided by HW. If not configured, APP > + uses the number from HW. Users can check the number by calling the API > + ``rte_eth_dev_info_get``. > + If users want to limit the number of queues, they can set a smaller number > + using EAL parameter like ``max_queue_pair_num=n``. Is this copy/paste error? There is no 'max_queue_pair_num' device argument in this driver. And there are other devargs, seems not documented here. > + > + > +Driver compilation and testing > +------------------------------ > + > +Refer to the document :ref:`compiling and testing a PMD for a NIC ` > +for details. > + > +Sample Application Notes > +------------------------ > + > +Packet TX/RX with FPGA Pass-through image > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +FPGA Pass-through bitstream is original FPGA Image. > + > +To start ``testpmd``, and add I40e PF to FPGA network port: > + > +.. code-block:: console > + > + ./app/testpmd -l 0-15 -n 4 --vdev 'ifpga_rawdev_cfg0,ifpga=b3:00.0,port=0' --vdev 'ipn3ke_cfg0,afu=0|b3:00.0,i40e_pf={0000:b1:00.0|0000:b1:00.1|0000:b1:00.2|0000:b1:00.3|0000:b5:00.0|0000:b5:00.1|0000:b5:00.2|0000:b5:00.3}' -- -i --no-numa --port-topology=loop Can you please help me understand? raw device ifpga_rawdev_cfg0, used to get devargs and to create the AFU device. AFU driver is already in this patch, net_ipn3ke_afu. It should be probed after rawdev created the device. vdev ipn3ke_cfg0, used to get devargs and link afu device and i40e devices, so i40e devices should be already probed in this stage, and port representors created for AFU device. Is above correct? Overall there is a IFPGA bus and AFU device work going on, but they are behind rawdev and vdev. > + > +HQoS and flow acceleration > +~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +HQoS and flow acceleration bitstream is used to offloading HQoS and flow classifier. > + > +To start ``testpmd``, and add I40e PF to FPGA network port, enable FPGA HQoS and Flow Acceleration: > + > +.. code-block:: console > + > + ./app/testpmd -l 0-15 -n 4 --vdev 'ifpga_rawdev_cfg0,ifpga=b3:00.0,port=0' --vdev 'ipn3ke_cfg0,afu=0|b3:00.0,fpga_acc={tm|flow},i40e_pf={0000:b1:00.0|0000:b1:00.1|0000:b1:00.2|0000:b1:00.3|0000:b5:00.0|0000:b5:00.1|0000:b5:00.2|0000:b5:00.3}' -- -i --no-numa --forward-mode=macswap > + > +Limitations or Known issues > +--------------------------- > + > +19.05 limitation > +~~~~~~~~~~~~~~~~ > + > +Ipn3ke code released in 19.05 is for evaluation only. >