xref: /linux/drivers/mmc/host/sdhci-of-at91.c (revision 44f57d78)
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 
33 struct sdhci_at91_priv {
34 	struct clk *hclock;
35 	struct clk *gck;
36 	struct clk *mainck;
37 	bool restore_needed;
38 };
39 
40 static 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 
49 static 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  */
98 static 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 
109 static 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 
117 static 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 
125 static 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 
133 static const struct sdhci_pltfm_data soc_data_sama5d2 = {
134 	.ops = &sdhci_at91_sama5d2_ops,
135 };
136 
137 static const struct of_device_id sdhci_at91_dt_match[] = {
138 	{ .compatible = "atmel,sama5d2-sdhci", .data = &soc_data_sama5d2 },
139 	{}
140 };
141 MODULE_DEVICE_TABLE(of, sdhci_at91_dt_match);
142 
143 static 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
222 static 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
238 static 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 
257 static 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 
291 out:
292 	return sdhci_runtime_resume_host(host);
293 }
294 #endif /* CONFIG_PM */
295 
296 static 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 
303 static 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 
402 pm_runtime_disable:
403 	pm_runtime_disable(&pdev->dev);
404 	pm_runtime_set_suspended(&pdev->dev);
405 	pm_runtime_put_noidle(&pdev->dev);
406 clocks_disable_unprepare:
407 	clk_disable_unprepare(priv->gck);
408 	clk_disable_unprepare(priv->mainck);
409 	clk_disable_unprepare(priv->hclock);
410 sdhci_pltfm_free:
411 	sdhci_pltfm_free(pdev);
412 	return ret;
413 }
414 
415 static 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 
437 static 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 
447 module_platform_driver(sdhci_at91_driver);
448 
449 MODULE_DESCRIPTION("SDHCI driver for at91");
450 MODULE_AUTHOR("Ludovic Desroches <ludovic.desroches@atmel.com>");
451 MODULE_LICENSE("GPL v2");
452