From patchwork Tue Sep 4 13:49:11 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomasz Duszynski X-Patchwork-Id: 44249 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 300465B36; Tue, 4 Sep 2018 15:49:41 +0200 (CEST) Received: from mail-lj1-f175.google.com (mail-lj1-f175.google.com [209.85.208.175]) by dpdk.org (Postfix) with ESMTP id 757F15592 for ; Tue, 4 Sep 2018 15:49:34 +0200 (CEST) Received: by mail-lj1-f175.google.com with SMTP id q127-v6so3195872ljq.11 for ; Tue, 04 Sep 2018 06:49:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=semihalf-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=Pb1QM3WoKO0XDxYYp3UuHsmAdN8YjUREMaw6CI+dY7c=; b=Q7v/0SXQg+QfzK2uYQN0+uuadSUV5qcKCHv7rPSGNHJZNhjIdZJW+ULAb7eLqBiabW yllJicro5RRSOXuQdRqgkoKmWYGqNi0crFgLolWmKnJN18/wqhgdzodnQXuzlng9dTMC CfmCe8hvOc57hhwYwrVuKH30PknhU4KdBjhKNKIcLycTgYcWBvfLm++Ze0E9xUjWu5BY stC1EGAQex34+dCfkobxgkey2Jt/JsKjQIm/Hlabt6I36C9NWBWlTg5azL/THGABKd37 7FzWPlhzKbXsXHd6kPfctgHgbPjCmwVqJ7FuDrkkmGKLG2vzb6v6qggHGmUWY9ZNOG6L ZKjQ== 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:in-reply-to :references; bh=Pb1QM3WoKO0XDxYYp3UuHsmAdN8YjUREMaw6CI+dY7c=; b=GD7Ga/Dl0qM7UY4lxa5cBFtQNvKukR8f43FYVVlVMa2O28nshqQJouCcohPn6lP+/D vpio/hAVSfpL+YlbKJr1TBopahK1v3MA1aCUQ6ye9HNOY516YiImyuhzEXrvuctHTzX9 L21+Gc46DimB7uKNNpzs/sBe4Sa6HG3f50CbFUuhCYYsQ8o0w+asYNgDm8xbB20z8oiv 3wpLoytOUtirKaiEpW9yQAh44Q0idBfjnhGvy0wKywT0C3ed8TqUD2SdzJUZ0+WAjmP0 Cogx2+gP4QVmuxAykOFfMTKJydJ9FV+kQnTynaMAzAXMrug3ecFlvyXCy2CjQ9v0Kr7F 6okA== X-Gm-Message-State: APzg51COtMR6BbyJ3AxnUvOMQmLGDxSCKGcYp5I8Ty6te2RezJcd9V25 VBhZQWpJmi/dGn5r6ePU97gfbJTMeJQ2zg== X-Google-Smtp-Source: ANB0VdZkjrUvqfv95fttom2Tf5FdNgisqlNZt+tWbwzaJVR90MP55EDXL+lgx3rqnavY2XbGBNAJhA== X-Received: by 2002:a2e:259:: with SMTP id 86-v6mr21532590ljc.107.1536068973882; Tue, 04 Sep 2018 06:49:33 -0700 (PDT) Received: from sh.semihalf.local (31-172-191-173.noc.fibertech.net.pl. [31.172.191.173]) by smtp.gmail.com with ESMTPSA id q22-v6sm4057225lff.10.2018.09.04.06.49.32 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 04 Sep 2018 06:49:33 -0700 (PDT) From: Tomasz Duszynski To: dev@dpdk.org Cc: nsamsono@marvell.com, mw@semihalf.com Date: Tue, 4 Sep 2018 15:49:11 +0200 Message-Id: <1536068953-9352-11-git-send-email-tdu@semihalf.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1536068953-9352-1-git-send-email-tdu@semihalf.com> References: <1536045016-32008-1-git-send-email-tdu@semihalf.com> <1536068953-9352-1-git-send-email-tdu@semihalf.com> Subject: [dpdk-dev] [PATCH v2 10/12] net/mvpp2: align documentation with MUSDK 18.09 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" From: Natalie Samsonov Update documentation to align with MUSDK 18.09. Signed-off-by: Natalie Samsonov --- doc/guides/nics/mvpp2.rst | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/doc/guides/nics/mvpp2.rst b/doc/guides/nics/mvpp2.rst index a452c8a..3b3f8c6 100644 --- a/doc/guides/nics/mvpp2.rst +++ b/doc/guides/nics/mvpp2.rst @@ -74,6 +74,7 @@ Features of the MVPP2 PMD are: - QoS - RX flow control - TX queue start/stop +- Scattered TX frames Limitations @@ -96,19 +97,19 @@ Prerequisites .. code-block:: console - git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell.git -b linux-4.4.52-armada-17.10 + git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell.git -b linux-4.4.120-armada-18.09 - Out of tree `mvpp2x_sysfs` kernel module sources .. code-block:: console - git clone https://github.com/MarvellEmbeddedProcessors/mvpp2x-marvell.git -b mvpp2x-armada-17.10 + git clone https://github.com/MarvellEmbeddedProcessors/mvpp2x-marvell.git -b mvpp2x-armada-18.09 - MUSDK (Marvell User-Space SDK) sources .. code-block:: console - git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell.git -b musdk-armada-17.10 + git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell.git -b musdk-armada-18.09 MUSDK is a light-weight library that provides direct access to Marvell's PPv2 (Packet Processor v2). Alternatively prebuilt MUSDK library can be @@ -119,12 +120,6 @@ Prerequisites To get better understanding of the library one can consult documentation available in the ``doc`` top level directory of the MUSDK sources. - MUSDK must be configured with the following features: - - .. code-block:: console - - --enable-bpool-dma=64 - - DPDK environment Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup @@ -140,6 +135,9 @@ The following options can be modified in the ``config`` file. Toggle compilation of the librte mvpp2 driver. + .. Note:: + + When MVPP2 PMD is enabled ``CONFIG_RTE_LIBRTE_MVNETA_PMD`` must be disabled QoS Configuration ----------------- @@ -314,7 +312,7 @@ Driver needs precompiled MUSDK library during compilation. export CROSS_COMPILE=/bin/aarch64-linux-gnu- ./bootstrap - ./configure --host=aarch64-linux-gnu --enable-bpool-dma=64 + ./configure --host=aarch64-linux-gnu make install MUSDK will be installed to `usr/local` under current directory. @@ -328,7 +326,8 @@ the path to the MUSDK installation directory needs to be exported. export LIBMUSDK_PATH=/usr/local export CROSS=aarch64-linux-gnu- make config T=arm64-armv8a-linuxapp-gcc - sed -ri 's,(MVPP2_PMD=)n,\1y,' build/.config + sed -i "s/MVNETA_PMD=y/MVNETA_PMD=n/" build/.config + sed -i "s/MVPP2_PMD=n/MVPP2_PMD=y/" build/.config make Flow API @@ -500,15 +499,14 @@ Usage Example ------------- MVPP2 PMD requires extra out of tree kernel modules to function properly. -`musdk_uio` and `mv_pp_uio` sources are part of the MUSDK. Please consult +`musdk_cma` sources are part of the MUSDK. Please consult ``doc/musdk_get_started.txt`` for the detailed build instructions. For `mvpp2x_sysfs` please consult ``Documentation/pp22_sysfs.txt`` for the detailed build instructions. .. code-block:: console - insmod musdk_uio.ko - insmod mv_pp_uio.ko + insmod musdk_cma.ko insmod mvpp2x_sysfs.ko Additionally interfaces used by DPDK application need to be put up: