xref: /freebsd/sys/contrib/device-tree/Bindings/dma/owl-dma.txt (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1* Actions Semi Owl SoCs DMA controller
2
3This binding follows the generic DMA bindings defined in dma.txt.
4
5Required properties:
6- compatible: Should be "actions,s900-dma".
7- reg: Should contain DMA registers location and length.
8- interrupts: Should contain 4 interrupts shared by all channel.
9- #dma-cells: Must be <1>. Used to represent the number of integer
10              cells in the dmas property of client device.
11- dma-channels: Physical channels supported.
12- dma-requests: Number of DMA request signals supported by the controller.
13                Refer to Documentation/devicetree/bindings/dma/dma.txt
14- clocks: Phandle and Specifier of the clock feeding the DMA controller.
15
16Example:
17
18Controller:
19                dma: dma-controller@e0260000 {
20                        compatible = "actions,s900-dma";
21                        reg = <0x0 0xe0260000 0x0 0x1000>;
22                        interrupts = <GIC_SPI 57 IRQ_TYPE_LEVEL_HIGH>,
23                                     <GIC_SPI 58 IRQ_TYPE_LEVEL_HIGH>,
24                                     <GIC_SPI 59 IRQ_TYPE_LEVEL_HIGH>,
25                                     <GIC_SPI 60 IRQ_TYPE_LEVEL_HIGH>;
26                        #dma-cells = <1>;
27                        dma-channels = <12>;
28                        dma-requests = <46>;
29                        clocks = <&clock CLK_DMAC>;
30                };
31
32Client:
33
34DMA clients connected to the Actions Semi Owl SoCs DMA controller must
35use the format described in the dma.txt file, using a two-cell specifier
36for each channel.
37
38The two cells in order are:
391. A phandle pointing to the DMA controller.
402. The channel id.
41
42uart5: serial@e012a000 {
43        ...
44        dma-names = "tx", "rx";
45        dmas = <&dma 26>, <&dma 27>;
46        ...
47};
48