GNU Linux-libre 4.19.264-gnu1
[releases.git] / Documentation / devicetree / bindings / mmc / k3-dw-mshc.txt
1 * Hisilicon specific extensions to the Synopsys Designware Mobile
2   Storage Host Controller
3
4 Read synopsys-dw-mshc.txt for more details
5
6 The Synopsys designware mobile storage host controller is used to interface
7 a SoC with storage medium such as eMMC or SD/MMC cards. This file documents
8 differences between the core Synopsys dw mshc controller properties described
9 by synopsys-dw-mshc.txt and the properties used by the Hisilicon specific
10 extensions to the Synopsys Designware Mobile Storage Host Controller.
11
12 Required Properties:
13
14 * compatible: should be one of the following.
15   - "hisilicon,hi3660-dw-mshc": for controllers with hi3660 specific extensions.
16   - "hisilicon,hi4511-dw-mshc": for controllers with hi4511 specific extensions.
17   - "hisilicon,hi6220-dw-mshc": for controllers with hi6220 specific extensions.
18
19 Optional Properties:
20 - hisilicon,peripheral-syscon: phandle of syscon used to control peripheral.
21
22 Example:
23
24         /* for Hi3620 */
25
26         /* SoC portion */
27         dwmmc_0: dwmmc0@fcd03000 {
28                 compatible = "hisilicon,hi4511-dw-mshc";
29                 reg = <0xfcd03000 0x1000>;
30                 interrupts = <0 16 4>;
31                 #address-cells = <1>;
32                 #size-cells = <0>;
33                 clocks = <&mmc_clock HI3620_SD_CIUCLK>, <&clock HI3620_DDRC_PER_CLK>;
34                 clock-names = "ciu", "biu";
35         };
36
37         /* Board portion */
38         dwmmc0@fcd03000 {
39                 vmmc-supply = <&ldo12>;
40                 fifo-depth = <0x100>;
41                 pinctrl-names = "default";
42                 pinctrl-0 = <&sd_pmx_pins &sd_cfg_func1 &sd_cfg_func2>;
43                 bus-width = <4>;
44                 disable-wp;
45                 cd-gpios = <&gpio10 3 0>;
46                 cap-mmc-highspeed;
47                 cap-sd-highspeed;
48         };
49
50         /* for Hi6220 */
51
52         dwmmc_1: dwmmc1@f723e000 {
53                 compatible = "hisilicon,hi6220-dw-mshc";
54                 bus-width = <0x4>;
55                 disable-wp;
56                 cap-sd-highspeed;
57                 sd-uhs-sdr12;
58                 sd-uhs-sdr25;
59                 card-detect-delay = <200>;
60                 hisilicon,peripheral-syscon = <&ao_ctrl>;
61                 reg = <0x0 0xf723e000 0x0 0x1000>;
62                 interrupts = <0x0 0x49 0x4>;
63                 clocks = <&clock_sys HI6220_MMC1_CIUCLK>, <&clock_sys HI6220_MMC1_CLK>;
64                 clock-names = "ciu", "biu";
65                 cd-gpios = <&gpio1 0 1>;
66                 pinctrl-names = "default", "idle";
67                 pinctrl-0 = <&sd_pmx_func &sd_clk_cfg_func &sd_cfg_func>;
68                 pinctrl-1 = <&sd_pmx_idle &sd_clk_cfg_idle &sd_cfg_idle>;
69                 vqmmc-supply = <&ldo7>;
70                 vmmc-supply = <&ldo10>;
71         };