From patchwork Fri Sep 7 07:25:19 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Hemant Agrawal X-Patchwork-Id: 146179 Delivered-To: patch@linaro.org Received: by 2002:a2e:1648:0:0:0:0:0 with SMTP id 8-v6csp838390ljw; Fri, 7 Sep 2018 00:27:19 -0700 (PDT) X-Google-Smtp-Source: ANB0VdZXw4Qgko1P9FGGK82YLUr+WK8pII1ix7cOhNIUmCNMZj38wzzskGk2WvZBQ4DnDyfe4NiC X-Received: by 2002:a1c:5e08:: with SMTP id s8-v6mr4621196wmb.88.1536305239145; Fri, 07 Sep 2018 00:27:19 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1536305239; cv=none; d=google.com; s=arc-20160816; b=jasZRMK8ccC52/fBUzRj1NanEnWvetYEOoqGQJS+RB0pJJ4Ow2xdGnmaUDm+cPlW9q OHWZQWUhtPj7gVjz2w2C1qhAMQ8z9WED4GvFgbibYwr7LMvJQ5onGkXPuSAEaQ+RYMj3 bBHuDZm4somsSoqdJSE3ZxcdcRi/JLvfDVWK6zBVklvOfK5DhEtMS2XKVKNLl9xevVId sTzVsHdUeWRQ0ISpAtoR0v7BdSM7gyojy2+d1tvg5zJZnanNX8KBQkW/HwFzeDo2xYGZ CBXZqPuUjtoilvf2rWPKwmEXlFCYmO+qBAznqGXe7z3t2LK8H8hzaY1ZufED8HsT/Esq YwAg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject :content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:cc:to:from; bh=N8z9fmNfbI/k/ZRPcdRfqsfT4hc5/34XO5KmSjVr5lE=; b=bgGdTjrVwNo1bAcvB4Y24KHOl5VW7xFEMU7HrPcSa33D2Uo2NLHDfIqVg2s8sJh5nw maspGSsnMNd2O5R42t6Dh/1OgZJocrPZ6a0SjsbwGOTukZ83LDB74lw9CH6iugTX2dCx QIOkEZ6QKpOc5hdrz2aXH1XcfywCk2IinDA4YOvceR8cnlIKc7nSEZcJocSRJOHqpcb1 yD83cznradKmxFsnIXplmj+ClOILwZwhUq2qM3B9HcAL0catrvbTkb1pK9XfHJYEf8uL PtBWd7qJY0DiO7JnkUv08Fn7WXSHRmO0MUXHKimgfjsAo9riEiQnHgSYdwrnBvKE5A7O BhCw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id p65-v6si6647927wrc.368.2018.09.07.00.27.18; Fri, 07 Sep 2018 00:27:19 -0700 (PDT) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id C3AF3325F; Fri, 7 Sep 2018 09:27:17 +0200 (CEST) Received: from inva021.nxp.com (inva021.nxp.com [92.121.34.21]) by dpdk.org (Postfix) with ESMTP id 75BD83256 for ; Fri, 7 Sep 2018 09:27:16 +0200 (CEST) Received: from inva021.nxp.com (localhost [127.0.0.1]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id 00F50200289; Fri, 7 Sep 2018 09:27:16 +0200 (CEST) Received: from invc005.ap-rdc01.nxp.com (invc005.ap-rdc01.nxp.com [165.114.16.14]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id 5612B200146; Fri, 7 Sep 2018 09:27:14 +0200 (CEST) Received: from bf-netperf1.ap.freescale.net (bf-netperf1.ap.freescale.net [10.232.134.28]) by invc005.ap-rdc01.nxp.com (Postfix) with ESMTP id 25BE8402DD; Fri, 7 Sep 2018 15:27:12 +0800 (SGT) From: Hemant Agrawal To: dev@dpdk.org Cc: john.mcnamara@intel.com Date: Fri, 7 Sep 2018 12:55:19 +0530 Message-Id: <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1535614772-20886-1-git-send-email-hemant.agrawal@nxp.com> References: <1535614772-20886-1-git-send-email-hemant.agrawal@nxp.com> MIME-Version: 1.0 X-Virus-Scanned: ClamAV using ClamSMTP Subject: [dpdk-dev] [PATCH v2 1/4] doc: create a platorm specific page for NXP DPAA platform 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" Signed-off-by: Hemant Agrawal --- doc/guides/platform/dpaa.rst | 100 ++++++++++++++++++++++++++++++++++++++++++ doc/guides/platform/index.rst | 1 + 2 files changed, 101 insertions(+) create mode 100644 doc/guides/platform/dpaa.rst -- 2.7.4 diff --git a/doc/guides/platform/dpaa.rst b/doc/guides/platform/dpaa.rst new file mode 100644 index 0000000..c065df0 --- /dev/null +++ b/doc/guides/platform/dpaa.rst @@ -0,0 +1,100 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright 2018 NXP + +NXP QorIQ DPAA Board Support Package +==================================== + +This doc has information about steps to setup QorIq dpaa +based layerscape platform and information about common offload +hw block drivers of **NXP QorIQ DPAA** SoC family. + +Supported DPAA SoCs +-------------------- + +* LS1046A/LS1026A +* LS1043A/LS1023A + +More information about SoC can be found at `NXP Official Website +`_. + + +Common Offload HW Block Drivers +------------------------------- + +1. **Nics Driver** + See :doc:`../nics/dpaa` for NXP dpaa nic driver information. + +2. **Cryptodev Driver** + See :doc:`../cryptodevs/dpaa_sec` for NXP dpaa cryptodev driver information. + +3. **Eventdev Driver** + See :doc:`../eventdevs/dpaa` for NXP dpaa eventdev driver information. + + +Steps To Setup Platform +----------------------- + +There are four main pre-requisities for executing DPAA PMD on a DPAA +compatible board: + +1. **ARM 64 Tool Chain** + + For example, the `*aarch64* Linaro Toolchain `_. + +2. **Linux Kernel** + + It can be obtained from `NXP's Github hosting `_. + +3. **Rootfile system** + + Any *aarch64* supporting filesystem can be used. For example, + Ubuntu 16.04 LTS (Xenial) or 18.04 (Bionic) userland which can be obtained + from `here + `_. + +4. **FMC Tool** + + Before any DPDK application can be executed, the Frame Manager Configuration + Tool (FMC) need to be executed to set the configurations of the queues. This + includes the queue state, RSS and other policies. + This tool can be obtained from `NXP (Freescale) Public Git Repository `_. + + This tool needs configuration files which are available in the + :ref:`DPDK Extra Scripts `, described below for DPDK usages. + +As an alternative method, DPAA PMD can also be executed using images provided +as part of SDK from NXP. The SDK includes all the above prerequisites necessary +to bring up a DPAA board. + +The following dependencies are not part of DPDK and must be installed +separately: + +- **NXP Linux SDK** + + NXP Linux software development kit (SDK) includes support for family + of QorIQ® ARM-Architecture-based system on chip (SoC) processors + and corresponding boards. + + It includes the Linux board support packages (BSPs) for NXP SoCs, + a fully operational tool chain, kernel and board specific modules. + + SDK and related information can be obtained from: `NXP QorIQ SDK `_. + + +.. _extra_scripts: + +- **DPDK Extra Scripts** + + DPAA based resources can be configured easily with the help of ready scripts + as provided in the DPDK Extra repository. + + `DPDK Extras Scripts `_. + +Currently supported by DPDK: + +- NXP SDK **2.0+** (preferred: LSDK 18.09). +- Supported architectures: **arm64 LE**. + +- Follow the DPDK :ref:`Getting Started Guide for Linux ` + to setup the basic DPDK environment. diff --git a/doc/guides/platform/index.rst b/doc/guides/platform/index.rst index ca6113d..fc7c6d4 100644 --- a/doc/guides/platform/index.rst +++ b/doc/guides/platform/index.rst @@ -10,4 +10,5 @@ The following are platform specific guides and setup information. :maxdepth: 2 :numbered: + dpaa octeontx From patchwork Fri Sep 7 07:25:20 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Hemant Agrawal X-Patchwork-Id: 146180 Delivered-To: patch@linaro.org Received: by 2002:a2e:1648:0:0:0:0:0 with SMTP id 8-v6csp838459ljw; Fri, 7 Sep 2018 00:27:26 -0700 (PDT) X-Google-Smtp-Source: ANB0VdbD9lCVhAfgx8tlw7jXz4GEKhz/LDrCgQkxs0MFHyeuYgqeuQw9Dh4qG2C4FZL+IbNnpIsp X-Received: by 2002:a1c:8dd1:: with SMTP id p200-v6mr3960029wmd.145.1536305246308; Fri, 07 Sep 2018 00:27:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1536305246; cv=none; d=google.com; s=arc-20160816; b=cVchRxhVVuCMDRZyhJuPcCpdVwB9yIyn/PlmjxFAPRJEZxNJsHcYP8n7C6tDQSXRsH lhaF8YtXBN37MztU2kHwwao8jbru8mWdHp1ig4AM6f2dmqpCph0BAjvjv8hxXYWnLHM5 kQbL9xTK4J8DuINVgKi60k96UAwEyc9Uo5a6YXlB80xC8Yrbxm+BUra90imFK5t2cEAg tdCtWVLnp7alvNb4v4e2RqasEP388L4NJDMCFCG2pYwpbLzmsV2z9Lrzw6ttNAW4sIDa p6FVcn0BmHRBMzxkWyn0yYHygu2VK11++6K9a/4Ja/KRsN0GlIEa//k6nEYoIxQ9o6E5 6gPg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject :content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:cc:to:from; bh=VGTMMSKX+Jahxev+KwjeOH1huNq4dObPMFxpQnfthg8=; b=IiVmrV8QW6RLD763aylHa0h3oOryirhJcprssiNLc/g6EyQyux6f2nv4ZOg2yHdoIi Z+NnEPjUWlJDOIPtKQ3HKYOAeLDwwy659zD7M98Lf9Jgqn8pjfp0qobYrt7wNrNmG9kH GaICD0MpuQcmGEq80z/Onk6HXA1VrMykonH8EOuuKxxJTGS7IINvA0CwTO1LGBPg9Gj5 6dWNs61LHnQMeqfLFFBJOqoOuXkIBREBoRPfYgr33YzAirFgXKJIzxWX4m0imW2Przh/ dp04hVSPkhznjofpW8n/MJNqULQ1/sbluhPzGkLxTRhuyET4AA9ElBLElV1Pwa+MZ/x4 N5Jw== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id 19-v6si6025188wrb.170.2018.09.07.00.27.26; Fri, 07 Sep 2018 00:27:26 -0700 (PDT) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 17EE04C9D; Fri, 7 Sep 2018 09:27:20 +0200 (CEST) Received: from inva021.nxp.com (inva021.nxp.com [92.121.34.21]) by dpdk.org (Postfix) with ESMTP id BF38A3256 for ; Fri, 7 Sep 2018 09:27:16 +0200 (CEST) Received: from inva021.nxp.com (localhost [127.0.0.1]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id 7CDED200034; Fri, 7 Sep 2018 09:27:16 +0200 (CEST) Received: from invc005.ap-rdc01.nxp.com (invc005.ap-rdc01.nxp.com [165.114.16.14]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id DBD00200011; Fri, 7 Sep 2018 09:27:14 +0200 (CEST) Received: from bf-netperf1.ap.freescale.net (bf-netperf1.ap.freescale.net [10.232.134.28]) by invc005.ap-rdc01.nxp.com (Postfix) with ESMTP id ABEE0402E5; Fri, 7 Sep 2018 15:27:12 +0800 (SGT) From: Hemant Agrawal To: dev@dpdk.org Cc: john.mcnamara@intel.com Date: Fri, 7 Sep 2018 12:55:20 +0530 Message-Id: <1536305122-23322-2-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> References: <1535614772-20886-1-git-send-email-hemant.agrawal@nxp.com> <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> MIME-Version: 1.0 X-Virus-Scanned: ClamAV using ClamSMTP Subject: [dpdk-dev] [PATCH v2 2/4] doc: remove redundant prerequisite info for dpaa devices 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" Signed-off-by: Hemant Agrawal --- doc/guides/cryptodevs/dpaa_sec.rst | 25 ++-------------- doc/guides/eventdevs/dpaa.rst | 48 +++---------------------------- doc/guides/nics/dpaa.rst | 59 +------------------------------------- 3 files changed, 7 insertions(+), 125 deletions(-) -- 2.7.4 diff --git a/doc/guides/cryptodevs/dpaa_sec.rst b/doc/guides/cryptodevs/dpaa_sec.rst index dd68389..897a4fe 100644 --- a/doc/guides/cryptodevs/dpaa_sec.rst +++ b/doc/guides/cryptodevs/dpaa_sec.rst @@ -101,32 +101,11 @@ Prerequisites ------------- DPAA_SEC driver has similar pre-requisites as described in :ref:`dpaa_overview`. -The following dependencies are not part of DPDK and must be installed separately: -* **NXP Linux SDK** +See :doc:`../platform/dpaa` for setup information - NXP Linux software development kit (SDK) includes support for the family - of QorIQ® ARM-Architecture-based system on chip (SoC) processors - and corresponding boards. - It includes the Linux board support packages (BSPs) for NXP SoCs, - a fully operational tool chain, kernel and board specific modules. - - SDK and related information can be obtained from: `NXP QorIQ SDK `_. - -* **DPDK Extras Scripts** - - DPAA based resources can be configured easily with the help of ready scripts - as provided in the DPDK Extras repository. - - `DPDK Extras Scripts `_. - -Currently supported by DPDK: - -* NXP SDK **2.0+**. -* Supported architectures: **arm64 LE**. - -* Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. +- Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. Pre-Installation Configuration ------------------------------ diff --git a/doc/guides/eventdevs/dpaa.rst b/doc/guides/eventdevs/dpaa.rst index 7383295..3af2343 100644 --- a/doc/guides/eventdevs/dpaa.rst +++ b/doc/guides/eventdevs/dpaa.rst @@ -25,57 +25,17 @@ The DPAA EVENTDEV implements many features in the eventdev API; Supported DPAA SoCs -------------------- -- LS1046A -- LS1043A +- LS1046A/LS1026A +- LS1043A/LS1023A Prerequisites ------------- -There are following pre-requisites for executing EVENTDEV on a DPAA compatible -platform: - -1. **ARM 64 Tool Chain** - - For example, the `*aarch64* Linaro Toolchain `_. - -2. **Linux Kernel** - - It can be obtained from `NXP's Github hosting `_. - -3. **Rootfile System** - - Any *aarch64* supporting filesystem can be used. For example, - Ubuntu 15.10 (Wily) or 16.04 LTS (Xenial) userland which can be obtained - from `here `_. - -As an alternative method, DPAA EVENTDEV can also be executed using images provided -as part of SDK from NXP. The SDK includes all the above prerequisites necessary -to bring up a DPAA board. - -The following dependencies are not part of DPDK and must be installed -separately: - -- **NXP Linux SDK** - - NXP Linux software development kit (SDK) includes support for family - of QorIQ® ARM-Architecture-based system on chip (SoC) processors - and corresponding boards. - - It includes the Linux board support packages (BSPs) for NXP SoCs, - a fully operational tool chain, kernel and board specific modules. - - SDK and related information can be obtained from: `NXP QorIQ SDK `_. - -- **DPDK Extra Scripts** - - DPAA based resources can be configured easily with the help of ready to use - xml files as provided in the DPDK Extra repository. - - `DPDK Extras Scripts `_. +See :doc:`../platform/dpaa` for setup information Currently supported by DPDK: -- NXP SDK **2.0+** or LSDK **17.09+** +- NXP SDK **2.0+** or LSDK **18.09+** - Supported architectures: **arm64 LE**. - Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. diff --git a/doc/guides/nics/dpaa.rst b/doc/guides/nics/dpaa.rst index 620c045..2173673 100644 --- a/doc/guides/nics/dpaa.rst +++ b/doc/guides/nics/dpaa.rst @@ -181,65 +181,8 @@ Supported DPAA SoCs Prerequisites ------------- -There are three main pre-requisities for executing DPAA PMD on a DPAA -compatible board: +See :doc:`../platform/dpaa` for setup information -1. **ARM 64 Tool Chain** - - For example, the `*aarch64* Linaro Toolchain `_. - -2. **Linux Kernel** - - It can be obtained from `NXP's Github hosting `_. - -3. **Rootfile system** - - Any *aarch64* supporting filesystem can be used. For example, - Ubuntu 15.10 (Wily) or 16.04 LTS (Xenial) userland which can be obtained - from `here `_. - -4. **FMC Tool** - - Before any DPDK application can be executed, the Frame Manager Configuration - Tool (FMC) need to be executed to set the configurations of the queues. This - includes the queue state, RSS and other policies. - This tool can be obtained from `NXP (Freescale) Public Git Repository `_. - - This tool needs configuration files which are available in the - :ref:`DPDK Extra Scripts `, described below for DPDK usages. - -As an alternative method, DPAA PMD can also be executed using images provided -as part of SDK from NXP. The SDK includes all the above prerequisites necessary -to bring up a DPAA board. - -The following dependencies are not part of DPDK and must be installed -separately: - -- **NXP Linux SDK** - - NXP Linux software development kit (SDK) includes support for family - of QorIQ® ARM-Architecture-based system on chip (SoC) processors - and corresponding boards. - - It includes the Linux board support packages (BSPs) for NXP SoCs, - a fully operational tool chain, kernel and board specific modules. - - SDK and related information can be obtained from: `NXP QorIQ SDK `_. - - -.. _extra_scripts: - -- **DPDK Extra Scripts** - - DPAA based resources can be configured easily with the help of ready scripts - as provided in the DPDK Extra repository. - - `DPDK Extras Scripts `_. - -Currently supported by DPDK: - -- NXP SDK **2.0+**. -- Supported architectures: **arm64 LE**. - Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. From patchwork Fri Sep 7 07:25:21 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Hemant Agrawal X-Patchwork-Id: 146181 Delivered-To: patch@linaro.org Received: by 2002:a2e:1648:0:0:0:0:0 with SMTP id 8-v6csp838545ljw; Fri, 7 Sep 2018 00:27:34 -0700 (PDT) X-Google-Smtp-Source: ANB0VdajOSkfwASTMO4s5mtSpdbUGxUWti1w88FRGF2nMN26odoSqJZuNiLsiSsz9i0Takfs/RhI X-Received: by 2002:adf:9503:: with SMTP id 3-v6mr4882497wrs.251.1536305253911; Fri, 07 Sep 2018 00:27:33 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1536305253; cv=none; d=google.com; s=arc-20160816; b=eZ1x8Ot+ap+RMDYkohPNeQMccCdywAuxtH1i+XmUGLIoedQzynTgjfUGMboZRRwCxc q+xxM9xa3sAb7A9pI8RvJyswZiyoV02BxQ4gDCT1Td2bxavY572pigB0ukekjxS8wHyd Gtrs150lA83SPlLyji1gkNtVCnyGg43cJ4tRjJqR3ksmmRTYXkSg6jfXal0PTH3+YCEI Wbwcun8eaFwizdPaQtXRxMrICVL9RCoVcr60Ki5Eww7lSp6stsjMiSLxa4seklnB9HSV acN6IbwWEfVJmZOvjTCmNq6cJhYIxY5JuTuorLml1jXPScXyuBJZ0yBdqe+0IIxfVFUU Pltg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject :content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:cc:to:from; bh=T66fV0fdY9kQ7Z0IotwFjokDZXjxUxFbpA1ExoOjAmw=; b=XpN88uZMW4YtcBnnQ0HQL8X4rsAUtEes5o43RiTpnJHNeH2pN7Ig6Zvx2l24lQUc48 bH0qzJJSumLVWZMe9R1Loz8KIwX4HcnLyaqLtPB8Fy6e/LheX8mesfJJ6cjmBRWBwojs uCgmCRsTIr3A1uuiJoPZQFqfsg8ysjZuxbBHuvW9CBkvfmBFr90jK4VOegm9tFZ0HjUN 9L1uOXwn9HEXe4rcJx37+zPbwiCRMzSU6XgAoKTCBLkis9CSDVyZrdZkadPHiDl9tWGn 7sFmVe/oiw1oEhX8JA6z/btysdOZ8HKvCFeNjIYZeDXOk4GD4+rRwnanBdt4Iyxi7dd/ 34oA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id v6-v6si7377305wra.377.2018.09.07.00.27.33; Fri, 07 Sep 2018 00:27:33 -0700 (PDT) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 97D8B4CBD; Fri, 7 Sep 2018 09:27:21 +0200 (CEST) Received: from inva021.nxp.com (inva021.nxp.com [92.121.34.21]) by dpdk.org (Postfix) with ESMTP id 32DFF3256 for ; Fri, 7 Sep 2018 09:27:17 +0200 (CEST) Received: from inva021.nxp.com (localhost [127.0.0.1]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id 1101F200011; Fri, 7 Sep 2018 09:27:17 +0200 (CEST) Received: from invc005.ap-rdc01.nxp.com (invc005.ap-rdc01.nxp.com [165.114.16.14]) by inva021.eu-rdc02.nxp.com (Postfix) with ESMTP id 6698520009E; Fri, 7 Sep 2018 09:27:15 +0200 (CEST) Received: from bf-netperf1.ap.freescale.net (bf-netperf1.ap.freescale.net [10.232.134.28]) by invc005.ap-rdc01.nxp.com (Postfix) with ESMTP id 37B194030E; Fri, 7 Sep 2018 15:27:13 +0800 (SGT) From: Hemant Agrawal To: dev@dpdk.org Cc: john.mcnamara@intel.com Date: Fri, 7 Sep 2018 12:55:21 +0530 Message-Id: <1536305122-23322-3-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> References: <1535614772-20886-1-git-send-email-hemant.agrawal@nxp.com> <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> MIME-Version: 1.0 X-Virus-Scanned: ClamAV using ClamSMTP Subject: [dpdk-dev] [PATCH v2 3/4] doc: create a platorm specific page for NXP DPAA2 platform 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" Signed-off-by: Hemant Agrawal --- doc/guides/platform/dpaa2.rst | 98 +++++++++++++++++++++++++++++++++++++++++++ doc/guides/platform/index.rst | 1 + 2 files changed, 99 insertions(+) create mode 100644 doc/guides/platform/dpaa2.rst -- 2.7.4 diff --git a/doc/guides/platform/dpaa2.rst b/doc/guides/platform/dpaa2.rst new file mode 100644 index 0000000..e9f4399 --- /dev/null +++ b/doc/guides/platform/dpaa2.rst @@ -0,0 +1,98 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright 2018 NXP + +NXP QorIQ DPAA2 Board Support Package +===================================== + +This doc has information about steps to setup NXP QoriQ DPAA2 platform +and information about common offload hw block drivers of +**NXP QorIQ DPAA2** SoC family. + +Supported DPAA2 SoCs +-------------------- + +- LX2160A +- LS2084A/LS2044A +- LS2088A/LS2048A +- LS1088A/LS1048A + +More information about SoC can be found at `NXP Official Website +`_. + + +Common Offload HW Block Drivers +------------------------------- + +1. **Nics Driver** + See :doc:`../nics/dpaa2` for NXP dpaa2 nic driver information. + +2. **Cryptodev Driver** + See :doc:`../cryptodevs/dpaa2_sec` for NXP dpaa2 cryptodev driver information. + +3. **Eventdev Driver** + See :doc:`../eventdevs/dpaa2` for NXP dpaa2 eventdev driver information. + + +Steps To Setup Platform +----------------------- + +There are four main pre-requisities for executing DPAA2 PMD on a DPAA2 +compatible board: + +1. **ARM 64 Tool Chain** + + For example, the `*aarch64* Linaro Toolchain `_. + +2. **Linux Kernel** + + It can be obtained from `NXP's Github hosting `_. + +3. **Rootfile system** + + Any *aarch64* supporting filesystem can be used. For example, + Ubuntu 16.04 LTS (Xenial) or 18.04 (Bionic) userland which can be obtained + from `here + `_. + +4. **Resource Scripts** + + DPAA2 based resources can be configured easily with the help of ready scripts + as provided in the DPDK Extra repository. + +As an alternative method, DPAA2 PMD can also be executed using images provided +as part of SDK from NXP. The SDK includes all the above prerequisites necessary +to bring up a DPAA2 board. + +The following dependencies are not part of DPDK and must be installed +separately: + +- **NXP Linux SDK** + + NXP Linux software development kit (SDK) includes support for family + of QorIQ® ARM-Architecture-based system on chip (SoC) processors + and corresponding boards. + + It includes the Linux board support packages (BSPs) for NXP SoCs, + a fully operational tool chain, kernel and board specific modules. + + SDK and related information can be obtained from: `NXP QorIQ SDK `_. + + +.. _extra_scripts: + +- **DPDK Extra Scripts** + + DPAA2 based resources can be configured easily with the help of ready scripts + as provided in the DPDK Extra repository. + + `DPDK Extras Scripts `_. + +Currently supported by DPDK: + +- NXP SDK **2.0+** (preferred: LSDK 18.09). +- MC Firmware version **10.10.0** and higher. +- Supported architectures: **arm64 LE**. + +- Follow the DPDK :ref:`Getting Started Guide for Linux ` + to setup the basic DPDK environment. diff --git a/doc/guides/platform/index.rst b/doc/guides/platform/index.rst index fc7c6d4..98c6638 100644 --- a/doc/guides/platform/index.rst +++ b/doc/guides/platform/index.rst @@ -11,4 +11,5 @@ The following are platform specific guides and setup information. :numbered: dpaa + dpaa2 octeontx From patchwork Fri Sep 7 07:25:22 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Hemant Agrawal X-Patchwork-Id: 146182 Delivered-To: patch@linaro.org Received: by 2002:a2e:1648:0:0:0:0:0 with SMTP id 8-v6csp838677ljw; Fri, 7 Sep 2018 00:27:43 -0700 (PDT) X-Google-Smtp-Source: ANB0VdbJpHUMPSlA0YUOFeKQB+QBqdrKoT/eO8FzteFL8vj1foQd62RuwtDvsQ1zxzGe2X2IPAvm X-Received: by 2002:adf:9d81:: with SMTP id p1-v6mr4885664wre.12.1536305263617; Fri, 07 Sep 2018 00:27:43 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1536305263; cv=none; d=google.com; s=arc-20160816; b=eU5l1DonGJS1EQB2DNHemxheMzDJO2xPB3FIopjPI5sEbBvA9OOAn1XlOzv8JBkyMW G+fbkna2n/RgjLkpdgrW1wRyKIF9xQUZ/V4YkAdMB/3VsbTyPDsxwdvjdwMnNzVjHRE0 Ohi5KqnIy7KoQnphPIYcYn5YpSUKU8hJZvPrsRELJnR9JXjwEFP3FfW4DHEcmcnC0quk jcZ+2odwfqrDXEY7sdpH/z+23VuPLpd2tO8q/yGDjnldigarfwCefXbef/RFKxbmIz7L osDnkZAritpQszY1IWkeuqrhrGIp32LxeQJkOXa+GvEnuDyRfWEG8kGRB+DXWZtHeRLA lg4w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject :content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:cc:to:from; bh=RJ2ZlOeT76h4hpYXVruG3JytEymjri3f5d6ya9zAihk=; b=bwwU+LGu1th+9Q9ed8TYWnW5jHsk+vytzKB1/mdnQv/qtGy+wpxk55+iQE3YJMVWd3 teaLkumHlzBlKvjaxwtEvY91VC/Oc+SrnHO28B36jAA/DRXLmXsSF810W1ReQ3R+tFPj 4+YO19x0LAkLe05dWVuVF7MEjwgK1LI3BBXJAFfLYApSpwGuKLUCARGGhwrtbEy0udeI 3/qipcDxqlp0PBYmK+GQll6a1x/VuQ1enGMBDn7x9Dk6ocQkH5x9wqe50/zrG/GFaG6x JYIuh6M1faUqnPsMFA8KbE6HUmVRrS/Hxo679sGwfq+GLNiVi6FZuK3LAQZcy2LQqHCf MCrA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Return-Path: Received: from dpdk.org (dpdk.org. [92.243.14.124]) by mx.google.com with ESMTP id r7-v6si5902595wmr.164.2018.09.07.00.27.43; Fri, 07 Sep 2018 00:27:43 -0700 (PDT) Received-SPF: pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) client-ip=92.243.14.124; Authentication-Results: mx.google.com; spf=pass (google.com: domain of dev-bounces@dpdk.org designates 92.243.14.124 as permitted sender) smtp.mailfrom=dev-bounces@dpdk.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=nxp.com Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 387834F9B; Fri, 7 Sep 2018 09:27:23 +0200 (CEST) Received: from inva020.nxp.com (inva020.nxp.com [92.121.34.13]) by dpdk.org (Postfix) with ESMTP id EFF754C8B for ; Fri, 7 Sep 2018 09:27:17 +0200 (CEST) Received: from inva020.nxp.com (localhost [127.0.0.1]) by inva020.eu-rdc02.nxp.com (Postfix) with ESMTP id 889A71A00E8; Fri, 7 Sep 2018 09:27:17 +0200 (CEST) Received: from invc005.ap-rdc01.nxp.com (invc005.ap-rdc01.nxp.com [165.114.16.14]) by inva020.eu-rdc02.nxp.com (Postfix) with ESMTP id E826D1A0060; Fri, 7 Sep 2018 09:27:15 +0200 (CEST) Received: from bf-netperf1.ap.freescale.net (bf-netperf1.ap.freescale.net [10.232.134.28]) by invc005.ap-rdc01.nxp.com (Postfix) with ESMTP id BA9EA4030F; Fri, 7 Sep 2018 15:27:13 +0800 (SGT) From: Hemant Agrawal To: dev@dpdk.org Cc: john.mcnamara@intel.com Date: Fri, 7 Sep 2018 12:55:22 +0530 Message-Id: <1536305122-23322-4-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 In-Reply-To: <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> References: <1535614772-20886-1-git-send-email-hemant.agrawal@nxp.com> <1536305122-23322-1-git-send-email-hemant.agrawal@nxp.com> MIME-Version: 1.0 X-Virus-Scanned: ClamAV using ClamSMTP Subject: [dpdk-dev] [PATCH v2 4/4] doc: remove redundant prerequisite info for dpaa2 devices 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" Signed-off-by: Hemant Agrawal --- doc/guides/cryptodevs/dpaa2_sec.rst | 28 +++++---------------- doc/guides/eventdevs/dpaa2.rst | 50 ++++--------------------------------- doc/guides/nics/dpaa2.rst | 49 +++--------------------------------- 3 files changed, 15 insertions(+), 112 deletions(-) -- 2.7.4 diff --git a/doc/guides/cryptodevs/dpaa2_sec.rst b/doc/guides/cryptodevs/dpaa2_sec.rst index 9191704..aee79ab 100644 --- a/doc/guides/cryptodevs/dpaa2_sec.rst +++ b/doc/guides/cryptodevs/dpaa2_sec.rst @@ -129,7 +129,7 @@ AEAD algorithms: Supported DPAA2 SoCs -------------------- -* LS2080A/LS2040A +* LS2160A * LS2084A/LS2044A * LS2088A/LS2048A * LS1088A/LS1048A @@ -157,31 +157,15 @@ Prerequisites DPAA2_SEC driver has similar pre-requisites as described in :ref:`dpaa2_overview`. The following dependencies are not part of DPDK and must be installed separately: -* **NXP Linux SDK** - - NXP Linux software development kit (SDK) includes support for the family - of QorIQ® ARM-Architecture-based system on chip (SoC) processors - and corresponding boards. - - It includes the Linux board support packages (BSPs) for NXP SoCs, - a fully operational tool chain, kernel and board specific modules. - - SDK and related information can be obtained from: `NXP QorIQ SDK `_. - -* **DPDK Extra Scripts** - - DPAA2 based resources can be configured easily with the help of ready scripts - as provided in the DPDK helper repository. - - `DPDK Extra Scripts `_. +See :doc:`../platform/dpaa2` for setup information Currently supported by DPDK: -* NXP SDK **17.08+**. -* MC Firmware version **10.3.1** and higher. -* Supported architectures: **arm64 LE**. +- NXP SDK **18.09+**. +- MC Firmware version **10.10.0** and higher. +- Supported architectures: **arm64 LE**. -* Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. +- Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. Pre-Installation Configuration ------------------------------ diff --git a/doc/guides/eventdevs/dpaa2.rst b/doc/guides/eventdevs/dpaa2.rst index ad94f24..2b1700a 100644 --- a/doc/guides/eventdevs/dpaa2.rst +++ b/doc/guides/eventdevs/dpaa2.rst @@ -26,7 +26,7 @@ The DPAA2 EVENTDEV implements many features in the eventdev API; Supported DPAA2 SoCs -------------------- -- LS2080A/LS2040A +- LX2160A - LS2084A/LS2044A - LS2088A/LS2048A - LS1088A/LS1048A @@ -34,52 +34,12 @@ Supported DPAA2 SoCs Prerequisites ------------- -There are three main pre-requisities for executing DPAA2 EVENTDEV on a DPAA2 -compatible board: - -1. **ARM 64 Tool Chain** - - For example, the `*aarch64* Linaro Toolchain `_. - -2. **Linux Kernel** - - It can be obtained from `NXP's Github hosting `_. - -3. **Rootfile system** - - Any *aarch64* supporting filesystem can be used. For example, - Ubuntu 15.10 (Wily) or 16.04 LTS (Xenial) userland which can be obtained - from `here `_. - -As an alternative method, DPAA2 EVENTDEV can also be executed using images provided -as part of SDK from NXP. The SDK includes all the above prerequisites necessary -to bring up a DPAA2 board. - -The following dependencies are not part of DPDK and must be installed -separately: - -- **NXP Linux SDK** - - NXP Linux software development kit (SDK) includes support for family - of QorIQ® ARM-Architecture-based system on chip (SoC) processors - and corresponding boards. - - It includes the Linux board support packages (BSPs) for NXP SoCs, - a fully operational tool chain, kernel and board specific modules. - - SDK and related information can be obtained from: `NXP QorIQ SDK `_. - -- **DPDK Extra Scripts** - - DPAA2 based resources can be configured easily with the help of ready scripts - as provided in the DPDK Extra repository. - - `DPDK Extras Scripts `_. +See :doc:`../platform/dpaa2` for setup information Currently supported by DPDK: -- NXP SDK **2.0+**. -- MC Firmware version **10.0.0** and higher. +- NXP SDK **18.09+**. +- MC Firmware version **10.10.0** and higher. - Supported architectures: **arm64 LE**. - Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment. @@ -155,4 +115,4 @@ DPAA2 drivers for DPDK can only work on NXP SoCs as listed in the Port-core binding ~~~~~~~~~~~~~~~~~ -DPAA2 EVENTDEV driver requires event port 'x' to be used on core 'x'. +DPAA2 EVENTDEV can support only one eventport per core. diff --git a/doc/guides/nics/dpaa2.rst b/doc/guides/nics/dpaa2.rst index 66c03e1..53fb767 100644 --- a/doc/guides/nics/dpaa2.rst +++ b/doc/guides/nics/dpaa2.rst @@ -409,8 +409,7 @@ Features of the DPAA2 PMD are: Supported DPAA2 SoCs -------------------- - -- LS2080A/LS2040A +- LX2160A - LS2084A/LS2044A - LS2088A/LS2048A - LS1088A/LS1048A @@ -418,52 +417,12 @@ Supported DPAA2 SoCs Prerequisites ------------- -There are three main pre-requisities for executing DPAA2 PMD on a DPAA2 -compatible board: - -1. **ARM 64 Tool Chain** - - For example, the `*aarch64* Linaro Toolchain `_. - -2. **Linux Kernel** - - It can be obtained from `NXP's Github hosting `_. - -3. **Rootfile system** - - Any *aarch64* supporting filesystem can be used. For example, - Ubuntu 15.10 (Wily) or 16.04 LTS (Xenial) userland which can be obtained - from `here `_. - -As an alternative method, DPAA2 PMD can also be executed using images provided -as part of SDK from NXP. The SDK includes all the above prerequisites necessary -to bring up a DPAA2 board. - -The following dependencies are not part of DPDK and must be installed -separately: - -- **NXP Linux SDK** - - NXP Linux software development kit (SDK) includes support for family - of QorIQ® ARM-Architecture-based system on chip (SoC) processors - and corresponding boards. - - It includes the Linux board support packages (BSPs) for NXP SoCs, - a fully operational tool chain, kernel and board specific modules. - - SDK and related information can be obtained from: `NXP QorIQ SDK `_. - -- **DPDK Extra Scripts** - - DPAA2 based resources can be configured easily with the help of ready scripts - as provided in the DPDK Extra repository. - - `DPDK Extras Scripts `_. +See :doc:`../platform/dpaa2` for setup information Currently supported by DPDK: -- NXP SDK **17.08+**. -- MC Firmware version **10.3.1** and higher. +- NXP SDK **18.09+**. +- MC Firmware version **10.10.0** and higher. - Supported architectures: **arm64 LE**. - Follow the DPDK :ref:`Getting Started Guide for Linux ` to setup the basic DPDK environment.