[PATCH 7/6] DMA: shdma: add DT binding documentation

[PATCH 7/6] DMA: shdma: add DT binding documentation

[Guennadi Liakhovetski]

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 <g.liakhovetski+renesas@gmail.com>
---

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";
-- 
1.7.2.5

Re: [PATCH 7/6] DMA: shdma: add DT binding documentation

[Arnd Bergmann]

On Friday 26 April 2013, Guennadi Liakhovetski wrote:
> 
> 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 <g.liakhovetski+renesas@gmail.com>
> ---
> 
> 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

Acked-by: Arnd Bergmann <arnd@arndb.de>

Re: [PATCH 7/6] DMA: shdma: add DT binding documentation

[Vinod Koul]

On Fri, Apr 26, 2013 at 08:26:16AM +0200, Guennadi Liakhovetski wrote:
> 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 <g.liakhovetski+renesas@gmail.com>
> ---
> 
> 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 :)
Yes, but where is the rest of series. I got only the 7th of 6 (huh)...

Can you please resend entire one...

--
~Vinod

Re: [PATCH 7/6] DMA: shdma: add DT binding documentation

[Guennadi Liakhovetski]

On Tue, 30 Apr 2013, Vinod Koul wrote:

> On Fri, Apr 26, 2013 at 08:26:16AM +0200, Guennadi Liakhovetski wrote:
> > 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 <g.liakhovetski+renesas@gmail.com>
> > ---
> > 
> > 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 :)
> Yes, but where is the rest of series. I got only the 7th of 6 (huh)...
> 
> Can you please resend entire one...

You were CCed on it and you even commented to it, asking Arnd to review... 
But sure, np, I'll re-send them to you privately again.

Thanks
Guennadi
---
Guennadi Liakhovetski, Ph.D.
Freelance Open-Source Software Developer
http://www.open-technology.de/