Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/103956/?format=api
{ "id": 103956, "url": "http://patches.dpdk.org/api/patches/103956/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20211108090704.3585175-8-g.singh@nxp.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20211108090704.3585175-8-g.singh@nxp.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20211108090704.3585175-8-g.singh@nxp.com", "date": "2021-11-08T09:07:04", "name": "[v3,7/7] doc: add user guide of DPAA DMA driver", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": true, "hash": "d51732901316e03c6fe272468e18315543101077", "submitter": { "id": 1068, "url": "http://patches.dpdk.org/api/people/1068/?format=api", "name": "Gagandeep Singh", "email": "g.singh@nxp.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20211108090704.3585175-8-g.singh@nxp.com/mbox/", "series": [ { "id": 20374, "url": "http://patches.dpdk.org/api/series/20374/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=20374", "date": "2021-11-08T09:06:57", "name": "Introduce DPAA DMA driver", "version": 3, "mbox": "http://patches.dpdk.org/series/20374/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/103956/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/103956/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id D7FEAA0C4B;\n\tMon, 8 Nov 2021 10:08:19 +0100 (CET)", "from [217.70.189.124] (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 7237D41156;\n\tMon, 8 Nov 2021 10:07:46 +0100 (CET)", "from EUR03-AM5-obe.outbound.protection.outlook.com\n (mail-eopbgr30042.outbound.protection.outlook.com [40.107.3.42])\n by mails.dpdk.org (Postfix) with ESMTP id 356AD41149\n for <dev@dpdk.org>; Mon, 8 Nov 2021 10:07:42 +0100 (CET)", "from VI1PR04MB6960.eurprd04.prod.outlook.com (2603:10a6:803:12d::10)\n by VI1PR0401MB2366.eurprd04.prod.outlook.com (2603:10a6:800:2b::23)\n with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4669.13; Mon, 8 Nov\n 2021 09:07:41 +0000", "from VI1PR04MB6960.eurprd04.prod.outlook.com\n ([fe80::11d9:6f32:90e:80c1]) by VI1PR04MB6960.eurprd04.prod.outlook.com\n ([fe80::11d9:6f32:90e:80c1%7]) with mapi id 15.20.4669.016; Mon, 8 Nov 2021\n 09:07:41 +0000", "from lsv03457.swis.in-blr01.nxp.com (14.142.151.118) by\n SG2PR02CA0077.apcprd02.prod.outlook.com (2603:1096:4:90::17) with Microsoft\n SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.4669.11 via Frontend Transport; Mon, 8 Nov 2021 09:07:39 +0000" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=E88gJLlqVzafPFlTgM912ibrJLb5P3c4ktDH+mpYH+e5UWfaJJMahn3tibO30avjokVmHb3mP4vXEgtrLs6owb2LZWQ2RFTx1a4umySkL1AsifBoF6K3fV/yrTYtdm1kd0f7SCK0EJPZvoxdmZjUgXFPX0Jdi+/r0wErNOMa54Wgq5aXoa3miuab6MRphsQAkaiSsuaYhIRQ5WLZW/7raxC77IXk0UPMj+Ar4LSDtPDXpHLJQ+bgkWOYllxc8OJGnvfJJtEmc4P2mDUEBY2eI3izBfUbMtTB0AVKCg5p+RGa/2EMUqKK6450LDQswE6nyFSu2sYGhty72hjBM5JZaQ==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=Xhju688NWIaEJaXIj/E5HzIPdvLSpA3Eme26xi3Dj7M=;\n b=Kd4p15KZ9rh1ZASbX5bbBjGTzB/jAC0flJElFW01w37RMiwaDSToXy4+98g2Cpkbi99LmlE9W+luqnCqyKw1uf5jr4AWT8jg0lW77vV6r4P82EjWm10WBA7TQP3DMA62OR7GpgJ2E3qWy+ihyt9D8nazqfITg5CLPOScsiNJDQwFOPuOK5v9xWj+rt4w/okhL5mn7Nn7PzmTAT3rIsFNeFCN8GeqnhtOTSxhH/L4tUblZMjOyIywXqtNb6kZ720eVn7KHfeZyUviBBmqvB4+zIoKEbygomwbQLwtLTVu+gQtyDYqmMFHX0PqPysQyBenZb4P6HUS/tuYMod3LWrQOg==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass\n smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass\n header.d=nxp.com; arc=none", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=Xhju688NWIaEJaXIj/E5HzIPdvLSpA3Eme26xi3Dj7M=;\n b=Rb9vTRNExYmCTvubGAJd33S9ZZqXqsb6N3Zsetsdej0RnEHWDizHjjoBXzj4wLiwpEVrBZqPk+c/hBWTRzGlPBfE/EMkeWE+nJBMdap/kSTstlNSihA/t5FXxXGsAWCLLnTHTnRcxv7qrrtkvdjRoik9hDkE0SbaAFkonGWciWo=", "Authentication-Results": "dkim=none (message not signed)\n header.d=none;dmarc=none action=none header.from=nxp.com;", "From": "Gagandeep Singh <g.singh@nxp.com>", "To": "dev@dpdk.org", "Cc": "nipun.gupta@nxp.com, thomas@monjalon.net,\n Gagandeep Singh <g.singh@nxp.com>", "Date": "Mon, 8 Nov 2021 14:37:04 +0530", "Message-Id": "<20211108090704.3585175-8-g.singh@nxp.com>", "X-Mailer": "git-send-email 2.25.1", "In-Reply-To": "<20211108090704.3585175-1-g.singh@nxp.com>", "References": "<20211101085143.2472241-2-g.singh@nxp.com>\n <20211108090704.3585175-1-g.singh@nxp.com>", "Content-Transfer-Encoding": "8bit", "Content-Type": "text/plain", "X-ClientProxiedBy": "SG2PR02CA0077.apcprd02.prod.outlook.com\n (2603:1096:4:90::17) To VI1PR04MB6960.eurprd04.prod.outlook.com\n (2603:10a6:803:12d::10)", "MIME-Version": "1.0", "X-MS-PublicTrafficType": "Email", "X-MS-Office365-Filtering-Correlation-Id": "570446d3-59ea-4377-324f-08d9a29737e1", "X-MS-TrafficTypeDiagnostic": "VI1PR0401MB2366:", "X-Microsoft-Antispam-PRVS": "\n <VI1PR0401MB23663319CBE4EE1494703619E1919@VI1PR0401MB2366.eurprd04.prod.outlook.com>", "X-MS-Oob-TLC-OOBClassifiers": "OLM:9508;", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;", "X-Microsoft-Antispam-Message-Info": "\n 8fBQjf+JIN0JEhaOqoW3mBUPq2z69824I2x3851VdZuCj4KNR2q0fTORpKD/cW231+M7nAU37Hm/3Tw3Nnb2Ukkd6IIdz8cRQce/jVfC1f2oZXCBwGiREoX6h/s/XBJgZMuA6sYyDeBEMhjvPofbelzxlFJa8eTHNYl1hLLjzn/bKg2+rhC6nkE8x1hRljnh6Gh3UY4QEOVTW14NfPVd9mGUvqo2IjuezXrY8eddLnD0vIbpVJsQ+eYdhIIRZx5HalyvtY+Nj9LOoKLuEHVqqO6RwIXNtwTnnLu/BgIuagNfresqdFMXj1/bTTB1VPBGqbX+dYwD6E6msemYjE9vlGiUnE6AmnKs1QwQH4bCnHUcyV0Q4A4GR4ydt81pu6X9mNlTWj9UnibrIrtfoxMqKNqmX+YK7LVRX5qhzIUbHxPwMc9QqSR+em9wAd0vxqL2QBhMIzX4NQJiRrM9UiN9ox07ZQ/0qlaNcLFhN+q5gevSHYU5YwIsdLwO3C7eCwTDXmtjHBgQpymcyAdBcn8/Tb/XCH5RqInv0EeseaVMHtU5x8sj7xUKIljoBapVv5Ho91nwVIS0p1UR9BAZqXNVR8WfJQn1dVuQIyd225jR+DafzvWkbnC2gY5HbUR4/E62ci+VKMxXER//3hvdiUy3k9dKetp1x4C7ra1nbwKaEnObltxtvAadt3qcCntOwiAKvlBlDZHDqnY/CxxA//bb6V/4ZQfAj8mVu/RCkgIWsou9MSUk3nJBq7MqFTYgnD+O1q1TEnSGjseXkGtN9SzzvnC40MgMijK6n3WZSJjpGuHeDxu7ztmmfdtnaHYeGdjv", "X-Forefront-Antispam-Report": "CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:VI1PR04MB6960.eurprd04.prod.outlook.com; PTR:; CAT:NONE;\n SFS:(4636009)(366004)(6666004)(52116002)(6486002)(1006002)(5660300002)(316002)(8936002)(55236004)(4326008)(7696005)(8676002)(66556008)(38350700002)(66476007)(66946007)(86362001)(38100700002)(508600001)(1076003)(6916009)(2906002)(956004)(2616005)(36756003)(83380400001)(186003)(26005)(110426009);\n DIR:OUT; SFP:1101;", "X-MS-Exchange-AntiSpam-MessageData-ChunkCount": "1", "X-MS-Exchange-AntiSpam-MessageData-0": "\n H++sVtqbSm2e3jfeeF49D7KZaESZzxG4o/zU/wOz2omgTdHt2yH4/2iZ6M/D52YXhDwNsFq8k+F+YkHD7SiwsMcxzR9MMZQ0BPeyFZ1ovW2dMfKStJi19MlneG9BbACFpDG+o645xpW3X8R0ITFsLGrxR31qgw1YQuv+3/tx7wzj5vBx4KqbkwDlNZ3RxxV60sbZ9RZqx502nZrts+2Hlj3HUawZCs5cqPvNQH4WufseCVDcK1GlaKGrbXA2caatoasHRDVmFTDjyfdPkndXndePmvgXARBRFNPCoeATSU7TTkMOPOvI2MbS+u0jASHYgCLPeDyOiUohm/iM0g59nS4tEMM5cybbgV4Ds5vlDHj33pg7D12BJLJ0lTsQ71ol/m1oQHzdwCUpJbJinNhts+U48X5Bqup87e1PBqjfQtm+X4IO543WhmSW7jSOvmiXsCsBzL3jctY3RdVQYsMLeCbzYB0pbytVdrZ3QKNpdIGmEF6RMg/A4EIfSAtyyKGJVrd3wZAEdr2xNw1ZAvA6/DIgAtgiCtmZMk+uppGjyzuDrkVqm42KyRnwN3BgnsL7MlgOXLdD0piSb/HZcPr4LvCWicmti7+VMSjZTai5dJ2RJduxAbym9gYlRAHHX8PG4A9f7jljmiat39lefGdbHknHlYdwdGjNNqzBXvC5nGAXq6UHszEXLkS8PWwnWMqXSrVOhaqSg1EFVqiBgjgQatn2C4rHH0StKwwctGzKGwGsuprWyGhx7pWJMVNX3wp4HZvRFwc+dRfEGwaZZZsCtoVQWwlbU0SvXn6WivHOojiiFF9uw8l8aZvNckKsXl2T1UyhNKiBSQpbtQIPFR/GXlACKX21INN6SZHI/tiA143KecaKuXTq3vHraBnmnaXoDFuisbwyrqdV+MZEr6Gj7u8tM0S5EjqrqTzHACZcvh8BxWFrjNAvCBDExc4SsoeWKzzz/FxgeqGNsfSEgKZL7VYfJdcBaMtZuIM9VEejNBJqdym1WIwX3+y3XeM2jtt7AAzEVf1wOFEq0jCsSmRi1hEbUZM1lToY4fFCO4j3dSs0WJ55BnlA8pcO1lRszShAkloByJHAdvU+P7TIy9XHvz1Oo+IP4Gi59Rn4KmHSMIzKN35q9BSN/AXt8c0D9uEM1d+tmz5hvG2hLcpQRSDU05cF5vfzw1ogN+1mKGEwHcTzl8KTrexGdMiykqTknznQGPnYpLO/Jrlz8r/z/9wcoyL7icBtZv8gfQT5eT72sj/uN7iJBVyn3poG45R+4sk596ryyPla+urmDkylrEf6UNE9Pc8f47+J0g9hJu56nnHhRB+fH6pfhLd7+67xf8VwniEzTkcxEwQz3m15m+Jp9IsGGsvJ7H+nEbHsn0TXJ2Fg8c6PzSOfo8NsKXLvfeMKojbY57PyZznNquK7honoi6/PeO5rtiwqCRCrpR7yzBH0l6WDLGhD/DF/QGNj0aoUAG8hbtrs902G54UEkCOONxZJFLZcnu9enPGiHeV3F9sEAU1mxMp60hmDiv/gbZXdY5AOrBO7r5wxrOBG7XHZP2AwAJDAJ71zUhcgkNykbt0=", "X-OriginatorOrg": "nxp.com", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n 570446d3-59ea-4377-324f-08d9a29737e1", "X-MS-Exchange-CrossTenant-AuthSource": "VI1PR04MB6960.eurprd04.prod.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Internal", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "08 Nov 2021 09:07:41.3979 (UTC)", "X-MS-Exchange-CrossTenant-FromEntityHeader": "Hosted", "X-MS-Exchange-CrossTenant-Id": "686ea1d3-bc2b-4c6f-a92c-d99c5c301635", "X-MS-Exchange-CrossTenant-MailboxType": "HOSTED", "X-MS-Exchange-CrossTenant-UserPrincipalName": "\n uu74l53z9TzXrqO3ljMVBrII5/il7dltCnfZmxapzXIV6ASq+hQfcU6U5rHgw7QL", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "VI1PR0401MB2366", "Subject": "[dpdk-dev] [PATCH v3 7/7] doc: add user guide of DPAA DMA driver", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org", "Sender": "\"dev\" <dev-bounces@dpdk.org>" }, "content": "This patch adds DPAA DMA user guide.\n\nSigned-off-by: Gagandeep Singh <g.singh@nxp.com>\n---\n MAINTAINERS | 1 +\n doc/guides/dmadevs/dpaa.rst | 60 +++++++++++++++++++++++++++++++++++++\n 2 files changed, 61 insertions(+)\n create mode 100644 doc/guides/dmadevs/dpaa.rst", "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 76b9fb8e6c..a5ad16e309 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -1361,6 +1361,7 @@ NXP DPAA DMA\n M: Gagandeep Singh <g.singh@nxp.com>\n M: Nipun Gupta <nipun.gupta@nxp.com>\n F: drivers/dma/dpaa/\n+F: doc/guides/dmadevs/dpaa.rst\n \n \n Packet processing\ndiff --git a/doc/guides/dmadevs/dpaa.rst b/doc/guides/dmadevs/dpaa.rst\nnew file mode 100644\nindex 0000000000..ed9628ed79\n--- /dev/null\n+++ b/doc/guides/dmadevs/dpaa.rst\n@@ -0,0 +1,60 @@\n+.. SPDX-License-Identifier: BSD-3-Clause\n+ Copyright 2021 NXP\n+\n+NXP DPAA DMA Driver\n+=====================\n+\n+The DPAA DMA is an implementation of the dmadev APIs, that provide means\n+to initiate a DMA transaction from CPU. The initiated DMA is performed\n+without CPU being involved in the actual DMA transaction. This is achieved\n+via using the QDMA controller of DPAA SoC.\n+\n+The QDMA controller transfers blocks of data between one source and one\n+destination. The blocks of data transferred can be represented in memory\n+as contiguous or noncontiguous using scatter/gather table(s).\n+\n+More information can be found at `NXP Official Website\n+<http://www.nxp.com/products/microcontrollers-and-processors/arm-processors/qoriq-arm-processors:QORIQ-ARM>`_.\n+\n+Features\n+--------\n+\n+The DPAA DMA implements following features in the dmadev API:\n+\n+- Supports 1 virtual channel.\n+- Supports all 4 DMA transfers: MEM_TO_MEM, MEM_TO_DEV,\n+ DEV_TO_MEM, DEV_TO_DEV.\n+- Supports DMA silent mode.\n+- Supports issuing DMA of data within memory without hogging CPU while\n+ performing DMA operation.\n+\n+Supported DPAA SoCs\n+--------------------\n+\n+- LS1046A\n+- LS1043A\n+\n+Prerequisites\n+-------------\n+\n+See :doc:`../platform/dpaa` for setup information\n+\n+- Follow the DPDK :ref:`Getting Started Guide for Linux <linux_gsg>` to setup the basic DPDK environment.\n+\n+.. note::\n+\n+ Some part of dpaa bus code (qbman and fman - library) routines are\n+ dual licensed (BSD & GPLv2), however they are used as BSD in DPDK in userspace.\n+\n+Initialization\n+--------------\n+\n+On EAL initialization, DPAA DMA devices will be detected on DPAA bus and\n+will be probed and populated into their device list.\n+\n+\n+Platform Requirement\n+~~~~~~~~~~~~~~~~~~~~\n+\n+DPAA DMA driver for DPDK can only work on NXP SoCs as listed in the\n+``Supported DPAA SoCs``.\n", "prefixes": [ "v3", "7/7" ] }