From patchwork Tue Dec 5 09:39:22 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tomasz Duszynski X-Patchwork-Id: 31933 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 0CB391B18C; Tue, 5 Dec 2017 10:39:48 +0100 (CET) Received: from mail-lf0-f67.google.com (mail-lf0-f67.google.com [209.85.215.67]) by dpdk.org (Postfix) with ESMTP id E3366199C8 for ; Tue, 5 Dec 2017 10:39:44 +0100 (CET) Received: by mail-lf0-f67.google.com with SMTP id e137so22506783lfg.5 for ; Tue, 05 Dec 2017 01:39:44 -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=BrL6ZDmL4hxI1JfZvypa+v1CuVdP3yLC/QWFLO/9s4w=; b=CXsO+Uv9DeKiFViT+i+FcRvybOaNJw6BTsdPitNfdWCjJp7DeOzzUDr+yynv2Hrv1G /4QjuodLbeNzRIWObuoYI4Z0f7OtqpERMx5TD55EDi1UMG2JT1ti/evvfr30Osys2R7z vn9vXK45hmQbgUfxo8A9h1tSO9d59idQfoqCxbShO+f6suHSK8B1B8D3+YDzqCzzrKvj l2w8kQ5UZm7543+smOQfHccuo0kzp2t02uG0mLkGeo46VJV1IRH8OkZWoRHHT0otq/jB Bhots3McBS2F0jODzBzD2ZTJTcyjIfs7sRxewK8QeNZTvmqZ7+TfPzfz+0AQ/9+6khsl 96tQ== 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=BrL6ZDmL4hxI1JfZvypa+v1CuVdP3yLC/QWFLO/9s4w=; b=QtszkxC7p2E/hP3Tg686O1pSTfO/Lg8V2UjXrgNng4YniT0T16UyvwaR38W1yh7V0/ mqaLW1/E41Lix78fiJUA1jwh7tol2kOGcGm3VZgh/CQi9qizHdkPwQYDzHmGMwADh42i HvDwRi+e4SRJmjgCI7VSrEVP+PUJj40YO8ZMEt53o5eibhMqqhMG8LRjOqQKGGF3Er60 rOt5Ki/TdESdxoGdZu4IFG4bIIDmSKfvC1nsRP4hRhv8xItWVRa1KnhMsW6UzfYQAchK LP9BXq+NzNzk7FKMdRr/fFb4TTEKx5EwdL0blnNPtBkrVt98FaQTPTrcnjE+KkhvJqNz nIuQ== X-Gm-Message-State: AJaThX4m58uVz7S1uwCB+bns9M1yQH5Z3ARHHsb0cSUvstle4MFKmjm2 uVo+vWGlVNzajZ2XKZc6UK7FCFSKE9o= X-Google-Smtp-Source: AGs4zMY6nMS8SQk1/iGNoUozID+8+PsOoqHMKDzggmEED2UeHIZnzwsBKltCLxPBr7F682mXnxrz8w== X-Received: by 10.25.83.140 with SMTP id h12mr9996040lfl.129.1512466784200; Tue, 05 Dec 2017 01:39:44 -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 p5sm3334975ljc.7.2017.12.05.01.39.42 (version=TLS1_2 cipher=ECDHE-RSA-AES128-SHA bits=128/128); Tue, 05 Dec 2017 01:39:43 -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: Tue, 5 Dec 2017 10:39:22 +0100 Message-Id: <1512466762-1982-8-git-send-email-tdu@semihalf.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1512466762-1982-1-git-send-email-tdu@semihalf.com> References: <1512141592-16695-1-git-send-email-tdu@semihalf.com> <1512466762-1982-1-git-send-email-tdu@semihalf.com> Subject: [dpdk-dev] [PATCH v3 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 Acked-by: Jianbo Liu --- doc/guides/nics/mrvl.rst | 69 +++++++++++++++++++++++++++++++----------------- 1 file changed, 45 insertions(+), 24 deletions(-) -- 2.7.4 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: