Commit | Line | Data |
---|---|---|
b93931a6 PO |
1 | /* |
2 | * linux/drivers/mmc/core/host.c | |
3 | * | |
4 | * Copyright (C) 2003 Russell King, All Rights Reserved. | |
ff3112f5 | 5 | * Copyright (C) 2007-2008 Pierre Ossman |
04566831 | 6 | * Copyright (C) 2010 Linus Walleij |
b93931a6 PO |
7 | * |
8 | * This program is free software; you can redistribute it and/or modify | |
9 | * it under the terms of the GNU General Public License version 2 as | |
10 | * published by the Free Software Foundation. | |
11 | * | |
12 | * MMC host class device management | |
13 | */ | |
14 | ||
15 | #include <linux/device.h> | |
16 | #include <linux/err.h> | |
17 | #include <linux/idr.h> | |
6c56e7a0 GL |
18 | #include <linux/of.h> |
19 | #include <linux/of_gpio.h> | |
b93931a6 | 20 | #include <linux/pagemap.h> |
3ef77af1 | 21 | #include <linux/export.h> |
af8350c7 | 22 | #include <linux/leds.h> |
5a0e3ad6 | 23 | #include <linux/slab.h> |
4c2ef25f | 24 | #include <linux/suspend.h> |
b93931a6 PO |
25 | |
26 | #include <linux/mmc/host.h> | |
04566831 | 27 | #include <linux/mmc/card.h> |
6c56e7a0 | 28 | #include <linux/mmc/slot-gpio.h> |
b93931a6 PO |
29 | |
30 | #include "core.h" | |
31 | #include "host.h" | |
df8aca16 | 32 | #include "slot-gpio.h" |
3aa8793f | 33 | #include "pwrseq.h" |
b93931a6 PO |
34 | |
35 | #define cls_dev_to_mmc_host(d) container_of(d, struct mmc_host, class_dev) | |
36 | ||
e2d1926b UH |
37 | static DEFINE_IDR(mmc_host_idr); |
38 | static DEFINE_SPINLOCK(mmc_host_lock); | |
39 | ||
b93931a6 PO |
40 | static void mmc_host_classdev_release(struct device *dev) |
41 | { | |
42 | struct mmc_host *host = cls_dev_to_mmc_host(dev); | |
e2d1926b UH |
43 | spin_lock(&mmc_host_lock); |
44 | idr_remove(&mmc_host_idr, host->index); | |
45 | spin_unlock(&mmc_host_lock); | |
b93931a6 PO |
46 | kfree(host); |
47 | } | |
48 | ||
49 | static struct class mmc_host_class = { | |
50 | .name = "mmc_host", | |
51 | .dev_release = mmc_host_classdev_release, | |
52 | }; | |
53 | ||
54 | int mmc_register_host_class(void) | |
55 | { | |
56 | return class_register(&mmc_host_class); | |
57 | } | |
58 | ||
59 | void mmc_unregister_host_class(void) | |
60 | { | |
61 | class_unregister(&mmc_host_class); | |
62 | } | |
63 | ||
dfa13ebb AH |
64 | void mmc_retune_enable(struct mmc_host *host) |
65 | { | |
66 | host->can_retune = 1; | |
67 | if (host->retune_period) | |
68 | mod_timer(&host->retune_timer, | |
69 | jiffies + host->retune_period * HZ); | |
70 | } | |
71 | ||
72 | void mmc_retune_disable(struct mmc_host *host) | |
73 | { | |
74 | host->can_retune = 0; | |
75 | del_timer_sync(&host->retune_timer); | |
76 | host->retune_now = 0; | |
77 | host->need_retune = 0; | |
78 | } | |
79 | ||
80 | void mmc_retune_timer_stop(struct mmc_host *host) | |
81 | { | |
82 | del_timer_sync(&host->retune_timer); | |
83 | } | |
84 | EXPORT_SYMBOL(mmc_retune_timer_stop); | |
85 | ||
86 | void mmc_retune_hold(struct mmc_host *host) | |
87 | { | |
88 | if (!host->hold_retune) | |
89 | host->retune_now = 1; | |
90 | host->hold_retune += 1; | |
91 | } | |
92 | ||
93 | void mmc_retune_release(struct mmc_host *host) | |
94 | { | |
95 | if (host->hold_retune) | |
96 | host->hold_retune -= 1; | |
97 | else | |
98 | WARN_ON(1); | |
99 | } | |
100 | ||
101 | int mmc_retune(struct mmc_host *host) | |
102 | { | |
6376f69d | 103 | bool return_to_hs400 = false; |
dfa13ebb AH |
104 | int err; |
105 | ||
106 | if (host->retune_now) | |
107 | host->retune_now = 0; | |
108 | else | |
109 | return 0; | |
110 | ||
111 | if (!host->need_retune || host->doing_retune || !host->card) | |
112 | return 0; | |
113 | ||
114 | host->need_retune = 0; | |
115 | ||
116 | host->doing_retune = 1; | |
117 | ||
6376f69d AH |
118 | if (host->ios.timing == MMC_TIMING_MMC_HS400) { |
119 | err = mmc_hs400_to_hs200(host->card); | |
120 | if (err) | |
121 | goto out; | |
122 | ||
123 | return_to_hs400 = true; | |
124 | ||
125 | if (host->ops->prepare_hs400_tuning) | |
126 | host->ops->prepare_hs400_tuning(host, &host->ios); | |
127 | } | |
128 | ||
dfa13ebb | 129 | err = mmc_execute_tuning(host->card); |
6376f69d AH |
130 | if (err) |
131 | goto out; | |
dfa13ebb | 132 | |
6376f69d AH |
133 | if (return_to_hs400) |
134 | err = mmc_hs200_to_hs400(host->card); | |
135 | out: | |
dfa13ebb AH |
136 | host->doing_retune = 0; |
137 | ||
138 | return err; | |
139 | } | |
140 | ||
141 | static void mmc_retune_timer(unsigned long data) | |
142 | { | |
143 | struct mmc_host *host = (struct mmc_host *)data; | |
144 | ||
145 | mmc_retune_needed(host); | |
146 | } | |
147 | ||
6c56e7a0 GL |
148 | /** |
149 | * mmc_of_parse() - parse host's device-tree node | |
150 | * @host: host whose node should be parsed. | |
151 | * | |
152 | * To keep the rest of the MMC subsystem unaware of whether DT has been | |
153 | * used to to instantiate and configure this host instance or not, we | |
154 | * parse the properties and set respective generic mmc-host flags and | |
155 | * parameters. | |
156 | */ | |
ec0a7517 | 157 | int mmc_of_parse(struct mmc_host *host) |
6c56e7a0 GL |
158 | { |
159 | struct device_node *np; | |
160 | u32 bus_width; | |
90614cd9 | 161 | int ret; |
a31b0c6c KM |
162 | bool cd_cap_invert, cd_gpio_invert = false; |
163 | bool ro_cap_invert, ro_gpio_invert = false; | |
6c56e7a0 GL |
164 | |
165 | if (!host->parent || !host->parent->of_node) | |
ec0a7517 | 166 | return 0; |
6c56e7a0 GL |
167 | |
168 | np = host->parent->of_node; | |
169 | ||
170 | /* "bus-width" is translated to MMC_CAP_*_BIT_DATA flags */ | |
171 | if (of_property_read_u32(np, "bus-width", &bus_width) < 0) { | |
172 | dev_dbg(host->parent, | |
173 | "\"bus-width\" property is missing, assuming 1 bit.\n"); | |
174 | bus_width = 1; | |
175 | } | |
176 | ||
177 | switch (bus_width) { | |
178 | case 8: | |
179 | host->caps |= MMC_CAP_8_BIT_DATA; | |
180 | /* Hosts capable of 8-bit transfers can also do 4 bits */ | |
181 | case 4: | |
182 | host->caps |= MMC_CAP_4_BIT_DATA; | |
183 | break; | |
184 | case 1: | |
185 | break; | |
186 | default: | |
187 | dev_err(host->parent, | |
1c279f4f | 188 | "Invalid \"bus-width\" value %u!\n", bus_width); |
ec0a7517 | 189 | return -EINVAL; |
6c56e7a0 GL |
190 | } |
191 | ||
192 | /* f_max is obtained from the optional "max-frequency" property */ | |
193 | of_property_read_u32(np, "max-frequency", &host->f_max); | |
194 | ||
195 | /* | |
196 | * Configure CD and WP pins. They are both by default active low to | |
197 | * match the SDHCI spec. If GPIOs are provided for CD and / or WP, the | |
198 | * mmc-gpio helpers are used to attach, configure and use them. If | |
199 | * polarity inversion is specified in DT, one of MMC_CAP2_CD_ACTIVE_HIGH | |
200 | * and MMC_CAP2_RO_ACTIVE_HIGH capability-2 flags is set. If the | |
201 | * "broken-cd" property is provided, the MMC_CAP_NEEDS_POLL capability | |
202 | * is set. If the "non-removable" property is found, the | |
203 | * MMC_CAP_NONREMOVABLE capability is set and no card-detection | |
204 | * configuration is performed. | |
205 | */ | |
206 | ||
207 | /* Parse Card Detection */ | |
90614cd9 | 208 | if (of_property_read_bool(np, "non-removable")) { |
6c56e7a0 GL |
209 | host->caps |= MMC_CAP_NONREMOVABLE; |
210 | } else { | |
a31b0c6c | 211 | cd_cap_invert = of_property_read_bool(np, "cd-inverted"); |
6c56e7a0 | 212 | |
90614cd9 | 213 | if (of_property_read_bool(np, "broken-cd")) |
6c56e7a0 GL |
214 | host->caps |= MMC_CAP_NEEDS_POLL; |
215 | ||
89168b48 | 216 | ret = mmc_gpiod_request_cd(host, "cd", 0, true, |
a31b0c6c | 217 | 0, &cd_gpio_invert); |
9116752f | 218 | if (!ret) |
98e90de9 | 219 | dev_info(host->parent, "Got CD GPIO\n"); |
43934ece | 220 | else if (ret != -ENOENT && ret != -ENOSYS) |
9116752f | 221 | return ret; |
89168b48 LW |
222 | |
223 | /* | |
224 | * There are two ways to flag that the CD line is inverted: | |
225 | * through the cd-inverted flag and by the GPIO line itself | |
226 | * being inverted from the GPIO subsystem. This is a leftover | |
227 | * from the times when the GPIO subsystem did not make it | |
228 | * possible to flag a line as inverted. | |
229 | * | |
230 | * If the capability on the host AND the GPIO line are | |
231 | * both inverted, the end result is that the CD line is | |
232 | * not inverted. | |
233 | */ | |
a31b0c6c | 234 | if (cd_cap_invert ^ cd_gpio_invert) |
89168b48 | 235 | host->caps2 |= MMC_CAP2_CD_ACTIVE_HIGH; |
6c56e7a0 GL |
236 | } |
237 | ||
238 | /* Parse Write Protection */ | |
a31b0c6c | 239 | ro_cap_invert = of_property_read_bool(np, "wp-inverted"); |
6c56e7a0 | 240 | |
a31b0c6c | 241 | ret = mmc_gpiod_request_ro(host, "wp", 0, false, 0, &ro_gpio_invert); |
9116752f | 242 | if (!ret) |
98e90de9 | 243 | dev_info(host->parent, "Got WP GPIO\n"); |
43934ece | 244 | else if (ret != -ENOENT && ret != -ENOSYS) |
9116752f | 245 | return ret; |
2fdb6e2d | 246 | |
19f44246 LPC |
247 | if (of_property_read_bool(np, "disable-wp")) |
248 | host->caps2 |= MMC_CAP2_NO_WRITE_PROTECT; | |
249 | ||
89168b48 | 250 | /* See the comment on CD inversion above */ |
a31b0c6c | 251 | if (ro_cap_invert ^ ro_gpio_invert) |
89168b48 LW |
252 | host->caps2 |= MMC_CAP2_RO_ACTIVE_HIGH; |
253 | ||
90614cd9 | 254 | if (of_property_read_bool(np, "cap-sd-highspeed")) |
2fdb6e2d | 255 | host->caps |= MMC_CAP_SD_HIGHSPEED; |
90614cd9 | 256 | if (of_property_read_bool(np, "cap-mmc-highspeed")) |
2fdb6e2d | 257 | host->caps |= MMC_CAP_MMC_HIGHSPEED; |
90614cd9 | 258 | if (of_property_read_bool(np, "sd-uhs-sdr12")) |
b66bd0e4 | 259 | host->caps |= MMC_CAP_UHS_SDR12; |
90614cd9 | 260 | if (of_property_read_bool(np, "sd-uhs-sdr25")) |
b66bd0e4 | 261 | host->caps |= MMC_CAP_UHS_SDR25; |
90614cd9 | 262 | if (of_property_read_bool(np, "sd-uhs-sdr50")) |
b66bd0e4 | 263 | host->caps |= MMC_CAP_UHS_SDR50; |
90614cd9 | 264 | if (of_property_read_bool(np, "sd-uhs-sdr104")) |
b66bd0e4 | 265 | host->caps |= MMC_CAP_UHS_SDR104; |
90614cd9 | 266 | if (of_property_read_bool(np, "sd-uhs-ddr50")) |
b66bd0e4 | 267 | host->caps |= MMC_CAP_UHS_DDR50; |
90614cd9 | 268 | if (of_property_read_bool(np, "cap-power-off-card")) |
2fdb6e2d | 269 | host->caps |= MMC_CAP_POWER_OFF_CARD; |
794f1578 CJ |
270 | if (of_property_read_bool(np, "cap-mmc-hw-reset")) |
271 | host->caps |= MMC_CAP_HW_RESET; | |
90614cd9 | 272 | if (of_property_read_bool(np, "cap-sdio-irq")) |
2fdb6e2d | 273 | host->caps |= MMC_CAP_SDIO_IRQ; |
90614cd9 | 274 | if (of_property_read_bool(np, "full-pwr-cycle")) |
5a36d6bc | 275 | host->caps2 |= MMC_CAP2_FULL_PWR_CYCLE; |
90614cd9 | 276 | if (of_property_read_bool(np, "keep-power-in-suspend")) |
2fdb6e2d | 277 | host->pm_caps |= MMC_PM_KEEP_POWER; |
90614cd9 | 278 | if (of_property_read_bool(np, "enable-sdio-wakeup")) |
2fdb6e2d | 279 | host->pm_caps |= MMC_PM_WAKE_SDIO_IRQ; |
90614cd9 | 280 | if (of_property_read_bool(np, "mmc-ddr-1_8v")) |
c0baf848 | 281 | host->caps |= MMC_CAP_1_8V_DDR; |
90614cd9 | 282 | if (of_property_read_bool(np, "mmc-ddr-1_2v")) |
c0baf848 | 283 | host->caps |= MMC_CAP_1_2V_DDR; |
90614cd9 | 284 | if (of_property_read_bool(np, "mmc-hs200-1_8v")) |
321bd41d | 285 | host->caps2 |= MMC_CAP2_HS200_1_8V_SDR; |
90614cd9 | 286 | if (of_property_read_bool(np, "mmc-hs200-1_2v")) |
321bd41d | 287 | host->caps2 |= MMC_CAP2_HS200_1_2V_SDR; |
90614cd9 | 288 | if (of_property_read_bool(np, "mmc-hs400-1_8v")) |
c373eb48 | 289 | host->caps2 |= MMC_CAP2_HS400_1_8V | MMC_CAP2_HS200_1_8V_SDR; |
90614cd9 | 290 | if (of_property_read_bool(np, "mmc-hs400-1_2v")) |
c373eb48 | 291 | host->caps2 |= MMC_CAP2_HS400_1_2V | MMC_CAP2_HS200_1_2V_SDR; |
ec0a7517 | 292 | |
3d705d14 SH |
293 | host->dsr_req = !of_property_read_u32(np, "dsr", &host->dsr); |
294 | if (host->dsr_req && (host->dsr & ~0xffff)) { | |
295 | dev_err(host->parent, | |
296 | "device tree specified broken value for DSR: 0x%x, ignoring\n", | |
297 | host->dsr); | |
298 | host->dsr_req = 0; | |
299 | } | |
300 | ||
3aa8793f | 301 | return mmc_pwrseq_alloc(host); |
6c56e7a0 GL |
302 | } |
303 | ||
304 | EXPORT_SYMBOL(mmc_of_parse); | |
305 | ||
b93931a6 PO |
306 | /** |
307 | * mmc_alloc_host - initialise the per-host structure. | |
308 | * @extra: sizeof private data structure | |
309 | * @dev: pointer to host device model structure | |
310 | * | |
311 | * Initialise the per-host structure. | |
312 | */ | |
313 | struct mmc_host *mmc_alloc_host(int extra, struct device *dev) | |
314 | { | |
ff3112f5 | 315 | int err; |
b93931a6 PO |
316 | struct mmc_host *host; |
317 | ||
be760a9d | 318 | host = kzalloc(sizeof(struct mmc_host) + extra, GFP_KERNEL); |
b93931a6 PO |
319 | if (!host) |
320 | return NULL; | |
321 | ||
d9adcc12 GL |
322 | /* scanning will be enabled when we're ready */ |
323 | host->rescan_disable = 1; | |
803d9e04 | 324 | idr_preload(GFP_KERNEL); |
ff3112f5 | 325 | spin_lock(&mmc_host_lock); |
803d9e04 TH |
326 | err = idr_alloc(&mmc_host_idr, host, 0, 0, GFP_NOWAIT); |
327 | if (err >= 0) | |
328 | host->index = err; | |
ff3112f5 | 329 | spin_unlock(&mmc_host_lock); |
803d9e04 | 330 | idr_preload_end(); |
df8aca16 UH |
331 | if (err < 0) { |
332 | kfree(host); | |
333 | return NULL; | |
334 | } | |
ff3112f5 | 335 | |
d1b26863 | 336 | dev_set_name(&host->class_dev, "mmc%d", host->index); |
ff3112f5 | 337 | |
b93931a6 PO |
338 | host->parent = dev; |
339 | host->class_dev.parent = dev; | |
340 | host->class_dev.class = &mmc_host_class; | |
341 | device_initialize(&host->class_dev); | |
342 | ||
df8aca16 UH |
343 | if (mmc_gpio_alloc(host)) { |
344 | put_device(&host->class_dev); | |
345 | return NULL; | |
346 | } | |
04566831 | 347 | |
b93931a6 PO |
348 | spin_lock_init(&host->lock); |
349 | init_waitqueue_head(&host->wq); | |
350 | INIT_DELAYED_WORK(&host->detect, mmc_rescan); | |
81ca03a0 | 351 | #ifdef CONFIG_PM |
4c2ef25f | 352 | host->pm_notify.notifier_call = mmc_pm_notify; |
81ca03a0 | 353 | #endif |
dfa13ebb | 354 | setup_timer(&host->retune_timer, mmc_retune_timer, (unsigned long)host); |
b93931a6 PO |
355 | |
356 | /* | |
357 | * By default, hosts do not support SGIO or large requests. | |
358 | * They have to set these according to their abilities. | |
359 | */ | |
a36274e0 | 360 | host->max_segs = 1; |
b93931a6 PO |
361 | host->max_seg_size = PAGE_CACHE_SIZE; |
362 | ||
363 | host->max_req_size = PAGE_CACHE_SIZE; | |
364 | host->max_blk_size = 512; | |
365 | host->max_blk_count = PAGE_CACHE_SIZE / 512; | |
366 | ||
367 | return host; | |
368 | } | |
369 | ||
370 | EXPORT_SYMBOL(mmc_alloc_host); | |
371 | ||
372 | /** | |
373 | * mmc_add_host - initialise host hardware | |
374 | * @host: mmc host | |
67a61c48 PO |
375 | * |
376 | * Register the host with the driver model. The host must be | |
377 | * prepared to start servicing requests before this function | |
378 | * completes. | |
b93931a6 PO |
379 | */ |
380 | int mmc_add_host(struct mmc_host *host) | |
381 | { | |
382 | int err; | |
383 | ||
17b759af NP |
384 | WARN_ON((host->caps & MMC_CAP_SDIO_IRQ) && |
385 | !host->ops->enable_sdio_irq); | |
386 | ||
b93931a6 PO |
387 | err = device_add(&host->class_dev); |
388 | if (err) | |
389 | return err; | |
390 | ||
f317dfeb WS |
391 | led_trigger_register_simple(dev_name(&host->class_dev), &host->led); |
392 | ||
6edd8ee6 HS |
393 | #ifdef CONFIG_DEBUG_FS |
394 | mmc_add_host_debugfs(host); | |
395 | #endif | |
396 | ||
b93931a6 | 397 | mmc_start_host(host); |
e910f206 DS |
398 | if (!(host->pm_flags & MMC_PM_IGNORE_PM_NOTIFY)) |
399 | register_pm_notifier(&host->pm_notify); | |
b93931a6 PO |
400 | |
401 | return 0; | |
402 | } | |
403 | ||
404 | EXPORT_SYMBOL(mmc_add_host); | |
405 | ||
406 | /** | |
407 | * mmc_remove_host - remove host hardware | |
408 | * @host: mmc host | |
409 | * | |
410 | * Unregister and remove all cards associated with this host, | |
67a61c48 PO |
411 | * and power down the MMC bus. No new requests will be issued |
412 | * after this function has returned. | |
b93931a6 PO |
413 | */ |
414 | void mmc_remove_host(struct mmc_host *host) | |
415 | { | |
e910f206 DS |
416 | if (!(host->pm_flags & MMC_PM_IGNORE_PM_NOTIFY)) |
417 | unregister_pm_notifier(&host->pm_notify); | |
418 | ||
b93931a6 PO |
419 | mmc_stop_host(host); |
420 | ||
6edd8ee6 HS |
421 | #ifdef CONFIG_DEBUG_FS |
422 | mmc_remove_host_debugfs(host); | |
423 | #endif | |
424 | ||
b93931a6 PO |
425 | device_del(&host->class_dev); |
426 | ||
77f1fd6e | 427 | led_trigger_unregister_simple(host->led); |
b93931a6 PO |
428 | } |
429 | ||
430 | EXPORT_SYMBOL(mmc_remove_host); | |
431 | ||
432 | /** | |
433 | * mmc_free_host - free the host structure | |
434 | * @host: mmc host | |
435 | * | |
436 | * Free the host once all references to it have been dropped. | |
437 | */ | |
438 | void mmc_free_host(struct mmc_host *host) | |
439 | { | |
3aa8793f | 440 | mmc_pwrseq_free(host); |
b93931a6 PO |
441 | put_device(&host->class_dev); |
442 | } | |
443 | ||
444 | EXPORT_SYMBOL(mmc_free_host); |