From patchwork Mon Jun 15 14:36:21 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Punnaiah Choudary Kalluri X-Patchwork-Id: 6609901 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 EEC76C0020 for ; Mon, 15 Jun 2015 14:39:28 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id 1814E20462 for ; Mon, 15 Jun 2015 14:39:28 +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 1A810201FE for ; Mon, 15 Jun 2015 14:39:27 +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 1Z4VVY-0007p5-PW; Mon, 15 Jun 2015 14:37:04 +0000 Received: from mail-bn1on0061.outbound.protection.outlook.com ([157.56.110.61] helo=na01-bn1-obe.outbound.protection.outlook.com) by bombadil.infradead.org with esmtps (Exim 4.80.1 #2 (Red Hat Linux)) id 1Z4VVV-0007ip-Au for linux-arm-kernel@lists.infradead.org; Mon, 15 Jun 2015 14:37:02 +0000 Received: from BL2FFO11FD041.protection.gbl (10.173.160.31) by BL2FFO11HUB022.protection.gbl (10.173.161.46) with Microsoft SMTP Server (TLS) id 15.1.190.9; Mon, 15 Jun 2015 14:36:37 +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 BL2FFO11FD041.mail.protection.outlook.com (10.173.161.137) with Microsoft SMTP Server (TLS) id 15.1.190.9 via Frontend Transport; Mon, 15 Jun 2015 14:36:37 +0000 Received: from unknown-38-66.xilinx.com ([149.199.38.66]:37732 helo=xsj-pvapsmtp01) by xsj-pvapsmtpgw02 with esmtp (Exim 4.63) (envelope-from ) id 1Z4VV6-00008D-Mw; Mon, 15 Jun 2015 07:36:36 -0700 Received: from [127.0.0.1] (helo=localhost) by xsj-pvapsmtp01 with smtp (Exim 4.63) (envelope-from ) id 1Z4VV6-0002CZ-Gg; Mon, 15 Jun 2015 07:36:36 -0700 Received: from xsj-pvapsmtp01 (mailhub.xilinx.com [149.199.38.66]) by xsj-smtp-dlp2.xlnx.xilinx.com (8.13.8/8.13.1) with ESMTP id t5FEa42w005271; Mon, 15 Jun 2015 07:36:04 -0700 Received: from [172.23.64.208] (helo=xhdrdevl6.xilinx.com) by xsj-pvapsmtp01 with esmtp (Exim 4.63) (envelope-from ) id 1Z4VUu-0002Ad-Pa; Mon, 15 Jun 2015 07:36:25 -0700 Received: by xhdrdevl6.xilinx.com (Postfix, from userid 12826) id E242DEF8192; Mon, 15 Jun 2015 20:06:23 +0530 (IST) From: Punnaiah Choudary Kalluri To: , , , , , , , , Subject: [PATCH v2 1/2] Documentation: dt: Add Xilinx zynqmp dma device tree binding documentation Date: Mon, 15 Jun 2015 20:06:21 +0530 Message-ID: <1434378982-30184-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-21614.005 X-TM-AS-User-Approved-Sender: Yes;Yes X-EOPAttributedMessage: 0 X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11FD041; 1:FcqI5USkLuWzuTlNQDNqY2esIu1t2zBNr9xjKXoHAk38ut2pVgBgshIuIp2ApgdgCAD8BN72XrxDAWUl0W+RDOg3mVZt68iDj/PqEK1h/27ZZLJl4xn4nodvUH5Pd+NvCtV/0X6Ltlvy3bvoQsp9hy/7xzlIzzo2U1t7osUkgMWSHt+ENiPPwmEU0MsEb4Xk6vONWHac1hKJaBhxJ4J4ydYkXezSTY2u16w7uLFkUQTCqwGFJ+GgnN5hXYHW9FmfsKtUctUqahz787nvd7abP3wKZdb71rqXqQFmx/S+/OMG28lWiK72WeuQsWHwZ0UtOTMAVSNloD34voygZ8LZWSS1XQrAvH1/9Gzub4XfXus= X-Forefront-Antispam-Report: CIP:149.199.60.100; CTRY:US; IPV:NLI; EFV:NLI; SFV:NSPM; SFS:(10009020)(6009001)(438002)(189002)(199003)(87936001)(86362001)(106466001)(46386002)(42186005)(48376002)(47776003)(50466002)(50226001)(229853001)(107886002)(46102003)(45336002)(551934003)(103686003)(6806004)(62966003)(92566002)(33646002)(19580405001)(77156002)(63266004)(36756003)(189998001)(5001960100002)(52956003)(19580395003)(5001770100001)(2201001)(50986999)(107986001)(4001430100001)(90966001); DIR:OUT; SFP:1101; SCL:1; SRVR:BL2FFO11HUB022; H:xsj-pvapsmtpgw02; FPR:; SPF:Pass; MLV:sfv; MX:1; A:1; LANG:en; MIME-Version: 1.0 X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11HUB022; 2:VZIlHXX3Y4iwKwiP3xKe2pUSpL/Df9jpLm6DSQ9uIEoCY87qhrjZz9L5dj7KfoI6; 2:+SzQGgUnB4kwW162z8tbs97S9vskSk4ojUG1Q6KauEumvoYIuabF0utl8bSbUuwhyzn5kpResabJRDhy8vitd/+0Ji5ivtlwqLvgtdyhTfytE7hiGmtdHV6/dyjgLamj01q7OTBViocnmI72/YKWFLZGRtQuWBNbbHHjSi1HJ83T7jJReKiCNe7Fe+ftS21gjDkNo4Y+q2QEr8+3ULn63Y8g1KohynMo5bRX1iJvCdf1HI4L9LFUNVgEHtmKkw6K; 6:Xs83X8s9qQctpYiIFoGvQ8eq/dD2AcDf9HFKJt/updhbA2Gb9BDEI2B9NCnyi+EluIVX/9rtBFtLls7yIN+DU0/6v8okO2RzxCXCXd2YcyMdX/OXAyeU6h+yL4+hui/XlmoKKJp1JA9JSh8bCPGo0BM+eUJdxIbMkfN2NMhvHeCwTLkxSGyEjmuUfxd0A4ykJIkFfXOwsLP3lrpYYiP+DRSWKgLH/VBiRXiVUyvsz/WlXK1MtsDORqgpxx78R4TNqOkSyFWeOYO61ce59DUGrg9a6JkU589Uafp3k0mTkePWgmMfk6uW/AOczWb+qI7qaA/fEYGEJlnSxTm6EtIABturJI101Pp4qu3KEZOu5N6A8caHYRRu7NKa7y7Qj+ln+hnMJBlS2PxXWe3xd/NH1LpfVQk43ykBIq3HNjTKSCN9ebAFatRdY3Q6mgSBGL+g4Oc3GTPjX8srTtyR4NMmGpQGTAIY0slXaVi0+/M9/3ds2NGmEXRBhfB9yYiXh071 X-Microsoft-Antispam: UriScan:;BCL:0;PCL:0;RULEID:;SRVR:BL2FFO11HUB022; 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:BL2FFO11HUB022; BCL:0; PCL:0; RULEID:; SRVR:BL2FFO11HUB022; X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11HUB022; 3:wIBPkSreuXU1ugpP8TRQ89LVAJ2ktbrnDS/pJm6iWtmlsBPfqL1FP8WFlbfJoAS7D79uE5iM0QVAb+ST3FcyOy4BM4VsJLIAHgHpuPuLGVHU4lNc1Fw6RotNBW3wQlu4gcaSK3EuEF7wP8Yl6OFz09YPs5MwymtcN0/RdM/CWIckO5Mk+1FLQ4bR6Ks2XjVcdlNm7jdHT163n1bQvLvABfH0qXnZx59ehapbrMHMQ59gRjJpJGWNcVXY7HIhMlU1bDRbzfA6XonPMfTgc+q+f3AGGERqCLZSsE6Sku91QSeMU+c4VMB8UDpgFAbO99KK X-Forefront-PRVS: 0608DEDB67 X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BL2FFO11HUB022; 9:/ny8HKpdX1QOAfuAwdEQvrxWabLze1kWTtLAnF6Zq?= =?us-ascii?Q?peF3vpDD/vnu9r0qlUaL+JIsgVJKZXFQGV3ISmd8R8arTuSq/0nSOjh85Aj8?= =?us-ascii?Q?psufTA6naDFQ31MOy5obOIs2q7KOnAfT3M2Y1TkTr74ScGR+gA9ZbxNpuNn0?= =?us-ascii?Q?QRT02octiDQf+Y7nxipY7CWENcxpDh2D0TCNeJjwqohFqjQh8YkeCKjU6bG/?= =?us-ascii?Q?ZHSqbrUsD1jepoXDzzr+dmekedoX/wvcNrgZ5p44XkBydTzhu+B6bbDuaWkV?= =?us-ascii?Q?vDJYVfh2HFTJLdmg2wfHeL/aEK0niYd/c9Z+dnkmCzkpv2iUC8BigmOFvOuh?= =?us-ascii?Q?DVxrs0phacKcn8LYi9s46msGeh3nhU+Vas0+BImeBxmyLOhlD+GN4vlRECAM?= =?us-ascii?Q?9GckW2NOuPwOPge/SZJlNkbARqQ+calN1C2IRwENdBVyrASii+bxKmOXgpww?= =?us-ascii?Q?NM+0/Q6X79mEWWXo1csS0MO9HXXoN6O+wrg0z0FGSCR0KM9CrLRH+0PcIA+B?= =?us-ascii?Q?teryRBfmlCFNNcLgPMRjrC0YPjv3Ljjyna3ukUO27zjzcPnspaNKHEvhTE0E?= =?us-ascii?Q?IeNfxDD7b/7sFKie4ZNy66Lmual9pMVAFswo1bv7TOqNH/UQAhMGFiu1j9F1?= =?us-ascii?Q?QrvNj47aLE+vWFVG+6Cq3TLiWEk3OmBp56kPJtQ/d8cU7M5W1I7w7plpMTMe?= =?us-ascii?Q?5mC6oQozRljNFBPQEghZjItju4JlaUaFvixZiJvEq+jeCIr3wL9AgRcA9bfD?= =?us-ascii?Q?J+bJkO+6BnqZ3KbuO1lH3v13C+EegpPUDt+D+BLarOYEMXBjfCRfWlYdh+13?= =?us-ascii?Q?9q3DgweeKtSyORJMzuUF4QlsFi21h4yOmM+ZHk1rUnFlfjD6t4pQWaql/d27?= =?us-ascii?Q?VnfFfsSj13GyfaFyaB5muTGDjxzamvWkby2wH3+WuLv/fKblb/OcHX61sx+4?= =?us-ascii?Q?bdC6hR82c/21E1aIKnORNuLQYqmPfaAyd99IbQ5IA=3D=3D?= X-Microsoft-Exchange-Diagnostics: 1; BL2FFO11HUB022; 3:kqKbvc8jaEg4Vs1cIs7qESqfaOpj+7IJmJjlrQa0FVQ80UoFeL/bQ1bOnsH4V92bqWFDBxwbEDqhXKG5FWTOGA43tPLsARAv3tMj2Qz2v6jdU5rUMHPga91oSDKR+FYqwOnfp5AICkxX0f8WyZ8oow==; 10:nFQjUfrHUG1S+3KBZ/xapZW5cvZVN7PkzFMUf+IeX1c42lGpxOep/GrTJ5xfph3v4kePuZOOZORM5R8gKDuh+T6Qw3JiEjzXcmbMQf3sUnE= X-OriginatorOrg: xilinx.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 15 Jun 2015 14:36:37.5902 (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: BL2FFO11HUB022 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20150615_073701_619620_A0ED37C9 X-CRM114-Status: UNSURE ( 9.97 ) X-CRM114-Notice: Please train this message. X-Spam-Score: -0.0 (/) Cc: devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, kpc528@gmail.com, kalluripunnaiahchoudary@gmail.com, dmaengine@vger.kernel.org, Punnaiah Choudary Kalluri , linux-arm-kernel@lists.infradead.org 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.7 required=5.0 tests=BAD_ENC_HEADER,BAYES_00, RCVD_IN_DNSWL_MED, 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 for Xilinx zynqmp dma engine used in Zynq UltraScale+ MPSoC. Signed-off-by: Punnaiah Choudary Kalluri --- Changes in v2: - None --- .../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>; +};