Merge branch 'for-linus' of git://git.kernel.org/pub/scm/linux/kernel/git/dtor/input
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mmc / renesas,mmcif.txt
1 * Renesas Multi Media Card Interface (MMCIF) Controller
2
3 This file documents differences between the core properties in mmc.txt
4 and the properties used by the MMCIF device.
5
6
7 Required properties:
8
9 - compatible: should be "renesas,mmcif-<soctype>", "renesas,sh-mmcif" as a
10   fallback. Examples with <soctype> are:
11         - "renesas,mmcif-r7s72100" for the MMCIF found in r7s72100 SoCs
12         - "renesas,mmcif-r8a73a4" for the MMCIF found in r8a73a4 SoCs
13         - "renesas,mmcif-r8a7740" for the MMCIF found in r8a7740 SoCs
14         - "renesas,mmcif-r8a7778" for the MMCIF found in r8a7778 SoCs
15         - "renesas,mmcif-r8a7790" for the MMCIF found in r8a7790 SoCs
16         - "renesas,mmcif-r8a7791" for the MMCIF found in r8a7791 SoCs
17         - "renesas,mmcif-r8a7793" for the MMCIF found in r8a7793 SoCs
18         - "renesas,mmcif-r8a7794" for the MMCIF found in r8a7794 SoCs
19         - "renesas,mmcif-sh73a0" for the MMCIF found in sh73a0 SoCs
20
21 - interrupts: Some SoCs have only 1 shared interrupt, while others have either
22   2 or 3 individual interrupts (error, int, card detect). Below is the number
23   of interrupts for each SoC:
24     1: r8a73a4, r8a7778, r8a7790, r8a7791, r8a7793, r8a7794
25     2: r8a7740, sh73a0
26     3: r7s72100
27
28 - clocks: reference to the functional clock
29
30 - dmas: reference to the DMA channels, one per channel name listed in the
31   dma-names property.
32 - dma-names: must contain "tx" for the transmit DMA channel and "rx" for the
33   receive DMA channel.
34 - max-frequency: Maximum operating clock frequency, driver uses default clock
35   frequency if it is not set.
36
37
38 Example: R8A7790 (R-Car H2) MMCIF0
39
40         mmcif0: mmc@ee200000 {
41                 compatible = "renesas,mmcif-r8a7790", "renesas,sh-mmcif";
42                 reg = <0 0xee200000 0 0x80>;
43                 interrupts = <0 169 IRQ_TYPE_LEVEL_HIGH>;
44                 clocks = <&mstp3_clks R8A7790_CLK_MMCIF0>;
45                 dmas = <&dmac0 0xd1>, <&dmac0 0xd2>;
46                 dma-names = "tx", "rx";
47                 max-frequency = <97500000>;
48         };