bus.c 8.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420
  1. // SPDX-License-Identifier: GPL-2.0-only
  2. /*
  3. * linux/drivers/mmc/core/bus.c
  4. *
  5. * Copyright (C) 2003 Russell King, All Rights Reserved.
  6. * Copyright (C) 2007 Pierre Ossman
  7. *
  8. * MMC card bus driver model
  9. */
  10. #include <linux/export.h>
  11. #include <linux/device.h>
  12. #include <linux/err.h>
  13. #include <linux/slab.h>
  14. #include <linux/stat.h>
  15. #include <linux/of.h>
  16. #include <linux/pm_runtime.h>
  17. #include <linux/mmc/card.h>
  18. #include <linux/mmc/host.h>
  19. #include "core.h"
  20. #include "card.h"
  21. #include "host.h"
  22. #include "sdio_cis.h"
  23. #include "bus.h"
  24. #define to_mmc_driver(d) container_of(d, struct mmc_driver, drv)
  25. static ssize_t type_show(struct device *dev,
  26. struct device_attribute *attr, char *buf)
  27. {
  28. struct mmc_card *card = mmc_dev_to_card(dev);
  29. switch (card->type) {
  30. case MMC_TYPE_MMC:
  31. return sprintf(buf, "MMC\n");
  32. case MMC_TYPE_SD:
  33. return sprintf(buf, "SD\n");
  34. case MMC_TYPE_SDIO:
  35. return sprintf(buf, "SDIO\n");
  36. case MMC_TYPE_SD_COMBO:
  37. return sprintf(buf, "SDcombo\n");
  38. default:
  39. return -EFAULT;
  40. }
  41. }
  42. static DEVICE_ATTR_RO(type);
  43. static struct attribute *mmc_dev_attrs[] = {
  44. &dev_attr_type.attr,
  45. NULL,
  46. };
  47. ATTRIBUTE_GROUPS(mmc_dev);
  48. /*
  49. * This currently matches any MMC driver to any MMC card - drivers
  50. * themselves make the decision whether to drive this card in their
  51. * probe method.
  52. */
  53. static int mmc_bus_match(struct device *dev, struct device_driver *drv)
  54. {
  55. return 1;
  56. }
  57. static int
  58. mmc_bus_uevent(struct device *dev, struct kobj_uevent_env *env)
  59. {
  60. struct mmc_card *card = mmc_dev_to_card(dev);
  61. const char *type;
  62. unsigned int i;
  63. int retval = 0;
  64. switch (card->type) {
  65. case MMC_TYPE_MMC:
  66. type = "MMC";
  67. break;
  68. case MMC_TYPE_SD:
  69. type = "SD";
  70. break;
  71. case MMC_TYPE_SDIO:
  72. type = "SDIO";
  73. break;
  74. case MMC_TYPE_SD_COMBO:
  75. type = "SDcombo";
  76. break;
  77. default:
  78. type = NULL;
  79. }
  80. if (type) {
  81. retval = add_uevent_var(env, "MMC_TYPE=%s", type);
  82. if (retval)
  83. return retval;
  84. }
  85. if (card->type == MMC_TYPE_SDIO || card->type == MMC_TYPE_SD_COMBO) {
  86. retval = add_uevent_var(env, "SDIO_ID=%04X:%04X",
  87. card->cis.vendor, card->cis.device);
  88. if (retval)
  89. return retval;
  90. retval = add_uevent_var(env, "SDIO_REVISION=%u.%u",
  91. card->major_rev, card->minor_rev);
  92. if (retval)
  93. return retval;
  94. for (i = 0; i < card->num_info; i++) {
  95. retval = add_uevent_var(env, "SDIO_INFO%u=%s", i+1, card->info[i]);
  96. if (retval)
  97. return retval;
  98. }
  99. }
  100. /*
  101. * SDIO (non-combo) cards are not handled by mmc_block driver and do not
  102. * have accessible CID register which used by mmc_card_name() function.
  103. */
  104. if (card->type == MMC_TYPE_SDIO)
  105. return 0;
  106. retval = add_uevent_var(env, "MMC_NAME=%s", mmc_card_name(card));
  107. if (retval)
  108. return retval;
  109. /*
  110. * Request the mmc_block device. Note: that this is a direct request
  111. * for the module it carries no information as to what is inserted.
  112. */
  113. retval = add_uevent_var(env, "MODALIAS=mmc:block");
  114. return retval;
  115. }
  116. static int mmc_bus_probe(struct device *dev)
  117. {
  118. struct mmc_driver *drv = to_mmc_driver(dev->driver);
  119. struct mmc_card *card = mmc_dev_to_card(dev);
  120. return drv->probe(card);
  121. }
  122. static int mmc_bus_remove(struct device *dev)
  123. {
  124. struct mmc_driver *drv = to_mmc_driver(dev->driver);
  125. struct mmc_card *card = mmc_dev_to_card(dev);
  126. drv->remove(card);
  127. return 0;
  128. }
  129. static void mmc_bus_shutdown(struct device *dev)
  130. {
  131. struct mmc_driver *drv = to_mmc_driver(dev->driver);
  132. struct mmc_card *card = mmc_dev_to_card(dev);
  133. struct mmc_host *host = card->host;
  134. int ret;
  135. if (dev->driver && drv->shutdown)
  136. drv->shutdown(card);
  137. if (host->bus_ops->shutdown) {
  138. ret = host->bus_ops->shutdown(host);
  139. if (ret)
  140. pr_warn("%s: error %d during shutdown\n",
  141. mmc_hostname(host), ret);
  142. }
  143. }
  144. #ifdef CONFIG_PM_SLEEP
  145. static int mmc_bus_suspend(struct device *dev)
  146. {
  147. struct mmc_card *card = mmc_dev_to_card(dev);
  148. struct mmc_host *host = card->host;
  149. int ret;
  150. ret = pm_generic_suspend(dev);
  151. if (ret)
  152. return ret;
  153. ret = host->bus_ops->suspend(host);
  154. if (ret)
  155. pm_generic_resume(dev);
  156. return ret;
  157. }
  158. static int mmc_bus_resume(struct device *dev)
  159. {
  160. struct mmc_card *card = mmc_dev_to_card(dev);
  161. struct mmc_host *host = card->host;
  162. int ret;
  163. ret = host->bus_ops->resume(host);
  164. if (ret)
  165. pr_warn("%s: error %d during resume (card was removed?)\n",
  166. mmc_hostname(host), ret);
  167. ret = pm_generic_resume(dev);
  168. return ret;
  169. }
  170. #endif
  171. #ifdef CONFIG_PM
  172. static int mmc_runtime_suspend(struct device *dev)
  173. {
  174. struct mmc_card *card = mmc_dev_to_card(dev);
  175. struct mmc_host *host = card->host;
  176. return host->bus_ops->runtime_suspend(host);
  177. }
  178. static int mmc_runtime_resume(struct device *dev)
  179. {
  180. struct mmc_card *card = mmc_dev_to_card(dev);
  181. struct mmc_host *host = card->host;
  182. return host->bus_ops->runtime_resume(host);
  183. }
  184. #endif /* !CONFIG_PM */
  185. static const struct dev_pm_ops mmc_bus_pm_ops = {
  186. SET_RUNTIME_PM_OPS(mmc_runtime_suspend, mmc_runtime_resume, NULL)
  187. SET_SYSTEM_SLEEP_PM_OPS(mmc_bus_suspend, mmc_bus_resume)
  188. };
  189. static struct bus_type mmc_bus_type = {
  190. .name = "mmc",
  191. .dev_groups = mmc_dev_groups,
  192. .match = mmc_bus_match,
  193. .uevent = mmc_bus_uevent,
  194. .probe = mmc_bus_probe,
  195. .remove = mmc_bus_remove,
  196. .shutdown = mmc_bus_shutdown,
  197. .pm = &mmc_bus_pm_ops,
  198. };
  199. int mmc_register_bus(void)
  200. {
  201. return bus_register(&mmc_bus_type);
  202. }
  203. void mmc_unregister_bus(void)
  204. {
  205. bus_unregister(&mmc_bus_type);
  206. }
  207. /**
  208. * mmc_register_driver - register a media driver
  209. * @drv: MMC media driver
  210. */
  211. int mmc_register_driver(struct mmc_driver *drv)
  212. {
  213. drv->drv.bus = &mmc_bus_type;
  214. return driver_register(&drv->drv);
  215. }
  216. EXPORT_SYMBOL(mmc_register_driver);
  217. /**
  218. * mmc_unregister_driver - unregister a media driver
  219. * @drv: MMC media driver
  220. */
  221. void mmc_unregister_driver(struct mmc_driver *drv)
  222. {
  223. drv->drv.bus = &mmc_bus_type;
  224. driver_unregister(&drv->drv);
  225. }
  226. EXPORT_SYMBOL(mmc_unregister_driver);
  227. static void mmc_release_card(struct device *dev)
  228. {
  229. struct mmc_card *card = mmc_dev_to_card(dev);
  230. sdio_free_common_cis(card);
  231. kfree(card->info);
  232. kfree(card);
  233. }
  234. /*
  235. * Allocate and initialise a new MMC card structure.
  236. */
  237. struct mmc_card *mmc_alloc_card(struct mmc_host *host, struct device_type *type)
  238. {
  239. struct mmc_card *card;
  240. card = kzalloc(sizeof(struct mmc_card), GFP_KERNEL);
  241. if (!card)
  242. return ERR_PTR(-ENOMEM);
  243. card->host = host;
  244. device_initialize(&card->dev);
  245. card->dev.parent = mmc_classdev(host);
  246. card->dev.bus = &mmc_bus_type;
  247. card->dev.release = mmc_release_card;
  248. card->dev.type = type;
  249. return card;
  250. }
  251. /*
  252. * Register a new MMC card with the driver model.
  253. */
  254. int mmc_add_card(struct mmc_card *card)
  255. {
  256. int ret;
  257. const char *type;
  258. const char *uhs_bus_speed_mode = "";
  259. static const char *const uhs_speeds[] = {
  260. [UHS_SDR12_BUS_SPEED] = "SDR12 ",
  261. [UHS_SDR25_BUS_SPEED] = "SDR25 ",
  262. [UHS_SDR50_BUS_SPEED] = "SDR50 ",
  263. [UHS_SDR104_BUS_SPEED] = "SDR104 ",
  264. [UHS_DDR50_BUS_SPEED] = "DDR50 ",
  265. };
  266. dev_set_name(&card->dev, "%s:%04x", mmc_hostname(card->host), card->rca);
  267. switch (card->type) {
  268. case MMC_TYPE_MMC:
  269. type = "MMC";
  270. break;
  271. case MMC_TYPE_SD:
  272. type = "SD";
  273. if (mmc_card_blockaddr(card)) {
  274. if (mmc_card_ext_capacity(card))
  275. type = "SDXC";
  276. else
  277. type = "SDHC";
  278. }
  279. break;
  280. case MMC_TYPE_SDIO:
  281. type = "SDIO";
  282. break;
  283. case MMC_TYPE_SD_COMBO:
  284. type = "SD-combo";
  285. if (mmc_card_blockaddr(card))
  286. type = "SDHC-combo";
  287. break;
  288. default:
  289. type = "?";
  290. break;
  291. }
  292. if (mmc_card_uhs(card) &&
  293. (card->sd_bus_speed < ARRAY_SIZE(uhs_speeds)))
  294. uhs_bus_speed_mode = uhs_speeds[card->sd_bus_speed];
  295. if (mmc_host_is_spi(card->host)) {
  296. pr_info("%s: new %s%s%s card on SPI\n",
  297. mmc_hostname(card->host),
  298. mmc_card_hs(card) ? "high speed " : "",
  299. mmc_card_ddr52(card) ? "DDR " : "",
  300. type);
  301. } else {
  302. pr_info("%s: new %s%s%s%s%s%s card at address %04x\n",
  303. mmc_hostname(card->host),
  304. mmc_card_uhs(card) ? "ultra high speed " :
  305. (mmc_card_hs(card) ? "high speed " : ""),
  306. mmc_card_hs400(card) ? "HS400 " :
  307. (mmc_card_hs200(card) ? "HS200 " : ""),
  308. mmc_card_hs400es(card) ? "Enhanced strobe " : "",
  309. mmc_card_ddr52(card) ? "DDR " : "",
  310. uhs_bus_speed_mode, type, card->rca);
  311. }
  312. #ifdef CONFIG_DEBUG_FS
  313. mmc_add_card_debugfs(card);
  314. #endif
  315. card->dev.of_node = mmc_of_find_child_device(card->host, 0);
  316. device_enable_async_suspend(&card->dev);
  317. ret = device_add(&card->dev);
  318. if (ret)
  319. return ret;
  320. mmc_card_set_present(card);
  321. return 0;
  322. }
  323. /*
  324. * Unregister a new MMC card with the driver model, and
  325. * (eventually) free it.
  326. */
  327. void mmc_remove_card(struct mmc_card *card)
  328. {
  329. struct mmc_host *host = card->host;
  330. #ifdef CONFIG_DEBUG_FS
  331. mmc_remove_card_debugfs(card);
  332. #endif
  333. if (mmc_card_present(card)) {
  334. if (mmc_host_is_spi(card->host)) {
  335. pr_info("%s: SPI card removed\n",
  336. mmc_hostname(card->host));
  337. } else {
  338. pr_info("%s: card %04x removed\n",
  339. mmc_hostname(card->host), card->rca);
  340. }
  341. device_del(&card->dev);
  342. of_node_put(card->dev.of_node);
  343. }
  344. if (host->cqe_enabled) {
  345. host->cqe_ops->cqe_disable(host);
  346. host->cqe_enabled = false;
  347. }
  348. put_device(&card->dev);
  349. }