18c2ecf20Sopenharmony_ci* Renesas Multi Media Card Interface (MMCIF) Controller
28c2ecf20Sopenharmony_ci
38c2ecf20Sopenharmony_ciThis file documents differences between the core properties in mmc.txt
48c2ecf20Sopenharmony_ciand the properties used by the MMCIF device.
58c2ecf20Sopenharmony_ci
68c2ecf20Sopenharmony_ci
78c2ecf20Sopenharmony_ciRequired properties:
88c2ecf20Sopenharmony_ci
98c2ecf20Sopenharmony_ci- compatible: should be "renesas,mmcif-<soctype>", "renesas,sh-mmcif" as a
108c2ecf20Sopenharmony_ci  fallback. Examples with <soctype> are:
118c2ecf20Sopenharmony_ci	- "renesas,mmcif-r7s72100" for the MMCIF found in r7s72100 SoCs
128c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a73a4" for the MMCIF found in r8a73a4 SoCs
138c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7740" for the MMCIF found in r8a7740 SoCs
148c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7742" for the MMCIF found in r8a7742 SoCs
158c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7743" for the MMCIF found in r8a7743 SoCs
168c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7744" for the MMCIF found in r8a7744 SoCs
178c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7745" for the MMCIF found in r8a7745 SoCs
188c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7778" for the MMCIF found in r8a7778 SoCs
198c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7790" for the MMCIF found in r8a7790 SoCs
208c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7791" for the MMCIF found in r8a7791 SoCs
218c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7793" for the MMCIF found in r8a7793 SoCs
228c2ecf20Sopenharmony_ci	- "renesas,mmcif-r8a7794" for the MMCIF found in r8a7794 SoCs
238c2ecf20Sopenharmony_ci	- "renesas,mmcif-sh73a0" for the MMCIF found in sh73a0 SoCs
248c2ecf20Sopenharmony_ci
258c2ecf20Sopenharmony_ci- interrupts: Some SoCs have only 1 shared interrupt, while others have either
268c2ecf20Sopenharmony_ci  2 or 3 individual interrupts (error, int, card detect). Below is the number
278c2ecf20Sopenharmony_ci  of interrupts for each SoC:
288c2ecf20Sopenharmony_ci    1: r8a73a4, r8a7742, r8a7743, r8a7744, r8a7745, r8a7778, r8a7790, r8a7791,
298c2ecf20Sopenharmony_ci       r8a7793, r8a7794
308c2ecf20Sopenharmony_ci    2: r8a7740, sh73a0
318c2ecf20Sopenharmony_ci    3: r7s72100
328c2ecf20Sopenharmony_ci
338c2ecf20Sopenharmony_ci- clocks: reference to the functional clock
348c2ecf20Sopenharmony_ci
358c2ecf20Sopenharmony_ci- dmas: reference to the DMA channels, one per channel name listed in the
368c2ecf20Sopenharmony_ci  dma-names property.
378c2ecf20Sopenharmony_ci- dma-names: must contain "tx" for the transmit DMA channel and "rx" for the
388c2ecf20Sopenharmony_ci  receive DMA channel.
398c2ecf20Sopenharmony_ci- max-frequency: Maximum operating clock frequency, driver uses default clock
408c2ecf20Sopenharmony_ci  frequency if it is not set.
418c2ecf20Sopenharmony_ci
428c2ecf20Sopenharmony_ci
438c2ecf20Sopenharmony_ciExample: R8A7790 (R-Car H2) MMCIF0
448c2ecf20Sopenharmony_ci
458c2ecf20Sopenharmony_ci	mmcif0: mmc@ee200000 {
468c2ecf20Sopenharmony_ci		compatible = "renesas,mmcif-r8a7790", "renesas,sh-mmcif";
478c2ecf20Sopenharmony_ci		reg = <0 0xee200000 0 0x80>;
488c2ecf20Sopenharmony_ci		interrupts = <0 169 IRQ_TYPE_LEVEL_HIGH>;
498c2ecf20Sopenharmony_ci		clocks = <&mstp3_clks R8A7790_CLK_MMCIF0>;
508c2ecf20Sopenharmony_ci		dmas = <&dmac0 0xd1>, <&dmac0 0xd2>;
518c2ecf20Sopenharmony_ci		dma-names = "tx", "rx";
528c2ecf20Sopenharmony_ci		max-frequency = <97500000>;
538c2ecf20Sopenharmony_ci	};
54