linux/drivers/mmc/host/sdhci-of-at91.c
<<
>>
Prefs
   1// SPDX-License-Identifier: GPL-2.0-only
   2/*
   3 * Atmel SDMMC controller driver.
   4 *
   5 * Copyright (C) 2015 Atmel,
   6 *               2015 Ludovic Desroches <ludovic.desroches@atmel.com>
   7 */
   8
   9#include <linux/clk.h>
  10#include <linux/delay.h>
  11#include <linux/err.h>
  12#include <linux/io.h>
  13#include <linux/kernel.h>
  14#include <linux/mmc/host.h>
  15#include <linux/mmc/slot-gpio.h>
  16#include <linux/module.h>
  17#include <linux/of.h>
  18#include <linux/of_device.h>
  19#include <linux/pm.h>
  20#include <linux/pm_runtime.h>
  21
  22#include "sdhci-pltfm.h"
  23
  24#define SDMMC_MC1R      0x204
  25#define         SDMMC_MC1R_DDR          BIT(3)
  26#define         SDMMC_MC1R_FCD          BIT(7)
  27#define SDMMC_CACR      0x230
  28#define         SDMMC_CACR_CAPWREN      BIT(0)
  29#define         SDMMC_CACR_KEY          (0x46 << 8)
  30
  31#define SDHCI_AT91_PRESET_COMMON_CONF   0x400 /* drv type B, programmable clock mode */
  32
  33struct sdhci_at91_priv {
  34        struct clk *hclock;
  35        struct clk *gck;
  36        struct clk *mainck;
  37        bool restore_needed;
  38};
  39
  40static void sdhci_at91_set_force_card_detect(struct sdhci_host *host)
  41{
  42        u8 mc1r;
  43
  44        mc1r = readb(host->ioaddr + SDMMC_MC1R);
  45        mc1r |= SDMMC_MC1R_FCD;
  46        writeb(mc1r, host->ioaddr + SDMMC_MC1R);
  47}
  48
  49static void sdhci_at91_set_clock(struct sdhci_host *host, unsigned int clock)
  50{
  51        u16 clk;
  52        unsigned long timeout;
  53
  54        host->mmc->actual_clock = 0;
  55
  56        /*
  57         * There is no requirement to disable the internal clock before
  58         * changing the SD clock configuration. Moreover, disabling the
  59         * internal clock, changing the configuration and re-enabling the
  60         * internal clock causes some bugs. It can prevent to get the internal
  61         * clock stable flag ready and an unexpected switch to the base clock
  62         * when using presets.
  63         */
  64        clk = sdhci_readw(host, SDHCI_CLOCK_CONTROL);
  65        clk &= SDHCI_CLOCK_INT_EN;
  66        sdhci_writew(host, clk, SDHCI_CLOCK_CONTROL);
  67
  68        if (clock == 0)
  69                return;
  70
  71        clk = sdhci_calc_clk(host, clock, &host->mmc->actual_clock);
  72
  73        clk |= SDHCI_CLOCK_INT_EN;
  74        sdhci_writew(host, clk, SDHCI_CLOCK_CONTROL);
  75
  76        /* Wait max 20 ms */
  77        timeout = 20;
  78        while (!((clk = sdhci_readw(host, SDHCI_CLOCK_CONTROL))
  79                & SDHCI_CLOCK_INT_STABLE)) {
  80                if (timeout == 0) {
  81                        pr_err("%s: Internal clock never stabilised.\n",
  82                               mmc_hostname(host->mmc));
  83                        return;
  84                }
  85                timeout--;
  86                mdelay(1);
  87        }
  88
  89        clk |= SDHCI_CLOCK_CARD_EN;
  90        sdhci_writew(host, clk, SDHCI_CLOCK_CONTROL);
  91}
  92
  93/*
  94 * In this specific implementation of the SDHCI controller, the power register
  95 * needs to have a valid voltage set even when the power supply is managed by
  96 * an external regulator.
  97 */
  98static void sdhci_at91_set_power(struct sdhci_host *host, unsigned char mode,
  99                     unsigned short vdd)
 100{
 101        if (!IS_ERR(host->mmc->supply.vmmc)) {
 102                struct mmc_host *mmc = host->mmc;
 103
 104                mmc_regulator_set_ocr(mmc, mmc->supply.vmmc, vdd);
 105        }
 106        sdhci_set_power_noreg(host, mode, vdd);
 107}
 108
 109static void sdhci_at91_set_uhs_signaling(struct sdhci_host *host,
 110                                         unsigned int timing)
 111{
 112        if (timing == MMC_TIMING_MMC_DDR52)
 113                sdhci_writeb(host, SDMMC_MC1R_DDR, SDMMC_MC1R);
 114        sdhci_set_uhs_signaling(host, timing);
 115}
 116
 117static void sdhci_at91_reset(struct sdhci_host *host, u8 mask)
 118{
 119        sdhci_reset(host, mask);
 120
 121        if (host->mmc->caps & MMC_CAP_NONREMOVABLE)
 122                sdhci_at91_set_force_card_detect(host);
 123}
 124
 125static const struct sdhci_ops sdhci_at91_sama5d2_ops = {
 126        .set_clock              = sdhci_at91_set_clock,
 127        .set_bus_width          = sdhci_set_bus_width,
 128        .reset                  = sdhci_at91_reset,
 129        .set_uhs_signaling      = sdhci_at91_set_uhs_signaling,
 130        .set_power              = sdhci_at91_set_power,
 131};
 132
 133static const struct sdhci_pltfm_data soc_data_sama5d2 = {
 134        .ops = &sdhci_at91_sama5d2_ops,
 135};
 136
 137static const struct of_device_id sdhci_at91_dt_match[] = {
 138        { .compatible = "atmel,sama5d2-sdhci", .data = &soc_data_sama5d2 },
 139        {}
 140};
 141MODULE_DEVICE_TABLE(of, sdhci_at91_dt_match);
 142
 143static int sdhci_at91_set_clks_presets(struct device *dev)
 144{
 145        struct sdhci_host *host = dev_get_drvdata(dev);
 146        struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
 147        struct sdhci_at91_priv *priv = sdhci_pltfm_priv(pltfm_host);
 148        int ret;
 149        unsigned int                    caps0, caps1;
 150        unsigned int                    clk_base, clk_mul;
 151        unsigned int                    gck_rate, real_gck_rate;
 152        unsigned int                    preset_div;
 153
 154        /*
 155         * The mult clock is provided by as a generated clock by the PMC
 156         * controller. In order to set the rate of gck, we have to get the
 157         * base clock rate and the clock mult from capabilities.
 158         */
 159        clk_prepare_enable(priv->hclock);
 160        caps0 = readl(host->ioaddr + SDHCI_CAPABILITIES);
 161        caps1 = readl(host->ioaddr + SDHCI_CAPABILITIES_1);
 162        clk_base = (caps0 & SDHCI_CLOCK_V3_BASE_MASK) >> SDHCI_CLOCK_BASE_SHIFT;
 163        clk_mul = (caps1 & SDHCI_CLOCK_MUL_MASK) >> SDHCI_CLOCK_MUL_SHIFT;
 164        gck_rate = clk_base * 1000000 * (clk_mul + 1);
 165        ret = clk_set_rate(priv->gck, gck_rate);
 166        if (ret < 0) {
 167                dev_err(dev, "failed to set gck");
 168                clk_disable_unprepare(priv->hclock);
 169                return ret;
 170        }
 171        /*
 172         * We need to check if we have the requested rate for gck because in
 173         * some cases this rate could be not supported. If it happens, the rate
 174         * is the closest one gck can provide. We have to update the value
 175         * of clk mul.
 176         */
 177        real_gck_rate = clk_get_rate(priv->gck);
 178        if (real_gck_rate != gck_rate) {
 179                clk_mul = real_gck_rate / (clk_base * 1000000) - 1;
 180                caps1 &= (~SDHCI_CLOCK_MUL_MASK);
 181                caps1 |= ((clk_mul << SDHCI_CLOCK_MUL_SHIFT) &
 182                          SDHCI_CLOCK_MUL_MASK);
 183                /* Set capabilities in r/w mode. */
 184                writel(SDMMC_CACR_KEY | SDMMC_CACR_CAPWREN,
 185                       host->ioaddr + SDMMC_CACR);
 186                writel(caps1, host->ioaddr + SDHCI_CAPABILITIES_1);
 187                /* Set capabilities in ro mode. */
 188                writel(0, host->ioaddr + SDMMC_CACR);
 189                dev_info(dev, "update clk mul to %u as gck rate is %u Hz\n",
 190                         clk_mul, real_gck_rate);
 191        }
 192
 193        /*
 194         * We have to set preset values because it depends on the clk_mul
 195         * value. Moreover, SDR104 is supported in a degraded mode since the
 196         * maximum sd clock value is 120 MHz instead of 208 MHz. For that
 197         * reason, we need to use presets to support SDR104.
 198         */
 199        preset_div = DIV_ROUND_UP(real_gck_rate, 24000000) - 1;
 200        writew(SDHCI_AT91_PRESET_COMMON_CONF | preset_div,
 201               host->ioaddr + SDHCI_PRESET_FOR_SDR12);
 202        preset_div = DIV_ROUND_UP(real_gck_rate, 50000000) - 1;
 203        writew(SDHCI_AT91_PRESET_COMMON_CONF | preset_div,
 204               host->ioaddr + SDHCI_PRESET_FOR_SDR25);
 205        preset_div = DIV_ROUND_UP(real_gck_rate, 100000000) - 1;
 206        writew(SDHCI_AT91_PRESET_COMMON_CONF | preset_div,
 207               host->ioaddr + SDHCI_PRESET_FOR_SDR50);
 208        preset_div = DIV_ROUND_UP(real_gck_rate, 120000000) - 1;
 209        writew(SDHCI_AT91_PRESET_COMMON_CONF | preset_div,
 210               host->ioaddr + SDHCI_PRESET_FOR_SDR104);
 211        preset_div = DIV_ROUND_UP(real_gck_rate, 50000000) - 1;
 212        writew(SDHCI_AT91_PRESET_COMMON_CONF | preset_div,
 213               host->ioaddr + SDHCI_PRESET_FOR_DDR50);
 214
 215        clk_prepare_enable(priv->mainck);
 216        clk_prepare_enable(priv->gck);
 217
 218        return 0;
 219}
 220
 221#ifdef CONFIG_PM_SLEEP
 222static int sdhci_at91_suspend(struct device *dev)
 223{
 224        struct sdhci_host *host = dev_get_drvdata(dev);
 225        struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
 226        struct sdhci_at91_priv *priv = sdhci_pltfm_priv(pltfm_host);
 227        int ret;
 228
 229        ret = pm_runtime_force_suspend(dev);
 230
 231        priv->restore_needed = true;
 232
 233        return ret;
 234}
 235#endif /* CONFIG_PM_SLEEP */
 236
 237#ifdef CONFIG_PM
 238static int sdhci_at91_runtime_suspend(struct device *dev)
 239{
 240        struct sdhci_host *host = dev_get_drvdata(dev);
 241        struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
 242        struct sdhci_at91_priv *priv = sdhci_pltfm_priv(pltfm_host);
 243        int ret;
 244
 245        ret = sdhci_runtime_suspend_host(host);
 246
 247        if (host->tuning_mode != SDHCI_TUNING_MODE_3)
 248                mmc_retune_needed(host->mmc);
 249
 250        clk_disable_unprepare(priv->gck);
 251        clk_disable_unprepare(priv->hclock);
 252        clk_disable_unprepare(priv->mainck);
 253
 254        return ret;
 255}
 256
 257static int sdhci_at91_runtime_resume(struct device *dev)
 258{
 259        struct sdhci_host *host = dev_get_drvdata(dev);
 260        struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
 261        struct sdhci_at91_priv *priv = sdhci_pltfm_priv(pltfm_host);
 262        int ret;
 263
 264        if (priv->restore_needed) {
 265                ret = sdhci_at91_set_clks_presets(dev);
 266                if (ret)
 267                        return ret;
 268
 269                priv->restore_needed = false;
 270                goto out;
 271        }
 272
 273        ret = clk_prepare_enable(priv->mainck);
 274        if (ret) {
 275                dev_err(dev, "can't enable mainck\n");
 276                return ret;
 277        }
 278
 279        ret = clk_prepare_enable(priv->hclock);
 280        if (ret) {
 281                dev_err(dev, "can't enable hclock\n");
 282                return ret;
 283        }
 284
 285        ret = clk_prepare_enable(priv->gck);
 286        if (ret) {
 287                dev_err(dev, "can't enable gck\n");
 288                return ret;
 289        }
 290
 291out:
 292        return sdhci_runtime_resume_host(host);
 293}
 294#endif /* CONFIG_PM */
 295
 296static const struct dev_pm_ops sdhci_at91_dev_pm_ops = {
 297        SET_SYSTEM_SLEEP_PM_OPS(sdhci_at91_suspend, pm_runtime_force_resume)
 298        SET_RUNTIME_PM_OPS(sdhci_at91_runtime_suspend,
 299                           sdhci_at91_runtime_resume,
 300                           NULL)
 301};
 302
 303static int sdhci_at91_probe(struct platform_device *pdev)
 304{
 305        const struct of_device_id       *match;
 306        const struct sdhci_pltfm_data   *soc_data;
 307        struct sdhci_host               *host;
 308        struct sdhci_pltfm_host         *pltfm_host;
 309        struct sdhci_at91_priv          *priv;
 310        int                             ret;
 311
 312        match = of_match_device(sdhci_at91_dt_match, &pdev->dev);
 313        if (!match)
 314                return -EINVAL;
 315        soc_data = match->data;
 316
 317        host = sdhci_pltfm_init(pdev, soc_data, sizeof(*priv));
 318        if (IS_ERR(host))
 319                return PTR_ERR(host);
 320
 321        pltfm_host = sdhci_priv(host);
 322        priv = sdhci_pltfm_priv(pltfm_host);
 323
 324        priv->mainck = devm_clk_get(&pdev->dev, "baseclk");
 325        if (IS_ERR(priv->mainck)) {
 326                dev_err(&pdev->dev, "failed to get baseclk\n");
 327                return PTR_ERR(priv->mainck);
 328        }
 329
 330        priv->hclock = devm_clk_get(&pdev->dev, "hclock");
 331        if (IS_ERR(priv->hclock)) {
 332                dev_err(&pdev->dev, "failed to get hclock\n");
 333                return PTR_ERR(priv->hclock);
 334        }
 335
 336        priv->gck = devm_clk_get(&pdev->dev, "multclk");
 337        if (IS_ERR(priv->gck)) {
 338                dev_err(&pdev->dev, "failed to get multclk\n");
 339                return PTR_ERR(priv->gck);
 340        }
 341
 342        ret = sdhci_at91_set_clks_presets(&pdev->dev);
 343        if (ret)
 344                goto sdhci_pltfm_free;
 345
 346        priv->restore_needed = false;
 347
 348        ret = mmc_of_parse(host->mmc);
 349        if (ret)
 350                goto clocks_disable_unprepare;
 351
 352        sdhci_get_of_property(pdev);
 353
 354        pm_runtime_get_noresume(&pdev->dev);
 355        pm_runtime_set_active(&pdev->dev);
 356        pm_runtime_enable(&pdev->dev);
 357        pm_runtime_set_autosuspend_delay(&pdev->dev, 50);
 358        pm_runtime_use_autosuspend(&pdev->dev);
 359
 360        ret = sdhci_add_host(host);
 361        if (ret)
 362                goto pm_runtime_disable;
 363
 364        /*
 365         * When calling sdhci_runtime_suspend_host(), the sdhci layer makes
 366         * the assumption that all the clocks of the controller are disabled.
 367         * It means we can't get irq from it when it is runtime suspended.
 368         * For that reason, it is not planned to wake-up on a card detect irq
 369         * from the controller.
 370         * If we want to use runtime PM and to be able to wake-up on card
 371         * insertion, we have to use a GPIO for the card detection or we can
 372         * use polling. Be aware that using polling will resume/suspend the
 373         * controller between each attempt.
 374         * Disable SDHCI_QUIRK_BROKEN_CARD_DETECTION to be sure nobody tries
 375         * to enable polling via device tree with broken-cd property.
 376         */
 377        if (mmc_card_is_removable(host->mmc) &&
 378            mmc_gpio_get_cd(host->mmc) < 0) {
 379                host->mmc->caps |= MMC_CAP_NEEDS_POLL;
 380                host->quirks &= ~SDHCI_QUIRK_BROKEN_CARD_DETECTION;
 381        }
 382
 383        /*
 384         * If the device attached to the MMC bus is not removable, it is safer
 385         * to set the Force Card Detect bit. People often don't connect the
 386         * card detect signal and use this pin for another purpose. If the card
 387         * detect pin is not muxed to SDHCI controller, a default value is
 388         * used. This value can be different from a SoC revision to another
 389         * one. Problems come when this default value is not card present. To
 390         * avoid this case, if the device is non removable then the card
 391         * detection procedure using the SDMCC_CD signal is bypassed.
 392         * This bit is reset when a software reset for all command is performed
 393         * so we need to implement our own reset function to set back this bit.
 394         */
 395        if (host->mmc->caps & MMC_CAP_NONREMOVABLE)
 396                sdhci_at91_set_force_card_detect(host);
 397
 398        pm_runtime_put_autosuspend(&pdev->dev);
 399
 400        return 0;
 401
 402pm_runtime_disable:
 403        pm_runtime_disable(&pdev->dev);
 404        pm_runtime_set_suspended(&pdev->dev);
 405        pm_runtime_put_noidle(&pdev->dev);
 406clocks_disable_unprepare:
 407        clk_disable_unprepare(priv->gck);
 408        clk_disable_unprepare(priv->mainck);
 409        clk_disable_unprepare(priv->hclock);
 410sdhci_pltfm_free:
 411        sdhci_pltfm_free(pdev);
 412        return ret;
 413}
 414
 415static int sdhci_at91_remove(struct platform_device *pdev)
 416{
 417        struct sdhci_host       *host = platform_get_drvdata(pdev);
 418        struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
 419        struct sdhci_at91_priv  *priv = sdhci_pltfm_priv(pltfm_host);
 420        struct clk *gck = priv->gck;
 421        struct clk *hclock = priv->hclock;
 422        struct clk *mainck = priv->mainck;
 423
 424        pm_runtime_get_sync(&pdev->dev);
 425        pm_runtime_disable(&pdev->dev);
 426        pm_runtime_put_noidle(&pdev->dev);
 427
 428        sdhci_pltfm_unregister(pdev);
 429
 430        clk_disable_unprepare(gck);
 431        clk_disable_unprepare(hclock);
 432        clk_disable_unprepare(mainck);
 433
 434        return 0;
 435}
 436
 437static struct platform_driver sdhci_at91_driver = {
 438        .driver         = {
 439                .name   = "sdhci-at91",
 440                .of_match_table = sdhci_at91_dt_match,
 441                .pm     = &sdhci_at91_dev_pm_ops,
 442        },
 443        .probe          = sdhci_at91_probe,
 444        .remove         = sdhci_at91_remove,
 445};
 446
 447module_platform_driver(sdhci_at91_driver);
 448
 449MODULE_DESCRIPTION("SDHCI driver for at91");
 450MODULE_AUTHOR("Ludovic Desroches <ludovic.desroches@atmel.com>");
 451MODULE_LICENSE("GPL v2");
 452