xref: /openbmc/linux/drivers/pcmcia/cs.c (revision 216d7cdd) 
1 /*
2  * cs.c -- Kernel Card Services - core services
3  *
4  * This program is free software; you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License version 2 as
6  * published by the Free Software Foundation.
7  *
8  * The initial developer of the original code is David A. Hinds
9  * <dahinds@users.sourceforge.net>.  Portions created by David A. Hinds
10  * are Copyright (C) 1999 David A. Hinds.  All Rights Reserved.
11  *
12  * (C) 1999		David A. Hinds
13  */
14 
15 #include <linux/module.h>
16 #include <linux/moduleparam.h>
17 #include <linux/init.h>
18 #include <linux/kernel.h>
19 #include <linux/string.h>
20 #include <linux/major.h>
21 #include <linux/errno.h>
22 #include <linux/slab.h>
23 #include <linux/mm.h>
24 #include <linux/interrupt.h>
25 #include <linux/timer.h>
26 #include <linux/ioport.h>
27 #include <linux/delay.h>
28 #include <linux/pm.h>
29 #include <linux/device.h>
30 #include <linux/kthread.h>
31 #include <linux/freezer.h>
32 #include <asm/system.h>
33 #include <asm/irq.h>
34 
35 #include <pcmcia/cs_types.h>
36 #include <pcmcia/ss.h>
37 #include <pcmcia/cs.h>
38 #include <pcmcia/cistpl.h>
39 #include <pcmcia/cisreg.h>
40 #include <pcmcia/ds.h>
41 #include "cs_internal.h"
42 
43 
44 /* Module parameters */
45 
46 MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
47 MODULE_DESCRIPTION("Linux Kernel Card Services");
48 MODULE_LICENSE("GPL");
49 
50 #define INT_MODULE_PARM(n, v) static int n = v; module_param(n, int, 0444)
51 
52 INT_MODULE_PARM(setup_delay,	10);		/* centiseconds */
53 INT_MODULE_PARM(resume_delay,	20);		/* centiseconds */
54 INT_MODULE_PARM(shutdown_delay,	3);		/* centiseconds */
55 INT_MODULE_PARM(vcc_settle,	40);		/* centiseconds */
56 INT_MODULE_PARM(reset_time,	10);		/* usecs */
57 INT_MODULE_PARM(unreset_delay,	10);		/* centiseconds */
58 INT_MODULE_PARM(unreset_check,	10);		/* centiseconds */
59 INT_MODULE_PARM(unreset_limit,	30);		/* unreset_check's */
60 
61 /* Access speed for attribute memory windows */
62 INT_MODULE_PARM(cis_speed,	300);		/* ns */
63 
64 
65 socket_state_t dead_socket = {
66 	.csc_mask	= SS_DETECT,
67 };
68 EXPORT_SYMBOL(dead_socket);
69 
70 
71 /* List of all sockets, protected by a rwsem */
72 LIST_HEAD(pcmcia_socket_list);
73 EXPORT_SYMBOL(pcmcia_socket_list);
74 
75 DECLARE_RWSEM(pcmcia_socket_list_rwsem);
76 EXPORT_SYMBOL(pcmcia_socket_list_rwsem);
77 
78 
79 struct pcmcia_socket *pcmcia_get_socket(struct pcmcia_socket *skt)
80 {
81 	struct device *dev = get_device(&skt->dev);
82 	if (!dev)
83 		return NULL;
84 	return dev_get_drvdata(dev);
85 }
86 EXPORT_SYMBOL(pcmcia_get_socket);
87 
88 
89 void pcmcia_put_socket(struct pcmcia_socket *skt)
90 {
91 	put_device(&skt->dev);
92 }
93 EXPORT_SYMBOL(pcmcia_put_socket);
94 
95 
96 static void pcmcia_release_socket(struct device *dev)
97 {
98 	struct pcmcia_socket *socket = dev_get_drvdata(dev);
99 
100 	complete(&socket->socket_released);
101 }
102 
103 static int pccardd(void *__skt);
104 
105 /**
106  * pcmcia_register_socket - add a new pcmcia socket device
107  * @socket: the &socket to register
108  */
109 int pcmcia_register_socket(struct pcmcia_socket *socket)
110 {
111 	struct task_struct *tsk;
112 	int ret;
113 
114 	if (!socket || !socket->ops || !socket->dev.parent || !socket->resource_ops)
115 		return -EINVAL;
116 
117 	dev_dbg(&socket->dev, "pcmcia_register_socket(0x%p)\n", socket->ops);
118 
119 	/* try to obtain a socket number [yes, it gets ugly if we
120 	 * register more than 2^sizeof(unsigned int) pcmcia
121 	 * sockets... but the socket number is deprecated
122 	 * anyways, so I don't care] */
123 	down_write(&pcmcia_socket_list_rwsem);
124 	if (list_empty(&pcmcia_socket_list))
125 		socket->sock = 0;
126 	else {
127 		unsigned int found, i = 1;
128 		struct pcmcia_socket *tmp;
129 		do {
130 			found = 1;
131 			list_for_each_entry(tmp, &pcmcia_socket_list, socket_list) {
132 				if (tmp->sock == i)
133 					found = 0;
134 			}
135 			i++;
136 		} while (!found);
137 		socket->sock = i - 1;
138 	}
139 	list_add_tail(&socket->socket_list, &pcmcia_socket_list);
140 	up_write(&pcmcia_socket_list_rwsem);
141 
142 #ifndef CONFIG_CARDBUS
143 	/*
144 	 * If we do not support Cardbus, ensure that
145 	 * the Cardbus socket capability is disabled.
146 	 */
147 	socket->features &= ~SS_CAP_CARDBUS;
148 #endif
149 
150 	/* set proper values in socket->dev */
151 	dev_set_drvdata(&socket->dev, socket);
152 	socket->dev.class = &pcmcia_socket_class;
153 	dev_set_name(&socket->dev, "pcmcia_socket%u", socket->sock);
154 
155 	/* base address = 0, map = 0 */
156 	socket->cis_mem.flags = 0;
157 	socket->cis_mem.speed = cis_speed;
158 
159 	INIT_LIST_HEAD(&socket->cis_cache);
160 
161 	init_completion(&socket->socket_released);
162 	init_completion(&socket->thread_done);
163 	mutex_init(&socket->skt_mutex);
164 	mutex_init(&socket->ops_mutex);
165 	spin_lock_init(&socket->thread_lock);
166 
167 	if (socket->resource_ops->init) {
168 		mutex_lock(&socket->ops_mutex);
169 		ret = socket->resource_ops->init(socket);
170 		mutex_unlock(&socket->ops_mutex);
171 		if (ret)
172 			goto err;
173 	}
174 
175 	tsk = kthread_run(pccardd, socket, "pccardd");
176 	if (IS_ERR(tsk)) {
177 		ret = PTR_ERR(tsk);
178 		goto err;
179 	}
180 
181 	wait_for_completion(&socket->thread_done);
182 	if (!socket->thread) {
183 		dev_printk(KERN_WARNING, &socket->dev,
184 			   "PCMCIA: warning: socket thread did not start\n");
185 		return -EIO;
186 	}
187 
188 	pcmcia_parse_events(socket, SS_DETECT);
189 
190 	/*
191 	 * Let's try to get the PCMCIA module for 16-bit PCMCIA support.
192 	 * If it fails, it doesn't matter -- we still have 32-bit CardBus
193 	 * support to offer, so this is not a failure mode.
194 	 */
195 	request_module_nowait("pcmcia");
196 
197 	return 0;
198 
199  err:
200 	down_write(&pcmcia_socket_list_rwsem);
201 	list_del(&socket->socket_list);
202 	up_write(&pcmcia_socket_list_rwsem);
203 	return ret;
204 } /* pcmcia_register_socket */
205 EXPORT_SYMBOL(pcmcia_register_socket);
206 
207 
208 /**
209  * pcmcia_unregister_socket - remove a pcmcia socket device
210  * @socket: the &socket to unregister
211  */
212 void pcmcia_unregister_socket(struct pcmcia_socket *socket)
213 {
214 	if (!socket)
215 		return;
216 
217 	dev_dbg(&socket->dev, "pcmcia_unregister_socket(0x%p)\n", socket->ops);
218 
219 	if (socket->thread)
220 		kthread_stop(socket->thread);
221 
222 	/* remove from our own list */
223 	down_write(&pcmcia_socket_list_rwsem);
224 	list_del(&socket->socket_list);
225 	up_write(&pcmcia_socket_list_rwsem);
226 
227 	/* wait for sysfs to drop all references */
228 	if (socket->resource_ops->exit) {
229 		mutex_lock(&socket->ops_mutex);
230 		socket->resource_ops->exit(socket);
231 		mutex_unlock(&socket->ops_mutex);
232 	}
233 	wait_for_completion(&socket->socket_released);
234 } /* pcmcia_unregister_socket */
235 EXPORT_SYMBOL(pcmcia_unregister_socket);
236 
237 
238 struct pcmcia_socket *pcmcia_get_socket_by_nr(unsigned int nr)
239 {
240 	struct pcmcia_socket *s;
241 
242 	down_read(&pcmcia_socket_list_rwsem);
243 	list_for_each_entry(s, &pcmcia_socket_list, socket_list)
244 		if (s->sock == nr) {
245 			up_read(&pcmcia_socket_list_rwsem);
246 			return s;
247 		}
248 	up_read(&pcmcia_socket_list_rwsem);
249 
250 	return NULL;
251 
252 }
253 EXPORT_SYMBOL(pcmcia_get_socket_by_nr);
254 
255 /*
256  * The central event handler.  Send_event() sends an event to the
257  * 16-bit subsystem, which then calls the relevant device drivers.
258  * Parse_events() interprets the event bits from
259  * a card status change report.  Do_shutdown() handles the high
260  * priority stuff associated with a card removal.
261  */
262 
263 /* NOTE: send_event needs to be called with skt->sem held. */
264 
265 static int send_event(struct pcmcia_socket *s, event_t event, int priority)
266 {
267 	if ((s->state & SOCKET_CARDBUS) && (event != CS_EVENT_CARD_REMOVAL))
268 		return 0;
269 
270 	dev_dbg(&s->dev, "send_event(event %d, pri %d, callback 0x%p)\n",
271 	   event, priority, s->callback);
272 
273 	if (!s->callback)
274 		return 0;
275 
276 	return s->callback->event(s, event, priority);
277 }
278 
279 static int socket_reset(struct pcmcia_socket *skt)
280 {
281 	int status, i;
282 
283 	dev_dbg(&skt->dev, "reset\n");
284 
285 	skt->socket.flags |= SS_OUTPUT_ENA | SS_RESET;
286 	skt->ops->set_socket(skt, &skt->socket);
287 	udelay((long)reset_time);
288 
289 	skt->socket.flags &= ~SS_RESET;
290 	skt->ops->set_socket(skt, &skt->socket);
291 
292 	msleep(unreset_delay * 10);
293 	for (i = 0; i < unreset_limit; i++) {
294 		skt->ops->get_status(skt, &status);
295 
296 		if (!(status & SS_DETECT))
297 			return -ENODEV;
298 
299 		if (status & SS_READY)
300 			return 0;
301 
302 		msleep(unreset_check * 10);
303 	}
304 
305 	dev_printk(KERN_ERR, &skt->dev, "time out after reset.\n");
306 	return -ETIMEDOUT;
307 }
308 
309 /*
310  * socket_setup() and socket_shutdown() are called by the main event handler
311  * when card insertion and removal events are received.
312  * socket_setup() turns on socket power and resets the socket, in two stages.
313  * socket_shutdown() unconfigures a socket and turns off socket power.
314  */
315 static void socket_shutdown(struct pcmcia_socket *s)
316 {
317 	int status;
318 
319 	dev_dbg(&s->dev, "shutdown\n");
320 
321 	send_event(s, CS_EVENT_CARD_REMOVAL, CS_EVENT_PRI_HIGH);
322 
323 	mutex_lock(&s->ops_mutex);
324 	s->state &= SOCKET_INUSE | SOCKET_PRESENT;
325 	msleep(shutdown_delay * 10);
326 	s->state &= SOCKET_INUSE;
327 
328 	/* Blank out the socket state */
329 	s->socket = dead_socket;
330 	s->ops->init(s);
331 	s->ops->set_socket(s, &s->socket);
332 	s->lock_count = 0;
333 	kfree(s->fake_cis);
334 	s->fake_cis = NULL;
335 	s->functions = 0;
336 
337 	/* From here on we can be sure that only we (that is, the
338 	 * pccardd thread) accesses this socket, and all (16-bit)
339 	 * PCMCIA interactions are gone. Therefore, release
340 	 * ops_mutex so that we don't get a sysfs-related lockdep
341 	 * warning.
342 	 */
343 	mutex_unlock(&s->ops_mutex);
344 
345 #ifdef CONFIG_CARDBUS
346 	cb_free(s);
347 #endif
348 
349 	/* give socket some time to power down */
350 	msleep(100);
351 
352 	s->ops->get_status(s, &status);
353 	if (status & SS_POWERON) {
354 		dev_printk(KERN_ERR, &s->dev,
355 			   "*** DANGER *** unable to remove socket power\n");
356 	}
357 
358 	s->state &= ~SOCKET_INUSE;
359 }
360 
361 static int socket_setup(struct pcmcia_socket *skt, int initial_delay)
362 {
363 	int status, i;
364 
365 	dev_dbg(&skt->dev, "setup\n");
366 
367 	skt->ops->get_status(skt, &status);
368 	if (!(status & SS_DETECT))
369 		return -ENODEV;
370 
371 	msleep(initial_delay * 10);
372 
373 	for (i = 0; i < 100; i++) {
374 		skt->ops->get_status(skt, &status);
375 		if (!(status & SS_DETECT))
376 			return -ENODEV;
377 
378 		if (!(status & SS_PENDING))
379 			break;
380 
381 		msleep(100);
382 	}
383 
384 	if (status & SS_PENDING) {
385 		dev_printk(KERN_ERR, &skt->dev,
386 			   "voltage interrogation timed out.\n");
387 		return -ETIMEDOUT;
388 	}
389 
390 	if (status & SS_CARDBUS) {
391 		if (!(skt->features & SS_CAP_CARDBUS)) {
392 			dev_printk(KERN_ERR, &skt->dev,
393 				"cardbus cards are not supported.\n");
394 			return -EINVAL;
395 		}
396 		skt->state |= SOCKET_CARDBUS;
397 	} else
398 		skt->state &= ~SOCKET_CARDBUS;
399 
400 	/*
401 	 * Decode the card voltage requirements, and apply power to the card.
402 	 */
403 	if (status & SS_3VCARD)
404 		skt->socket.Vcc = skt->socket.Vpp = 33;
405 	else if (!(status & SS_XVCARD))
406 		skt->socket.Vcc = skt->socket.Vpp = 50;
407 	else {
408 		dev_printk(KERN_ERR, &skt->dev, "unsupported voltage key.\n");
409 		return -EIO;
410 	}
411 
412 	if (skt->power_hook)
413 		skt->power_hook(skt, HOOK_POWER_PRE);
414 
415 	skt->socket.flags = 0;
416 	skt->ops->set_socket(skt, &skt->socket);
417 
418 	/*
419 	 * Wait "vcc_settle" for the supply to stabilise.
420 	 */
421 	msleep(vcc_settle * 10);
422 
423 	skt->ops->get_status(skt, &status);
424 	if (!(status & SS_POWERON)) {
425 		dev_printk(KERN_ERR, &skt->dev, "unable to apply power.\n");
426 		return -EIO;
427 	}
428 
429 	status = socket_reset(skt);
430 
431 	if (skt->power_hook)
432 		skt->power_hook(skt, HOOK_POWER_POST);
433 
434 	return status;
435 }
436 
437 /*
438  * Handle card insertion.  Setup the socket, reset the card,
439  * and then tell the rest of PCMCIA that a card is present.
440  */
441 static int socket_insert(struct pcmcia_socket *skt)
442 {
443 	int ret;
444 
445 	dev_dbg(&skt->dev, "insert\n");
446 
447 	mutex_lock(&skt->ops_mutex);
448 	if (skt->state & SOCKET_INUSE) {
449 		mutex_unlock(&skt->ops_mutex);
450 		return -EINVAL;
451 	}
452 	skt->state |= SOCKET_INUSE;
453 
454 	ret = socket_setup(skt, setup_delay);
455 	if (ret == 0) {
456 		skt->state |= SOCKET_PRESENT;
457 
458 		dev_printk(KERN_NOTICE, &skt->dev,
459 			   "pccard: %s card inserted into slot %d\n",
460 			   (skt->state & SOCKET_CARDBUS) ? "CardBus" : "PCMCIA",
461 			   skt->sock);
462 
463 #ifdef CONFIG_CARDBUS
464 		if (skt->state & SOCKET_CARDBUS) {
465 			cb_alloc(skt);
466 			skt->state |= SOCKET_CARDBUS_CONFIG;
467 		}
468 #endif
469 		dev_dbg(&skt->dev, "insert done\n");
470 		mutex_unlock(&skt->ops_mutex);
471 
472 		send_event(skt, CS_EVENT_CARD_INSERTION, CS_EVENT_PRI_LOW);
473 	} else {
474 		mutex_unlock(&skt->ops_mutex);
475 		socket_shutdown(skt);
476 	}
477 
478 	return ret;
479 }
480 
481 static int socket_suspend(struct pcmcia_socket *skt)
482 {
483 	if (skt->state & SOCKET_SUSPEND)
484 		return -EBUSY;
485 
486 	mutex_lock(&skt->ops_mutex);
487 	skt->suspended_state = skt->state;
488 
489 	skt->socket = dead_socket;
490 	skt->ops->set_socket(skt, &skt->socket);
491 	if (skt->ops->suspend)
492 		skt->ops->suspend(skt);
493 	skt->state |= SOCKET_SUSPEND;
494 	mutex_unlock(&skt->ops_mutex);
495 	return 0;
496 }
497 
498 static int socket_early_resume(struct pcmcia_socket *skt)
499 {
500 	mutex_lock(&skt->ops_mutex);
501 	skt->socket = dead_socket;
502 	skt->ops->init(skt);
503 	skt->ops->set_socket(skt, &skt->socket);
504 	if (skt->state & SOCKET_PRESENT)
505 		skt->resume_status = socket_setup(skt, resume_delay);
506 	mutex_unlock(&skt->ops_mutex);
507 	return 0;
508 }
509 
510 static int socket_late_resume(struct pcmcia_socket *skt)
511 {
512 	int ret;
513 
514 	mutex_lock(&skt->ops_mutex);
515 	skt->state &= ~SOCKET_SUSPEND;
516 	mutex_unlock(&skt->ops_mutex);
517 
518 	if (!(skt->state & SOCKET_PRESENT)) {
519 		ret = socket_insert(skt);
520 		if (ret == -ENODEV)
521 			ret = 0;
522 		return ret;
523 	}
524 
525 	if (skt->resume_status) {
526 		socket_shutdown(skt);
527 		return 0;
528 	}
529 
530 	if (skt->suspended_state != skt->state) {
531 		dev_dbg(&skt->dev,
532 			"suspend state 0x%x != resume state 0x%x\n",
533 			skt->suspended_state, skt->state);
534 
535 		socket_shutdown(skt);
536 		return socket_insert(skt);
537 	}
538 
539 #ifdef CONFIG_CARDBUS
540 	if (skt->state & SOCKET_CARDBUS) {
541 		/* We can't be sure the CardBus card is the same
542 		 * as the one previously inserted. Therefore, remove
543 		 * and re-add... */
544 		cb_free(skt);
545 		cb_alloc(skt);
546 		return 0;
547 	}
548 #endif
549 
550 	send_event(skt, CS_EVENT_PM_RESUME, CS_EVENT_PRI_LOW);
551 	return 0;
552 }
553 
554 /*
555  * Resume a socket.  If a card is present, verify its CIS against
556  * our cached copy.  If they are different, the card has been
557  * replaced, and we need to tell the drivers.
558  */
559 static int socket_resume(struct pcmcia_socket *skt)
560 {
561 	if (!(skt->state & SOCKET_SUSPEND))
562 		return -EBUSY;
563 
564 	socket_early_resume(skt);
565 	return socket_late_resume(skt);
566 }
567 
568 static void socket_remove(struct pcmcia_socket *skt)
569 {
570 	dev_printk(KERN_NOTICE, &skt->dev,
571 		   "pccard: card ejected from slot %d\n", skt->sock);
572 	socket_shutdown(skt);
573 }
574 
575 /*
576  * Process a socket card detect status change.
577  *
578  * If we don't have a card already present, delay the detect event for
579  * about 20ms (to be on the safe side) before reading the socket status.
580  *
581  * Some i82365-based systems send multiple SS_DETECT events during card
582  * insertion, and the "card present" status bit seems to bounce.  This
583  * will probably be true with GPIO-based card detection systems after
584  * the product has aged.
585  */
586 static void socket_detect_change(struct pcmcia_socket *skt)
587 {
588 	if (!(skt->state & SOCKET_SUSPEND)) {
589 		int status;
590 
591 		if (!(skt->state & SOCKET_PRESENT))
592 			msleep(20);
593 
594 		skt->ops->get_status(skt, &status);
595 		if ((skt->state & SOCKET_PRESENT) &&
596 		     !(status & SS_DETECT))
597 			socket_remove(skt);
598 		if (!(skt->state & SOCKET_PRESENT) &&
599 		    (status & SS_DETECT))
600 			socket_insert(skt);
601 	}
602 }
603 
604 static int pccardd(void *__skt)
605 {
606 	struct pcmcia_socket *skt = __skt;
607 	int ret;
608 
609 	skt->thread = current;
610 	skt->socket = dead_socket;
611 	skt->ops->init(skt);
612 	skt->ops->set_socket(skt, &skt->socket);
613 
614 	/* register with the device core */
615 	ret = device_register(&skt->dev);
616 	if (ret) {
617 		dev_printk(KERN_WARNING, &skt->dev,
618 			   "PCMCIA: unable to register socket\n");
619 		skt->thread = NULL;
620 		complete(&skt->thread_done);
621 		return 0;
622 	}
623 	ret = pccard_sysfs_add_socket(&skt->dev);
624 	if (ret)
625 		dev_warn(&skt->dev, "err %d adding socket attributes\n", ret);
626 
627 	complete(&skt->thread_done);
628 
629 	/* wait for userspace to catch up */
630 	msleep(250);
631 
632 	set_freezable();
633 	for (;;) {
634 		unsigned long flags;
635 		unsigned int events;
636 		unsigned int sysfs_events;
637 
638 		set_current_state(TASK_INTERRUPTIBLE);
639 
640 		spin_lock_irqsave(&skt->thread_lock, flags);
641 		events = skt->thread_events;
642 		skt->thread_events = 0;
643 		sysfs_events = skt->sysfs_events;
644 		skt->sysfs_events = 0;
645 		spin_unlock_irqrestore(&skt->thread_lock, flags);
646 
647 		mutex_lock(&skt->skt_mutex);
648 		if (events & SS_DETECT)
649 			socket_detect_change(skt);
650 
651 		if (sysfs_events) {
652 			if (sysfs_events & PCMCIA_UEVENT_EJECT)
653 				socket_remove(skt);
654 			if (sysfs_events & PCMCIA_UEVENT_INSERT)
655 				socket_insert(skt);
656 			if ((sysfs_events & PCMCIA_UEVENT_SUSPEND) &&
657 				!(skt->state & SOCKET_CARDBUS)) {
658 				if (skt->callback)
659 					ret = skt->callback->suspend(skt);
660 				else
661 					ret = 0;
662 				if (!ret) {
663 					socket_suspend(skt);
664 					msleep(100);
665 				}
666 			}
667 			if ((sysfs_events & PCMCIA_UEVENT_RESUME) &&
668 				!(skt->state & SOCKET_CARDBUS)) {
669 				ret = socket_resume(skt);
670 				if (!ret && skt->callback)
671 					skt->callback->resume(skt);
672 			}
673 			if ((sysfs_events & PCMCIA_UEVENT_REQUERY) &&
674 				!(skt->state & SOCKET_CARDBUS)) {
675 				if (!ret && skt->callback)
676 					skt->callback->requery(skt);
677 			}
678 		}
679 		mutex_unlock(&skt->skt_mutex);
680 
681 		if (events || sysfs_events)
682 			continue;
683 
684 		if (kthread_should_stop())
685 			break;
686 
687 		schedule();
688 		try_to_freeze();
689 	}
690 	/* make sure we are running before we exit */
691 	set_current_state(TASK_RUNNING);
692 
693 	/* shut down socket, if a device is still present */
694 	if (skt->state & SOCKET_PRESENT) {
695 		mutex_lock(&skt->skt_mutex);
696 		socket_remove(skt);
697 		mutex_unlock(&skt->skt_mutex);
698 	}
699 
700 	/* remove from the device core */
701 	pccard_sysfs_remove_socket(&skt->dev);
702 	device_unregister(&skt->dev);
703 
704 	return 0;
705 }
706 
707 /*
708  * Yenta (at least) probes interrupts before registering the socket and
709  * starting the handler thread.
710  */
711 void pcmcia_parse_events(struct pcmcia_socket *s, u_int events)
712 {
713 	unsigned long flags;
714 	dev_dbg(&s->dev, "parse_events: events %08x\n", events);
715 	if (s->thread) {
716 		spin_lock_irqsave(&s->thread_lock, flags);
717 		s->thread_events |= events;
718 		spin_unlock_irqrestore(&s->thread_lock, flags);
719 
720 		wake_up_process(s->thread);
721 	}
722 } /* pcmcia_parse_events */
723 EXPORT_SYMBOL(pcmcia_parse_events);
724 
725 /**
726  * pcmcia_parse_uevents() - tell pccardd to issue manual commands
727  * @s:		the PCMCIA socket we wan't to command
728  * @events:	events to pass to pccardd
729  *
730  * userspace-issued insert, eject, suspend and resume commands must be
731  * handled by pccardd to avoid any sysfs-related deadlocks. Valid events
732  * are PCMCIA_UEVENT_EJECT (for eject), PCMCIA_UEVENT__INSERT (for insert),
733  * PCMCIA_UEVENT_RESUME (for resume), PCMCIA_UEVENT_SUSPEND (for suspend)
734  * and PCMCIA_UEVENT_REQUERY (for re-querying the PCMCIA card).
735  */
736 void pcmcia_parse_uevents(struct pcmcia_socket *s, u_int events)
737 {
738 	unsigned long flags;
739 	dev_dbg(&s->dev, "parse_uevents: events %08x\n", events);
740 	if (s->thread) {
741 		spin_lock_irqsave(&s->thread_lock, flags);
742 		s->sysfs_events |= events;
743 		spin_unlock_irqrestore(&s->thread_lock, flags);
744 
745 		wake_up_process(s->thread);
746 	}
747 }
748 EXPORT_SYMBOL(pcmcia_parse_uevents);
749 
750 
751 /* register pcmcia_callback */
752 int pccard_register_pcmcia(struct pcmcia_socket *s, struct pcmcia_callback *c)
753 {
754 	int ret = 0;
755 
756 	/* s->skt_mutex also protects s->callback */
757 	mutex_lock(&s->skt_mutex);
758 
759 	if (c) {
760 		/* registration */
761 		if (s->callback) {
762 			ret = -EBUSY;
763 			goto err;
764 		}
765 
766 		s->callback = c;
767 
768 		if ((s->state & (SOCKET_PRESENT|SOCKET_CARDBUS)) == SOCKET_PRESENT)
769 			send_event(s, CS_EVENT_CARD_INSERTION, CS_EVENT_PRI_LOW);
770 	} else
771 		s->callback = NULL;
772  err:
773 	mutex_unlock(&s->skt_mutex);
774 
775 	return ret;
776 }
777 EXPORT_SYMBOL(pccard_register_pcmcia);
778 
779 
780 /* I'm not sure which "reset" function this is supposed to use,
781  * but for now, it uses the low-level interface's reset, not the
782  * CIS register.
783  */
784 
785 int pcmcia_reset_card(struct pcmcia_socket *skt)
786 {
787 	int ret;
788 
789 	dev_dbg(&skt->dev, "resetting socket\n");
790 
791 	mutex_lock(&skt->skt_mutex);
792 	do {
793 		if (!(skt->state & SOCKET_PRESENT)) {
794 			dev_dbg(&skt->dev, "can't reset, not present\n");
795 			ret = -ENODEV;
796 			break;
797 		}
798 		if (skt->state & SOCKET_SUSPEND) {
799 			dev_dbg(&skt->dev, "can't reset, suspended\n");
800 			ret = -EBUSY;
801 			break;
802 		}
803 		if (skt->state & SOCKET_CARDBUS) {
804 			dev_dbg(&skt->dev, "can't reset, is cardbus\n");
805 			ret = -EPERM;
806 			break;
807 		}
808 
809 		if (skt->callback)
810 			skt->callback->suspend(skt);
811 		mutex_lock(&skt->ops_mutex);
812 		ret = socket_reset(skt);
813 		mutex_unlock(&skt->ops_mutex);
814 		if ((ret == 0) && (skt->callback))
815 			skt->callback->resume(skt);
816 
817 		ret = 0;
818 	} while (0);
819 	mutex_unlock(&skt->skt_mutex);
820 
821 	return ret;
822 } /* reset_card */
823 EXPORT_SYMBOL(pcmcia_reset_card);
824 
825 
826 static int pcmcia_socket_uevent(struct device *dev,
827 				struct kobj_uevent_env *env)
828 {
829 	struct pcmcia_socket *s = container_of(dev, struct pcmcia_socket, dev);
830 
831 	if (add_uevent_var(env, "SOCKET_NO=%u", s->sock))
832 		return -ENOMEM;
833 
834 	return 0;
835 }
836 
837 
838 static struct completion pcmcia_unload;
839 
840 static void pcmcia_release_socket_class(struct class *data)
841 {
842 	complete(&pcmcia_unload);
843 }
844 
845 
846 #ifdef CONFIG_PM
847 
848 static int __pcmcia_pm_op(struct device *dev,
849 			  int (*callback) (struct pcmcia_socket *skt))
850 {
851 	struct pcmcia_socket *s = container_of(dev, struct pcmcia_socket, dev);
852 	int ret;
853 
854 	mutex_lock(&s->skt_mutex);
855 	ret = callback(s);
856 	mutex_unlock(&s->skt_mutex);
857 
858 	return ret;
859 }
860 
861 static int pcmcia_socket_dev_suspend_noirq(struct device *dev)
862 {
863 	return __pcmcia_pm_op(dev, socket_suspend);
864 }
865 
866 static int pcmcia_socket_dev_resume_noirq(struct device *dev)
867 {
868 	return __pcmcia_pm_op(dev, socket_early_resume);
869 }
870 
871 static int pcmcia_socket_dev_resume(struct device *dev)
872 {
873 	return __pcmcia_pm_op(dev, socket_late_resume);
874 }
875 
876 static const struct dev_pm_ops pcmcia_socket_pm_ops = {
877 	/* dev_resume may be called with IRQs enabled */
878 	SET_SYSTEM_SLEEP_PM_OPS(NULL,
879 				pcmcia_socket_dev_resume)
880 
881 	/* late suspend must be called with IRQs disabled */
882 	.suspend_noirq = pcmcia_socket_dev_suspend_noirq,
883 	.freeze_noirq = pcmcia_socket_dev_suspend_noirq,
884 	.poweroff_noirq = pcmcia_socket_dev_suspend_noirq,
885 
886 	/* early resume must be called with IRQs disabled */
887 	.resume_noirq = pcmcia_socket_dev_resume_noirq,
888 	.thaw_noirq = pcmcia_socket_dev_resume_noirq,
889 	.restore_noirq = pcmcia_socket_dev_resume_noirq,
890 };
891 
892 #define PCMCIA_SOCKET_CLASS_PM_OPS (&pcmcia_socket_pm_ops)
893 
894 #else /* CONFIG_PM */
895 
896 #define PCMCIA_SOCKET_CLASS_PM_OPS NULL
897 
898 #endif /* CONFIG_PM */
899 
900 struct class pcmcia_socket_class = {
901 	.name = "pcmcia_socket",
902 	.dev_uevent = pcmcia_socket_uevent,
903 	.dev_release = pcmcia_release_socket,
904 	.class_release = pcmcia_release_socket_class,
905 	.pm = PCMCIA_SOCKET_CLASS_PM_OPS,
906 };
907 EXPORT_SYMBOL(pcmcia_socket_class);
908 
909 
910 static int __init init_pcmcia_cs(void)
911 {
912 	init_completion(&pcmcia_unload);
913 	return class_register(&pcmcia_socket_class);
914 }
915 
916 static void __exit exit_pcmcia_cs(void)
917 {
918 	class_unregister(&pcmcia_socket_class);
919 	wait_for_completion(&pcmcia_unload);
920 }
921 
922 subsys_initcall(init_pcmcia_cs);
923 module_exit(exit_pcmcia_cs);
924 
925