xref: /openbmc/linux/drivers/mmc/host/sdhci-cadence.c (revision e721eb06)
1 // SPDX-License-Identifier: GPL-2.0-or-later
2 /*
3  * Copyright (C) 2016 Socionext Inc.
4  *   Author: Masahiro Yamada <yamada.masahiro@socionext.com>
5  */
6 
7 #include <linux/bitfield.h>
8 #include <linux/bits.h>
9 #include <linux/iopoll.h>
10 #include <linux/module.h>
11 #include <linux/mmc/host.h>
12 #include <linux/mmc/mmc.h>
13 #include <linux/of.h>
14 #include <linux/of_device.h>
15 
16 #include "sdhci-pltfm.h"
17 
18 /* HRS - Host Register Set (specific to Cadence) */
19 #define SDHCI_CDNS_HRS04		0x10		/* PHY access port */
20 #define   SDHCI_CDNS_HRS04_ACK			BIT(26)
21 #define   SDHCI_CDNS_HRS04_RD			BIT(25)
22 #define   SDHCI_CDNS_HRS04_WR			BIT(24)
23 #define   SDHCI_CDNS_HRS04_RDATA		GENMASK(23, 16)
24 #define   SDHCI_CDNS_HRS04_WDATA		GENMASK(15, 8)
25 #define   SDHCI_CDNS_HRS04_ADDR			GENMASK(5, 0)
26 
27 #define SDHCI_CDNS_HRS06		0x18		/* eMMC control */
28 #define   SDHCI_CDNS_HRS06_TUNE_UP		BIT(15)
29 #define   SDHCI_CDNS_HRS06_TUNE			GENMASK(13, 8)
30 #define   SDHCI_CDNS_HRS06_MODE			GENMASK(2, 0)
31 #define   SDHCI_CDNS_HRS06_MODE_SD		0x0
32 #define   SDHCI_CDNS_HRS06_MODE_MMC_SDR		0x2
33 #define   SDHCI_CDNS_HRS06_MODE_MMC_DDR		0x3
34 #define   SDHCI_CDNS_HRS06_MODE_MMC_HS200	0x4
35 #define   SDHCI_CDNS_HRS06_MODE_MMC_HS400	0x5
36 #define   SDHCI_CDNS_HRS06_MODE_MMC_HS400ES	0x6
37 
38 /* SRS - Slot Register Set (SDHCI-compatible) */
39 #define SDHCI_CDNS_SRS_BASE		0x200
40 
41 /* PHY */
42 #define SDHCI_CDNS_PHY_DLY_SD_HS	0x00
43 #define SDHCI_CDNS_PHY_DLY_SD_DEFAULT	0x01
44 #define SDHCI_CDNS_PHY_DLY_UHS_SDR12	0x02
45 #define SDHCI_CDNS_PHY_DLY_UHS_SDR25	0x03
46 #define SDHCI_CDNS_PHY_DLY_UHS_SDR50	0x04
47 #define SDHCI_CDNS_PHY_DLY_UHS_DDR50	0x05
48 #define SDHCI_CDNS_PHY_DLY_EMMC_LEGACY	0x06
49 #define SDHCI_CDNS_PHY_DLY_EMMC_SDR	0x07
50 #define SDHCI_CDNS_PHY_DLY_EMMC_DDR	0x08
51 #define SDHCI_CDNS_PHY_DLY_SDCLK	0x0b
52 #define SDHCI_CDNS_PHY_DLY_HSMMC	0x0c
53 #define SDHCI_CDNS_PHY_DLY_STROBE	0x0d
54 
55 /*
56  * The tuned val register is 6 bit-wide, but not the whole of the range is
57  * available.  The range 0-42 seems to be available (then 43 wraps around to 0)
58  * but I am not quite sure if it is official.  Use only 0 to 39 for safety.
59  */
60 #define SDHCI_CDNS_MAX_TUNING_LOOP	40
61 
62 struct sdhci_cdns_phy_param {
63 	u8 addr;
64 	u8 data;
65 };
66 
67 struct sdhci_cdns_priv {
68 	void __iomem *hrs_addr;
69 	bool enhanced_strobe;
70 	unsigned int nr_phy_params;
71 	struct sdhci_cdns_phy_param phy_params[];
72 };
73 
74 struct sdhci_cdns_phy_cfg {
75 	const char *property;
76 	u8 addr;
77 };
78 
79 static const struct sdhci_cdns_phy_cfg sdhci_cdns_phy_cfgs[] = {
80 	{ "cdns,phy-input-delay-sd-highspeed", SDHCI_CDNS_PHY_DLY_SD_HS, },
81 	{ "cdns,phy-input-delay-legacy", SDHCI_CDNS_PHY_DLY_SD_DEFAULT, },
82 	{ "cdns,phy-input-delay-sd-uhs-sdr12", SDHCI_CDNS_PHY_DLY_UHS_SDR12, },
83 	{ "cdns,phy-input-delay-sd-uhs-sdr25", SDHCI_CDNS_PHY_DLY_UHS_SDR25, },
84 	{ "cdns,phy-input-delay-sd-uhs-sdr50", SDHCI_CDNS_PHY_DLY_UHS_SDR50, },
85 	{ "cdns,phy-input-delay-sd-uhs-ddr50", SDHCI_CDNS_PHY_DLY_UHS_DDR50, },
86 	{ "cdns,phy-input-delay-mmc-highspeed", SDHCI_CDNS_PHY_DLY_EMMC_SDR, },
87 	{ "cdns,phy-input-delay-mmc-ddr", SDHCI_CDNS_PHY_DLY_EMMC_DDR, },
88 	{ "cdns,phy-dll-delay-sdclk", SDHCI_CDNS_PHY_DLY_SDCLK, },
89 	{ "cdns,phy-dll-delay-sdclk-hsmmc", SDHCI_CDNS_PHY_DLY_HSMMC, },
90 	{ "cdns,phy-dll-delay-strobe", SDHCI_CDNS_PHY_DLY_STROBE, },
91 };
92 
93 static int sdhci_cdns_write_phy_reg(struct sdhci_cdns_priv *priv,
94 				    u8 addr, u8 data)
95 {
96 	void __iomem *reg = priv->hrs_addr + SDHCI_CDNS_HRS04;
97 	u32 tmp;
98 	int ret;
99 
100 	ret = readl_poll_timeout(reg, tmp, !(tmp & SDHCI_CDNS_HRS04_ACK),
101 				 0, 10);
102 	if (ret)
103 		return ret;
104 
105 	tmp = FIELD_PREP(SDHCI_CDNS_HRS04_WDATA, data) |
106 	      FIELD_PREP(SDHCI_CDNS_HRS04_ADDR, addr);
107 	writel(tmp, reg);
108 
109 	tmp |= SDHCI_CDNS_HRS04_WR;
110 	writel(tmp, reg);
111 
112 	ret = readl_poll_timeout(reg, tmp, tmp & SDHCI_CDNS_HRS04_ACK, 0, 10);
113 	if (ret)
114 		return ret;
115 
116 	tmp &= ~SDHCI_CDNS_HRS04_WR;
117 	writel(tmp, reg);
118 
119 	ret = readl_poll_timeout(reg, tmp, !(tmp & SDHCI_CDNS_HRS04_ACK),
120 				 0, 10);
121 
122 	return ret;
123 }
124 
125 static unsigned int sdhci_cdns_phy_param_count(struct device_node *np)
126 {
127 	unsigned int count = 0;
128 	int i;
129 
130 	for (i = 0; i < ARRAY_SIZE(sdhci_cdns_phy_cfgs); i++)
131 		if (of_property_read_bool(np, sdhci_cdns_phy_cfgs[i].property))
132 			count++;
133 
134 	return count;
135 }
136 
137 static void sdhci_cdns_phy_param_parse(struct device_node *np,
138 				       struct sdhci_cdns_priv *priv)
139 {
140 	struct sdhci_cdns_phy_param *p = priv->phy_params;
141 	u32 val;
142 	int ret, i;
143 
144 	for (i = 0; i < ARRAY_SIZE(sdhci_cdns_phy_cfgs); i++) {
145 		ret = of_property_read_u32(np, sdhci_cdns_phy_cfgs[i].property,
146 					   &val);
147 		if (ret)
148 			continue;
149 
150 		p->addr = sdhci_cdns_phy_cfgs[i].addr;
151 		p->data = val;
152 		p++;
153 	}
154 }
155 
156 static int sdhci_cdns_phy_init(struct sdhci_cdns_priv *priv)
157 {
158 	int ret, i;
159 
160 	for (i = 0; i < priv->nr_phy_params; i++) {
161 		ret = sdhci_cdns_write_phy_reg(priv, priv->phy_params[i].addr,
162 					       priv->phy_params[i].data);
163 		if (ret)
164 			return ret;
165 	}
166 
167 	return 0;
168 }
169 
170 static void *sdhci_cdns_priv(struct sdhci_host *host)
171 {
172 	struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
173 
174 	return sdhci_pltfm_priv(pltfm_host);
175 }
176 
177 static unsigned int sdhci_cdns_get_timeout_clock(struct sdhci_host *host)
178 {
179 	/*
180 	 * Cadence's spec says the Timeout Clock Frequency is the same as the
181 	 * Base Clock Frequency.
182 	 */
183 	return host->max_clk;
184 }
185 
186 static void sdhci_cdns_set_emmc_mode(struct sdhci_cdns_priv *priv, u32 mode)
187 {
188 	u32 tmp;
189 
190 	/* The speed mode for eMMC is selected by HRS06 register */
191 	tmp = readl(priv->hrs_addr + SDHCI_CDNS_HRS06);
192 	tmp &= ~SDHCI_CDNS_HRS06_MODE;
193 	tmp |= FIELD_PREP(SDHCI_CDNS_HRS06_MODE, mode);
194 	writel(tmp, priv->hrs_addr + SDHCI_CDNS_HRS06);
195 }
196 
197 static u32 sdhci_cdns_get_emmc_mode(struct sdhci_cdns_priv *priv)
198 {
199 	u32 tmp;
200 
201 	tmp = readl(priv->hrs_addr + SDHCI_CDNS_HRS06);
202 	return FIELD_GET(SDHCI_CDNS_HRS06_MODE, tmp);
203 }
204 
205 static void sdhci_cdns_set_uhs_signaling(struct sdhci_host *host,
206 					 unsigned int timing)
207 {
208 	struct sdhci_cdns_priv *priv = sdhci_cdns_priv(host);
209 	u32 mode;
210 
211 	switch (timing) {
212 	case MMC_TIMING_MMC_HS:
213 		mode = SDHCI_CDNS_HRS06_MODE_MMC_SDR;
214 		break;
215 	case MMC_TIMING_MMC_DDR52:
216 		mode = SDHCI_CDNS_HRS06_MODE_MMC_DDR;
217 		break;
218 	case MMC_TIMING_MMC_HS200:
219 		mode = SDHCI_CDNS_HRS06_MODE_MMC_HS200;
220 		break;
221 	case MMC_TIMING_MMC_HS400:
222 		if (priv->enhanced_strobe)
223 			mode = SDHCI_CDNS_HRS06_MODE_MMC_HS400ES;
224 		else
225 			mode = SDHCI_CDNS_HRS06_MODE_MMC_HS400;
226 		break;
227 	default:
228 		mode = SDHCI_CDNS_HRS06_MODE_SD;
229 		break;
230 	}
231 
232 	sdhci_cdns_set_emmc_mode(priv, mode);
233 
234 	/* For SD, fall back to the default handler */
235 	if (mode == SDHCI_CDNS_HRS06_MODE_SD)
236 		sdhci_set_uhs_signaling(host, timing);
237 }
238 
239 static const struct sdhci_ops sdhci_cdns_ops = {
240 	.set_clock = sdhci_set_clock,
241 	.get_timeout_clock = sdhci_cdns_get_timeout_clock,
242 	.set_bus_width = sdhci_set_bus_width,
243 	.reset = sdhci_reset,
244 	.set_uhs_signaling = sdhci_cdns_set_uhs_signaling,
245 };
246 
247 static const struct sdhci_pltfm_data sdhci_cdns_uniphier_pltfm_data = {
248 	.ops = &sdhci_cdns_ops,
249 	.quirks2 = SDHCI_QUIRK2_PRESET_VALUE_BROKEN,
250 };
251 
252 static const struct sdhci_pltfm_data sdhci_cdns_pltfm_data = {
253 	.ops = &sdhci_cdns_ops,
254 };
255 
256 static int sdhci_cdns_set_tune_val(struct sdhci_host *host, unsigned int val)
257 {
258 	struct sdhci_cdns_priv *priv = sdhci_cdns_priv(host);
259 	void __iomem *reg = priv->hrs_addr + SDHCI_CDNS_HRS06;
260 	u32 tmp;
261 	int i, ret;
262 
263 	if (WARN_ON(!FIELD_FIT(SDHCI_CDNS_HRS06_TUNE, val)))
264 		return -EINVAL;
265 
266 	tmp = readl(reg);
267 	tmp &= ~SDHCI_CDNS_HRS06_TUNE;
268 	tmp |= FIELD_PREP(SDHCI_CDNS_HRS06_TUNE, val);
269 
270 	/*
271 	 * Workaround for IP errata:
272 	 * The IP6116 SD/eMMC PHY design has a timing issue on receive data
273 	 * path. Send tune request twice.
274 	 */
275 	for (i = 0; i < 2; i++) {
276 		tmp |= SDHCI_CDNS_HRS06_TUNE_UP;
277 		writel(tmp, reg);
278 
279 		ret = readl_poll_timeout(reg, tmp,
280 					 !(tmp & SDHCI_CDNS_HRS06_TUNE_UP),
281 					 0, 1);
282 		if (ret)
283 			return ret;
284 	}
285 
286 	return 0;
287 }
288 
289 static int sdhci_cdns_execute_tuning(struct mmc_host *mmc, u32 opcode)
290 {
291 	struct sdhci_host *host = mmc_priv(mmc);
292 	int cur_streak = 0;
293 	int max_streak = 0;
294 	int end_of_streak = 0;
295 	int i;
296 
297 	/*
298 	 * This handler only implements the eMMC tuning that is specific to
299 	 * this controller.  Fall back to the standard method for SD timing.
300 	 */
301 	if (host->timing != MMC_TIMING_MMC_HS200)
302 		return sdhci_execute_tuning(mmc, opcode);
303 
304 	if (WARN_ON(opcode != MMC_SEND_TUNING_BLOCK_HS200))
305 		return -EINVAL;
306 
307 	for (i = 0; i < SDHCI_CDNS_MAX_TUNING_LOOP; i++) {
308 		if (sdhci_cdns_set_tune_val(host, i) ||
309 		    mmc_send_tuning(host->mmc, opcode, NULL)) { /* bad */
310 			cur_streak = 0;
311 		} else { /* good */
312 			cur_streak++;
313 			if (cur_streak > max_streak) {
314 				max_streak = cur_streak;
315 				end_of_streak = i;
316 			}
317 		}
318 	}
319 
320 	if (!max_streak) {
321 		dev_err(mmc_dev(host->mmc), "no tuning point found\n");
322 		return -EIO;
323 	}
324 
325 	return sdhci_cdns_set_tune_val(host, end_of_streak - max_streak / 2);
326 }
327 
328 static void sdhci_cdns_hs400_enhanced_strobe(struct mmc_host *mmc,
329 					     struct mmc_ios *ios)
330 {
331 	struct sdhci_host *host = mmc_priv(mmc);
332 	struct sdhci_cdns_priv *priv = sdhci_cdns_priv(host);
333 	u32 mode;
334 
335 	priv->enhanced_strobe = ios->enhanced_strobe;
336 
337 	mode = sdhci_cdns_get_emmc_mode(priv);
338 
339 	if (mode == SDHCI_CDNS_HRS06_MODE_MMC_HS400 && ios->enhanced_strobe)
340 		sdhci_cdns_set_emmc_mode(priv,
341 					 SDHCI_CDNS_HRS06_MODE_MMC_HS400ES);
342 
343 	if (mode == SDHCI_CDNS_HRS06_MODE_MMC_HS400ES && !ios->enhanced_strobe)
344 		sdhci_cdns_set_emmc_mode(priv,
345 					 SDHCI_CDNS_HRS06_MODE_MMC_HS400);
346 }
347 
348 static int sdhci_cdns_probe(struct platform_device *pdev)
349 {
350 	struct sdhci_host *host;
351 	const struct sdhci_pltfm_data *data;
352 	struct sdhci_pltfm_host *pltfm_host;
353 	struct sdhci_cdns_priv *priv;
354 	struct clk *clk;
355 	unsigned int nr_phy_params;
356 	int ret;
357 	struct device *dev = &pdev->dev;
358 	static const u16 version = SDHCI_SPEC_400 << SDHCI_SPEC_VER_SHIFT;
359 
360 	clk = devm_clk_get(dev, NULL);
361 	if (IS_ERR(clk))
362 		return PTR_ERR(clk);
363 
364 	ret = clk_prepare_enable(clk);
365 	if (ret)
366 		return ret;
367 
368 	data = of_device_get_match_data(dev);
369 	if (!data)
370 		data = &sdhci_cdns_pltfm_data;
371 
372 	nr_phy_params = sdhci_cdns_phy_param_count(dev->of_node);
373 	host = sdhci_pltfm_init(pdev, data,
374 				struct_size(priv, phy_params, nr_phy_params));
375 	if (IS_ERR(host)) {
376 		ret = PTR_ERR(host);
377 		goto disable_clk;
378 	}
379 
380 	pltfm_host = sdhci_priv(host);
381 	pltfm_host->clk = clk;
382 
383 	priv = sdhci_pltfm_priv(pltfm_host);
384 	priv->nr_phy_params = nr_phy_params;
385 	priv->hrs_addr = host->ioaddr;
386 	priv->enhanced_strobe = false;
387 	host->ioaddr += SDHCI_CDNS_SRS_BASE;
388 	host->mmc_host_ops.execute_tuning = sdhci_cdns_execute_tuning;
389 	host->mmc_host_ops.hs400_enhanced_strobe =
390 				sdhci_cdns_hs400_enhanced_strobe;
391 	sdhci_enable_v4_mode(host);
392 	__sdhci_read_caps(host, &version, NULL, NULL);
393 
394 	sdhci_get_of_property(pdev);
395 
396 	ret = mmc_of_parse(host->mmc);
397 	if (ret)
398 		goto free;
399 
400 	sdhci_cdns_phy_param_parse(dev->of_node, priv);
401 
402 	ret = sdhci_cdns_phy_init(priv);
403 	if (ret)
404 		goto free;
405 
406 	ret = sdhci_add_host(host);
407 	if (ret)
408 		goto free;
409 
410 	return 0;
411 free:
412 	sdhci_pltfm_free(pdev);
413 disable_clk:
414 	clk_disable_unprepare(clk);
415 
416 	return ret;
417 }
418 
419 #ifdef CONFIG_PM_SLEEP
420 static int sdhci_cdns_resume(struct device *dev)
421 {
422 	struct sdhci_host *host = dev_get_drvdata(dev);
423 	struct sdhci_pltfm_host *pltfm_host = sdhci_priv(host);
424 	struct sdhci_cdns_priv *priv = sdhci_pltfm_priv(pltfm_host);
425 	int ret;
426 
427 	ret = clk_prepare_enable(pltfm_host->clk);
428 	if (ret)
429 		return ret;
430 
431 	ret = sdhci_cdns_phy_init(priv);
432 	if (ret)
433 		goto disable_clk;
434 
435 	ret = sdhci_resume_host(host);
436 	if (ret)
437 		goto disable_clk;
438 
439 	return 0;
440 
441 disable_clk:
442 	clk_disable_unprepare(pltfm_host->clk);
443 
444 	return ret;
445 }
446 #endif
447 
448 static const struct dev_pm_ops sdhci_cdns_pm_ops = {
449 	SET_SYSTEM_SLEEP_PM_OPS(sdhci_pltfm_suspend, sdhci_cdns_resume)
450 };
451 
452 static const struct of_device_id sdhci_cdns_match[] = {
453 	{
454 		.compatible = "socionext,uniphier-sd4hc",
455 		.data = &sdhci_cdns_uniphier_pltfm_data,
456 	},
457 	{ .compatible = "cdns,sd4hc" },
458 	{ /* sentinel */ }
459 };
460 MODULE_DEVICE_TABLE(of, sdhci_cdns_match);
461 
462 static struct platform_driver sdhci_cdns_driver = {
463 	.driver = {
464 		.name = "sdhci-cdns",
465 		.pm = &sdhci_cdns_pm_ops,
466 		.of_match_table = sdhci_cdns_match,
467 	},
468 	.probe = sdhci_cdns_probe,
469 	.remove = sdhci_pltfm_unregister,
470 };
471 module_platform_driver(sdhci_cdns_driver);
472 
473 MODULE_AUTHOR("Masahiro Yamada <yamada.masahiro@socionext.com>");
474 MODULE_DESCRIPTION("Cadence SD/SDIO/eMMC Host Controller Driver");
475 MODULE_LICENSE("GPL");
476