1 /* 3c509.c: A 3c509 EtherLink3 ethernet driver for linux. */
3 Written 1993-2000 by Donald Becker.
5 Copyright 1994-2000 by Donald Becker.
6 Copyright 1993 United States Government as represented by the
7 Director, National Security Agency. This software may be used and
8 distributed according to the terms of the GNU General Public License,
9 incorporated herein by reference.
11 This driver is for the 3Com EtherLinkIII series.
13 The author may be reached as becker@scyld.com, or C/O
14 Scyld Computing Corporation
15 410 Severn Ave., Suite 210
19 Because of the way 3c509 ISA detection works it's difficult to predict
20 a priori which of several ISA-mode cards will be detected first.
22 This driver does not use predictive interrupt mode, resulting in higher
23 packet latency but lower overhead. If interrupts are disabled for an
24 unusually long time it could also result in missed packets, but in
25 practice this rarely happens.
29 Alan Cox: Removed the 'Unexpected interrupt' bug.
30 Michael Meskes: Upgraded to Donald Becker's version 1.07.
31 Alan Cox: Increased the eeprom delay. Regardless of
32 what the docs say some people definitely
33 get problems with lower (but in card spec)
35 v1.10 4/21/97 Fixed module code so that multiple cards may be detected,
37 Andrea Arcangeli: Upgraded to Donald Becker's version 1.12.
38 Rick Payne: Fixed SMP race condition
39 v1.13 9/8/97 Made 'max_interrupt_work' an insmod-settable variable -djb
40 v1.14 10/15/97 Avoided waiting..discard message for fast machines -djb
41 v1.15 1/31/98 Faster recovery for Tx errors. -djb
42 v1.16 2/3/98 Different ID port handling to avoid sound cards. -djb
43 v1.18 12Mar2001 Andrew Morton <andrewm@uow.edu.au>
44 - Avoid bogus detect of 3c590's (Andrzej Krzysztofowicz)
45 - Reviewed against 1.18 from scyld.com
46 v1.18a 17Nov2001 Jeff Garzik <jgarzik@pobox.com>
48 v1.18b 1Mar2002 Zwane Mwaikambo <zwane@commfireservices.com>
49 - Power Management support
50 v1.18c 1Mar2002 David Ruggiero <jdr@farfalle.com>
52 v1.19 16Oct2002 Zwane Mwaikambo <zwane@linuxpower.ca>
53 - Additional ethtool features
54 v1.19a 28Oct2002 Davud Ruggiero <jdr@farfalle.com>
55 - Increase *read_eeprom udelay to workaround oops with 2 cards.
56 v1.19b 08Nov2002 Marc Zyngier <maz@wild-wind.fr.eu.org>
57 - Introduce driver model for EISA cards.
58 v1.20 04Feb2008 Ondrej Zary <linux@rainbow-software.org>
59 - convert to isa_driver and pnp_driver and some cleanups
62 #define DRV_NAME "3c509"
63 #define DRV_VERSION "1.20"
64 #define DRV_RELDATE "04Feb2008"
66 /* A few values that may be tweaked. */
68 /* Time in jiffies before concluding the transmitter is hung. */
69 #define TX_TIMEOUT (400*HZ/1000)
71 #include <linux/module.h>
72 #include <linux/mca.h>
73 #include <linux/isa.h>
74 #include <linux/pnp.h>
75 #include <linux/string.h>
76 #include <linux/interrupt.h>
77 #include <linux/errno.h>
79 #include <linux/slab.h>
80 #include <linux/ioport.h>
81 #include <linux/init.h>
82 #include <linux/netdevice.h>
83 #include <linux/etherdevice.h>
85 #include <linux/skbuff.h>
86 #include <linux/delay.h> /* for udelay() */
87 #include <linux/spinlock.h>
88 #include <linux/ethtool.h>
89 #include <linux/device.h>
90 #include <linux/eisa.h>
91 #include <linux/bitops.h>
93 #include <asm/uaccess.h>
97 static char version[] __initdata = DRV_NAME ".c:" DRV_VERSION " " DRV_RELDATE " becker@scyld.com\n";
100 static int el3_debug = EL3_DEBUG;
102 static int el3_debug = 2;
105 /* Used to do a global count of all the cards in the system. Must be
106 * a global variable so that the mca/eisa probe routines can increment
108 static int el3_cards = 0;
109 #define EL3_MAX_CARDS 8
111 /* To minimize the size of the driver source I only define operating
112 constants if they are used several times. You'll need the manual
113 anyway if you want to understand driver details. */
114 /* Offsets from base I/O address. */
115 #define EL3_DATA 0x00
117 #define EL3_STATUS 0x0e
118 #define EEPROM_READ 0x80
120 #define EL3_IO_EXTENT 16
122 #define EL3WINDOW(win_num) outw(SelectWindow + (win_num), ioaddr + EL3_CMD)
125 /* The top five bits written to EL3_CMD are a command, the lower
126 11 bits are the parameter, if applicable. */
128 TotalReset = 0<<11, SelectWindow = 1<<11, StartCoax = 2<<11,
129 RxDisable = 3<<11, RxEnable = 4<<11, RxReset = 5<<11, RxDiscard = 8<<11,
130 TxEnable = 9<<11, TxDisable = 10<<11, TxReset = 11<<11,
131 FakeIntr = 12<<11, AckIntr = 13<<11, SetIntrEnb = 14<<11,
132 SetStatusEnb = 15<<11, SetRxFilter = 16<<11, SetRxThreshold = 17<<11,
133 SetTxThreshold = 18<<11, SetTxStart = 19<<11, StatsEnable = 21<<11,
134 StatsDisable = 22<<11, StopCoax = 23<<11, PowerUp = 27<<11,
135 PowerDown = 28<<11, PowerAuto = 29<<11};
138 IntLatch = 0x0001, AdapterFailure = 0x0002, TxComplete = 0x0004,
139 TxAvailable = 0x0008, RxComplete = 0x0010, RxEarly = 0x0020,
140 IntReq = 0x0040, StatsFull = 0x0080, CmdBusy = 0x1000, };
142 /* The SetRxFilter command accepts the following classes: */
144 RxStation = 1, RxMulticast = 2, RxBroadcast = 4, RxProm = 8 };
146 /* Register window 1 offsets, the window used in normal operation. */
149 #define RX_STATUS 0x08
150 #define TX_STATUS 0x0B
151 #define TX_FREE 0x0C /* Remaining free bytes in Tx buffer. */
153 #define WN0_CONF_CTRL 0x04 /* Window 0: Configuration control register */
154 #define WN0_ADDR_CONF 0x06 /* Window 0: Address configuration register */
155 #define WN0_IRQ 0x08 /* Window 0: Set IRQ line in bits 12-15. */
156 #define WN4_MEDIA 0x0A /* Window 4: Various transcvr/media bits. */
157 #define MEDIA_TP 0x00C0 /* Enable link beat and jabber for 10baseT. */
158 #define WN4_NETDIAG 0x06 /* Window 4: Net diagnostic */
159 #define FD_ENABLE 0x8000 /* Enable full-duplex ("external loopback") */
162 * Must be a power of two (we use a binary and in the
165 #define SKB_QUEUE_SIZE 64
167 enum el3_cardtype { EL3_ISA, EL3_PNP, EL3_MCA, EL3_EISA };
170 struct net_device_stats stats;
174 struct sk_buff *queue[SKB_QUEUE_SIZE];
175 enum el3_cardtype type;
178 static int current_tag;
179 static struct net_device *el3_devs[EL3_MAX_CARDS];
181 /* Parameters that may be passed into the module. */
182 static int debug = -1;
183 static int irq[] = {-1, -1, -1, -1, -1, -1, -1, -1};
184 /* Maximum events (Rx packets, etc.) to handle at each interrupt. */
185 static int max_interrupt_work = 10;
190 static int __init el3_common_init(struct net_device *dev);
191 static void el3_common_remove(struct net_device *dev);
192 static ushort id_read_eeprom(int index);
193 static ushort read_eeprom(int ioaddr, int index);
194 static int el3_open(struct net_device *dev);
195 static int el3_start_xmit(struct sk_buff *skb, struct net_device *dev);
196 static irqreturn_t el3_interrupt(int irq, void *dev_id);
197 static void update_stats(struct net_device *dev);
198 static struct net_device_stats *el3_get_stats(struct net_device *dev);
199 static int el3_rx(struct net_device *dev);
200 static int el3_close(struct net_device *dev);
201 static void set_multicast_list(struct net_device *dev);
202 static void el3_tx_timeout (struct net_device *dev);
203 static void el3_down(struct net_device *dev);
204 static void el3_up(struct net_device *dev);
205 static const struct ethtool_ops ethtool_ops;
207 static int el3_suspend(struct device *, pm_message_t);
208 static int el3_resume(struct device *);
210 #define el3_suspend NULL
211 #define el3_resume NULL
215 /* generic device remove for all device types */
216 static int el3_device_remove (struct device *device);
217 #ifdef CONFIG_NET_POLL_CONTROLLER
218 static void el3_poll_controller(struct net_device *dev);
221 /* Return 0 on success, 1 on error, 2 when found already detected PnP card */
222 static int el3_isa_id_sequence(__be16 *phys_addr)
224 short lrs_state = 0xff;
227 /* ISA boards are detected by sending the ID sequence to the
228 ID_PORT. We find cards past the first by setting the 'current_tag'
229 on cards as they are found. Cards with their tag set will not
230 respond to subsequent ID sequences. */
234 for (i = 0; i < 255; i++) {
235 outb(lrs_state, id_port);
237 lrs_state = lrs_state & 0x100 ? lrs_state ^ 0xcf : lrs_state;
239 /* For the first probe, clear all board's tag registers. */
240 if (current_tag == 0)
242 else /* Otherwise kill off already-found boards. */
244 if (id_read_eeprom(7) != 0x6d50)
246 /* Read in EEPROM data, which does contention-select.
247 Only the lowest address board will stay "on-line".
248 3Com got the byte order backwards. */
249 for (i = 0; i < 3; i++)
250 phys_addr[i] = htons(id_read_eeprom(i));
253 /* The ISA PnP 3c509 cards respond to the ID sequence too.
254 This check is needed in order not to register them twice. */
255 for (i = 0; i < el3_cards; i++) {
256 struct el3_private *lp = netdev_priv(el3_devs[i]);
257 if (lp->type == EL3_PNP
258 && !memcmp(phys_addr, el3_devs[i]->dev_addr,
261 printk(KERN_DEBUG "3c509 with address %02x %02x %02x %02x %02x %02x was found by ISAPnP\n",
262 phys_addr[0] & 0xff, phys_addr[0] >> 8,
263 phys_addr[1] & 0xff, phys_addr[1] >> 8,
264 phys_addr[2] & 0xff, phys_addr[2] >> 8);
265 /* Set the adaptor tag so that the next card can be found. */
266 outb(0xd0 + ++current_tag, id_port);
271 #endif /* CONFIG_PNP */
276 static void __devinit el3_dev_fill(struct net_device *dev, __be16 *phys_addr,
277 int ioaddr, int irq, int if_port,
278 enum el3_cardtype type)
280 struct el3_private *lp = netdev_priv(dev);
282 memcpy(dev->dev_addr, phys_addr, ETH_ALEN);
283 dev->base_addr = ioaddr;
285 dev->if_port = if_port;
289 static int __devinit el3_isa_match(struct device *pdev,
292 struct net_device *dev;
293 int ioaddr, isa_irq, if_port, err;
297 while ((err = el3_isa_id_sequence(phys_addr)) == 2)
298 ; /* Skip to next card when PnP card found */
302 iobase = id_read_eeprom(8);
303 if_port = iobase >> 14;
304 ioaddr = 0x200 + ((iobase & 0x1f) << 4);
305 if (irq[el3_cards] > 1 && irq[el3_cards] < 16)
306 isa_irq = irq[el3_cards];
308 isa_irq = id_read_eeprom(9) >> 12;
310 dev = alloc_etherdev(sizeof(struct el3_private));
314 netdev_boot_setup_check(dev);
316 if (!request_region(ioaddr, EL3_IO_EXTENT, "3c509-isa")) {
321 /* Set the adaptor tag so that the next card can be found. */
322 outb(0xd0 + ++current_tag, id_port);
324 /* Activate the adaptor at the EEPROM location. */
325 outb((ioaddr >> 4) | 0xe0, id_port);
328 if (inw(ioaddr) != 0x6d50) {
333 /* Free the interrupt so that some other card can use it. */
334 outw(0x0f00, ioaddr + WN0_IRQ);
336 el3_dev_fill(dev, phys_addr, ioaddr, isa_irq, if_port, EL3_ISA);
337 dev_set_drvdata(pdev, dev);
338 if (el3_common_init(dev)) {
343 el3_devs[el3_cards++] = dev;
347 static int __devexit el3_isa_remove(struct device *pdev,
350 el3_device_remove(pdev);
351 dev_set_drvdata(pdev, NULL);
356 static int el3_isa_suspend(struct device *dev, unsigned int n,
360 return el3_suspend(dev, state);
363 static int el3_isa_resume(struct device *dev, unsigned int n)
365 struct net_device *ndev = dev_get_drvdata(dev);
366 int ioaddr = ndev->base_addr, err;
369 while ((err = el3_isa_id_sequence(phys_addr)) == 2)
370 ; /* Skip to next card when PnP card found */
373 /* Set the adaptor tag so that the next card can be found. */
374 outb(0xd0 + ++current_tag, id_port);
375 /* Enable the card */
376 outb((ioaddr >> 4) | 0xe0, id_port);
378 if (inw(ioaddr) != 0x6d50)
380 /* Free the interrupt so that some other card can use it. */
381 outw(0x0f00, ioaddr + WN0_IRQ);
382 return el3_resume(dev);
386 static struct isa_driver el3_isa_driver = {
387 .match = el3_isa_match,
388 .remove = __devexit_p(el3_isa_remove),
390 .suspend = el3_isa_suspend,
391 .resume = el3_isa_resume,
397 static int isa_registered;
400 static struct pnp_device_id el3_pnp_ids[] = {
401 { .id = "TCM5090" }, /* 3Com Etherlink III (TP) */
402 { .id = "TCM5091" }, /* 3Com Etherlink III */
403 { .id = "TCM5094" }, /* 3Com Etherlink III (combo) */
404 { .id = "TCM5095" }, /* 3Com Etherlink III (TPO) */
405 { .id = "TCM5098" }, /* 3Com Etherlink III (TPC) */
406 { .id = "PNP80f7" }, /* 3Com Etherlink III compatible */
407 { .id = "PNP80f8" }, /* 3Com Etherlink III compatible */
410 MODULE_DEVICE_TABLE(pnp, el3_pnp_ids);
412 static int __devinit el3_pnp_probe(struct pnp_dev *pdev,
413 const struct pnp_device_id *id)
416 int ioaddr, irq, if_port;
418 struct net_device *dev = NULL;
421 ioaddr = pnp_port_start(pdev, 0);
422 if (!request_region(ioaddr, EL3_IO_EXTENT, "3c509-pnp"))
424 irq = pnp_irq(pdev, 0);
426 for (i = 0; i < 3; i++)
427 phys_addr[i] = htons(read_eeprom(ioaddr, i));
428 if_port = read_eeprom(ioaddr, 8) >> 14;
429 dev = alloc_etherdev(sizeof(struct el3_private));
431 release_region(ioaddr, EL3_IO_EXTENT);
434 SET_NETDEV_DEV(dev, &pdev->dev);
435 netdev_boot_setup_check(dev);
437 el3_dev_fill(dev, phys_addr, ioaddr, irq, if_port, EL3_PNP);
438 pnp_set_drvdata(pdev, dev);
439 err = el3_common_init(dev);
442 pnp_set_drvdata(pdev, NULL);
447 el3_devs[el3_cards++] = dev;
451 static void __devexit el3_pnp_remove(struct pnp_dev *pdev)
453 el3_common_remove(pnp_get_drvdata(pdev));
454 pnp_set_drvdata(pdev, NULL);
458 static int el3_pnp_suspend(struct pnp_dev *pdev, pm_message_t state)
460 return el3_suspend(&pdev->dev, state);
463 static int el3_pnp_resume(struct pnp_dev *pdev)
465 return el3_resume(&pdev->dev);
469 static struct pnp_driver el3_pnp_driver = {
471 .id_table = el3_pnp_ids,
472 .probe = el3_pnp_probe,
473 .remove = __devexit_p(el3_pnp_remove),
475 .suspend = el3_pnp_suspend,
476 .resume = el3_pnp_resume,
479 static int pnp_registered;
480 #endif /* CONFIG_PNP */
483 static struct eisa_device_id el3_eisa_ids[] = {
489 MODULE_DEVICE_TABLE(eisa, el3_eisa_ids);
491 static int el3_eisa_probe (struct device *device);
493 static struct eisa_driver el3_eisa_driver = {
494 .id_table = el3_eisa_ids,
497 .probe = el3_eisa_probe,
498 .remove = __devexit_p (el3_device_remove),
499 .suspend = el3_suspend,
500 .resume = el3_resume,
503 static int eisa_registered;
507 static int el3_mca_probe(struct device *dev);
509 static short el3_mca_adapter_ids[] __initdata = {
518 static char *el3_mca_adapter_names[] __initdata = {
519 "3Com 3c529 EtherLink III (10base2)",
520 "3Com 3c529 EtherLink III (10baseT)",
521 "3Com 3c529 EtherLink III (test mode)",
522 "3Com 3c529 EtherLink III (TP or coax)",
523 "3Com 3c529 EtherLink III (TP)",
527 static struct mca_driver el3_mca_driver = {
528 .id_table = el3_mca_adapter_ids,
531 .bus = &mca_bus_type,
532 .probe = el3_mca_probe,
533 .remove = __devexit_p(el3_device_remove),
534 .suspend = el3_suspend,
535 .resume = el3_resume,
538 static int mca_registered;
539 #endif /* CONFIG_MCA */
541 static int __init el3_common_init(struct net_device *dev)
543 struct el3_private *lp = netdev_priv(dev);
545 DECLARE_MAC_BUF(mac);
546 const char *if_names[] = {"10baseT", "AUI", "undefined", "BNC"};
548 spin_lock_init(&lp->lock);
550 if (dev->mem_start & 0x05) { /* xcvr codes 1/3/4/12 */
551 dev->if_port = (dev->mem_start & 0x0f);
552 } else { /* xcvr codes 0/8 */
553 /* use eeprom value, but save user's full-duplex selection */
554 dev->if_port |= (dev->mem_start & 0x08);
557 /* The EL3-specific entries in the device structure. */
558 dev->open = &el3_open;
559 dev->hard_start_xmit = &el3_start_xmit;
560 dev->stop = &el3_close;
561 dev->get_stats = &el3_get_stats;
562 dev->set_multicast_list = &set_multicast_list;
563 dev->tx_timeout = el3_tx_timeout;
564 dev->watchdog_timeo = TX_TIMEOUT;
565 #ifdef CONFIG_NET_POLL_CONTROLLER
566 dev->poll_controller = el3_poll_controller;
568 SET_ETHTOOL_OPS(dev, ðtool_ops);
570 err = register_netdev(dev);
572 printk(KERN_ERR "Failed to register 3c5x9 at %#3.3lx, IRQ %d.\n",
573 dev->base_addr, dev->irq);
574 release_region(dev->base_addr, EL3_IO_EXTENT);
578 printk(KERN_INFO "%s: 3c5x9 found at %#3.3lx, %s port, "
579 "address %s, IRQ %d.\n",
580 dev->name, dev->base_addr, if_names[(dev->if_port & 0x03)],
581 print_mac(mac, dev->dev_addr), dev->irq);
584 printk(KERN_INFO "%s", version);
589 static void el3_common_remove (struct net_device *dev)
591 unregister_netdev (dev);
592 release_region(dev->base_addr, EL3_IO_EXTENT);
597 static int __init el3_mca_probe(struct device *device)
599 /* Based on Erik Nygren's (nygren@mit.edu) 3c529 patch,
600 * heavily modified by Chris Beauregard
601 * (cpbeaure@csclub.uwaterloo.ca) to support standard MCA
604 * redone for multi-card detection by ZP Gu (zpg@castle.net)
605 * now works as a module */
608 int ioaddr, irq, if_port;
610 struct net_device *dev = NULL;
612 struct mca_device *mdev = to_mca_device(device);
613 int slot = mdev->slot;
616 pos4 = mca_device_read_stored_pos(mdev, 4);
617 pos5 = mca_device_read_stored_pos(mdev, 5);
619 ioaddr = ((short)((pos4&0xfc)|0x02)) << 8;
623 printk(KERN_INFO "3c529: found %s at slot %d\n",
624 el3_mca_adapter_names[mdev->index], slot + 1);
627 strncpy(mdev->name, el3_mca_adapter_names[mdev->index],
629 mca_device_set_claim(mdev, 1);
631 if_port = pos4 & 0x03;
633 irq = mca_device_transform_irq(mdev, irq);
634 ioaddr = mca_device_transform_ioport(mdev, ioaddr);
636 printk(KERN_DEBUG "3c529: irq %d ioaddr 0x%x ifport %d\n", irq, ioaddr, if_port);
639 for (i = 0; i < 3; i++) {
640 phys_addr[i] = htons(read_eeprom(ioaddr, i));
643 dev = alloc_etherdev(sizeof (struct el3_private));
645 release_region(ioaddr, EL3_IO_EXTENT);
649 netdev_boot_setup_check(dev);
651 el3_dev_fill(dev, phys_addr, ioaddr, irq, if_port, EL3_MCA);
652 device->driver_data = dev;
653 err = el3_common_init(dev);
656 device->driver_data = NULL;
661 el3_devs[el3_cards++] = dev;
665 #endif /* CONFIG_MCA */
668 static int __init el3_eisa_probe (struct device *device)
671 int ioaddr, irq, if_port;
673 struct net_device *dev = NULL;
674 struct eisa_device *edev;
677 /* Yeepee, The driver framework is calling us ! */
678 edev = to_eisa_device (device);
679 ioaddr = edev->base_addr;
681 if (!request_region(ioaddr, EL3_IO_EXTENT, "3c579-eisa"))
684 /* Change the register set to the configuration window 0. */
685 outw(SelectWindow | 0, ioaddr + 0xC80 + EL3_CMD);
687 irq = inw(ioaddr + WN0_IRQ) >> 12;
688 if_port = inw(ioaddr + 6)>>14;
689 for (i = 0; i < 3; i++)
690 phys_addr[i] = htons(read_eeprom(ioaddr, i));
692 /* Restore the "Product ID" to the EEPROM read register. */
693 read_eeprom(ioaddr, 3);
695 dev = alloc_etherdev(sizeof (struct el3_private));
697 release_region(ioaddr, EL3_IO_EXTENT);
701 netdev_boot_setup_check(dev);
703 el3_dev_fill(dev, phys_addr, ioaddr, irq, if_port, EL3_EISA);
704 eisa_set_drvdata (edev, dev);
705 err = el3_common_init(dev);
708 eisa_set_drvdata (edev, NULL);
713 el3_devs[el3_cards++] = dev;
718 /* This remove works for all device types.
720 * The net dev must be stored in the driver_data field */
721 static int __devexit el3_device_remove (struct device *device)
723 struct net_device *dev;
725 dev = device->driver_data;
727 el3_common_remove (dev);
731 /* Read a word from the EEPROM using the regular EEPROM access register.
732 Assume that we are in register window zero.
734 static ushort read_eeprom(int ioaddr, int index)
736 outw(EEPROM_READ + index, ioaddr + 10);
737 /* Pause for at least 162 us. for the read to take place.
738 Some chips seem to require much longer */
740 return inw(ioaddr + 12);
743 /* Read a word from the EEPROM when in the ISA ID probe state. */
744 static ushort id_read_eeprom(int index)
748 /* Issue read command, and pause for at least 162 us. for it to complete.
749 Assume extra-fast 16Mhz bus. */
750 outb(EEPROM_READ + index, id_port);
752 /* Pause for at least 162 us. for the read to take place. */
753 /* Some chips seem to require much longer */
756 for (bit = 15; bit >= 0; bit--)
757 word = (word << 1) + (inb(id_port) & 0x01);
760 printk(KERN_DEBUG " 3c509 EEPROM word %d %#4.4x.\n", index, word);
767 el3_open(struct net_device *dev)
769 int ioaddr = dev->base_addr;
772 outw(TxReset, ioaddr + EL3_CMD);
773 outw(RxReset, ioaddr + EL3_CMD);
774 outw(SetStatusEnb | 0x00, ioaddr + EL3_CMD);
776 i = request_irq(dev->irq, &el3_interrupt, 0, dev->name, dev);
782 printk(KERN_DEBUG "%s: Opening, IRQ %d status@%x %4.4x.\n", dev->name,
783 dev->irq, ioaddr + EL3_STATUS, inw(ioaddr + EL3_STATUS));
788 printk(KERN_DEBUG "%s: Opened 3c509 IRQ %d status %4.4x.\n",
789 dev->name, dev->irq, inw(ioaddr + EL3_STATUS));
795 el3_tx_timeout (struct net_device *dev)
797 struct el3_private *lp = netdev_priv(dev);
798 int ioaddr = dev->base_addr;
800 /* Transmitter timeout, serious problems. */
801 printk(KERN_WARNING "%s: transmit timed out, Tx_status %2.2x status %4.4x "
802 "Tx FIFO room %d.\n",
803 dev->name, inb(ioaddr + TX_STATUS), inw(ioaddr + EL3_STATUS),
804 inw(ioaddr + TX_FREE));
805 lp->stats.tx_errors++;
806 dev->trans_start = jiffies;
807 /* Issue TX_RESET and TX_START commands. */
808 outw(TxReset, ioaddr + EL3_CMD);
809 outw(TxEnable, ioaddr + EL3_CMD);
810 netif_wake_queue(dev);
815 el3_start_xmit(struct sk_buff *skb, struct net_device *dev)
817 struct el3_private *lp = netdev_priv(dev);
818 int ioaddr = dev->base_addr;
821 netif_stop_queue (dev);
823 lp->stats.tx_bytes += skb->len;
826 printk(KERN_DEBUG "%s: el3_start_xmit(length = %u) called, status %4.4x.\n",
827 dev->name, skb->len, inw(ioaddr + EL3_STATUS));
830 #ifndef final_version
831 { /* Error-checking code, delete someday. */
832 ushort status = inw(ioaddr + EL3_STATUS);
833 if (status & 0x0001 /* IRQ line active, missed one. */
834 && inw(ioaddr + EL3_STATUS) & 1) { /* Make sure. */
835 printk(KERN_DEBUG "%s: Missed interrupt, status then %04x now %04x"
836 " Tx %2.2x Rx %4.4x.\n", dev->name, status,
837 inw(ioaddr + EL3_STATUS), inb(ioaddr + TX_STATUS),
838 inw(ioaddr + RX_STATUS));
839 /* Fake interrupt trigger by masking, acknowledge interrupts. */
840 outw(SetStatusEnb | 0x00, ioaddr + EL3_CMD);
841 outw(AckIntr | IntLatch | TxAvailable | RxEarly | IntReq,
843 outw(SetStatusEnb | 0xff, ioaddr + EL3_CMD);
849 * We lock the driver against other processors. Note
850 * we don't need to lock versus the IRQ as we suspended
851 * that. This means that we lose the ability to take
852 * an RX during a TX upload. That sucks a bit with SMP
853 * on an original 3c509 (2K buffer)
855 * Using disable_irq stops us crapping on other
856 * time sensitive devices.
859 spin_lock_irqsave(&lp->lock, flags);
861 /* Put out the doubleword header... */
862 outw(skb->len, ioaddr + TX_FIFO);
863 outw(0x00, ioaddr + TX_FIFO);
864 /* ... and the packet rounded to a doubleword. */
865 outsl(ioaddr + TX_FIFO, skb->data, (skb->len + 3) >> 2);
867 dev->trans_start = jiffies;
868 if (inw(ioaddr + TX_FREE) > 1536)
869 netif_start_queue(dev);
871 /* Interrupt us when the FIFO has room for max-sized packet. */
872 outw(SetTxThreshold + 1536, ioaddr + EL3_CMD);
874 spin_unlock_irqrestore(&lp->lock, flags);
878 /* Clear the Tx status stack. */
883 while (--i > 0 && (tx_status = inb(ioaddr + TX_STATUS)) > 0) {
884 if (tx_status & 0x38) lp->stats.tx_aborted_errors++;
885 if (tx_status & 0x30) outw(TxReset, ioaddr + EL3_CMD);
886 if (tx_status & 0x3C) outw(TxEnable, ioaddr + EL3_CMD);
887 outb(0x00, ioaddr + TX_STATUS); /* Pop the status stack. */
893 /* The EL3 interrupt handler. */
895 el3_interrupt(int irq, void *dev_id)
897 struct net_device *dev = dev_id;
898 struct el3_private *lp;
900 int i = max_interrupt_work;
902 lp = netdev_priv(dev);
903 spin_lock(&lp->lock);
905 ioaddr = dev->base_addr;
908 status = inw(ioaddr + EL3_STATUS);
909 printk(KERN_DEBUG "%s: interrupt, status %4.4x.\n", dev->name, status);
912 while ((status = inw(ioaddr + EL3_STATUS)) &
913 (IntLatch | RxComplete | StatsFull)) {
915 if (status & RxComplete)
918 if (status & TxAvailable) {
920 printk(KERN_DEBUG " TX room bit was handled.\n");
921 /* There's room in the FIFO for a full-sized packet. */
922 outw(AckIntr | TxAvailable, ioaddr + EL3_CMD);
923 netif_wake_queue (dev);
925 if (status & (AdapterFailure | RxEarly | StatsFull | TxComplete)) {
926 /* Handle all uncommon interrupts. */
927 if (status & StatsFull) /* Empty statistics. */
929 if (status & RxEarly) { /* Rx early is unused. */
931 outw(AckIntr | RxEarly, ioaddr + EL3_CMD);
933 if (status & TxComplete) { /* Really Tx error. */
934 struct el3_private *lp = netdev_priv(dev);
938 while (--i>0 && (tx_status = inb(ioaddr + TX_STATUS)) > 0) {
939 if (tx_status & 0x38) lp->stats.tx_aborted_errors++;
940 if (tx_status & 0x30) outw(TxReset, ioaddr + EL3_CMD);
941 if (tx_status & 0x3C) outw(TxEnable, ioaddr + EL3_CMD);
942 outb(0x00, ioaddr + TX_STATUS); /* Pop the status stack. */
945 if (status & AdapterFailure) {
946 /* Adapter failure requires Rx reset and reinit. */
947 outw(RxReset, ioaddr + EL3_CMD);
948 /* Set the Rx filter to the current state. */
949 outw(SetRxFilter | RxStation | RxBroadcast
950 | (dev->flags & IFF_ALLMULTI ? RxMulticast : 0)
951 | (dev->flags & IFF_PROMISC ? RxProm : 0),
953 outw(RxEnable, ioaddr + EL3_CMD); /* Re-enable the receiver. */
954 outw(AckIntr | AdapterFailure, ioaddr + EL3_CMD);
959 printk(KERN_ERR "%s: Infinite loop in interrupt, status %4.4x.\n",
961 /* Clear all interrupts. */
962 outw(AckIntr | 0xFF, ioaddr + EL3_CMD);
965 /* Acknowledge the IRQ. */
966 outw(AckIntr | IntReq | IntLatch, ioaddr + EL3_CMD); /* Ack IRQ */
970 printk(KERN_DEBUG "%s: exiting interrupt, status %4.4x.\n", dev->name,
971 inw(ioaddr + EL3_STATUS));
973 spin_unlock(&lp->lock);
978 #ifdef CONFIG_NET_POLL_CONTROLLER
980 * Polling receive - used by netconsole and other diagnostic tools
981 * to allow network i/o with interrupts disabled.
983 static void el3_poll_controller(struct net_device *dev)
985 disable_irq(dev->irq);
986 el3_interrupt(dev->irq, dev);
987 enable_irq(dev->irq);
991 static struct net_device_stats *
992 el3_get_stats(struct net_device *dev)
994 struct el3_private *lp = netdev_priv(dev);
998 * This is fast enough not to bother with disable IRQ
1002 spin_lock_irqsave(&lp->lock, flags);
1004 spin_unlock_irqrestore(&lp->lock, flags);
1008 /* Update statistics. We change to register window 6, so this should be run
1009 single-threaded if the device is active. This is expected to be a rare
1010 operation, and it's simpler for the rest of the driver to assume that
1011 window 1 is always valid rather than use a special window-state variable.
1013 static void update_stats(struct net_device *dev)
1015 struct el3_private *lp = netdev_priv(dev);
1016 int ioaddr = dev->base_addr;
1019 printk(" Updating the statistics.\n");
1020 /* Turn off statistics updates while reading. */
1021 outw(StatsDisable, ioaddr + EL3_CMD);
1022 /* Switch to the stats window, and read everything. */
1024 lp->stats.tx_carrier_errors += inb(ioaddr + 0);
1025 lp->stats.tx_heartbeat_errors += inb(ioaddr + 1);
1026 /* Multiple collisions. */ inb(ioaddr + 2);
1027 lp->stats.collisions += inb(ioaddr + 3);
1028 lp->stats.tx_window_errors += inb(ioaddr + 4);
1029 lp->stats.rx_fifo_errors += inb(ioaddr + 5);
1030 lp->stats.tx_packets += inb(ioaddr + 6);
1031 /* Rx packets */ inb(ioaddr + 7);
1032 /* Tx deferrals */ inb(ioaddr + 8);
1033 inw(ioaddr + 10); /* Total Rx and Tx octets. */
1036 /* Back to window 1, and turn statistics back on. */
1038 outw(StatsEnable, ioaddr + EL3_CMD);
1043 el3_rx(struct net_device *dev)
1045 struct el3_private *lp = netdev_priv(dev);
1046 int ioaddr = dev->base_addr;
1050 printk(" In rx_packet(), status %4.4x, rx_status %4.4x.\n",
1051 inw(ioaddr+EL3_STATUS), inw(ioaddr+RX_STATUS));
1052 while ((rx_status = inw(ioaddr + RX_STATUS)) > 0) {
1053 if (rx_status & 0x4000) { /* Error, update stats. */
1054 short error = rx_status & 0x3800;
1056 outw(RxDiscard, ioaddr + EL3_CMD);
1057 lp->stats.rx_errors++;
1059 case 0x0000: lp->stats.rx_over_errors++; break;
1060 case 0x0800: lp->stats.rx_length_errors++; break;
1061 case 0x1000: lp->stats.rx_frame_errors++; break;
1062 case 0x1800: lp->stats.rx_length_errors++; break;
1063 case 0x2000: lp->stats.rx_frame_errors++; break;
1064 case 0x2800: lp->stats.rx_crc_errors++; break;
1067 short pkt_len = rx_status & 0x7ff;
1068 struct sk_buff *skb;
1070 skb = dev_alloc_skb(pkt_len+5);
1071 lp->stats.rx_bytes += pkt_len;
1073 printk("Receiving packet size %d status %4.4x.\n",
1074 pkt_len, rx_status);
1076 skb_reserve(skb, 2); /* Align IP on 16 byte */
1078 /* 'skb->data' points to the start of sk_buff data area. */
1079 insl(ioaddr + RX_FIFO, skb_put(skb,pkt_len),
1080 (pkt_len + 3) >> 2);
1082 outw(RxDiscard, ioaddr + EL3_CMD); /* Pop top Rx packet. */
1083 skb->protocol = eth_type_trans(skb,dev);
1085 dev->last_rx = jiffies;
1086 lp->stats.rx_packets++;
1089 outw(RxDiscard, ioaddr + EL3_CMD);
1090 lp->stats.rx_dropped++;
1092 printk("%s: Couldn't allocate a sk_buff of size %d.\n",
1093 dev->name, pkt_len);
1095 inw(ioaddr + EL3_STATUS); /* Delay. */
1096 while (inw(ioaddr + EL3_STATUS) & 0x1000)
1097 printk(KERN_DEBUG " Waiting for 3c509 to discard packet, status %x.\n",
1098 inw(ioaddr + EL3_STATUS) );
1105 * Set or clear the multicast filter for this adaptor.
1108 set_multicast_list(struct net_device *dev)
1110 unsigned long flags;
1111 struct el3_private *lp = netdev_priv(dev);
1112 int ioaddr = dev->base_addr;
1114 if (el3_debug > 1) {
1116 if (old != dev->mc_count) {
1117 old = dev->mc_count;
1118 printk("%s: Setting Rx mode to %d addresses.\n", dev->name, dev->mc_count);
1121 spin_lock_irqsave(&lp->lock, flags);
1122 if (dev->flags&IFF_PROMISC) {
1123 outw(SetRxFilter | RxStation | RxMulticast | RxBroadcast | RxProm,
1126 else if (dev->mc_count || (dev->flags&IFF_ALLMULTI)) {
1127 outw(SetRxFilter | RxStation | RxMulticast | RxBroadcast, ioaddr + EL3_CMD);
1130 outw(SetRxFilter | RxStation | RxBroadcast, ioaddr + EL3_CMD);
1131 spin_unlock_irqrestore(&lp->lock, flags);
1135 el3_close(struct net_device *dev)
1137 int ioaddr = dev->base_addr;
1138 struct el3_private *lp = netdev_priv(dev);
1141 printk("%s: Shutting down ethercard.\n", dev->name);
1145 free_irq(dev->irq, dev);
1146 /* Switching back to window 0 disables the IRQ. */
1148 if (lp->type != EL3_EISA) {
1149 /* But we explicitly zero the IRQ line select anyway. Don't do
1150 * it on EISA cards, it prevents the module from getting an
1151 * IRQ after unload+reload... */
1152 outw(0x0f00, ioaddr + WN0_IRQ);
1159 el3_link_ok(struct net_device *dev)
1161 int ioaddr = dev->base_addr;
1165 tmp = inw(ioaddr + WN4_MEDIA);
1167 return tmp & (1<<11);
1171 el3_netdev_get_ecmd(struct net_device *dev, struct ethtool_cmd *ecmd)
1174 int ioaddr = dev->base_addr;
1177 /* obtain current transceiver via WN4_MEDIA? */
1178 tmp = inw(ioaddr + WN0_ADDR_CONF);
1179 ecmd->transceiver = XCVR_INTERNAL;
1180 switch (tmp >> 14) {
1182 ecmd->port = PORT_TP;
1185 ecmd->port = PORT_AUI;
1186 ecmd->transceiver = XCVR_EXTERNAL;
1189 ecmd->port = PORT_BNC;
1194 ecmd->duplex = DUPLEX_HALF;
1195 ecmd->supported = 0;
1196 tmp = inw(ioaddr + WN0_CONF_CTRL);
1198 ecmd->supported |= SUPPORTED_AUI;
1200 ecmd->supported |= SUPPORTED_BNC;
1202 ecmd->supported |= SUPPORTED_TP | SUPPORTED_10baseT_Half |
1203 SUPPORTED_10baseT_Full; /* hmm... */
1205 tmp = inw(ioaddr + WN4_NETDIAG);
1206 if (tmp & FD_ENABLE)
1207 ecmd->duplex = DUPLEX_FULL;
1210 ecmd->speed = SPEED_10;
1216 el3_netdev_set_ecmd(struct net_device *dev, struct ethtool_cmd *ecmd)
1219 int ioaddr = dev->base_addr;
1221 if (ecmd->speed != SPEED_10)
1223 if ((ecmd->duplex != DUPLEX_HALF) && (ecmd->duplex != DUPLEX_FULL))
1225 if ((ecmd->transceiver != XCVR_INTERNAL) && (ecmd->transceiver != XCVR_EXTERNAL))
1228 /* change XCVR type */
1230 tmp = inw(ioaddr + WN0_ADDR_CONF);
1231 switch (ecmd->port) {
1248 outw(tmp, ioaddr + WN0_ADDR_CONF);
1249 if (dev->if_port == 3) {
1250 /* fire up the DC-DC convertor if BNC gets enabled */
1251 tmp = inw(ioaddr + WN0_ADDR_CONF);
1252 if (tmp & (3 << 14)) {
1253 outw(StartCoax, ioaddr + EL3_CMD);
1260 tmp = inw(ioaddr + WN4_NETDIAG);
1261 if (ecmd->duplex == DUPLEX_FULL)
1265 outw(tmp, ioaddr + WN4_NETDIAG);
1271 static void el3_get_drvinfo(struct net_device *dev, struct ethtool_drvinfo *info)
1273 strcpy(info->driver, DRV_NAME);
1274 strcpy(info->version, DRV_VERSION);
1277 static int el3_get_settings(struct net_device *dev, struct ethtool_cmd *ecmd)
1279 struct el3_private *lp = netdev_priv(dev);
1282 spin_lock_irq(&lp->lock);
1283 ret = el3_netdev_get_ecmd(dev, ecmd);
1284 spin_unlock_irq(&lp->lock);
1288 static int el3_set_settings(struct net_device *dev, struct ethtool_cmd *ecmd)
1290 struct el3_private *lp = netdev_priv(dev);
1293 spin_lock_irq(&lp->lock);
1294 ret = el3_netdev_set_ecmd(dev, ecmd);
1295 spin_unlock_irq(&lp->lock);
1299 static u32 el3_get_link(struct net_device *dev)
1301 struct el3_private *lp = netdev_priv(dev);
1304 spin_lock_irq(&lp->lock);
1305 ret = el3_link_ok(dev);
1306 spin_unlock_irq(&lp->lock);
1310 static u32 el3_get_msglevel(struct net_device *dev)
1315 static void el3_set_msglevel(struct net_device *dev, u32 v)
1320 static const struct ethtool_ops ethtool_ops = {
1321 .get_drvinfo = el3_get_drvinfo,
1322 .get_settings = el3_get_settings,
1323 .set_settings = el3_set_settings,
1324 .get_link = el3_get_link,
1325 .get_msglevel = el3_get_msglevel,
1326 .set_msglevel = el3_set_msglevel,
1330 el3_down(struct net_device *dev)
1332 int ioaddr = dev->base_addr;
1334 netif_stop_queue(dev);
1336 /* Turn off statistics ASAP. We update lp->stats below. */
1337 outw(StatsDisable, ioaddr + EL3_CMD);
1339 /* Disable the receiver and transmitter. */
1340 outw(RxDisable, ioaddr + EL3_CMD);
1341 outw(TxDisable, ioaddr + EL3_CMD);
1343 if (dev->if_port == 3)
1344 /* Turn off thinnet power. Green! */
1345 outw(StopCoax, ioaddr + EL3_CMD);
1346 else if (dev->if_port == 0) {
1347 /* Disable link beat and jabber, if_port may change here next open(). */
1349 outw(inw(ioaddr + WN4_MEDIA) & ~MEDIA_TP, ioaddr + WN4_MEDIA);
1352 outw(SetIntrEnb | 0x0000, ioaddr + EL3_CMD);
1358 el3_up(struct net_device *dev)
1360 int i, sw_info, net_diag;
1361 int ioaddr = dev->base_addr;
1363 /* Activating the board required and does no harm otherwise */
1364 outw(0x0001, ioaddr + 4);
1366 /* Set the IRQ line. */
1367 outw((dev->irq << 12) | 0x0f00, ioaddr + WN0_IRQ);
1369 /* Set the station address in window 2 each time opened. */
1372 for (i = 0; i < 6; i++)
1373 outb(dev->dev_addr[i], ioaddr + i);
1375 if ((dev->if_port & 0x03) == 3) /* BNC interface */
1376 /* Start the thinnet transceiver. We should really wait 50ms...*/
1377 outw(StartCoax, ioaddr + EL3_CMD);
1378 else if ((dev->if_port & 0x03) == 0) { /* 10baseT interface */
1379 /* Combine secondary sw_info word (the adapter level) and primary
1380 sw_info word (duplex setting plus other useless bits) */
1382 sw_info = (read_eeprom(ioaddr, 0x14) & 0x400f) |
1383 (read_eeprom(ioaddr, 0x0d) & 0xBff0);
1386 net_diag = inw(ioaddr + WN4_NETDIAG);
1387 net_diag = (net_diag | FD_ENABLE); /* temporarily assume full-duplex will be set */
1388 printk("%s: ", dev->name);
1389 switch (dev->if_port & 0x0c) {
1391 /* force full-duplex mode if 3c5x9b */
1392 if (sw_info & 0x000f) {
1393 printk("Forcing 3c5x9b full-duplex mode");
1397 /* set full-duplex mode based on eeprom config setting */
1398 if ((sw_info & 0x000f) && (sw_info & 0x8000)) {
1399 printk("Setting 3c5x9b full-duplex mode (from EEPROM configuration bit)");
1403 /* xcvr=(0 || 4) OR user has an old 3c5x9 non "B" model */
1404 printk("Setting 3c5x9/3c5x9B half-duplex mode");
1405 net_diag = (net_diag & ~FD_ENABLE); /* disable full duplex */
1408 outw(net_diag, ioaddr + WN4_NETDIAG);
1409 printk(" if_port: %d, sw_info: %4.4x\n", dev->if_port, sw_info);
1411 printk("%s: 3c5x9 net diag word is now: %4.4x.\n", dev->name, net_diag);
1412 /* Enable link beat and jabber check. */
1413 outw(inw(ioaddr + WN4_MEDIA) | MEDIA_TP, ioaddr + WN4_MEDIA);
1416 /* Switch to the stats window, and clear all stats by reading. */
1417 outw(StatsDisable, ioaddr + EL3_CMD);
1419 for (i = 0; i < 9; i++)
1424 /* Switch to register set 1 for normal use. */
1427 /* Accept b-case and phys addr only. */
1428 outw(SetRxFilter | RxStation | RxBroadcast, ioaddr + EL3_CMD);
1429 outw(StatsEnable, ioaddr + EL3_CMD); /* Turn on statistics. */
1431 outw(RxEnable, ioaddr + EL3_CMD); /* Enable the receiver. */
1432 outw(TxEnable, ioaddr + EL3_CMD); /* Enable transmitter. */
1433 /* Allow status bits to be seen. */
1434 outw(SetStatusEnb | 0xff, ioaddr + EL3_CMD);
1435 /* Ack all pending events, and set active indicator mask. */
1436 outw(AckIntr | IntLatch | TxAvailable | RxEarly | IntReq,
1438 outw(SetIntrEnb | IntLatch|TxAvailable|TxComplete|RxComplete|StatsFull,
1441 netif_start_queue(dev);
1444 /* Power Management support functions */
1448 el3_suspend(struct device *pdev, pm_message_t state)
1450 unsigned long flags;
1451 struct net_device *dev;
1452 struct el3_private *lp;
1455 dev = pdev->driver_data;
1456 lp = netdev_priv(dev);
1457 ioaddr = dev->base_addr;
1459 spin_lock_irqsave(&lp->lock, flags);
1461 if (netif_running(dev))
1462 netif_device_detach(dev);
1465 outw(PowerDown, ioaddr + EL3_CMD);
1467 spin_unlock_irqrestore(&lp->lock, flags);
1472 el3_resume(struct device *pdev)
1474 unsigned long flags;
1475 struct net_device *dev;
1476 struct el3_private *lp;
1479 dev = pdev->driver_data;
1480 lp = netdev_priv(dev);
1481 ioaddr = dev->base_addr;
1483 spin_lock_irqsave(&lp->lock, flags);
1485 outw(PowerUp, ioaddr + EL3_CMD);
1488 if (netif_running(dev))
1489 netif_device_attach(dev);
1491 spin_unlock_irqrestore(&lp->lock, flags);
1495 #endif /* CONFIG_PM */
1497 module_param(debug,int, 0);
1498 module_param_array(irq, int, NULL, 0);
1499 module_param(max_interrupt_work, int, 0);
1500 MODULE_PARM_DESC(debug, "debug level (0-6)");
1501 MODULE_PARM_DESC(irq, "IRQ number(s) (assigned)");
1502 MODULE_PARM_DESC(max_interrupt_work, "maximum events handled per interrupt");
1504 module_param(nopnp, int, 0);
1505 MODULE_PARM_DESC(nopnp, "disable ISA PnP support (0-1)");
1506 #endif /* CONFIG_PNP */
1507 MODULE_DESCRIPTION("3Com Etherlink III (3c509, 3c509B, 3c529, 3c579) ethernet driver");
1508 MODULE_LICENSE("GPL");
1510 static int __init el3_init_module(void)
1519 ret = pnp_register_driver(&el3_pnp_driver);
1524 /* Select an open I/O location at 0x1*0 to do ISA contention select. */
1525 /* Start with 0x110 to avoid some sound cards.*/
1526 for (id_port = 0x110 ; id_port < 0x200; id_port += 0x10) {
1527 if (!request_region(id_port, 1, "3c509-control"))
1529 outb(0x00, id_port);
1530 outb(0xff, id_port);
1531 if (inb(id_port) & 0x01)
1534 release_region(id_port, 1);
1536 if (id_port >= 0x200) {
1538 printk(KERN_ERR "No I/O port available for 3c509 activation.\n");
1540 ret = isa_register_driver(&el3_isa_driver, EL3_MAX_CARDS);
1545 ret = eisa_driver_register(&el3_eisa_driver);
1547 eisa_registered = 1;
1550 ret = mca_register_driver(&el3_mca_driver);
1562 if (eisa_registered)
1572 static void __exit el3_cleanup_module(void)
1576 pnp_unregister_driver(&el3_pnp_driver);
1579 isa_unregister_driver(&el3_isa_driver);
1581 release_region(id_port, 1);
1583 if (eisa_registered)
1584 eisa_driver_unregister(&el3_eisa_driver);
1588 mca_unregister_driver(&el3_mca_driver);
1592 module_init (el3_init_module);
1593 module_exit (el3_cleanup_module);