Commit | Line | Data |
---|---|---|
e29a7d73 PO |
1 | /* |
2 | * linux/drivers/mmc/core/sdio_bus.c | |
3 | * | |
4 | * Copyright 2007 Pierre Ossman | |
5 | * | |
6 | * This program is free software; you can redistribute it and/or modify | |
7 | * it under the terms of the GNU General Public License as published by | |
8 | * the Free Software Foundation; either version 2 of the License, or (at | |
9 | * your option) any later version. | |
10 | * | |
11 | * SDIO function driver model | |
12 | */ | |
13 | ||
14 | #include <linux/device.h> | |
15 | #include <linux/err.h> | |
3ef77af1 | 16 | #include <linux/export.h> |
5a0e3ad6 | 17 | #include <linux/slab.h> |
80fd933c | 18 | #include <linux/pm_runtime.h> |
eed222ac | 19 | #include <linux/acpi.h> |
e29a7d73 PO |
20 | |
21 | #include <linux/mmc/card.h> | |
ed919b01 | 22 | #include <linux/mmc/host.h> |
e29a7d73 PO |
23 | #include <linux/mmc/sdio_func.h> |
24 | ||
b1538bcf | 25 | #include "sdio_cis.h" |
e29a7d73 PO |
26 | #include "sdio_bus.h" |
27 | ||
bcfe66e2 PO |
28 | /* show configuration fields */ |
29 | #define sdio_config_attr(field, format_string) \ | |
30 | static ssize_t \ | |
31 | field##_show(struct device *dev, struct device_attribute *attr, char *buf) \ | |
32 | { \ | |
33 | struct sdio_func *func; \ | |
34 | \ | |
35 | func = dev_to_sdio_func (dev); \ | |
36 | return sprintf (buf, format_string, func->field); \ | |
f24fc57b GKH |
37 | } \ |
38 | static DEVICE_ATTR_RO(field) | |
bcfe66e2 PO |
39 | |
40 | sdio_config_attr(class, "0x%02x\n"); | |
41 | sdio_config_attr(vendor, "0x%04x\n"); | |
42 | sdio_config_attr(device, "0x%04x\n"); | |
43 | ||
44 | static ssize_t modalias_show(struct device *dev, struct device_attribute *attr, char *buf) | |
45 | { | |
46 | struct sdio_func *func = dev_to_sdio_func (dev); | |
47 | ||
48 | return sprintf(buf, "sdio:c%02Xv%04Xd%04X\n", | |
49 | func->class, func->vendor, func->device); | |
50 | } | |
f24fc57b GKH |
51 | static DEVICE_ATTR_RO(modalias); |
52 | ||
53 | static struct attribute *sdio_dev_attrs[] = { | |
54 | &dev_attr_class.attr, | |
55 | &dev_attr_vendor.attr, | |
56 | &dev_attr_device.attr, | |
57 | &dev_attr_modalias.attr, | |
58 | NULL, | |
bcfe66e2 | 59 | }; |
f24fc57b | 60 | ATTRIBUTE_GROUPS(sdio_dev); |
bcfe66e2 | 61 | |
3b38bea0 PO |
62 | static const struct sdio_device_id *sdio_match_one(struct sdio_func *func, |
63 | const struct sdio_device_id *id) | |
64 | { | |
65 | if (id->class != (__u8)SDIO_ANY_ID && id->class != func->class) | |
66 | return NULL; | |
67 | if (id->vendor != (__u16)SDIO_ANY_ID && id->vendor != func->vendor) | |
68 | return NULL; | |
69 | if (id->device != (__u16)SDIO_ANY_ID && id->device != func->device) | |
70 | return NULL; | |
71 | return id; | |
72 | } | |
73 | ||
74 | static const struct sdio_device_id *sdio_match_device(struct sdio_func *func, | |
75 | struct sdio_driver *sdrv) | |
76 | { | |
77 | const struct sdio_device_id *ids; | |
78 | ||
79 | ids = sdrv->id_table; | |
80 | ||
81 | if (ids) { | |
82 | while (ids->class || ids->vendor || ids->device) { | |
83 | if (sdio_match_one(func, ids)) | |
84 | return ids; | |
85 | ids++; | |
86 | } | |
87 | } | |
88 | ||
89 | return NULL; | |
90 | } | |
e29a7d73 | 91 | |
e29a7d73 PO |
92 | static int sdio_bus_match(struct device *dev, struct device_driver *drv) |
93 | { | |
3b38bea0 PO |
94 | struct sdio_func *func = dev_to_sdio_func(dev); |
95 | struct sdio_driver *sdrv = to_sdio_driver(drv); | |
96 | ||
97 | if (sdio_match_device(func, sdrv)) | |
98 | return 1; | |
99 | ||
100 | return 0; | |
e29a7d73 PO |
101 | } |
102 | ||
103 | static int | |
7ac0326c | 104 | sdio_bus_uevent(struct device *dev, struct kobj_uevent_env *env) |
e29a7d73 | 105 | { |
d59b66c7 | 106 | struct sdio_func *func = dev_to_sdio_func(dev); |
d59b66c7 | 107 | |
7ac0326c | 108 | if (add_uevent_var(env, |
d59b66c7 PO |
109 | "SDIO_CLASS=%02X", func->class)) |
110 | return -ENOMEM; | |
111 | ||
7ac0326c | 112 | if (add_uevent_var(env, |
d59b66c7 PO |
113 | "SDIO_ID=%04X:%04X", func->vendor, func->device)) |
114 | return -ENOMEM; | |
115 | ||
7ac0326c | 116 | if (add_uevent_var(env, |
d59b66c7 PO |
117 | "MODALIAS=sdio:c%02Xv%04Xd%04X", |
118 | func->class, func->vendor, func->device)) | |
119 | return -ENOMEM; | |
120 | ||
e29a7d73 PO |
121 | return 0; |
122 | } | |
123 | ||
124 | static int sdio_bus_probe(struct device *dev) | |
125 | { | |
3b38bea0 PO |
126 | struct sdio_driver *drv = to_sdio_driver(dev->driver); |
127 | struct sdio_func *func = dev_to_sdio_func(dev); | |
128 | const struct sdio_device_id *id; | |
9a08f82b | 129 | int ret; |
3b38bea0 PO |
130 | |
131 | id = sdio_match_device(func, drv); | |
132 | if (!id) | |
133 | return -ENODEV; | |
134 | ||
40bba0c1 OBC |
135 | /* Unbound SDIO functions are always suspended. |
136 | * During probe, the function is set active and the usage count | |
137 | * is incremented. If the driver supports runtime PM, | |
138 | * it should call pm_runtime_put_noidle() in its probe routine and | |
139 | * pm_runtime_get_noresume() in its remove routine. | |
140 | */ | |
ed919b01 OBC |
141 | if (func->card->host->caps & MMC_CAP_POWER_OFF_CARD) { |
142 | ret = pm_runtime_get_sync(dev); | |
143 | if (ret < 0) | |
3bffb800 | 144 | goto disable_runtimepm; |
ed919b01 | 145 | } |
40bba0c1 | 146 | |
9a08f82b DV |
147 | /* Set the default block size so the driver is sure it's something |
148 | * sensible. */ | |
149 | sdio_claim_host(func); | |
150 | ret = sdio_set_block_size(func, 0); | |
151 | sdio_release_host(func); | |
152 | if (ret) | |
40bba0c1 OBC |
153 | goto disable_runtimepm; |
154 | ||
155 | ret = drv->probe(func, id); | |
156 | if (ret) | |
157 | goto disable_runtimepm; | |
158 | ||
159 | return 0; | |
9a08f82b | 160 | |
40bba0c1 | 161 | disable_runtimepm: |
ed919b01 OBC |
162 | if (func->card->host->caps & MMC_CAP_POWER_OFF_CARD) |
163 | pm_runtime_put_noidle(dev); | |
40bba0c1 | 164 | return ret; |
e29a7d73 PO |
165 | } |
166 | ||
167 | static int sdio_bus_remove(struct device *dev) | |
168 | { | |
3b38bea0 PO |
169 | struct sdio_driver *drv = to_sdio_driver(dev->driver); |
170 | struct sdio_func *func = dev_to_sdio_func(dev); | |
ed919b01 | 171 | int ret = 0; |
40bba0c1 OBC |
172 | |
173 | /* Make sure card is powered before invoking ->remove() */ | |
ecc02441 OBC |
174 | if (func->card->host->caps & MMC_CAP_POWER_OFF_CARD) |
175 | pm_runtime_get_sync(dev); | |
3b38bea0 PO |
176 | |
177 | drv->remove(func); | |
178 | ||
d1496c39 | 179 | if (func->irq_handler) { |
a3c76eb9 | 180 | pr_warning("WARNING: driver %s did not remove " |
d1496c39 NP |
181 | "its interrupt handler!\n", drv->name); |
182 | sdio_claim_host(func); | |
183 | sdio_release_irq(func); | |
184 | sdio_release_host(func); | |
185 | } | |
186 | ||
40bba0c1 | 187 | /* First, undo the increment made directly above */ |
ed919b01 OBC |
188 | if (func->card->host->caps & MMC_CAP_POWER_OFF_CARD) |
189 | pm_runtime_put_noidle(dev); | |
40bba0c1 OBC |
190 | |
191 | /* Then undo the runtime PM settings in sdio_bus_probe() */ | |
ed919b01 | 192 | if (func->card->host->caps & MMC_CAP_POWER_OFF_CARD) |
297c7f2f | 193 | pm_runtime_put_sync(dev); |
40bba0c1 | 194 | |
40bba0c1 | 195 | return ret; |
e29a7d73 PO |
196 | } |
197 | ||
e841a7c6 | 198 | #ifdef CONFIG_PM |
b0afd8f6 RW |
199 | |
200 | #ifdef CONFIG_PM_SLEEP | |
201 | static int pm_no_operation(struct device *dev) | |
202 | { | |
203 | /* | |
204 | * Prevent the PM core from calling SDIO device drivers' suspend | |
205 | * callback routines, which it is not supposed to do, by using this | |
206 | * empty function as the bus type suspend callaback for SDIO. | |
207 | */ | |
208 | return 0; | |
209 | } | |
210 | #endif | |
211 | ||
80fd933c | 212 | static const struct dev_pm_ops sdio_bus_pm_ops = { |
b0afd8f6 | 213 | SET_SYSTEM_SLEEP_PM_OPS(pm_no_operation, pm_no_operation) |
80fd933c OBC |
214 | SET_RUNTIME_PM_OPS( |
215 | pm_generic_runtime_suspend, | |
216 | pm_generic_runtime_resume, | |
45f0a85c | 217 | NULL |
80fd933c OBC |
218 | ) |
219 | }; | |
220 | ||
221 | #define SDIO_PM_OPS_PTR (&sdio_bus_pm_ops) | |
222 | ||
e841a7c6 | 223 | #else /* !CONFIG_PM */ |
80fd933c OBC |
224 | |
225 | #define SDIO_PM_OPS_PTR NULL | |
226 | ||
e841a7c6 | 227 | #endif /* !CONFIG_PM */ |
80fd933c | 228 | |
e29a7d73 PO |
229 | static struct bus_type sdio_bus_type = { |
230 | .name = "sdio", | |
f24fc57b | 231 | .dev_groups = sdio_dev_groups, |
e29a7d73 PO |
232 | .match = sdio_bus_match, |
233 | .uevent = sdio_bus_uevent, | |
234 | .probe = sdio_bus_probe, | |
235 | .remove = sdio_bus_remove, | |
80fd933c | 236 | .pm = SDIO_PM_OPS_PTR, |
e29a7d73 PO |
237 | }; |
238 | ||
239 | int sdio_register_bus(void) | |
240 | { | |
241 | return bus_register(&sdio_bus_type); | |
242 | } | |
243 | ||
244 | void sdio_unregister_bus(void) | |
245 | { | |
246 | bus_unregister(&sdio_bus_type); | |
247 | } | |
248 | ||
f76c8515 PO |
249 | /** |
250 | * sdio_register_driver - register a function driver | |
251 | * @drv: SDIO function driver | |
252 | */ | |
253 | int sdio_register_driver(struct sdio_driver *drv) | |
254 | { | |
255 | drv->drv.name = drv->name; | |
256 | drv->drv.bus = &sdio_bus_type; | |
257 | return driver_register(&drv->drv); | |
258 | } | |
259 | EXPORT_SYMBOL_GPL(sdio_register_driver); | |
260 | ||
261 | /** | |
262 | * sdio_unregister_driver - unregister a function driver | |
263 | * @drv: SDIO function driver | |
264 | */ | |
265 | void sdio_unregister_driver(struct sdio_driver *drv) | |
266 | { | |
267 | drv->drv.bus = &sdio_bus_type; | |
268 | driver_unregister(&drv->drv); | |
269 | } | |
270 | EXPORT_SYMBOL_GPL(sdio_unregister_driver); | |
271 | ||
e29a7d73 PO |
272 | static void sdio_release_func(struct device *dev) |
273 | { | |
274 | struct sdio_func *func = dev_to_sdio_func(dev); | |
b1538bcf | 275 | |
1a632f8c | 276 | sdio_free_func_cis(func); |
e29a7d73 | 277 | |
4c42d6cc | 278 | kfree(func->info); |
759bdc7a | 279 | |
e29a7d73 PO |
280 | kfree(func); |
281 | } | |
282 | ||
283 | /* | |
284 | * Allocate and initialise a new SDIO function structure. | |
285 | */ | |
286 | struct sdio_func *sdio_alloc_func(struct mmc_card *card) | |
287 | { | |
288 | struct sdio_func *func; | |
289 | ||
9f2fcf99 | 290 | func = kzalloc(sizeof(struct sdio_func), GFP_KERNEL); |
e29a7d73 PO |
291 | if (!func) |
292 | return ERR_PTR(-ENOMEM); | |
293 | ||
e29a7d73 PO |
294 | func->card = card; |
295 | ||
296 | device_initialize(&func->dev); | |
297 | ||
298 | func->dev.parent = &card->dev; | |
299 | func->dev.bus = &sdio_bus_type; | |
300 | func->dev.release = sdio_release_func; | |
301 | ||
302 | return func; | |
303 | } | |
304 | ||
eed222ac AL |
305 | #ifdef CONFIG_ACPI |
306 | static void sdio_acpi_set_handle(struct sdio_func *func) | |
307 | { | |
308 | struct mmc_host *host = func->card->host; | |
309 | u64 addr = (host->slotno << 16) | func->num; | |
310 | ||
311 | ACPI_HANDLE_SET(&func->dev, | |
312 | acpi_get_child(ACPI_HANDLE(host->parent), addr)); | |
313 | } | |
314 | #else | |
315 | static inline void sdio_acpi_set_handle(struct sdio_func *func) {} | |
316 | #endif | |
317 | ||
e29a7d73 PO |
318 | /* |
319 | * Register a new SDIO function with the driver model. | |
320 | */ | |
321 | int sdio_add_func(struct sdio_func *func) | |
322 | { | |
323 | int ret; | |
324 | ||
d1b26863 | 325 | dev_set_name(&func->dev, "%s:%d", mmc_card_id(func->card), func->num); |
e29a7d73 | 326 | |
eed222ac | 327 | sdio_acpi_set_handle(func); |
e29a7d73 | 328 | ret = device_add(&func->dev); |
eed222ac | 329 | if (ret == 0) { |
e29a7d73 | 330 | sdio_func_set_present(func); |
eed222ac AL |
331 | acpi_dev_pm_attach(&func->dev, false); |
332 | } | |
e29a7d73 PO |
333 | |
334 | return ret; | |
335 | } | |
336 | ||
337 | /* | |
338 | * Unregister a SDIO function with the driver model, and | |
339 | * (eventually) free it. | |
3d10a1ba DD |
340 | * This function can be called through error paths where sdio_add_func() was |
341 | * never executed (because a failure occurred at an earlier point). | |
e29a7d73 PO |
342 | */ |
343 | void sdio_remove_func(struct sdio_func *func) | |
344 | { | |
3d10a1ba DD |
345 | if (!sdio_func_present(func)) |
346 | return; | |
e29a7d73 | 347 | |
eed222ac | 348 | acpi_dev_pm_detach(&func->dev, false); |
3d10a1ba | 349 | device_del(&func->dev); |
e29a7d73 PO |
350 | put_device(&func->dev); |
351 | } | |
352 |