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 / 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,omap3-pre-es3-hsmmc" for OMAP3 controllers pre ES3.0
14  Should be "ti,omap4-hsmmc", for OMAP4 controllers
15 - ti,hwmods: Must be "mmc<n>", n is controller instance starting 1
16
17 Optional properties:
18 ti,dual-volt: boolean, supports dual voltage cards
19 <supply-name>-supply: phandle to the regulator device tree node
20 "supply-name" examples are "vmmc", "vmmc_aux" etc
21 ti,non-removable: non-removable slot (like eMMC)
22 ti,needs-special-reset: Requires a special softreset sequence
23 ti,needs-special-hs-handling: HSMMC IP needs special setting for handling High Speed
24 dmas: List of DMA specifiers with the controller specific format
25 as described in the generic DMA client binding. A tx and rx
26 specifier is required.
27 dma-names: List of DMA request names. These strings correspond
28 1:1 with the DMA specifiers listed in dmas. The string naming is
29 to be "rx" and "tx" for RX and TX DMA requests, respectively.
30
31 Examples:
32
33 [hwmod populated DMA resources]
34
35         mmc1: mmc@0x4809c000 {
36                 compatible = "ti,omap4-hsmmc";
37                 reg = <0x4809c000 0x400>;
38                 ti,hwmods = "mmc1";
39                 ti,dual-volt;
40                 bus-width = <4>;
41                 vmmc-supply = <&vmmc>; /* phandle to regulator node */
42                 ti,non-removable;
43         };
44
45 [generic DMA request binding]
46
47         mmc1: mmc@0x4809c000 {
48                 compatible = "ti,omap4-hsmmc";
49                 reg = <0x4809c000 0x400>;
50                 ti,hwmods = "mmc1";
51                 ti,dual-volt;
52                 bus-width = <4>;
53                 vmmc-supply = <&vmmc>; /* phandle to regulator node */
54                 ti,non-removable;
55                 dmas = <&edma 24
56                         &edma 25>;
57                 dma-names = "tx", "rx";
58         };