634bb66fc49c59011306beae12f49f65f5064e7e
[muen/linux.git] / Documentation / devicetree / bindings / mmc / tmio_mmc.txt
1 * Toshiba Mobile IO SD/MMC controller
2
3 The tmio-mmc driver doesn't probe its devices actively, instead its binding to
4 devices is managed by either MFD drivers or by the sh_mobile_sdhi platform
5 driver. Those drivers supply the tmio-mmc driver with platform data, that either
6 describe hardware capabilities, known to them, or are obtained by them from
7 their own platform data or from their DT information. In the latter case all
8 compulsory and any optional properties, common to all SD/MMC drivers, as
9 described in mmc.txt, can be used. Additionally the following tmio_mmc-specific
10 optional bindings can be used.
11
12 Required properties:
13 - compatible: should contain one or more of the following:
14                 "renesas,sdhi-sh73a0" - SDHI IP on SH73A0 SoC
15                 "renesas,sdhi-r7s72100" - SDHI IP on R7S72100 SoC
16                 "renesas,sdhi-r8a73a4" - SDHI IP on R8A73A4 SoC
17                 "renesas,sdhi-r8a7740" - SDHI IP on R8A7740 SoC
18                 "renesas,sdhi-r8a7743" - SDHI IP on R8A7743 SoC
19                 "renesas,sdhi-r8a7745" - SDHI IP on R8A7745 SoC
20                 "renesas,sdhi-r8a7778" - SDHI IP on R8A7778 SoC
21                 "renesas,sdhi-r8a7779" - SDHI IP on R8A7779 SoC
22                 "renesas,sdhi-r8a7790" - SDHI IP on R8A7790 SoC
23                 "renesas,sdhi-r8a7791" - SDHI IP on R8A7791 SoC
24                 "renesas,sdhi-r8a7792" - SDHI IP on R8A7792 SoC
25                 "renesas,sdhi-r8a7793" - SDHI IP on R8A7793 SoC
26                 "renesas,sdhi-r8a7794" - SDHI IP on R8A7794 SoC
27                 "renesas,sdhi-r8a7795" - SDHI IP on R8A7795 SoC
28                 "renesas,sdhi-r8a7796" - SDHI IP on R8A7796 SoC
29                 "renesas,sdhi-r8a77995" - SDHI IP on R8A77995 SoC
30                 "renesas,sdhi-shmobile" - a generic sh-mobile SDHI controller
31                 "renesas,rcar-gen1-sdhi" - a generic R-Car Gen1 SDHI controller
32                 "renesas,rcar-gen2-sdhi" - a generic R-Car Gen2 or RZ/G1
33                                            SDHI controller
34                 "renesas,rcar-gen3-sdhi" - a generic R-Car Gen3 SDHI controller
35
36
37                 When compatible with the generic version, nodes must list
38                 the SoC-specific version corresponding to the platform
39                 first followed by the generic version.
40
41 - clocks: Most controllers only have 1 clock source per channel. However, on
42           some variations of this controller, the internal card detection
43           logic that exists in this controller is sectioned off to be run by a
44           separate second clock source to allow the main core clock to be turned
45           off to save power.
46           If 2 clocks are specified by the hardware, you must name them as
47           "core" and "cd". If the controller only has 1 clock, naming is not
48           required.
49           Devices which have more than 1 clock are listed below:
50           2: R7S72100
51
52 Optional properties:
53 - pinctrl-names: should be "default", "state_uhs"
54 - pinctrl-0: should contain default/high speed pin ctrl
55 - pinctrl-1: should contain uhs mode pin ctrl
56
57 Example: R8A7790 (R-Car H2) SDHI controller nodes
58
59         sdhi0: sd@ee100000 {
60                 compatible = "renesas,sdhi-r8a7790", "renesas,rcar-gen2-sdhi";
61                 reg = <0 0xee100000 0 0x328>;
62                 interrupts = <GIC_SPI 165 IRQ_TYPE_LEVEL_HIGH>;
63                 clocks = <&cpg CPG_MOD 314>;
64                 dmas = <&dmac0 0xcd>, <&dmac0 0xce>,
65                        <&dmac1 0xcd>, <&dmac1 0xce>;
66                 dma-names = "tx", "rx", "tx", "rx";
67                 max-frequency = <195000000>;
68                 power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
69                 resets = <&cpg 314>;
70         };
71
72         sdhi1: sd@ee120000 {
73                 compatible = "renesas,sdhi-r8a7790", "renesas,rcar-gen2-sdhi";
74                 reg = <0 0xee120000 0 0x328>;
75                 interrupts = <GIC_SPI 166 IRQ_TYPE_LEVEL_HIGH>;
76                 clocks = <&cpg CPG_MOD 313>;
77                 dmas = <&dmac0 0xc9>, <&dmac0 0xca>,
78                        <&dmac1 0xc9>, <&dmac1 0xca>;
79                 dma-names = "tx", "rx", "tx", "rx";
80                 max-frequency = <195000000>;
81                 power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
82                 resets = <&cpg 313>;
83         };
84
85         sdhi2: sd@ee140000 {
86                 compatible = "renesas,sdhi-r8a7790", "renesas,rcar-gen2-sdhi";
87                 reg = <0 0xee140000 0 0x100>;
88                 interrupts = <GIC_SPI 167 IRQ_TYPE_LEVEL_HIGH>;
89                 clocks = <&cpg CPG_MOD 312>;
90                 dmas = <&dmac0 0xc1>, <&dmac0 0xc2>,
91                        <&dmac1 0xc1>, <&dmac1 0xc2>;
92                 dma-names = "tx", "rx", "tx", "rx";
93                 max-frequency = <97500000>;
94                 power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
95                 resets = <&cpg 312>;
96         };
97
98         sdhi3: sd@ee160000 {
99                 compatible = "renesas,sdhi-r8a7790", "renesas,rcar-gen2-sdhi";
100                 reg = <0 0xee160000 0 0x100>;
101                 interrupts = <GIC_SPI 168 IRQ_TYPE_LEVEL_HIGH>;
102                 clocks = <&cpg CPG_MOD 311>;
103                 dmas = <&dmac0 0xd3>, <&dmac0 0xd4>,
104                        <&dmac1 0xd3>, <&dmac1 0xd4>;
105                 dma-names = "tx", "rx", "tx", "rx";
106                 max-frequency = <97500000>;
107                 power-domains = <&sysc R8A7790_PD_ALWAYS_ON>;
108                 resets = <&cpg 311>;
109         };