Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* |
2 | * card.c - contains functions for managing groups of PnP devices | |
3 | * | |
4 | * Copyright 2002 Adam Belay <ambx1@neo.rr.com> | |
1da177e4 LT |
5 | */ |
6 | ||
1da177e4 | 7 | #include <linux/module.h> |
38f6b38d | 8 | #include <linux/mutex.h> |
e436675f | 9 | #include <linux/ctype.h> |
1da177e4 | 10 | #include <linux/slab.h> |
1da177e4 | 11 | #include <linux/pnp.h> |
e86b19ce | 12 | #include <linux/dma-mapping.h> |
1da177e4 LT |
13 | #include "base.h" |
14 | ||
15 | LIST_HEAD(pnp_cards); | |
b449f63c | 16 | static LIST_HEAD(pnp_card_drivers); |
1da177e4 | 17 | |
9dd78466 BH |
18 | static const struct pnp_card_device_id *match_card(struct pnp_card_driver *drv, |
19 | struct pnp_card *card) | |
1da177e4 | 20 | { |
9dd78466 | 21 | const struct pnp_card_device_id *drv_id = drv->id_table; |
07d4e9af | 22 | |
9dd78466 BH |
23 | while (*drv_id->id) { |
24 | if (compare_pnp_id(card->id, drv_id->id)) { | |
1da177e4 | 25 | int i = 0; |
07d4e9af | 26 | |
1da177e4 LT |
27 | for (;;) { |
28 | int found; | |
29 | struct pnp_dev *dev; | |
07d4e9af | 30 | |
1e0aa9ad BH |
31 | if (i == PNP_MAX_DEVICES || |
32 | !*drv_id->devs[i].id) | |
1da177e4 LT |
33 | return drv_id; |
34 | found = 0; | |
35 | card_for_each_dev(card, dev) { | |
1e0aa9ad BH |
36 | if (compare_pnp_id(dev->id, |
37 | drv_id->devs[i].id)) { | |
1da177e4 LT |
38 | found = 1; |
39 | break; | |
40 | } | |
41 | } | |
9dd78466 | 42 | if (!found) |
1da177e4 LT |
43 | break; |
44 | i++; | |
45 | } | |
46 | } | |
47 | drv_id++; | |
48 | } | |
49 | return NULL; | |
50 | } | |
51 | ||
9dd78466 | 52 | static void card_remove(struct pnp_dev *dev) |
1da177e4 LT |
53 | { |
54 | dev->card_link = NULL; | |
55 | } | |
982c6094 | 56 | |
9dd78466 | 57 | static void card_remove_first(struct pnp_dev *dev) |
1da177e4 | 58 | { |
9dd78466 | 59 | struct pnp_card_driver *drv = to_pnp_card_driver(dev->driver); |
07d4e9af | 60 | |
1da177e4 LT |
61 | if (!dev->card || !drv) |
62 | return; | |
63 | if (drv->remove) | |
64 | drv->remove(dev->card_link); | |
65 | drv->link.remove = &card_remove; | |
66 | kfree(dev->card_link); | |
67 | card_remove(dev); | |
68 | } | |
69 | ||
a9adb8db | 70 | static int card_probe(struct pnp_card *card, struct pnp_card_driver *drv) |
1da177e4 | 71 | { |
a9adb8db JJ |
72 | const struct pnp_card_device_id *id; |
73 | struct pnp_card_link *clink; | |
74 | struct pnp_dev *dev; | |
75 | ||
76 | if (!drv->probe) | |
77 | return 0; | |
9dd78466 | 78 | id = match_card(drv, card); |
a9adb8db JJ |
79 | if (!id) |
80 | return 0; | |
81 | ||
82 | clink = pnp_alloc(sizeof(*clink)); | |
83 | if (!clink) | |
84 | return 0; | |
85 | clink->card = card; | |
86 | clink->driver = drv; | |
87 | clink->pm_state = PMSG_ON; | |
88 | ||
89 | if (drv->probe(clink, id) >= 0) | |
90 | return 1; | |
91 | ||
92 | /* Recovery */ | |
93 | card_for_each_dev(card, dev) { | |
94 | if (dev->card_link == clink) | |
95 | pnp_release_card_device(dev); | |
1da177e4 | 96 | } |
a9adb8db | 97 | kfree(clink); |
1da177e4 LT |
98 | return 0; |
99 | } | |
100 | ||
101 | /** | |
102 | * pnp_add_card_id - adds an EISA id to the specified card | |
103 | * @id: pointer to a pnp_id structure | |
104 | * @card: pointer to the desired card | |
1da177e4 | 105 | */ |
25cdcd00 | 106 | static struct pnp_id *pnp_add_card_id(struct pnp_card *card, char *id) |
1da177e4 | 107 | { |
e436675f BH |
108 | struct pnp_id *dev_id, *ptr; |
109 | ||
110 | dev_id = kzalloc(sizeof(struct pnp_id), GFP_KERNEL); | |
111 | if (!dev_id) | |
112 | return NULL; | |
113 | ||
114 | dev_id->id[0] = id[0]; | |
115 | dev_id->id[1] = id[1]; | |
116 | dev_id->id[2] = id[2]; | |
117 | dev_id->id[3] = tolower(id[3]); | |
118 | dev_id->id[4] = tolower(id[4]); | |
119 | dev_id->id[5] = tolower(id[5]); | |
120 | dev_id->id[6] = tolower(id[6]); | |
121 | dev_id->id[7] = '\0'; | |
122 | ||
123 | dev_id->next = NULL; | |
1da177e4 LT |
124 | ptr = card->id; |
125 | while (ptr && ptr->next) | |
126 | ptr = ptr->next; | |
127 | if (ptr) | |
e436675f | 128 | ptr->next = dev_id; |
1da177e4 | 129 | else |
e436675f BH |
130 | card->id = dev_id; |
131 | ||
132 | return dev_id; | |
1da177e4 LT |
133 | } |
134 | ||
9dd78466 | 135 | static void pnp_free_card_ids(struct pnp_card *card) |
1da177e4 | 136 | { |
9dd78466 | 137 | struct pnp_id *id; |
1da177e4 | 138 | struct pnp_id *next; |
07d4e9af | 139 | |
1da177e4 LT |
140 | id = card->id; |
141 | while (id) { | |
142 | next = id->next; | |
143 | kfree(id); | |
144 | id = next; | |
145 | } | |
146 | } | |
147 | ||
148 | static void pnp_release_card(struct device *dmdev) | |
149 | { | |
9dd78466 | 150 | struct pnp_card *card = to_pnp_card(dmdev); |
07d4e9af | 151 | |
1da177e4 LT |
152 | pnp_free_card_ids(card); |
153 | kfree(card); | |
154 | } | |
155 | ||
6bf2aab2 BH |
156 | struct pnp_card *pnp_alloc_card(struct pnp_protocol *protocol, int id, char *pnpid) |
157 | { | |
158 | struct pnp_card *card; | |
159 | struct pnp_id *dev_id; | |
160 | ||
161 | card = kzalloc(sizeof(struct pnp_card), GFP_KERNEL); | |
162 | if (!card) | |
163 | return NULL; | |
164 | ||
165 | card->protocol = protocol; | |
166 | card->number = id; | |
167 | ||
168 | card->dev.parent = &card->protocol->dev; | |
c85e37c5 | 169 | dev_set_name(&card->dev, "%02x:%02x", card->protocol->number, card->number); |
6bf2aab2 | 170 | |
2f4f27d4 | 171 | card->dev.coherent_dma_mask = DMA_BIT_MASK(24); |
e86b19ce RH |
172 | card->dev.dma_mask = &card->dev.coherent_dma_mask; |
173 | ||
6bf2aab2 BH |
174 | dev_id = pnp_add_card_id(card, pnpid); |
175 | if (!dev_id) { | |
176 | kfree(card); | |
177 | return NULL; | |
178 | } | |
179 | ||
180 | return card; | |
181 | } | |
182 | ||
9dd78466 BH |
183 | static ssize_t pnp_show_card_name(struct device *dmdev, |
184 | struct device_attribute *attr, char *buf) | |
1da177e4 LT |
185 | { |
186 | char *str = buf; | |
187 | struct pnp_card *card = to_pnp_card(dmdev); | |
07d4e9af | 188 | |
9dd78466 | 189 | str += sprintf(str, "%s\n", card->name); |
1da177e4 LT |
190 | return (str - buf); |
191 | } | |
192 | ||
9dd78466 | 193 | static DEVICE_ATTR(name, S_IRUGO, pnp_show_card_name, NULL); |
1da177e4 | 194 | |
9dd78466 BH |
195 | static ssize_t pnp_show_card_ids(struct device *dmdev, |
196 | struct device_attribute *attr, char *buf) | |
1da177e4 LT |
197 | { |
198 | char *str = buf; | |
199 | struct pnp_card *card = to_pnp_card(dmdev); | |
9dd78466 | 200 | struct pnp_id *pos = card->id; |
1da177e4 LT |
201 | |
202 | while (pos) { | |
9dd78466 | 203 | str += sprintf(str, "%s\n", pos->id); |
1da177e4 LT |
204 | pos = pos->next; |
205 | } | |
206 | return (str - buf); | |
207 | } | |
208 | ||
9dd78466 | 209 | static DEVICE_ATTR(card_id, S_IRUGO, pnp_show_card_ids, NULL); |
1da177e4 LT |
210 | |
211 | static int pnp_interface_attach_card(struct pnp_card *card) | |
212 | { | |
9dd78466 | 213 | int rc = device_create_file(&card->dev, &dev_attr_name); |
07d4e9af | 214 | |
9dd78466 BH |
215 | if (rc) |
216 | return rc; | |
bfc7ee20 | 217 | |
9dd78466 BH |
218 | rc = device_create_file(&card->dev, &dev_attr_card_id); |
219 | if (rc) | |
220 | goto err_name; | |
bfc7ee20 | 221 | |
1da177e4 | 222 | return 0; |
bfc7ee20 | 223 | |
1e0aa9ad | 224 | err_name: |
9dd78466 | 225 | device_remove_file(&card->dev, &dev_attr_name); |
bfc7ee20 | 226 | return rc; |
1da177e4 LT |
227 | } |
228 | ||
229 | /** | |
230 | * pnp_add_card - adds a PnP card to the PnP Layer | |
231 | * @card: pointer to the card to add | |
232 | */ | |
9dd78466 | 233 | int pnp_add_card(struct pnp_card *card) |
1da177e4 LT |
234 | { |
235 | int error; | |
9dd78466 | 236 | struct list_head *pos, *temp; |
07d4e9af | 237 | |
1da177e4 LT |
238 | card->dev.bus = NULL; |
239 | card->dev.release = &pnp_release_card; | |
240 | error = device_register(&card->dev); | |
5bfc43a0 | 241 | if (error) { |
a05d0781 | 242 | dev_err(&card->dev, "could not register (err=%d)\n", error); |
75365d04 | 243 | put_device(&card->dev); |
5bfc43a0 BH |
244 | return error; |
245 | } | |
246 | ||
247 | pnp_interface_attach_card(card); | |
38f6b38d | 248 | mutex_lock(&pnp_lock); |
5bfc43a0 BH |
249 | list_add_tail(&card->global_list, &pnp_cards); |
250 | list_add_tail(&card->protocol_list, &card->protocol->cards); | |
38f6b38d | 251 | mutex_unlock(&pnp_lock); |
5bfc43a0 BH |
252 | |
253 | /* we wait until now to add devices in order to ensure the drivers | |
254 | * will be able to use all of the related devices on the card | |
255 | * without waiting an unreasonable length of time */ | |
256 | list_for_each(pos, &card->devices) { | |
257 | struct pnp_dev *dev = card_to_pnp_dev(pos); | |
258 | __pnp_add_device(dev); | |
259 | } | |
260 | ||
261 | /* match with card drivers */ | |
262 | list_for_each_safe(pos, temp, &pnp_card_drivers) { | |
263 | struct pnp_card_driver *drv = | |
264 | list_entry(pos, struct pnp_card_driver, | |
265 | global_list); | |
266 | card_probe(card, drv); | |
267 | } | |
268 | return 0; | |
1da177e4 LT |
269 | } |
270 | ||
271 | /** | |
272 | * pnp_remove_card - removes a PnP card from the PnP Layer | |
273 | * @card: pointer to the card to remove | |
274 | */ | |
9dd78466 | 275 | void pnp_remove_card(struct pnp_card *card) |
1da177e4 LT |
276 | { |
277 | struct list_head *pos, *temp; | |
07d4e9af | 278 | |
1da177e4 | 279 | device_unregister(&card->dev); |
38f6b38d | 280 | mutex_lock(&pnp_lock); |
1da177e4 LT |
281 | list_del(&card->global_list); |
282 | list_del(&card->protocol_list); | |
38f6b38d | 283 | mutex_unlock(&pnp_lock); |
9dd78466 | 284 | list_for_each_safe(pos, temp, &card->devices) { |
1da177e4 LT |
285 | struct pnp_dev *dev = card_to_pnp_dev(pos); |
286 | pnp_remove_card_device(dev); | |
287 | } | |
288 | } | |
289 | ||
290 | /** | |
291 | * pnp_add_card_device - adds a device to the specified card | |
292 | * @card: pointer to the card to add to | |
293 | * @dev: pointer to the device to add | |
294 | */ | |
9dd78466 | 295 | int pnp_add_card_device(struct pnp_card *card, struct pnp_dev *dev) |
1da177e4 | 296 | { |
1da177e4 LT |
297 | dev->dev.parent = &card->dev; |
298 | dev->card_link = NULL; | |
c85e37c5 KS |
299 | dev_set_name(&dev->dev, "%02x:%02x.%02x", |
300 | dev->protocol->number, card->number, dev->number); | |
38f6b38d | 301 | mutex_lock(&pnp_lock); |
1da177e4 LT |
302 | dev->card = card; |
303 | list_add_tail(&dev->card_list, &card->devices); | |
38f6b38d | 304 | mutex_unlock(&pnp_lock); |
1da177e4 LT |
305 | return 0; |
306 | } | |
307 | ||
308 | /** | |
309 | * pnp_remove_card_device- removes a device from the specified card | |
1da177e4 LT |
310 | * @dev: pointer to the device to remove |
311 | */ | |
9dd78466 | 312 | void pnp_remove_card_device(struct pnp_dev *dev) |
1da177e4 | 313 | { |
38f6b38d | 314 | mutex_lock(&pnp_lock); |
1da177e4 LT |
315 | dev->card = NULL; |
316 | list_del(&dev->card_list); | |
38f6b38d | 317 | mutex_unlock(&pnp_lock); |
1da177e4 LT |
318 | __pnp_remove_device(dev); |
319 | } | |
320 | ||
321 | /** | |
322 | * pnp_request_card_device - Searches for a PnP device under the specified card | |
3d41088f | 323 | * @clink: pointer to the card link, cannot be NULL |
1da177e4 | 324 | * @id: pointer to a PnP ID structure that explains the rules for finding the device |
25985edc | 325 | * @from: Starting place to search from. If NULL it will start from the beginning. |
1da177e4 | 326 | */ |
9dd78466 BH |
327 | struct pnp_dev *pnp_request_card_device(struct pnp_card_link *clink, |
328 | const char *id, struct pnp_dev *from) | |
1da177e4 | 329 | { |
9dd78466 BH |
330 | struct list_head *pos; |
331 | struct pnp_dev *dev; | |
332 | struct pnp_card_driver *drv; | |
333 | struct pnp_card *card; | |
07d4e9af | 334 | |
1da177e4 | 335 | if (!clink || !id) |
5bfc43a0 BH |
336 | return NULL; |
337 | ||
1da177e4 LT |
338 | card = clink->card; |
339 | drv = clink->driver; | |
340 | if (!from) { | |
341 | pos = card->devices.next; | |
342 | } else { | |
343 | if (from->card != card) | |
5bfc43a0 | 344 | return NULL; |
1da177e4 LT |
345 | pos = from->card_list.next; |
346 | } | |
347 | while (pos != &card->devices) { | |
348 | dev = card_to_pnp_dev(pos); | |
9dd78466 | 349 | if ((!dev->card_link) && compare_pnp_id(dev->id, id)) |
1da177e4 LT |
350 | goto found; |
351 | pos = pos->next; | |
352 | } | |
353 | ||
1da177e4 LT |
354 | return NULL; |
355 | ||
1e0aa9ad | 356 | found: |
1da177e4 LT |
357 | dev->card_link = clink; |
358 | dev->dev.driver = &drv->link.driver; | |
bfc7ee20 JG |
359 | if (pnp_bus_type.probe(&dev->dev)) |
360 | goto err_out; | |
361 | if (device_bind_driver(&dev->dev)) | |
362 | goto err_out; | |
363 | ||
1da177e4 | 364 | return dev; |
bfc7ee20 | 365 | |
1e0aa9ad | 366 | err_out: |
bfc7ee20 JG |
367 | dev->dev.driver = NULL; |
368 | dev->card_link = NULL; | |
bfc7ee20 | 369 | return NULL; |
1da177e4 LT |
370 | } |
371 | ||
372 | /** | |
373 | * pnp_release_card_device - call this when the driver no longer needs the device | |
25985edc | 374 | * @dev: pointer to the PnP device structure |
1da177e4 | 375 | */ |
9dd78466 | 376 | void pnp_release_card_device(struct pnp_dev *dev) |
1da177e4 | 377 | { |
9dd78466 | 378 | struct pnp_card_driver *drv = dev->card_link->driver; |
07d4e9af | 379 | |
1da177e4 LT |
380 | drv->link.remove = &card_remove; |
381 | device_release_driver(&dev->dev); | |
382 | drv->link.remove = &card_remove_first; | |
1da177e4 LT |
383 | } |
384 | ||
4c98cfef TI |
385 | /* |
386 | * suspend/resume callbacks | |
387 | */ | |
388 | static int card_suspend(struct pnp_dev *dev, pm_message_t state) | |
389 | { | |
390 | struct pnp_card_link *link = dev->card_link; | |
07d4e9af | 391 | |
4c98cfef TI |
392 | if (link->pm_state.event == state.event) |
393 | return 0; | |
394 | link->pm_state = state; | |
395 | return link->driver->suspend(link, state); | |
396 | } | |
397 | ||
398 | static int card_resume(struct pnp_dev *dev) | |
399 | { | |
400 | struct pnp_card_link *link = dev->card_link; | |
07d4e9af | 401 | |
4c98cfef TI |
402 | if (link->pm_state.event == PM_EVENT_ON) |
403 | return 0; | |
404 | link->pm_state = PMSG_ON; | |
405 | link->driver->resume(link); | |
406 | return 0; | |
407 | } | |
408 | ||
1da177e4 LT |
409 | /** |
410 | * pnp_register_card_driver - registers a PnP card driver with the PnP Layer | |
411 | * @drv: pointer to the driver to register | |
412 | */ | |
9dd78466 | 413 | int pnp_register_card_driver(struct pnp_card_driver *drv) |
1da177e4 | 414 | { |
982c6094 | 415 | int error; |
1da177e4 LT |
416 | struct list_head *pos, *temp; |
417 | ||
418 | drv->link.name = drv->name; | |
419 | drv->link.id_table = NULL; /* this will disable auto matching */ | |
420 | drv->link.flags = drv->flags; | |
421 | drv->link.probe = NULL; | |
422 | drv->link.remove = &card_remove_first; | |
4c98cfef TI |
423 | drv->link.suspend = drv->suspend ? card_suspend : NULL; |
424 | drv->link.resume = drv->resume ? card_resume : NULL; | |
1da177e4 | 425 | |
982c6094 BH |
426 | error = pnp_register_driver(&drv->link); |
427 | if (error < 0) | |
428 | return error; | |
d1d051b2 | 429 | |
38f6b38d | 430 | mutex_lock(&pnp_lock); |
1da177e4 | 431 | list_add_tail(&drv->global_list, &pnp_card_drivers); |
38f6b38d | 432 | mutex_unlock(&pnp_lock); |
d1d051b2 | 433 | |
9dd78466 BH |
434 | list_for_each_safe(pos, temp, &pnp_cards) { |
435 | struct pnp_card *card = | |
436 | list_entry(pos, struct pnp_card, global_list); | |
437 | card_probe(card, drv); | |
1da177e4 | 438 | } |
982c6094 | 439 | return 0; |
1da177e4 LT |
440 | } |
441 | ||
442 | /** | |
443 | * pnp_unregister_card_driver - unregisters a PnP card driver from the PnP Layer | |
444 | * @drv: pointer to the driver to unregister | |
445 | */ | |
9dd78466 | 446 | void pnp_unregister_card_driver(struct pnp_card_driver *drv) |
1da177e4 | 447 | { |
38f6b38d | 448 | mutex_lock(&pnp_lock); |
1da177e4 | 449 | list_del(&drv->global_list); |
38f6b38d | 450 | mutex_unlock(&pnp_lock); |
1da177e4 LT |
451 | pnp_unregister_driver(&drv->link); |
452 | } | |
453 | ||
1da177e4 LT |
454 | EXPORT_SYMBOL(pnp_request_card_device); |
455 | EXPORT_SYMBOL(pnp_release_card_device); | |
456 | EXPORT_SYMBOL(pnp_register_card_driver); | |
457 | EXPORT_SYMBOL(pnp_unregister_card_driver); |