[deliverable/linux.git] / Documentation / devicetree / bindings / dma / arm-pl330.txt

* ARM PrimeCell PL330 DMA Controller

The ARM PrimeCell PL330 DMA controller can move blocks of memory contents
between memory and peripherals or memory to memory.

Required properties:
  - compatible: should include both "arm,pl330" and "arm,primecell".
  - reg: physical base address of the controller and length of memory mapped
    region.
  - interrupts: interrupt number to the cpu.

Optional properties:
- dma-coherent      : Present if dma operations are coherent

Example:

	pdma0: pdma@12680000 {
		compatible = "arm,pl330", "arm,primecell";
		reg = <0x12680000 0x1000>;
		interrupts = <99>;
	};

Client drivers (device nodes requiring dma transfers from dev-to-mem or
mem-to-dev) should specify the DMA channel numbers using a two-value pair
as shown below.

  [property name]  = <[phandle of the dma controller] [dma request id]>;

      where 'dma request id' is the dma request number which is connected
      to the client controller. The 'property name' is recommended to be
      of the form <name>-dma-channel.

  Example:  tx-dma-channel = <&pdma0 12>;
Commit	Line	Data
93ed5544 TA	1	* ARM PrimeCell PL330 DMA Controller
	2
	3	The ARM PrimeCell PL330 DMA controller can move blocks of memory contents
	4	between memory and peripherals or memory to memory.
	5
	6	Required properties:
	7	- compatible: should include both "arm,pl330" and "arm,primecell".
	8	- reg: physical base address of the controller and length of memory mapped
	9	region.
	10	- interrupts: interrupt number to the cpu.
	11
1dc737c4 RH	12	Optional properties:
	13	- dma-coherent : Present if dma operations are coherent
	14
93ed5544 TA	15	Example:
	16
	17	pdma0: pdma@12680000 {
	18	compatible = "arm,pl330", "arm,primecell";
	19	reg = <0x12680000 0x1000>;
	20	interrupts = <99>;
	21	};
	22
	23	Client drivers (device nodes requiring dma transfers from dev-to-mem or
	24	mem-to-dev) should specify the DMA channel numbers using a two-value pair
	25	as shown below.
	26
	27	[property name] = <[phandle of the dma controller] [dma request id]>;
	28
	29	where 'dma request id' is the dma request number which is connected
	30	to the client controller. The 'property name' is recommended to be
	31	of the form <name>-dma-channel.
	32
	33	Example: tx-dma-channel = <&pdma0 12>;