xref: /linux/Documentation/devicetree/bindings/dma/renesas,nbpfaxi.txt (revision 14c2a7b934e43527e38adc40cb9466811baaf8a9)
194c7b6fcSGuennadi Liakhovetski* Renesas "Type-AXI" NBPFAXI* DMA controllers
294c7b6fcSGuennadi Liakhovetski
394c7b6fcSGuennadi Liakhovetski* DMA controller
494c7b6fcSGuennadi Liakhovetski
594c7b6fcSGuennadi LiakhovetskiRequired properties
694c7b6fcSGuennadi Liakhovetski
794c7b6fcSGuennadi Liakhovetski- compatible:	must be one of
894c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac1b4"
994c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac1b8"
1094c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac1b16"
1194c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac4b4"
1294c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac4b8"
1394c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac4b16"
1494c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac8b4"
1594c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac8b8"
1694c7b6fcSGuennadi Liakhovetski		"renesas,nbpfaxi64dmac8b16"
1794c7b6fcSGuennadi Liakhovetski- #dma-cells:	must be 2: the first integer is a terminal number, to which this
1894c7b6fcSGuennadi Liakhovetski		slave is connected, the second one is flags. Flags is a bitmask
1994c7b6fcSGuennadi Liakhovetski		with the following bits defined:
2094c7b6fcSGuennadi Liakhovetski
2194c7b6fcSGuennadi Liakhovetski#define NBPF_SLAVE_RQ_HIGH	1
2294c7b6fcSGuennadi Liakhovetski#define NBPF_SLAVE_RQ_LOW	2
2394c7b6fcSGuennadi Liakhovetski#define NBPF_SLAVE_RQ_LEVEL	4
2494c7b6fcSGuennadi Liakhovetski
2594c7b6fcSGuennadi LiakhovetskiOptional properties:
26*9a1a34f3SNiklas Cassel- max-burst-mem-read:	limit burst size for memory reads
27*9a1a34f3SNiklas Cassel  (DMA_MEM_TO_MEM/DMA_MEM_TO_DEV) to this value, specified in bytes, rather
28*9a1a34f3SNiklas Cassel  than using the maximum burst size allowed by the hardware's buffer size.
29*9a1a34f3SNiklas Cassel- max-burst-mem-write:	limit burst size for memory writes
30*9a1a34f3SNiklas Cassel  (DMA_DEV_TO_MEM/DMA_MEM_TO_MEM) to this value, specified in bytes, rather
31*9a1a34f3SNiklas Cassel  than using the maximum burst size allowed by the hardware's buffer size.
32*9a1a34f3SNiklas Cassel  If both max-burst-mem-read and max-burst-mem-write are set, DMA_MEM_TO_MEM
33*9a1a34f3SNiklas Cassel  will use the lower value.
3494c7b6fcSGuennadi Liakhovetski
3594c7b6fcSGuennadi LiakhovetskiYou can use dma-channels and dma-requests as described in dma.txt, although they
3694c7b6fcSGuennadi Liakhovetskiwon't be used, this information is derived from the compatibility string.
3794c7b6fcSGuennadi Liakhovetski
3894c7b6fcSGuennadi LiakhovetskiExample:
3994c7b6fcSGuennadi Liakhovetski
4094c7b6fcSGuennadi Liakhovetski	dma: dma-controller@48000000 {
4194c7b6fcSGuennadi Liakhovetski		compatible = "renesas,nbpfaxi64dmac8b4";
4294c7b6fcSGuennadi Liakhovetski		reg = <0x48000000 0x400>;
4394c7b6fcSGuennadi Liakhovetski		interrupts = <0 12 0x4
4494c7b6fcSGuennadi Liakhovetski			      0 13 0x4
4594c7b6fcSGuennadi Liakhovetski			      0 14 0x4
4694c7b6fcSGuennadi Liakhovetski			      0 15 0x4
4794c7b6fcSGuennadi Liakhovetski			      0 16 0x4
4894c7b6fcSGuennadi Liakhovetski			      0 17 0x4
4994c7b6fcSGuennadi Liakhovetski			      0 18 0x4
5094c7b6fcSGuennadi Liakhovetski			      0 19 0x4>;
5194c7b6fcSGuennadi Liakhovetski		#dma-cells = <2>;
5294c7b6fcSGuennadi Liakhovetski		dma-channels = <8>;
5394c7b6fcSGuennadi Liakhovetski		dma-requests = <8>;
5494c7b6fcSGuennadi Liakhovetski	};
5594c7b6fcSGuennadi Liakhovetski
5694c7b6fcSGuennadi Liakhovetski* DMA client
5794c7b6fcSGuennadi Liakhovetski
5894c7b6fcSGuennadi LiakhovetskiRequired properties:
5994c7b6fcSGuennadi Liakhovetski
6094c7b6fcSGuennadi Liakhovetskidmas and dma-names are required, as described in dma.txt.
6194c7b6fcSGuennadi Liakhovetski
6294c7b6fcSGuennadi LiakhovetskiExample:
6394c7b6fcSGuennadi Liakhovetski
6494c7b6fcSGuennadi Liakhovetski#include <dt-bindings/dma/nbpfaxi.h>
6594c7b6fcSGuennadi Liakhovetski
6694c7b6fcSGuennadi Liakhovetski...
6794c7b6fcSGuennadi Liakhovetski		dmas = <&dma 0 (NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL)
6894c7b6fcSGuennadi Liakhovetski			&dma 1 (NBPF_SLAVE_RQ_HIGH | NBPF_SLAVE_RQ_LEVEL)>;
6994c7b6fcSGuennadi Liakhovetski		dma-names = "rx", "tx";
70