Merge tag 'armsoc-dt' of git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc
[sfrench/cifs-2.6.git] / Documentation / devicetree / bindings / mmc / fsl-imx-esdhc.txt
1 * Freescale Enhanced Secure Digital Host Controller (eSDHC) for i.MX
2
3 The Enhanced Secure Digital Host Controller on Freescale i.MX 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 sdhci-esdhc-imx driver.
8
9 Required properties:
10 - compatible : Should be "fsl,<chip>-esdhc", the supported chips include
11                "fsl,imx25-esdhc"
12                "fsl,imx35-esdhc"
13                "fsl,imx51-esdhc"
14                "fsl,imx53-esdhc"
15                "fsl,imx6q-usdhc"
16                "fsl,imx6sl-usdhc"
17                "fsl,imx6sx-usdhc"
18                "fsl,imx6ull-usdhc"
19                "fsl,imx7d-usdhc"
20                "fsl,imx7ulp-usdhc"
21                "fsl,imx8qxp-usdhc"
22
23 Optional properties:
24 - fsl,wp-controller : Indicate to use controller internal write protection
25 - fsl,delay-line : Specify the number of delay cells for override mode.
26   This is used to set the clock delay for DLL(Delay Line) on override mode
27   to select a proper data sampling window in case the clock quality is not good
28   due to signal path is too long on the board. Please refer to eSDHC/uSDHC
29   chapter, DLL (Delay Line) section in RM for details.
30 - voltage-ranges : Specify the voltage range in case there are software
31   transparent level shifters on the outputs of the controller. Two cells are
32   required, first cell specifies minimum slot voltage (mV), second cell
33   specifies maximum slot voltage (mV). Several ranges could be specified.
34 - fsl,tuning-start-tap: Specify the start dealy cell point when send first CMD19
35   in tuning procedure.
36 - fsl,tuning-step: Specify the increasing delay cell steps in tuning procedure.
37   The uSDHC use one delay cell as default increasing step to do tuning process.
38   This property allows user to change the tuning step to more than one delay
39   cells which is useful for some special boards or cards when the default
40   tuning step can't find the proper delay window within limited tuning retries.
41
42 Examples:
43
44 esdhc@70004000 {
45         compatible = "fsl,imx51-esdhc";
46         reg = <0x70004000 0x4000>;
47         interrupts = <1>;
48         fsl,wp-controller;
49 };
50
51 esdhc@70008000 {
52         compatible = "fsl,imx51-esdhc";
53         reg = <0x70008000 0x4000>;
54         interrupts = <2>;
55         cd-gpios = <&gpio1 6 0>; /* GPIO1_6 */
56         wp-gpios = <&gpio1 5 0>; /* GPIO1_5 */
57 };