1 /* ne-h8300.c: A NE2000 clone on H8/300 driver for linux. */
4 Written 1992-94 by Donald Becker.
6 Copyright 1993 United States Government as represented by the
7 Director, National Security Agency.
9 This software may be used and distributed according to the terms
10 of the GNU General Public License, incorporated herein by reference.
12 The author may be reached as becker@scyld.com, or C/O
13 Scyld Computing Corporation, 410 Severn Ave., Suite 210, Annapolis MD 21403
16 Yoshinori Sato <ysato@users.sourceforge.jp>
19 static const char version1[] =
20 "ne-h8300.c:v1.00 2004/04/11 ysato\n";
22 #include <linux/module.h>
23 #include <linux/kernel.h>
24 #include <linux/errno.h>
25 #include <linux/init.h>
26 #include <linux/interrupt.h>
27 #include <linux/delay.h>
28 #include <linux/netdevice.h>
29 #include <linux/etherdevice.h>
31 #include <asm/system.h>
37 #define DRV_NAME "ne-h8300"
39 /* Some defines that people can play with if so inclined. */
41 /* Do we perform extra sanity checks on stuff ? */
42 /* #define NE_SANITY_CHECK */
44 /* Do we implement the read before write bugfix ? */
45 /* #define NE_RW_BUGFIX */
47 /* Do we have a non std. amount of memory? (in units of 256 byte pages) */
48 /* #define PACKETBUF_MEMSIZE 0x40 */
50 /* A zero-terminated list of I/O addresses to be probed at boot. */
52 /* ---- No user-serviceable parts below ---- */
54 #define NE_BASE (dev->base_addr)
56 #define NE_DATAPORT (ei_status.word16?0x20:0x10) /* NatSemi-defined port window offset. */
57 #define NE_RESET (ei_status.word16?0x3f:0x1f) /* Issue a read to reset, a write to clear. */
58 #define NE_IO_EXTENT (ei_status.word16?0x40:0x20)
60 #define NESM_START_PG 0x40 /* First page of TX buffer */
61 #define NESM_STOP_PG 0x80 /* Last page +1 of RX ring */
63 static int ne_probe1(struct net_device *dev, int ioaddr);
65 static int ne_open(struct net_device *dev);
66 static int ne_close(struct net_device *dev);
68 static void ne_reset_8390(struct net_device *dev);
69 static void ne_get_8390_hdr(struct net_device *dev, struct e8390_pkt_hdr *hdr,
71 static void ne_block_input(struct net_device *dev, int count,
72 struct sk_buff *skb, int ring_offset);
73 static void ne_block_output(struct net_device *dev, const int count,
74 const unsigned char *buf, const int start_page);
77 static u32 reg_offset[16];
79 static int __init init_reg_offset(struct net_device *dev,unsigned long base_addr)
81 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
83 unsigned char bus_width;
85 bus_width = *(volatile unsigned char *)ABWCR;
86 bus_width &= 1 << ((base_addr >> 21) & 7);
88 for (i = 0; i < sizeof(reg_offset) / sizeof(u32); i++)
90 reg_offset[i] = i * 2 + 1;
94 ei_local->reg_offset = reg_offset;
98 static int __initdata h8300_ne_count = 0;
99 #ifdef CONFIG_H8300H_H8MAX
100 static unsigned long __initdata h8300_ne_base[] = { 0x800600 };
101 static int h8300_ne_irq[] = {EXT_IRQ4};
103 #ifdef CONFIG_H8300H_AKI3068NET
104 static unsigned long __initdata h8300_ne_base[] = { 0x200000 };
105 static int h8300_ne_irq[] = {EXT_IRQ5};
108 static inline int init_dev(struct net_device *dev)
110 if (h8300_ne_count < (sizeof(h8300_ne_base) / sizeof(unsigned long))) {
111 dev->base_addr = h8300_ne_base[h8300_ne_count];
112 dev->irq = h8300_ne_irq[h8300_ne_count];
119 /* Probe for various non-shared-memory ethercards.
121 NEx000-clone boards have a Station Address PROM (SAPROM) in the packet
122 buffer memory space. NE2000 clones have 0x57,0x57 in bytes 0x0e,0x0f of
123 the SAPROM, while other supposed NE2000 clones must be detected by their
126 Reading the SAPROM from a word-wide card with the 8390 set in byte-wide
127 mode results in doubled values, which can be detected and compensated for.
129 The probe is also responsible for initializing the card and filling
130 in the 'dev' and 'ei_status' structures.
132 We use the minimum memory size for some ethercard product lines, iff we can't
133 distinguish models. You can increase the packet buffer size by setting
134 PACKETBUF_MEMSIZE. Reported Cabletron packet buffer locations are:
135 E1010 starts at 0x100 and ends at 0x2000.
136 E1010-x starts at 0x100 and ends at 0x8000. ("-x" means "more memory")
137 E2010 starts at 0x100 and ends at 0x4000.
138 E2010-x starts at 0x100 and ends at 0xffff. */
140 static int __init do_ne_probe(struct net_device *dev)
142 unsigned int base_addr = dev->base_addr;
144 SET_MODULE_OWNER(dev);
146 /* First check any supplied i/o locations. User knows best. <cough> */
147 if (base_addr > 0x1ff) /* Check a single specified location. */
148 return ne_probe1(dev, base_addr);
149 else if (base_addr != 0) /* Don't probe at all. */
155 static void cleanup_card(struct net_device *dev)
157 free_irq(dev->irq, dev);
158 release_region(dev->base_addr, NE_IO_EXTENT);
162 struct net_device * __init ne_probe(int unit)
164 struct net_device *dev = alloc_ei_netdev();
168 return ERR_PTR(-ENOMEM);
171 return ERR_PTR(-ENODEV);
173 sprintf(dev->name, "eth%d", unit);
174 netdev_boot_setup_check(dev);
176 err = init_reg_offset(dev, dev->base_addr);
180 err = do_ne_probe(dev);
190 static int __init ne_probe1(struct net_device *dev, int ioaddr)
193 unsigned char SA_prom[16];
195 const char *name = NULL;
196 int start_page, stop_page;
198 static unsigned version_printed;
199 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
200 unsigned char bus_width;
202 if (!request_region(ioaddr, NE_IO_EXTENT, DRV_NAME))
205 reg0 = inb_p(ioaddr);
211 /* Do a preliminary verification that we have a 8390. */
214 outb_p(E8390_NODMA+E8390_PAGE1+E8390_STOP, ioaddr + E8390_CMD);
215 regd = inb_p(ioaddr + EI_SHIFT(0x0d));
216 outb_p(0xff, ioaddr + EI_SHIFT(0x0d));
217 outb_p(E8390_NODMA+E8390_PAGE0, ioaddr + E8390_CMD);
218 inb_p(ioaddr + EN0_COUNTER0); /* Clear the counter by reading. */
219 if (inb_p(ioaddr + EN0_COUNTER0) != 0) {
220 outb_p(reg0, ioaddr + EI_SHIFT(0));
221 outb_p(regd, ioaddr + EI_SHIFT(0x0d)); /* Restore the old values. */
227 if (ei_debug && version_printed++ == 0)
228 printk(KERN_INFO "%s", version1);
230 printk(KERN_INFO "NE*000 ethercard probe at %08x:", ioaddr);
232 /* Read the 16 bytes of station address PROM.
233 We must first initialize registers, similar to NS8390_init(eifdev, 0).
234 We can't reliably read the SAPROM address without this.
235 (I learned the hard way!). */
237 struct {unsigned char value, offset; } program_seq[] =
239 {E8390_NODMA+E8390_PAGE0+E8390_STOP, E8390_CMD}, /* Select page 0*/
240 {0x48, EN0_DCFG}, /* Set byte-wide (0x48) access. */
241 {0x00, EN0_RCNTLO}, /* Clear the count regs. */
243 {0x00, EN0_IMR}, /* Mask completion irq. */
245 {E8390_RXOFF, EN0_RXCR}, /* 0x20 Set to monitor */
246 {E8390_TXOFF, EN0_TXCR}, /* 0x02 and loopback mode. */
249 {0x00, EN0_RSARLO}, /* DMA starting at 0x0000. */
251 {E8390_RREAD+E8390_START, E8390_CMD},
254 for (i = 0; i < sizeof(program_seq)/sizeof(program_seq[0]); i++)
255 outb_p(program_seq[i].value, ioaddr + program_seq[i].offset);
258 bus_width = *(volatile unsigned char *)ABWCR;
259 bus_width &= 1 << ((ioaddr >> 21) & 7);
260 ei_status.word16 = (bus_width == 0); /* temporary setting */
261 for(i = 0; i < 16 /*sizeof(SA_prom)*/; i++) {
262 SA_prom[i] = inb_p(ioaddr + NE_DATAPORT);
263 inb_p(ioaddr + NE_DATAPORT); /* dummy read */
266 start_page = NESM_START_PG;
267 stop_page = NESM_STOP_PG;
272 outb_p(0x49, ioaddr + EN0_DCFG);
274 /* Set up the rest of the parameters. */
275 name = (wordlength == 2) ? "NE2000" : "NE1000";
278 printk(" failed to detect IRQ line.\n");
283 /* Snarf the interrupt now. There's no point in waiting since we cannot
284 share and the board will usually be enabled. */
285 ret = request_irq(dev->irq, ei_interrupt, 0, name, dev);
287 printk (" unable to get IRQ %d (errno=%d).\n", dev->irq, ret);
291 dev->base_addr = ioaddr;
293 for(i = 0; i < ETHER_ADDR_LEN; i++) {
294 printk(" %2.2x", SA_prom[i]);
295 dev->dev_addr[i] = SA_prom[i];
298 printk("\n%s: %s found at %#x, using IRQ %d.\n",
299 dev->name, name, ioaddr, dev->irq);
301 ei_status.name = name;
302 ei_status.tx_start_page = start_page;
303 ei_status.stop_page = stop_page;
304 ei_status.word16 = (wordlength == 2);
306 ei_status.rx_start_page = start_page + TX_PAGES;
307 #ifdef PACKETBUF_MEMSIZE
308 /* Allow the packet buffer size to be overridden by know-it-alls. */
309 ei_status.stop_page = ei_status.tx_start_page + PACKETBUF_MEMSIZE;
312 ei_status.reset_8390 = &ne_reset_8390;
313 ei_status.block_input = &ne_block_input;
314 ei_status.block_output = &ne_block_output;
315 ei_status.get_8390_hdr = &ne_get_8390_hdr;
317 dev->open = &ne_open;
318 dev->stop = &ne_close;
319 #ifdef CONFIG_NET_POLL_CONTROLLER
320 dev->poll_controller = ei_poll;
324 ret = register_netdev(dev);
329 free_irq(dev->irq, dev);
331 release_region(ioaddr, NE_IO_EXTENT);
335 static int ne_open(struct net_device *dev)
341 static int ne_close(struct net_device *dev)
344 printk(KERN_DEBUG "%s: Shutting down ethercard.\n", dev->name);
349 /* Hard reset the card. This used to pause for the same period that a
350 8390 reset command required, but that shouldn't be necessary. */
352 static void ne_reset_8390(struct net_device *dev)
354 unsigned long reset_start_time = jiffies;
355 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
358 printk(KERN_DEBUG "resetting the 8390 t=%ld...", jiffies);
360 /* DON'T change these to inb_p/outb_p or reset will fail on clones. */
361 outb(inb(NE_BASE + NE_RESET), NE_BASE + NE_RESET);
364 ei_status.dmaing = 0;
366 /* This check _should_not_ be necessary, omit eventually. */
367 while ((inb_p(NE_BASE+EN0_ISR) & ENISR_RESET) == 0)
368 if (jiffies - reset_start_time > 2*HZ/100) {
369 printk(KERN_WARNING "%s: ne_reset_8390() did not complete.\n", dev->name);
372 outb_p(ENISR_RESET, NE_BASE + EN0_ISR); /* Ack intr. */
375 /* Grab the 8390 specific header. Similar to the block_input routine, but
376 we don't need to be concerned with ring wrap as the header will be at
377 the start of a page, so we optimize accordingly. */
379 static void ne_get_8390_hdr(struct net_device *dev, struct e8390_pkt_hdr *hdr, int ring_page)
381 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
382 /* This *shouldn't* happen. If it does, it's the last thing you'll see */
384 if (ei_status.dmaing)
386 printk(KERN_EMERG "%s: DMAing conflict in ne_get_8390_hdr "
387 "[DMAstat:%d][irqlock:%d].\n",
388 dev->name, ei_status.dmaing, ei_status.irqlock);
392 ei_status.dmaing |= 0x01;
393 outb_p(E8390_NODMA+E8390_PAGE0+E8390_START, NE_BASE + NE_CMD);
394 outb_p(sizeof(struct e8390_pkt_hdr), NE_BASE + EN0_RCNTLO);
395 outb_p(0, NE_BASE + EN0_RCNTHI);
396 outb_p(0, NE_BASE + EN0_RSARLO); /* On page boundary */
397 outb_p(ring_page, NE_BASE + EN0_RSARHI);
398 outb_p(E8390_RREAD+E8390_START, NE_BASE + NE_CMD);
400 if (ei_status.word16) {
402 unsigned short *p = (unsigned short *)hdr;
403 for (len = sizeof(struct e8390_pkt_hdr)>>1; len > 0; len--)
404 *p++ = inw(NE_BASE + NE_DATAPORT);
406 insb(NE_BASE + NE_DATAPORT, hdr, sizeof(struct e8390_pkt_hdr));
408 outb_p(ENISR_RDC, NE_BASE + EN0_ISR); /* Ack intr. */
409 ei_status.dmaing &= ~0x01;
411 le16_to_cpus(&hdr->count);
414 /* Block input and output, similar to the Crynwr packet driver. If you
415 are porting to a new ethercard, look at the packet driver source for hints.
416 The NEx000 doesn't share the on-board packet memory -- you have to put
417 the packet out through the "remote DMA" dataport using outb. */
419 static void ne_block_input(struct net_device *dev, int count, struct sk_buff *skb, int ring_offset)
421 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
422 #ifdef NE_SANITY_CHECK
423 int xfer_count = count;
425 char *buf = skb->data;
427 /* This *shouldn't* happen. If it does, it's the last thing you'll see */
428 if (ei_status.dmaing)
430 printk(KERN_EMERG "%s: DMAing conflict in ne_block_input "
431 "[DMAstat:%d][irqlock:%d].\n",
432 dev->name, ei_status.dmaing, ei_status.irqlock);
435 ei_status.dmaing |= 0x01;
436 outb_p(E8390_NODMA+E8390_PAGE0+E8390_START, NE_BASE + NE_CMD);
437 outb_p(count & 0xff, NE_BASE + EN0_RCNTLO);
438 outb_p(count >> 8, NE_BASE + EN0_RCNTHI);
439 outb_p(ring_offset & 0xff, NE_BASE + EN0_RSARLO);
440 outb_p(ring_offset >> 8, NE_BASE + EN0_RSARHI);
441 outb_p(E8390_RREAD+E8390_START, NE_BASE + NE_CMD);
442 if (ei_status.word16)
445 unsigned short *p = (unsigned short *)buf;
446 for (len = count>>1; len > 0; len--)
447 *p++ = inw(NE_BASE + NE_DATAPORT);
450 buf[count-1] = inb(NE_BASE + NE_DATAPORT);
451 #ifdef NE_SANITY_CHECK
456 insb(NE_BASE + NE_DATAPORT, buf, count);
459 #ifdef NE_SANITY_CHECK
460 /* This was for the ALPHA version only, but enough people have
461 been encountering problems so it is still here. If you see
462 this message you either 1) have a slightly incompatible clone
463 or 2) have noise/speed problems with your bus. */
467 /* DMA termination address check... */
468 int addr, tries = 20;
470 /* DON'T check for 'inb_p(EN0_ISR) & ENISR_RDC' here
471 -- it's broken for Rx on some cards! */
472 int high = inb_p(NE_BASE + EN0_RSARHI);
473 int low = inb_p(NE_BASE + EN0_RSARLO);
474 addr = (high << 8) + low;
475 if (((ring_offset + xfer_count) & 0xff) == low)
477 } while (--tries > 0);
479 printk(KERN_WARNING "%s: RX transfer address mismatch,"
480 "%#4.4x (expected) vs. %#4.4x (actual).\n",
481 dev->name, ring_offset + xfer_count, addr);
484 outb_p(ENISR_RDC, NE_BASE + EN0_ISR); /* Ack intr. */
485 ei_status.dmaing &= ~0x01;
488 static void ne_block_output(struct net_device *dev, int count,
489 const unsigned char *buf, const int start_page)
491 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
492 unsigned long dma_start;
493 #ifdef NE_SANITY_CHECK
497 /* Round the count up for word writes. Do we need to do this?
498 What effect will an odd byte count have on the 8390?
499 I should check someday. */
501 if (ei_status.word16 && (count & 0x01))
504 /* This *shouldn't* happen. If it does, it's the last thing you'll see */
505 if (ei_status.dmaing)
507 printk(KERN_EMERG "%s: DMAing conflict in ne_block_output."
508 "[DMAstat:%d][irqlock:%d]\n",
509 dev->name, ei_status.dmaing, ei_status.irqlock);
512 ei_status.dmaing |= 0x01;
513 /* We should already be in page 0, but to be safe... */
514 outb_p(E8390_PAGE0+E8390_START+E8390_NODMA, NE_BASE + NE_CMD);
516 #ifdef NE_SANITY_CHECK
520 #ifdef NE8390_RW_BUGFIX
521 /* Handle the read-before-write bug the same way as the
522 Crynwr packet driver -- the NatSemi method doesn't work.
523 Actually this doesn't always work either, but if you have
524 problems with your NEx000 this is better than nothing! */
526 outb_p(0x42, NE_BASE + EN0_RCNTLO);
527 outb_p(0x00, NE_BASE + EN0_RCNTHI);
528 outb_p(0x42, NE_BASE + EN0_RSARLO);
529 outb_p(0x00, NE_BASE + EN0_RSARHI);
530 outb_p(E8390_RREAD+E8390_START, NE_BASE + NE_CMD);
531 /* Make certain that the dummy read has occurred. */
535 outb_p(ENISR_RDC, NE_BASE + EN0_ISR);
537 /* Now the normal output. */
538 outb_p(count & 0xff, NE_BASE + EN0_RCNTLO);
539 outb_p(count >> 8, NE_BASE + EN0_RCNTHI);
540 outb_p(0x00, NE_BASE + EN0_RSARLO);
541 outb_p(start_page, NE_BASE + EN0_RSARHI);
543 outb_p(E8390_RWRITE+E8390_START, NE_BASE + NE_CMD);
544 if (ei_status.word16) {
546 unsigned short *p = (unsigned short *)buf;
547 for (len = count>>1; len > 0; len--)
548 outw(*p++, NE_BASE + NE_DATAPORT);
550 outsb(NE_BASE + NE_DATAPORT, buf, count);
555 #ifdef NE_SANITY_CHECK
556 /* This was for the ALPHA version only, but enough people have
557 been encountering problems so it is still here. */
561 /* DMA termination address check... */
562 int addr, tries = 20;
564 int high = inb_p(NE_BASE + EN0_RSARHI);
565 int low = inb_p(NE_BASE + EN0_RSARLO);
566 addr = (high << 8) + low;
567 if ((start_page << 8) + count == addr)
569 } while (--tries > 0);
573 printk(KERN_WARNING "%s: Tx packet transfer address mismatch,"
574 "%#4.4x (expected) vs. %#4.4x (actual).\n",
575 dev->name, (start_page << 8) + count, addr);
582 while ((inb_p(NE_BASE + EN0_ISR) & ENISR_RDC) == 0)
583 if (jiffies - dma_start > 2*HZ/100) { /* 20ms */
584 printk(KERN_WARNING "%s: timeout waiting for Tx RDC.\n", dev->name);
590 outb_p(ENISR_RDC, NE_BASE + EN0_ISR); /* Ack intr. */
591 ei_status.dmaing &= ~0x01;
597 #define MAX_NE_CARDS 1 /* Max number of NE cards per module */
598 static struct net_device *dev_ne[MAX_NE_CARDS];
599 static int io[MAX_NE_CARDS];
600 static int irq[MAX_NE_CARDS];
601 static int bad[MAX_NE_CARDS]; /* 0xbad = bad sig or no reset ack */
603 MODULE_PARM(io, "1-" __MODULE_STRING(MAX_NE_CARDS) "i");
604 MODULE_PARM(irq, "1-" __MODULE_STRING(MAX_NE_CARDS) "i");
605 MODULE_PARM(bad, "1-" __MODULE_STRING(MAX_NE_CARDS) "i");
606 MODULE_PARM_DESC(io, "I/O base address(es)");
607 MODULE_PARM_DESC(irq, "IRQ number(s)");
608 MODULE_DESCRIPTION("H8/300 NE2000 Ethernet driver");
609 MODULE_LICENSE("GPL");
611 /* This is set up so that no ISA autoprobe takes place. We can't guarantee
612 that the ne2k probe is the last 8390 based probe to take place (as it
613 is at boot) and so the probe will get confused by any other 8390 cards.
614 ISA device autoprobes on a running machine are not recommended anyway. */
616 int init_module(void)
618 int this_dev, found = 0;
621 for (this_dev = 0; this_dev < MAX_NE_CARDS; this_dev++) {
622 struct net_device *dev = alloc_ei_netdev();
626 dev->irq = irq[this_dev];
627 dev->mem_end = bad[this_dev];
628 dev->base_addr = io[this_dev];
630 dev->base_addr = h8300_ne_base[this_dev];
631 dev->irq = h8300_ne_irq[this_dev];
633 err = init_reg_offset(dev, dev->base_addr);
635 if (do_ne_probe(dev) == 0) {
636 dev_ne[found++] = dev;
643 if (io[this_dev] != 0)
644 printk(KERN_WARNING "ne.c: No NE*000 card found at i/o = %#x\n", dev->base_addr);
646 printk(KERN_NOTICE "ne.c: You must supply \"io=0xNNN\" value(s) for ISA cards.\n");
654 void cleanup_module(void)
658 for (this_dev = 0; this_dev < MAX_NE_CARDS; this_dev++) {
659 struct net_device *dev = dev_ne[this_dev];
661 unregister_netdev(dev);