From patchwork Thu Nov 30 13:32:23 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomasz Duszynski X-Patchwork-Id: 31833 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 390377CE2; Thu, 30 Nov 2017 14:32:51 +0100 (CET) Received: from mail-lf0-f65.google.com (mail-lf0-f65.google.com [209.85.215.65]) by dpdk.org (Postfix) with ESMTP id 0BCDB5593 for ; Thu, 30 Nov 2017 14:32:46 +0100 (CET) Received: by mail-lf0-f65.google.com with SMTP id f20so7917848lfe.3 for ; Thu, 30 Nov 2017 05:32:46 -0800 (PST) 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=UHI7+wvnM/I26dnGb8FanB4lkruq6zHJpVNEF0Qhwlc=; b=f0/7YnBJNQpe7fPBczxoSBKKoscSLN8nMN6MupdDc+0Wif6Kb6u6E2jN+NXbwpTTwO tpoovyC3lDrcqxREV6whKBSaluX2D6peqQAESvvWNpesp0OklKKxvSFjJo6Dr5ZM7a3x i4R9FX1P/uC1//ePesPlAhHA35ZOY7mOtKkNSEsdAjvRRCGFzl46+AiMQzT48SE2IVYr lF8S/TyCrmNjRFv28WqH0eoC9zvfaAZmo55vApZ0WNvs9nS+yEwxzq5KpOSED26CPvjq dyifM0KrsoRL4T0XXkAw2Ea9i1egNHbbIYoIO62YJiCTlvHp9VQJOlPjwYz3di5kVWHa lLGQ== 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=UHI7+wvnM/I26dnGb8FanB4lkruq6zHJpVNEF0Qhwlc=; b=QQQDFM3lSbQJaPwjhqPIuRrwvDRgKjqr28eq2pYFS0R+FoL0WdLD+xPPYrEPY8YHEH uJbbbvpx3OXrNxhlvCbFGAwXH8SbGJLMn39UBPa6+3gFFK1UvBUEYga+aLU0iNqoOrnZ HbJi/SgI+jPwFfn0mxUyc40JgqgQtIHdIzyxj2Pr1QFAZmvpdj7UqYGX01tfeCQ9v4/N bJ64Ntli2uR7kWiWzmx7pmGU+PHU3db1jJUDIJB851j516P4WPOKJDY7MdSimwstJ+Iw XT4oLRRVgD3GDgW0vMNlPWPMGeg7MAO92gmtGz+ekj+W1BC5rMJyiC+Axmhwnc9CUV7r Klsw== X-Gm-Message-State: AJaThX5EFQ8yosB06NJBKfcuSLE/AgTVcreEjF3NKBYJKAQJtDkmV2ug ptUir0Lu1UjMk2xeyR3z/JjtxASR9MQ= X-Google-Smtp-Source: AGs4zMa0o1bPxJHfZbIhdsePNcs6j94vwAaHRzf4rzvyhubPUPakrH0uv6l87lZwegvAHHqdL/GHWw== X-Received: by 10.46.21.79 with SMTP id 15mr3304461ljv.27.1512048765292; Thu, 30 Nov 2017 05:32:45 -0800 (PST) Received: from tdu.semihalf.local (31-172-191-173.noc.fibertech.net.pl. [31.172.191.173]) by smtp.gmail.com with ESMTPSA id x27sm717277lfb.23.2017.11.30.05.32.44 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Thu, 30 Nov 2017 05:32:44 -0800 (PST) From: Tomasz Duszynski To: dev@dpdk.org Cc: mw@semihalf.com, jck@semihalf.com, dima@marvell.com, nsamsono@marvell.com, jianbo.liu@arm.com, Tomasz Duszynski Date: Thu, 30 Nov 2017 14:32:23 +0100 Message-Id: <1512048743-23749-8-git-send-email-tdu@semihalf.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1512048743-23749-1-git-send-email-tdu@semihalf.com> References: <1512048743-23749-1-git-send-email-tdu@semihalf.com> Subject: [dpdk-dev] [PATCH 7/7] net/mrvl: update MRVL NET PMD documentation 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" Update MRVL NET PMD documentation. Signed-off-by: Tomasz Duszynski --- doc/guides/nics/mrvl.rst | 69 +++++++++++++++++++++++++++++++----------------- 1 file changed, 45 insertions(+), 24 deletions(-) diff --git a/doc/guides/nics/mrvl.rst b/doc/guides/nics/mrvl.rst index fbfdf47..67b254c 100644 --- a/doc/guides/nics/mrvl.rst +++ b/doc/guides/nics/mrvl.rst @@ -87,31 +87,40 @@ Limitations Prerequisites ------------- -- Custom Linux Kernel sources available - `here `__. +- Custom Linux Kernel sources -- Out of tree `mvpp2x_sysfs` kernel module sources available - `here `__. + .. code-block:: console -- MUSDK (Marvell User-Space SDK) sources available - `here `__. + git clone https://github.com/MarvellEmbeddedProcessors/linux-marvell.git -b linux-4.4.52-armada-17.10 - MUSDK is a light-weight library that provides direct access to Marvell's - PPv2 (Packet Processor v2). Alternatively prebuilt MUSDK library can be - requested from `Marvell Extranet `_. Once - approval has been granted, library can be found by typing ``musdk`` in - the search box. +- Out of tree `mvpp2x_sysfs` kernel module sources - MUSDK must be configured with the following features: + .. code-block:: console - .. code-block:: console + git clone https://github.com/MarvellEmbeddedProcessors/mvpp2x-marvell.git -b mvpp2x-armada-17.10 - --enable-bpool-dma=64 +- MUSDK (Marvell User-Space SDK) sources + + .. code-block:: console + + git clone https://github.com/MarvellEmbeddedProcessors/musdk-marvell.git -b musdk-armada-17.10 + + MUSDK is a light-weight library that provides direct access to Marvell's + PPv2 (Packet Processor v2). Alternatively prebuilt MUSDK library can be + requested from `Marvell Extranet `_. Once + approval has been granted, library can be found by typing ``musdk`` in + the search box. + + 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 - DPDK environment. + Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup + DPDK environment. Config File Options @@ -123,11 +132,6 @@ The following options can be modified in the ``config`` file. Toggle compilation of the librte_pmd_mrvl driver. -- ``CONFIG_RTE_MRVL_MUSDK_DMA_MEMSIZE`` (default ``41943040``) - - Size in bytes of the contiguous memory region that MUSDK will allocate - for run-time DMA-able data buffers. - QoS Configuration ----------------- @@ -142,7 +146,7 @@ Configuration syntax [port default] default_tc = - qos_mode = + mapping_priority = [port tc ] rxq = @@ -160,7 +164,7 @@ Where: - ````: Default traffic class (e.g. 0) -- ````: QoS priority for mapping (`ip`, `vlan`, `ip/vlan` or `vlan/ip`). +- ````: QoS priority for mapping (`ip`, `vlan`, `ip/vlan` or `vlan/ip`). - ````: Traffic Class to be configured. @@ -218,9 +222,26 @@ Building DPDK Driver needs precompiled MUSDK library during compilation. Please consult ``doc/musdk_get_started.txt`` for the detailed build instructions. +.. code-block:: console + + export CROSS_COMPILE=/bin/aarch64-linux-gnu- + ./bootstrap + ./configure --enable-bpool-dma=64 + make install + +MUSDK will be installed to `usr/local` under current directory. +For the detailed build instructions please consult ``doc/musdk_get_started.txt``. + Before the DPDK build process the environmental variable ``LIBMUSDK_PATH`` with the path to the MUSDK installation directory needs to be exported. +.. code-block:: console + + export LIBMUSDK_PATH=/usr/local + export CROSS=aarch64-linux-gnu- + make config T=arm64-armv8a-linuxapp-gcc + sed -ri 's,(MRVL_PMD=)n,\1y,' build/.config + make Usage Example ------------- @@ -242,7 +263,7 @@ Additionally interfaces used by DPDK application need to be put up: .. code-block:: console ip link set eth0 up - ip link set eth1 up + ip link set eth2 up In order to run testpmd example application following command can be used: