2 * linux/drivers/mmc/core/bus.c
4 * Copyright (C) 2003 Russell King, All Rights Reserved.
5 * Copyright (C) 2007 Pierre Ossman
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License version 2 as
9 * published by the Free Software Foundation.
11 * MMC card bus driver model
14 #include <linux/export.h>
15 #include <linux/device.h>
16 #include <linux/err.h>
17 #include <linux/slab.h>
18 #include <linux/stat.h>
19 #include <linux/pm_runtime.h>
21 #include <linux/mmc/card.h>
22 #include <linux/mmc/host.h>
28 #define to_mmc_driver(d) container_of(d, struct mmc_driver, drv)
30 static ssize_t
type_show(struct device
*dev
,
31 struct device_attribute
*attr
, char *buf
)
33 struct mmc_card
*card
= mmc_dev_to_card(dev
);
37 return sprintf(buf
, "MMC\n");
39 return sprintf(buf
, "SD\n");
41 return sprintf(buf
, "SDIO\n");
42 case MMC_TYPE_SD_COMBO
:
43 return sprintf(buf
, "SDcombo\n");
48 static DEVICE_ATTR_RO(type
);
50 static struct attribute
*mmc_dev_attrs
[] = {
54 ATTRIBUTE_GROUPS(mmc_dev
);
57 * This currently matches any MMC driver to any MMC card - drivers
58 * themselves make the decision whether to drive this card in their
61 static int mmc_bus_match(struct device
*dev
, struct device_driver
*drv
)
67 mmc_bus_uevent(struct device
*dev
, struct kobj_uevent_env
*env
)
69 struct mmc_card
*card
= mmc_dev_to_card(dev
);
83 case MMC_TYPE_SD_COMBO
:
91 retval
= add_uevent_var(env
, "MMC_TYPE=%s", type
);
96 retval
= add_uevent_var(env
, "MMC_NAME=%s", mmc_card_name(card
));
101 * Request the mmc_block device. Note: that this is a direct request
102 * for the module it carries no information as to what is inserted.
104 retval
= add_uevent_var(env
, "MODALIAS=mmc:block");
109 static int mmc_bus_probe(struct device
*dev
)
111 struct mmc_driver
*drv
= to_mmc_driver(dev
->driver
);
112 struct mmc_card
*card
= mmc_dev_to_card(dev
);
114 return drv
->probe(card
);
117 static int mmc_bus_remove(struct device
*dev
)
119 struct mmc_driver
*drv
= to_mmc_driver(dev
->driver
);
120 struct mmc_card
*card
= mmc_dev_to_card(dev
);
127 static void mmc_bus_shutdown(struct device
*dev
)
129 struct mmc_driver
*drv
= to_mmc_driver(dev
->driver
);
130 struct mmc_card
*card
= mmc_dev_to_card(dev
);
131 struct mmc_host
*host
= card
->host
;
134 if (dev
->driver
&& drv
->shutdown
)
137 if (host
->bus_ops
->shutdown
) {
138 ret
= host
->bus_ops
->shutdown(host
);
140 pr_warn("%s: error %d during shutdown\n",
141 mmc_hostname(host
), ret
);
145 #ifdef CONFIG_PM_SLEEP
146 static int mmc_bus_suspend(struct device
*dev
)
148 struct mmc_driver
*drv
= to_mmc_driver(dev
->driver
);
149 struct mmc_card
*card
= mmc_dev_to_card(dev
);
150 struct mmc_host
*host
= card
->host
;
153 if (dev
->driver
&& drv
->suspend
) {
154 ret
= drv
->suspend(card
);
159 ret
= host
->bus_ops
->suspend(host
);
163 static int mmc_bus_resume(struct device
*dev
)
165 struct mmc_driver
*drv
= to_mmc_driver(dev
->driver
);
166 struct mmc_card
*card
= mmc_dev_to_card(dev
);
167 struct mmc_host
*host
= card
->host
;
170 ret
= host
->bus_ops
->resume(host
);
172 pr_warn("%s: error %d during resume (card was removed?)\n",
173 mmc_hostname(host
), ret
);
175 if (dev
->driver
&& drv
->resume
)
176 ret
= drv
->resume(card
);
183 static int mmc_runtime_suspend(struct device
*dev
)
185 struct mmc_card
*card
= mmc_dev_to_card(dev
);
186 struct mmc_host
*host
= card
->host
;
188 return host
->bus_ops
->runtime_suspend(host
);
191 static int mmc_runtime_resume(struct device
*dev
)
193 struct mmc_card
*card
= mmc_dev_to_card(dev
);
194 struct mmc_host
*host
= card
->host
;
196 return host
->bus_ops
->runtime_resume(host
);
198 #endif /* !CONFIG_PM */
200 static const struct dev_pm_ops mmc_bus_pm_ops
= {
201 SET_RUNTIME_PM_OPS(mmc_runtime_suspend
, mmc_runtime_resume
, NULL
)
202 SET_SYSTEM_SLEEP_PM_OPS(mmc_bus_suspend
, mmc_bus_resume
)
205 static struct bus_type mmc_bus_type
= {
207 .dev_groups
= mmc_dev_groups
,
208 .match
= mmc_bus_match
,
209 .uevent
= mmc_bus_uevent
,
210 .probe
= mmc_bus_probe
,
211 .remove
= mmc_bus_remove
,
212 .shutdown
= mmc_bus_shutdown
,
213 .pm
= &mmc_bus_pm_ops
,
216 int mmc_register_bus(void)
218 return bus_register(&mmc_bus_type
);
221 void mmc_unregister_bus(void)
223 bus_unregister(&mmc_bus_type
);
227 * mmc_register_driver - register a media driver
228 * @drv: MMC media driver
230 int mmc_register_driver(struct mmc_driver
*drv
)
232 drv
->drv
.bus
= &mmc_bus_type
;
233 return driver_register(&drv
->drv
);
236 EXPORT_SYMBOL(mmc_register_driver
);
239 * mmc_unregister_driver - unregister a media driver
240 * @drv: MMC media driver
242 void mmc_unregister_driver(struct mmc_driver
*drv
)
244 drv
->drv
.bus
= &mmc_bus_type
;
245 driver_unregister(&drv
->drv
);
248 EXPORT_SYMBOL(mmc_unregister_driver
);
250 static void mmc_release_card(struct device
*dev
)
252 struct mmc_card
*card
= mmc_dev_to_card(dev
);
254 sdio_free_common_cis(card
);
262 * Allocate and initialise a new MMC card structure.
264 struct mmc_card
*mmc_alloc_card(struct mmc_host
*host
, struct device_type
*type
)
266 struct mmc_card
*card
;
268 card
= kzalloc(sizeof(struct mmc_card
), GFP_KERNEL
);
270 return ERR_PTR(-ENOMEM
);
274 device_initialize(&card
->dev
);
276 card
->dev
.parent
= mmc_classdev(host
);
277 card
->dev
.bus
= &mmc_bus_type
;
278 card
->dev
.release
= mmc_release_card
;
279 card
->dev
.type
= type
;
285 * Register a new MMC card with the driver model.
287 int mmc_add_card(struct mmc_card
*card
)
291 const char *uhs_bus_speed_mode
= "";
292 static const char *const uhs_speeds
[] = {
293 [UHS_SDR12_BUS_SPEED
] = "SDR12 ",
294 [UHS_SDR25_BUS_SPEED
] = "SDR25 ",
295 [UHS_SDR50_BUS_SPEED
] = "SDR50 ",
296 [UHS_SDR104_BUS_SPEED
] = "SDR104 ",
297 [UHS_DDR50_BUS_SPEED
] = "DDR50 ",
301 dev_set_name(&card
->dev
, "%s:%04x", mmc_hostname(card
->host
), card
->rca
);
303 switch (card
->type
) {
309 if (mmc_card_blockaddr(card
)) {
310 if (mmc_card_ext_capacity(card
))
319 case MMC_TYPE_SD_COMBO
:
321 if (mmc_card_blockaddr(card
))
329 if (mmc_card_uhs(card
) &&
330 (card
->sd_bus_speed
< ARRAY_SIZE(uhs_speeds
)))
331 uhs_bus_speed_mode
= uhs_speeds
[card
->sd_bus_speed
];
333 if (mmc_host_is_spi(card
->host
)) {
334 pr_info("%s: new %s%s%s card on SPI\n",
335 mmc_hostname(card
->host
),
336 mmc_card_hs(card
) ? "high speed " : "",
337 mmc_card_ddr52(card
) ? "DDR " : "",
340 pr_info("%s: new %s%s%s%s%s card at address %04x\n",
341 mmc_hostname(card
->host
),
342 mmc_card_uhs(card
) ? "ultra high speed " :
343 (mmc_card_hs(card
) ? "high speed " : ""),
344 mmc_card_hs400(card
) ? "HS400 " :
345 (mmc_card_hs200(card
) ? "HS200 " : ""),
346 mmc_card_ddr52(card
) ? "DDR " : "",
347 uhs_bus_speed_mode
, type
, card
->rca
);
350 #ifdef CONFIG_DEBUG_FS
351 mmc_add_card_debugfs(card
);
353 mmc_init_context_info(card
->host
);
355 ret
= device_add(&card
->dev
);
359 mmc_card_set_present(card
);
365 * Unregister a new MMC card with the driver model, and
366 * (eventually) free it.
368 void mmc_remove_card(struct mmc_card
*card
)
370 #ifdef CONFIG_DEBUG_FS
371 mmc_remove_card_debugfs(card
);
374 if (mmc_card_present(card
)) {
375 if (mmc_host_is_spi(card
->host
)) {
376 pr_info("%s: SPI card removed\n",
377 mmc_hostname(card
->host
));
379 pr_info("%s: card %04x removed\n",
380 mmc_hostname(card
->host
), card
->rca
);
382 device_del(&card
->dev
);
385 put_device(&card
->dev
);