From patchwork Thu May 21 17:09:54 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Appana Durga Kedareswara rao X-Patchwork-Id: 6457791 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 0152DC0020 for ; Thu, 21 May 2015 17:12:56 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 167EA2051A for ; Thu, 21 May 2015 17:12:56 +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 195CA200F3 for ; Thu, 21 May 2015 17:12:55 +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 1YvTzX-0005MW-Al; Thu, 21 May 2015 17:10:43 +0000 Received: from mail-bn1bon0072.outbound.protection.outlook.com ([157.56.111.72] helo=na01-bn1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1YvTzQ-0005CG-4t for linux-arm-kernel@lists.infradead.org; Thu, 21 May 2015 17:10:40 +0000 Received: from BN1BFFO11FD020.protection.gbl (10.58.144.33) by BN1BFFO11HUB033.protection.gbl (10.58.144.180) with Microsoft SMTP Server (TLS) id 15.1.172.14; Thu, 21 May 2015 17:10:11 +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 BN1BFFO11FD020.mail.protection.outlook.com (10.58.144.83) with Microsoft SMTP Server (TLS) id 15.1.172.14 via Frontend Transport; Thu, 21 May 2015 17:10:11 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:49146 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1YvTz0-00054v-3y; Thu, 21 May 2015 10:10:10 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1YvTyz-0001l9-Lb; Thu, 21 May 2015 10:10:09 -0700 Received: from xsj-pvapsmtp01 (mailhub.xilinx.com [149.199.38.66]) by xsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id t4LH9XiY016576; Thu, 21 May 2015 10:09:34 -0700 Received: from [172.23.64.207] (helo=xhd-lin64re117.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1YvTym-0001ZZ-Px; Thu, 21 May 2015 10:09:57 -0700 Received: by xhd-lin64re117.xilinx.com (Postfix, from userid 13614) id 01D40209DF; Thu, 21 May 2015 22:39:55 +0530 (IST) From: Kedareswara rao Appana To: , , , , , , , Subject: [PATCH v4 1/2] dma: Add Xilinx Central DMA DT Binding Documentation Date: Thu, 21 May 2015 22:39:54 +0530 Message-ID: <1432228194-6760-1-git-send-email-appanad@xilinx.com> X-Mailer: git-send-email 2.1.2 X-RCIS-Action: ALLOW X-TM-AS-Product-Ver: IMSS-7.1.0.1224-8.0.0.1202-21558.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11FD020; 1:CBd30kVxTwLJnWkCPRGcOnQnAPV7ELMMo3ren3ZBmFH30zReDiMPlJt3FP1PTYzSavUMenkWajO+VXnkdRMCK4k2Z8AUKuRo2A8chpauenbVvQxHCeNEtp9vUxwZI3OjvJAL7WIJJCGbCQdcdmmklpm7YZJSqzHrALuSJnvf8fhUnjNypFPe703Et2SZj4z9NzJTSKdVrLtwPIsW3xUpCIy4F0erAutd+YsFZi9QIZCfo+8e0k7K8rs8zAET85ZnOzR+B4UObWc1OTq4P233xiu5Ik3dnpOrUdZGcsz9Blz/Vf3NwCxsphmFKUcFcrJ7 X-Forefront-Antispam-Report: CIP:149.199.60.100; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(438002)(189002)(199003)(4001540100001)(81156007)(46102003)(42186005)(77156002)(62966003)(103686003)(189998001)(64706001)(47776003)(33646002)(63266004)(5001960100002)(107886002)(36386004)(48376002)(19580405001)(92566002)(19580395003)(5001860100001)(5001920100001)(5001830100001)(5001770100001)(87936001)(86362001)(36756003)(2201001)(46386002)(52956003)(50986999)(6806004)(50466002)(229853001)(50226001)(45336002)(106466001)(107986001)(90966001)(5001870100001)(4001450100001)(4001430100001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN1BFFO11HUB033; H:xsj-pvapsmtpgw02; FPR:; SPF:Pass; PTR:xapps1.xilinx.com,unknown-60-100.xilinx.com; MX:1; A:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11HUB033; 2:nEdylh4kS0tA+HtBzpcGvsKKmAsYdp6KGiByPjl44G332U3s/5DoCWWHfehKtGpQ; 2:9l6juHjBbXfABupYUZIoqkllPaTByO749mrKAVGL7KME3KqX03XTUFpoLm7BSqbMgqQgWJbVdPGyCsRRAAspkybFBchEOIUW7l3mxTfHIwuz5Pg9EdvrQfCZ7YCXU1rWCtrBAiqk3Txv/ZuSpuXWMaeex9xn4Mftwkjf7Vu9zJiM545d5nrgPL0HP/DSvKWuR5IWdLsUCrMff04SwZUvRlsVyD68XTBjveBu16pwYLkoRBa7fSJpTzjsmBU5u/HC; 6:U0nsevLhILJa5EeFEDGJV2UJecaXQR6bT9hatbBVkYelr/VzIh/uKieE1fg+CRuAsSD725kB3QqJPGLvRZjax/Kl86h9GTIjMUIHtEz/9/UNsRZQQldPoGtnW963PPopvPo1Cjeh/kpyK7N68YiG095tjfeUlcBqonM3+6QPZ95qf/MMaMTQXZQ8OD3+ioPXCEySuWX3nG6uuBrx7+fc6DY4+4+C+F0yVR/xBWT7woNqaCcdx74Y75yf6Q8kUw0bkAEUwa/QRhLDtO3EBEy797MGOpXtnT3uif+osBNnhAGDVR9CYBtm7yizdLxi5tfCoTYEZWGiVcrkmxRSGUL9MULb4Yi5FUmkLoQIwx/nUlBhlXM/KLUEj6M5BqY+mw2N4D5DxAtJxx/WY363aV74x40crllgZNpomqLbn/g83iXEqeVBx84oNjt/Yzmzh3pE9MKrP2I1tan9cAwbIstmdfMWzmB5vuOLA5GKToKXSolfzwBZ6kog6dw/91Ca3ZHb X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN1BFFO11HUB033; 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:BN1BFFO11HUB033; BCL:0; PCL:0; RULEID:; SRVR:BN1BFFO11HUB033; X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11HUB033; 3:DNil0wcoP4b+S+UJxPIs/fTE+4Om+F1l9b3I8rbbq7N8zV9uk+68voOq5boVE6TpJLh8EsASOMVhSFH+fxipPiH5GhHYJLXhFoOkfOHAVuqqOTmQBLLW+1TVKkEKtvnFSBM3JBzUpRhlouuehaCCc1f1ls99GxPFfYJAju3jEM8cV9lpE2oYQ6/Q6875m3Mwqr2d8zllT2/xdFGHWGiPir7nt0RAzT1osG/t3BwBAfY2DrcAEE0QpswGzWVB85qIgsw8WPn/VFsQPC4yvQeA0Wzwoyu3KIwpBAN3HHiEA0M= X-Forefront-PRVS: 0583A86C08 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN1BFFO11HUB033; 9:C/fOpzbJ4gNkEh7dXBJc0GL/pF8VUmh2L/LT5azN?= =?us-ascii?Q?C4ZWb8FIwyKFfe2bMWz9YJFtnbMJGPbVfMN8e6/k1c101J6E3sq+s9krbB8s?= =?us-ascii?Q?fyAV4cfEVPz62nEZ97lll82O8CFkYJpG+jFeQl74HKQgwSc+87olG6fp1Gaq?= =?us-ascii?Q?5UQHeYxmZjtuqQuT7WSqIJXEB3gk0xj0BSdpFxaJjg4ZH/Y6WKGxkCYsjWiK?= =?us-ascii?Q?dEXHobatrFSNeLnuDpVEr09H1qpngQR7/SvXO4LGTXN5fecZp8yH4u8bAAj0?= =?us-ascii?Q?fCyS7LBDX4x2ihJQKCELtdYS3O63uuMlwuKq8X6dTyKwqYPrY9shbCZphA3K?= =?us-ascii?Q?GOf416STq8sIw9CEUC5BbJtoDJ4yPLf26NOwuMuxdUiTWhaOoYcauWgnuOlT?= =?us-ascii?Q?ywS48sSKtNCaaB8/bqWRIDiTeuOs2EtfzsZ/iHHXLczggaFUcvblioyqGbEZ?= =?us-ascii?Q?OTvsAzazw5DbxUqrzYWc/W30VwifNM2tfjsJiw5O9uVoOkmVOS3SwipPTcmk?= =?us-ascii?Q?pDGZfRZNmRlhotACqxTdRJG9hFMLc2oKILig3ckHhRqOwt7Vxeblb4Q2yDE9?= =?us-ascii?Q?x6kXSkn8Saz9qpY6xJ+uRJvC3ngxFtdQwpRiJmVATkjRozLGXi0abHV4kW99?= =?us-ascii?Q?Zvk/yve4gXqnqR3rqchAcTpmvtncOXUQFqSdbRra2h+X7U4/IpYjukHsXKIF?= =?us-ascii?Q?HdlOK3hCQmYNQcoQ0+w4s9+FI/Gh47IsIUIFFCsY7ipiKw77BhxC5LFzjvhG?= =?us-ascii?Q?5deytwDrzMrxDFt1eWpqZQ2Ge4TW5Pkfk06MDvIG9mtrrlaTA53AzZfEKQL/?= =?us-ascii?Q?T1C4oLRF0ffggtgSgVi0Edt7AU7qRQEXVpOGjerZIqzl5cSZYBEn1WoalHcE?= =?us-ascii?Q?Iq5ajaXWwl+ef5r9pRgWsh8LzhRc8GbNyk/1sUbULArxLkYZufM5EPwKI6LW?= =?us-ascii?Q?6xzR6EjHka7jnT4SdsZHN24kzgaz4gobo+Y5JQqEA7ZVecGNSAG6rX8wh/Wz?= =?us-ascii?Q?VwvoBuD9n+04nEU53H+qMb3jr4b+5lz69yYVasFGWs4td26o5dT+mmIjgNqP?= =?us-ascii?Q?j0mcY+qdYHp+Pp4DRgSEVPogZygQot7W5rs2qbDHb0q2qQI8J0Nc2vzweImb?= =?us-ascii?Q?Sg9qBznQISg4FqzDfKXR85h3CKvi16oghqAJyJwTQ4x+YhSGTcb0YfGsk71T?= =?us-ascii?Q?pDr+Ojl2vuaZGvM6y4al/pPnLD3c4xz4F+oe?= X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11HUB033; 3:2H9lbqZeGgU4bJy03YtYONah0CIM2f9l+96N/P1J9Z7gEQKM6RvNCJQ5cNncHTaFgBaTP3hthYBQflkVM2cEZvRH3UTeELHqZlhVBg08Qh/aOTGGyFuHYB/1s75o19EBEUppENf5+RGm8RrJS8B9qA==; 10:QU0MHVIlHObdi+UkYD+HoOzGUosUwshgiUeMkIEggHvT9Fp2UCDnp9M5EHMEDfhyDIQMTk0jVNt7lHc58b3THVsHCZXryKZpyKKBsg5x8Bk= X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 21 May 2015 17:10:11.1659 (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: BN1BFFO11HUB033 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20150521_101036_441848_7DF2D1B4 X-CRM114-Status: UNSURE ( 9.55 ) X-CRM114-Notice: Please train this message. X-Spam-Score: -1.1 (-) Cc: devicetree@vger.kernel.org, Kedareswara rao Appana , linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, Srikanth Thokala 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 of Xilinx Central DMA Engine. Signed-off-by: Srikanth Thokala Signed-off-by: Kedareswara rao Appana --- This patch is rebased on the commit Merge tag 'nfs-for-4.1-2' of git://git.linux-nfs.org/projects/trondmy/linux-nfs Changes in v4: - None. Changes in v3: - Used proper alignment for all the properties. Changes in v2: - Change property 'xlnx,data-width' to 'xlnx,datawidth' in the description to match the implementation. .../devicetree/bindings/dma/xilinx/xilinx_cdma.txt | 54 ++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 Documentation/devicetree/bindings/dma/xilinx/xilinx_cdma.txt diff --git a/Documentation/devicetree/bindings/dma/xilinx/xilinx_cdma.txt b/Documentation/devicetree/bindings/dma/xilinx/xilinx_cdma.txt new file mode 100644 index 0000000..d1637de --- /dev/null +++ b/Documentation/devicetree/bindings/dma/xilinx/xilinx_cdma.txt @@ -0,0 +1,54 @@ +Xilinx AXI CDMA engine, it does transfers between memory-mapped source +address and a memory-mapped destination address. + +Required properties: +- compatible : Should be "xlnx,axi-cdma-1.00.a" +- #dma-cells : Should be <1>, see "dmas" property below +- reg : Should contain cdma registers location and length. +- dma-channel child node: Should have only one channel + +Optional properties: +- xlnx,include-sg : Tells whether configured for Scatter-mode in + the hardware. + +Required child node properties: +- compatible : It should be "xlnx,axi-cdma-channel". +- interrupts : Should contain per channel CDMA interrupts. +- xlnx,datawidth : Should contain the stream data width, take values + {32,64...1024}. + +Option child node properties: +- xlnx,include-dre : Tells whether hardware is configured for Data + Realignment Engine. + +Example: +++++++++ + +axi_cdma_0: axicdma@7e200000 { + compatible = "xlnx,axi-cdma-1.00.a"; + #dma_cells = <1>; + reg = < 0x7e200000 0x10000 >; + dma-channel@7e200000 { + compatible = "xlnx,axi-cdma-channel"; + interrupts = < 0 55 4 >; + xlnx,datawidth = <0x40>; + } ; +} ; + + +* DMA client + +Required properties: +- dmas : a list of <[Central DMA device phandle] [Channel ID]> pairs, + where Channel ID is '0' for write/tx and '1' for read/rx + channel. +- dma-names : a list of DMA channel names, one per "dmas" entry + +Example: +++++++++ + +cdmatest_0: cdmatest@0 { + compatible ="xlnx,axi-cdma-test-1.00.a"; + dmas = <&axi_cdma_0 0>; + dma-names = "cdma"; +} ;