Automatic merge of rsync://rsync.kernel.org/pub/scm/linux/kernel/git/torvalds/linux...
[linux-2.6] / drivers / net / wireless / atmel_cs.c
1 /*** -*- linux-c -*- **********************************************************
2
3      Driver for Atmel at76c502 at76c504 and at76c506 wireless cards.
4
5         Copyright 2000-2001 ATMEL Corporation.
6         Copyright 2003 Simon Kelley.
7
8     This code was developed from version 2.1.1 of the Atmel drivers, 
9     released by Atmel corp. under the GPL in December 2002. It also 
10     includes code from the Linux aironet drivers (C) Benjamin Reed, 
11     and the Linux PCMCIA package, (C) David Hinds. 
12
13     For all queries about this code, please contact the current author, 
14     Simon Kelley <simon@thekelleys.org.uk> and not Atmel Corporation.
15
16     This program is free software; you can redistribute it and/or modify
17     it under the terms of the GNU General Public License as published by
18     the Free Software Foundation; either version 2 of the License, or
19     (at your option) any later version.
20
21     This software is distributed in the hope that it will be useful,
22     but WITHOUT ANY WARRANTY; without even the implied warranty of
23     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
24     GNU General Public License for more details.
25
26     You should have received a copy of the GNU General Public License
27     along with Atmel wireless lan drivers; if not, write to the Free Software
28     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
29
30 ******************************************************************************/
31
32 #include <linux/config.h>
33 #ifdef __IN_PCMCIA_PACKAGE__
34 #include <pcmcia/k_compat.h>
35 #endif
36 #include <linux/init.h>
37 #include <linux/kernel.h>
38 #include <linux/module.h>
39 #include <linux/ptrace.h>
40 #include <linux/slab.h>
41 #include <linux/string.h>
42 #include <linux/netdevice.h>
43 #include <linux/moduleparam.h>
44 #include <linux/device.h>
45
46 #include <pcmcia/version.h>
47 #include <pcmcia/cs_types.h>
48 #include <pcmcia/cs.h>
49 #include <pcmcia/cistpl.h>
50 #include <pcmcia/cisreg.h>
51 #include <pcmcia/ds.h>
52 #include <pcmcia/ciscode.h>
53
54 #include <asm/io.h>
55 #include <asm/system.h>
56 #include <linux/wireless.h>
57
58 #include "atmel.h"
59
60 /*
61    All the PCMCIA modules use PCMCIA_DEBUG to control debugging.  If
62    you do not define PCMCIA_DEBUG at all, all the debug code will be
63    left out.  If you compile with PCMCIA_DEBUG=0, the debug code will
64    be present but disabled -- but it can then be enabled for specific
65    modules at load time with a 'pc_debug=#' option to insmod.
66 */
67 #ifdef PCMCIA_DEBUG
68 static int pc_debug = PCMCIA_DEBUG;
69 module_param(pc_debug, int, 0);
70 static char *version = "$Revision: 1.2 $";
71 #define DEBUG(n, args...) if (pc_debug>(n)) printk(KERN_DEBUG args);
72 #else
73 #define DEBUG(n, args...)
74 #endif
75
76 /*====================================================================*/
77
78 MODULE_AUTHOR("Simon Kelley");
79 MODULE_DESCRIPTION("Support for Atmel at76c50x 802.11 wireless ethernet cards.");
80 MODULE_LICENSE("GPL");
81 MODULE_SUPPORTED_DEVICE("Atmel at76c50x PCMCIA cards");
82
83 /*====================================================================*/
84
85 /*
86    The event() function is this driver's Card Services event handler.
87    It will be called by Card Services when an appropriate card status
88    event is received.  The config() and release() entry points are
89    used to configure or release a socket, in response to card
90    insertion and ejection events.  They are invoked from the atmel_cs
91    event handler. 
92 */
93
94 static void atmel_config(dev_link_t *link);
95 static void atmel_release(dev_link_t *link);
96 static int atmel_event(event_t event, int priority,
97                        event_callback_args_t *args);
98
99 /*
100    The attach() and detach() entry points are used to create and destroy
101    "instances" of the driver, where each instance represents everything
102    needed to manage one actual PCMCIA card.
103 */
104
105 static dev_link_t *atmel_attach(void);
106 static void atmel_detach(dev_link_t *);
107
108 /*
109    You'll also need to prototype all the functions that will actually
110    be used to talk to your device.  See 'pcmem_cs' for a good example
111    of a fully self-sufficient driver; the other drivers rely more or
112    less on other parts of the kernel.
113 */
114
115 /*
116    The dev_info variable is the "key" that is used to match up this
117    device driver with appropriate cards, through the card configuration
118    database.
119 */
120
121 static dev_info_t dev_info = "atmel_cs";
122
123 /*
124    A linked list of "instances" of the  atmelnet device.  Each actual
125    PCMCIA card corresponds to one device instance, and is described
126    by one dev_link_t structure (defined in ds.h).
127
128    You may not want to use a linked list for this -- for example, the
129    memory card driver uses an array of dev_link_t pointers, where minor
130    device numbers are used to derive the corresponding array index.
131 */
132
133 static dev_link_t *dev_list = NULL;
134
135 /*
136    A dev_link_t structure has fields for most things that are needed
137    to keep track of a socket, but there will usually be some device
138    specific information that also needs to be kept track of.  The
139    'priv' pointer in a dev_link_t structure can be used to point to
140    a device-specific private data structure, like this.
141
142    A driver needs to provide a dev_node_t structure for each device
143    on a card.  In some cases, there is only one device per card (for
144    example, ethernet cards, modems).  In other cases, there may be
145    many actual or logical devices (SCSI adapters, memory cards with
146    multiple partitions).  The dev_node_t structures need to be kept
147    in a linked list starting at the 'dev' field of a dev_link_t
148    structure.  We allocate them in the card's private data structure,
149    because they generally shouldn't be allocated dynamically.
150
151    In this case, we also provide a flag to indicate if a device is
152    "stopped" due to a power management event, or card ejection.  The
153    device IO routines can use a flag like this to throttle IO to a
154    card that is not ready to accept it.
155 */
156    
157 typedef struct local_info_t {
158         dev_node_t      node;
159         struct net_device *eth_dev;
160 } local_info_t;
161
162 /*======================================================================
163   
164   atmel_attach() creates an "instance" of the driver, allocating
165   local data structures for one device.  The device is registered
166   with Card Services.
167   
168   The dev_link structure is initialized, but we don't actually
169   configure the card at this point -- we wait until we receive a
170   card insertion event.
171   
172   ======================================================================*/
173
174 static dev_link_t *atmel_attach(void)
175 {
176         client_reg_t client_reg;
177         dev_link_t *link;
178         local_info_t *local;
179         int ret;
180         
181         DEBUG(0, "atmel_attach()\n");
182
183         /* Initialize the dev_link_t structure */
184         link = kmalloc(sizeof(struct dev_link_t), GFP_KERNEL);
185         if (!link) {
186                 printk(KERN_ERR "atmel_cs: no memory for new device\n");
187                 return NULL;
188         }
189         memset(link, 0, sizeof(struct dev_link_t));
190         
191         /* Interrupt setup */
192         link->irq.Attributes = IRQ_TYPE_EXCLUSIVE;
193         link->irq.IRQInfo1 = IRQ_LEVEL_ID;
194         link->irq.Handler = NULL;
195         
196         /*
197           General socket configuration defaults can go here.  In this
198           client, we assume very little, and rely on the CIS for almost
199           everything.  In most clients, many details (i.e., number, sizes,
200           and attributes of IO windows) are fixed by the nature of the
201           device, and can be hard-wired here.
202         */
203         link->conf.Attributes = 0;
204         link->conf.Vcc = 50;
205         link->conf.IntType = INT_MEMORY_AND_IO;
206         
207         /* Allocate space for private device-specific data */
208         local = kmalloc(sizeof(local_info_t), GFP_KERNEL);
209         if (!local) {
210                 printk(KERN_ERR "atmel_cs: no memory for new device\n");
211                 kfree (link);
212                 return NULL;
213         }
214         memset(local, 0, sizeof(local_info_t));
215         link->priv = local;
216         
217         /* Register with Card Services */
218         link->next = dev_list;
219         dev_list = link;
220         client_reg.dev_info = &dev_info;
221         client_reg.EventMask =
222                 CS_EVENT_CARD_INSERTION | CS_EVENT_CARD_REMOVAL |
223                 CS_EVENT_RESET_PHYSICAL | CS_EVENT_CARD_RESET |
224                 CS_EVENT_PM_SUSPEND | CS_EVENT_PM_RESUME;
225         client_reg.event_handler = &atmel_event;
226         client_reg.Version = 0x0210;
227         client_reg.event_callback_args.client_data = link;
228         ret = pcmcia_register_client(&link->handle, &client_reg);
229         if (ret != 0) {
230                 cs_error(link->handle, RegisterClient, ret);
231                 atmel_detach(link);
232                 return NULL;
233         }
234         
235         return link;
236 } /* atmel_attach */
237
238 /*======================================================================
239   
240   This deletes a driver "instance".  The device is de-registered
241   with Card Services.  If it has been released, all local data
242   structures are freed.  Otherwise, the structures will be freed
243   when the device is released.
244   
245   ======================================================================*/
246
247 static void atmel_detach(dev_link_t *link)
248 {
249         dev_link_t **linkp;
250         
251         DEBUG(0, "atmel_detach(0x%p)\n", link);
252         
253         /* Locate device structure */
254         for (linkp = &dev_list; *linkp; linkp = &(*linkp)->next)
255                 if (*linkp == link) break;
256         if (*linkp == NULL)
257                 return;
258
259         if (link->state & DEV_CONFIG)
260                 atmel_release(link);
261                 
262         /* Break the link with Card Services */
263         if (link->handle)
264                 pcmcia_deregister_client(link->handle);
265
266         /* Unlink device structure, free pieces */
267         *linkp = link->next;
268         if (link->priv)
269                 kfree(link->priv);
270         kfree(link);
271 }
272
273 /*======================================================================
274   
275   atmel_config() is scheduled to run after a CARD_INSERTION event
276   is received, to configure the PCMCIA socket, and to make the
277   device available to the system.
278   
279   ======================================================================*/
280
281 #define CS_CHECK(fn, ret) \
282 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
283
284 /* Call-back function to interrogate PCMCIA-specific information
285    about the current existance of the card */
286 static int card_present(void *arg)
287
288         dev_link_t *link = (dev_link_t *)arg;
289         if (link->state & DEV_SUSPEND)
290                 return 0;
291         else if (link->state & DEV_PRESENT)
292                 return 1;
293         
294         return 0;
295 }
296
297 /* list of cards we know about and their firmware requirements.
298    Go either by Manfid or version strings.
299    Cards not in this list will need a firmware parameter to the module
300    in all probability. Note that the SMC 2632 V2 and V3 have the same
301    manfids, so we ignore those and use the version1 strings. */
302
303 static struct { 
304         int manf, card;
305         char *ver1;
306         AtmelFWType firmware;
307         char *name;
308 } card_table[] = {
309         { 0, 0, "WLAN/802.11b PC CARD", ATMEL_FW_TYPE_502D, "Actiontec 802CAT1" },  
310         { 0, 0, "ATMEL/AT76C502AR", ATMEL_FW_TYPE_502, "NoName-RFMD" }, 
311         { 0, 0, "ATMEL/AT76C502AR_D", ATMEL_FW_TYPE_502D, "NoName-revD" }, 
312         { 0, 0, "ATMEL/AT76C502AR_E", ATMEL_FW_TYPE_502E, "NoName-revE" },
313         { 0, 0, "ATMEL/AT76C504", ATMEL_FW_TYPE_504, "NoName-504" },
314         { 0, 0, "ATMEL/AT76C504A", ATMEL_FW_TYPE_504A_2958, "NoName-504a-2958" },
315         { 0, 0, "ATMEL/AT76C504_R", ATMEL_FW_TYPE_504_2958, "NoName-504-2958" },
316         { MANFID_3COM, 0x0620, NULL, ATMEL_FW_TYPE_502_3COM, "3com 3CRWE62092B" }, 
317         { MANFID_3COM, 0x0696, NULL, ATMEL_FW_TYPE_502_3COM, "3com 3CRSHPW196" }, 
318         { 0, 0, "SMC/2632W-V2", ATMEL_FW_TYPE_502, "SMC 2632W-V2" },
319         { 0, 0, "SMC/2632W", ATMEL_FW_TYPE_502D, "SMC 2632W-V3" },
320         { 0xd601, 0x0007, NULL, ATMEL_FW_TYPE_502, "Sitecom WLAN-011" }, 
321         { 0x01bf, 0x3302, NULL, ATMEL_FW_TYPE_502E, "Belkin F5D6020-V2" }, 
322         { 0, 0, "BT/Voyager 1020 Laptop Adapter", ATMEL_FW_TYPE_502, "BT Voyager 1020" },
323         { 0, 0, "IEEE 802.11b/Wireless LAN PC Card", ATMEL_FW_TYPE_502, "Siemens Gigaset PC Card II" },
324         { 0, 0, "IEEE 802.11b/Wireless LAN Card S", ATMEL_FW_TYPE_504_2958, "Siemens Gigaset PC Card II" },
325         { 0, 0, "CNet/CNWLC 11Mbps Wireless PC Card V-5", ATMEL_FW_TYPE_502E, "CNet CNWLC-811ARL" },
326         { 0, 0, "Wireless/PC_CARD", ATMEL_FW_TYPE_502D, "Planet WL-3552" },
327         { 0, 0, "OEM/11Mbps Wireless LAN PC Card V-3", ATMEL_FW_TYPE_502, "OEM 11Mbps WLAN PCMCIA Card" },
328         { 0, 0, "11WAVE/11WP611AL-E", ATMEL_FW_TYPE_502E, "11WAVE WaveBuddy" },
329         { 0, 0, "LG/LW2100N", ATMEL_FW_TYPE_502E, "LG LW2100N 11Mbps WLAN PCMCIA Card" },
330 };
331
332 static void atmel_config(dev_link_t *link)
333 {
334         client_handle_t handle;
335         tuple_t tuple;
336         cisparse_t parse;
337         local_info_t *dev;
338         int last_fn, last_ret;
339         u_char buf[64];
340         int card_index = -1, done = 0;
341         
342         handle = link->handle;
343         dev = link->priv;
344
345         DEBUG(0, "atmel_config(0x%p)\n", link);
346         
347         tuple.Attributes = 0;
348         tuple.TupleData = buf;
349         tuple.TupleDataMax = sizeof(buf);
350         tuple.TupleOffset = 0;
351         
352         tuple.DesiredTuple = CISTPL_MANFID;
353         if (pcmcia_get_first_tuple(handle, &tuple) == 0) {
354                 int i;
355                 cistpl_manfid_t *manfid;
356                 CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
357                 CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
358                 manfid = &(parse.manfid);
359                 for (i = 0; i < sizeof(card_table)/sizeof(card_table[0]); i++) {
360                         if (!card_table[i].ver1 &&
361                             manfid->manf == card_table[i].manf &&
362                             manfid->card == card_table[i].card) {
363                                 card_index = i;
364                                 done = 1;
365                         }
366                 }
367         }
368
369         tuple.DesiredTuple = CISTPL_VERS_1;
370         if (!done && (pcmcia_get_first_tuple(handle, &tuple) == 0)) {
371                 int i, j, k;
372                 cistpl_vers_1_t *ver1;
373                 CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
374                 CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
375                 ver1 = &(parse.version_1);
376                 
377                 for (i = 0; i < sizeof(card_table)/sizeof(card_table[0]); i++) {
378                         for (j = 0; j < ver1->ns; j++) {
379                                 char *p = card_table[i].ver1;
380                                 char *q = &ver1->str[ver1->ofs[j]];
381                                 if (!p)
382                                         goto mismatch;
383                                 for (k = 0; k < j; k++) {
384                                         while ((*p != '\0') && (*p != '/')) p++;
385                                         if (*p == '\0') {
386                                                 if (*q != '\0')
387                                                         goto mismatch;
388                                         } else {
389                                                 p++;
390                                         }
391                                 }
392                                 while((*q != '\0') && (*p != '\0') && 
393                                       (*p != '/') && (*p == *q)) p++, q++;
394                                 if (((*p != '\0') && *p != '/') || *q != '\0')
395                                         goto mismatch;
396                         }
397                         card_index = i;
398                         break;  /* done */
399                         
400                 mismatch:
401                         j = 0; /* dummy stmt to shut up compiler */
402                 }
403         }               
404
405         /*
406           This reads the card's CONFIG tuple to find its configuration
407           registers.
408         */
409         tuple.DesiredTuple = CISTPL_CONFIG;
410         CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
411         CS_CHECK(GetTupleData, pcmcia_get_tuple_data(handle, &tuple));
412         CS_CHECK(ParseTuple, pcmcia_parse_tuple(handle, &tuple, &parse));
413         link->conf.ConfigBase = parse.config.base;
414         link->conf.Present = parse.config.rmask[0];
415         
416         /* Configure card */
417         link->state |= DEV_CONFIG;
418         
419         /*
420           In this loop, we scan the CIS for configuration table entries,
421           each of which describes a valid card configuration, including
422           voltage, IO window, memory window, and interrupt settings.
423           
424           We make no assumptions about the card to be configured: we use
425           just the information available in the CIS.  In an ideal world,
426           this would work for any PCMCIA card, but it requires a complete
427           and accurate CIS.  In practice, a driver usually "knows" most of
428           these things without consulting the CIS, and most client drivers
429           will only use the CIS to fill in implementation-defined details.
430         */
431         tuple.DesiredTuple = CISTPL_CFTABLE_ENTRY;
432         CS_CHECK(GetFirstTuple, pcmcia_get_first_tuple(handle, &tuple));
433         while (1) {
434                 cistpl_cftable_entry_t dflt = { 0 };
435                 cistpl_cftable_entry_t *cfg = &(parse.cftable_entry);
436                 if (pcmcia_get_tuple_data(handle, &tuple) != 0 ||
437                                 pcmcia_parse_tuple(handle, &tuple, &parse) != 0)
438                         goto next_entry;
439                 
440                 if (cfg->flags & CISTPL_CFTABLE_DEFAULT) dflt = *cfg;
441                 if (cfg->index == 0) goto next_entry;
442                 link->conf.ConfigIndex = cfg->index;
443                 
444                 /* Does this card need audio output? */
445                 if (cfg->flags & CISTPL_CFTABLE_AUDIO) {
446                         link->conf.Attributes |= CONF_ENABLE_SPKR;
447                         link->conf.Status = CCSR_AUDIO_ENA;
448                 }
449                 
450                 /* Use power settings for Vcc and Vpp if present */
451                 /*  Note that the CIS values need to be rescaled */
452                 if (cfg->vcc.present & (1<<CISTPL_POWER_VNOM))
453                         link->conf.Vcc = cfg->vcc.param[CISTPL_POWER_VNOM]/10000;
454                 else if (dflt.vcc.present & (1<<CISTPL_POWER_VNOM))
455                         link->conf.Vcc = dflt.vcc.param[CISTPL_POWER_VNOM]/10000;
456                 
457                 if (cfg->vpp1.present & (1<<CISTPL_POWER_VNOM))
458                         link->conf.Vpp1 = link->conf.Vpp2 =
459                                 cfg->vpp1.param[CISTPL_POWER_VNOM]/10000;
460                 else if (dflt.vpp1.present & (1<<CISTPL_POWER_VNOM))
461                         link->conf.Vpp1 = link->conf.Vpp2 =
462                                 dflt.vpp1.param[CISTPL_POWER_VNOM]/10000;
463                 
464                 /* Do we need to allocate an interrupt? */
465                 if (cfg->irq.IRQInfo1 || dflt.irq.IRQInfo1)
466                         link->conf.Attributes |= CONF_ENABLE_IRQ;
467                 
468                 /* IO window settings */
469                 link->io.NumPorts1 = link->io.NumPorts2 = 0;
470                 if ((cfg->io.nwin > 0) || (dflt.io.nwin > 0)) {
471                         cistpl_io_t *io = (cfg->io.nwin) ? &cfg->io : &dflt.io;
472                         link->io.Attributes1 = IO_DATA_PATH_WIDTH_AUTO;
473                         if (!(io->flags & CISTPL_IO_8BIT))
474                                 link->io.Attributes1 = IO_DATA_PATH_WIDTH_16;
475                         if (!(io->flags & CISTPL_IO_16BIT))
476                                 link->io.Attributes1 = IO_DATA_PATH_WIDTH_8;
477                         link->io.BasePort1 = io->win[0].base;
478                         link->io.NumPorts1 = io->win[0].len;
479                         if (io->nwin > 1) {
480                                 link->io.Attributes2 = link->io.Attributes1;
481                                 link->io.BasePort2 = io->win[1].base;
482                                 link->io.NumPorts2 = io->win[1].len;
483                         }
484                 }
485                 
486                 /* This reserves IO space but doesn't actually enable it */
487                 if (pcmcia_request_io(link->handle, &link->io) != 0)
488                         goto next_entry;
489
490                 /* If we got this far, we're cool! */
491                 break;
492                 
493         next_entry:
494                 CS_CHECK(GetNextTuple, pcmcia_get_next_tuple(handle, &tuple));
495         }
496         
497         /*
498           Allocate an interrupt line.  Note that this does not assign a
499           handler to the interrupt, unless the 'Handler' member of the
500           irq structure is initialized.
501         */
502         if (link->conf.Attributes & CONF_ENABLE_IRQ)
503                 CS_CHECK(RequestIRQ, pcmcia_request_irq(link->handle, &link->irq));
504         
505         /*
506           This actually configures the PCMCIA socket -- setting up
507           the I/O windows and the interrupt mapping, and putting the
508           card and host interface into "Memory and IO" mode.
509         */
510         CS_CHECK(RequestConfiguration, pcmcia_request_configuration(link->handle, &link->conf));
511         
512         if (link->irq.AssignedIRQ == 0) {
513                 printk(KERN_ALERT 
514                        "atmel: cannot assign IRQ: check that CONFIG_ISA is set in kernel config.");
515                 goto cs_failed;
516         }
517        
518         ((local_info_t*)link->priv)->eth_dev = 
519                 init_atmel_card(link->irq.AssignedIRQ,
520                                 link->io.BasePort1,
521                                 card_index == -1 ? ATMEL_FW_TYPE_NONE :  card_table[card_index].firmware,
522                                 &handle_to_dev(handle),
523                                 card_present, 
524                                 link);
525         if (!((local_info_t*)link->priv)->eth_dev) 
526                 goto cs_failed;
527         
528         /*
529           At this point, the dev_node_t structure(s) need to be
530           initialized and arranged in a linked list at link->dev.
531         */
532         strcpy(dev->node.dev_name, ((local_info_t*)link->priv)->eth_dev->name );
533         dev->node.major = dev->node.minor = 0;
534         link->dev = &dev->node;
535         
536         /* Finally, report what we've done */
537         printk(KERN_INFO "%s: %s%sindex 0x%02x: Vcc %d.%d",
538                dev->node.dev_name,
539                card_index == -1 ? "" :  card_table[card_index].name,
540                card_index == -1 ? "" : " ",
541                link->conf.ConfigIndex,
542                link->conf.Vcc/10, link->conf.Vcc%10);
543         if (link->conf.Vpp1)
544                 printk(", Vpp %d.%d", link->conf.Vpp1/10, link->conf.Vpp1%10);
545         if (link->conf.Attributes & CONF_ENABLE_IRQ)
546                 printk(", irq %d", link->irq.AssignedIRQ);
547         if (link->io.NumPorts1)
548                 printk(", io 0x%04x-0x%04x", link->io.BasePort1,
549                        link->io.BasePort1+link->io.NumPorts1-1);
550         if (link->io.NumPorts2)
551                 printk(" & 0x%04x-0x%04x", link->io.BasePort2,
552                        link->io.BasePort2+link->io.NumPorts2-1);
553         printk("\n");
554         
555         link->state &= ~DEV_CONFIG_PENDING;
556         return;
557         
558  cs_failed:
559         cs_error(link->handle, last_fn, last_ret);
560         atmel_release(link);
561 }
562
563 /*======================================================================
564   
565   After a card is removed, atmel_release() will unregister the
566   device, and release the PCMCIA configuration.  If the device is
567   still open, this will be postponed until it is closed.
568   
569   ======================================================================*/
570
571 static void atmel_release(dev_link_t *link)
572 {
573         struct net_device *dev = ((local_info_t*)link->priv)->eth_dev;
574                 
575         DEBUG(0, "atmel_release(0x%p)\n", link);
576         
577         /* Unlink the device chain */
578         link->dev = NULL;
579         
580         if (dev) 
581                 stop_atmel_card(dev, 0);
582         ((local_info_t*)link->priv)->eth_dev = NULL; 
583         
584         /* Don't bother checking to see if these succeed or not */
585         pcmcia_release_configuration(link->handle);
586         if (link->io.NumPorts1)
587                 pcmcia_release_io(link->handle, &link->io);
588         if (link->irq.AssignedIRQ)
589                 pcmcia_release_irq(link->handle, &link->irq);
590         link->state &= ~DEV_CONFIG;
591 }
592
593 /*======================================================================
594   
595   The card status event handler.  Mostly, this schedules other
596   stuff to run after an event is received.
597
598   When a CARD_REMOVAL event is received, we immediately set a
599   private flag to block future accesses to this device.  All the
600   functions that actually access the device should check this flag
601   to make sure the card is still present.
602   
603   ======================================================================*/
604
605 static int atmel_event(event_t event, int priority,
606                       event_callback_args_t *args)
607 {
608         dev_link_t *link = args->client_data;
609         local_info_t *local = link->priv;
610         
611         DEBUG(1, "atmel_event(0x%06x)\n", event);
612         
613         switch (event) {
614         case CS_EVENT_CARD_REMOVAL:
615                 link->state &= ~DEV_PRESENT;
616                 if (link->state & DEV_CONFIG) {
617                         netif_device_detach(local->eth_dev);
618                         atmel_release(link);
619                 }
620                 break;
621         case CS_EVENT_CARD_INSERTION:
622                 link->state |= DEV_PRESENT | DEV_CONFIG_PENDING;
623                 atmel_config(link);
624                 break;
625         case CS_EVENT_PM_SUSPEND:
626                 link->state |= DEV_SUSPEND;
627                 /* Fall through... */
628         case CS_EVENT_RESET_PHYSICAL:
629                 if (link->state & DEV_CONFIG) {
630                         netif_device_detach(local->eth_dev);
631                         pcmcia_release_configuration(link->handle);
632                 }
633                 break;
634         case CS_EVENT_PM_RESUME:
635                 link->state &= ~DEV_SUSPEND;
636                 /* Fall through... */
637         case CS_EVENT_CARD_RESET:
638                 if (link->state & DEV_CONFIG) {
639                         pcmcia_request_configuration(link->handle, &link->conf);
640                         atmel_open(local->eth_dev);
641                         netif_device_attach(local->eth_dev);
642                 }
643                 break;
644         }
645         return 0;
646 } /* atmel_event */
647
648 /*====================================================================*/
649 static struct pcmcia_driver atmel_driver = {
650         .owner          = THIS_MODULE,
651         .drv            = {
652                 .name   = "atmel_cs",
653         },
654         .attach         = atmel_attach,
655         .detach         = atmel_detach,
656 };
657
658 static int atmel_cs_init(void)
659 {
660         return pcmcia_register_driver(&atmel_driver);
661 }
662
663 static void atmel_cs_cleanup(void)
664 {
665         pcmcia_unregister_driver(&atmel_driver);
666         BUG_ON(dev_list != NULL);
667 }
668
669 /*
670     This program is free software; you can redistribute it and/or
671     modify it under the terms of the GNU General Public License
672     as published by the Free Software Foundation; either version 2
673     of the License, or (at your option) any later version.
674
675     This program is distributed in the hope that it will be useful,
676     but WITHOUT ANY WARRANTY; without even the implied warranty of
677     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
678     GNU General Public License for more details.
679
680     In addition:
681
682     Redistribution and use in source and binary forms, with or without
683     modification, are permitted provided that the following conditions
684     are met:
685
686     1. Redistributions of source code must retain the above copyright
687        notice, this list of conditions and the following disclaimer.
688     2. Redistributions in binary form must reproduce the above copyright
689        notice, this list of conditions and the following disclaimer in the
690        documentation and/or other materials provided with the distribution.
691     3. The name of the author may not be used to endorse or promote
692        products derived from this software without specific prior written
693        permission.
694
695     THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
696     IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
697     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
698     ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
699     INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
700     (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
701     SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
702     HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
703     STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING
704     IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
705     POSSIBILITY OF SUCH DAMAGE.    
706 */
707
708 module_init(atmel_cs_init);
709 module_exit(atmel_cs_cleanup);