From patchwork Thu Aug 6 03:19:32 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: 6955341 Return-Path: X-Original-To: patchwork-linux-arm@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork2.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork2.web.kernel.org (Postfix) with ESMTP id 90A3DC05AC for ; Thu, 6 Aug 2015 03:22:12 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 612F32069E for ; Thu, 6 Aug 2015 03:22:11 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.9]) (using TLSv1.2 with cipher AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 6310E2069D for ; Thu, 6 Aug 2015 03:22:10 +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 1ZNBix-0000xW-8o; Thu, 06 Aug 2015 03:20:07 +0000 Received: from mail-by2on0079.outbound.protection.outlook.com ([207.46.100.79] helo=na01-by2-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1ZNBiu-0000J4-0v for linux-arm-kernel@lists.infradead.org; Thu, 06 Aug 2015 03:20:05 +0000 Received: from BN1BFFO11FD023.protection.gbl (10.58.144.33) by BN1BFFO11HUB043.protection.gbl (10.58.144.190) with Microsoft SMTP Server (TLS) id 15.1.243.9; Thu, 6 Aug 2015 03:19:41 +0000 Authentication-Results: spf=pass (sender IP is 149.199.60.100) 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.100 as permitted sender) receiver=protection.outlook.com; client-ip=149.199.60.100; helo=xsj-pvapsmtpgw02; Received: from xsj-pvapsmtpgw02 (149.199.60.100) by BN1BFFO11FD023.mail.protection.outlook.com (10.58.144.86) with Microsoft SMTP Server (TLS) id 15.1.243.9 via Frontend Transport; Thu, 6 Aug 2015 03:19:41 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:54391 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1ZNBiV-0003ec-Pb; Wed, 05 Aug 2015 20:19:39 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1ZNBiV-0001ov-KW; Wed, 05 Aug 2015 20:19:39 -0700 Received: from xsj-pvapsmtp01 (xsj-mail.xilinx.com [149.199.38.66]) by xsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id t763J8Vd005363; Wed, 5 Aug 2015 20:19:08 -0700 Received: from [172.23.64.208] (helo=xhdrdevl6.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1ZNBiS-0001oP-4r; Wed, 05 Aug 2015 20:19:36 -0700 Received: by xhdrdevl6.xilinx.com (Postfix, from userid 12826) id 40BD3EF81BB; Thu, 6 Aug 2015 08:49:35 +0530 (IST) From: Punnaiah Choudary Kalluri To: , , , , , , , Subject: [PATCH v4 1/2] Documentation: dt: Add Xilinx zynqmp dma device tree binding documentation Date: Thu, 6 Aug 2015 08:49:32 +0530 Message-ID: <1438831173-8761-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-21726.003 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11FD023; 1:QketBdL6x7x2q0h92MHBavcHHJjzzcN80rUrhiLOVNAvQjrlmsC924CY3wipRysKiKv9knNHwcIadOAohvwOcwnrdwqACNH+gshfiErkHZw31jqoK3WSuItdTYZrfjw7G8ZV/spjBGyfVL6cmrWChz4FD8tjYjcbEcZkPm9zEPCkhZKq9tVpRQPzr0Wm2RlzrTGnqFlajAlPPz0VAMZramrr7NSyfZGJpNFzaCIV6shU7CRYOkcxKd6nDpvj95vFbDJEEJuG7ChEy9IioI8uNcWm11PsQMXYDfLYXvtjsp8DdZJM/cp4HFYij62VPn/uwhJbKjRAUOcXcfVnz0mjOg== X-Forefront-Antispam-Report: CIP:149.199.60.100; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(2980300002)(438002)(199003)(189002)(36386004)(19580395003)(103686003)(2201001)(42186005)(229853001)(106466001)(92566002)(33646002)(6806004)(86362001)(19580405001)(87936001)(50986999)(47776003)(77156002)(63266004)(64706001)(52956003)(62966003)(551934003)(50226001)(189998001)(107886002)(48376002)(5003940100001)(5001920100001)(4001540100001)(46386002)(81156007)(5001960100002)(50466002)(36756003)(5001770100001)(5001860100001)(5001830100001)(46102003)(45336002)(107986001)(5001870100001)(4001430100001)(90966001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN1BFFO11HUB043; H:xsj-pvapsmtpgw02; FPR:; SPF:Pass; PTR:xapps1.xilinx.com,unknown-60-100.xilinx.com; A:1; MX:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11HUB043; 2:tDjuW8axVnXJHyt0PUbTFFmGvjbcsuNnvGiQpCGV8oOa9iYPrMp/idkqUBxyNgLglFU5gLs+o8f0AZ+S2gLWHJtat0HuudUdHxW/Iuo+ixAnJvbrYMozBalDe5jt9mD6wkgI0D61S53gayjem7dQqO5+gWTjWnEzhXJ2F8O2ozs=; 3:0WpXjFD7dRlD6YZFByBYQ6xOWhknnXkuAMxppcq60zBz+b/yM+PAFU4M1XClfLazoTCGSkk1LSZN9CxUNFqg6ZmWRi6TLemMOAd2V7Yzci2KCPdrYu23hNWWPJTY9DaSQEumltMHMApIq6fFLYd6iwqIv+HVnRz/3skBM9RUM6BQGherlpGgPiSBlGtDwdQT/v8K9cQAo7YanNcqawLCIyC08v2duCXaN80aI4PVzPN4cPYUz8BBImYZC4TqmHfI; 25:ijeo6lXVtQIopT0heAw1bsWCgUuPlH8O46dKDUzbWK95VlCA+LfaJaegn6Z5DE4T4u+q4dhtBtsx2lFe6+ND3Rdt61I9OAfPRQxgbcXawvM1hL2d8ZDB5yFsrkLY3ntAnXWI6LE0f4JldkGuxqMDg8qV6jZKTtDTgoXsGjVAziBalj5NyBTELV8BeI+HVir3W3LcwqnaQClWP9jM6PAHCdzlnCylRNRFFqfw+f8SmsuWZkKIq7ai7Ba+t5PszPmpFoANN4rOLttbN6wmpqen3A== X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN1BFFO11HUB043; X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11HUB043; 20:LILZ09HF57qvQgqLJJJXQz7CsTL7c230GMk+Bsm7MLmEF8leQaj2NJRB8cYZEL6K9l7dKu67lQlZ7EWOVT3Pgyh03XrIvLPrcqMiLl/2THT/NEWuy6lnNZIstANxeaLr5iSzDvJcG2LBKrTUgFowBarPxOzLexuOYxcoqeEkpBdCKZJmDkDmUvRK1aOuzYv1RWudl/eUO9fp9CqXdXNhDVly4pNBj0NffTVXtGcIfFy52uLyfL0iZLDT10ugoHzeIWZqkxeZCrBGRZpfL17q3onhLrMAj/edQeFCitTliHXuLTYWki/lorCdqh5QN+Xzy4tLRN8F5lYQgrFZi/zuj4SAUmYE85ic4wVfVS+OkOWDx7ZprYlXLhV9IcgWiQZEn0OSctJGp+WW0Gpc4Wde34Ay04l+HhXIoU6785VFvMwdWmrPeJGGZw6MN/LyJURTXQ9LdKoMeGfmlw2WaX0wcbCPhfCASwvx1Q60h+JJ0cG15YRs7Dhr3A9iwi9Ut7TO; 4:u4tNIImfIR4H82QdpCMMO6GpJ0B1u42E3T/NzgMwzNAeCPm5LYWH6fBQJUAXxsAvx51GeyFaZCFPzZFFrhvN5/mUmo9KFXuvuNL61I6TR5x0JvoFAqpY+X7byYgmCja/vTtByLRjFvBBJajZoUeqnO/lQK8clNkwGsexDDCWe4tCjmvyFyAQn0asu6M97xjBbKKtBYgWC6b7X2bXWJvwQXHWL0u4HRUzu0uJOaK2rX57SkfxhNsBINIyNR+77GIV/+0Dxo6XAa18WuXwiCryDr1INj5yS0osnKP/VLO4WDg= X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(5005006)(3002001); SRVR:BN1BFFO11HUB043; BCL:0; PCL:0; RULEID:; SRVR:BN1BFFO11HUB043; X-Forefront-PRVS: 06607E485E X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN1BFFO11HUB043; 23:mjhcas2XIbVATvMaDZT8Uxm9xM7TBx6eIbYs474?= =?us-ascii?Q?8cNwErKl2YoiXq12gxizfB6nZfY9o3l9OacMhs1FrevthnzlyDI3Je8IP2VB?= =?us-ascii?Q?8mi9ef6BME+ufXw9+OzQLt2auWxJhgZlWzKlUYDpnJGMm4JXYYVovgjztbSj?= =?us-ascii?Q?QWmBucFdz+tJjipDcbTbOz2KbPHFUlcvFeioELcj4CMamd2cGnbSE8N6nE06?= =?us-ascii?Q?G5XplH40SNxTuiGPUDKwCaxyUnu33+HiJrdBC0kzYiOAHp2iOM4kvlb+0/Pc?= =?us-ascii?Q?qNMyQt5G30O/ZMcBUyu0to0d5JcloikM0kyz+Jd2mQwDmpT7lwYBIm+OWcXr?= =?us-ascii?Q?sqRJCRU4I+zLVjmCRytXsBGIiYDl5Gpdl98FOtYPdHFLYXZfO+swJfCWofu0?= =?us-ascii?Q?Clgq+dqvRzbhpGp45oRFBNYTCzmzFamhhkx1WwzKilpOf5NyB/TPOiRopwWr?= =?us-ascii?Q?GKf0F9ljtdcOe5SqLUWkZ5YwncmpHAUA5SRPGDB5vGXCVbVM5DEx4eVpgWi9?= =?us-ascii?Q?IGjGRbVx0rUYayksuQRdvxRTMGUIVlMaiz9sU06CSqqdlpI5/6eyOaEeXL0j?= =?us-ascii?Q?M9jCMbTtCs4hnzRn3WAFuc4wCOx+fYMJshVCrpz9KWTJF5bnxKWZsJ9dRD+3?= =?us-ascii?Q?VxxVhjMjDcojBvUC/j0IYZBjquEq2nzTvG6DDpevTu+oGiP1/oIdXfW73sHj?= =?us-ascii?Q?f9/I2/r6inr62M4MsDvfZrc8qoQNO2SZiW6yCmEIvCWzK10+jmqQXgmYhwy4?= =?us-ascii?Q?KvEv211H0PvNGIbVskwkm3Ks+rjoeW/+27BZWVxDYlO+zB5/EzpaESANRAR4?= =?us-ascii?Q?86yfqD5MVwCxOcFMiLu1jiFEvKmx3cNmPT0Lp6sUrjfHB4hEiWQFTnw5skF6?= =?us-ascii?Q?ZmAg1WO0o4NWxM1YxojAWoTl0fzWwsYG4VCMXhCJA5LfOWm1IXeBpOUAZg1r?= =?us-ascii?Q?Sn3FJgsDFzB51zwJJqIFXm6reQ2cCfE0MMpi3YY6v5Kzw3KsMN+Vle0M98UH?= =?us-ascii?Q?Uj7Fj7v4LHx5NDtw6Wk7GD5b/Z87f7c7MhNlszeTBC1WkFLYlQ7wo/6Cj0wF?= =?us-ascii?Q?3kDAUv747Kx3SEb3cCuaWZFXOrcFXvhgeA9fkSJvMMq0oKPvcONf/Dtc0pKp?= =?us-ascii?Q?2pSWde7nDacw+/MNb8j4EKsVRhQoVIIW8tuaQ40XntdsEilMxZFZFFLzlLrf?= =?us-ascii?Q?emF9RLPTsNNWabGQdjO0dTV1C50kDEnjMvZ890Ll1PmBkxrEOHkvWlg4VHRN?= =?us-ascii?Q?6z5ZIk0nzAhMEeMC6qKV8flvQ+w64Kp7RCNR7X4HJ?= X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11HUB043; 5:/ezwxSbNIej4NfErjbBo8rK/MsP3OdeV8XVCSqxaotPXYdxfAAS42l6V92TfF/0eLKm+T+0ftJCni03F5NeMOjn4ALDQZikVXwIBzTPcgGm2wGg1Exd3ZmjHgh71ytM4tkiBdiIfNOyvk21mqKVRJg==; 24:UUxbvUcko4S+GvlAwEOJRYZJtEcQJvy1p86KRQTaRf6qx/TZMG9t25lXAMhoXhzXOOvLxRA6cbrH2mGJk0jryHIWaQu7IP+vL1swivL94vg= X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 06 Aug 2015 03:19:41.1366 (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.100]; Helo=[xsj-pvapsmtpgw02] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN1BFFO11HUB043 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20150805_202004_435730_EEE3E4E5 X-CRM114-Status: GOOD ( 13.34 ) X-Spam-Score: -1.9 (-) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, kpc528@gmail.com, kalluripunnaiahchoudary@gmail.com, dmaengine@vger.kernel.org, Punnaiah Choudary Kalluri , linux-arm-kernel@lists.infradead.org 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.3 required=5.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_MED, 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 --- Changes in v4: - None Changes in v3: - None Changes in v2: - None --- .../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>; +};