From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1751651AbbIGMtF (ORCPT ); Mon, 7 Sep 2015 08:49:05 -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 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; 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 Content-Type: text/plain 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: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@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"; +} ; -- 2.1.2