Merge tag 'kbuild-misc-v4.15' of git://git.kernel.org/pub/scm/linux/kernel/git/masahi...
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mmc / sunxi-mmc.txt
1 * Allwinner sunxi MMC controller
2
3 The highspeed MMC host controller on Allwinner SoCs provides an interface
4 for MMC, SD and SDIO types of memory cards.
5
6 Supported maximum speeds are the ones of the eMMC standard 4.5 as well
7 as the speed of SD standard 3.0.
8 Absolute maximum transfer rate is 200MB/s
9
10 Required properties:
11  - compatible : should be one of:
12    * "allwinner,sun4i-a10-mmc"
13    * "allwinner,sun5i-a13-mmc"
14    * "allwinner,sun7i-a20-mmc"
15    * "allwinner,sun8i-a83t-emmc"
16    * "allwinner,sun9i-a80-mmc"
17    * "allwinner,sun50i-a64-emmc"
18    * "allwinner,sun50i-a64-mmc"
19  - reg : mmc controller base registers
20  - clocks : a list with 4 phandle + clock specifier pairs
21  - clock-names : must contain "ahb", "mmc", "output" and "sample"
22  - interrupts : mmc controller interrupt
23
24 Optional properties:
25  - resets : phandle + reset specifier pair
26  - reset-names : must contain "ahb"
27  - for cd, bus-width and additional generic mmc parameters
28    please refer to mmc.txt within this directory
29
30 Examples:
31         - Within .dtsi:
32         mmc0: mmc@1c0f000 {
33                 compatible = "allwinner,sun5i-a13-mmc";
34                 reg = <0x01c0f000 0x1000>;
35                 clocks = <&ahb_gates 8>, <&mmc0_clk>, <&mmc0_output_clk>, <&mmc0_sample_clk>;
36                 clock-names = "ahb", "mod", "output", "sample";
37                 interrupts = <0 32 4>;
38                 status = "disabled";
39         };
40
41         - Within dts:
42         mmc0: mmc@1c0f000 {
43                 pinctrl-names = "default", "default";
44                 pinctrl-0 = <&mmc0_pins_a>;
45                 pinctrl-1 = <&mmc0_cd_pin_reference_design>;
46                 bus-width = <4>;
47                 cd-gpios = <&pio 7 1 0>; /* PH1 */
48                 cd-inverted;
49                 status = "okay";
50         };