From patchwork Tue Jun 9 08:50:42 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: 482157 Return-Path: X-Original-To: incoming-dt@patchwork.ozlabs.org Delivered-To: patchwork-incoming-dt@bilbo.ozlabs.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by ozlabs.org (Postfix) with ESMTP id 13D69140325 for ; Tue, 9 Jun 2015 19:06:45 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751956AbbFIJGn (ORCPT ); Tue, 9 Jun 2015 05:06:43 -0400 Received: from mail-bl2on0053.outbound.protection.outlook.com ([65.55.169.53]:61600 "EHLO na01-bl2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750868AbbFIJGk (ORCPT ); Tue, 9 Jun 2015 05:06:40 -0400 Received: from BN1AFFO11HUB037.protection.gbl (10.58.52.148) by BN1BFFO11SHT008.protection.gbl (10.58.145.23) with Microsoft SMTP Server (TLS) id 15.1.184.11; Tue, 9 Jun 2015 08:50:50 +0000 Received: from BN1AFFO11FD054.protection.gbl (10.58.52.31) by BN1AFFO11HUB037.protection.gbl (10.58.52.148) with Microsoft SMTP Server (TLS) id 15.1.190.9; Tue, 9 Jun 2015 08:50:49 +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 BN1AFFO11FD054.mail.protection.outlook.com (10.58.53.69) with Microsoft SMTP Server (TLS) id 15.1.190.9 via Frontend Transport; Tue, 9 Jun 2015 08:50:49 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:52564 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1Z2FFA-00067e-14; Tue, 09 Jun 2015 01:50:48 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1Z2FF9-0006CV-Rs; Tue, 09 Jun 2015 01:50:47 -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 t598oJvN026248; Tue, 9 Jun 2015 01:50:20 -0700 Received: from [172.23.64.207] (helo=xhd-lin64re117.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1Z2FF6-0006Bj-4J; Tue, 09 Jun 2015 01:50:44 -0700 Received: by xhd-lin64re117.xilinx.com (Postfix, from userid 13614) id 522FC209C2; Tue, 9 Jun 2015 14:20:43 +0530 (IST) From: Kedareswara rao Appana To: , , , , , , , , CC: , , Srikanth Thokala Subject: [PATCH v5 1/2] dma: Add Xilinx Central DMA DT Binding Documentation Date: Tue, 9 Jun 2015 14:20:42 +0530 Message-ID: <1433839842-5699-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-21602.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11FD054; 1:jDuQcnTCU29osUx4q0Z4dIeIENAcHU4joAWuQHlnn/9fxV2p7fNS9kYDDtAfVW39QHBXgkGujXw8AgI3dN/mDaBl7kY1D2bB9QXUa50oBKOqtjSa+Rj0QcEYmXTb5yQtHSjPbcUIqJr/Uab72Uq/a5of//CC3CvShkbr7m8TpqafWhfOkWzL/z7qxEx5aup77DOb4YZtIsCu/4UE/KV/KWNK56TMCBBxOPQfItm8KrWhHdT7q7aEtuGCdc6IuyzyAUqXc2yfoFKmIvVs14X/5zABMAh6gx5KPm6jh885l34QbOe5cT4VbQ+unTEQ5Js/FdGKfwMcyLZ6aPE9w1TWAg== X-Forefront-Antispam-Report: CIP:149.199.60.100; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(438002)(189002)(199003)(63266004)(42186005)(92566002)(7049001)(46102003)(19580405001)(6806004)(47776003)(45336002)(48376002)(50466002)(52956003)(36756003)(62966003)(46386002)(229853001)(33646002)(2201001)(50986999)(189998001)(86362001)(87936001)(77156002)(36386004)(50226001)(5001770100001)(19580395003)(103686003)(5001960100002)(107886002)(106466001)(107986001)(90966001)(4001450100001)(4001430100001); DIR:OUT; SFP:1101; SCL:1; SRVR:BN1AFFO11HUB037; H:xsj-pvapsmtpgw02; FPR:; SPF:Pass; MLV:sfv; MX:1; A:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11HUB037; 2:nF7Biw2ASIE6QkrkzhpHdrLiumE14JugXx3sMLwmLlZI8TPyhbq0PrtAAhufToB9; 2:gH6h2Wxf/yAhXYQF0aqpSaZIEK4pFbWV5tzlQuMlp2Gpr4tQb3dRKNEJLQX4Hd1Ewv6lwaPDt1FhtHdbIcRPdUOkpnOHy14F8JumDtc4o/zDHqekH0ZOgXnTBBP/def1aCALjCopkVUzZYVBEke9Q9B1qqDgaNA1tQ+YT8WrWzJQhLDwanLhvxORpAUMoZ5m7ezyiIhz5KmCjICjfCzWhzS5tI9+ulXfkJcXKL20yQQHAQxg4qfJYx8GlUq3GWKi; 6:KADOX1XU7jcHMjEIr3thFXvDDjgXouiMcnbIkkDn30mtsG0fypsXk+HOPf6WqD+qg6zRoshZTSHKjsKRCH9cArcGKahoHEGo9Zwjr05jWiyZM4HF/vlutc/P7uetSTzQZd/NW8zYYw4lAxy4e1uYyV+jqInQiqrd8Jc8yZaC9ds03gWOFCwyzvD0RYQt+TU2+T5TKIaTpXOm4icRddHcSlh3BtZSOEn5xig67ZogkLMYmsqlYcTTMfm5h3Ce3mJ+f3zIYaXv2zrnwoPuMNv4qCaFSONrM/wiQIc1qLAjBXYu5jev2lcPADjibwlLzAJwMSIXRFwaP3OkddwWJepaEcE03ON7k2NJz0IP1+0T4e3ww64PVz5/ZMaUTTALhW724wZLzWn0MkZTpJKKV9d9fVXvENUkLI+dp9RrvBJ9eE1P1Louy2ppy1klhE+ReAhQ7QswSrCZJDjfImbgBnEErJdEc6bawwDdYqkjUxWOQ1T/PvgcRm691a3U3uMwYSNk X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BN1AFFO11HUB037; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(5005006)(520003)(3002001); SRVR:BN1AFFO11HUB037; BCL:0; PCL:0; RULEID:; SRVR:BN1AFFO11HUB037; X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11HUB037; 3:hL7wIT07qbyDy/M3YAoqvfBFccwL2N47SCs+llSMMqMfXfRXyeTTrM4jKinJabonXsikDp37ck2n4U3h7mKNhm+T6PdiST5OScjK8E//TQbzcV8UgCFQ6sAv52Fznul19X4qU2YigFGwGDMRfauHYE2F42hvm8YqzO6Y8IByDwyrciRkb2Naju027IwFc15jKl6KlA0NLQJuKoS/q2rMoaAOi5LvFqH4fy2Efn8cf0xyVGmcA3SU62s1ZNvQNN5S3+mlstX6ptdJgSSUpN5gX87zOeOWAXL9dMJKnHf8n1JC06LL5+U4DY8V2DGww2Hp X-Forefront-PRVS: 06022AA85F X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN1AFFO11HUB037; 9:qAwA+ZCnO3emD92oitt6+ZNT9N3+mIoAlk8BlnzG?= =?us-ascii?Q?XSaRDj7MhkNlMRxvu//oJkaWBXlnFfSK5z/rwtetb2Jk8r1zz4qjXX81VBSm?= =?us-ascii?Q?LuUNdIJf6sXMKH7Nte+MD1nmyI93DT+AHCvrE6AH2FU4UH/WKrBO6uV7uqQV?= =?us-ascii?Q?1diFn153+6S0tIm+0QSxyKYpnrc0aq9HQ2qayAyG3s7JV+3asH7ozZfjTIFW?= =?us-ascii?Q?lfRaYaxUSgsjk7acCFJLRRqGLbNwOzsBO2GiuIbGTpn4oZV2zqMyYU/Xf6Bf?= =?us-ascii?Q?GrPhki5Kh8H642YdX57aviTx6BLWXaNduJLBr9onr6liihtjCAFXLg6CFh7G?= =?us-ascii?Q?J2Mg418ZptgYUaZ1xc1RGHbPfwTo3gzBGsV3bgNAS71eJq7mfVFAOCYyFV44?= =?us-ascii?Q?riiR6Xp8luPsyrDkyYueSQo0lxrzwxb/NNYdlTXMaKXa+4/qLxz1rlFqBfwc?= =?us-ascii?Q?jgEUhD/Vd8aSba1Hk4nyHCx/rcon0rcKRcg01JHjwGTelyrqM4yZAxzdZgPM?= =?us-ascii?Q?CSsDbuwX4w5BYJDiK7ett0YBTbB1D8EtqTutlGCZb5l7Pz6gfD6MKdzd5fuS?= =?us-ascii?Q?mNdPZlrrRkLcwa2V5cQStmfo7ImUjJpS8ZQ20l6mT1irc/BegZAcmxe+re1m?= =?us-ascii?Q?+PUdSkgn27fVNfo2jRWTIAU5Cc/mTH9mES3Pa+BJ5425sARMq8lYtHEC+NLX?= =?us-ascii?Q?It2PWiflBqorSLW8nJ71ubCiajLiXPm+NzEIYvZQ4KC0UVBae6BIWKHIokyZ?= =?us-ascii?Q?uzSTtD3DX4HRXTk7BsKuuW8N/ZWZ7TacGaaQjBlYNGsqj1mtK6y25Dyi+8vB?= =?us-ascii?Q?Uv8rWjXAvld7KaGoY7YjmFMYKEuZaqkh8PGJT4q68xzW3uCCEswUD7W0bO3N?= =?us-ascii?Q?Ittg6WSgpSTuUjJ+uUUOBnVsntsniq3s0nuuuIeVBjFheP1sYKzTnvDnzDfT?= =?us-ascii?Q?mF/l9ABiLpGJ7uX4/Z7N/NJP2g2xFN88+fb7v/Bip7AhTlbYrpjYZFHpR/qL?= =?us-ascii?Q?jjVNPjKtTgFLB3AxdnMUJQkm?= X-Microsoft-Exchange-Diagnostics: 1; BN1AFFO11HUB037; 3:kkdRLlkQ3gUqaK9/aeWlt0+BmV0duSyK/qo3G+33rDs87Hh8Ll3Ck/8emxV75W/pDmoKpc32nO9jj/EeF7TMu4nipv8BhnlrDjbhkHRhoin9wDo8f9PEmktsKMqs7gmr3V+6splxUHDHx6ayTIyeZQ==; 10:VWdmtRmMoyuMgjoCXkqnbaXqMGpHiJWqAKAsh6BhWcna6UNLjKk7xihiFbwfFa16aXr+KNj94xjhjxlqYi9ix6/m5bjmKd4XsHIpj0HR2ps= X-MS-Exchange-CrossTenant-OriginalArrivalTime: 09 Jun 2015 08:50:49.1030 (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: BN1AFFO11HUB037 X-Microsoft-Exchange-Diagnostics: 1; BN1BFFO11SHT008; 9:JLHDIdTWMisYm+xFGc2fYEcuKaBdHHoqv7mv3+H5f7okrvVTrrA8ompsmBDwNA8POLG1Nddr1hKgS3sl8Cmq+YZlxNtuNY3ifWmAJckmdR84fqOdLFHF0FV3BcfLEk+MrPnj1yS0WCUpvVC0k10ePA== X-OriginatorOrg: xilinx.com Sender: devicetree-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: devicetree@vger.kernel.org Device-tree binding documentation of Xilinx Central DMA Engine. Signed-off-by: Srikanth Thokala Signed-off-by: Kedareswara rao Appana --- Changes in v5: - None. 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"; +} ;