dt-bindings: mmci: add optional reset property
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mmc / mmci.txt
1 * ARM PrimeCell MultiMedia Card Interface (MMCI) PL180/1
2
3 The ARM PrimeCell MMCI PL180 and PL181 provides an interface for
4 reading and writing to MultiMedia and SD cards alike.
5
6 This file documents differences between the core properties described
7 by mmc.txt and the properties used by the mmci driver. Using "st" as
8 the prefix for a property, indicates support by the ST Micro variant.
9
10 Required properties:
11 - compatible             : contains "arm,pl18x", "arm,primecell".
12 - vmmc-supply            : phandle to the regulator device tree node, mentioned
13                            as the VCC/VDD supply in the eMMC/SD specs.
14
15 Optional properties:
16 - arm,primecell-periphid : contains the PrimeCell Peripheral ID, it overrides
17                            the ID provided by the HW
18 - resets                 : phandle to internal reset line.
19 - vqmmc-supply           : phandle to the regulator device tree node, mentioned
20                            as the VCCQ/VDD_IO supply in the eMMC/SD specs.
21 - st,sig-dir-dat0        : bus signal direction pin used for DAT[0].
22 - st,sig-dir-dat2        : bus signal direction pin used for DAT[2].
23 - st,sig-dir-dat31       : bus signal direction pin used for DAT[3] and DAT[1].
24 - st,sig-dir-dat74       : bus signal direction pin used for DAT[4] to DAT[7].
25 - st,sig-dir-cmd         : cmd signal direction pin used for CMD.
26 - st,sig-pin-fbclk       : feedback clock signal pin used.
27
28 Deprecated properties:
29 - mmc-cap-mmc-highspeed  : indicates whether MMC is high speed capable.
30 - mmc-cap-sd-highspeed   : indicates whether SD is high speed capable.
31
32 Example:
33
34 sdi0_per1@80126000 {
35         compatible = "arm,pl18x", "arm,primecell";
36         reg = <0x80126000 0x1000>;
37         interrupts = <0 60 IRQ_TYPE_LEVEL_HIGH>;
38
39         dmas = <&dma 29 0 0x2>, /* Logical - DevToMem */
40                <&dma 29 0 0x0>; /* Logical - MemToDev */
41         dma-names = "rx", "tx";
42
43         clocks = <&prcc_kclk 1 5>, <&prcc_pclk 1 5>;
44         clock-names = "sdi", "apb_pclk";
45
46         max-frequency = <100000000>;
47         bus-width = <4>;
48         cap-sd-highspeed;
49         cap-mmc-highspeed;
50         cd-gpios  = <&gpio2 31 0x4>; // 95
51         st,sig-dir-dat0;
52         st,sig-dir-dat2;
53         st,sig-dir-cmd;
54         st,sig-pin-fbclk;
55
56         vmmc-supply = <&ab8500_ldo_aux3_reg>;
57         vqmmc-supply = <&vmmci>;
58
59         pinctrl-names = "default", "sleep";
60         pinctrl-0 = <&sdi0_default_mode>;
61         pinctrl-1 = <&sdi0_sleep_mode>;
62 };