Merge tag 'tegra-for-4.8-i2c' of git://git.kernel.org/pub/scm/linux/kernel/git/tegra...
[cascardo/linux.git] / Documentation / devicetree / bindings / dma / sun6i-dma.txt
1 Allwinner A31 DMA Controller
2
3 This driver follows the generic DMA bindings defined in dma.txt.
4
5 Required properties:
6
7 - compatible:   Must be one of
8                   "allwinner,sun6i-a31-dma"
9                   "allwinner,sun8i-a23-dma"
10                   "allwinner,sun8i-a83t-dma"
11                   "allwinner,sun8i-h3-dma"
12 - reg:          Should contain the registers base address and length
13 - interrupts:   Should contain a reference to the interrupt used by this device
14 - clocks:       Should contain a reference to the parent AHB clock
15 - resets:       Should contain a reference to the reset controller asserting
16                 this device in reset
17 - #dma-cells :  Should be 1, a single cell holding a line request number
18
19 Example:
20         dma: dma-controller@01c02000 {
21                 compatible = "allwinner,sun6i-a31-dma";
22                 reg = <0x01c02000 0x1000>;
23                 interrupts = <0 50 4>;
24                 clocks = <&ahb1_gates 6>;
25                 resets = <&ahb1_rst 6>;
26                 #dma-cells = <1>;
27         };
28
29 Clients:
30
31 DMA clients connected to the A31 DMA controller must use the format
32 described in the dma.txt file, using a two-cell specifier for each
33 channel: a phandle plus one integer cells.
34 The two cells in order are:
35
36 1. A phandle pointing to the DMA controller.
37 2. The port ID as specified in the datasheet
38
39 Example:
40 spi2: spi@01c6a000 {
41         compatible = "allwinner,sun6i-a31-spi";
42         reg = <0x01c6a000 0x1000>;
43         interrupts = <0 67 4>;
44         clocks = <&ahb1_gates 22>, <&spi2_clk>;
45         clock-names = "ahb", "mod";
46         dmas = <&dma 25>, <&dma 25>;
47         dma-names = "rx", "tx";
48         resets = <&ahb1_rst 22>;
49 };