Commit | Line | Data |
---|---|---|
1da177e4 LT |
1 | /* 3c501.c: A 3Com 3c501 Ethernet driver for Linux. */ |
2 | /* | |
3 | Written 1992,1993,1994 Donald Becker | |
4 | ||
5 | Copyright 1993 United States Government as represented by the | |
6 | Director, National Security Agency. This software may be used and | |
7 | distributed according to the terms of the GNU General Public License, | |
8 | incorporated herein by reference. | |
9 | ||
10 | This is a device driver for the 3Com Etherlink 3c501. | |
11 | Do not purchase this card, even as a joke. It's performance is horrible, | |
12 | and it breaks in many ways. | |
13 | ||
14 | The original author may be reached as becker@scyld.com, or C/O | |
15 | Scyld Computing Corporation | |
16 | 410 Severn Ave., Suite 210 | |
17 | Annapolis MD 21403 | |
18 | ||
19 | Fixed (again!) the missing interrupt locking on TX/RX shifting. | |
20 | Alan Cox <Alan.Cox@linux.org> | |
21 | ||
22 | Removed calls to init_etherdev since they are no longer needed, and | |
23 | cleaned up modularization just a bit. The driver still allows only | |
24 | the default address for cards when loaded as a module, but that's | |
25 | really less braindead than anyone using a 3c501 board. :) | |
26 | 19950208 (invid@msen.com) | |
27 | ||
28 | Added traps for interrupts hitting the window as we clear and TX load | |
29 | the board. Now getting 150K/second FTP with a 3c501 card. Still playing | |
30 | with a TX-TX optimisation to see if we can touch 180-200K/second as seems | |
31 | theoretically maximum. | |
32 | 19950402 Alan Cox <Alan.Cox@linux.org> | |
6aa20a22 JG |
33 | |
34 | Cleaned up for 2.3.x because we broke SMP now. | |
1da177e4 LT |
35 | 20000208 Alan Cox <alan@redhat.com> |
36 | ||
37 | Check up pass for 2.5. Nothing significant changed | |
38 | 20021009 Alan Cox <alan@redhat.com> | |
39 | ||
6aa20a22 | 40 | Fixed zero fill corner case |
1da177e4 | 41 | 20030104 Alan Cox <alan@redhat.com> |
6aa20a22 JG |
42 | |
43 | ||
1da177e4 LT |
44 | For the avoidance of doubt the "preferred form" of this code is one which |
45 | is in an open non patent encumbered format. Where cryptographic key signing | |
46 | forms part of the process of creating an executable the information | |
47 | including keys needed to generate an equivalently functional executable | |
48 | are deemed to be part of the source code. | |
49 | ||
50 | */ | |
51 | ||
52 | ||
53 | /** | |
54 | * DOC: 3c501 Card Notes | |
55 | * | |
56 | * Some notes on this thing if you have to hack it. [Alan] | |
57 | * | |
58 | * Some documentation is available from 3Com. Due to the boards age | |
59 | * standard responses when you ask for this will range from 'be serious' | |
60 | * to 'give it to a museum'. The documentation is incomplete and mostly | |
6aa20a22 | 61 | * of historical interest anyway. |
1da177e4 LT |
62 | * |
63 | * The basic system is a single buffer which can be used to receive or | |
64 | * transmit a packet. A third command mode exists when you are setting | |
65 | * things up. | |
66 | * | |
67 | * If it's transmitting it's not receiving and vice versa. In fact the | |
68 | * time to get the board back into useful state after an operation is | |
69 | * quite large. | |
70 | * | |
71 | * The driver works by keeping the board in receive mode waiting for a | |
72 | * packet to arrive. When one arrives it is copied out of the buffer | |
73 | * and delivered to the kernel. The card is reloaded and off we go. | |
74 | * | |
75 | * When transmitting lp->txing is set and the card is reset (from | |
76 | * receive mode) [possibly losing a packet just received] to command | |
77 | * mode. A packet is loaded and transmit mode triggered. The interrupt | |
78 | * handler runs different code for transmit interrupts and can handle | |
79 | * returning to receive mode or retransmissions (yes you have to help | |
80 | * out with those too). | |
81 | * | |
82 | * DOC: Problems | |
6aa20a22 | 83 | * |
1da177e4 LT |
84 | * There are a wide variety of undocumented error returns from the card |
85 | * and you basically have to kick the board and pray if they turn up. Most | |
86 | * only occur under extreme load or if you do something the board doesn't | |
87 | * like (eg touching a register at the wrong time). | |
88 | * | |
89 | * The driver is less efficient than it could be. It switches through | |
90 | * receive mode even if more transmits are queued. If this worries you buy | |
91 | * a real Ethernet card. | |
92 | * | |
93 | * The combination of slow receive restart and no real multicast | |
94 | * filter makes the board unusable with a kernel compiled for IP | |
95 | * multicasting in a real multicast environment. That's down to the board, | |
96 | * but even with no multicast programs running a multicast IP kernel is | |
97 | * in group 224.0.0.1 and you will therefore be listening to all multicasts. | |
98 | * One nv conference running over that Ethernet and you can give up. | |
99 | * | |
100 | */ | |
101 | ||
102 | #define DRV_NAME "3c501" | |
103 | #define DRV_VERSION "2002/10/09" | |
104 | ||
105 | ||
106 | static const char version[] = | |
107 | DRV_NAME ".c: " DRV_VERSION " Alan Cox (alan@redhat.com).\n"; | |
108 | ||
109 | /* | |
110 | * Braindamage remaining: | |
111 | * The 3c501 board. | |
112 | */ | |
113 | ||
114 | #include <linux/module.h> | |
115 | ||
116 | #include <linux/kernel.h> | |
117 | #include <linux/fcntl.h> | |
118 | #include <linux/ioport.h> | |
119 | #include <linux/interrupt.h> | |
120 | #include <linux/slab.h> | |
121 | #include <linux/string.h> | |
122 | #include <linux/errno.h> | |
1da177e4 LT |
123 | #include <linux/spinlock.h> |
124 | #include <linux/ethtool.h> | |
125 | #include <linux/delay.h> | |
126 | #include <linux/bitops.h> | |
127 | ||
128 | #include <asm/uaccess.h> | |
129 | #include <asm/io.h> | |
130 | ||
131 | #include <linux/netdevice.h> | |
132 | #include <linux/etherdevice.h> | |
133 | #include <linux/skbuff.h> | |
134 | #include <linux/init.h> | |
135 | ||
136 | #include "3c501.h" | |
137 | ||
138 | /* | |
139 | * The boilerplate probe code. | |
140 | */ | |
141 | ||
142 | static int io=0x280; | |
143 | static int irq=5; | |
144 | static int mem_start; | |
145 | ||
146 | /** | |
147 | * el1_probe: - probe for a 3c501 | |
6aa20a22 | 148 | * @dev: The device structure passed in to probe. |
1da177e4 LT |
149 | * |
150 | * This can be called from two places. The network layer will probe using | |
151 | * a device structure passed in with the probe information completed. For a | |
152 | * modular driver we use #init_module to fill in our own structure and probe | |
153 | * for it. | |
154 | * | |
155 | * Returns 0 on success. ENXIO if asked not to probe and ENODEV if asked to | |
156 | * probe and failing to find anything. | |
157 | */ | |
6aa20a22 | 158 | |
1da177e4 LT |
159 | struct net_device * __init el1_probe(int unit) |
160 | { | |
161 | struct net_device *dev = alloc_etherdev(sizeof(struct net_local)); | |
162 | static unsigned ports[] = { 0x280, 0x300, 0}; | |
163 | unsigned *port; | |
164 | int err = 0; | |
165 | ||
166 | if (!dev) | |
167 | return ERR_PTR(-ENOMEM); | |
168 | ||
169 | if (unit >= 0) { | |
170 | sprintf(dev->name, "eth%d", unit); | |
171 | netdev_boot_setup_check(dev); | |
172 | io = dev->base_addr; | |
173 | irq = dev->irq; | |
174 | mem_start = dev->mem_start & 7; | |
175 | } | |
176 | ||
177 | SET_MODULE_OWNER(dev); | |
178 | ||
179 | if (io > 0x1ff) { /* Check a single specified location. */ | |
180 | err = el1_probe1(dev, io); | |
181 | } else if (io != 0) { | |
182 | err = -ENXIO; /* Don't probe at all. */ | |
183 | } else { | |
184 | for (port = ports; *port && el1_probe1(dev, *port); port++) | |
185 | ; | |
186 | if (!*port) | |
187 | err = -ENODEV; | |
188 | } | |
189 | if (err) | |
190 | goto out; | |
191 | err = register_netdev(dev); | |
192 | if (err) | |
193 | goto out1; | |
194 | return dev; | |
195 | out1: | |
196 | release_region(dev->base_addr, EL1_IO_EXTENT); | |
197 | out: | |
198 | free_netdev(dev); | |
199 | return ERR_PTR(err); | |
200 | } | |
201 | ||
202 | /** | |
6aa20a22 | 203 | * el1_probe1: |
1da177e4 LT |
204 | * @dev: The device structure to use |
205 | * @ioaddr: An I/O address to probe at. | |
206 | * | |
207 | * The actual probe. This is iterated over by #el1_probe in order to | |
208 | * check all the applicable device locations. | |
209 | * | |
210 | * Returns 0 for a success, in which case the device is activated, | |
211 | * EAGAIN if the IRQ is in use by another driver, and ENODEV if the | |
212 | * board cannot be found. | |
213 | */ | |
214 | ||
215 | static int __init el1_probe1(struct net_device *dev, int ioaddr) | |
216 | { | |
217 | struct net_local *lp; | |
218 | const char *mname; /* Vendor name */ | |
219 | unsigned char station_addr[6]; | |
220 | int autoirq = 0; | |
221 | int i; | |
222 | ||
223 | /* | |
224 | * Reserve I/O resource for exclusive use by this driver | |
225 | */ | |
226 | ||
227 | if (!request_region(ioaddr, EL1_IO_EXTENT, DRV_NAME)) | |
228 | return -ENODEV; | |
229 | ||
230 | /* | |
231 | * Read the station address PROM data from the special port. | |
232 | */ | |
233 | ||
234 | for (i = 0; i < 6; i++) | |
235 | { | |
236 | outw(i, ioaddr + EL1_DATAPTR); | |
237 | station_addr[i] = inb(ioaddr + EL1_SAPROM); | |
238 | } | |
239 | /* | |
240 | * Check the first three octets of the S.A. for 3Com's prefix, or | |
241 | * for the Sager NP943 prefix. | |
242 | */ | |
243 | ||
244 | if (station_addr[0] == 0x02 && station_addr[1] == 0x60 | |
245 | && station_addr[2] == 0x8c) | |
246 | { | |
247 | mname = "3c501"; | |
248 | } else if (station_addr[0] == 0x00 && station_addr[1] == 0x80 | |
249 | && station_addr[2] == 0xC8) | |
250 | { | |
251 | mname = "NP943"; | |
252 | } | |
253 | else { | |
254 | release_region(ioaddr, EL1_IO_EXTENT); | |
255 | return -ENODEV; | |
256 | } | |
257 | ||
258 | /* | |
259 | * We auto-IRQ by shutting off the interrupt line and letting it float | |
260 | * high. | |
261 | */ | |
262 | ||
263 | dev->irq = irq; | |
264 | ||
265 | if (dev->irq < 2) | |
266 | { | |
267 | unsigned long irq_mask; | |
268 | ||
269 | irq_mask = probe_irq_on(); | |
270 | inb(RX_STATUS); /* Clear pending interrupts. */ | |
271 | inb(TX_STATUS); | |
272 | outb(AX_LOOP + 1, AX_CMD); | |
273 | ||
274 | outb(0x00, AX_CMD); | |
275 | ||
276 | mdelay(20); | |
277 | autoirq = probe_irq_off(irq_mask); | |
278 | ||
279 | if (autoirq == 0) | |
280 | { | |
281 | printk(KERN_WARNING "%s probe at %#x failed to detect IRQ line.\n", | |
282 | mname, ioaddr); | |
283 | release_region(ioaddr, EL1_IO_EXTENT); | |
284 | return -EAGAIN; | |
285 | } | |
286 | } | |
287 | ||
288 | outb(AX_RESET+AX_LOOP, AX_CMD); /* Loopback mode. */ | |
289 | dev->base_addr = ioaddr; | |
290 | memcpy(dev->dev_addr, station_addr, ETH_ALEN); | |
291 | ||
292 | if (mem_start & 0xf) | |
293 | el_debug = mem_start & 0x7; | |
294 | if (autoirq) | |
295 | dev->irq = autoirq; | |
296 | ||
297 | printk(KERN_INFO "%s: %s EtherLink at %#lx, using %sIRQ %d.\n", dev->name, mname, dev->base_addr, | |
298 | autoirq ? "auto":"assigned ", dev->irq); | |
299 | ||
300 | #ifdef CONFIG_IP_MULTICAST | |
301 | printk(KERN_WARNING "WARNING: Use of the 3c501 in a multicast kernel is NOT recommended.\n"); | |
302 | #endif | |
303 | ||
304 | if (el_debug) | |
305 | printk(KERN_DEBUG "%s", version); | |
306 | ||
307 | memset(dev->priv, 0, sizeof(struct net_local)); | |
308 | lp = netdev_priv(dev); | |
309 | spin_lock_init(&lp->lock); | |
6aa20a22 | 310 | |
1da177e4 LT |
311 | /* |
312 | * The EL1-specific entries in the device structure. | |
313 | */ | |
314 | ||
315 | dev->open = &el_open; | |
316 | dev->hard_start_xmit = &el_start_xmit; | |
317 | dev->tx_timeout = &el_timeout; | |
318 | dev->watchdog_timeo = HZ; | |
319 | dev->stop = &el1_close; | |
320 | dev->get_stats = &el1_get_stats; | |
321 | dev->set_multicast_list = &set_multicast_list; | |
322 | dev->ethtool_ops = &netdev_ethtool_ops; | |
323 | return 0; | |
324 | } | |
325 | ||
326 | /** | |
327 | * el1_open: | |
328 | * @dev: device that is being opened | |
329 | * | |
330 | * When an ifconfig is issued which changes the device flags to include | |
6aa20a22 | 331 | * IFF_UP this function is called. It is only called when the change |
1da177e4 LT |
332 | * occurs, not when the interface remains up. #el1_close will be called |
333 | * when it goes down. | |
334 | * | |
335 | * Returns 0 for a successful open, or -EAGAIN if someone has run off | |
336 | * with our interrupt line. | |
337 | */ | |
338 | ||
339 | static int el_open(struct net_device *dev) | |
340 | { | |
341 | int retval; | |
342 | int ioaddr = dev->base_addr; | |
343 | struct net_local *lp = netdev_priv(dev); | |
344 | unsigned long flags; | |
345 | ||
346 | if (el_debug > 2) | |
347 | printk(KERN_DEBUG "%s: Doing el_open()...", dev->name); | |
348 | ||
349 | if ((retval = request_irq(dev->irq, &el_interrupt, 0, dev->name, dev))) | |
350 | return retval; | |
351 | ||
352 | spin_lock_irqsave(&lp->lock, flags); | |
353 | el_reset(dev); | |
354 | spin_unlock_irqrestore(&lp->lock, flags); | |
355 | ||
356 | lp->txing = 0; /* Board in RX mode */ | |
357 | outb(AX_RX, AX_CMD); /* Aux control, irq and receive enabled */ | |
358 | netif_start_queue(dev); | |
359 | return 0; | |
360 | } | |
361 | ||
362 | /** | |
363 | * el_timeout: | |
364 | * @dev: The 3c501 card that has timed out | |
365 | * | |
366 | * Attempt to restart the board. This is basically a mixture of extreme | |
367 | * violence and prayer | |
368 | * | |
369 | */ | |
6aa20a22 | 370 | |
1da177e4 LT |
371 | static void el_timeout(struct net_device *dev) |
372 | { | |
373 | struct net_local *lp = netdev_priv(dev); | |
374 | int ioaddr = dev->base_addr; | |
6aa20a22 | 375 | |
1da177e4 LT |
376 | if (el_debug) |
377 | printk (KERN_DEBUG "%s: transmit timed out, txsr %#2x axsr=%02x rxsr=%02x.\n", | |
378 | dev->name, inb(TX_STATUS), inb(AX_STATUS), inb(RX_STATUS)); | |
379 | lp->stats.tx_errors++; | |
380 | outb(TX_NORM, TX_CMD); | |
381 | outb(RX_NORM, RX_CMD); | |
382 | outb(AX_OFF, AX_CMD); /* Just trigger a false interrupt. */ | |
383 | outb(AX_RX, AX_CMD); /* Aux control, irq and receive enabled */ | |
384 | lp->txing = 0; /* Ripped back in to RX */ | |
385 | netif_wake_queue(dev); | |
386 | } | |
387 | ||
6aa20a22 | 388 | |
1da177e4 LT |
389 | /** |
390 | * el_start_xmit: | |
391 | * @skb: The packet that is queued to be sent | |
392 | * @dev: The 3c501 card we want to throw it down | |
393 | * | |
394 | * Attempt to send a packet to a 3c501 card. There are some interesting | |
395 | * catches here because the 3c501 is an extremely old and therefore | |
396 | * stupid piece of technology. | |
397 | * | |
398 | * If we are handling an interrupt on the other CPU we cannot load a packet | |
399 | * as we may still be attempting to retrieve the last RX packet buffer. | |
400 | * | |
401 | * When a transmit times out we dump the card into control mode and just | |
402 | * start again. It happens enough that it isnt worth logging. | |
403 | * | |
404 | * We avoid holding the spin locks when doing the packet load to the board. | |
405 | * The device is very slow, and its DMA mode is even slower. If we held the | |
406 | * lock while loading 1500 bytes onto the controller we would drop a lot of | |
407 | * serial port characters. This requires we do extra locking, but we have | |
408 | * no real choice. | |
409 | */ | |
410 | ||
411 | static int el_start_xmit(struct sk_buff *skb, struct net_device *dev) | |
412 | { | |
413 | struct net_local *lp = netdev_priv(dev); | |
414 | int ioaddr = dev->base_addr; | |
415 | unsigned long flags; | |
416 | ||
417 | /* | |
418 | * Avoid incoming interrupts between us flipping txing and flipping | |
419 | * mode as the driver assumes txing is a faithful indicator of card | |
420 | * state | |
421 | */ | |
422 | ||
423 | spin_lock_irqsave(&lp->lock, flags); | |
6aa20a22 | 424 | |
1da177e4 LT |
425 | /* |
426 | * Avoid timer-based retransmission conflicts. | |
427 | */ | |
428 | ||
429 | netif_stop_queue(dev); | |
430 | ||
431 | do | |
432 | { | |
433 | int len = skb->len; | |
434 | int pad = 0; | |
435 | int gp_start; | |
436 | unsigned char *buf = skb->data; | |
6aa20a22 | 437 | |
1da177e4 LT |
438 | if (len < ETH_ZLEN) |
439 | pad = ETH_ZLEN - len; | |
6aa20a22 | 440 | |
1da177e4 LT |
441 | gp_start = 0x800 - ( len + pad ); |
442 | ||
443 | lp->tx_pkt_start = gp_start; | |
444 | lp->collisions = 0; | |
445 | ||
446 | lp->stats.tx_bytes += skb->len; | |
447 | ||
448 | /* | |
449 | * Command mode with status cleared should [in theory] | |
450 | * mean no more interrupts can be pending on the card. | |
451 | */ | |
452 | ||
453 | outb_p(AX_SYS, AX_CMD); | |
454 | inb_p(RX_STATUS); | |
455 | inb_p(TX_STATUS); | |
456 | ||
457 | lp->loading = 1; | |
458 | lp->txing = 1; | |
459 | ||
460 | /* | |
461 | * Turn interrupts back on while we spend a pleasant afternoon | |
462 | * loading bytes into the board | |
463 | */ | |
464 | ||
465 | spin_unlock_irqrestore(&lp->lock, flags); | |
6aa20a22 | 466 | |
1da177e4 LT |
467 | outw(0x00, RX_BUF_CLR); /* Set rx packet area to 0. */ |
468 | outw(gp_start, GP_LOW); /* aim - packet will be loaded into buffer start */ | |
469 | outsb(DATAPORT,buf,len); /* load buffer (usual thing each byte increments the pointer) */ | |
470 | if (pad) { | |
471 | while(pad--) /* Zero fill buffer tail */ | |
472 | outb(0, DATAPORT); | |
473 | } | |
474 | outw(gp_start, GP_LOW); /* the board reuses the same register */ | |
6aa20a22 | 475 | |
1da177e4 LT |
476 | if(lp->loading != 2) |
477 | { | |
478 | outb(AX_XMIT, AX_CMD); /* fire ... Trigger xmit. */ | |
479 | lp->loading=0; | |
480 | dev->trans_start = jiffies; | |
481 | if (el_debug > 2) | |
482 | printk(KERN_DEBUG " queued xmit.\n"); | |
483 | dev_kfree_skb (skb); | |
484 | return 0; | |
485 | } | |
486 | /* A receive upset our load, despite our best efforts */ | |
487 | if(el_debug>2) | |
488 | printk(KERN_DEBUG "%s: burped during tx load.\n", dev->name); | |
489 | spin_lock_irqsave(&lp->lock, flags); | |
490 | } | |
491 | while(1); | |
492 | ||
493 | } | |
494 | ||
495 | /** | |
496 | * el_interrupt: | |
497 | * @irq: Interrupt number | |
498 | * @dev_id: The 3c501 that burped | |
1da177e4 | 499 | * |
6aa20a22 | 500 | * Handle the ether interface interrupts. The 3c501 needs a lot more |
1da177e4 LT |
501 | * hand holding than most cards. In particular we get a transmit interrupt |
502 | * with a collision error because the board firmware isnt capable of rewinding | |
503 | * its own transmit buffer pointers. It can however count to 16 for us. | |
504 | * | |
505 | * On the receive side the card is also very dumb. It has no buffering to | |
506 | * speak of. We simply pull the packet out of its PIO buffer (which is slow) | |
507 | * and queue it for the kernel. Then we reset the card for the next packet. | |
508 | * | |
d6e05edc | 509 | * We sometimes get surprise interrupts late both because the SMP IRQ delivery |
1da177e4 LT |
510 | * is message passing and because the card sometimes seems to deliver late. I |
511 | * think if it is part way through a receive and the mode is changed it carries | |
512 | * on receiving and sends us an interrupt. We have to band aid all these cases | |
d6e05edc | 513 | * to get a sensible 150kBytes/second performance. Even then you want a small |
1da177e4 LT |
514 | * TCP window. |
515 | */ | |
516 | ||
7d12e780 | 517 | static irqreturn_t el_interrupt(int irq, void *dev_id) |
1da177e4 LT |
518 | { |
519 | struct net_device *dev = dev_id; | |
520 | struct net_local *lp; | |
521 | int ioaddr; | |
522 | int axsr; /* Aux. status reg. */ | |
523 | ||
524 | ioaddr = dev->base_addr; | |
525 | lp = netdev_priv(dev); | |
526 | ||
527 | spin_lock(&lp->lock); | |
6aa20a22 | 528 | |
1da177e4 LT |
529 | /* |
530 | * What happened ? | |
531 | */ | |
532 | ||
533 | axsr = inb(AX_STATUS); | |
534 | ||
535 | /* | |
536 | * Log it | |
537 | */ | |
538 | ||
539 | if (el_debug > 3) | |
540 | printk(KERN_DEBUG "%s: el_interrupt() aux=%#02x", dev->name, axsr); | |
541 | ||
542 | if(lp->loading==1 && !lp->txing) | |
543 | printk(KERN_WARNING "%s: Inconsistent state loading while not in tx\n", | |
544 | dev->name); | |
545 | ||
546 | if (lp->txing) | |
547 | { | |
548 | ||
549 | /* | |
550 | * Board in transmit mode. May be loading. If we are | |
551 | * loading we shouldn't have got this. | |
552 | */ | |
553 | ||
554 | int txsr = inb(TX_STATUS); | |
555 | ||
556 | if(lp->loading==1) | |
557 | { | |
558 | if(el_debug > 2) | |
559 | { | |
560 | printk(KERN_DEBUG "%s: Interrupt while loading [", dev->name); | |
561 | printk(KERN_DEBUG " txsr=%02x gp=%04x rp=%04x]\n", txsr, inw(GP_LOW),inw(RX_LOW)); | |
562 | } | |
563 | lp->loading=2; /* Force a reload */ | |
564 | spin_unlock(&lp->lock); | |
565 | goto out; | |
566 | } | |
567 | ||
568 | if (el_debug > 6) | |
569 | printk(KERN_DEBUG " txsr=%02x gp=%04x rp=%04x", txsr, inw(GP_LOW),inw(RX_LOW)); | |
570 | ||
571 | if ((axsr & 0x80) && (txsr & TX_READY) == 0) | |
572 | { | |
573 | /* | |
574 | * FIXME: is there a logic to whether to keep on trying or | |
575 | * reset immediately ? | |
576 | */ | |
577 | if(el_debug>1) | |
578 | printk(KERN_DEBUG "%s: Unusual interrupt during Tx, txsr=%02x axsr=%02x" | |
579 | " gp=%03x rp=%03x.\n", dev->name, txsr, axsr, | |
580 | inw(ioaddr + EL1_DATAPTR), inw(ioaddr + EL1_RXPTR)); | |
581 | lp->txing = 0; | |
582 | netif_wake_queue(dev); | |
583 | } | |
584 | else if (txsr & TX_16COLLISIONS) | |
585 | { | |
586 | /* | |
587 | * Timed out | |
588 | */ | |
589 | if (el_debug) | |
590 | printk (KERN_DEBUG "%s: Transmit failed 16 times, Ethernet jammed?\n",dev->name); | |
591 | outb(AX_SYS, AX_CMD); | |
592 | lp->txing = 0; | |
593 | lp->stats.tx_aborted_errors++; | |
594 | netif_wake_queue(dev); | |
595 | } | |
596 | else if (txsr & TX_COLLISION) | |
597 | { | |
598 | /* | |
599 | * Retrigger xmit. | |
600 | */ | |
601 | ||
602 | if (el_debug > 6) | |
603 | printk(KERN_DEBUG " retransmitting after a collision.\n"); | |
604 | /* | |
605 | * Poor little chip can't reset its own start pointer | |
606 | */ | |
607 | ||
608 | outb(AX_SYS, AX_CMD); | |
609 | outw(lp->tx_pkt_start, GP_LOW); | |
610 | outb(AX_XMIT, AX_CMD); | |
611 | lp->stats.collisions++; | |
612 | spin_unlock(&lp->lock); | |
613 | goto out; | |
614 | } | |
615 | else | |
616 | { | |
617 | /* | |
618 | * It worked.. we will now fall through and receive | |
619 | */ | |
620 | lp->stats.tx_packets++; | |
621 | if (el_debug > 6) | |
622 | printk(KERN_DEBUG " Tx succeeded %s\n", | |
623 | (txsr & TX_RDY) ? "." : "but tx is busy!"); | |
624 | /* | |
625 | * This is safe the interrupt is atomic WRT itself. | |
626 | */ | |
627 | ||
628 | lp->txing = 0; | |
629 | netif_wake_queue(dev); /* In case more to transmit */ | |
630 | } | |
631 | } | |
632 | else | |
633 | { | |
634 | /* | |
635 | * In receive mode. | |
636 | */ | |
637 | ||
638 | int rxsr = inb(RX_STATUS); | |
639 | if (el_debug > 5) | |
640 | printk(KERN_DEBUG " rxsr=%02x txsr=%02x rp=%04x", rxsr, inb(TX_STATUS),inw(RX_LOW)); | |
641 | /* | |
642 | * Just reading rx_status fixes most errors. | |
643 | */ | |
644 | if (rxsr & RX_MISSED) | |
645 | lp->stats.rx_missed_errors++; | |
646 | else if (rxsr & RX_RUNT) | |
647 | { /* Handled to avoid board lock-up. */ | |
648 | lp->stats.rx_length_errors++; | |
649 | if (el_debug > 5) | |
650 | printk(KERN_DEBUG " runt.\n"); | |
651 | } | |
652 | else if (rxsr & RX_GOOD) | |
653 | { | |
654 | /* | |
655 | * Receive worked. | |
656 | */ | |
657 | el_receive(dev); | |
658 | } | |
659 | else | |
660 | { | |
661 | /* | |
662 | * Nothing? Something is broken! | |
663 | */ | |
664 | if (el_debug > 2) | |
665 | printk(KERN_DEBUG "%s: No packet seen, rxsr=%02x **resetting 3c501***\n", | |
666 | dev->name, rxsr); | |
667 | el_reset(dev); | |
668 | } | |
669 | if (el_debug > 3) | |
670 | printk(KERN_DEBUG ".\n"); | |
671 | } | |
672 | ||
673 | /* | |
674 | * Move into receive mode | |
675 | */ | |
676 | ||
677 | outb(AX_RX, AX_CMD); | |
678 | outw(0x00, RX_BUF_CLR); | |
679 | inb(RX_STATUS); /* Be certain that interrupts are cleared. */ | |
680 | inb(TX_STATUS); | |
681 | spin_unlock(&lp->lock); | |
682 | out: | |
683 | return IRQ_HANDLED; | |
684 | } | |
685 | ||
686 | ||
687 | /** | |
688 | * el_receive: | |
689 | * @dev: Device to pull the packets from | |
690 | * | |
691 | * We have a good packet. Well, not really "good", just mostly not broken. | |
692 | * We must check everything to see if it is good. In particular we occasionally | |
693 | * get wild packet sizes from the card. If the packet seems sane we PIO it | |
694 | * off the card and queue it for the protocol layers. | |
695 | */ | |
696 | ||
697 | static void el_receive(struct net_device *dev) | |
698 | { | |
699 | struct net_local *lp = netdev_priv(dev); | |
700 | int ioaddr = dev->base_addr; | |
701 | int pkt_len; | |
702 | struct sk_buff *skb; | |
703 | ||
704 | pkt_len = inw(RX_LOW); | |
705 | ||
706 | if (el_debug > 4) | |
707 | printk(KERN_DEBUG " el_receive %d.\n", pkt_len); | |
708 | ||
709 | if ((pkt_len < 60) || (pkt_len > 1536)) | |
710 | { | |
711 | if (el_debug) | |
712 | printk(KERN_DEBUG "%s: bogus packet, length=%d\n", dev->name, pkt_len); | |
713 | lp->stats.rx_over_errors++; | |
714 | return; | |
715 | } | |
716 | ||
717 | /* | |
718 | * Command mode so we can empty the buffer | |
719 | */ | |
720 | ||
721 | outb(AX_SYS, AX_CMD); | |
722 | skb = dev_alloc_skb(pkt_len+2); | |
723 | ||
724 | /* | |
725 | * Start of frame | |
726 | */ | |
727 | ||
728 | outw(0x00, GP_LOW); | |
729 | if (skb == NULL) | |
730 | { | |
731 | printk(KERN_INFO "%s: Memory squeeze, dropping packet.\n", dev->name); | |
732 | lp->stats.rx_dropped++; | |
733 | return; | |
734 | } | |
735 | else | |
736 | { | |
737 | skb_reserve(skb,2); /* Force 16 byte alignment */ | |
738 | skb->dev = dev; | |
739 | /* | |
740 | * The read increments through the bytes. The interrupt | |
741 | * handler will fix the pointer when it returns to | |
742 | * receive mode. | |
743 | */ | |
744 | insb(DATAPORT, skb_put(skb,pkt_len), pkt_len); | |
745 | skb->protocol=eth_type_trans(skb,dev); | |
746 | netif_rx(skb); | |
747 | dev->last_rx = jiffies; | |
748 | lp->stats.rx_packets++; | |
749 | lp->stats.rx_bytes+=pkt_len; | |
750 | } | |
751 | return; | |
752 | } | |
753 | ||
754 | /** | |
755 | * el_reset: Reset a 3c501 card | |
756 | * @dev: The 3c501 card about to get zapped | |
757 | * | |
758 | * Even resetting a 3c501 isnt simple. When you activate reset it loses all | |
759 | * its configuration. You must hold the lock when doing this. The function | |
760 | * cannot take the lock itself as it is callable from the irq handler. | |
761 | */ | |
762 | ||
763 | static void el_reset(struct net_device *dev) | |
764 | { | |
765 | struct net_local *lp = netdev_priv(dev); | |
766 | int ioaddr = dev->base_addr; | |
767 | ||
768 | if (el_debug> 2) | |
769 | printk(KERN_INFO "3c501 reset..."); | |
770 | outb(AX_RESET, AX_CMD); /* Reset the chip */ | |
771 | outb(AX_LOOP, AX_CMD); /* Aux control, irq and loopback enabled */ | |
772 | { | |
773 | int i; | |
774 | for (i = 0; i < 6; i++) /* Set the station address. */ | |
775 | outb(dev->dev_addr[i], ioaddr + i); | |
776 | } | |
777 | ||
778 | outw(0, RX_BUF_CLR); /* Set rx packet area to 0. */ | |
779 | outb(TX_NORM, TX_CMD); /* tx irq on done, collision */ | |
780 | outb(RX_NORM, RX_CMD); /* Set Rx commands. */ | |
781 | inb(RX_STATUS); /* Clear status. */ | |
782 | inb(TX_STATUS); | |
783 | lp->txing = 0; | |
784 | } | |
785 | ||
786 | /** | |
787 | * el1_close: | |
788 | * @dev: 3c501 card to shut down | |
789 | * | |
790 | * Close a 3c501 card. The IFF_UP flag has been cleared by the user via | |
791 | * the SIOCSIFFLAGS ioctl. We stop any further transmissions being queued, | |
792 | * and then disable the interrupts. Finally we reset the chip. The effects | |
793 | * of the rest will be cleaned up by #el1_open. Always returns 0 indicating | |
794 | * a success. | |
795 | */ | |
6aa20a22 | 796 | |
1da177e4 LT |
797 | static int el1_close(struct net_device *dev) |
798 | { | |
799 | int ioaddr = dev->base_addr; | |
800 | ||
801 | if (el_debug > 2) | |
802 | printk(KERN_INFO "%s: Shutting down Ethernet card at %#x.\n", dev->name, ioaddr); | |
803 | ||
804 | netif_stop_queue(dev); | |
6aa20a22 | 805 | |
1da177e4 LT |
806 | /* |
807 | * Free and disable the IRQ. | |
808 | */ | |
809 | ||
810 | free_irq(dev->irq, dev); | |
811 | outb(AX_RESET, AX_CMD); /* Reset the chip */ | |
812 | ||
813 | return 0; | |
814 | } | |
815 | ||
816 | /** | |
817 | * el1_get_stats: | |
818 | * @dev: The card to get the statistics for | |
819 | * | |
820 | * In smarter devices this function is needed to pull statistics off the | |
821 | * board itself. The 3c501 has no hardware statistics. We maintain them all | |
822 | * so they are by definition always up to date. | |
823 | * | |
824 | * Returns the statistics for the card from the card private data | |
825 | */ | |
6aa20a22 | 826 | |
1da177e4 LT |
827 | static struct net_device_stats *el1_get_stats(struct net_device *dev) |
828 | { | |
829 | struct net_local *lp = netdev_priv(dev); | |
830 | return &lp->stats; | |
831 | } | |
832 | ||
833 | /** | |
834 | * set_multicast_list: | |
835 | * @dev: The device to adjust | |
836 | * | |
6aa20a22 | 837 | * Set or clear the multicast filter for this adaptor to use the best-effort |
1da177e4 LT |
838 | * filtering supported. The 3c501 supports only three modes of filtering. |
839 | * It always receives broadcasts and packets for itself. You can choose to | |
840 | * optionally receive all packets, or all multicast packets on top of this. | |
841 | */ | |
842 | ||
843 | static void set_multicast_list(struct net_device *dev) | |
844 | { | |
845 | int ioaddr = dev->base_addr; | |
846 | ||
847 | if(dev->flags&IFF_PROMISC) | |
848 | { | |
849 | outb(RX_PROM, RX_CMD); | |
850 | inb(RX_STATUS); | |
851 | } | |
852 | else if (dev->mc_list || dev->flags&IFF_ALLMULTI) | |
853 | { | |
854 | outb(RX_MULT, RX_CMD); /* Multicast or all multicast is the same */ | |
855 | inb(RX_STATUS); /* Clear status. */ | |
856 | } | |
857 | else | |
858 | { | |
859 | outb(RX_NORM, RX_CMD); | |
860 | inb(RX_STATUS); | |
861 | } | |
862 | } | |
863 | ||
864 | ||
865 | static void netdev_get_drvinfo(struct net_device *dev, | |
866 | struct ethtool_drvinfo *info) | |
867 | { | |
868 | strcpy(info->driver, DRV_NAME); | |
869 | strcpy(info->version, DRV_VERSION); | |
870 | sprintf(info->bus_info, "ISA 0x%lx", dev->base_addr); | |
871 | } | |
872 | ||
873 | static u32 netdev_get_msglevel(struct net_device *dev) | |
874 | { | |
875 | return debug; | |
876 | } | |
877 | ||
878 | static void netdev_set_msglevel(struct net_device *dev, u32 level) | |
879 | { | |
880 | debug = level; | |
881 | } | |
882 | ||
7282d491 | 883 | static const struct ethtool_ops netdev_ethtool_ops = { |
1da177e4 LT |
884 | .get_drvinfo = netdev_get_drvinfo, |
885 | .get_msglevel = netdev_get_msglevel, | |
886 | .set_msglevel = netdev_set_msglevel, | |
887 | }; | |
888 | ||
889 | #ifdef MODULE | |
890 | ||
891 | static struct net_device *dev_3c501; | |
892 | ||
893 | module_param(io, int, 0); | |
894 | module_param(irq, int, 0); | |
895 | MODULE_PARM_DESC(io, "EtherLink I/O base address"); | |
896 | MODULE_PARM_DESC(irq, "EtherLink IRQ number"); | |
897 | ||
898 | /** | |
899 | * init_module: | |
900 | * | |
901 | * When the driver is loaded as a module this function is called. We fake up | |
902 | * a device structure with the base I/O and interrupt set as if it were being | |
903 | * called from Space.c. This minimises the extra code that would otherwise | |
904 | * be required. | |
905 | * | |
906 | * Returns 0 for success or -EIO if a card is not found. Returning an error | |
907 | * here also causes the module to be unloaded | |
908 | */ | |
6aa20a22 | 909 | |
96e672c7 | 910 | int __init init_module(void) |
1da177e4 LT |
911 | { |
912 | dev_3c501 = el1_probe(-1); | |
913 | if (IS_ERR(dev_3c501)) | |
914 | return PTR_ERR(dev_3c501); | |
915 | return 0; | |
916 | } | |
917 | ||
918 | /** | |
919 | * cleanup_module: | |
6aa20a22 | 920 | * |
1da177e4 LT |
921 | * The module is being unloaded. We unhook our network device from the system |
922 | * and then free up the resources we took when the card was found. | |
923 | */ | |
6aa20a22 | 924 | |
1da177e4 LT |
925 | void cleanup_module(void) |
926 | { | |
927 | struct net_device *dev = dev_3c501; | |
928 | unregister_netdev(dev); | |
929 | release_region(dev->base_addr, EL1_IO_EXTENT); | |
930 | free_netdev(dev); | |
931 | } | |
932 | ||
933 | #endif /* MODULE */ | |
934 | ||
935 | MODULE_AUTHOR("Donald Becker, Alan Cox"); | |
936 | MODULE_DESCRIPTION("Support for the ancient 3Com 3c501 ethernet card"); | |
937 | MODULE_LICENSE("GPL"); | |
938 |