From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753399AbbFHRMM (ORCPT ); Mon, 8 Jun 2015 13:12:12 -0400 Received: from mail-bn1on0092.outbound.protection.outlook.com ([157.56.110.92]:34209 "EHLO na01-bn1-obe.outbound.protection.outlook.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1753077AbbFHRME (ORCPT ); Mon, 8 Jun 2015 13:12:04 -0400 Authentication-Results: spf=pass (sender IP is 149.199.60.83) smtp.mailfrom=xilinx.com; vger.kernel.org; dkim=none (message not signed) header.d=none; From: Punnaiah Choudary Kalluri To: , , , , , , , , CC: , , , , , , "Punnaiah Choudary Kalluri" Subject: [PATCH 1/2] Documentation: dt: Add Xilinx zynqmp dma device tree binding documentation Date: Mon, 8 Jun 2015 22:27:07 +0530 Message-ID: <1433782628-23748-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-21600.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1;BY2FFO11FD010;1:VyTCqFur3QHY+tjVS4SxG6wvLNNvxbLR+IHGF/Kv+VmVFTysDyqPxAn6bHnMTDq+zdXnDqj1T3jpdgd9HS8+4Ou1chfiuKJ3eN+7VrHzhrWjaxtNttELHAxfp3JtjMYCK+/+1dmu9/N9Zn2Ag9VjgRWlmQc3QMEtKCKYmtT05lZH+356EkSXtzyxDaku4wvewM+0qGhuZzIjyiCWv2RPr2O5lkWE6kjIhyDN+S7iroyu7h9vGCnKloqIVPhov/b2ibNHthS2CJCiz/MwwVFu3ZtIuv1u6gQf4ier0PDwE+MfqedbP0dggC8elEveHTCTC2dooPGv+VLxTX0sQstsNw== X-Forefront-Antispam-Report: CIP:149.199.60.83;CTRY:US;IPV:NLI;EFV:NLI;SFV:NSPM;SFS:(10009020)(6009001)(438002)(199003)(189002)(46102003)(50986999)(5001770100001)(36386004)(36756003)(107886002)(5001960100002)(189998001)(77156002)(62966003)(45336002)(50226001)(551934003)(92566002)(46386002)(19580405001)(52956003)(86362001)(6806004)(48376002)(47776003)(229853001)(103686003)(42186005)(33646002)(19580395003)(87936001)(2201001)(50466002)(63266004)(107986001)(4001430100001)(90966001);DIR:OUT;SFP:1101;SCL:1;SRVR:BY2FFO11HUB015;H:xsj-pvapsmtpgw01;FPR:;SPF:Pass;MLV:sfv;A:1;MX:1;LANG:en; MIME-Version: 1.0 Content-Type: text/plain X-Microsoft-Exchange-Diagnostics: 1;BY2FFO11HUB015;2:hbWBFmajvcO84hEOGTMMnIEvmnnYUcFVVJbmr59iyFGC/sp3LjVCKjAdJeS/qlxh;2:Uxe+6o+0HHacUkMF24440Rn4OVUT2Ae195lBrT0DqoPAOuTecx9j2eZ1OZPSVR5KRFe+xl3q16nsrWrHZ72fDEr3CxCcpm3b+hrKIUFUl7AMqfMdCdACQaZr+A1AjDj5xqY6t3EMso3PbdvHpWUmGL9qBNtrCoeXh4DwG6J4wo5K/IJ0EwodkUKG7gdgEBLxTJFVIoKsaKaMCw5eCku6yRC0TTfSF/DdlcX+amS/qzA=;6:xvgq8uwIise5yqUKiiLAkh9vPKpav0yCkUnk6GZFpbPtnjkC3EURCfO65GWDqZ5bLWfSh6sxbRGp1GIGQioYYuVe+RTGQUVd57qhODGWKWkgqPpc6PD5K8gSkRg4VuhRrbz9v9UgF5fArgx8K2se0Ug/nbEj/saAXRWC0LWJTwRJNpEU10fI0bso8OKmUdCUtJvH8Jmp2XyV7odqO4jEbniKBnNv0MDCwJIpmwhXf/L25Kri7O746GjYycdIrZ/q9kUZMNfBrwcG6NkOauYRiA+EJna3kcjbaWhMlGXtGkr7JEdpA2pKdn40JA6KBsVwy2q2FehNRUcuBwyD3uDguOjgF8VlZ6XO1e43YnVvgn6/vUXJ/bapGFd5lHAx25TycA0rrkAmOmQ9/YjTC+oRCrlKGZ6qxtXToNQnifTuxWfi8Z6peTZQlZUiAdh3PfJtZmbar5CANVh1RglxdxeGQVAgP4TGqbHImRoWQHoCGChVhLaObvfiptZ29F720Jsr X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BY2FFO11HUB015; X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-Exchange-Antispam-Report-CFA-Test: BCL:0;PCL:0;RULEID:(601004)(520003)(5005006)(3002001);SRVR:BY2FFO11HUB015;BCL:0;PCL:0;RULEID:;SRVR:BY2FFO11HUB015; X-Microsoft-Exchange-Diagnostics: 1;BY2FFO11HUB015;3:d2dlMm8cnQmKU8lTtUbnGCBsuued3YqwW6trj5SJ9jkQ0XylbOGpoUGz+iu7608iMSIEBj1iVn2/Ug7Tk6HCMZ03LJlcXyD71Gt9XMczRsw1YP4N/NwO5HENssWVcEK+BfoiBnoISslFnl+X0obns09RAZerBfllsWaXwJOjTRCGJFl8gMC1TahSkV9yDUHhrJA4ewsk8qW/dB5RNSYARcu2tyHkr1tZB3wHyDvn2C5ggBBvKOrTRNoClF+zsgWK16eR+ScCgRGlc09AnZO2+lQJMhHmL0G1cKEteIh6+C7IKfQXsAM118cB7VG4UPkv X-Forefront-PRVS: 060166847D X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1;BY2FFO11HUB015;9:fmrN5a7nyYGPeubOssKECQeqZ8rGCYO5kygJnSmUD?= =?us-ascii?Q?4mUaaAfvzinvmDdoGsqYksZRu1brcJn+qeEjYsa4UGBDrucF6zyM1gvkjuLI?= =?us-ascii?Q?/7Iro2KqrYXpgF1ALkoyAIektliQ2fLOIfVIhO5E40J/fQps6KOUrgehxErN?= =?us-ascii?Q?K0XlTT6541YeQeNBIwP+P1zZ4ONX8nqdw0X4SDi0rT80zJAkH01hdT398pSz?= =?us-ascii?Q?PSrPXoXl5WHDsWlSGZwJQOQeOVnLOz3tfF0J0buaaAvAoIk961hS80UZBLoZ?= =?us-ascii?Q?Fh6X0n0glOSAvGdXeAfB0t9uDWShSb6/qdDINOowOhUFf2mRYLkto8yX2Waw?= =?us-ascii?Q?/pZq4Gnx9WjG0yt7gFFQ7jh5yVJaCigETHhZpDjPuhAS/k5IyZR6F7HWbl2e?= =?us-ascii?Q?zDUsv0PzweVsoRV5rGu+s49CZNAljgQefHzDh948FEW8IoJObS4Hi7VfMAKE?= =?us-ascii?Q?Qx6olSawGybRAHVOCkaXLV1YPdybiqpz5FgUB4OvqfmD0gwZF4jJgGUcBMqg?= =?us-ascii?Q?QlDBMGy2ag1x1w4MkRuIwDf0E9wY/g0kDOjM6BoOg/BcgKtlCyOqPVxOXzvL?= =?us-ascii?Q?Bjm8yFm975kYgiZUYv0zULhOg7utHo8hjiKN58HwyHKcBM8W3EnbXUU59hRS?= =?us-ascii?Q?F+IAmWKG9qCSCjt0Usa/7wsEGPQSDQB3N43ASbaFvdAnfXRiVFC3ZpuYQY9b?= =?us-ascii?Q?sQeHPmz0exVdpBNeWr3U/Zbsow3b8k4wm3Rezcol7OL6jZqzLwe71hAYAFnX?= =?us-ascii?Q?2dYe2rVPaEkj/fNxiJD6eI0wm/OxkCqnHFMuThQiQA0fQDKuVH241jd98yLW?= =?us-ascii?Q?ek5OqY7yBJeBYZ6pShdu6bhTfrWIIWvObzt1oxAzIrlLB95G3aO4t8w1hSD4?= =?us-ascii?Q?cRbVXMO6Eh8YrciM4/uIFRBcEsE4Ajgp9O/Bv8UKvjynPnFpsxUlaKq+KH7B?= =?us-ascii?Q?Y/pTN8vdxm5djyHMf0Wc4FV2onD5FRCmgoKaPUQZw=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1;BY2FFO11HUB015;3:zgTqrW4wqgLhzCpSkwb8FUTLA+qGUvbFl4aKO+A3Vax52UIq/k5HindLJC1ztoIfFtQqOGQ6xBOiHbKwQkH+5gEGI0CsHoxFDdeLdlCBZFw069kSkWbDjx82D5kZpEpp30xmz444HgI2quKbx0QeiA==;10:aQiWO93HEIp1R0GlFkq7+0miMa0FD8d/5Pb0AP8q6bfTmGtt2an0Y6VAlsCzH5Rbk0T20GGhuQm/JqVHbhMRmgXMb4scaujkzgSUpdeENrI= X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 08 Jun 2015 16:57:22.7231 (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.83];Helo=[xsj-pvapsmtpgw01] X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY2FFO11HUB015 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Device-tree binding documentation for Xilinx zynqmp dma engine used in Zynq UltraScale+ MPSoC. Signed-off-by: Punnaiah Choudary Kalluri --- .../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>; +}; -- 1.7.4