From patchwork Thu Jan 28 22:23:49 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Matej Vido X-Patchwork-Id: 10204 X-Patchwork-Delegate: bruce.richardson@intel.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 6CAAEC502; Thu, 28 Jan 2016 23:24:14 +0100 (CET) Received: from office2.cesnet.cz (office2.cesnet.cz [195.113.144.244]) by dpdk.org (Postfix) with ESMTP id BA01CC500 for ; Thu, 28 Jan 2016 23:24:13 +0100 (CET) Received: from localhost.localdomain (bband-dyn71.95-103-243.t-com.sk [95.103.243.71]) (using TLSv1 with cipher AES128-SHA (128/128 bits)) (No client certificate requested) by office2.cesnet.cz (Postfix) with ESMTPSA id 56193ED55AC; Thu, 28 Jan 2016 23:24:13 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cesnet.cz; s=office2; t=1454019853; bh=UvFE4q5sMPSn7mJqwVmx35ViZPzvxh/2G+XUXMQ/7I8=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References; b=nsLIy4UQir1T/VeuwTj0AwUnRzgOh/Qn0rnixi3w07A+bSTJBYeLuvUY9xogs08u8 SACL7oq/8a8O7dxRZbYhIQVGosdpXgPsqMUwiEtgj+cmRA18vTXOlvRGsIIQdwbgL4 NEKIKjTrfFGOB+HaoC1GJ6h1PlYAwcsS/Ypge8mk= From: Matej Vido To: dev@dpdk.org Date: Thu, 28 Jan 2016 23:23:49 +0100 Message-Id: <1454019829-5908-4-git-send-email-vido@cesnet.cz> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1454019829-5908-1-git-send-email-vido@cesnet.cz> References: <1454019829-5908-1-git-send-email-vido@cesnet.cz> Cc: pus@cesnet.cz, viktorin@rehivetech.com Subject: [dpdk-dev] [PATCH 4/4] szedata2: update documentation and release notes X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Add info about change from virtual PMD_VDEV to PMD_PDEV and new functions to release notes. Signed-off-by: Matej Vido --- doc/guides/nics/szedata2.rst | 93 +++++++++++++++++++++------------ doc/guides/rel_notes/release_2_3.rst | 9 +++ 2 files changed, 68 insertions(+), 34 deletions(-) diff --git a/doc/guides/nics/szedata2.rst b/doc/guides/nics/szedata2.rst index ee3c3fe..ac512a0 100644 --- a/doc/guides/nics/szedata2.rst +++ b/doc/guides/nics/szedata2.rst @@ -1,5 +1,5 @@ .. BSD LICENSE - Copyright 2015 CESNET + Copyright 2015 - 2016 CESNET All rights reserved. Redistribution and use in source and binary forms, with or without @@ -33,8 +33,8 @@ SZEDATA2 poll mode driver library The SZEDATA2 poll mode driver library implements support for cards from COMBO family (**COMBO-80G**, **COMBO-100G**). -The SZEDATA2 PMD is virtual PMD which uses interface provided by libsze2 -library to communicate with COMBO cards over sze2 layer. +The SZEDATA2 PMD uses interface provided by libsze2 library to communicate +with COMBO cards over sze2 layer. More information about family of `COMBO cards `_ @@ -74,50 +74,41 @@ separately: * szedata2_cv3 Kernel modules manage initialization of hardware, allocation and - sharing of resources for user space applications: + sharing of resources for user space applications. Information about getting the dependencies can be found `here `_. +Configuration +------------- -Using the SZEDATA2 PMD ----------------------- - -SZEDATA2 PMD can be created by passing ``--vdev=`` option to EAL in the -following format: - -.. code-block:: console - - --vdev 'DEVICE,dev_path=PATH,rx_ifaces=RX_MASK,tx_ifaces=TX_MASK' - -``DEVICE`` and options ``dev_path``, ``rx_ifaces``, ``tx_ifaces`` are mandatory -and must be separated by commas. +These configuration options can be modified before compilation in the +``.config`` file: -* ``DEVICE``: contains prefix ``eth_szedata2`` followed by numbers or letters, - must be unique for each virtual device +* ``CONFIG_RTE_LIBRTE_PMD_SZEDATA2`` default value: **n** -* ``dev_path``: Defines path to szedata2 device. - Value is valid path to szedata2 device. Example: + Value **y** enables compilation of szedata2 PMD. - .. code-block:: console +* ``CONFIG_RTE_LIBRTE_PMD_SZEDATA2_AS`` default value: **0** - dev_path=/dev/szedataII0 + This option defines type of firmware address space. + Currently supported value is: -* ``rx_ifaces``: Defines which receive channels will be used. - For each channel is created one queue. Value is mask for selecting which - receive channels are required. Example: + * **0** for firmwares: - .. code-block:: console + * NIC_100G1_LR4 + * HANIC_100G1_LR4 + * HANIC_100G1_SR10 - rx_ifaces=0x3 -* ``tx_ifaces``: Defines which transmit channels will be used. - For each channel is created one queue. Value is mask for selecting which - transmit channels are required. Example: +Using the SZEDATA2 PMD +---------------------- - .. code-block:: console +From DPDK version 2.3.0 the type of SZEDATA2 PMD is changed to PMD_PDEV. +SZEDATA2 device is automatically recognized during EAL initialization. +No special command line options are needed. - tx_ifaces=0x3 +Kernel modules have to be loaded before running the DPDK application. Example of usage ---------------- @@ -128,5 +119,39 @@ transmit channel: .. code-block:: console $RTE_TARGET/app/testpmd -c 0xf -n 2 \ - --vdev 'eth_szedata20,dev_path=/dev/szedataII0,rx_ifaces=0x3,tx_ifaces=0x3' \ - -- --port-topology=chained --rxq=2 --txq=2 --nb-cores=2 + -- --port-topology=chained --rxq=2 --txq=2 --nb-cores=2 -i -a + +Example output: + +.. code-block:: console + + [...] + EAL: PCI device 0000:06:00.0 on NUMA socket -1 + EAL: probe driver: 1b26:c1c1 rte_szedata2_pmd + PMD: Initializing szedata2 device (0000:06:00.0) + PMD: SZEDATA2 path: /dev/szedataII0 + PMD: Available DMA channels RX: 8 TX: 8 + PMD: resource0 phys_addr = 0xe8000000 len = 134217728 virt addr = 7f48f8000000 + PMD: szedata2 device (0000:06:00.0) successfully initialized + Interactive-mode selected + Auto-start selected + Configuring Port 0 (socket 0) + Port 0: 00:11:17:00:00:00 + Checking link statuses... + Port 0 Link Up - speed 10000 Mbps - full-duplex + Done + Start automatic packet forwarding + io packet forwarding - CRC stripping disabled - packets/burst=32 + nb forwarding cores=2 - nb forwarding ports=1 + RX queues=2 - RX desc=128 - RX free threshold=0 + RX threshold registers: pthresh=0 hthresh=0 wthresh=0 + TX queues=2 - TX desc=512 - TX free threshold=0 + TX threshold registers: pthresh=0 hthresh=0 wthresh=0 + TX RS bit threshold=0 - TXQ flags=0x0 + testpmd> + +.. note:: + + Link speed API currently supports speeds up to 40 Gbps. + Therefore there is used 10G constant for 100 Gbps cards until the link speed + API is not changed. diff --git a/doc/guides/rel_notes/release_2_3.rst b/doc/guides/rel_notes/release_2_3.rst index 99de186..6f22017 100644 --- a/doc/guides/rel_notes/release_2_3.rst +++ b/doc/guides/rel_notes/release_2_3.rst @@ -15,6 +15,15 @@ EAL Drivers ~~~~~~~ +* **szedata2: Change type of driver from PMD_VDEV to PMD_PDEV.** + + Previously szedata2 device had to be added by ``--vdev`` option. + Now szedata2 PMD recognises the device automatically during EAL + initialization. + +* **szedata2: Add functions for promiscuous and allmulticast modes.** + +* **szedata2: Add functions for setting link up/down.** Libraries ~~~~~~~~~