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