1*c66ec88fSEmmanuel Vadot* STMicroelectronics sdhci-st MMC/SD controller 2*c66ec88fSEmmanuel Vadot 3*c66ec88fSEmmanuel VadotThis file documents the differences between the core properties in 4*c66ec88fSEmmanuel VadotDocumentation/devicetree/bindings/mmc/mmc.txt and the properties 5*c66ec88fSEmmanuel Vadotused by the sdhci-st driver. 6*c66ec88fSEmmanuel Vadot 7*c66ec88fSEmmanuel VadotRequired properties: 8*c66ec88fSEmmanuel Vadot- compatible: Must be "st,sdhci" and it can be compatible to "st,sdhci-stih407" 9*c66ec88fSEmmanuel Vadot to set the internal glue logic used for configuring the MMC 10*c66ec88fSEmmanuel Vadot subsystem (mmcss) inside the FlashSS (available in STiH407 SoC 11*c66ec88fSEmmanuel Vadot family). 12*c66ec88fSEmmanuel Vadot 13*c66ec88fSEmmanuel Vadot- clock-names: Should be "mmc" and "icn". (NB: The latter is not compulsory) 14*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/resource-names.txt 15*c66ec88fSEmmanuel Vadot- clocks: Phandle to the clock. 16*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/clock/clock-bindings.txt 17*c66ec88fSEmmanuel Vadot 18*c66ec88fSEmmanuel Vadot- interrupts: One mmc interrupt should be described here. 19*c66ec88fSEmmanuel Vadot- interrupt-names: Should be "mmcirq". 20*c66ec88fSEmmanuel Vadot 21*c66ec88fSEmmanuel Vadot- pinctrl-names: A pinctrl state names "default" must be defined. 22*c66ec88fSEmmanuel Vadot- pinctrl-0: Phandle referencing pin configuration of the sd/emmc controller. 23*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/pinctrl/pinctrl-bindings.txt 24*c66ec88fSEmmanuel Vadot 25*c66ec88fSEmmanuel Vadot- reg: This must provide the host controller base address and it can also 26*c66ec88fSEmmanuel Vadot contain the FlashSS Top register for TX/RX delay used by the driver 27*c66ec88fSEmmanuel Vadot to configure DLL inside the flashSS, if so reg-names must also be 28*c66ec88fSEmmanuel Vadot specified. 29*c66ec88fSEmmanuel Vadot 30*c66ec88fSEmmanuel VadotOptional properties: 31*c66ec88fSEmmanuel Vadot- reg-names: Should be "mmc" and "top-mmc-delay". "top-mmc-delay" is optional 32*c66ec88fSEmmanuel Vadot for eMMC on stih407 family silicon to configure DLL inside FlashSS. 33*c66ec88fSEmmanuel Vadot 34*c66ec88fSEmmanuel Vadot- non-removable: Non-removable slot. Also used for configuring mmcss in STiH407 SoC 35*c66ec88fSEmmanuel Vadot family. 36*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/mmc/mmc.txt. 37*c66ec88fSEmmanuel Vadot 38*c66ec88fSEmmanuel Vadot- bus-width: Number of data lines. 39*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/mmc/mmc.txt. 40*c66ec88fSEmmanuel Vadot 41*c66ec88fSEmmanuel Vadot- max-frequency: Can be 200MHz, 100MHz or 50MHz (default) and used for 42*c66ec88fSEmmanuel Vadot configuring the CCONFIG3 in the mmcss. 43*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/mmc/mmc.txt. 44*c66ec88fSEmmanuel Vadot 45*c66ec88fSEmmanuel Vadot- resets: Phandle and reset specifier pair to softreset line of HC IP. 46*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/reset/reset.txt 47*c66ec88fSEmmanuel Vadot 48*c66ec88fSEmmanuel Vadot- vqmmc-supply: Phandle to the regulator dt node, mentioned as the vcc/vdd 49*c66ec88fSEmmanuel Vadot supply in eMMC/SD specs. 50*c66ec88fSEmmanuel Vadot 51*c66ec88fSEmmanuel Vadot- sd-uhs-sdr50: To enable the SDR50 in the mmcss. 52*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/mmc/mmc.txt. 53*c66ec88fSEmmanuel Vadot 54*c66ec88fSEmmanuel Vadot- sd-uhs-sdr104: To enable the SDR104 in the mmcss. 55*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/mmc/mmc.txt. 56*c66ec88fSEmmanuel Vadot 57*c66ec88fSEmmanuel Vadot- sd-uhs-ddr50: To enable the DDR50 in the mmcss. 58*c66ec88fSEmmanuel Vadot See: Documentation/devicetree/bindings/mmc/mmc.txt. 59*c66ec88fSEmmanuel Vadot 60*c66ec88fSEmmanuel VadotExample: 61*c66ec88fSEmmanuel Vadot 62*c66ec88fSEmmanuel Vadot/* Example stih416e eMMC configuration */ 63*c66ec88fSEmmanuel Vadot 64*c66ec88fSEmmanuel Vadotmmc0: sdhci@fe81e000 { 65*c66ec88fSEmmanuel Vadot compatible = "st,sdhci"; 66*c66ec88fSEmmanuel Vadot reg = <0xfe81e000 0x1000>; 67*c66ec88fSEmmanuel Vadot interrupts = <GIC_SPI 127 IRQ_TYPE_NONE>; 68*c66ec88fSEmmanuel Vadot interrupt-names = "mmcirq"; 69*c66ec88fSEmmanuel Vadot pinctrl-names = "default"; 70*c66ec88fSEmmanuel Vadot pinctrl-0 = <&pinctrl_mmc0>; 71*c66ec88fSEmmanuel Vadot clock-names = "mmc"; 72*c66ec88fSEmmanuel Vadot clocks = <&clk_s_a1_ls 1>; 73*c66ec88fSEmmanuel Vadot bus-width = <8> 74*c66ec88fSEmmanuel Vadot 75*c66ec88fSEmmanuel Vadot/* Example SD stih407 family configuration */ 76*c66ec88fSEmmanuel Vadot 77*c66ec88fSEmmanuel Vadotmmc1: sdhci@9080000 { 78*c66ec88fSEmmanuel Vadot compatible = "st,sdhci-stih407", "st,sdhci"; 79*c66ec88fSEmmanuel Vadot reg = <0x09080000 0x7ff>; 80*c66ec88fSEmmanuel Vadot reg-names = "mmc"; 81*c66ec88fSEmmanuel Vadot interrupts = <GIC_SPI 90 IRQ_TYPE_NONE>; 82*c66ec88fSEmmanuel Vadot interrupt-names = "mmcirq"; 83*c66ec88fSEmmanuel Vadot pinctrl-names = "default"; 84*c66ec88fSEmmanuel Vadot pinctrl-0 = <&pinctrl_sd1>; 85*c66ec88fSEmmanuel Vadot clock-names = "mmc"; 86*c66ec88fSEmmanuel Vadot clocks = <&clk_s_c0_flexgen CLK_MMC_1>; 87*c66ec88fSEmmanuel Vadot resets = <&softreset STIH407_MMC1_SOFTRESET>; 88*c66ec88fSEmmanuel Vadot bus-width = <4>; 89*c66ec88fSEmmanuel Vadot}; 90*c66ec88fSEmmanuel Vadot 91*c66ec88fSEmmanuel Vadot/* Example eMMC stih407 family configuration */ 92*c66ec88fSEmmanuel Vadot 93*c66ec88fSEmmanuel Vadotmmc0: sdhci@9060000 { 94*c66ec88fSEmmanuel Vadot compatible = "st,sdhci-stih407", "st,sdhci"; 95*c66ec88fSEmmanuel Vadot reg = <0x09060000 0x7ff>, <0x9061008 0x20>; 96*c66ec88fSEmmanuel Vadot reg-names = "mmc", "top-mmc-delay"; 97*c66ec88fSEmmanuel Vadot interrupts = <GIC_SPI 92 IRQ_TYPE_NONE>; 98*c66ec88fSEmmanuel Vadot interrupt-names = "mmcirq"; 99*c66ec88fSEmmanuel Vadot pinctrl-names = "default"; 100*c66ec88fSEmmanuel Vadot pinctrl-0 = <&pinctrl_mmc0>; 101*c66ec88fSEmmanuel Vadot clock-names = "mmc"; 102*c66ec88fSEmmanuel Vadot clocks = <&clk_s_c0_flexgen CLK_MMC_0>; 103*c66ec88fSEmmanuel Vadot vqmmc-supply = <&vmmc_reg>; 104*c66ec88fSEmmanuel Vadot max-frequency = <200000000>; 105*c66ec88fSEmmanuel Vadot bus-width = <8>; 106*c66ec88fSEmmanuel Vadot non-removable; 107*c66ec88fSEmmanuel Vadot sd-uhs-sdr50; 108*c66ec88fSEmmanuel Vadot sd-uhs-sdr104; 109*c66ec88fSEmmanuel Vadot sd-uhs-ddr50; 110*c66ec88fSEmmanuel Vadot}; 111