tjh.dev
Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
dmaengine: st_fdma: Add STMicroelectronics FDMA DT binding documentation
This patch adds the DT binding documentation for the FDMA constroller
found on STi based chipsets from STMicroelectronics.
Signed-off-by: Ludovic Barre <ludovic.barre@st.com>
Signed-off-by: Peter Griffin <peter.griffin@linaro.org>
Acked-by: Rob Herring <robh@kernel.org>
Signed-off-by: Vinod Koul <vinod.koul@intel.com>
authored by
Peter Griffin
and committed by
Vinod Koul
897f419a
e41ddbc0
+87
+87
Documentation/devicetree/bindings/dma/st_fdma.txt
+87
Documentation/devicetree/bindings/dma/st_fdma.txt
···
1
+
* STMicroelectronics Flexible Direct Memory Access Device Tree bindings
2
+
3
+
The FDMA is a general-purpose direct memory access controller capable of
4
+
supporting 16 independent DMA channels. It accepts up to 32 DMA requests.
5
+
The FDMA is based on a Slim processor which requires a firmware.
6
+
7
+
* FDMA Controller
8
+
9
+
Required properties:
10
+
- compatible : Should be one of
11
+
- st,stih407-fdma-mpe31-11, "st,slim-rproc";
12
+
- st,stih407-fdma-mpe31-12, "st,slim-rproc";
13
+
- st,stih407-fdma-mpe31-13, "st,slim-rproc";
14
+
- reg : Should contain an entry for each name in reg-names
15
+
- reg-names : Must contain "slimcore", "dmem", "peripherals", "imem" entries
16
+
- interrupts : Should contain one interrupt shared by all channels
17
+
- dma-channels : Number of channels supported by the controller
18
+
- #dma-cells : Must be <3>. See DMA client section below
19
+
- clocks : Must contain an entry for each clock
20
+
See: Documentation/devicetree/bindings/clock/clock-bindings.txt
21
+
22
+
23
+
Example:
24
+
25
+
fdma0: dma-controller@8e20000 {
26
+
compatible = "st,stih407-fdma-mpe31-11", "st,slim-rproc";
27
+
reg = <0x8e20000 0x8000>,
28
+
<0x8e30000 0x3000>,
29
+
<0x8e37000 0x1000>,
30
+
<0x8e38000 0x8000>;
31
+
reg-names = "slimcore", "dmem", "peripherals", "imem";
32
+
clocks = <&clk_s_c0_flexgen CLK_FDMA>,
33
+
<&clk_s_c0_flexgen CLK_EXT2F_A9>,
34
+
<&clk_s_c0_flexgen CLK_EXT2F_A9>,
35
+
<&clk_s_c0_flexgen CLK_EXT2F_A9>;
36
+
interrupts = <GIC_SPI 5 IRQ_TYPE_NONE>;
37
+
dma-channels = <16>;
38
+
#dma-cells = <3>;
39
+
};
40
+
41
+
* DMA client
42
+
43
+
Required properties:
44
+
- dmas: Comma separated list of dma channel requests
45
+
- dma-names: Names of the aforementioned requested channels
46
+
47
+
Each dmas request consists of 4 cells:
48
+
1. A phandle pointing to the FDMA controller
49
+
2. The request line number
50
+
3. A 32bit mask specifying (see include/linux/platform_data/dma-st-fdma.h)
51
+
-bit 2-0: Holdoff value, dreq will be masked for
52
+
0x0: 0-0.5us
53
+
0x1: 0.5-1us
54
+
0x2: 1-1.5us
55
+
-bit 17: data swap
56
+
0x0: disabled
57
+
0x1: enabled
58
+
-bit 21: Increment Address
59
+
0x0: no address increment between transfers
60
+
0x1: increment address between transfers
61
+
-bit 22: 2 STBus Initiator Coprocessor interface
62
+
0x0: high priority port
63
+
0x1: low priority port
64
+
4. transfers type
65
+
0 free running
66
+
1 paced
67
+
68
+
Example:
69
+
70
+
sti_uni_player2: sti-uni-player@2 {
71
+
compatible = "st,sti-uni-player";
72
+
status = "disabled";
73
+
#sound-dai-cells = <0>;
74
+
st,syscfg = <&syscfg_core>;
75
+
clocks = <&clk_s_d0_flexgen CLK_PCM_2>;
76
+
assigned-clocks = <&clk_s_d0_flexgen CLK_PCM_2>;
77
+
assigned-clock-parents = <&clk_s_d0_quadfs 2>;
78
+
assigned-clock-rates = <50000000>;
79
+
reg = <0x8D82000 0x158>;
80
+
interrupts = <GIC_SPI 86 IRQ_TYPE_NONE>;
81
+
dmas = <&fdma0 4 0 1>;
82
+
dai-name = "Uni Player #1 (DAC)";
83
+
dma-names = "tx";
84
+
st,uniperiph-id = <2>;
85
+
st,version = <5>;
86
+
st,mode = "PCM";
87
+
};