2 net-3-driver for the 3c523 Etherlink/MC card (i82586 Ethernet chip)
5 This is an extension to the Linux operating system, and is covered by the
6 same GNU General Public License that covers that work.
8 Copyright 1995, 1996 by Chris Beauregard (cpbeaure@undergrad.math.uwaterloo.ca)
10 This is basically Michael Hipp's ni52 driver, with a new probing
11 algorithm and some minor changes to the 82586 CA and reset routines.
12 Thanks a lot Michael for a really clean i82586 implementation! Unless
13 otherwise documented in ni52.c, any bugs are mine.
15 Contrary to the Ethernet-HOWTO, this isn't based on the 3c507 driver in
16 any way. The ni52 is a lot easier to modify.
21 Crynwr packet driver collection was a great reference for my first
22 attempt at this sucker. The 3c507 driver also helped, until I noticed
23 that ni52.c was a lot nicer.
25 EtherLink/MC: Micro Channel Ethernet Adapter Technical Reference
26 Manual, courtesy of 3Com CardFacts, documents the 3c523-specific
27 stuff. Information on CardFacts is found in the Ethernet HOWTO.
28 Also see <a href="http://www.3com.com/">
30 Microprocessor Communications Support Chips, T.J. Byers, ISBN
31 0-444-01224-9, has a section on the i82586. It tells you just enough
32 to know that you really don't want to learn how to program the chip.
34 The original device probe code was stolen from ps2esdi.c
37 Since most of the code was stolen from ni52.c, you'll run across the
38 same bugs in the 0.62 version of ni52.c, plus maybe a few because of
39 the 3c523 idiosynchacies. The 3c523 has 16K of RAM though, so there
40 shouldn't be the overrun problem that the 8K ni52 has.
42 This driver is for a 16K adapter. It should work fine on the 64K
43 adapters, but it will only use one of the 4 banks of RAM. Modifying
44 this for the 64K version would require a lot of heinous bank
45 switching, which I'm sure not interested in doing. If you try to
46 implement a bank switching version, you'll basically have to remember
47 what bank is enabled and do a switch everytime you access a memory
48 location that's not current. You'll also have to remap pointers on
49 the driver side, because it only knows about 16K of the memory.
50 Anyone desperate or masochistic enough to try?
52 It seems to be stable now when multiple transmit buffers are used. I
53 can't see any performance difference, but then I'm working on a 386SX.
55 Multicast doesn't work. It doesn't even pretend to work. Don't use
56 it. Don't compile your kernel with multicast support. I don't know
60 This driver is useable as a loadable module. If you try to specify an
61 IRQ or a IO address (via insmod 3c523.o irq=xx io=0xyyy), it will
62 search the MCA slots until it finds a 3c523 with the specified
65 This driver does support multiple ethernet cards when used as a module
66 (up to MAX_3C523_CARDS, the default being 4)
68 This has been tested with both BNC and TP versions, internal and
69 external transceivers. Haven't tested with the 64K version (that I
76 update to 1.3.59, incorporated multicast diffs from ni52.c
78 added shared irq support
80 added support for multiple cards when used as a module
81 added option to disable multicast as is causes problems
82 Ganesh Sittampalam <ganesh.sittampalam@magdalen.oxford.ac.uk>
83 Stuart Adamson <stuart.adamson@compsoc.net>
85 added support for ethtool (jgarzik)
87 $Header: /fsys2/home/chrisb/linux-1.3.59-MCA/drivers/net/RCS/3c523.c,v 1.1 1996/02/05 01:53:46 chrisb Exp chrisb $
90 #define DRV_NAME "3c523"
91 #define DRV_VERSION "17-Nov-2001"
93 #include <linux/init.h>
94 #include <linux/netdevice.h>
95 #include <linux/etherdevice.h>
96 #include <linux/module.h>
97 #include <linux/kernel.h>
98 #include <linux/string.h>
99 #include <linux/errno.h>
100 #include <linux/ioport.h>
101 #include <linux/skbuff.h>
102 #include <linux/slab.h>
103 #include <linux/interrupt.h>
104 #include <linux/delay.h>
105 #include <linux/mca-legacy.h>
106 #include <linux/ethtool.h>
107 #include <linux/bitops.h>
108 #include <linux/jiffies.h>
110 #include <asm/uaccess.h>
111 #include <asm/processor.h>
116 /*************************************************************************/
117 #define DEBUG /* debug on */
118 #define SYSBUSVAL 0 /* 1 = 8 Bit, 0 = 16 bit - 3c523 only does 16 bit */
119 #undef ELMC_MULTICAST /* Disable multicast support as it is somewhat seriously broken at the moment */
121 #define make32(ptr16) (p->memtop + (short) (ptr16) )
122 #define make24(ptr32) ((char *) (ptr32) - p->base)
123 #define make16(ptr32) ((unsigned short) ((unsigned long) (ptr32) - (unsigned long) p->memtop ))
125 /*************************************************************************/
127 Tables to which we can map values in the configuration registers.
129 static int irq_table[] __initdata = {
133 static int csr_table[] __initdata = {
134 0x300, 0x1300, 0x2300, 0x3300
137 static int shm_table[] __initdata = {
138 0x0c0000, 0x0c8000, 0x0d0000, 0x0d8000
141 /******************* how to calculate the buffers *****************************
144 * IMPORTANT NOTE: if you configure only one NUM_XMIT_BUFFS, the driver works
145 * --------------- in a different (more stable?) mode. Only in this mode it's
146 * possible to configure the driver with 'NO_NOPCOMMANDS'
148 sizeof(scp)=12; sizeof(scb)=16; sizeof(iscp)=8;
149 sizeof(scp)+sizeof(iscp)+sizeof(scb) = 36 = INIT
150 sizeof(rfd) = 24; sizeof(rbd) = 12;
151 sizeof(tbd) = 8; sizeof(transmit_cmd) = 16;
154 * if you don't know the driver, better do not change this values: */
156 #define RECV_BUFF_SIZE 1524 /* slightly oversized */
157 #define XMIT_BUFF_SIZE 1524 /* slightly oversized */
158 #define NUM_XMIT_BUFFS 1 /* config for both, 8K and 16K shmem */
159 #define NUM_RECV_BUFFS_8 4 /* config for 8K shared mem */
160 #define NUM_RECV_BUFFS_16 9 /* config for 16K shared mem */
162 #if (NUM_XMIT_BUFFS == 1)
163 #define NO_NOPCOMMANDS /* only possible with NUM_XMIT_BUFFS=1 */
166 /**************************************************************************/
168 #define DELAY(x) { mdelay(32 * x); }
170 /* a much shorter delay: */
171 #define DELAY_16(); { udelay(16) ; }
173 /* wait for command with timeout: */
174 #define WAIT_4_SCB_CMD() { int i; \
175 for(i=0;i<1024;i++) { \
176 if(!p->scb->cmd) break; \
179 printk(KERN_WARNING "%s:%d: scb_cmd timed out .. resetting i82586\n",\
180 dev->name,__LINE__); \
181 elmc_id_reset586(); } } }
183 static irqreturn_t elmc_interrupt(int irq, void *dev_id, struct pt_regs *reg_ptr);
184 static int elmc_open(struct net_device *dev);
185 static int elmc_close(struct net_device *dev);
186 static int elmc_send_packet(struct sk_buff *, struct net_device *);
187 static struct net_device_stats *elmc_get_stats(struct net_device *dev);
188 static void elmc_timeout(struct net_device *dev);
189 #ifdef ELMC_MULTICAST
190 static void set_multicast_list(struct net_device *dev);
192 static struct ethtool_ops netdev_ethtool_ops;
194 /* helper-functions */
195 static int init586(struct net_device *dev);
196 static int check586(struct net_device *dev, unsigned long where, unsigned size);
197 static void alloc586(struct net_device *dev);
198 static void startrecv586(struct net_device *dev);
199 static void *alloc_rfa(struct net_device *dev, void *ptr);
200 static void elmc_rcv_int(struct net_device *dev);
201 static void elmc_xmt_int(struct net_device *dev);
202 static void elmc_rnr_int(struct net_device *dev);
205 struct net_device_stats stats;
208 unsigned long mapped_start; /* Start of ioremap */
209 volatile struct rfd_struct *rfd_last, *rfd_top, *rfd_first;
210 volatile struct scp_struct *scp; /* volatile is important */
211 volatile struct iscp_struct *iscp; /* volatile is important */
212 volatile struct scb_struct *scb; /* volatile is important */
213 volatile struct tbd_struct *xmit_buffs[NUM_XMIT_BUFFS];
214 #if (NUM_XMIT_BUFFS == 1)
215 volatile struct transmit_cmd_struct *xmit_cmds[2];
216 volatile struct nop_cmd_struct *nop_cmds[2];
218 volatile struct transmit_cmd_struct *xmit_cmds[NUM_XMIT_BUFFS];
219 volatile struct nop_cmd_struct *nop_cmds[NUM_XMIT_BUFFS];
221 volatile int nop_point, num_recv_buffs;
222 volatile char *xmit_cbuffs[NUM_XMIT_BUFFS];
223 volatile int xmit_count, xmit_last;
227 #define elmc_attn586() {elmc_do_attn586(dev->base_addr,ELMC_CTRL_INTE);}
228 #define elmc_reset586() {elmc_do_reset586(dev->base_addr,ELMC_CTRL_INTE);}
230 /* with interrupts disabled - this will clear the interrupt bit in the
231 3c523 control register, and won't put it back. This effectively
232 disables interrupts on the card. */
233 #define elmc_id_attn586() {elmc_do_attn586(dev->base_addr,0);}
234 #define elmc_id_reset586() {elmc_do_reset586(dev->base_addr,0);}
236 /*************************************************************************/
238 Do a Channel Attention on the 3c523. This is extremely board dependent.
240 static void elmc_do_attn586(int ioaddr, int ints)
242 /* the 3c523 requires a minimum of 500 ns. The delays here might be
243 a little too large, and hence they may cut the performance of the
244 card slightly. If someone who knows a little more about Linux
245 timing would care to play with these, I'd appreciate it. */
247 /* this bit masking stuff is crap. I'd rather have separate
248 registers with strobe triggers for each of these functions. <sigh>
249 Ya take what ya got. */
251 outb(ELMC_CTRL_RST | 0x3 | ELMC_CTRL_CA | ints, ioaddr + ELMC_CTRL);
252 DELAY_16(); /* > 500 ns */
253 outb(ELMC_CTRL_RST | 0x3 | ints, ioaddr + ELMC_CTRL);
256 /*************************************************************************/
258 Reset the 82586 on the 3c523. Also very board dependent.
260 static void elmc_do_reset586(int ioaddr, int ints)
262 /* toggle the RST bit low then high */
263 outb(0x3 | ELMC_CTRL_LBK, ioaddr + ELMC_CTRL);
264 DELAY_16(); /* > 500 ns */
265 outb(ELMC_CTRL_RST | ELMC_CTRL_LBK | 0x3, ioaddr + ELMC_CTRL);
267 elmc_do_attn586(ioaddr, ints);
270 /**********************************************
274 static int elmc_close(struct net_device *dev)
276 netif_stop_queue(dev);
277 elmc_id_reset586(); /* the hard way to stop the receiver */
278 free_irq(dev->irq, dev);
282 /**********************************************
286 static int elmc_open(struct net_device *dev)
290 elmc_id_attn586(); /* disable interrupts */
292 ret = request_irq(dev->irq, &elmc_interrupt, SA_SHIRQ | SA_SAMPLE_RANDOM,
295 printk(KERN_ERR "%s: couldn't get irq %d\n", dev->name, dev->irq);
302 netif_start_queue(dev);
303 return 0; /* most done by init */
306 /**********************************************
307 * Check to see if there's an 82586 out there.
310 static int __init check586(struct net_device *dev, unsigned long where, unsigned size)
312 struct priv *p = (struct priv *) dev->priv;
316 p->base = (unsigned long) isa_bus_to_virt((unsigned long)where) + size - 0x01000000;
317 p->memtop = isa_bus_to_virt((unsigned long)where) + size;
318 p->scp = (struct scp_struct *)(p->base + SCP_DEFAULT_ADDRESS);
319 memset((char *) p->scp, 0, sizeof(struct scp_struct));
320 p->scp->sysbus = SYSBUSVAL; /* 1 = 8Bit-Bus, 0 = 16 Bit */
322 iscp_addrs[0] = isa_bus_to_virt((unsigned long)where);
323 iscp_addrs[1] = (char *) p->scp - sizeof(struct iscp_struct);
325 for (i = 0; i < 2; i++) {
326 p->iscp = (struct iscp_struct *) iscp_addrs[i];
327 memset((char *) p->iscp, 0, sizeof(struct iscp_struct));
329 p->scp->iscp = make24(p->iscp);
334 /* reset586 does an implicit CA */
336 /* apparently, you sometimes have to kick the 82586 twice... */
340 if (p->iscp->busy) { /* i82586 clears 'busy' after successful init */
347 /******************************************************************
348 * set iscp at the right place, called by elmc_probe and open586.
351 void alloc586(struct net_device *dev)
353 struct priv *p = (struct priv *) dev->priv;
358 p->scp = (struct scp_struct *) (p->base + SCP_DEFAULT_ADDRESS);
359 p->scb = (struct scb_struct *) isa_bus_to_virt(dev->mem_start);
360 p->iscp = (struct iscp_struct *) ((char *) p->scp - sizeof(struct iscp_struct));
362 memset((char *) p->iscp, 0, sizeof(struct iscp_struct));
363 memset((char *) p->scp, 0, sizeof(struct scp_struct));
365 p->scp->iscp = make24(p->iscp);
366 p->scp->sysbus = SYSBUSVAL;
367 p->iscp->scb_offset = make16(p->scb);
376 printk(KERN_ERR "%s: Init-Problems (alloc).\n", dev->name);
378 memset((char *) p->scb, 0, sizeof(struct scb_struct));
381 /*****************************************************************/
383 static int elmc_getinfo(char *buf, int slot, void *d)
386 struct net_device *dev = (struct net_device *) d;
392 len += sprintf(buf + len, "Revision: 0x%x\n",
393 inb(dev->base_addr + ELMC_REVISION) & 0xf);
394 len += sprintf(buf + len, "IRQ: %d\n", dev->irq);
395 len += sprintf(buf + len, "IO Address: %#lx-%#lx\n", dev->base_addr,
396 dev->base_addr + ELMC_IO_EXTENT);
397 len += sprintf(buf + len, "Memory: %#lx-%#lx\n", dev->mem_start,
399 len += sprintf(buf + len, "Transceiver: %s\n", dev->if_port ?
400 "External" : "Internal");
401 len += sprintf(buf + len, "Device: %s\n", dev->name);
402 len += sprintf(buf + len, "Hardware Address:");
403 for (i = 0; i < 6; i++) {
404 len += sprintf(buf + len, " %02x", dev->dev_addr[i]);
410 } /* elmc_getinfo() */
412 /*****************************************************************/
414 static int __init do_elmc_probe(struct net_device *dev)
417 int base_addr = dev->base_addr;
422 unsigned int size = 0;
424 struct priv *pr = dev->priv;
426 SET_MODULE_OWNER(dev);
430 /* search through the slots for the 3c523. */
431 slot = mca_find_adapter(ELMC_MCA_ID, 0);
433 status = mca_read_stored_pos(slot, 2);
435 dev->irq=irq_table[(status & ELMC_STATUS_IRQ_SELECT) >> 6];
436 dev->base_addr=csr_table[(status & ELMC_STATUS_CSR_SELECT) >> 1];
439 If we're trying to match a specified irq or IO address,
440 we'll reject a match unless it's what we're looking for.
441 Also reject it if the card is already in use.
444 if ((irq && irq != dev->irq) ||
445 (base_addr && base_addr != dev->base_addr)) {
446 slot = mca_find_adapter(ELMC_MCA_ID, slot + 1);
449 if (!request_region(dev->base_addr, ELMC_IO_EXTENT, DRV_NAME)) {
450 slot = mca_find_adapter(ELMC_MCA_ID, slot + 1);
454 /* found what we're looking for... */
458 /* we didn't find any 3c523 in the slots we checked for */
459 if (slot == MCA_NOTFOUND)
460 return ((base_addr || irq) ? -ENXIO : -ENODEV);
462 mca_set_adapter_name(slot, "3Com 3c523 Etherlink/MC");
463 mca_set_adapter_procfn(slot, (MCA_ProcFn) elmc_getinfo, dev);
465 /* if we get this far, adapter has been found - carry on */
466 printk(KERN_INFO "%s: 3c523 adapter found in slot %d\n", dev->name, slot + 1);
468 /* Now we extract configuration info from the card.
469 The 3c523 provides information in two of the POS registers, but
470 the second one is only needed if we want to tell the card what IRQ
471 to use. I suspect that whoever sets the thing up initially would
472 prefer we don't screw with those things.
474 Note that we read the status info when we found the card...
476 See 3c523.h for more details.
479 /* revision is stored in the first 4 bits of the revision register */
480 revision = inb(dev->base_addr + ELMC_REVISION) & 0xf;
482 /* according to docs, we read the interrupt and write it back to
483 the IRQ select register, since the POST might not configure the IRQ
487 mca_write_pos(slot, 3, 0x04);
490 mca_write_pos(slot, 3, 0x02);
493 mca_write_pos(slot, 3, 0x08);
496 mca_write_pos(slot, 3, 0x01);
500 memset(pr, 0, sizeof(struct priv));
503 printk(KERN_INFO "%s: 3Com 3c523 Rev 0x%x at %#lx\n", dev->name, (int) revision,
506 /* Determine if we're using the on-board transceiver (i.e. coax) or
507 an external one. The information is pretty much useless, but I
508 guess it's worth brownie points. */
509 dev->if_port = (status & ELMC_STATUS_DISABLE_THIN);
511 /* The 3c523 has a 24K chunk of memory. The first 16K is the
512 shared memory, while the last 8K is for the EtherStart BIOS ROM.
513 Which we don't care much about here. We'll just tell Linux that
514 we're using 16K. MCA won't permit address space conflicts caused
515 by not mapping the other 8K. */
516 dev->mem_start = shm_table[(status & ELMC_STATUS_MEMORY_SELECT) >> 3];
518 /* We're using MCA, so it's a given that the information about memory
519 size is correct. The Crynwr drivers do something like this. */
521 elmc_id_reset586(); /* seems like a good idea before checking it... */
523 size = 0x4000; /* check for 16K mem */
524 if (!check586(dev, dev->mem_start, size)) {
525 printk(KERN_ERR "%s: memprobe, Can't find memory at 0x%lx!\n", dev->name,
530 dev->mem_end = dev->mem_start + size; /* set mem_end showed by 'ifconfig' */
532 pr->memtop = isa_bus_to_virt(dev->mem_start) + size;
533 pr->base = (unsigned long) isa_bus_to_virt(dev->mem_start) + size - 0x01000000;
536 elmc_id_reset586(); /* make sure it doesn't generate spurious ints */
538 /* set number of receive-buffs according to memsize */
539 pr->num_recv_buffs = NUM_RECV_BUFFS_16;
541 /* dump all the assorted information */
542 printk(KERN_INFO "%s: IRQ %d, %sternal xcvr, memory %#lx-%#lx.\n", dev->name,
543 dev->irq, dev->if_port ? "ex" : "in",
544 dev->mem_start, dev->mem_end - 1);
546 /* The hardware address for the 3c523 is stored in the first six
547 bytes of the IO address. */
548 printk(KERN_INFO "%s: hardware address ", dev->name);
549 for (i = 0; i < 6; i++) {
550 dev->dev_addr[i] = inb(dev->base_addr + i);
551 printk(" %02x", dev->dev_addr[i]);
555 dev->open = &elmc_open;
556 dev->stop = &elmc_close;
557 dev->get_stats = &elmc_get_stats;
558 dev->hard_start_xmit = &elmc_send_packet;
559 dev->tx_timeout = &elmc_timeout;
560 dev->watchdog_timeo = HZ;
561 #ifdef ELMC_MULTICAST
562 dev->set_multicast_list = &set_multicast_list;
564 dev->set_multicast_list = NULL;
566 dev->ethtool_ops = &netdev_ethtool_ops;
568 /* note that we haven't actually requested the IRQ from the kernel.
569 That gets done in elmc_open(). I'm not sure that's such a good idea,
570 but it works, so I'll go with it. */
572 #ifndef ELMC_MULTICAST
573 dev->flags&=~IFF_MULTICAST; /* Multicast doesn't work */
576 retval = register_netdev(dev);
582 mca_set_adapter_procfn(slot, NULL, NULL);
583 release_region(dev->base_addr, ELMC_IO_EXTENT);
587 static void cleanup_card(struct net_device *dev)
589 mca_set_adapter_procfn(((struct priv *) (dev->priv))->slot, NULL, NULL);
590 release_region(dev->base_addr, ELMC_IO_EXTENT);
594 struct net_device * __init elmc_probe(int unit)
596 struct net_device *dev = alloc_etherdev(sizeof(struct priv));
600 return ERR_PTR(-ENOMEM);
602 sprintf(dev->name, "eth%d", unit);
603 netdev_boot_setup_check(dev);
605 err = do_elmc_probe(dev);
615 /**********************************************
616 * init the chip (elmc-interrupt should be disabled?!)
617 * needs a correct 'allocated' memory
620 static int init586(struct net_device *dev)
625 struct priv *p = (struct priv *) dev->priv;
626 volatile struct configure_cmd_struct *cfg_cmd;
627 volatile struct iasetup_cmd_struct *ias_cmd;
628 volatile struct tdr_cmd_struct *tdr_cmd;
629 volatile struct mcsetup_cmd_struct *mc_cmd;
630 struct dev_mc_list *dmi = dev->mc_list;
631 int num_addrs = dev->mc_count;
633 ptr = (void *) ((char *) p->scb + sizeof(struct scb_struct));
635 cfg_cmd = (struct configure_cmd_struct *) ptr; /* configure-command */
636 cfg_cmd->cmd_status = 0;
637 cfg_cmd->cmd_cmd = CMD_CONFIGURE | CMD_LAST;
638 cfg_cmd->cmd_link = 0xffff;
640 cfg_cmd->byte_cnt = 0x0a; /* number of cfg bytes */
641 cfg_cmd->fifo = 0x08; /* fifo-limit (8=tx:32/rx:64) */
642 cfg_cmd->sav_bf = 0x40; /* hold or discard bad recv frames (bit 7) */
643 cfg_cmd->adr_len = 0x2e; /* addr_len |!src_insert |pre-len |loopback */
644 cfg_cmd->priority = 0x00;
646 cfg_cmd->time_low = 0x00;
647 cfg_cmd->time_high = 0xf2;
648 cfg_cmd->promisc = 0;
649 if (dev->flags & (IFF_ALLMULTI | IFF_PROMISC)) {
650 cfg_cmd->promisc = 1;
651 dev->flags |= IFF_PROMISC;
653 cfg_cmd->carr_coll = 0x00;
655 p->scb->cbl_offset = make16(cfg_cmd);
657 p->scb->cmd = CUC_START; /* cmd.-unit start */
660 s = jiffies; /* warning: only active with interrupts on !! */
661 while (!(cfg_cmd->cmd_status & STAT_COMPL)) {
662 if (time_after(jiffies, s + 30*HZ/100))
666 if ((cfg_cmd->cmd_status & (STAT_OK | STAT_COMPL)) != (STAT_COMPL | STAT_OK)) {
667 printk(KERN_WARNING "%s (elmc): configure command failed: %x\n", dev->name, cfg_cmd->cmd_status);
671 * individual address setup
673 ias_cmd = (struct iasetup_cmd_struct *) ptr;
675 ias_cmd->cmd_status = 0;
676 ias_cmd->cmd_cmd = CMD_IASETUP | CMD_LAST;
677 ias_cmd->cmd_link = 0xffff;
679 memcpy((char *) &ias_cmd->iaddr, (char *) dev->dev_addr, ETH_ALEN);
681 p->scb->cbl_offset = make16(ias_cmd);
683 p->scb->cmd = CUC_START; /* cmd.-unit start */
687 while (!(ias_cmd->cmd_status & STAT_COMPL)) {
688 if (time_after(jiffies, s + 30*HZ/100))
692 if ((ias_cmd->cmd_status & (STAT_OK | STAT_COMPL)) != (STAT_OK | STAT_COMPL)) {
693 printk(KERN_WARNING "%s (elmc): individual address setup command failed: %04x\n", dev->name, ias_cmd->cmd_status);
697 * TDR, wire check .. e.g. no resistor e.t.c
699 tdr_cmd = (struct tdr_cmd_struct *) ptr;
701 tdr_cmd->cmd_status = 0;
702 tdr_cmd->cmd_cmd = CMD_TDR | CMD_LAST;
703 tdr_cmd->cmd_link = 0xffff;
706 p->scb->cbl_offset = make16(tdr_cmd);
708 p->scb->cmd = CUC_START; /* cmd.-unit start */
712 while (!(tdr_cmd->cmd_status & STAT_COMPL)) {
713 if (time_after(jiffies, s + 30*HZ/100)) {
714 printk(KERN_WARNING "%s: %d Problems while running the TDR.\n", dev->name, __LINE__);
721 DELAY(2); /* wait for result */
722 result = tdr_cmd->status;
724 p->scb->cmd = p->scb->status & STAT_MASK;
725 elmc_id_attn586(); /* ack the interrupts */
727 if (result & TDR_LNK_OK) {
729 } else if (result & TDR_XCVR_PRB) {
730 printk(KERN_WARNING "%s: TDR: Transceiver problem!\n", dev->name);
731 } else if (result & TDR_ET_OPN) {
732 printk(KERN_WARNING "%s: TDR: No correct termination %d clocks away.\n", dev->name, result & TDR_TIMEMASK);
733 } else if (result & TDR_ET_SRT) {
734 if (result & TDR_TIMEMASK) /* time == 0 -> strange :-) */
735 printk(KERN_WARNING "%s: TDR: Detected a short circuit %d clocks away.\n", dev->name, result & TDR_TIMEMASK);
737 printk(KERN_WARNING "%s: TDR: Unknown status %04x\n", dev->name, result);
743 p->scb->cmd = p->scb->status & STAT_MASK;
747 * alloc nop/xmit-cmds
749 #if (NUM_XMIT_BUFFS == 1)
750 for (i = 0; i < 2; i++) {
751 p->nop_cmds[i] = (struct nop_cmd_struct *) ptr;
752 p->nop_cmds[i]->cmd_cmd = CMD_NOP;
753 p->nop_cmds[i]->cmd_status = 0;
754 p->nop_cmds[i]->cmd_link = make16((p->nop_cmds[i]));
755 ptr = (char *) ptr + sizeof(struct nop_cmd_struct);
757 p->xmit_cmds[0] = (struct transmit_cmd_struct *) ptr; /* transmit cmd/buff 0 */
758 ptr = (char *) ptr + sizeof(struct transmit_cmd_struct);
760 for (i = 0; i < NUM_XMIT_BUFFS; i++) {
761 p->nop_cmds[i] = (struct nop_cmd_struct *) ptr;
762 p->nop_cmds[i]->cmd_cmd = CMD_NOP;
763 p->nop_cmds[i]->cmd_status = 0;
764 p->nop_cmds[i]->cmd_link = make16((p->nop_cmds[i]));
765 ptr = (char *) ptr + sizeof(struct nop_cmd_struct);
766 p->xmit_cmds[i] = (struct transmit_cmd_struct *) ptr; /*transmit cmd/buff 0 */
767 ptr = (char *) ptr + sizeof(struct transmit_cmd_struct);
771 ptr = alloc_rfa(dev, (void *) ptr); /* init receive-frame-area */
778 /* I don't understand this: do we really need memory after the init? */
779 int len = ((char *) p->iscp - (char *) ptr - 8) / 6;
781 printk(KERN_ERR "%s: Ooooops, no memory for MC-Setup!\n", dev->name);
783 if (len < num_addrs) {
785 printk(KERN_WARNING "%s: Sorry, can only apply %d MC-Address(es).\n",
786 dev->name, num_addrs);
788 mc_cmd = (struct mcsetup_cmd_struct *) ptr;
789 mc_cmd->cmd_status = 0;
790 mc_cmd->cmd_cmd = CMD_MCSETUP | CMD_LAST;
791 mc_cmd->cmd_link = 0xffff;
792 mc_cmd->mc_cnt = num_addrs * 6;
793 for (i = 0; i < num_addrs; i++) {
794 memcpy((char *) mc_cmd->mc_list[i], dmi->dmi_addr, 6);
797 p->scb->cbl_offset = make16(mc_cmd);
798 p->scb->cmd = CUC_START;
801 while (!(mc_cmd->cmd_status & STAT_COMPL)) {
802 if (time_after(jiffies, s + 30*HZ/100))
805 if (!(mc_cmd->cmd_status & STAT_COMPL)) {
806 printk(KERN_WARNING "%s: Can't apply multicast-address-list.\n", dev->name);
811 * alloc xmit-buffs / init xmit_cmds
813 for (i = 0; i < NUM_XMIT_BUFFS; i++) {
814 p->xmit_cbuffs[i] = (char *) ptr; /* char-buffs */
815 ptr = (char *) ptr + XMIT_BUFF_SIZE;
816 p->xmit_buffs[i] = (struct tbd_struct *) ptr; /* TBD */
817 ptr = (char *) ptr + sizeof(struct tbd_struct);
818 if ((void *) ptr > (void *) p->iscp) {
819 printk(KERN_ERR "%s: not enough shared-mem for your configuration!\n", dev->name);
822 memset((char *) (p->xmit_cmds[i]), 0, sizeof(struct transmit_cmd_struct));
823 memset((char *) (p->xmit_buffs[i]), 0, sizeof(struct tbd_struct));
824 p->xmit_cmds[i]->cmd_status = STAT_COMPL;
825 p->xmit_cmds[i]->cmd_cmd = CMD_XMIT | CMD_INT;
826 p->xmit_cmds[i]->tbd_offset = make16((p->xmit_buffs[i]));
827 p->xmit_buffs[i]->next = 0xffff;
828 p->xmit_buffs[i]->buffer = make24((p->xmit_cbuffs[i]));
833 #ifndef NO_NOPCOMMANDS
838 * 'start transmitter' (nop-loop)
840 #ifndef NO_NOPCOMMANDS
841 p->scb->cbl_offset = make16(p->nop_cmds[0]);
842 p->scb->cmd = CUC_START;
846 p->xmit_cmds[0]->cmd_link = 0xffff;
847 p->xmit_cmds[0]->cmd_cmd = CMD_XMIT | CMD_LAST | CMD_INT;
853 /******************************************************
854 * This is a helper routine for elmc_rnr_int() and init586().
855 * It sets up the Receive Frame Area (RFA).
858 static void *alloc_rfa(struct net_device *dev, void *ptr)
860 volatile struct rfd_struct *rfd = (struct rfd_struct *) ptr;
861 volatile struct rbd_struct *rbd;
863 struct priv *p = (struct priv *) dev->priv;
865 memset((char *) rfd, 0, sizeof(struct rfd_struct) * p->num_recv_buffs);
868 for (i = 0; i < p->num_recv_buffs; i++) {
869 rfd[i].next = make16(rfd + (i + 1) % p->num_recv_buffs);
871 rfd[p->num_recv_buffs - 1].last = RFD_SUSP; /* RU suspend */
873 ptr = (void *) (rfd + p->num_recv_buffs);
875 rbd = (struct rbd_struct *) ptr;
876 ptr = (void *) (rbd + p->num_recv_buffs);
878 /* clr descriptors */
879 memset((char *) rbd, 0, sizeof(struct rbd_struct) * p->num_recv_buffs);
881 for (i = 0; i < p->num_recv_buffs; i++) {
882 rbd[i].next = make16((rbd + (i + 1) % p->num_recv_buffs));
883 rbd[i].size = RECV_BUFF_SIZE;
884 rbd[i].buffer = make24(ptr);
885 ptr = (char *) ptr + RECV_BUFF_SIZE;
888 p->rfd_top = p->rfd_first;
889 p->rfd_last = p->rfd_first + p->num_recv_buffs - 1;
891 p->scb->rfa_offset = make16(p->rfd_first);
892 p->rfd_first->rbd_offset = make16(rbd);
898 /**************************************************
899 * Interrupt Handler ...
903 elmc_interrupt(int irq, void *dev_id, struct pt_regs *reg_ptr)
905 struct net_device *dev = (struct net_device *) dev_id;
910 printk(KERN_ERR "elmc-interrupt: irq %d for unknown device.\n", (int) -(((struct pt_regs *) reg_ptr)->orig_eax + 2));
912 } else if (!netif_running(dev)) {
913 /* The 3c523 has this habit of generating interrupts during the
914 reset. I'm not sure if the ni52 has this same problem, but it's
915 really annoying if we haven't finished initializing it. I was
916 hoping all the elmc_id_* commands would disable this, but I
917 might have missed a few. */
919 elmc_id_attn586(); /* ack inter. and disable any more */
921 } else if (!(ELMC_CTRL_INT & inb(dev->base_addr + ELMC_CTRL))) {
922 /* wasn't this device */
925 /* reading ELMC_CTRL also clears the INT bit. */
927 p = (struct priv *) dev->priv;
929 while ((stat = p->scb->status & STAT_MASK))
932 elmc_attn586(); /* ack inter. */
934 if (stat & STAT_CX) {
935 /* command with I-bit set complete */
938 if (stat & STAT_FR) {
939 /* received a frame */
942 #ifndef NO_NOPCOMMANDS
943 if (stat & STAT_CNA) {
944 /* CU went 'not ready' */
945 if (netif_running(dev)) {
946 printk(KERN_WARNING "%s: oops! CU has left active state. stat: %04x/%04x.\n", dev->name, (int) stat, (int) p->scb->status);
951 if (stat & STAT_RNR) {
952 /* RU went 'not ready' */
954 if (p->scb->status & RU_SUSPEND) {
955 /* special case: RU_SUSPEND */
958 p->scb->cmd = RUC_RESUME;
961 printk(KERN_WARNING "%s: Receiver-Unit went 'NOT READY': %04x/%04x.\n", dev->name, (int) stat, (int) p->scb->status);
965 WAIT_4_SCB_CMD(); /* wait for ack. (elmc_xmt_int can be faster than ack!!) */
966 if (p->scb->cmd) { /* timed out? */
973 /*******************************************************
977 static void elmc_rcv_int(struct net_device *dev)
980 unsigned short totlen;
982 struct rbd_struct *rbd;
983 struct priv *p = (struct priv *) dev->priv;
985 for (; (status = p->rfd_top->status) & STAT_COMPL;) {
986 rbd = (struct rbd_struct *) make32(p->rfd_top->rbd_offset);
988 if (status & STAT_OK) { /* frame received without error? */
989 if ((totlen = rbd->status) & RBD_LAST) { /* the first and the last buffer? */
990 totlen &= RBD_MASK; /* length of this frame */
992 skb = (struct sk_buff *) dev_alloc_skb(totlen + 2);
995 skb_reserve(skb, 2); /* 16 byte alignment */
997 eth_copy_and_sum(skb, (char *) p->base+(unsigned long) rbd->buffer,totlen,0);
998 skb->protocol = eth_type_trans(skb, dev);
1000 dev->last_rx = jiffies;
1001 p->stats.rx_packets++;
1002 p->stats.rx_bytes += totlen;
1004 p->stats.rx_dropped++;
1007 printk(KERN_WARNING "%s: received oversized frame.\n", dev->name);
1008 p->stats.rx_dropped++;
1010 } else { /* frame !(ok), only with 'save-bad-frames' */
1011 printk(KERN_WARNING "%s: oops! rfd-error-status: %04x\n", dev->name, status);
1012 p->stats.rx_errors++;
1014 p->rfd_top->status = 0;
1015 p->rfd_top->last = RFD_SUSP;
1016 p->rfd_last->last = 0; /* delete RU_SUSP */
1017 p->rfd_last = p->rfd_top;
1018 p->rfd_top = (struct rfd_struct *) make32(p->rfd_top->next); /* step to next RFD */
1022 /**********************************************************
1023 * handle 'Receiver went not ready'.
1026 static void elmc_rnr_int(struct net_device *dev)
1028 struct priv *p = (struct priv *) dev->priv;
1030 p->stats.rx_errors++;
1032 WAIT_4_SCB_CMD(); /* wait for the last cmd */
1033 p->scb->cmd = RUC_ABORT; /* usually the RU is in the 'no resource'-state .. abort it now. */
1035 WAIT_4_SCB_CMD(); /* wait for accept cmd. */
1037 alloc_rfa(dev, (char *) p->rfd_first);
1038 startrecv586(dev); /* restart RU */
1040 printk(KERN_WARNING "%s: Receive-Unit restarted. Status: %04x\n", dev->name, p->scb->status);
1044 /**********************************************************
1045 * handle xmit - interrupt
1048 static void elmc_xmt_int(struct net_device *dev)
1051 struct priv *p = (struct priv *) dev->priv;
1053 status = p->xmit_cmds[p->xmit_last]->cmd_status;
1054 if (!(status & STAT_COMPL)) {
1055 printk(KERN_WARNING "%s: strange .. xmit-int without a 'COMPLETE'\n", dev->name);
1057 if (status & STAT_OK) {
1058 p->stats.tx_packets++;
1059 p->stats.collisions += (status & TCMD_MAXCOLLMASK);
1061 p->stats.tx_errors++;
1062 if (status & TCMD_LATECOLL) {
1063 printk(KERN_WARNING "%s: late collision detected.\n", dev->name);
1064 p->stats.collisions++;
1065 } else if (status & TCMD_NOCARRIER) {
1066 p->stats.tx_carrier_errors++;
1067 printk(KERN_WARNING "%s: no carrier detected.\n", dev->name);
1068 } else if (status & TCMD_LOSTCTS) {
1069 printk(KERN_WARNING "%s: loss of CTS detected.\n", dev->name);
1070 } else if (status & TCMD_UNDERRUN) {
1071 p->stats.tx_fifo_errors++;
1072 printk(KERN_WARNING "%s: DMA underrun detected.\n", dev->name);
1073 } else if (status & TCMD_MAXCOLL) {
1074 printk(KERN_WARNING "%s: Max. collisions exceeded.\n", dev->name);
1075 p->stats.collisions += 16;
1079 #if (NUM_XMIT_BUFFS != 1)
1080 if ((++p->xmit_last) == NUM_XMIT_BUFFS) {
1085 netif_wake_queue(dev);
1088 /***********************************************************
1089 * (re)start the receiver
1092 static void startrecv586(struct net_device *dev)
1094 struct priv *p = (struct priv *) dev->priv;
1096 p->scb->rfa_offset = make16(p->rfd_first);
1097 p->scb->cmd = RUC_START;
1098 elmc_attn586(); /* start cmd. */
1099 WAIT_4_SCB_CMD(); /* wait for accept cmd. (no timeout!!) */
1102 /******************************************************
1106 static void elmc_timeout(struct net_device *dev)
1108 struct priv *p = (struct priv *) dev->priv;
1109 /* COMMAND-UNIT active? */
1110 if (p->scb->status & CU_ACTIVE) {
1112 printk("%s: strange ... timeout with CU active?!?\n", dev->name);
1113 printk("%s: X0: %04x N0: %04x N1: %04x %d\n", dev->name, (int) p->xmit_cmds[0]->cmd_status, (int) p->nop_cmds[0]->cmd_status, (int) p->nop_cmds[1]->cmd_status, (int) p->nop_point);
1115 p->scb->cmd = CUC_ABORT;
1118 p->scb->cbl_offset = make16(p->nop_cmds[p->nop_point]);
1119 p->scb->cmd = CUC_START;
1122 netif_wake_queue(dev);
1125 printk("%s: xmitter timed out, try to restart! stat: %04x\n", dev->name, p->scb->status);
1126 printk("%s: command-stats: %04x %04x\n", dev->name, p->xmit_cmds[0]->cmd_status, p->xmit_cmds[1]->cmd_status);
1133 /******************************************************
1137 static int elmc_send_packet(struct sk_buff *skb, struct net_device *dev)
1141 #ifndef NO_NOPCOMMANDS
1144 struct priv *p = (struct priv *) dev->priv;
1146 netif_stop_queue(dev);
1148 len = (ETH_ZLEN < skb->len) ? skb->len : ETH_ZLEN;
1150 if (len != skb->len)
1151 memset((char *) p->xmit_cbuffs[p->xmit_count], 0, ETH_ZLEN);
1152 memcpy((char *) p->xmit_cbuffs[p->xmit_count], (char *) (skb->data), skb->len);
1154 #if (NUM_XMIT_BUFFS == 1)
1155 #ifdef NO_NOPCOMMANDS
1156 p->xmit_buffs[0]->size = TBD_LAST | len;
1157 for (i = 0; i < 16; i++) {
1158 p->scb->cbl_offset = make16(p->xmit_cmds[0]);
1159 p->scb->cmd = CUC_START;
1160 p->xmit_cmds[0]->cmd_status = 0;
1162 dev->trans_start = jiffies;
1167 if ((p->scb->status & CU_ACTIVE)) { /* test it, because CU sometimes doesn't start immediately */
1170 if (p->xmit_cmds[0]->cmd_status) {
1174 printk(KERN_WARNING "%s: Can't start transmit-command.\n", dev->name);
1178 next_nop = (p->nop_point + 1) & 0x1;
1179 p->xmit_buffs[0]->size = TBD_LAST | len;
1181 p->xmit_cmds[0]->cmd_link = p->nop_cmds[next_nop]->cmd_link
1182 = make16((p->nop_cmds[next_nop]));
1183 p->xmit_cmds[0]->cmd_status = p->nop_cmds[next_nop]->cmd_status = 0;
1185 p->nop_cmds[p->nop_point]->cmd_link = make16((p->xmit_cmds[0]));
1186 dev->trans_start = jiffies;
1187 p->nop_point = next_nop;
1191 p->xmit_buffs[p->xmit_count]->size = TBD_LAST | len;
1192 if ((next_nop = p->xmit_count + 1) == NUM_XMIT_BUFFS) {
1195 p->xmit_cmds[p->xmit_count]->cmd_status = 0;
1196 p->xmit_cmds[p->xmit_count]->cmd_link = p->nop_cmds[next_nop]->cmd_link
1197 = make16((p->nop_cmds[next_nop]));
1198 p->nop_cmds[next_nop]->cmd_status = 0;
1199 p->nop_cmds[p->xmit_count]->cmd_link = make16((p->xmit_cmds[p->xmit_count]));
1200 dev->trans_start = jiffies;
1201 p->xmit_count = next_nop;
1202 if (p->xmit_count != p->xmit_last)
1203 netif_wake_queue(dev);
1209 /*******************************************
1210 * Someone wanna have the statistics
1213 static struct net_device_stats *elmc_get_stats(struct net_device *dev)
1215 struct priv *p = (struct priv *) dev->priv;
1216 unsigned short crc, aln, rsc, ovrn;
1218 crc = p->scb->crc_errs; /* get error-statistic from the ni82586 */
1219 p->scb->crc_errs -= crc;
1220 aln = p->scb->aln_errs;
1221 p->scb->aln_errs -= aln;
1222 rsc = p->scb->rsc_errs;
1223 p->scb->rsc_errs -= rsc;
1224 ovrn = p->scb->ovrn_errs;
1225 p->scb->ovrn_errs -= ovrn;
1227 p->stats.rx_crc_errors += crc;
1228 p->stats.rx_fifo_errors += ovrn;
1229 p->stats.rx_frame_errors += aln;
1230 p->stats.rx_dropped += rsc;
1235 /********************************************************
1239 #ifdef ELMC_MULTICAST
1240 static void set_multicast_list(struct net_device *dev)
1243 /* without a running interface, promiscuous doesn't work */
1254 static void netdev_get_drvinfo(struct net_device *dev,
1255 struct ethtool_drvinfo *info)
1257 strcpy(info->driver, DRV_NAME);
1258 strcpy(info->version, DRV_VERSION);
1259 sprintf(info->bus_info, "MCA 0x%lx", dev->base_addr);
1262 static struct ethtool_ops netdev_ethtool_ops = {
1263 .get_drvinfo = netdev_get_drvinfo,
1268 /* Increase if needed ;) */
1269 #define MAX_3C523_CARDS 4
1271 static struct net_device *dev_elmc[MAX_3C523_CARDS];
1272 static int irq[MAX_3C523_CARDS];
1273 static int io[MAX_3C523_CARDS];
1274 module_param_array(irq, int, NULL, 0);
1275 module_param_array(io, int, NULL, 0);
1276 MODULE_PARM_DESC(io, "EtherLink/MC I/O base address(es)");
1277 MODULE_PARM_DESC(irq, "EtherLink/MC IRQ number(s)");
1278 MODULE_LICENSE("GPL");
1280 int init_module(void)
1282 int this_dev,found = 0;
1284 /* Loop until we either can't find any more cards, or we have MAX_3C523_CARDS */
1285 for(this_dev=0; this_dev<MAX_3C523_CARDS; this_dev++) {
1286 struct net_device *dev = alloc_etherdev(sizeof(struct priv));
1289 dev->irq=irq[this_dev];
1290 dev->base_addr=io[this_dev];
1291 if (do_elmc_probe(dev) == 0) {
1292 dev_elmc[this_dev] = dev;
1297 if (io[this_dev]==0)
1299 printk(KERN_WARNING "3c523.c: No 3c523 card found at io=%#x\n",io[this_dev]);
1303 if(io[0]==0) printk(KERN_NOTICE "3c523.c: No 3c523 cards found\n");
1308 void cleanup_module(void)
1311 for (this_dev=0; this_dev<MAX_3C523_CARDS; this_dev++) {
1312 struct net_device *dev = dev_elmc[this_dev];
1314 unregister_netdev(dev);