host.c 12 KB

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