xref: /freebsd/sys/contrib/device-tree/Bindings/dma/moxa,moxart-dma.txt (revision b97ee269eae3cbaf35c18f51a459aea581c2a7dc)
1c66ec88fSEmmanuel VadotMOXA ART DMA Controller
2c66ec88fSEmmanuel Vadot
3c66ec88fSEmmanuel VadotSee dma.txt first
4c66ec88fSEmmanuel Vadot
5c66ec88fSEmmanuel VadotRequired properties:
6c66ec88fSEmmanuel Vadot
7c66ec88fSEmmanuel Vadot- compatible :	Must be "moxa,moxart-dma"
8c66ec88fSEmmanuel Vadot- reg :		Should contain registers location and length
9c66ec88fSEmmanuel Vadot- interrupts :	Should contain an interrupt-specifier for the sole
10c66ec88fSEmmanuel Vadot		interrupt generated by the device
11c66ec88fSEmmanuel Vadot- #dma-cells :	Should be 1, a single cell holding a line request number
12c66ec88fSEmmanuel Vadot
13c66ec88fSEmmanuel VadotExample:
14c66ec88fSEmmanuel Vadot
15c66ec88fSEmmanuel Vadot	dma: dma@90500000 {
16c66ec88fSEmmanuel Vadot		compatible = "moxa,moxart-dma";
17c66ec88fSEmmanuel Vadot		reg = <0x90500080 0x40>;
18c66ec88fSEmmanuel Vadot		interrupts = <24 0>;
19c66ec88fSEmmanuel Vadot		#dma-cells = <1>;
20c66ec88fSEmmanuel Vadot	};
21c66ec88fSEmmanuel Vadot
22c66ec88fSEmmanuel Vadot
23c66ec88fSEmmanuel VadotClients:
24c66ec88fSEmmanuel Vadot
25c66ec88fSEmmanuel VadotDMA clients connected to the MOXA ART DMA controller must use the format
26c66ec88fSEmmanuel Vadotdescribed in the dma.txt file, using a two-cell specifier for each channel:
27c66ec88fSEmmanuel Vadota phandle plus one integer cells.
28c66ec88fSEmmanuel VadotThe two cells in order are:
29c66ec88fSEmmanuel Vadot
30c66ec88fSEmmanuel Vadot1. A phandle pointing to the DMA controller.
31c66ec88fSEmmanuel Vadot2. Peripheral identifier for the hardware handshaking interface.
32c66ec88fSEmmanuel Vadot
33c66ec88fSEmmanuel VadotExample:
34c66ec88fSEmmanuel VadotUse specific request line passing from dma
35c66ec88fSEmmanuel VadotFor example, MMC request line is 5
36c66ec88fSEmmanuel Vadot
37*b97ee269SEmmanuel Vadot	mmc: mmc@98e00000 {
38*b97ee269SEmmanuel Vadot		compatible = "moxa,moxart-mmc";
39c66ec88fSEmmanuel Vadot		reg = <0x98e00000 0x5C>;
40c66ec88fSEmmanuel Vadot		interrupts = <5 0>;
41c66ec88fSEmmanuel Vadot		clocks = <&clk_apb>;
42c66ec88fSEmmanuel Vadot		dmas =  <&dma 5>,
43c66ec88fSEmmanuel Vadot			<&dma 5>;
44c66ec88fSEmmanuel Vadot		dma-names = "tx", "rx";
45c66ec88fSEmmanuel Vadot	};
46