From patchwork Mon Sep 7 12:33:08 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: 515134 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 6F0981401CB for ; Mon, 7 Sep 2015 22:49:05 +1000 (AEST) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751135AbbIGMtE (ORCPT ); Mon, 7 Sep 2015 08:49:04 -0400 Received: from mail-bl2on0065.outbound.protection.outlook.com ([65.55.169.65]:29280 "EHLO na01-bl2-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1750969AbbIGMtB (ORCPT ); Mon, 7 Sep 2015 08:49:01 -0400 X-Greylist: delayed 946 seconds by postgrey-1.27 at vger.kernel.org; Mon, 07 Sep 2015 08:49:00 EDT Received: from BY2FFO11FD047.protection.gbl (10.1.14.30) by BY2FFO11HUB039.protection.gbl (10.1.14.122) with Microsoft SMTP Server (TLS) id 15.1.262.18; Mon, 7 Sep 2015 12:33:13 +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;vger.kernel.org; dmarc=bestguesspass action=none header.from=xilinx.com; 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 BY2FFO11FD047.mail.protection.outlook.com (10.1.15.175) with Microsoft SMTP Server (TLS) id 15.1.262.18 via Frontend Transport; Mon, 7 Sep 2015 12:33:13 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:36189 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1ZYvbk-0002WL-LF; Mon, 07 Sep 2015 05:33:12 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1ZYvbk-0000SQ-Gs; Mon, 07 Sep 2015 05:33:12 -0700 Received: from xsj-pvapsmtp01 (xsj-pvapsmtp01.xilinx.com [149.199.38.66]) by xsj-smtp-dlp1.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id t87CWdPJ014214; Mon, 7 Sep 2015 05:32:39 -0700 Received: from [172.23.64.207] (helo=xhd-lin64re117.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1ZYvbi-0000SE-1j; Mon, 07 Sep 2015 05:33:10 -0700 Received: by xhd-lin64re117.xilinx.com (Postfix, from userid 13614) id 3BEBF208F6; Mon, 7 Sep 2015 18:03:09 +0530 (IST) From: Kedareswara rao Appana To: , , , , , , , , , CC: , , Subject: [PATCH v6 1/2] dmaengine: Add Xilinx Central DMA DT Binding Documentation Date: Mon, 7 Sep 2015 18:03:08 +0530 Message-ID: <1441629188-17601-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-21798.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11FD047; 1:QLRFlljpBf3kQeVnkWeqjGcFFiFckERQXOs/OQhqIIuYoLPY6VAtPu/cAcO0a3ugf0eV3R2AHLIm53zjOZoW6AJPljOB0KO/P/Slb/ltXGuYsi/aDXDnOaVQkuSmD2dZhd8/eykvT8sMUz84DsFFph6uO8y+lht8Dt/BDsryGIHzXx6kjIiGMfPGHAeqF2SBJPHeAJsQlIzIS4gGfgTylMGv4kWL6/bV2OdnKfhuvd7o3cD0jpbMd6b2EJ+Ejl3B67AlLd5NA2OtmJwFoCgOzfB8wlSF9HnZGJRl2TaKjV/fE/eKCBcz6O6q5f+66igpfbiZ7s8YVYKj4DPUPZ0p2AdV4tNs+dk1pAlduTiHPH5L9CVeEUBh102R8iTHMTY6Df6lPQotgmehB+iQ+tt4fMlRdgqMxyFaLFV14L5jf8c= X-Forefront-Antispam-Report: CIP:149.199.60.100; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(2980300002)(438002)(199003)(189002)(45336002)(5001960100002)(86362001)(33646002)(106466001)(6806004)(50226001)(64706001)(50986999)(103686003)(46102003)(19580395003)(229853001)(19580405001)(5003940100001)(47776003)(2201001)(50466002)(87936001)(5001860100001)(4001450100002)(36756003)(52956003)(5001920100001)(48376002)(92566002)(5001830100001)(7049001)(5001770100001)(189998001)(63266004)(62966003)(77156002)(4001540100001)(5007970100001)(81156007)(42186005)(46386002)(36386004)(107986001)(921003)(5001870100001)(90966001)(1121003); DIR:OUT; SFP:1101; SCL:1; SRVR:BY2FFO11HUB039; 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; BY2FFO11HUB039; 2:U+v6txJdQ9jOslEXUBo+8wqZzG8FzATddwaqwthoSM8sUEuk0zFnuUMr3xjkwkNzQ55NU0mL0WYySeC6X5YLAjFV06Xk11ZbMxALTTOO3hmSL+0DRK9vmFtvXv4XcP6DRYvgA5l5LHj8I1IBRqMRVnw4c9UJV8JZdLsckkxQikw=; 3:/dzYx8hiCYk4w8OC65AuH3heQWXAWhUyX4t+SEJs0zy8Pa/Y8jf2VWHBW5jk/3DaDIA9om4X+rY+VaBLDsZG/hyIQlbnh8/YmOkXzJdWYQdEdyuYu3kjDWtJFYNUgusSTZRDAAJ2xeQm57INHvixXBe//nDoeSu2Jz8hKWnCs790poQYz3z51ES4OO34sAgN6Tc0CcsioWfydmUIRCPjjvT3nqihCNIK9UlrZBpJsuF/oc+NsxQTj5KBmU1YszFsbbfkUiPE9x9ISnSyr3YXjQ==; 25:VFW8awrf8uusINsZOAa5zVJA5W55cxSw28ltEgrFLvviqW/TS8ejmRSKhtBAT6Hy5mkRC6KQ+cfHvNpAwIkyexuEMu7YAbC8gvsXsw0XTe903cfoQBR0QJX8Y6+OyFNnN68/n/kTZwW2PbDxanUW5hlqsoQMVfHek7LBxBJUgqQild1WV9TPJrYwA1i5NZF2RQsBDE3bPivUIxImCC6x8mPFt0ulAiSI14kdF6KF2hFl/Z1jcvYC89Qp1Jn2OwsWCas8eqphOthb+XCVOK931w== X-Microsoft-Antispam: UriScan:; BCL:0; PCL:0; RULEID:(8251501001); SRVR:BY2FFO11HUB039; X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11HUB039; 20:7MVkguVFlJXpfl124bomWMra5YcmB8IJY+USrii4Ir4v5mGk19EjVjYCffbqOdXK2uhvxzJB7JcurJCIsxe6yMG+rm+ax6FW/Na7gElmObm2MZAgDcKJRnjIuSmrr//lxJKp3i+vKOrb7IvPhA4NlYGYbh18yyiwTObQkDxbcMen4qav/oVUgHuxWCN3KVR4SXBKYW++dGZxO8pN0IKuXFdwfLz4UgOZAGJQjeJyO1EdMym6vMb2Km/mgzdeTf8yumq3r75GJpOmcX6sqTWHPCXPOuFXWNgrdqkHaRASGqGEMd3/oJaoqH6b4fG6NF0/dO+MhWnuNlwaxV8CB17Z/5jQ/xrFFRt2mgTPKpnZJMz2EttJ6qooCDJWOOqcsTDcfBwoMj5NVkSSCF4zfomCH0vkta+D53Szk4NAkbmnFb9k4/ACqhgdPdbYS9mkqIC3E652Wfq9xe9tYv2BwVu+gROF+WGP3lLh09u2r6prmwCEYBwJ0qmifh6i2H+36fAe; 4:WZdE/Jru2ML68pNNDHwZy/HG2lng0T+rQCLuSw7AVnb2NZ4GI/2EVP9RwWaKCvVDza4GAtRThbr7dEOOAi/WgKkZeGtBtH4vfVkCVZqujUjnGKvegyg6/poHqNMk7cv7/0Xa7HXe32LdQSR22Fzenm2es9ns0HXaco7fKRYPWIPJaemT+mDHj+LL2i6Q0p5XZUmywqQFx5GHmhuDnGsj4Px+L+S/L1EFF+eATV4Mroev6jO2yu2VhiviWbK2syEY/W6fwUIb+da+6jBzusrEuKJTaxScOTse+xGUBOYy0CmQYTYHJUbgez+1jbgxuzOMLnDbR3r/Dj9LMHDEKvWtsQ== X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(601004)(8121501046)(5005006)(3002001); SRVR:BY2FFO11HUB039; BCL:0; PCL:0; RULEID:; SRVR:BY2FFO11HUB039; X-Forefront-PRVS: 069255B8B8 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BY2FFO11HUB039; 23:xBNM+dUb67QXnviqBtXgZGQYrH5V30Q/WlEqcYyB?= =?us-ascii?Q?I/Z7poyUIlVsDCVEF6wU9HdWPw2y6iKySXxVnKALwP273cjaDTzPHbWUYiQA?= =?us-ascii?Q?5LiwFplXcTqqd0+N9RYOfRGUNWFMQ4DhyX7m3p8UZE8oW1jThq9lT9a1k0Zd?= =?us-ascii?Q?hx2dUZ0oMO5+XR+lIk4JVoZG2zf7BwyjNwq39QzAaTPu0SWIQkVfjMEY49/q?= =?us-ascii?Q?z8N1uEH1bmxgDSZ0XaOOM0OMPL0bouMAP3RWnw3eZ0BEE0r0F9XEwLQGmqZc?= =?us-ascii?Q?hOhDfVGi46+iUFbnC7pd7Xth57baYO+dY//BT+Z6zrkgq2Buv+WK2xQJIVVE?= =?us-ascii?Q?qZs0ymdYxUDP2ehLgogOYr9TVgw3sjC6oAFhbJMAlVmkC5qSRj36V7QK+Xa3?= =?us-ascii?Q?yuCRm1DUqB58wY1LIVntlQy6o/NLJJLz+cVCc0lFREkWunyGKTpzpK5eiQBu?= =?us-ascii?Q?uQyzjOYKUASn4ENnlFPKRdq496C9z/VCznXBTNdDT3DrCtelxgZck5nEkbCw?= =?us-ascii?Q?m9EMPnm0PvdZjylPCMrOHlckbzuH5dFjMQnEH+qm1Wvdss0MiM/uIt6k3Pus?= =?us-ascii?Q?wwwn9diO1W8pbr2kcpHAOsErltp/DgP9r6lsFA7FdoCWM/uJKXwnaNo/T1+G?= =?us-ascii?Q?SBqANP7RZ/CKjTVjhgYcRddeUGwD2atBroos38YV6OMkF1Iv8VX+hneIf4SG?= =?us-ascii?Q?ZSH6T7KARB06pZB3UrJGkqe7wfnAYfZYT4x+sLzL/I7rGH1UycF2isDdlRtM?= =?us-ascii?Q?k0WCHaeki2plxexhW43hvHu4sKNJvnXo9F0beM6teqrFXX0BV8EkxewqClvq?= =?us-ascii?Q?2CViDmKQE/ve1inaf5hr3U/Xjwyp4PjdpDj/kyDJ1g5aQUxao7HEa4X/RYmd?= =?us-ascii?Q?GWBWWc+SqsQbNYOQFA9jy9ILgf7He2+OhG/NzH/NdZX84+80eTOdCqCxiKUi?= =?us-ascii?Q?rODW4vGL1zI5w1HqDcUrRgT751r0nNEN24k4pip26AWjeBvfKQUmltKQLyrE?= =?us-ascii?Q?ZxPRY7PQ5Q3T7GHK8jPlWOUpCFhV1iscJefnhEC7QkULKBQdJXpG12HyGJnb?= =?us-ascii?Q?z6IBo4VC+nX2vn66Vn/xKlierXv38J6V3FndgZqvNRciv28nSWwCxM4KUjZw?= =?us-ascii?Q?504TCE4GzHw/01SIOx9c6gBGFiFlMGjsKI0euNFlWB9TwyObEYfI2IUOADQr?= =?us-ascii?Q?R0oBECQzZ9ZfVgZHUhrOaN+4V2oF4atPwL65BWW2k0FdU5NAR/Drx6tmyJlU?= =?us-ascii?Q?v/QP7Tsrwrk9g4hjLYFKCvsM3ChD72KAvh9x+5w/CPdDFdEoPJqdnbx4wEza?= =?us-ascii?Q?9bUpTeuoKG2BpqiaoEMj74M=3D?= X-Microsoft-Exchange-Diagnostics: 1; BY2FFO11HUB039; 5:oicFxHnG1pZpOlt2/LhT1IMhfWPe+wNFrlBAStI4ux9I6Jrw+5xGgt9iAfvhhdY8FtMimKlZg7DqSBlciqJa7vIY2QyyUv9fkEIk8qNTwAroz/hFEV/FqODv6N9yi1GU1TfNgSdT5NdNRJc4nrHgXA==; 24:qgjwzuafMYH1rwITwgzUuQ6k+5mrdf3NbgcCFQRY2IAOu9kHr69Yolg+2gRIi2V89GwVfrW64TtbItkV+exvlzio7Gf0QEeXlDH4h1F7Pjw= SpamDiagnosticOutput: 1:23 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Sep 2015 12:33:13.1156 (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: BY2FFO11HUB039 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: Kedareswara rao Appana --- Changes in v6: - None. 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..8b366ce --- /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"; +} ;