Documentation/devicetree/bindings/mmc/sdhci-msm.txt

   1 * Qualcomm SDHCI controller (sdhci-msm)
   2
   3 This file documents differences between the core properties in mmc.txt
   4 and the properties used by the sdhci-msm driver.
   5
   6 Required properties:
   7 - compatible: Should contain a SoC-specific string and a IP version string:
   8         version strings:
   9                 "qcom,sdhci-msm-v4" for sdcc versions less than 5.0
  10                 "qcom,sdhci-msm-v5" for sdcc version 5.0
  11                 For SDCC version 5.0.0, MCI registers are removed from SDCC
  12                 interface and some registers are moved to HC. New compatible
  13                 string is added to support this change - "qcom,sdhci-msm-v5".
  14         full compatible strings with SoC and version:
  15                 "qcom,apq8084-sdhci", "qcom,sdhci-msm-v4"
  16                 "qcom,msm8974-sdhci", "qcom,sdhci-msm-v4"
  17                 "qcom,msm8916-sdhci", "qcom,sdhci-msm-v4"
  18                 "qcom,msm8992-sdhci", "qcom,sdhci-msm-v4"
  19                 "qcom,msm8996-sdhci", "qcom,sdhci-msm-v4"
  20                 "qcom,sdm845-sdhci", "qcom,sdhci-msm-v5"
  21                 "qcom,qcs404-sdhci", "qcom,sdhci-msm-v5"
  22         NOTE that some old device tree files may be floating around that only
  23         have the string "qcom,sdhci-msm-v4" without the SoC compatible string
  24         but doing that should be considered a deprecated practice.
  25
  26 - reg: Base address and length of the register in the following order:
  27         - Host controller register map (required)
  28         - SD Core register map (required for msm-v4 and below)
  29 - interrupts: Should contain an interrupt-specifiers for the interrupts:
  30         - Host controller interrupt (required)
  31 - pinctrl-names: Should contain only one value - "default".
  32 - pinctrl-0: Should specify pin control groups used for this controller.
  33 - clocks: A list of phandle + clock-specifier pairs for the clocks listed in clock-names.
  34 - clock-names: Should contain the following:
  35         "iface" - Main peripheral bus clock (PCLK/HCLK - AHB Bus clock) (required)
  36         "core"  - SDC MMC clock (MCLK) (required)
  37         "bus"   - SDCC bus voter clock (optional)
  38         "xo"    - TCXO clock (optional)
  39         "cal"   - reference clock for RCLK delay calibration (optional)
  40         "sleep" - sleep clock for RCLK delay calibration (optional)
  41
  42 Example:
  43
  44         sdhc_1: sdhci@f9824900 {
  45                 compatible = "qcom,msm8974-sdhci", "qcom,sdhci-msm-v4";
  46                 reg = <0xf9824900 0x11c>, <0xf9824000 0x800>;
  47                 interrupts = <0 123 0>;
  48                 bus-width = <8>;
  49                 non-removable;
  50
  51                 vmmc-supply = <&pm8941_l20>;
  52                 vqmmc-supply = <&pm8941_s3>;
  53
  54                 pinctrl-names = "default";
  55                 pinctrl-0 = <&sdc1_clk &sdc1_cmd &sdc1_data>;
  56
  57                 clocks = <&gcc GCC_SDCC1_APPS_CLK>, <&gcc GCC_SDCC1_AHB_CLK>;
  58                 clock-names = "core", "iface";
  59         };
  60
  61         sdhc_2: sdhci@f98a4900 {
  62                 compatible = "qcom,msm8974-sdhci", "qcom,sdhci-msm-v4";
  63                 reg = <0xf98a4900 0x11c>, <0xf98a4000 0x800>;
  64                 interrupts = <0 125 0>;
  65                 bus-width = <4>;
  66                 cd-gpios = <&msmgpio 62 0x1>;
  67
  68                 vmmc-supply = <&pm8941_l21>;
  69                 vqmmc-supply = <&pm8941_l13>;
  70
  71                 pinctrl-names = "default";
  72                 pinctrl-0 = <&sdc2_clk &sdc2_cmd &sdc2_data>;
  73
  74                 clocks = <&gcc GCC_SDCC2_APPS_CLK>, <&gcc GCC_SDCC2_AHB_CLK>;
  75                 clock-names = "core", "iface";
  76         };