From patchwork Mon Jun 8 16:57:07 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Punnaiah Choudary Kalluri X-Patchwork-Id: 6566961 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id AAE029F2F4 for ; Mon, 8 Jun 2015 17:00:17 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id B9F9F204C9 for ; Mon, 8 Jun 2015 17:00:16 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id BBECF204AB for ; Mon, 8 Jun 2015 17:00:15 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.80.1 #2 (Red Hat Linux)) id 1Z20NE-0006ib-MF; Mon, 08 Jun 2015 16:58:08 +0000 Received: from mail-bl2on0087.outbound.protection.outlook.com ([65.55.169.87] helo=na01-bl2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Z20Mx-0006WX-1T for linux-arm-kernel@lists.infradead.org; Mon, 08 Jun 2015 16:57:52 +0000 Received: from BY2FFO11FD010.protection.gbl (10.1.14.34) by BY2FFO11HUB015.protection.gbl (10.1.15.224) with Microsoft SMTP Server (TLS) id 15.1.190.9; Mon, 8 Jun 2015 16:57:22 +0000 Authentication-Results: spf=pass (sender IP is 149.199.60.83) smtp.mailfrom=xilinx.com; vger.kernel.org; dkim=none (message not signed) header.d=none; Received-SPF: Pass (protection.outlook.com: domain of xilinx.com designates 149.199.60.83 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.83; helo=xsj-pvapsmtpgw01; Received: from xsj-pvapsmtpgw01 (149.199.60.83) by BY2FFO11FD010.mail.protection.outlook.com (10.1.14.74) with Microsoft SMTP Server (TLS) id 15.1.190.9 via Frontend Transport; Mon, 8 Jun 2015 16:57:22 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66] helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw01 with esmtp (Exim 4.63) (envelope-from ) id 1Z20MU-0004ts-6p; Mon, 08 Jun 2015 09:57:22 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1Z20MU-0007yA-0L; Mon, 08 Jun 2015 09:57:22 -0700 Received: from xsj-pvapsmtp01 (xsj-smtp.xilinx.com [149.199.38.66]) by xsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id t58GukRo016792; Mon, 8 Jun 2015 09:56:46 -0700 Received: from [172.23.64.208] (helo=xhdrdevl6.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1Z20MI-0007uv-8f; Mon, 08 Jun 2015 09:57:10 -0700 Received: by xhdrdevl6.xilinx.com (Postfix, from userid 12826) id 632DFEF81A2; Mon, 8 Jun 2015 22:27:09 +0530 (IST) From: Punnaiah Choudary Kalluri To: , , , , , , , , Subject: [PATCH 1/2] Documentation: dt: Add Xilinx zynqmp dma device tree binding documentation Date: Mon, 8 Jun 2015 22:27:07 +0530 Message-ID: <1433782628-23748-1-git-send-email-punnaia@xilinx.com> X-Mailer: git-send-email 1.7.4 X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.0.0.1202-21600.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD010; 1:VyTCqFur3QHY+tjVS4SxG6wvLNNvxbLR+IHGF/Kv+VmVFTysDyqPxAn6bHnMTDq+zdXnDqj1T3jpdgd9HS8+4Ou1chfiuKJ3eN+7VrHzhrWjaxtNttELHAxfp3JtjMYCK+/+1dmu9/N9Zn2Ag9VjgRWlmQc3QMEtKCKYmtT05lZH+356EkSXtzyxDaku4wvewM+0qGhuZzIjyiCWv2RPr2O5lkWE6kjIhyDN+S7iroyu7h9vGCnKloqIVPhov/b2ibNHthS2CJCiz/MwwVFu3ZtIuv1u6gQf4ier0PDwE+MfqedbP0dggC8elEveHTCTC2dooPGv+VLxTX0sQstsNw== X-Forefront-Antispam-Report: CIP:149.199.60.83; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(438002)(199003)(189002)(46102003)(50986999)(5001770100001)(36386004)(36756003)(107886002)(5001960100002)(189998001)(77156002)(62966003)(45336002)(50226001)(551934003)(92566002)(46386002)(19580405001)(52956003)(86362001)(6806004)(48376002)(47776003)(229853001)(103686003)(42186005)(33646002)(19580395003)(87936001)(2201001)(50466002)(63266004)(107986001)(4001430100001)(90966001); DIR:OUT; SFP:1101; SCL:1; SRVR:BY2FFO11HUB015; H:xsj-pvapsmtpgw01; FPR:; SPF:Pass; MLV:sfv; A:1; MX:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11HUB015; 2:hbWBFmajvcO84hEOGTMMnIEvmnnYUcFVVJbmr59iyFGC/sp3LjVCKjAdJeS/qlxh; 2:Uxe+6o+0HHacUkMF24440Rn4OVUT2Ae195lBrT0DqoPAOuTecx9j2eZ1OZPSVR5KRFe+xl3q16nsrWrHZ72fDEr3CxCcpm3b+hrKIUFUl7AMqfMdCdACQaZr+A1AjDj5xqY6t3EMso3PbdvHpWUmGL9qBNtrCoeXh4DwG6J4wo5K/IJ0EwodkUKG7gdgEBLxTJFVIoKsaKaMCw5eCku6yRC0TTfSF/DdlcX+amS/qzA=; 6:xvgq8uwIise5yqUKiiLAkh9vPKpav0yCkUnk6GZFpbPtnjkC3EURCfO65GWDqZ5bLWfSh6sxbRGp1GIGQioYYuVe+RTGQUVd57qhODGWKWkgqPpc6PD5K8gSkRg4VuhRrbz9v9UgF5fArgx8K2se0Ug/nbEj/saAXRWC0LWJTwRJNpEU10fI0bso8OKmUdCUtJvH8Jmp2XyV7odqO4jEbniKBnNv0MDCwJIpmwhXf/L25Kri7O746GjYycdIrZ/q9kUZMNfBrwcG6NkOauYRiA+EJna3kcjbaWhMlGXtGkr7JEdpA2pKdn40JA6KBsVwy2q2FehNRUcuBwyD3uDguOjgF8VlZ6XO1e43YnVvgn6/vUXJ/bapGFd5lHAx25TycA0rrkAmOmQ9/YjTC+oRCrlKGZ6qxtXToNQnifTuxWfi8Z6peTZQlZUiAdh3PfJtZmbar5CANVh1RglxdxeGQVAgP4TGqbHImRoWQHoCGChVhLaObvfiptZ29F720Jsr X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BY2FFO11HUB015; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(520003)(5005006)(3002001); SRVR:BY2FFO11HUB015; BCL:0; PCL:0; RULEID:; SRVR:BY2FFO11HUB015; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11HUB015; 3:d2dlMm8cnQmKU8lTtUbnGCBsuued3YqwW6trj5SJ9jkQ0XylbOGpoUGz+iu7608iMSIEBj1iVn2/Ug7Tk6HCMZ03LJlcXyD71Gt9XMczRsw1YP4N/NwO5HENssWVcEK+BfoiBnoISslFnl+X0obns09RAZerBfllsWaXwJOjTRCGJFl8gMC1TahSkV9yDUHhrJA4ewsk8qW/dB5RNSYARcu2tyHkr1tZB3wHyDvn2C5ggBBvKOrTRNoClF+zsgWK16eR+ScCgRGlc09AnZO2+lQJMhHmL0G1cKEteIh6+C7IKfQXsAM118cB7VG4UPkv X-Forefront-PRVS: 060166847D X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY2FFO11HUB015; 9:fmrN5a7nyYGPeubOssKECQeqZ8rGCYO5kygJnSmUD?= =?us-ascii?Q?4mUaaAfvzinvmDdoGsqYksZRu1brcJn+qeEjYsa4UGBDrucF6zyM1gvkjuLI?= =?us-ascii?Q?/7Iro2KqrYXpgF1ALkoyAIektliQ2fLOIfVIhO5E40J/fQps6KOUrgehxErN?= =?us-ascii?Q?K0XlTT6541YeQeNBIwP+P1zZ4ONX8nqdw0X4SDi0rT80zJAkH01hdT398pSz?= =?us-ascii?Q?PSrPXoXl5WHDsWlSGZwJQOQeOVnLOz3tfF0J0buaaAvAoIk961hS80UZBLoZ?= =?us-ascii?Q?Fh6X0n0glOSAvGdXeAfB0t9uDWShSb6/qdDINOowOhUFf2mRYLkto8yX2Waw?= =?us-ascii?Q?/pZq4Gnx9WjG0yt7gFFQ7jh5yVJaCigETHhZpDjPuhAS/k5IyZR6F7HWbl2e?= =?us-ascii?Q?zDUsv0PzweVsoRV5rGu+s49CZNAljgQefHzDh948FEW8IoJObS4Hi7VfMAKE?= =?us-ascii?Q?Qx6olSawGybRAHVOCkaXLV1YPdybiqpz5FgUB4OvqfmD0gwZF4jJgGUcBMqg?= =?us-ascii?Q?QlDBMGy2ag1x1w4MkRuIwDf0E9wY/g0kDOjM6BoOg/BcgKtlCyOqPVxOXzvL?= =?us-ascii?Q?Bjm8yFm975kYgiZUYv0zULhOg7utHo8hjiKN58HwyHKcBM8W3EnbXUU59hRS?= =?us-ascii?Q?F+IAmWKG9qCSCjt0Usa/7wsEGPQSDQB3N43ASbaFvdAnfXRiVFC3ZpuYQY9b?= =?us-ascii?Q?sQeHPmz0exVdpBNeWr3U/Zbsow3b8k4wm3Rezcol7OL6jZqzLwe71hAYAFnX?= =?us-ascii?Q?2dYe2rVPaEkj/fNxiJD6eI0wm/OxkCqnHFMuThQiQA0fQDKuVH241jd98yLW?= =?us-ascii?Q?ek5OqY7yBJeBYZ6pShdu6bhTfrWIIWvObzt1oxAzIrlLB95G3aO4t8w1hSD4?= =?us-ascii?Q?cRbVXMO6Eh8YrciM4/uIFRBcEsE4Ajgp9O/Bv8UKvjynPnFpsxUlaKq+KH7B?= =?us-ascii?Q?Y/pTN8vdxm5djyHMf0Wc4FV2onD5FRCmgoKaPUQZw=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11HUB015; 3:zgTqrW4wqgLhzCpSkwb8FUTLA+qGUvbFl4aKO+A3Vax52UIq/k5HindLJC1ztoIfFtQqOGQ6xBOiHbKwQkH+5gEGI0CsHoxFDdeLdlCBZFw069kSkWbDjx82D5kZpEpp30xmz444HgI2quKbx0QeiA==; 10:aQiWO93HEIp1R0GlFkq7+0miMa0FD8d/5Pb0AP8q6bfTmGtt2an0Y6VAlsCzH5Rbk0T20GGhuQm/JqVHbhMRmgXMb4scaujkzgSUpdeENrI= X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Jun 2015 16:57:22.7231 (UTC) X-MS-Exchange-CrossTenant-Id: 657af505-d5df-48d0-8300-c31994686c5c X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=657af505-d5df-48d0-8300-c31994686c5c; Ip=[149.199.60.83]; Helo=[xsj-pvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY2FFO11HUB015 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20150608_095751_445856_07749AEA X-CRM114-Status: UNSURE ( 9.74 ) X-CRM114-Notice: Please train this message. X-Spam-Score: -1.1 (-) Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, kpc528@gmail.com, kalluripunnaiahchoudary@xilinx.com, dmaengine@vger.kernel.org, Punnaiah Choudary Kalluri , linux-arm-kernel@lists.infradead.org X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+patchwork-linux-arm=patchwork.kernel.org@lists.infradead.org X-Spam-Status: No, score=-4.2 required=5.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_MED, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP Device-tree binding documentation for Xilinx zynqmp dma engine used in Zynq UltraScale+ MPSoC. Signed-off-by: Punnaiah Choudary Kalluri --- .../devicetree/bindings/dma/xilinx/zynqmp_dma.txt | 61 ++++++++++++++++++++ 1 files changed, 61 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/dma/xilinx/zynqmp_dma.txt diff --git a/Documentation/devicetree/bindings/dma/xilinx/zynqmp_dma.txt b/Documentation/devicetree/bindings/dma/xilinx/zynqmp_dma.txt new file mode 100644 index 0000000..e4f92b9 --- /dev/null +++ b/Documentation/devicetree/bindings/dma/xilinx/zynqmp_dma.txt @@ -0,0 +1,61 @@ +Xilinx ZynqMP DMA engine, it does support memory to memory transfers, +memory to device and device to memory transfers. It also has flow +control and rate control support for slave/peripheral dma access. + +Required properties: +- compatible: Should be "xlnx,zynqmp-dma-1.0" +- #dma-cells: Should be <1>, a single cell holding a line request number +- reg: Memory map for module access +- interrupt-parent: Interrupt controller the interrupt is routed through +- interrupts: Should contain DMA channel interrupt +- xlnx,bus-width: AXI buswidth in bits. Should contain 128 or 64 + +Optional properties: +- xlnx,include-sg: Indicates the controller to operate in simple or scatter + gather dma mode +- xlnx,ratectrl: Scheduling interval in terms of clock cycles for + source AXI transaction +- xlnx,overfetch: Tells whether the channel is allowed to over fetch the data +- xlnx,src-issue: Number of AXI outstanding transactions on source side +- xlnx,desc-axi-cohrnt: Tells whether the AXI transactions generated for the + descriptor read are marked Non-coherent +- xlnx,src-axi-cohrnt: Tells whether the AXI transactions generated for the + source descriptor payload are marked Non-coherent +- xlnx,dst-axi-cohrnt: Tells whether the AXI transactions generated for the + dst descriptor payload are marked Non-coherent +- xlnx,desc-axi-qos: AXI QOS bits to be used for descriptor fetch +- xlnx,src-axi-qos: AXI QOS bits to be used for data read +- xlnx,dst-axi-qos: AXI QOS bits to be used for data write +- xlnx,desc-axi-cache: AXI cache bits to be used for descriptor fetch. +- xlnx,desc-axi-cache: AXI cache bits to be used for data read +- xlnx,desc-axi-cache: AXI cache bits to be used for data write +- xlnx,src-burst-len: AXI length for data read. Support only power of 2 values + i.e 1,2,4,8 and 16 +- xlnx,dst-burst-len: AXI length for data write. Support only power of 2 values + i.e 1,2,4,8 and 16 + +Example: +++++++++ +fpd_dma_chan1: dma@FD500000 { + compatible = "xlnx,zynqmp-dma-1.0"; + reg = <0x0 0xFD500000 0x1000>; + #dma_cells = <1>; + interrupt-parent = <&gic>; + interrupts = <0 117 4>; + xlnx,bus-width = <128>; + xlnx,include-sg; + xlnx,overfetch; + xlnx,ratectrl = <0>; + xlnx,src-issue = <16>; + xlnx,desc-axi-cohrnt; + xlnx,src-axi-cohrnt; + xlnx,dst-axi-cohrnt; + xlnx,desc-axi-qos = <0>; + xlnx,desc-axi-cache = <0>; + xlnx,src-axi-qos = <0>; + xlnx,src-axi-cache = <2>; + xlnx,dst-axi-qos = <0>; + xlnx,dst-axi-cache = <2>; + xlnx,src-burst-len = <4>; + xlnx,dst-burst-len = <4>; +};