From patchwork Thu Nov 30 07:48:34 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Wen He X-Patchwork-Id: 10084329 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id F051F602B9 for ; Thu, 30 Nov 2017 08:07:55 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id E1DEC29EE4 for ; Thu, 30 Nov 2017 08:07:55 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id D6CE229EEA; Thu, 30 Nov 2017 08:07:55 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 4EB6129EE4 for ; Thu, 30 Nov 2017 08:07:55 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751563AbdK3IHz (ORCPT ); Thu, 30 Nov 2017 03:07:55 -0500 Received: from mail-by2nam03on0078.outbound.protection.outlook.com ([104.47.42.78]:39712 "EHLO NAM03-BY2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1751040AbdK3IHk (ORCPT ); Thu, 30 Nov 2017 03:07:40 -0500 Received: from BN6PR03CA0007.namprd03.prod.outlook.com (2603:10b6:404:23::17) by SN2PR03MB2366.namprd03.prod.outlook.com (2603:10b6:804:e::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P256) id 15.20.282.5; Thu, 30 Nov 2017 08:07:39 +0000 Received: from BL2FFO11FD015.protection.gbl (2a01:111:f400:7c09::106) by BN6PR03CA0007.outlook.office365.com (2603:10b6:404:23::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.282.5 via Frontend Transport; Thu, 30 Nov 2017 08:07:38 +0000 Authentication-Results: spf=fail (sender IP is 192.88.168.50) smtp.mailfrom=nxp.com; nxp.com; dkim=none (message not signed) header.d=none;nxp.com; dmarc=fail action=none header.from=nxp.com; Received-SPF: Fail (protection.outlook.com: domain of nxp.com does not designate 192.88.168.50 as permitted sender) receiver=protection.outlook.com; client-ip=192.88.168.50; helo=tx30smr01.am.freescale.net; Received: from tx30smr01.am.freescale.net (192.88.168.50) by BL2FFO11FD015.mail.protection.outlook.com (10.173.160.223) with Microsoft SMTP Server (version=TLS1_0, cipher=TLS_RSA_WITH_AES_256_CBC_SHA) id 15.20.218.12 via Frontend Transport; Thu, 30 Nov 2017 08:07:38 +0000 Received: from titan.ap.freescale.net ([10.192.208.233]) by tx30smr01.am.freescale.net (8.14.3/8.14.0) with ESMTP id vAU87XOT031747; Thu, 30 Nov 2017 01:07:36 -0700 From: Wen He To: CC: , , Wen He Subject: [PATCH 2/4] dma: fsl-qdma: add devicetree documentation for qDMA driver. Date: Thu, 30 Nov 2017 15:48:34 +0800 Message-ID: <20171130074836.1381-2-wen.he_1@nxp.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20171130074836.1381-1-wen.he_1@nxp.com> References: <20171130074836.1381-1-wen.he_1@nxp.com> X-EOPAttributedMessage: 0 X-Matching-Connectors: 131565028585585862; (91ab9b29-cfa4-454e-5278-08d120cd25b8); () X-Forefront-Antispam-Report: CIP:192.88.168.50; IPV:NLI; CTRY:US; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(336005)(39860400002)(346002)(376002)(39380400002)(2980300002)(1110001)(1109001)(339900001)(199003)(189002)(50226002)(8676002)(106466001)(6916009)(2950100002)(47776003)(77096006)(2351001)(68736007)(5660300001)(81156014)(48376002)(51416003)(81166006)(356003)(85426001)(316002)(86362001)(54906003)(305945005)(1076002)(105606002)(104016004)(4326008)(16586007)(50466002)(2906002)(189998001)(8656006)(36756003)(97736004)(8936002)(53936002)(50986010)(76176010)(498600001)(33646002); DIR:OUT; SFP:1101; SCL:1; SRVR:SN2PR03MB2366; H:tx30smr01.am.freescale.net; FPR:; SPF:Fail; PTR:InfoDomainNonexistent; A:1; MX:1; LANG:en; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD015; 1:L47TMO9pF+zUtcwV6098q1sx8MfcGoQ1D+rLZhFMy3r1AMTAYACkNx0ktztascYiLIBl1bNQ/XBa2vepfNtnmeSxfR6J70oZzDbapnsW+6T/olkRfDbzGP2dtlV2Yzej MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: d6385065-c571-4568-db65-08d537c96c29 X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(4534020)(4628075)(201703131517081)(5600026)(4604075)(2017052603283); SRVR:SN2PR03MB2366; X-Microsoft-Exchange-Diagnostics: 1; SN2PR03MB2366; 3:6DAYCWru0cdOIpGgu3ONYbiqSlGeZXEVhKy2T60QS2nygUfCykEtY1nloGaDcGffauoqvOW5ADBdnRi3Zce8RCS1HXiEwtZlEGdIU+HamhI8PuzeTSjOpBhhjEqlntpiyOzEEuQ646KIBpYTKQU7P3LtcnSaYzF6bRS6aIbLC0SHUqSM+rBSXoIUK+m04G8OzF7kQkPpF2dFBXiSBwhRDt25J9x5OuVOI6omP1IwRbYAgVP3WtW6C+f6kvVnL9BQWCt2fapxdxjxENM3gyc9SUFhKGb5sMLYkuZEm20NmAKHrTprY2CsETxV9lEan9gF7YfssYgGENcJqZ1MlJr6igKZBA6dr+uoYde8BNdbc2E=; 25:hP146gj9sgPSiYt2vbM08e3DBgen/Nusj4cWbCBNUXwIgHsqEE/qsHwXsBG5JvSXQx4H9W+lITJjs20b2wdFdiAutoWfSAN88ft8zSIqMCu9ZdoOnc+mh5VoaNMO0zrTtt1YQo8JKIGyyN/cBFW5dtOwVYsJPpPALPIeFb3ig+qm3JXQTYlT6p+03k1AnaffFrRvdkYCs5q4DLI2RFiMq4Vix8v8ltfwTFcHNBM2QYi3zM0a9hVb/9nDHABB0i+d4eMBf1GmwW6tOQZ4Txf35nXOCZTpS+cSH496GujhuB0OLMYhoj922ITFZzJ5OKlieoGmkgqC4Pta4LaNvVVmog== X-MS-TrafficTypeDiagnostic: SN2PR03MB2366: X-Microsoft-Exchange-Diagnostics: 1; SN2PR03MB2366; 31:zYuTMXWZb130IHQUEgQ2+EGvsoh0dMxPyjknk4vZKkYDMUhGAn4hKX1GI+frieD62KQe7erQ/s2PPdqaBSkEwzoiQJl6zUq6GtwEh0tpmD9KKJ0s8fpc3Dlhul7bKrrrtKm0MoaOLgkmYiEPcjVsJet5pSADWYqVGoGt3+ZSZLfQSQIwQKr0z4uHekoLn9yi2/MuU3hkpO6g+ewnSoSqgEJCwXq5Nyyf6EStvwTgFFc=; 4:W8R3bYUatZ0Ha+HPGeeh9yo9PflRQFfnyOn5fkIgsu1y1NNTV/273ntDTYpunE2LNdi7tFLo/KbUqBu4KvYWWzoBC5Gn6aY6yW5Up+PQ2MAft7rb2z8Iep+uUiFWIWy2QWflnsj+aEa6Khd876JH5HOYn+XXa97cbueoMivqZKVmYUk3KNtkevYewiFIQxd/jOVzNHb1OZRVg2ggivAu+NmQmQW8IHcOku3vBVLCp5ebJtKBXPVdctCdQVePN/f6cUJwLiYMadWVgbsEwpMgBr/69dgP3DcgBBunDhLHdiiE3IJb2SPOFBmi3lfp7c9g X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:(185117386973197); X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6095135)(2401047)(5005006)(8121501046)(10201501046)(3002001)(3231022)(93006095)(93001095)(6055026)(6096035)(20161123565025)(20161123561025)(20161123559100)(20161123563025)(20161123556025)(201703131430075)(201703131433075)(201703131448075)(201703161259150)(201703151042153)(201708071742011); SRVR:SN2PR03MB2366; BCL:0; PCL:0; RULEID:(100000803101)(100110400095)(400006); SRVR:SN2PR03MB2366; X-Forefront-PRVS: 05079D8470 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; SN2PR03MB2366; 23:j5GP3HYkn3alXzTS7c49yB9nD7WcuWb2H9OdGVbQi?= =?us-ascii?Q?8kTj7Ow9uAM5PbtsJpDmMD23/n4MYycszjJdYV8Ly32vlf7s2shQf3jLLxsF?= =?us-ascii?Q?Z3//wFcvR71lO5xnUt8oAmFH1dmX7kIed20yHXrwvlPKUtly4zx3xR+kPdnc?= =?us-ascii?Q?ZnF1mhiSR4cW3i7avPE+2usgL3EfqBDf5YN/zpK0oWS9Ezn8VDqLfgMajowA?= =?us-ascii?Q?JfrSfMEgaQCLPsRjO36I/BHDCZJb2UC9YG+KyWiPVlWEvwXEtPFPf7EDjrlg?= =?us-ascii?Q?DIqQHsUo2TDTBjWZ969cd+NOpPfXHN2eW/LiF313fnvuBVgeo5plIxNmN7A+?= =?us-ascii?Q?utsT/CTsnc5Z4ovjaQk34FOZKxJskpDjwh9hZudf7HwnbSSjSFotbbUvIXjM?= =?us-ascii?Q?wdrEcs5QNDkP+6hbvxnf+bRcOkH0SEt8tgztDH0zl1h3tOCWRwuN3DG32SHC?= =?us-ascii?Q?z8oSYMdsxYb6AUQNjM4+zbrVoEL5Ex//FsybsPnNsM02QzQiVZcCLg33e2OZ?= =?us-ascii?Q?e4jAj8Bp+jeu3M5JnU00PWrbPwz0yqN7cGo50jy4Z/uEwhVKvsqKLGq6H/Vx?= =?us-ascii?Q?m4ynmidYmZnVqL+Y+0c5tyD9WLyrMAr8aZIGJIWcEkIRad7pThztZkE8OZEd?= =?us-ascii?Q?NHkFVe2ER4wdGqyCfnSe92yj+UrwWZVCbmu+HhTxy1OK4nWbiMRtN1yWLYea?= =?us-ascii?Q?gwAdIt7BDWZ3izs1ybdn9dkDBQXXbpI6FpqOcQAAwCxUoDZQrVQk1E38QTjS?= =?us-ascii?Q?KD50eGAWU4iGdo7HCuqrCjOeLb2wGDwsHI5riYOvnWhRsoCpRXr/EoWrSwb5?= =?us-ascii?Q?xbN9wFEoKCTyQLMgUIHRg/DnoctBmRxmU8YoR3O720dHTBDUqAu4pPB7Nf/E?= =?us-ascii?Q?BR/1CbQpG/Ceee2RyFvB4svHlwY1MzdV97dByCvjEj42jUsOgf5Lb8OvENfm?= =?us-ascii?Q?6jCmR3yDX6rZ7LpmCNmgA0K5VoJXo/TyD7/Ad0dSz8/ZqkkqFtoqaolqa/ZJ?= =?us-ascii?Q?BWI7io30HOROnf6Ev0rzMcaOnFT+fyPmY0XFC/jP1deAJOItis2y9Mvr43tx?= =?us-ascii?Q?WSKANSAGy4JAJiFVzI+Vi0B/5DCLLdEREMREEcc7wSyZHcWkqbglClDCMKMz?= =?us-ascii?Q?y32Qmofuqef8WALYvAcR/Q9UfGWgGEn?= X-Microsoft-Exchange-Diagnostics: 1; SN2PR03MB2366; 6:DUa2G+zi7v2JIzVLNgOE51nxl3y+uujOI1sxXd93bTz9QQaOLiy4/iTXcbsvKOBwa5dCrYn+ClqPJzqJw/MSMDdbFyvr1X+ej+vurrnjtaPdD0pwNikt1JdtMHbW++aL3P/DmQiyR8PWrFjnolLUaPohMhU5i9G4QPPzCo/iCekgyDpNdaBBeGyT6wx0W3smiIB8/zkZyE/jDR2q7akRvIa5IsC8L2KPM6gaW//FCLaka3DGOi3tM/iPDFcNoF0ljv/NPc5H8gQaDrqycew+as3uWyRKt8Kz6DGhLUV2UEb2v333Omkg7ZBVxr/GPU7R363njxhhH+iVUpUERV971VLUJ5p50G8RlGnnO7oHe/g=; 5:Rn6SNWHm+yuXEDyJctvXIF8M1opfzKD4CYgirYcfG+UlCdurBx/zRqCi355tmPLD74qfNxArJaxAL3T6iyN48n3R7dDF1Kc8rw+8/2eqG8pR1husfZtVIj9ltyLGKXJpRGhAhEhhfrdnAoXhgFhqGpYbhuunmBH7YOyrM5Qj7R8=; 24:fWVmhl5FVubviXUxuyUHbvrburcCwCYmAykNUujJC4ywwSyXEizUO390eybyrErxNKwDJTszVJeikQa7mgJ8IFGohv50ee0aSwZreOHaKLs=; 7:mDsHn/gs0eat5x+BgHjpLzPM7dNHYt4ww8CPqirzaUGmNYSrJm7A3JinhYuO5F5thBuhdQUEJjZZgXK0bdRH7BQHFQqc75gp8DdkTIBczbqrwo7AZqsWDTmOt8TuGc70Qta0mXt3cYKG4XLpN0dSFbsw+L5gCZZfHeb5mhFqzVnek2ag70E9jp+Cqqvcdp45CRI+0BFPmCrd8JVAQM8UyikxYNFfAExOXJfQ/Cqx32BeP11VxWBB1Y2U2jbUNELO SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Nov 2017 08:07:38.3869 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: d6385065-c571-4568-db65-08d537c96c29 X-MS-Exchange-CrossTenant-Id: 5afe0b00-7697-4969-b663-5eab37d5f47e X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=5afe0b00-7697-4969-b663-5eab37d5f47e; Ip=[192.88.168.50]; Helo=[tx30smr01.am.freescale.net] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN2PR03MB2366 Sender: dmaengine-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: dmaengine@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Wen He --- Documentation/devicetree/bindings/dma/fsl-qdma.txt | 42 ++++++++++++++++++++++ 1 file changed, 42 insertions(+) create mode 100644 Documentation/devicetree/bindings/dma/fsl-qdma.txt diff --git a/Documentation/devicetree/bindings/dma/fsl-qdma.txt b/Documentation/devicetree/bindings/dma/fsl-qdma.txt new file mode 100644 index 000000000000..b076177b4863 --- /dev/null +++ b/Documentation/devicetree/bindings/dma/fsl-qdma.txt @@ -0,0 +1,42 @@ +* Freescale queue Direct Memory Access Controller(qDMA) Controller + + The qDMA controller transfers blocks of data between one source and one or more +destinations. The blocks of data transferred can be represented in memory as contiguous +or non-contiguous using scatter/gather table(s). Channel virtualization is supported +through enqueuing of DMA jobs to, or dequeuing DMA jobs from, different work +queues. + +* qDMA Controller +Required properties: +- compatible : + - "fsl,ls1021a-qdma", + Or "fsl,ls1043a-qdma" followed by "fsl,ls1021a-qdma", +- reg : Specifies base physical address(s) and size of the qDMA registers. + The region is qDMA control register's address and size. +- interrupts : A list of interrupt-specifiers, one for each entry in + interrupt-names. +- interrupt-names : Should contain: + "qdma-error" - the error interrupt + "qdma-queue" - the queue interrupt +- channels : Number of channels supported by the controller +- queues : Number of queues supported by driver + +Optional properties: +- big-endian: If present registers and hardware scatter/gather descriptors + of the qDMA are implemented in big endian mode, otherwise in little + mode. + + +Examples: + + qdma: qdma@8390000 { + compatible = "fsl,ls1021a-qdma"; + reg = <0x0 0x8398000 0x0 0x2000 /* Controller registers */ + 0x0 0x839a000 0x0 0x2000>; /* Block registers */ + interrupts = , + ; + interrupt-names = "qdma-error", "qdma-queue"; + channels = <8>; + queues = <2>; + big-endian; + };