Merge remote-tracking branch 'spi/fix/core' into spi-linus
[linux-drm-fsl-dcu.git] / Documentation / devicetree / bindings / mmc / ti-omap-hsmmc.txt
1 * TI Highspeed MMC host controller for OMAP
2
3 The Highspeed MMC Host Controller on TI OMAP family
4 provides an interface for MMC, SD, and SDIO types of memory cards.
5
6 This file documents differences between the core properties described
7 by mmc.txt and the properties used by the omap_hsmmc driver.
8
9 Required properties:
10 - compatible:
11  Should be "ti,omap2-hsmmc", for OMAP2 controllers
12  Should be "ti,omap3-hsmmc", for OMAP3 controllers
13  Should be "ti,omap4-hsmmc", for OMAP4 controllers
14 - ti,hwmods: Must be "mmc<n>", n is controller instance starting 1
15
16 Optional properties:
17 ti,dual-volt: boolean, supports dual voltage cards
18 <supply-name>-supply: phandle to the regulator device tree node
19 "supply-name" examples are "vmmc", "vmmc_aux" etc
20 ti,non-removable: non-removable slot (like eMMC)
21 ti,needs-special-reset: Requires a special softreset sequence
22 ti,needs-special-hs-handling: HSMMC IP needs special setting for handling High Speed
23 dmas: List of DMA specifiers with the controller specific format
24 as described in the generic DMA client binding. A tx and rx
25 specifier is required.
26 dma-names: List of DMA request names. These strings correspond
27 1:1 with the DMA specifiers listed in dmas. The string naming is
28 to be "rx" and "tx" for RX and TX DMA requests, respectively.
29
30 Examples:
31
32 [hwmod populated DMA resources]
33
34         mmc1: mmc@0x4809c000 {
35                 compatible = "ti,omap4-hsmmc";
36                 reg = <0x4809c000 0x400>;
37                 ti,hwmods = "mmc1";
38                 ti,dual-volt;
39                 bus-width = <4>;
40                 vmmc-supply = <&vmmc>; /* phandle to regulator node */
41                 ti,non-removable;
42         };
43
44 [generic DMA request binding]
45
46         mmc1: mmc@0x4809c000 {
47                 compatible = "ti,omap4-hsmmc";
48                 reg = <0x4809c000 0x400>;
49                 ti,hwmods = "mmc1";
50                 ti,dual-volt;
51                 bus-width = <4>;
52                 vmmc-supply = <&vmmc>; /* phandle to regulator node */
53                 ti,non-removable;
54                 dmas = <&edma 24
55                         &edma 25>;
56                 dma-names = "tx", "rx";
57         };