From patchwork Fri Apr 26 06:26:16 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Guennadi Liakhovetski X-Patchwork-Id: 2490981 Return-Path: X-Original-To: patchwork-linux-sh@patchwork.kernel.org Delivered-To: patchwork-process-083081@patchwork1.kernel.org Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by patchwork1.kernel.org (Postfix) with ESMTP id 807D43FC64 for ; Fri, 26 Apr 2013 06:26:38 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758707Ab3DZG0W (ORCPT ); Fri, 26 Apr 2013 02:26:22 -0400 Received: from moutng.kundenserver.de ([212.227.126.186]:50588 "EHLO moutng.kundenserver.de" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1758537Ab3DZG0U (ORCPT ); Fri, 26 Apr 2013 02:26:20 -0400 Received: from axis700.grange (dslb-088-076-028-093.pools.arcor-ip.net [88.76.28.93]) by mrelayeu.kundenserver.de (node=mreu0) with ESMTP (Nemesis) id 0MCdVO-1UMISB0Jec-009Ouz; Fri, 26 Apr 2013 08:26:17 +0200 Received: by axis700.grange (Postfix, from userid 1000) id 6F83740BB4; Fri, 26 Apr 2013 08:26:16 +0200 (CEST) Received: from localhost (localhost [127.0.0.1]) by axis700.grange (Postfix) with ESMTP id 64A7C40BB3; Fri, 26 Apr 2013 08:26:16 +0200 (CEST) Date: Fri, 26 Apr 2013 08:26:16 +0200 (CEST) From: Guennadi Liakhovetski X-X-Sender: lyakh@axis700.grange To: devicetree-discuss@lists.ozlabs.org cc: Arnd Bergmann , Vinod Koul , linux-sh@vger.kernel.org, Magnus Damm , linux-kernel@vger.kernel.org Subject: [PATCH 7/6] DMA: shdma: add DT binding documentation Message-ID: MIME-Version: 1.0 X-Provags-ID: V02:K0:ihI007l5n+rjR+f+hpWG6osLJNWMoQ7UvgMSznTb0UM 4+1jGoxhLXNkpkW6qdXgJdK1bMnkz5n1Cs192LF5VB9ttF2eil 18UfFXYWFNHsVF9vx66AICkXEnKeF4FAOqn8IV1v5DzZeq2g+z +MQUGiP7+OjsO+dVv/i5WcV/LSwVSQ08bO1Bq6iPiElD1Ef4lk 5RSM9ExcL8FXu1gM+TRu0j5rl2QT+NnKGFRLuexbjL5RRg7bWN Gl9JWv0e8shEo9fxS26qUBf6c/wTQ3md3YF5tjt/j4vDDQ4UC+ OqY8yy5aJgkK/FVjRh76t5tSrsI5ZlU/rgJBNPYE0FaDi0+wkg ekhvigFupIaboYcp0xhiqeASpDpLsaExYTatpPuIooFF3w70d5 PtUFSt2q0iXZg== Sender: linux-sh-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-sh@vger.kernel.org SHDMA uses only standard DMA Device Tree bindings. This patch adds documentation, exactly describing the use of the bindings and providing examples. Signed-off-by: Guennadi Liakhovetski Acked-by: Arnd Bergmann --- This patch adds the missing documentation to the patch series "DMA: shdma: add Device Tree support" http://thread.gmane.org/gmane.linux.ports.sh.devel/21972 Arnd, Vinod, I hope, now this series can be applied :) Documentation/devicetree/bindings/dma/shdma.txt | 61 +++++++++++++++++++++++ 1 files changed, 61 insertions(+), 0 deletions(-) create mode 100644 Documentation/devicetree/bindings/dma/shdma.txt diff --git a/Documentation/devicetree/bindings/dma/shdma.txt b/Documentation/devicetree/bindings/dma/shdma.txt new file mode 100644 index 0000000..f99618e --- /dev/null +++ b/Documentation/devicetree/bindings/dma/shdma.txt @@ -0,0 +1,61 @@ +* SHDMA Device Tree bindings + +Only generic DMA controller bindings are used for SHDMA DT nodes. + +* DMA controller + +Required properties: +- compatible: should be "renesas,shdma" +- #dma-cells: should be <1>, see "dmas" property below + +Optional properties (currently unused): +- dma-channels: number of DMA channels +- dma-requests: number of DMA request signals + +Example: + dma0: shdma@fe000020 { + compatible = "renesas,shdma"; + reg = <0xfe000020 0x89e0>; + interrupt-parent = <&gic>; + interrupts = <0 129 4 + 0 109 4 + 0 110 4 + 0 111 4 + 0 112 4 + 0 113 4 + 0 114 4 + 0 115 4 + 0 116 4 + 0 117 4 + 0 118 4 + 0 119 4 + 0 120 4 + 0 121 4 + 0 122 4 + 0 123 4 + 0 124 4 + 0 125 4 + 0 126 4 + 0 127 4 + 0 128 4>; + interrupt-names = "error", + "ch0", "ch1", "ch2", "ch3", + "ch4", "ch5", "ch6", "ch7", + "ch8", "ch9", "ch10", "ch11", + "ch12", "ch13", "ch14", "ch15", + "ch16", "ch17", "ch18", "ch19"; + #dma-cells = <1>; + dma-channels = <20>; + dma-requests = <256>; + }; + +* DMA client + +Required properties: +- dmas: a list of <[DMA controller phandle] [MID/RID value]> pairs +- dma-names: a list of DMA channel names, one per "dmas" entry + +Example: + dmas = <&dma0 0xd1 + &dma0 0xd2>; + dma-names = "tx", "rx";