From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR02-HE1-obe.outbound.protection.outlook.com (mail-eopbgr10084.outbound.protection.outlook.com [40.107.1.84]) by dpdk.org (Postfix) with ESMTP id 0AAA42BF7 for ; Thu, 30 Aug 2018 09:41:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=1rKNqzLnwb4hvGG+g1q4C6xvg2mswLFUPLb0MaCCwhE=; b=XmaQSZ++85AvGEm+lV2L2HPH8YdXp8+nAsL0a4sFBY2e/yKU+Ff472lCffjiF1eWVUzjQjGgYX0B1ffbtTiP+MwGzVf9LtreVks7vizPSHxBmZySB8urghVSSlPIh5YkN5yTDgiSo6FvftpSqeGgWYovU0PfvCK6mWa1tdMzUcc= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=hemant.agrawal@nxp.com; Received: from bf-netperf1.ap.freescale.net (14.143.30.134) by VI1PR0401MB2544.eurprd04.prod.outlook.com (2603:10a6:800:56::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1080.17; Thu, 30 Aug 2018 07:41:38 +0000 From: Hemant Agrawal To: dev@dpdk.org Cc: shreyansh.jain@nxp.com Date: Thu, 30 Aug 2018 13:09:29 +0530 Message-Id: <1535614772-20886-1-git-send-email-hemant.agrawal@nxp.com> X-Mailer: git-send-email 2.7.4 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Originating-IP: [14.143.30.134] X-ClientProxiedBy: SG2PR04CA0157.apcprd04.prod.outlook.com (2603:1096:4::19) To VI1PR0401MB2544.eurprd04.prod.outlook.com (2603:10a6:800:56::22) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: aef1341c-0644-4844-720c-08d60e4c05bb X-MS-Office365-Filtering-HT: Tenant X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(8989137)(4534165)(7168020)(4627221)(201703031133081)(201702281549075)(8990107)(5600074)(711020)(4618075)(2017052603328)(7153060)(7193020); SRVR:VI1PR0401MB2544; X-Microsoft-Exchange-Diagnostics: 1; VI1PR0401MB2544; 3:KvGCgvVp7ASkVK2wla1EFu7q8WKoZ8eQoYymduAkAFR27Xf63l4HgU/sLrAMoeufDv6q3Tvtabrz06U7J0G/kZzNTnBW3vC9nBM1u7f/7+PnJ6BNrF85CW3/HhN1YQO1L/Pw+IwIwFD7znVVhIUDqYEp6zNKmVFahEFScSfpE5MFPRUikuiIRI6ChW34KyEQxTnezU0k/nyniyTNo8W/e/Wb1lQOEhQgNtlXHdgdNucgGlILegnLAG/yRDy4Ho+q; 25:BD41rmI9vnG9z7iFA7ANe2mDWXD7hTHhI37V3CLRbcb2xbTI87dMobx3+WLC/BgM4MMZkJQlOtSAHvREqRQZEFPPMhxsxWGEdF7cBlzEpCJeh5TU672rshXBPnySz3WhTDKBhD3GfmqckLvxOHHNtIIV52KrVdNQ44SSjNK0TjqDWP2kVv0deiptMRG+P2dI8YSQR+vUlurUVHEoRZsjB3ttKZlkHmZg6cr6j1BCb/N615PYb7CP8n3CSK3gepeLOaUWnjxANQm9ZS+1DREhlPr91hmkQgfzfQ+8S65UxCKIOLr2IT9mc6fu7UXXppn4ezUrpkGTrWfAaAxW4GzRng==; 31:DKW+Fi/z6ncX5K91fVygTilTWL94zMcvTYfm3f2ZmKmFKUlFiK9hxRDsF2ZjxuOT4LaUBoVclEX2YoESlEZohH9bcrpuUsZo3jRp+X9REL4RpYqYUZFz2uL590w2jgDerIPeCvUNNG+GKZEbK9SeOouePA9p3BVU3qFMyJz7T65vi+KCtHf4xw9efDUaxPL/+mDWwTqX+CcvgG8JvK3bU0miRl2yJKSe1S0GIBiE1lk= X-MS-TrafficTypeDiagnostic: VI1PR0401MB2544: X-Microsoft-Exchange-Diagnostics: 1; VI1PR0401MB2544; 20:1uJccF4jdPEUvKK8ppyALM95CJj9j3Hz8onSjdPohvIVKuupiIu0/+8VwKRQDjEQFYaB6/veRDsjsJVoRYZV70yIsyT4PdunIuK9T4x48el1RO8HRyvFk/iz55Ma8KTbVbB80h/HMoiJFmyHIUwxFjwxebKCEsSoKvCOCih0PnNygW7t2YM0iq1WKTjTOqD1KgRu2L6hCBI6zFFZdmT9qvdhFkvaOV28KRGmeqdZ7JU9xSf4caLvKzND8MPTZAf2/CTM87SWjQz+eW66lsZhBQQw5bVgO9y3QPJjiDw32bs5wSQ2ZmP6ymsWuquulh9MwbQZVujyMN3NMxhsF4da7k0YGe+uJqQ/CfdNPzq9v9RVQxqKDhn3q8aXJkOSd6QRgcc+j7hg0JjZgPgs0VHamfO4F5ru6XcvNqEdKYw1zIhuOqesI3efl12RIrNYznfVPfcs7FkVeRC+3C9hui+ZK+6q7l/GqTN9xinSZBOnOebI28126IsL/LmY1A4p0sAj; 4:zsZqe72PHyOsUVOQm1yjqznyWwj0P9k7inMEjcuzakMr0pdktDWqT004m76Cg8te/BixRlsMtrwPjkbLYhmmqaQ9Ev2nVgllhe06MyL6LAwvK1Gw/uNoSWnjiwK0pZRL2TFk2MZYpWmnEhnrz4ah7flbl7EQhKEYs+hriPBmisFN5HoJeQTxhlwXlE9cJO5qvnwyuI97nJNFFq6rrCbhRNw8S53JemC9RGnpawLZls7nb8m3QWlR/1PwQ42HCOwMo6POSQ3I8jayfxomTfCtBK+/8N8bdbm8IepexSSm+LQ+p8hyOlREaPNHSsNSWwg8f72s7Bg1Q+AFRQCmgGS7uVz/aPdigx7oFYxPr7CIpS4= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197)(264314650089876); X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(8211001083)(6040522)(2401047)(5005006)(8121501046)(823301075)(3231311)(944501410)(52105095)(3002001)(93006095)(93001095)(10201501046)(6055026)(149027)(150027)(6041310)(20161123562045)(20161123558120)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(20161123564045)(201708071742011)(7699016); SRVR:VI1PR0401MB2544; BCL:0; PCL:0; RULEID:; SRVR:VI1PR0401MB2544; X-Forefront-PRVS: 07807C55DC X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10009020)(376002)(366004)(39860400002)(346002)(396003)(136003)(199004)(189003)(4326008)(8936002)(5009440100003)(6916009)(186003)(2870700001)(305945005)(3846002)(16526019)(6666003)(478600001)(25786009)(7736002)(105586002)(2361001)(68736007)(47776003)(44832011)(50226002)(2351001)(106356001)(6116002)(66066001)(97736004)(23676004)(81156014)(36756003)(8676002)(6512007)(55236004)(81166006)(6506007)(6306002)(386003)(316002)(956004)(50466002)(26005)(5660300001)(2616005)(2906002)(6486002)(86362001)(53936002)(52116002)(476003)(486006)(217873002)(110426005); DIR:OUT; SFP:1101; SCL:1; SRVR:VI1PR0401MB2544; H:bf-netperf1.ap.freescale.net; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; Received-SPF: None (protection.outlook.com: nxp.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?utf-8?B?MTtWSTFQUjA0MDFNQjI1NDQ7MjM6Q3BZZjRkWExJa1htcHZrN0JxRko5a0Vs?= =?utf-8?B?TndMTE03UUpmMHo2UWtOYXlyRFlsVlNMNEY1TFdIQUFBaDhsUHEwV2RYaUxP?= =?utf-8?B?eWNxeFB3T1FEMkdjajZxdVo3bTY1SFhUblFnRUJrL1U4ZEFxcFU3RjMxMjdk?= =?utf-8?B?c1U2TGI4YlliRGU4WmRDSTZVWXF1ZXI2YTNyR3AzVjBlZjdZNlZzNlNMemw2?= =?utf-8?B?UnprQnBuREZPM1VXYVJ4MTFaTzF4YytBRW55Vkxxa1RFRllrOTBocXVCRGFv?= =?utf-8?B?V0xyNktieW8vYU9oeXB3ZnpHcyt4TWpBbkc5VWpFYUs5S3RPTkg1UHJPT1lJ?= =?utf-8?B?QWx5NkN3eDZmUDlGRGtzenpPR2tQc2R3SW9XZ2N6Rlg5blNyZjBxSk1GRHhP?= =?utf-8?B?UW1lZnkxWm81a2NVcDFTdW0zUDFBR3JJKzhwc3g3SUpCUnc2aXRMVEpzSm9F?= =?utf-8?B?WE54QUlBWHEwZTdVN2E1MWFlU25rVmRLWWpySkxvMmZaNTc3Vyt2eld5RE1L?= =?utf-8?B?ZUVGaTVTc0ZRQitlQTV1UjBPOGNiODZyQnIydHZqUFh3N2dKNU84UllYMXBa?= =?utf-8?B?dHRRc0VubjFjNzZTeGdaV21WRUh6UWhCWmFWRFI4NkpDUzhBNURLRStOR3Rk?= =?utf-8?B?Nks5OVJ4dVIwSW45RkRHeHRHLzIzNTE0VG1acTZJYWhjYWlsOTJYMzlPK1Yv?= =?utf-8?B?UVllRTRibERua3EvQzNuazVXdjB5VDl6Z3FoV2swMUdKMjJ0TTlvM2x1c2Ix?= =?utf-8?B?M2Y0c012L1hjOUJzRSs4bWJTZW1lZzJSMEtpekZ2UEFsSDk2UFFDYlp4cXlr?= =?utf-8?B?SnlsSmRMcy83dUsvVHl5VkNpWXpGZDMzYlo3bEFtdjdDVTVGL0hwQkFMNGJh?= =?utf-8?B?dEVUNUpWdEpjbGtMTkNINHNUOG01R2pJK0dia0NwRVNZRWV2Qjg0VlBoSkpu?= =?utf-8?B?S0VMMnR6aGNoYlJ6Tkw0V1lRcGVGNEVxOG1kSVpRT090THhTdUFxMjhBQW12?= =?utf-8?B?NzNIOFYrbEtCUVdqVC9PNUljSisyZTBmcHFydGZWNkVVWG5xUEJZcG9jZEx4?= =?utf-8?B?NG5oM0J2QUVZRS84Z2pqRWx0eWNrd3JPQU1oY3M4VkRhTzZaNjZTSHFTUERF?= =?utf-8?B?TVhONDNDeFdyV211bGVkWDd5SXJlUVp2L3BTU1hJYVg0QlBYRkJyR09VN3I3?= =?utf-8?B?M3g4Z01DV3V5cEtaejdHUFBMUjRseGh2czBSaFFnQ1c1UExtRGtSeVlmLzR6?= =?utf-8?B?eFg3U3Y2RERzRVJ3cktTRHBTK1AzQmg5RDArQVU0V3JjSnZ0YXN5RE91N0t2?= =?utf-8?B?QlZGOWpOQmkyK3Z3bHB2Mmd2MTMxUzJYZ1JZWGllTzY5enBydDd4dXdrVDhX?= =?utf-8?B?d2taaHA1bjFCMkNuRFRhZDRPcDhOVEhTdVFTbWRLcWFIMlE2RzRWWk5SeVdi?= =?utf-8?B?ZDRCNWZYQ3kzQXd1VkFKd2dUQjF6MG53TW1lMk1kbUUrZkhEVFM4Z0RPOStQ?= =?utf-8?B?alJFRDRDSWVXWkhLL2ZvbzNQZHhCWmlVeTg1MHdZN3hTN09ZaGJ5YlplSWd4?= =?utf-8?B?ZTBSWnJITHh3STlCNXJJRTB0cTBWdmdnb3NCcTNzbnA2M0FqL01xK2FpNVd1?= =?utf-8?B?eEdmYjZGVVhxMTRlTEdJdUg5NlRIMXZrdEphUitEbzM1clBvNGpYaGFFR2k5?= =?utf-8?Q?8FtiDR30h1y3HvMvIG7WYOQCD8DO2lRPMTL6DMpXx?= X-Microsoft-Antispam-Message-Info: LILc363WSVmmubo86oBFq3QXo0VHsRogfEN0l5VGJke4uflbert6YKm141zZVwMlXlJxnFYKlOFhGvAkA0htD7IdiWXgh+KXB6OayF15y2YFKkGIyQyS4GxtfFZikdkBhlqF6DR5wpeQxrgDQa+J3ZO0NeXAjK8s307fRcD+Yicm+y/oIOkQcsDCB4sjrh+CCdufZjncLLapBa4FFz2F3htC+EuoiomfsTmUXLnZ155cl/s03xCWr/eVMBCL2HkrXfOBrSUqZT8+a+P2F28FmFLGk80BhhVv40g3sIWrGkgbQz5dhtT4l933qmWfClc7manNrIh9SXgIwjn+LK794jSh5RPZUmM0hBlaQb/Xyxk= X-Microsoft-Exchange-Diagnostics: 1; VI1PR0401MB2544; 6:uzFBmN+YNQX0AgupnXOXBZ4xpYaXIFMQZMTfYaktVoEptPjh5KTXYQdP3+dzzjeKoRfa/lxFEQpbP1eGuuoLyzwW/NeE1xk/+9F+frW92tGeAtNN7S+Syl7OdSeVtjJv25YEpaFwyCR76xsUsI5eUkKEI3ON6w934BQNzUKMTP2iXOFhTU/AJUHavbbpED6zQv8c3T7Ze0TaHMshUH6fD+E1crt3v1X5XOsM6CEbBodb3e37Ku5eQjVBr0IVFLMNl8TTTf3xNLj8iZ7Eb9lShP1BgQECjcweBG9kSAJcrA+UeVi2FHvdKj3VLG4bS6MKdKnowna09mchpovMdFOoEr0nL4wEMUoYMCPKs3aFNOE7brPx8owJoI7N8gp9yEuSr/RZbzgNOL5zYyYZ3pcioSHEjODcf8D/O7wifzNrt3msam+IEltQ+2VbezcmMZRm/1WpXko8mVUtDAGS9zPgQg==; 5:/4Y0i8RL+wF7uI/2LiZMMsQ6f0MI0P+O1lBh+aoKGIO/Cm7Vz4SdyD/Gqm2t35JeHjmBky2rnBtSr61EUJCFIzryCPcMFlK0rsLtw0z72wSsO4JZG/u666htB9baBxeFkFfkbgUIP8SeoBeBHVomlRGYMeAgJmRD5kD629N97Ok=; 7:IVCo0vSEnYTpLyd1OEJAQSNVFvcJHQ9j+QJFVzQgGatquCVanQQqucmBP/iaxjBllQL6OXRWaPLOaXQjDp7n0Az8PQUOGEZnkZchSz1wNT3IYCDCnOUshb0WyK70W0Zw0msheEvFRjGGx4BwzhHtcT1DiTb7JuPMquRZZYgrCgIy38KVDnJHaRADQePWLcu+bBFlOG8mFj1xtXG5SLil1HFZtDqtOtr5XodBXqTaFlVg4tm+gS9t9rGZdujXYIET SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Aug 2018 07:41:38.2856 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: aef1341c-0644-4844-720c-08d60e4c05bb X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR0401MB2544 Subject: [dpdk-dev] [PATCH 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: , X-List-Received-Date: Thu, 30 Aug 2018 07:41:42 -0000 Signed-off-by: Hemant Agrawal --- doc/guides/platform/dpaa.rst | 102 ++++++++++++++++++++++++++++++++++++++++++ doc/guides/platform/index.rst | 1 + 2 files changed, 103 insertions(+) create mode 100644 doc/guides/platform/dpaa.rst diff --git a/doc/guides/platform/dpaa.rst b/doc/guides/platform/dpaa.rst new file mode 100644 index 0000000..e51379b --- /dev/null +++ b/doc/guides/platform/dpaa.rst @@ -0,0 +1,102 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright 2018 NXP + +NXP DPAA Board Support Package +============================== + +This doc has information about steps to setup octeontx 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 -- 2.7.4