pcmcia: remove obsolete and wrong comments
[pandora-kernel.git] / drivers / net / pcmcia / com20020_cs.c
1 /*
2  * Linux ARCnet driver - COM20020 PCMCIA support
3  * 
4  * Written 1994-1999 by Avery Pennarun,
5  *    based on an ISA version by David Woodhouse.
6  * Derived from ibmtr_cs.c by Steve Kipisz (pcmcia-cs 3.1.4)
7  *    which was derived from pcnet_cs.c by David Hinds.
8  * Some additional portions derived from skeleton.c by Donald Becker.
9  *
10  * Special thanks to Contemporary Controls, Inc. (www.ccontrols.com)
11  *  for sponsoring the further development of this driver.
12  *
13  * **********************
14  *
15  * The original copyright of skeleton.c was as follows:
16  *
17  * skeleton.c Written 1993 by Donald Becker.
18  * Copyright 1993 United States Government as represented by the
19  * Director, National Security Agency.  This software may only be used
20  * and distributed according to the terms of the GNU General Public License as
21  * modified by SRC, incorporated herein by reference.
22  * 
23  * **********************
24  * Changes:
25  * Arnaldo Carvalho de Melo <acme@conectiva.com.br> - 08/08/2000
26  * - reorganize kmallocs in com20020_attach, checking all for failure
27  *   and releasing the previous allocations if one fails
28  * **********************
29  * 
30  * For more details, see drivers/net/arcnet.c
31  *
32  * **********************
33  */
34 #include <linux/kernel.h>
35 #include <linux/init.h>
36 #include <linux/ptrace.h>
37 #include <linux/slab.h>
38 #include <linux/string.h>
39 #include <linux/timer.h>
40 #include <linux/delay.h>
41 #include <linux/module.h>
42 #include <linux/netdevice.h>
43 #include <linux/arcdevice.h>
44 #include <linux/com20020.h>
45
46 #include <pcmcia/cistpl.h>
47 #include <pcmcia/ds.h>
48
49 #include <asm/io.h>
50 #include <asm/system.h>
51
52 #define VERSION "arcnet: COM20020 PCMCIA support loaded.\n"
53
54 #ifdef DEBUG
55
56 static void regdump(struct net_device *dev)
57 {
58     int ioaddr = dev->base_addr;
59     int count;
60     
61     printk("com20020 register dump:\n");
62     for (count = ioaddr; count < ioaddr + 16; count++)
63     {
64         if (!(count % 16))
65             printk("\n%04X: ", count);
66         printk("%02X ", inb(count));
67     }
68     printk("\n");
69     
70     printk("buffer0 dump:\n");
71         /* set up the address register */
72         count = 0;
73         outb((count >> 8) | RDDATAflag | AUTOINCflag, _ADDR_HI);
74         outb(count & 0xff, _ADDR_LO);
75     
76     for (count = 0; count < 256+32; count++)
77     {
78         if (!(count % 16))
79             printk("\n%04X: ", count);
80         
81         /* copy the data */
82         printk("%02X ", inb(_MEMDATA));
83     }
84     printk("\n");
85 }
86
87 #else
88
89 static inline void regdump(struct net_device *dev) { }
90
91 #endif
92
93
94 /*====================================================================*/
95
96 /* Parameters that can be set with 'insmod' */
97
98 static int node;
99 static int timeout = 3;
100 static int backplane;
101 static int clockp;
102 static int clockm;
103
104 module_param(node, int, 0);
105 module_param(timeout, int, 0);
106 module_param(backplane, int, 0);
107 module_param(clockp, int, 0);
108 module_param(clockm, int, 0);
109
110 MODULE_LICENSE("GPL");
111
112 /*====================================================================*/
113
114 static int com20020_config(struct pcmcia_device *link);
115 static void com20020_release(struct pcmcia_device *link);
116
117 static void com20020_detach(struct pcmcia_device *p_dev);
118
119 /*====================================================================*/
120
121 typedef struct com20020_dev_t {
122     struct net_device       *dev;
123 } com20020_dev_t;
124
125 static int com20020_probe(struct pcmcia_device *p_dev)
126 {
127     com20020_dev_t *info;
128     struct net_device *dev;
129     struct arcnet_local *lp;
130
131     dev_dbg(&p_dev->dev, "com20020_attach()\n");
132
133     /* Create new network device */
134     info = kzalloc(sizeof(struct com20020_dev_t), GFP_KERNEL);
135     if (!info)
136         goto fail_alloc_info;
137
138     dev = alloc_arcdev("");
139     if (!dev)
140         goto fail_alloc_dev;
141
142     lp = netdev_priv(dev);
143     lp->timeout = timeout;
144     lp->backplane = backplane;
145     lp->clockp = clockp;
146     lp->clockm = clockm & 3;
147     lp->hw.owner = THIS_MODULE;
148
149     /* fill in our module parameters as defaults */
150     dev->dev_addr[0] = node;
151
152     p_dev->resource[0]->flags |= IO_DATA_PATH_WIDTH_8;
153     p_dev->resource[0]->end = 16;
154     p_dev->config_flags |= CONF_ENABLE_IRQ;
155
156     info->dev = dev;
157     p_dev->priv = info;
158
159     return com20020_config(p_dev);
160
161 fail_alloc_dev:
162     kfree(info);
163 fail_alloc_info:
164     return -ENOMEM;
165 } /* com20020_attach */
166
167 static void com20020_detach(struct pcmcia_device *link)
168 {
169     struct com20020_dev_t *info = link->priv;
170     struct net_device *dev = info->dev;
171
172     dev_dbg(&link->dev, "detach...\n");
173
174     dev_dbg(&link->dev, "com20020_detach\n");
175
176     dev_dbg(&link->dev, "unregister...\n");
177
178     unregister_netdev(dev);
179
180     /*
181      * this is necessary because we register our IRQ separately
182      * from card services.
183      */
184     if (dev->irq)
185             free_irq(dev->irq, dev);
186
187     com20020_release(link);
188
189     /* Unlink device structure, free bits */
190     dev_dbg(&link->dev, "unlinking...\n");
191     if (link->priv)
192     {
193         dev = info->dev;
194         if (dev)
195         {
196             dev_dbg(&link->dev, "kfree...\n");
197             free_netdev(dev);
198         }
199         dev_dbg(&link->dev, "kfree2...\n");
200         kfree(info);
201     }
202
203 } /* com20020_detach */
204
205 static int com20020_config(struct pcmcia_device *link)
206 {
207     struct arcnet_local *lp;
208     com20020_dev_t *info;
209     struct net_device *dev;
210     int i, ret;
211     int ioaddr;
212
213     info = link->priv;
214     dev = info->dev;
215
216     dev_dbg(&link->dev, "config...\n");
217
218     dev_dbg(&link->dev, "com20020_config\n");
219
220     dev_dbg(&link->dev, "baseport1 is %Xh\n",
221             (unsigned int) link->resource[0]->start);
222
223     i = -ENODEV;
224     link->io_lines = 16;
225
226     if (!link->resource[0]->start)
227     {
228         for (ioaddr = 0x100; ioaddr < 0x400; ioaddr += 0x10)
229         {
230             link->resource[0]->start = ioaddr;
231             i = pcmcia_request_io(link);
232             if (i == 0)
233                 break;
234         }
235     }
236     else
237         i = pcmcia_request_io(link);
238     
239     if (i != 0)
240     {
241         dev_dbg(&link->dev, "requestIO failed totally!\n");
242         goto failed;
243     }
244         
245     ioaddr = dev->base_addr = link->resource[0]->start;
246     dev_dbg(&link->dev, "got ioaddr %Xh\n", ioaddr);
247
248     dev_dbg(&link->dev, "request IRQ %d\n",
249             link->irq);
250     if (!link->irq)
251     {
252         dev_dbg(&link->dev, "requestIRQ failed totally!\n");
253         goto failed;
254     }
255
256     dev->irq = link->irq;
257
258     ret = pcmcia_enable_device(link);
259     if (ret)
260             goto failed;
261
262     if (com20020_check(dev))
263     {
264         regdump(dev);
265         goto failed;
266     }
267     
268     lp = netdev_priv(dev);
269     lp->card_name = "PCMCIA COM20020";
270     lp->card_flags = ARC_CAN_10MBIT; /* pretend all of them can 10Mbit */
271
272     SET_NETDEV_DEV(dev, &link->dev);
273
274     i = com20020_found(dev, 0); /* calls register_netdev */
275     
276     if (i != 0) {
277         dev_printk(KERN_NOTICE, &link->dev,
278                 "com20020_cs: com20020_found() failed\n");
279         goto failed;
280     }
281
282     dev_dbg(&link->dev,KERN_INFO "%s: port %#3lx, irq %d\n",
283            dev->name, dev->base_addr, dev->irq);
284     return 0;
285
286 failed:
287     dev_dbg(&link->dev, "com20020_config failed...\n");
288     com20020_release(link);
289     return -ENODEV;
290 } /* com20020_config */
291
292 static void com20020_release(struct pcmcia_device *link)
293 {
294         dev_dbg(&link->dev, "com20020_release\n");
295         pcmcia_disable_device(link);
296 }
297
298 static int com20020_suspend(struct pcmcia_device *link)
299 {
300         com20020_dev_t *info = link->priv;
301         struct net_device *dev = info->dev;
302
303         if (link->open)
304                 netif_device_detach(dev);
305
306         return 0;
307 }
308
309 static int com20020_resume(struct pcmcia_device *link)
310 {
311         com20020_dev_t *info = link->priv;
312         struct net_device *dev = info->dev;
313
314         if (link->open) {
315                 int ioaddr = dev->base_addr;
316                 struct arcnet_local *lp = netdev_priv(dev);
317                 ARCRESET;
318         }
319
320         return 0;
321 }
322
323 static struct pcmcia_device_id com20020_ids[] = {
324         PCMCIA_DEVICE_PROD_ID12("Contemporary Control Systems, Inc.",
325                         "PCM20 Arcnet Adapter", 0x59991666, 0x95dfffaf),
326         PCMCIA_DEVICE_PROD_ID12("SoHard AG",
327                         "SH ARC PCMCIA", 0xf8991729, 0x69dff0c7),
328         PCMCIA_DEVICE_NULL
329 };
330 MODULE_DEVICE_TABLE(pcmcia, com20020_ids);
331
332 static struct pcmcia_driver com20020_cs_driver = {
333         .owner          = THIS_MODULE,
334         .name           = "com20020_cs",
335         .probe          = com20020_probe,
336         .remove         = com20020_detach,
337         .id_table       = com20020_ids,
338         .suspend        = com20020_suspend,
339         .resume         = com20020_resume,
340 };
341
342 static int __init init_com20020_cs(void)
343 {
344         return pcmcia_register_driver(&com20020_cs_driver);
345 }
346
347 static void __exit exit_com20020_cs(void)
348 {
349         pcmcia_unregister_driver(&com20020_cs_driver);
350 }
351
352 module_init(init_com20020_cs);
353 module_exit(exit_com20020_cs);