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);
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 const 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);
207 unsigned long mapped_start; /* Start of ioremap */
208 volatile struct rfd_struct *rfd_last, *rfd_top, *rfd_first;
209 volatile struct scp_struct *scp; /* volatile is important */
210 volatile struct iscp_struct *iscp; /* volatile is important */
211 volatile struct scb_struct *scb; /* volatile is important */
212 volatile struct tbd_struct *xmit_buffs[NUM_XMIT_BUFFS];
213 #if (NUM_XMIT_BUFFS == 1)
214 volatile struct transmit_cmd_struct *xmit_cmds[2];
215 volatile struct nop_cmd_struct *nop_cmds[2];
217 volatile struct transmit_cmd_struct *xmit_cmds[NUM_XMIT_BUFFS];
218 volatile struct nop_cmd_struct *nop_cmds[NUM_XMIT_BUFFS];
220 volatile int nop_point, num_recv_buffs;
221 volatile char *xmit_cbuffs[NUM_XMIT_BUFFS];
222 volatile int xmit_count, xmit_last;
226 #define elmc_attn586() {elmc_do_attn586(dev->base_addr,ELMC_CTRL_INTE);}
227 #define elmc_reset586() {elmc_do_reset586(dev->base_addr,ELMC_CTRL_INTE);}
229 /* with interrupts disabled - this will clear the interrupt bit in the
230 3c523 control register, and won't put it back. This effectively
231 disables interrupts on the card. */
232 #define elmc_id_attn586() {elmc_do_attn586(dev->base_addr,0);}
233 #define elmc_id_reset586() {elmc_do_reset586(dev->base_addr,0);}
235 /*************************************************************************/
237 Do a Channel Attention on the 3c523. This is extremely board dependent.
239 static void elmc_do_attn586(int ioaddr, int ints)
241 /* the 3c523 requires a minimum of 500 ns. The delays here might be
242 a little too large, and hence they may cut the performance of the
243 card slightly. If someone who knows a little more about Linux
244 timing would care to play with these, I'd appreciate it. */
246 /* this bit masking stuff is crap. I'd rather have separate
247 registers with strobe triggers for each of these functions. <sigh>
248 Ya take what ya got. */
250 outb(ELMC_CTRL_RST | 0x3 | ELMC_CTRL_CA | ints, ioaddr + ELMC_CTRL);
251 DELAY_16(); /* > 500 ns */
252 outb(ELMC_CTRL_RST | 0x3 | ints, ioaddr + ELMC_CTRL);
255 /*************************************************************************/
257 Reset the 82586 on the 3c523. Also very board dependent.
259 static void elmc_do_reset586(int ioaddr, int ints)
261 /* toggle the RST bit low then high */
262 outb(0x3 | ELMC_CTRL_LBK, ioaddr + ELMC_CTRL);
263 DELAY_16(); /* > 500 ns */
264 outb(ELMC_CTRL_RST | ELMC_CTRL_LBK | 0x3, ioaddr + ELMC_CTRL);
266 elmc_do_attn586(ioaddr, ints);
269 /**********************************************
273 static int elmc_close(struct net_device *dev)
275 netif_stop_queue(dev);
276 elmc_id_reset586(); /* the hard way to stop the receiver */
277 free_irq(dev->irq, dev);
281 /**********************************************
285 static int elmc_open(struct net_device *dev)
289 elmc_id_attn586(); /* disable interrupts */
291 ret = request_irq(dev->irq, &elmc_interrupt, IRQF_SHARED | IRQF_SAMPLE_RANDOM,
294 printk(KERN_ERR "%s: couldn't get irq %d\n", dev->name, dev->irq);
301 netif_start_queue(dev);
302 return 0; /* most done by init */
305 /**********************************************
306 * Check to see if there's an 82586 out there.
309 static int __init check586(struct net_device *dev, unsigned long where, unsigned size)
311 struct priv *p = (struct priv *) dev->priv;
315 p->base = (unsigned long) isa_bus_to_virt((unsigned long)where) + size - 0x01000000;
316 p->memtop = isa_bus_to_virt((unsigned long)where) + size;
317 p->scp = (struct scp_struct *)(p->base + SCP_DEFAULT_ADDRESS);
318 memset((char *) p->scp, 0, sizeof(struct scp_struct));
319 p->scp->sysbus = SYSBUSVAL; /* 1 = 8Bit-Bus, 0 = 16 Bit */
321 iscp_addrs[0] = isa_bus_to_virt((unsigned long)where);
322 iscp_addrs[1] = (char *) p->scp - sizeof(struct iscp_struct);
324 for (i = 0; i < 2; i++) {
325 p->iscp = (struct iscp_struct *) iscp_addrs[i];
326 memset((char *) p->iscp, 0, sizeof(struct iscp_struct));
328 p->scp->iscp = make24(p->iscp);
333 /* reset586 does an implicit CA */
335 /* apparently, you sometimes have to kick the 82586 twice... */
339 if (p->iscp->busy) { /* i82586 clears 'busy' after successful init */
346 /******************************************************************
347 * set iscp at the right place, called by elmc_probe and open586.
350 void alloc586(struct net_device *dev)
352 struct priv *p = (struct priv *) dev->priv;
357 p->scp = (struct scp_struct *) (p->base + SCP_DEFAULT_ADDRESS);
358 p->scb = (struct scb_struct *) isa_bus_to_virt(dev->mem_start);
359 p->iscp = (struct iscp_struct *) ((char *) p->scp - sizeof(struct iscp_struct));
361 memset((char *) p->iscp, 0, sizeof(struct iscp_struct));
362 memset((char *) p->scp, 0, sizeof(struct scp_struct));
364 p->scp->iscp = make24(p->iscp);
365 p->scp->sysbus = SYSBUSVAL;
366 p->iscp->scb_offset = make16(p->scb);
375 printk(KERN_ERR "%s: Init-Problems (alloc).\n", dev->name);
377 memset((char *) p->scb, 0, sizeof(struct scb_struct));
380 /*****************************************************************/
382 static int elmc_getinfo(char *buf, int slot, void *d)
385 struct net_device *dev = d;
386 DECLARE_MAC_BUF(mac);
391 len += sprintf(buf + len, "Revision: 0x%x\n",
392 inb(dev->base_addr + ELMC_REVISION) & 0xf);
393 len += sprintf(buf + len, "IRQ: %d\n", dev->irq);
394 len += sprintf(buf + len, "IO Address: %#lx-%#lx\n", dev->base_addr,
395 dev->base_addr + ELMC_IO_EXTENT);
396 len += sprintf(buf + len, "Memory: %#lx-%#lx\n", dev->mem_start,
398 len += sprintf(buf + len, "Transceiver: %s\n", dev->if_port ?
399 "External" : "Internal");
400 len += sprintf(buf + len, "Device: %s\n", dev->name);
401 len += sprintf(buf + len, "Hardware Address: %s\n",
402 print_mac(mac, dev->dev_addr));
405 } /* elmc_getinfo() */
407 /*****************************************************************/
409 static int __init do_elmc_probe(struct net_device *dev)
412 int base_addr = dev->base_addr;
417 unsigned int size = 0;
419 struct priv *pr = dev->priv;
420 DECLARE_MAC_BUF(mac);
425 /* search through the slots for the 3c523. */
426 slot = mca_find_adapter(ELMC_MCA_ID, 0);
428 status = mca_read_stored_pos(slot, 2);
430 dev->irq=irq_table[(status & ELMC_STATUS_IRQ_SELECT) >> 6];
431 dev->base_addr=csr_table[(status & ELMC_STATUS_CSR_SELECT) >> 1];
434 If we're trying to match a specified irq or IO address,
435 we'll reject a match unless it's what we're looking for.
436 Also reject it if the card is already in use.
439 if ((irq && irq != dev->irq) ||
440 (base_addr && base_addr != dev->base_addr)) {
441 slot = mca_find_adapter(ELMC_MCA_ID, slot + 1);
444 if (!request_region(dev->base_addr, ELMC_IO_EXTENT, DRV_NAME)) {
445 slot = mca_find_adapter(ELMC_MCA_ID, slot + 1);
449 /* found what we're looking for... */
453 /* we didn't find any 3c523 in the slots we checked for */
454 if (slot == MCA_NOTFOUND)
455 return ((base_addr || irq) ? -ENXIO : -ENODEV);
457 mca_set_adapter_name(slot, "3Com 3c523 Etherlink/MC");
458 mca_set_adapter_procfn(slot, (MCA_ProcFn) elmc_getinfo, dev);
460 /* if we get this far, adapter has been found - carry on */
461 printk(KERN_INFO "%s: 3c523 adapter found in slot %d\n", dev->name, slot + 1);
463 /* Now we extract configuration info from the card.
464 The 3c523 provides information in two of the POS registers, but
465 the second one is only needed if we want to tell the card what IRQ
466 to use. I suspect that whoever sets the thing up initially would
467 prefer we don't screw with those things.
469 Note that we read the status info when we found the card...
471 See 3c523.h for more details.
474 /* revision is stored in the first 4 bits of the revision register */
475 revision = inb(dev->base_addr + ELMC_REVISION) & 0xf;
477 /* according to docs, we read the interrupt and write it back to
478 the IRQ select register, since the POST might not configure the IRQ
482 mca_write_pos(slot, 3, 0x04);
485 mca_write_pos(slot, 3, 0x02);
488 mca_write_pos(slot, 3, 0x08);
491 mca_write_pos(slot, 3, 0x01);
495 memset(pr, 0, sizeof(struct priv));
498 printk(KERN_INFO "%s: 3Com 3c523 Rev 0x%x at %#lx\n", dev->name, (int) revision,
501 /* Determine if we're using the on-board transceiver (i.e. coax) or
502 an external one. The information is pretty much useless, but I
503 guess it's worth brownie points. */
504 dev->if_port = (status & ELMC_STATUS_DISABLE_THIN);
506 /* The 3c523 has a 24K chunk of memory. The first 16K is the
507 shared memory, while the last 8K is for the EtherStart BIOS ROM.
508 Which we don't care much about here. We'll just tell Linux that
509 we're using 16K. MCA won't permit address space conflicts caused
510 by not mapping the other 8K. */
511 dev->mem_start = shm_table[(status & ELMC_STATUS_MEMORY_SELECT) >> 3];
513 /* We're using MCA, so it's a given that the information about memory
514 size is correct. The Crynwr drivers do something like this. */
516 elmc_id_reset586(); /* seems like a good idea before checking it... */
518 size = 0x4000; /* check for 16K mem */
519 if (!check586(dev, dev->mem_start, size)) {
520 printk(KERN_ERR "%s: memprobe, Can't find memory at 0x%lx!\n", dev->name,
525 dev->mem_end = dev->mem_start + size; /* set mem_end showed by 'ifconfig' */
527 pr->memtop = isa_bus_to_virt(dev->mem_start) + size;
528 pr->base = (unsigned long) isa_bus_to_virt(dev->mem_start) + size - 0x01000000;
531 elmc_id_reset586(); /* make sure it doesn't generate spurious ints */
533 /* set number of receive-buffs according to memsize */
534 pr->num_recv_buffs = NUM_RECV_BUFFS_16;
536 /* dump all the assorted information */
537 printk(KERN_INFO "%s: IRQ %d, %sternal xcvr, memory %#lx-%#lx.\n", dev->name,
538 dev->irq, dev->if_port ? "ex" : "in",
539 dev->mem_start, dev->mem_end - 1);
541 /* The hardware address for the 3c523 is stored in the first six
542 bytes of the IO address. */
543 for (i = 0; i < 6; i++)
544 dev->dev_addr[i] = inb(dev->base_addr + i);
546 printk(KERN_INFO "%s: hardware address %s\n",
547 dev->name, print_mac(mac, dev->dev_addr));
549 dev->open = &elmc_open;
550 dev->stop = &elmc_close;
551 dev->get_stats = &elmc_get_stats;
552 dev->hard_start_xmit = &elmc_send_packet;
553 dev->tx_timeout = &elmc_timeout;
554 dev->watchdog_timeo = HZ;
555 #ifdef ELMC_MULTICAST
556 dev->set_multicast_list = &set_multicast_list;
558 dev->set_multicast_list = NULL;
560 dev->ethtool_ops = &netdev_ethtool_ops;
562 /* note that we haven't actually requested the IRQ from the kernel.
563 That gets done in elmc_open(). I'm not sure that's such a good idea,
564 but it works, so I'll go with it. */
566 #ifndef ELMC_MULTICAST
567 dev->flags&=~IFF_MULTICAST; /* Multicast doesn't work */
570 retval = register_netdev(dev);
576 mca_set_adapter_procfn(slot, NULL, NULL);
577 release_region(dev->base_addr, ELMC_IO_EXTENT);
581 static void cleanup_card(struct net_device *dev)
583 mca_set_adapter_procfn(((struct priv *) (dev->priv))->slot, NULL, NULL);
584 release_region(dev->base_addr, ELMC_IO_EXTENT);
588 struct net_device * __init elmc_probe(int unit)
590 struct net_device *dev = alloc_etherdev(sizeof(struct priv));
594 return ERR_PTR(-ENOMEM);
596 sprintf(dev->name, "eth%d", unit);
597 netdev_boot_setup_check(dev);
599 err = do_elmc_probe(dev);
609 /**********************************************
610 * init the chip (elmc-interrupt should be disabled?!)
611 * needs a correct 'allocated' memory
614 static int init586(struct net_device *dev)
619 struct priv *p = (struct priv *) dev->priv;
620 volatile struct configure_cmd_struct *cfg_cmd;
621 volatile struct iasetup_cmd_struct *ias_cmd;
622 volatile struct tdr_cmd_struct *tdr_cmd;
623 volatile struct mcsetup_cmd_struct *mc_cmd;
624 struct dev_mc_list *dmi = dev->mc_list;
625 int num_addrs = dev->mc_count;
627 ptr = (void *) ((char *) p->scb + sizeof(struct scb_struct));
629 cfg_cmd = (struct configure_cmd_struct *) ptr; /* configure-command */
630 cfg_cmd->cmd_status = 0;
631 cfg_cmd->cmd_cmd = CMD_CONFIGURE | CMD_LAST;
632 cfg_cmd->cmd_link = 0xffff;
634 cfg_cmd->byte_cnt = 0x0a; /* number of cfg bytes */
635 cfg_cmd->fifo = 0x08; /* fifo-limit (8=tx:32/rx:64) */
636 cfg_cmd->sav_bf = 0x40; /* hold or discard bad recv frames (bit 7) */
637 cfg_cmd->adr_len = 0x2e; /* addr_len |!src_insert |pre-len |loopback */
638 cfg_cmd->priority = 0x00;
640 cfg_cmd->time_low = 0x00;
641 cfg_cmd->time_high = 0xf2;
642 cfg_cmd->promisc = 0;
643 if (dev->flags & (IFF_ALLMULTI | IFF_PROMISC))
644 cfg_cmd->promisc = 1;
645 cfg_cmd->carr_coll = 0x00;
647 p->scb->cbl_offset = make16(cfg_cmd);
649 p->scb->cmd = CUC_START; /* cmd.-unit start */
652 s = jiffies; /* warning: only active with interrupts on !! */
653 while (!(cfg_cmd->cmd_status & STAT_COMPL)) {
654 if (time_after(jiffies, s + 30*HZ/100))
658 if ((cfg_cmd->cmd_status & (STAT_OK | STAT_COMPL)) != (STAT_COMPL | STAT_OK)) {
659 printk(KERN_WARNING "%s (elmc): configure command failed: %x\n", dev->name, cfg_cmd->cmd_status);
663 * individual address setup
665 ias_cmd = (struct iasetup_cmd_struct *) ptr;
667 ias_cmd->cmd_status = 0;
668 ias_cmd->cmd_cmd = CMD_IASETUP | CMD_LAST;
669 ias_cmd->cmd_link = 0xffff;
671 memcpy((char *) &ias_cmd->iaddr, (char *) dev->dev_addr, ETH_ALEN);
673 p->scb->cbl_offset = make16(ias_cmd);
675 p->scb->cmd = CUC_START; /* cmd.-unit start */
679 while (!(ias_cmd->cmd_status & STAT_COMPL)) {
680 if (time_after(jiffies, s + 30*HZ/100))
684 if ((ias_cmd->cmd_status & (STAT_OK | STAT_COMPL)) != (STAT_OK | STAT_COMPL)) {
685 printk(KERN_WARNING "%s (elmc): individual address setup command failed: %04x\n", dev->name, ias_cmd->cmd_status);
689 * TDR, wire check .. e.g. no resistor e.t.c
691 tdr_cmd = (struct tdr_cmd_struct *) ptr;
693 tdr_cmd->cmd_status = 0;
694 tdr_cmd->cmd_cmd = CMD_TDR | CMD_LAST;
695 tdr_cmd->cmd_link = 0xffff;
698 p->scb->cbl_offset = make16(tdr_cmd);
700 p->scb->cmd = CUC_START; /* cmd.-unit start */
704 while (!(tdr_cmd->cmd_status & STAT_COMPL)) {
705 if (time_after(jiffies, s + 30*HZ/100)) {
706 printk(KERN_WARNING "%s: %d Problems while running the TDR.\n", dev->name, __LINE__);
713 DELAY(2); /* wait for result */
714 result = tdr_cmd->status;
716 p->scb->cmd = p->scb->status & STAT_MASK;
717 elmc_id_attn586(); /* ack the interrupts */
719 if (result & TDR_LNK_OK) {
721 } else if (result & TDR_XCVR_PRB) {
722 printk(KERN_WARNING "%s: TDR: Transceiver problem!\n", dev->name);
723 } else if (result & TDR_ET_OPN) {
724 printk(KERN_WARNING "%s: TDR: No correct termination %d clocks away.\n", dev->name, result & TDR_TIMEMASK);
725 } else if (result & TDR_ET_SRT) {
726 if (result & TDR_TIMEMASK) /* time == 0 -> strange :-) */
727 printk(KERN_WARNING "%s: TDR: Detected a short circuit %d clocks away.\n", dev->name, result & TDR_TIMEMASK);
729 printk(KERN_WARNING "%s: TDR: Unknown status %04x\n", dev->name, result);
735 p->scb->cmd = p->scb->status & STAT_MASK;
739 * alloc nop/xmit-cmds
741 #if (NUM_XMIT_BUFFS == 1)
742 for (i = 0; i < 2; i++) {
743 p->nop_cmds[i] = (struct nop_cmd_struct *) ptr;
744 p->nop_cmds[i]->cmd_cmd = CMD_NOP;
745 p->nop_cmds[i]->cmd_status = 0;
746 p->nop_cmds[i]->cmd_link = make16((p->nop_cmds[i]));
747 ptr = (char *) ptr + sizeof(struct nop_cmd_struct);
749 p->xmit_cmds[0] = (struct transmit_cmd_struct *) ptr; /* transmit cmd/buff 0 */
750 ptr = (char *) ptr + sizeof(struct transmit_cmd_struct);
752 for (i = 0; i < NUM_XMIT_BUFFS; i++) {
753 p->nop_cmds[i] = (struct nop_cmd_struct *) ptr;
754 p->nop_cmds[i]->cmd_cmd = CMD_NOP;
755 p->nop_cmds[i]->cmd_status = 0;
756 p->nop_cmds[i]->cmd_link = make16((p->nop_cmds[i]));
757 ptr = (char *) ptr + sizeof(struct nop_cmd_struct);
758 p->xmit_cmds[i] = (struct transmit_cmd_struct *) ptr; /*transmit cmd/buff 0 */
759 ptr = (char *) ptr + sizeof(struct transmit_cmd_struct);
763 ptr = alloc_rfa(dev, (void *) ptr); /* init receive-frame-area */
770 /* I don't understand this: do we really need memory after the init? */
771 int len = ((char *) p->iscp - (char *) ptr - 8) / 6;
773 printk(KERN_ERR "%s: Ooooops, no memory for MC-Setup!\n", dev->name);
775 if (len < num_addrs) {
777 printk(KERN_WARNING "%s: Sorry, can only apply %d MC-Address(es).\n",
778 dev->name, num_addrs);
780 mc_cmd = (struct mcsetup_cmd_struct *) ptr;
781 mc_cmd->cmd_status = 0;
782 mc_cmd->cmd_cmd = CMD_MCSETUP | CMD_LAST;
783 mc_cmd->cmd_link = 0xffff;
784 mc_cmd->mc_cnt = num_addrs * 6;
785 for (i = 0; i < num_addrs; i++) {
786 memcpy((char *) mc_cmd->mc_list[i], dmi->dmi_addr, 6);
789 p->scb->cbl_offset = make16(mc_cmd);
790 p->scb->cmd = CUC_START;
793 while (!(mc_cmd->cmd_status & STAT_COMPL)) {
794 if (time_after(jiffies, s + 30*HZ/100))
797 if (!(mc_cmd->cmd_status & STAT_COMPL)) {
798 printk(KERN_WARNING "%s: Can't apply multicast-address-list.\n", dev->name);
803 * alloc xmit-buffs / init xmit_cmds
805 for (i = 0; i < NUM_XMIT_BUFFS; i++) {
806 p->xmit_cbuffs[i] = (char *) ptr; /* char-buffs */
807 ptr = (char *) ptr + XMIT_BUFF_SIZE;
808 p->xmit_buffs[i] = (struct tbd_struct *) ptr; /* TBD */
809 ptr = (char *) ptr + sizeof(struct tbd_struct);
810 if ((void *) ptr > (void *) p->iscp) {
811 printk(KERN_ERR "%s: not enough shared-mem for your configuration!\n", dev->name);
814 memset((char *) (p->xmit_cmds[i]), 0, sizeof(struct transmit_cmd_struct));
815 memset((char *) (p->xmit_buffs[i]), 0, sizeof(struct tbd_struct));
816 p->xmit_cmds[i]->cmd_status = STAT_COMPL;
817 p->xmit_cmds[i]->cmd_cmd = CMD_XMIT | CMD_INT;
818 p->xmit_cmds[i]->tbd_offset = make16((p->xmit_buffs[i]));
819 p->xmit_buffs[i]->next = 0xffff;
820 p->xmit_buffs[i]->buffer = make24((p->xmit_cbuffs[i]));
825 #ifndef NO_NOPCOMMANDS
830 * 'start transmitter' (nop-loop)
832 #ifndef NO_NOPCOMMANDS
833 p->scb->cbl_offset = make16(p->nop_cmds[0]);
834 p->scb->cmd = CUC_START;
838 p->xmit_cmds[0]->cmd_link = 0xffff;
839 p->xmit_cmds[0]->cmd_cmd = CMD_XMIT | CMD_LAST | CMD_INT;
845 /******************************************************
846 * This is a helper routine for elmc_rnr_int() and init586().
847 * It sets up the Receive Frame Area (RFA).
850 static void *alloc_rfa(struct net_device *dev, void *ptr)
852 volatile struct rfd_struct *rfd = (struct rfd_struct *) ptr;
853 volatile struct rbd_struct *rbd;
855 struct priv *p = (struct priv *) dev->priv;
857 memset((char *) rfd, 0, sizeof(struct rfd_struct) * p->num_recv_buffs);
860 for (i = 0; i < p->num_recv_buffs; i++) {
861 rfd[i].next = make16(rfd + (i + 1) % p->num_recv_buffs);
863 rfd[p->num_recv_buffs - 1].last = RFD_SUSP; /* RU suspend */
865 ptr = (void *) (rfd + p->num_recv_buffs);
867 rbd = (struct rbd_struct *) ptr;
868 ptr = (void *) (rbd + p->num_recv_buffs);
870 /* clr descriptors */
871 memset((char *) rbd, 0, sizeof(struct rbd_struct) * p->num_recv_buffs);
873 for (i = 0; i < p->num_recv_buffs; i++) {
874 rbd[i].next = make16((rbd + (i + 1) % p->num_recv_buffs));
875 rbd[i].size = RECV_BUFF_SIZE;
876 rbd[i].buffer = make24(ptr);
877 ptr = (char *) ptr + RECV_BUFF_SIZE;
880 p->rfd_top = p->rfd_first;
881 p->rfd_last = p->rfd_first + p->num_recv_buffs - 1;
883 p->scb->rfa_offset = make16(p->rfd_first);
884 p->rfd_first->rbd_offset = make16(rbd);
890 /**************************************************
891 * Interrupt Handler ...
895 elmc_interrupt(int irq, void *dev_id)
897 struct net_device *dev = dev_id;
901 if (!netif_running(dev)) {
902 /* The 3c523 has this habit of generating interrupts during the
903 reset. I'm not sure if the ni52 has this same problem, but it's
904 really annoying if we haven't finished initializing it. I was
905 hoping all the elmc_id_* commands would disable this, but I
906 might have missed a few. */
908 elmc_id_attn586(); /* ack inter. and disable any more */
910 } else if (!(ELMC_CTRL_INT & inb(dev->base_addr + ELMC_CTRL))) {
911 /* wasn't this device */
914 /* reading ELMC_CTRL also clears the INT bit. */
916 p = (struct priv *) dev->priv;
918 while ((stat = p->scb->status & STAT_MASK))
921 elmc_attn586(); /* ack inter. */
923 if (stat & STAT_CX) {
924 /* command with I-bit set complete */
927 if (stat & STAT_FR) {
928 /* received a frame */
931 #ifndef NO_NOPCOMMANDS
932 if (stat & STAT_CNA) {
933 /* CU went 'not ready' */
934 if (netif_running(dev)) {
935 printk(KERN_WARNING "%s: oops! CU has left active state. stat: %04x/%04x.\n", dev->name, (int) stat, (int) p->scb->status);
940 if (stat & STAT_RNR) {
941 /* RU went 'not ready' */
943 if (p->scb->status & RU_SUSPEND) {
944 /* special case: RU_SUSPEND */
947 p->scb->cmd = RUC_RESUME;
950 printk(KERN_WARNING "%s: Receiver-Unit went 'NOT READY': %04x/%04x.\n", dev->name, (int) stat, (int) p->scb->status);
954 WAIT_4_SCB_CMD(); /* wait for ack. (elmc_xmt_int can be faster than ack!!) */
955 if (p->scb->cmd) { /* timed out? */
962 /*******************************************************
966 static void elmc_rcv_int(struct net_device *dev)
969 unsigned short totlen;
971 struct rbd_struct *rbd;
972 struct priv *p = (struct priv *) dev->priv;
974 for (; (status = p->rfd_top->status) & STAT_COMPL;) {
975 rbd = (struct rbd_struct *) make32(p->rfd_top->rbd_offset);
977 if (status & STAT_OK) { /* frame received without error? */
978 if ((totlen = rbd->status) & RBD_LAST) { /* the first and the last buffer? */
979 totlen &= RBD_MASK; /* length of this frame */
981 skb = (struct sk_buff *) dev_alloc_skb(totlen + 2);
983 skb_reserve(skb, 2); /* 16 byte alignment */
985 skb_copy_to_linear_data(skb, (char *) p->base+(unsigned long) rbd->buffer,totlen);
986 skb->protocol = eth_type_trans(skb, dev);
988 dev->last_rx = jiffies;
989 dev->stats.rx_packets++;
990 dev->stats.rx_bytes += totlen;
992 dev->stats.rx_dropped++;
995 printk(KERN_WARNING "%s: received oversized frame.\n", dev->name);
996 dev->stats.rx_dropped++;
998 } else { /* frame !(ok), only with 'save-bad-frames' */
999 printk(KERN_WARNING "%s: oops! rfd-error-status: %04x\n", dev->name, status);
1000 dev->stats.rx_errors++;
1002 p->rfd_top->status = 0;
1003 p->rfd_top->last = RFD_SUSP;
1004 p->rfd_last->last = 0; /* delete RU_SUSP */
1005 p->rfd_last = p->rfd_top;
1006 p->rfd_top = (struct rfd_struct *) make32(p->rfd_top->next); /* step to next RFD */
1010 /**********************************************************
1011 * handle 'Receiver went not ready'.
1014 static void elmc_rnr_int(struct net_device *dev)
1016 struct priv *p = (struct priv *) dev->priv;
1018 dev->stats.rx_errors++;
1020 WAIT_4_SCB_CMD(); /* wait for the last cmd */
1021 p->scb->cmd = RUC_ABORT; /* usually the RU is in the 'no resource'-state .. abort it now. */
1023 WAIT_4_SCB_CMD(); /* wait for accept cmd. */
1025 alloc_rfa(dev, (char *) p->rfd_first);
1026 startrecv586(dev); /* restart RU */
1028 printk(KERN_WARNING "%s: Receive-Unit restarted. Status: %04x\n", dev->name, p->scb->status);
1032 /**********************************************************
1033 * handle xmit - interrupt
1036 static void elmc_xmt_int(struct net_device *dev)
1039 struct priv *p = (struct priv *) dev->priv;
1041 status = p->xmit_cmds[p->xmit_last]->cmd_status;
1042 if (!(status & STAT_COMPL)) {
1043 printk(KERN_WARNING "%s: strange .. xmit-int without a 'COMPLETE'\n", dev->name);
1045 if (status & STAT_OK) {
1046 dev->stats.tx_packets++;
1047 dev->stats.collisions += (status & TCMD_MAXCOLLMASK);
1049 dev->stats.tx_errors++;
1050 if (status & TCMD_LATECOLL) {
1051 printk(KERN_WARNING "%s: late collision detected.\n", dev->name);
1052 dev->stats.collisions++;
1053 } else if (status & TCMD_NOCARRIER) {
1054 dev->stats.tx_carrier_errors++;
1055 printk(KERN_WARNING "%s: no carrier detected.\n", dev->name);
1056 } else if (status & TCMD_LOSTCTS) {
1057 printk(KERN_WARNING "%s: loss of CTS detected.\n", dev->name);
1058 } else if (status & TCMD_UNDERRUN) {
1059 dev->stats.tx_fifo_errors++;
1060 printk(KERN_WARNING "%s: DMA underrun detected.\n", dev->name);
1061 } else if (status & TCMD_MAXCOLL) {
1062 printk(KERN_WARNING "%s: Max. collisions exceeded.\n", dev->name);
1063 dev->stats.collisions += 16;
1067 #if (NUM_XMIT_BUFFS != 1)
1068 if ((++p->xmit_last) == NUM_XMIT_BUFFS) {
1073 netif_wake_queue(dev);
1076 /***********************************************************
1077 * (re)start the receiver
1080 static void startrecv586(struct net_device *dev)
1082 struct priv *p = (struct priv *) dev->priv;
1084 p->scb->rfa_offset = make16(p->rfd_first);
1085 p->scb->cmd = RUC_START;
1086 elmc_attn586(); /* start cmd. */
1087 WAIT_4_SCB_CMD(); /* wait for accept cmd. (no timeout!!) */
1090 /******************************************************
1094 static void elmc_timeout(struct net_device *dev)
1096 struct priv *p = (struct priv *) dev->priv;
1097 /* COMMAND-UNIT active? */
1098 if (p->scb->status & CU_ACTIVE) {
1100 printk("%s: strange ... timeout with CU active?!?\n", dev->name);
1101 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);
1103 p->scb->cmd = CUC_ABORT;
1106 p->scb->cbl_offset = make16(p->nop_cmds[p->nop_point]);
1107 p->scb->cmd = CUC_START;
1110 netif_wake_queue(dev);
1113 printk("%s: xmitter timed out, try to restart! stat: %04x\n", dev->name, p->scb->status);
1114 printk("%s: command-stats: %04x %04x\n", dev->name, p->xmit_cmds[0]->cmd_status, p->xmit_cmds[1]->cmd_status);
1121 /******************************************************
1125 static int elmc_send_packet(struct sk_buff *skb, struct net_device *dev)
1129 #ifndef NO_NOPCOMMANDS
1132 struct priv *p = (struct priv *) dev->priv;
1134 netif_stop_queue(dev);
1136 len = (ETH_ZLEN < skb->len) ? skb->len : ETH_ZLEN;
1138 if (len != skb->len)
1139 memset((char *) p->xmit_cbuffs[p->xmit_count], 0, ETH_ZLEN);
1140 skb_copy_from_linear_data(skb, (char *) p->xmit_cbuffs[p->xmit_count], skb->len);
1142 #if (NUM_XMIT_BUFFS == 1)
1143 #ifdef NO_NOPCOMMANDS
1144 p->xmit_buffs[0]->size = TBD_LAST | len;
1145 for (i = 0; i < 16; i++) {
1146 p->scb->cbl_offset = make16(p->xmit_cmds[0]);
1147 p->scb->cmd = CUC_START;
1148 p->xmit_cmds[0]->cmd_status = 0;
1150 dev->trans_start = jiffies;
1155 if ((p->scb->status & CU_ACTIVE)) { /* test it, because CU sometimes doesn't start immediately */
1158 if (p->xmit_cmds[0]->cmd_status) {
1162 printk(KERN_WARNING "%s: Can't start transmit-command.\n", dev->name);
1166 next_nop = (p->nop_point + 1) & 0x1;
1167 p->xmit_buffs[0]->size = TBD_LAST | len;
1169 p->xmit_cmds[0]->cmd_link = p->nop_cmds[next_nop]->cmd_link
1170 = make16((p->nop_cmds[next_nop]));
1171 p->xmit_cmds[0]->cmd_status = p->nop_cmds[next_nop]->cmd_status = 0;
1173 p->nop_cmds[p->nop_point]->cmd_link = make16((p->xmit_cmds[0]));
1174 dev->trans_start = jiffies;
1175 p->nop_point = next_nop;
1179 p->xmit_buffs[p->xmit_count]->size = TBD_LAST | len;
1180 if ((next_nop = p->xmit_count + 1) == NUM_XMIT_BUFFS) {
1183 p->xmit_cmds[p->xmit_count]->cmd_status = 0;
1184 p->xmit_cmds[p->xmit_count]->cmd_link = p->nop_cmds[next_nop]->cmd_link
1185 = make16((p->nop_cmds[next_nop]));
1186 p->nop_cmds[next_nop]->cmd_status = 0;
1187 p->nop_cmds[p->xmit_count]->cmd_link = make16((p->xmit_cmds[p->xmit_count]));
1188 dev->trans_start = jiffies;
1189 p->xmit_count = next_nop;
1190 if (p->xmit_count != p->xmit_last)
1191 netif_wake_queue(dev);
1197 /*******************************************
1198 * Someone wanna have the statistics
1201 static struct net_device_stats *elmc_get_stats(struct net_device *dev)
1203 struct priv *p = (struct priv *) dev->priv;
1204 unsigned short crc, aln, rsc, ovrn;
1206 crc = p->scb->crc_errs; /* get error-statistic from the ni82586 */
1207 p->scb->crc_errs -= crc;
1208 aln = p->scb->aln_errs;
1209 p->scb->aln_errs -= aln;
1210 rsc = p->scb->rsc_errs;
1211 p->scb->rsc_errs -= rsc;
1212 ovrn = p->scb->ovrn_errs;
1213 p->scb->ovrn_errs -= ovrn;
1215 dev->stats.rx_crc_errors += crc;
1216 dev->stats.rx_fifo_errors += ovrn;
1217 dev->stats.rx_frame_errors += aln;
1218 dev->stats.rx_dropped += rsc;
1223 /********************************************************
1227 #ifdef ELMC_MULTICAST
1228 static void set_multicast_list(struct net_device *dev)
1231 /* without a running interface, promiscuous doesn't work */
1242 static void netdev_get_drvinfo(struct net_device *dev,
1243 struct ethtool_drvinfo *info)
1245 strcpy(info->driver, DRV_NAME);
1246 strcpy(info->version, DRV_VERSION);
1247 sprintf(info->bus_info, "MCA 0x%lx", dev->base_addr);
1250 static const struct ethtool_ops netdev_ethtool_ops = {
1251 .get_drvinfo = netdev_get_drvinfo,
1256 /* Increase if needed ;) */
1257 #define MAX_3C523_CARDS 4
1259 static struct net_device *dev_elmc[MAX_3C523_CARDS];
1260 static int irq[MAX_3C523_CARDS];
1261 static int io[MAX_3C523_CARDS];
1262 module_param_array(irq, int, NULL, 0);
1263 module_param_array(io, int, NULL, 0);
1264 MODULE_PARM_DESC(io, "EtherLink/MC I/O base address(es)");
1265 MODULE_PARM_DESC(irq, "EtherLink/MC IRQ number(s)");
1266 MODULE_LICENSE("GPL");
1268 int __init init_module(void)
1270 int this_dev,found = 0;
1272 /* Loop until we either can't find any more cards, or we have MAX_3C523_CARDS */
1273 for(this_dev=0; this_dev<MAX_3C523_CARDS; this_dev++) {
1274 struct net_device *dev = alloc_etherdev(sizeof(struct priv));
1277 dev->irq=irq[this_dev];
1278 dev->base_addr=io[this_dev];
1279 if (do_elmc_probe(dev) == 0) {
1280 dev_elmc[this_dev] = dev;
1285 if (io[this_dev]==0)
1287 printk(KERN_WARNING "3c523.c: No 3c523 card found at io=%#x\n",io[this_dev]);
1291 if(io[0]==0) printk(KERN_NOTICE "3c523.c: No 3c523 cards found\n");
1296 void __exit cleanup_module(void)
1299 for (this_dev=0; this_dev<MAX_3C523_CARDS; this_dev++) {
1300 struct net_device *dev = dev_elmc[this_dev];
1302 unregister_netdev(dev);