[RT2x00]: add driver for Ralink wireless hardware
[linux-2.6] / drivers / net / lne390.c
1 /*
2         lne390.c
3
4         Linux driver for Mylex LNE390 EISA Network Adapter
5
6         Copyright (C) 1996-1998, Paul Gortmaker.
7
8         This software may be used and distributed according to the terms
9         of the GNU General Public License, incorporated herein by reference.
10
11         Information and Code Sources:
12
13         1) Based upon framework of es3210 driver.
14         2) The existing myriad of other Linux 8390 drivers by Donald Becker.
15         3) Russ Nelson's asm packet driver provided additional info.
16         4) Info for getting IRQ and sh-mem gleaned from the EISA cfg files.
17
18         The LNE390 is an EISA shared memory NS8390 implementation. Note
19         that all memory copies to/from the board must be 32bit transfers.
20         There are two versions of the card: the lne390a and the lne390b.
21         Going by the EISA cfg files, the "a" has jumpers to select between
22         BNC/AUI, but the "b" also has RJ-45 and selection is via the SCU.
23         The shared memory address selection is also slightly different.
24         Note that shared memory address > 1MB are supported with this driver.
25
26         You can try <http://www.mylex.com> if you want more info, as I've
27         never even seen one of these cards.  :)
28
29         Arnaldo Carvalho de Melo <acme@conectiva.com.br> - 2000/09/01
30         - get rid of check_region
31         - no need to check if dev == NULL in lne390_probe1
32 */
33
34 static const char *version =
35         "lne390.c: Driver revision v0.99.1, 01/09/2000\n";
36
37 #include <linux/module.h>
38 #include <linux/eisa.h>
39 #include <linux/kernel.h>
40 #include <linux/errno.h>
41 #include <linux/string.h>
42 #include <linux/delay.h>
43 #include <linux/init.h>
44 #include <linux/netdevice.h>
45 #include <linux/etherdevice.h>
46
47 #include <asm/io.h>
48 #include <asm/system.h>
49
50 #include "8390.h"
51
52 #define DRV_NAME "lne390"
53
54 static int lne390_probe1(struct net_device *dev, int ioaddr);
55
56 static int lne390_open(struct net_device *dev);
57 static int lne390_close(struct net_device *dev);
58
59 static void lne390_reset_8390(struct net_device *dev);
60
61 static void lne390_get_8390_hdr(struct net_device *dev, struct e8390_pkt_hdr *hdr, int ring_page);
62 static void lne390_block_input(struct net_device *dev, int count, struct sk_buff *skb, int ring_offset);
63 static void lne390_block_output(struct net_device *dev, int count, const unsigned char *buf, const int start_page);
64
65 #define LNE390_START_PG         0x00    /* First page of TX buffer      */
66 #define LNE390_STOP_PG          0x80    /* Last page +1 of RX ring      */
67
68 #define LNE390_ID_PORT          0xc80   /* Same for all EISA cards      */
69 #define LNE390_IO_EXTENT        0x20
70 #define LNE390_SA_PROM          0x16    /* Start of e'net addr.         */
71 #define LNE390_RESET_PORT       0xc84   /* From the pkt driver source   */
72 #define LNE390_NIC_OFFSET       0x00    /* Hello, the 8390 is *here*    */
73
74 #define LNE390_ADDR0            0x00    /* 3 byte vendor prefix         */
75 #define LNE390_ADDR1            0x80
76 #define LNE390_ADDR2            0xe5
77
78 #define LNE390_ID0      0x10009835      /* 0x3598 = 01101 01100 11000 = mlx */
79 #define LNE390_ID1      0x11009835      /* above is the 390A, this is 390B  */
80
81 #define LNE390_CFG1             0xc84   /* NB: 0xc84 is also "reset" port. */
82 #define LNE390_CFG2             0xc90
83
84 /*
85  *      You can OR any of the following bits together and assign it
86  *      to LNE390_DEBUG to get verbose driver info during operation.
87  *      Currently only the probe one is implemented.
88  */
89
90 #define LNE390_D_PROBE  0x01
91 #define LNE390_D_RX_PKT 0x02
92 #define LNE390_D_TX_PKT 0x04
93 #define LNE390_D_IRQ    0x08
94
95 #define LNE390_DEBUG    0
96
97 static unsigned char irq_map[] __initdata = {15, 12, 11, 10, 9, 7, 5, 3};
98 static unsigned int shmem_mapA[] __initdata = {0xff, 0xfe, 0xfd, 0xfff, 0xffe, 0xffc, 0x0d, 0x0};
99 static unsigned int shmem_mapB[] __initdata = {0xff, 0xfe, 0x0e, 0xfff, 0xffe, 0xffc, 0x0d, 0x0};
100
101 /*
102  *      Probe for the card. The best way is to read the EISA ID if it
103  *      is known. Then we can check the prefix of the station address
104  *      PROM for a match against the value assigned to Mylex.
105  */
106
107 static int __init do_lne390_probe(struct net_device *dev)
108 {
109         unsigned short ioaddr = dev->base_addr;
110         int irq = dev->irq;
111         int mem_start = dev->mem_start;
112         int ret;
113
114         if (ioaddr > 0x1ff) {           /* Check a single specified location. */
115                 if (!request_region(ioaddr, LNE390_IO_EXTENT, DRV_NAME))
116                         return -EBUSY;
117                 ret = lne390_probe1(dev, ioaddr);
118                 if (ret)
119                         release_region(ioaddr, LNE390_IO_EXTENT);
120                 return ret;
121         }
122         else if (ioaddr > 0)            /* Don't probe at all. */
123                 return -ENXIO;
124
125         if (!EISA_bus) {
126 #if LNE390_DEBUG & LNE390_D_PROBE
127                 printk("lne390-debug: Not an EISA bus. Not probing high ports.\n");
128 #endif
129                 return -ENXIO;
130         }
131
132         /* EISA spec allows for up to 16 slots, but 8 is typical. */
133         for (ioaddr = 0x1000; ioaddr < 0x9000; ioaddr += 0x1000) {
134                 if (!request_region(ioaddr, LNE390_IO_EXTENT, DRV_NAME))
135                         continue;
136                 if (lne390_probe1(dev, ioaddr) == 0)
137                         return 0;
138                 release_region(ioaddr, LNE390_IO_EXTENT);
139                 dev->irq = irq;
140                 dev->mem_start = mem_start;
141         }
142
143         return -ENODEV;
144 }
145
146 #ifndef MODULE
147 struct net_device * __init lne390_probe(int unit)
148 {
149         struct net_device *dev = alloc_ei_netdev();
150         int err;
151
152         if (!dev)
153                 return ERR_PTR(-ENOMEM);
154
155         sprintf(dev->name, "eth%d", unit);
156         netdev_boot_setup_check(dev);
157
158         err = do_lne390_probe(dev);
159         if (err)
160                 goto out;
161         return dev;
162 out:
163         free_netdev(dev);
164         return ERR_PTR(err);
165 }
166 #endif
167
168 static int __init lne390_probe1(struct net_device *dev, int ioaddr)
169 {
170         int i, revision, ret;
171         unsigned long eisa_id;
172
173         if (inb_p(ioaddr + LNE390_ID_PORT) == 0xff) return -ENODEV;
174
175 #if LNE390_DEBUG & LNE390_D_PROBE
176         printk("lne390-debug: probe at %#x, ID %#8x\n", ioaddr, inl(ioaddr + LNE390_ID_PORT));
177         printk("lne390-debug: config regs: %#x %#x\n",
178                 inb(ioaddr + LNE390_CFG1), inb(ioaddr + LNE390_CFG2));
179 #endif
180
181
182 /*      Check the EISA ID of the card. */
183         eisa_id = inl(ioaddr + LNE390_ID_PORT);
184         if ((eisa_id != LNE390_ID0) && (eisa_id != LNE390_ID1)) {
185                 return -ENODEV;
186         }
187
188         revision = (eisa_id >> 24) & 0x01;      /* 0 = rev A, 1 rev B */
189
190 #if 0
191 /*      Check the Mylex vendor ID as well. Not really required. */
192         if (inb(ioaddr + LNE390_SA_PROM + 0) != LNE390_ADDR0
193                 || inb(ioaddr + LNE390_SA_PROM + 1) != LNE390_ADDR1
194                 || inb(ioaddr + LNE390_SA_PROM + 2) != LNE390_ADDR2 ) {
195                 printk("lne390.c: card not found");
196                 for(i = 0; i < ETHER_ADDR_LEN; i++)
197                         printk(" %02x", inb(ioaddr + LNE390_SA_PROM + i));
198                 printk(" (invalid prefix).\n");
199                 return -ENODEV;
200         }
201 #endif
202
203         printk("lne390.c: LNE390%X in EISA slot %d, address", 0xa+revision, ioaddr/0x1000);
204         for(i = 0; i < ETHER_ADDR_LEN; i++)
205                 printk(" %02x", (dev->dev_addr[i] = inb(ioaddr + LNE390_SA_PROM + i)));
206         printk(".\nlne390.c: ");
207
208         /* Snarf the interrupt now. CFG file has them all listed as `edge' with share=NO */
209         if (dev->irq == 0) {
210                 unsigned char irq_reg = inb(ioaddr + LNE390_CFG2) >> 3;
211                 dev->irq = irq_map[irq_reg & 0x07];
212                 printk("using");
213         } else {
214                 /* This is useless unless we reprogram the card here too */
215                 if (dev->irq == 2) dev->irq = 9;        /* Doh! */
216                 printk("assigning");
217         }
218         printk(" IRQ %d,", dev->irq);
219
220         if ((ret = request_irq(dev->irq, ei_interrupt, 0, DRV_NAME, dev))) {
221                 printk (" unable to get IRQ %d.\n", dev->irq);
222                 return ret;
223         }
224
225         if (dev->mem_start == 0) {
226                 unsigned char mem_reg = inb(ioaddr + LNE390_CFG2) & 0x07;
227
228                 if (revision)   /* LNE390B */
229                         dev->mem_start = shmem_mapB[mem_reg] * 0x10000;
230                 else            /* LNE390A */
231                         dev->mem_start = shmem_mapA[mem_reg] * 0x10000;
232                 printk(" using ");
233         } else {
234                 /* Should check for value in shmem_map and reprogram the card to use it */
235                 dev->mem_start &= 0xfff0000;
236                 printk(" assigning ");
237         }
238
239         printk("%dkB memory at physical address %#lx\n",
240                         LNE390_STOP_PG/4, dev->mem_start);
241
242         /*
243            BEWARE!! Some dain-bramaged EISA SCUs will allow you to put
244            the card mem within the region covered by `normal' RAM  !!!
245
246            ioremap() will fail in that case.
247         */
248         ei_status.mem = ioremap(dev->mem_start, LNE390_STOP_PG*0x100);
249         if (!ei_status.mem) {
250                 printk(KERN_ERR "lne390.c: Unable to remap card memory above 1MB !!\n");
251                 printk(KERN_ERR "lne390.c: Try using EISA SCU to set memory below 1MB.\n");
252                 printk(KERN_ERR "lne390.c: Driver NOT installed.\n");
253                 ret = -EAGAIN;
254                 goto cleanup;
255         }
256         printk("lne390.c: remapped %dkB card memory to virtual address %p\n",
257                         LNE390_STOP_PG/4, ei_status.mem);
258
259         dev->mem_start = (unsigned long)ei_status.mem;
260         dev->mem_end = dev->mem_start + (LNE390_STOP_PG - LNE390_START_PG)*256;
261
262         /* The 8390 offset is zero for the LNE390 */
263         dev->base_addr = ioaddr;
264
265         ei_status.name = "LNE390";
266         ei_status.tx_start_page = LNE390_START_PG;
267         ei_status.rx_start_page = LNE390_START_PG + TX_PAGES;
268         ei_status.stop_page = LNE390_STOP_PG;
269         ei_status.word16 = 1;
270
271         if (ei_debug > 0)
272                 printk(version);
273
274         ei_status.reset_8390 = &lne390_reset_8390;
275         ei_status.block_input = &lne390_block_input;
276         ei_status.block_output = &lne390_block_output;
277         ei_status.get_8390_hdr = &lne390_get_8390_hdr;
278
279         dev->open = &lne390_open;
280         dev->stop = &lne390_close;
281 #ifdef CONFIG_NET_POLL_CONTROLLER
282         dev->poll_controller = ei_poll;
283 #endif
284         NS8390_init(dev, 0);
285
286         ret = register_netdev(dev);
287         if (ret)
288                 goto unmap;
289         return 0;
290 unmap:
291         if (ei_status.reg0)
292                 iounmap(ei_status.mem);
293 cleanup:
294         free_irq(dev->irq, dev);
295         return ret;
296 }
297
298 /*
299  *      Reset as per the packet driver method. Judging by the EISA cfg
300  *      file, this just toggles the "Board Enable" bits (bit 2 and 0).
301  */
302
303 static void lne390_reset_8390(struct net_device *dev)
304 {
305         unsigned short ioaddr = dev->base_addr;
306
307         outb(0x04, ioaddr + LNE390_RESET_PORT);
308         if (ei_debug > 1) printk("%s: resetting the LNE390...", dev->name);
309
310         mdelay(2);
311
312         ei_status.txing = 0;
313         outb(0x01, ioaddr + LNE390_RESET_PORT);
314         if (ei_debug > 1) printk("reset done\n");
315
316         return;
317 }
318
319 /*
320  *      Note: In the following three functions is the implicit assumption
321  *      that the associated memcpy will only use "rep; movsl" as long as
322  *      we keep the counts as some multiple of doublewords. This is a
323  *      requirement of the hardware, and also prevents us from using
324  *      eth_io_copy_and_sum() since we can't guarantee it will limit
325  *      itself to doubleword access.
326  */
327
328 /*
329  *      Grab the 8390 specific header. Similar to the block_input routine, but
330  *      we don't need to be concerned with ring wrap as the header will be at
331  *      the start of a page, so we optimize accordingly. (A single doubleword.)
332  */
333
334 static void
335 lne390_get_8390_hdr(struct net_device *dev, struct e8390_pkt_hdr *hdr, int ring_page)
336 {
337         void __iomem *hdr_start = ei_status.mem + ((ring_page - LNE390_START_PG)<<8);
338         memcpy_fromio(hdr, hdr_start, sizeof(struct e8390_pkt_hdr));
339         hdr->count = (hdr->count + 3) & ~3;     /* Round up allocation. */
340 }
341
342 /*
343  *      Block input and output are easy on shared memory ethercards, the only
344  *      complication is when the ring buffer wraps. The count will already
345  *      be rounded up to a doubleword value via lne390_get_8390_hdr() above.
346  */
347
348 static void lne390_block_input(struct net_device *dev, int count, struct sk_buff *skb,
349                                                   int ring_offset)
350 {
351         void __iomem *xfer_start = ei_status.mem + ring_offset - (LNE390_START_PG<<8);
352
353         if (ring_offset + count > (LNE390_STOP_PG<<8)) {
354                 /* Packet wraps over end of ring buffer. */
355                 int semi_count = (LNE390_STOP_PG<<8) - ring_offset;
356                 memcpy_fromio(skb->data, xfer_start, semi_count);
357                 count -= semi_count;
358                 memcpy_fromio(skb->data + semi_count,
359                         ei_status.mem + (TX_PAGES<<8), count);
360         } else {
361                 /* Packet is in one chunk. */
362                 memcpy_fromio(skb->data, xfer_start, count);
363         }
364 }
365
366 static void lne390_block_output(struct net_device *dev, int count,
367                                 const unsigned char *buf, int start_page)
368 {
369         void __iomem *shmem = ei_status.mem + ((start_page - LNE390_START_PG)<<8);
370
371         count = (count + 3) & ~3;     /* Round up to doubleword */
372         memcpy_toio(shmem, buf, count);
373 }
374
375 static int lne390_open(struct net_device *dev)
376 {
377         ei_open(dev);
378         return 0;
379 }
380
381 static int lne390_close(struct net_device *dev)
382 {
383
384         if (ei_debug > 1)
385                 printk("%s: Shutting down ethercard.\n", dev->name);
386
387         ei_close(dev);
388         return 0;
389 }
390
391 #ifdef MODULE
392 #define MAX_LNE_CARDS   4       /* Max number of LNE390 cards per module */
393 static struct net_device *dev_lne[MAX_LNE_CARDS];
394 static int io[MAX_LNE_CARDS];
395 static int irq[MAX_LNE_CARDS];
396 static int mem[MAX_LNE_CARDS];
397
398 module_param_array(io, int, NULL, 0);
399 module_param_array(irq, int, NULL, 0);
400 module_param_array(mem, int, NULL, 0);
401 MODULE_PARM_DESC(io, "I/O base address(es)");
402 MODULE_PARM_DESC(irq, "IRQ number(s)");
403 MODULE_PARM_DESC(mem, "memory base address(es)");
404 MODULE_DESCRIPTION("Mylex LNE390A/B EISA Ethernet driver");
405 MODULE_LICENSE("GPL");
406
407 int __init init_module(void)
408 {
409         struct net_device *dev;
410         int this_dev, found = 0;
411
412         for (this_dev = 0; this_dev < MAX_LNE_CARDS; this_dev++) {
413                 if (io[this_dev] == 0 && this_dev != 0)
414                         break;
415                 dev = alloc_ei_netdev();
416                 if (!dev)
417                         break;
418                 dev->irq = irq[this_dev];
419                 dev->base_addr = io[this_dev];
420                 dev->mem_start = mem[this_dev];
421                 if (do_lne390_probe(dev) == 0) {
422                         dev_lne[found++] = dev;
423                         continue;
424                 }
425                 free_netdev(dev);
426                 printk(KERN_WARNING "lne390.c: No LNE390 card found (i/o = 0x%x).\n", io[this_dev]);
427                 break;
428         }
429         if (found)
430                 return 0;
431         return -ENXIO;
432 }
433
434 static void cleanup_card(struct net_device *dev)
435 {
436         free_irq(dev->irq, dev);
437         release_region(dev->base_addr, LNE390_IO_EXTENT);
438         iounmap(ei_status.mem);
439 }
440
441 void __exit cleanup_module(void)
442 {
443         int this_dev;
444
445         for (this_dev = 0; this_dev < MAX_LNE_CARDS; this_dev++) {
446                 struct net_device *dev = dev_lne[this_dev];
447                 if (dev) {
448                         unregister_netdev(dev);
449                         cleanup_card(dev);
450                         free_netdev(dev);
451                 }
452         }
453 }
454 #endif /* MODULE */
455