pcmcia: pcmcia_config_loop() improvement by passing vcc
[deliverable/linux.git] / drivers / net / pcmcia / axnet_cs.c
1 /*======================================================================
2
3 A PCMCIA ethernet driver for Asix AX88190-based cards
4
5 The Asix AX88190 is a NS8390-derived chipset with a few nasty
6 idiosyncracies that make it very inconvenient to support with a
7 standard 8390 driver. This driver is based on pcnet_cs, with the
8 tweaked 8390 code grafted on the end. Much of what I did was to
9 clean up and update a similar driver supplied by Asix, which was
10 adapted by William Lee, william@asix.com.tw.
11
12 Copyright (C) 2001 David A. Hinds -- dahinds@users.sourceforge.net
13
14 axnet_cs.c 1.28 2002/06/29 06:27:37
15
16 The network driver code is based on Donald Becker's NE2000 code:
17
18 Written 1992,1993 by Donald Becker.
19 Copyright 1993 United States Government as represented by the
20 Director, National Security Agency. This software may be used and
21 distributed according to the terms of the GNU General Public License,
22 incorporated herein by reference.
23 Donald Becker may be reached at becker@scyld.com
24
25 ======================================================================*/
26
27 #include <linux/kernel.h>
28 #include <linux/module.h>
29 #include <linux/init.h>
30 #include <linux/ptrace.h>
31 #include <linux/slab.h>
32 #include <linux/string.h>
33 #include <linux/timer.h>
34 #include <linux/delay.h>
35 #include <linux/spinlock.h>
36 #include <linux/ethtool.h>
37 #include <linux/netdevice.h>
38 #include <linux/crc32.h>
39 #include "../8390.h"
40
41 #include <pcmcia/cs_types.h>
42 #include <pcmcia/cs.h>
43 #include <pcmcia/cistpl.h>
44 #include <pcmcia/ciscode.h>
45 #include <pcmcia/ds.h>
46 #include <pcmcia/cisreg.h>
47
48 #include <asm/io.h>
49 #include <asm/system.h>
50 #include <asm/byteorder.h>
51 #include <asm/uaccess.h>
52
53 #define AXNET_CMD 0x00
54 #define AXNET_DATAPORT 0x10 /* NatSemi-defined port window offset. */
55 #define AXNET_RESET 0x1f /* Issue a read to reset, a write to clear. */
56 #define AXNET_MII_EEP 0x14 /* Offset of MII access port */
57 #define AXNET_TEST 0x15 /* Offset of TEST Register port */
58 #define AXNET_GPIO 0x17 /* Offset of General Purpose Register Port */
59
60 #define AXNET_START_PG 0x40 /* First page of TX buffer */
61 #define AXNET_STOP_PG 0x80 /* Last page +1 of RX ring */
62
63 #define AXNET_RDC_TIMEOUT 0x02 /* Max wait in jiffies for Tx RDC */
64
65 #define IS_AX88190 0x0001
66 #define IS_AX88790 0x0002
67
68 /*====================================================================*/
69
70 /* Module parameters */
71
72 MODULE_AUTHOR("David Hinds <dahinds@users.sourceforge.net>");
73 MODULE_DESCRIPTION("Asix AX88190 PCMCIA ethernet driver");
74 MODULE_LICENSE("GPL");
75
76 #ifdef PCMCIA_DEBUG
77 #define INT_MODULE_PARM(n, v) static int n = v; module_param(n, int, 0)
78
79 INT_MODULE_PARM(pc_debug, PCMCIA_DEBUG);
80 #define DEBUG(n, args...) if (pc_debug>(n)) printk(KERN_DEBUG args)
81 static char *version =
82 "axnet_cs.c 1.28 2002/06/29 06:27:37 (David Hinds)";
83 #else
84 #define DEBUG(n, args...)
85 #endif
86
87 /*====================================================================*/
88
89 static int axnet_config(struct pcmcia_device *link);
90 static void axnet_release(struct pcmcia_device *link);
91 static int axnet_open(struct net_device *dev);
92 static int axnet_close(struct net_device *dev);
93 static int axnet_ioctl(struct net_device *dev, struct ifreq *rq, int cmd);
94 static const struct ethtool_ops netdev_ethtool_ops;
95 static irqreturn_t ei_irq_wrapper(int irq, void *dev_id);
96 static void ei_watchdog(u_long arg);
97 static void axnet_reset_8390(struct net_device *dev);
98
99 static int mdio_read(unsigned int addr, int phy_id, int loc);
100 static void mdio_write(unsigned int addr, int phy_id, int loc, int value);
101
102 static void get_8390_hdr(struct net_device *,
103 struct e8390_pkt_hdr *, int);
104 static void block_input(struct net_device *dev, int count,
105 struct sk_buff *skb, int ring_offset);
106 static void block_output(struct net_device *dev, int count,
107 const u_char *buf, const int start_page);
108
109 static void axnet_detach(struct pcmcia_device *p_dev);
110
111 static void axdev_setup(struct net_device *dev);
112 static void AX88190_init(struct net_device *dev, int startp);
113 static int ax_open(struct net_device *dev);
114 static int ax_close(struct net_device *dev);
115 static irqreturn_t ax_interrupt(int irq, void *dev_id);
116
117 /*====================================================================*/
118
119 typedef struct axnet_dev_t {
120 struct pcmcia_device *p_dev;
121 dev_node_t node;
122 caddr_t base;
123 struct timer_list watchdog;
124 int stale, fast_poll;
125 u_short link_status;
126 u_char duplex_flag;
127 int phy_id;
128 int flags;
129 } axnet_dev_t;
130
131 static inline axnet_dev_t *PRIV(struct net_device *dev)
132 {
133 void *p = (char *)netdev_priv(dev) + sizeof(struct ei_device);
134 return p;
135 }
136
137 /*======================================================================
138
139 axnet_attach() creates an "instance" of the driver, allocating
140 local data structures for one device. The device is registered
141 with Card Services.
142
143 ======================================================================*/
144
145 static int axnet_probe(struct pcmcia_device *link)
146 {
147 axnet_dev_t *info;
148 struct net_device *dev;
149
150 DEBUG(0, "axnet_attach()\n");
151
152 dev = alloc_netdev(sizeof(struct ei_device) + sizeof(axnet_dev_t),
153 "eth%d", axdev_setup);
154
155 if (!dev)
156 return -ENOMEM;
157
158 info = PRIV(dev);
159 info->p_dev = link;
160 link->priv = dev;
161 link->irq.Attributes = IRQ_TYPE_DYNAMIC_SHARING;
162 link->irq.IRQInfo1 = IRQ_LEVEL_ID;
163 link->conf.Attributes = CONF_ENABLE_IRQ;
164 link->conf.IntType = INT_MEMORY_AND_IO;
165
166 dev->open = &axnet_open;
167 dev->stop = &axnet_close;
168 dev->do_ioctl = &axnet_ioctl;
169 SET_ETHTOOL_OPS(dev, &netdev_ethtool_ops);
170
171 return axnet_config(link);
172 } /* axnet_attach */
173
174 /*======================================================================
175
176 This deletes a driver "instance". The device is de-registered
177 with Card Services. If it has been released, all local data
178 structures are freed. Otherwise, the structures will be freed
179 when the device is released.
180
181 ======================================================================*/
182
183 static void axnet_detach(struct pcmcia_device *link)
184 {
185 struct net_device *dev = link->priv;
186
187 DEBUG(0, "axnet_detach(0x%p)\n", link);
188
189 if (link->dev_node)
190 unregister_netdev(dev);
191
192 axnet_release(link);
193
194 free_netdev(dev);
195 } /* axnet_detach */
196
197 /*======================================================================
198
199 This probes for a card's hardware address by reading the PROM.
200
201 ======================================================================*/
202
203 static int get_prom(struct pcmcia_device *link)
204 {
205 struct net_device *dev = link->priv;
206 unsigned int ioaddr = dev->base_addr;
207 int i, j;
208
209 /* This is based on drivers/net/ne.c */
210 struct {
211 u_char value, offset;
212 } program_seq[] = {
213 {E8390_NODMA+E8390_PAGE0+E8390_STOP, E8390_CMD}, /* Select page 0*/
214 {0x01, EN0_DCFG}, /* Set word-wide access. */
215 {0x00, EN0_RCNTLO}, /* Clear the count regs. */
216 {0x00, EN0_RCNTHI},
217 {0x00, EN0_IMR}, /* Mask completion irq. */
218 {0xFF, EN0_ISR},
219 {E8390_RXOFF|0x40, EN0_RXCR}, /* 0x60 Set to monitor */
220 {E8390_TXOFF, EN0_TXCR}, /* 0x02 and loopback mode. */
221 {0x10, EN0_RCNTLO},
222 {0x00, EN0_RCNTHI},
223 {0x00, EN0_RSARLO}, /* DMA starting at 0x0400. */
224 {0x04, EN0_RSARHI},
225 {E8390_RREAD+E8390_START, E8390_CMD},
226 };
227
228 /* Not much of a test, but the alternatives are messy */
229 if (link->conf.ConfigBase != 0x03c0)
230 return 0;
231
232 axnet_reset_8390(dev);
233 mdelay(10);
234
235 for (i = 0; i < ARRAY_SIZE(program_seq); i++)
236 outb_p(program_seq[i].value, ioaddr + program_seq[i].offset);
237
238 for (i = 0; i < 6; i += 2) {
239 j = inw(ioaddr + AXNET_DATAPORT);
240 dev->dev_addr[i] = j & 0xff;
241 dev->dev_addr[i+1] = j >> 8;
242 }
243 return 1;
244 } /* get_prom */
245
246 /*======================================================================
247
248 axnet_config() is scheduled to run after a CARD_INSERTION event
249 is received, to configure the PCMCIA socket, and to make the
250 ethernet device available to the system.
251
252 ======================================================================*/
253
254 #define CS_CHECK(fn, ret) \
255 do { last_fn = (fn); if ((last_ret = (ret)) != 0) goto cs_failed; } while (0)
256
257 static int try_io_port(struct pcmcia_device *link)
258 {
259 int j, ret;
260 if (link->io.NumPorts1 == 32) {
261 link->io.Attributes1 = IO_DATA_PATH_WIDTH_AUTO;
262 if (link->io.NumPorts2 > 0) {
263 /* for master/slave multifunction cards */
264 link->io.Attributes2 = IO_DATA_PATH_WIDTH_8;
265 link->irq.Attributes =
266 IRQ_TYPE_DYNAMIC_SHARING|IRQ_FIRST_SHARED;
267 }
268 } else {
269 /* This should be two 16-port windows */
270 link->io.Attributes1 = IO_DATA_PATH_WIDTH_8;
271 link->io.Attributes2 = IO_DATA_PATH_WIDTH_16;
272 }
273 if (link->io.BasePort1 == 0) {
274 link->io.IOAddrLines = 16;
275 for (j = 0; j < 0x400; j += 0x20) {
276 link->io.BasePort1 = j ^ 0x300;
277 link->io.BasePort2 = (j ^ 0x300) + 0x10;
278 ret = pcmcia_request_io(link, &link->io);
279 if (ret == CS_SUCCESS) return ret;
280 }
281 return ret;
282 } else {
283 return pcmcia_request_io(link, &link->io);
284 }
285 }
286
287 static int axnet_configcheck(struct pcmcia_device *p_dev,
288 cistpl_cftable_entry_t *cfg,
289 cistpl_cftable_entry_t *dflt,
290 unsigned int vcc,
291 void *priv_data)
292 {
293 int i;
294 cistpl_io_t *io = &cfg->io;
295
296 if (cfg->index == 0 || cfg->io.nwin == 0)
297 return -ENODEV;
298
299 p_dev->conf.ConfigIndex = 0x05;
300 /* For multifunction cards, by convention, we configure the
301 network function with window 0, and serial with window 1 */
302 if (io->nwin > 1) {
303 i = (io->win[1].len > io->win[0].len);
304 p_dev->io.BasePort2 = io->win[1-i].base;
305 p_dev->io.NumPorts2 = io->win[1-i].len;
306 } else {
307 i = p_dev->io.NumPorts2 = 0;
308 }
309 p_dev->io.BasePort1 = io->win[i].base;
310 p_dev->io.NumPorts1 = io->win[i].len;
311 p_dev->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
312 if (p_dev->io.NumPorts1 + p_dev->io.NumPorts2 >= 32)
313 return try_io_port(p_dev);
314
315 return -ENODEV;
316 }
317
318 static int axnet_config(struct pcmcia_device *link)
319 {
320 struct net_device *dev = link->priv;
321 axnet_dev_t *info = PRIV(dev);
322 int i, j, last_ret, last_fn;
323 DECLARE_MAC_BUF(mac);
324
325 DEBUG(0, "axnet_config(0x%p)\n", link);
326
327 /* don't trust the CIS on this; Linksys got it wrong */
328 link->conf.Present = 0x63;
329 last_ret = pcmcia_loop_config(link, axnet_configcheck, NULL);
330 if (last_ret != CS_SUCCESS) {
331 cs_error(link, RequestIO, last_ret);
332 goto failed;
333 }
334
335 CS_CHECK(RequestIRQ, pcmcia_request_irq(link, &link->irq));
336
337 if (link->io.NumPorts2 == 8) {
338 link->conf.Attributes |= CONF_ENABLE_SPKR;
339 link->conf.Status = CCSR_AUDIO_ENA;
340 }
341
342 CS_CHECK(RequestConfiguration, pcmcia_request_configuration(link, &link->conf));
343 dev->irq = link->irq.AssignedIRQ;
344 dev->base_addr = link->io.BasePort1;
345
346 if (!get_prom(link)) {
347 printk(KERN_NOTICE "axnet_cs: this is not an AX88190 card!\n");
348 printk(KERN_NOTICE "axnet_cs: use pcnet_cs instead.\n");
349 goto failed;
350 }
351
352 ei_status.name = "AX88190";
353 ei_status.word16 = 1;
354 ei_status.tx_start_page = AXNET_START_PG;
355 ei_status.rx_start_page = AXNET_START_PG + TX_PAGES;
356 ei_status.stop_page = AXNET_STOP_PG;
357 ei_status.reset_8390 = &axnet_reset_8390;
358 ei_status.get_8390_hdr = &get_8390_hdr;
359 ei_status.block_input = &block_input;
360 ei_status.block_output = &block_output;
361
362 if (inb(dev->base_addr + AXNET_TEST) != 0)
363 info->flags |= IS_AX88790;
364 else
365 info->flags |= IS_AX88190;
366
367 if (info->flags & IS_AX88790)
368 outb(0x10, dev->base_addr + AXNET_GPIO); /* select Internal PHY */
369
370 for (i = 0; i < 32; i++) {
371 j = mdio_read(dev->base_addr + AXNET_MII_EEP, i, 1);
372 if ((j != 0) && (j != 0xffff)) break;
373 }
374
375 /* Maybe PHY is in power down mode. (PPD_SET = 1)
376 Bit 2 of CCSR is active low. */
377 if (i == 32) {
378 conf_reg_t reg = { 0, CS_WRITE, CISREG_CCSR, 0x04 };
379 pcmcia_access_configuration_register(link, &reg);
380 for (i = 0; i < 32; i++) {
381 j = mdio_read(dev->base_addr + AXNET_MII_EEP, i, 1);
382 if ((j != 0) && (j != 0xffff)) break;
383 }
384 }
385
386 info->phy_id = (i < 32) ? i : -1;
387 link->dev_node = &info->node;
388 SET_NETDEV_DEV(dev, &handle_to_dev(link));
389
390 if (register_netdev(dev) != 0) {
391 printk(KERN_NOTICE "axnet_cs: register_netdev() failed\n");
392 link->dev_node = NULL;
393 goto failed;
394 }
395
396 strcpy(info->node.dev_name, dev->name);
397
398 printk(KERN_INFO "%s: Asix AX88%d90: io %#3lx, irq %d, "
399 "hw_addr %s\n",
400 dev->name, ((info->flags & IS_AX88790) ? 7 : 1),
401 dev->base_addr, dev->irq,
402 print_mac(mac, dev->dev_addr));
403 if (info->phy_id != -1) {
404 DEBUG(0, " MII transceiver at index %d, status %x.\n", info->phy_id, j);
405 } else {
406 printk(KERN_NOTICE " No MII transceivers found!\n");
407 }
408 return 0;
409
410 cs_failed:
411 cs_error(link, last_fn, last_ret);
412 failed:
413 axnet_release(link);
414 return -ENODEV;
415 } /* axnet_config */
416
417 /*======================================================================
418
419 After a card is removed, axnet_release() will unregister the net
420 device, and release the PCMCIA configuration. If the device is
421 still open, this will be postponed until it is closed.
422
423 ======================================================================*/
424
425 static void axnet_release(struct pcmcia_device *link)
426 {
427 pcmcia_disable_device(link);
428 }
429
430 static int axnet_suspend(struct pcmcia_device *link)
431 {
432 struct net_device *dev = link->priv;
433
434 if (link->open)
435 netif_device_detach(dev);
436
437 return 0;
438 }
439
440 static int axnet_resume(struct pcmcia_device *link)
441 {
442 struct net_device *dev = link->priv;
443
444 if (link->open) {
445 axnet_reset_8390(dev);
446 AX88190_init(dev, 1);
447 netif_device_attach(dev);
448 }
449
450 return 0;
451 }
452
453
454 /*======================================================================
455
456 MII interface support
457
458 ======================================================================*/
459
460 #define MDIO_SHIFT_CLK 0x01
461 #define MDIO_DATA_WRITE0 0x00
462 #define MDIO_DATA_WRITE1 0x08
463 #define MDIO_DATA_READ 0x04
464 #define MDIO_MASK 0x0f
465 #define MDIO_ENB_IN 0x02
466
467 static void mdio_sync(unsigned int addr)
468 {
469 int bits;
470 for (bits = 0; bits < 32; bits++) {
471 outb_p(MDIO_DATA_WRITE1, addr);
472 outb_p(MDIO_DATA_WRITE1 | MDIO_SHIFT_CLK, addr);
473 }
474 }
475
476 static int mdio_read(unsigned int addr, int phy_id, int loc)
477 {
478 u_int cmd = (0xf6<<10)|(phy_id<<5)|loc;
479 int i, retval = 0;
480
481 mdio_sync(addr);
482 for (i = 14; i >= 0; i--) {
483 int dat = (cmd&(1<<i)) ? MDIO_DATA_WRITE1 : MDIO_DATA_WRITE0;
484 outb_p(dat, addr);
485 outb_p(dat | MDIO_SHIFT_CLK, addr);
486 }
487 for (i = 19; i > 0; i--) {
488 outb_p(MDIO_ENB_IN, addr);
489 retval = (retval << 1) | ((inb_p(addr) & MDIO_DATA_READ) != 0);
490 outb_p(MDIO_ENB_IN | MDIO_SHIFT_CLK, addr);
491 }
492 return (retval>>1) & 0xffff;
493 }
494
495 static void mdio_write(unsigned int addr, int phy_id, int loc, int value)
496 {
497 u_int cmd = (0x05<<28)|(phy_id<<23)|(loc<<18)|(1<<17)|value;
498 int i;
499
500 mdio_sync(addr);
501 for (i = 31; i >= 0; i--) {
502 int dat = (cmd&(1<<i)) ? MDIO_DATA_WRITE1 : MDIO_DATA_WRITE0;
503 outb_p(dat, addr);
504 outb_p(dat | MDIO_SHIFT_CLK, addr);
505 }
506 for (i = 1; i >= 0; i--) {
507 outb_p(MDIO_ENB_IN, addr);
508 outb_p(MDIO_ENB_IN | MDIO_SHIFT_CLK, addr);
509 }
510 }
511
512 /*====================================================================*/
513
514 static int axnet_open(struct net_device *dev)
515 {
516 int ret;
517 axnet_dev_t *info = PRIV(dev);
518 struct pcmcia_device *link = info->p_dev;
519 unsigned int nic_base = dev->base_addr;
520
521 DEBUG(2, "axnet_open('%s')\n", dev->name);
522
523 if (!pcmcia_dev_present(link))
524 return -ENODEV;
525
526 outb_p(0xFF, nic_base + EN0_ISR); /* Clear bogus intr. */
527 ret = request_irq(dev->irq, ei_irq_wrapper, IRQF_SHARED, "axnet_cs", dev);
528 if (ret)
529 return ret;
530
531 link->open++;
532
533 info->link_status = 0x00;
534 init_timer(&info->watchdog);
535 info->watchdog.function = &ei_watchdog;
536 info->watchdog.data = (u_long)dev;
537 info->watchdog.expires = jiffies + HZ;
538 add_timer(&info->watchdog);
539
540 return ax_open(dev);
541 } /* axnet_open */
542
543 /*====================================================================*/
544
545 static int axnet_close(struct net_device *dev)
546 {
547 axnet_dev_t *info = PRIV(dev);
548 struct pcmcia_device *link = info->p_dev;
549
550 DEBUG(2, "axnet_close('%s')\n", dev->name);
551
552 ax_close(dev);
553 free_irq(dev->irq, dev);
554
555 link->open--;
556 netif_stop_queue(dev);
557 del_timer_sync(&info->watchdog);
558
559 return 0;
560 } /* axnet_close */
561
562 /*======================================================================
563
564 Hard reset the card. This used to pause for the same period that
565 a 8390 reset command required, but that shouldn't be necessary.
566
567 ======================================================================*/
568
569 static void axnet_reset_8390(struct net_device *dev)
570 {
571 unsigned int nic_base = dev->base_addr;
572 int i;
573
574 ei_status.txing = ei_status.dmaing = 0;
575
576 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, nic_base + E8390_CMD);
577
578 outb(inb(nic_base + AXNET_RESET), nic_base + AXNET_RESET);
579
580 for (i = 0; i < 100; i++) {
581 if ((inb_p(nic_base+EN0_ISR) & ENISR_RESET) != 0)
582 break;
583 udelay(100);
584 }
585 outb_p(ENISR_RESET, nic_base + EN0_ISR); /* Ack intr. */
586
587 if (i == 100)
588 printk(KERN_ERR "%s: axnet_reset_8390() did not complete.\n",
589 dev->name);
590
591 } /* axnet_reset_8390 */
592
593 /*====================================================================*/
594
595 static irqreturn_t ei_irq_wrapper(int irq, void *dev_id)
596 {
597 struct net_device *dev = dev_id;
598 PRIV(dev)->stale = 0;
599 return ax_interrupt(irq, dev_id);
600 }
601
602 static void ei_watchdog(u_long arg)
603 {
604 struct net_device *dev = (struct net_device *)(arg);
605 axnet_dev_t *info = PRIV(dev);
606 unsigned int nic_base = dev->base_addr;
607 unsigned int mii_addr = nic_base + AXNET_MII_EEP;
608 u_short link;
609
610 if (!netif_device_present(dev)) goto reschedule;
611
612 /* Check for pending interrupt with expired latency timer: with
613 this, we can limp along even if the interrupt is blocked */
614 if (info->stale++ && (inb_p(nic_base + EN0_ISR) & ENISR_ALL)) {
615 if (!info->fast_poll)
616 printk(KERN_INFO "%s: interrupt(s) dropped!\n", dev->name);
617 ei_irq_wrapper(dev->irq, dev);
618 info->fast_poll = HZ;
619 }
620 if (info->fast_poll) {
621 info->fast_poll--;
622 info->watchdog.expires = jiffies + 1;
623 add_timer(&info->watchdog);
624 return;
625 }
626
627 if (info->phy_id < 0)
628 goto reschedule;
629 link = mdio_read(mii_addr, info->phy_id, 1);
630 if (!link || (link == 0xffff)) {
631 printk(KERN_INFO "%s: MII is missing!\n", dev->name);
632 info->phy_id = -1;
633 goto reschedule;
634 }
635
636 link &= 0x0004;
637 if (link != info->link_status) {
638 u_short p = mdio_read(mii_addr, info->phy_id, 5);
639 printk(KERN_INFO "%s: %s link beat\n", dev->name,
640 (link) ? "found" : "lost");
641 if (link) {
642 info->duplex_flag = (p & 0x0140) ? 0x80 : 0x00;
643 if (p)
644 printk(KERN_INFO "%s: autonegotiation complete: "
645 "%sbaseT-%cD selected\n", dev->name,
646 ((p & 0x0180) ? "100" : "10"),
647 ((p & 0x0140) ? 'F' : 'H'));
648 else
649 printk(KERN_INFO "%s: link partner did not autonegotiate\n",
650 dev->name);
651 AX88190_init(dev, 1);
652 }
653 info->link_status = link;
654 }
655
656 reschedule:
657 info->watchdog.expires = jiffies + HZ;
658 add_timer(&info->watchdog);
659 }
660
661 static void netdev_get_drvinfo(struct net_device *dev,
662 struct ethtool_drvinfo *info)
663 {
664 strcpy(info->driver, "axnet_cs");
665 }
666
667 static const struct ethtool_ops netdev_ethtool_ops = {
668 .get_drvinfo = netdev_get_drvinfo,
669 };
670
671 /*====================================================================*/
672
673 static int axnet_ioctl(struct net_device *dev, struct ifreq *rq, int cmd)
674 {
675 axnet_dev_t *info = PRIV(dev);
676 u16 *data = (u16 *)&rq->ifr_ifru;
677 unsigned int mii_addr = dev->base_addr + AXNET_MII_EEP;
678 switch (cmd) {
679 case SIOCGMIIPHY:
680 data[0] = info->phy_id;
681 case SIOCGMIIREG: /* Read MII PHY register. */
682 data[3] = mdio_read(mii_addr, data[0], data[1] & 0x1f);
683 return 0;
684 case SIOCSMIIREG: /* Write MII PHY register. */
685 if (!capable(CAP_NET_ADMIN))
686 return -EPERM;
687 mdio_write(mii_addr, data[0], data[1] & 0x1f, data[2]);
688 return 0;
689 }
690 return -EOPNOTSUPP;
691 }
692
693 /*====================================================================*/
694
695 static void get_8390_hdr(struct net_device *dev,
696 struct e8390_pkt_hdr *hdr,
697 int ring_page)
698 {
699 unsigned int nic_base = dev->base_addr;
700
701 outb_p(0, nic_base + EN0_RSARLO); /* On page boundary */
702 outb_p(ring_page, nic_base + EN0_RSARHI);
703 outb_p(E8390_RREAD+E8390_START, nic_base + AXNET_CMD);
704
705 insw(nic_base + AXNET_DATAPORT, hdr,
706 sizeof(struct e8390_pkt_hdr)>>1);
707 /* Fix for big endian systems */
708 hdr->count = le16_to_cpu(hdr->count);
709
710 }
711
712 /*====================================================================*/
713
714 static void block_input(struct net_device *dev, int count,
715 struct sk_buff *skb, int ring_offset)
716 {
717 unsigned int nic_base = dev->base_addr;
718 int xfer_count = count;
719 char *buf = skb->data;
720
721 #ifdef PCMCIA_DEBUG
722 if ((ei_debug > 4) && (count != 4))
723 printk(KERN_DEBUG "%s: [bi=%d]\n", dev->name, count+4);
724 #endif
725 outb_p(ring_offset & 0xff, nic_base + EN0_RSARLO);
726 outb_p(ring_offset >> 8, nic_base + EN0_RSARHI);
727 outb_p(E8390_RREAD+E8390_START, nic_base + AXNET_CMD);
728
729 insw(nic_base + AXNET_DATAPORT,buf,count>>1);
730 if (count & 0x01)
731 buf[count-1] = inb(nic_base + AXNET_DATAPORT), xfer_count++;
732
733 }
734
735 /*====================================================================*/
736
737 static void block_output(struct net_device *dev, int count,
738 const u_char *buf, const int start_page)
739 {
740 unsigned int nic_base = dev->base_addr;
741
742 #ifdef PCMCIA_DEBUG
743 if (ei_debug > 4)
744 printk(KERN_DEBUG "%s: [bo=%d]\n", dev->name, count);
745 #endif
746
747 /* Round the count up for word writes. Do we need to do this?
748 What effect will an odd byte count have on the 8390?
749 I should check someday. */
750 if (count & 0x01)
751 count++;
752
753 outb_p(0x00, nic_base + EN0_RSARLO);
754 outb_p(start_page, nic_base + EN0_RSARHI);
755 outb_p(E8390_RWRITE+E8390_START, nic_base + AXNET_CMD);
756 outsw(nic_base + AXNET_DATAPORT, buf, count>>1);
757 }
758
759 static struct pcmcia_device_id axnet_ids[] = {
760 PCMCIA_PFC_DEVICE_MANF_CARD(0, 0x016c, 0x0081),
761 PCMCIA_DEVICE_MANF_CARD(0x018a, 0x0301),
762 PCMCIA_DEVICE_MANF_CARD(0x026f, 0x0301),
763 PCMCIA_DEVICE_MANF_CARD(0x026f, 0x0303),
764 PCMCIA_DEVICE_MANF_CARD(0x026f, 0x0309),
765 PCMCIA_DEVICE_MANF_CARD(0x0274, 0x1106),
766 PCMCIA_DEVICE_MANF_CARD(0x8a01, 0xc1ab),
767 PCMCIA_DEVICE_MANF_CARD(0x021b, 0x0202),
768 PCMCIA_DEVICE_MANF_CARD(0xffff, 0x1090),
769 PCMCIA_DEVICE_PROD_ID12("AmbiCom,Inc.", "Fast Ethernet PC Card(AMB8110)", 0x49b020a7, 0x119cc9fc),
770 PCMCIA_DEVICE_PROD_ID124("Fast Ethernet", "16-bit PC Card", "AX88190", 0xb4be14e3, 0x9a12eb6a, 0xab9be5ef),
771 PCMCIA_DEVICE_PROD_ID12("ASIX", "AX88190", 0x0959823b, 0xab9be5ef),
772 PCMCIA_DEVICE_PROD_ID12("Billionton", "LNA-100B", 0x552ab682, 0xbc3b87e1),
773 PCMCIA_DEVICE_PROD_ID12("CHEETAH ETHERCARD", "EN2228", 0x00fa7bc8, 0x00e990cc),
774 PCMCIA_DEVICE_PROD_ID12("CNet", "CNF301", 0xbc477dde, 0x78c5f40b),
775 PCMCIA_DEVICE_PROD_ID12("corega K.K.", "corega FEther PCC-TXD", 0x5261440f, 0x436768c5),
776 PCMCIA_DEVICE_PROD_ID12("corega K.K.", "corega FEtherII PCC-TXD", 0x5261440f, 0x730df72e),
777 PCMCIA_DEVICE_PROD_ID12("Dynalink", "L100C16", 0x55632fd5, 0x66bc2a90),
778 PCMCIA_DEVICE_PROD_ID12("Linksys", "EtherFast 10/100 PC Card (PCMPC100 V3)", 0x0733cc81, 0x232019a8),
779 PCMCIA_DEVICE_PROD_ID12("MELCO", "LPC3-TX", 0x481e0094, 0xf91af609),
780 PCMCIA_DEVICE_PROD_ID12("PCMCIA", "100BASE", 0x281f1c5d, 0x7c2add04),
781 PCMCIA_DEVICE_PROD_ID12("PCMCIA", "FastEtherCard", 0x281f1c5d, 0x7ef26116),
782 PCMCIA_DEVICE_PROD_ID12("PCMCIA", "FEP501", 0x281f1c5d, 0x2e272058),
783 PCMCIA_DEVICE_PROD_ID14("Network Everywhere", "AX88190", 0x820a67b6, 0xab9be5ef),
784 PCMCIA_DEVICE_NULL,
785 };
786 MODULE_DEVICE_TABLE(pcmcia, axnet_ids);
787
788 static struct pcmcia_driver axnet_cs_driver = {
789 .owner = THIS_MODULE,
790 .drv = {
791 .name = "axnet_cs",
792 },
793 .probe = axnet_probe,
794 .remove = axnet_detach,
795 .id_table = axnet_ids,
796 .suspend = axnet_suspend,
797 .resume = axnet_resume,
798 };
799
800 static int __init init_axnet_cs(void)
801 {
802 return pcmcia_register_driver(&axnet_cs_driver);
803 }
804
805 static void __exit exit_axnet_cs(void)
806 {
807 pcmcia_unregister_driver(&axnet_cs_driver);
808 }
809
810 module_init(init_axnet_cs);
811 module_exit(exit_axnet_cs);
812
813 /*====================================================================*/
814
815 /* 8390.c: A general NS8390 ethernet driver core for linux. */
816 /*
817 Written 1992-94 by Donald Becker.
818
819 Copyright 1993 United States Government as represented by the
820 Director, National Security Agency.
821
822 This software may be used and distributed according to the terms
823 of the GNU General Public License, incorporated herein by reference.
824
825 The author may be reached as becker@scyld.com, or C/O
826 Scyld Computing Corporation
827 410 Severn Ave., Suite 210
828 Annapolis MD 21403
829
830 This is the chip-specific code for many 8390-based ethernet adaptors.
831 This is not a complete driver, it must be combined with board-specific
832 code such as ne.c, wd.c, 3c503.c, etc.
833
834 Seeing how at least eight drivers use this code, (not counting the
835 PCMCIA ones either) it is easy to break some card by what seems like
836 a simple innocent change. Please contact me or Donald if you think
837 you have found something that needs changing. -- PG
838
839 Changelog:
840
841 Paul Gortmaker : remove set_bit lock, other cleanups.
842 Paul Gortmaker : add ei_get_8390_hdr() so we can pass skb's to
843 ei_block_input() for eth_io_copy_and_sum().
844 Paul Gortmaker : exchange static int ei_pingpong for a #define,
845 also add better Tx error handling.
846 Paul Gortmaker : rewrite Rx overrun handling as per NS specs.
847 Alexey Kuznetsov : use the 8390's six bit hash multicast filter.
848 Paul Gortmaker : tweak ANK's above multicast changes a bit.
849 Paul Gortmaker : update packet statistics for v2.1.x
850 Alan Cox : support arbitary stupid port mappings on the
851 68K Macintosh. Support >16bit I/O spaces
852 Paul Gortmaker : add kmod support for auto-loading of the 8390
853 module by all drivers that require it.
854 Alan Cox : Spinlocking work, added 'BUG_83C690'
855 Paul Gortmaker : Separate out Tx timeout code from Tx path.
856
857 Sources:
858 The National Semiconductor LAN Databook, and the 3Com 3c503 databook.
859
860 */
861
862 static const char *version_8390 =
863 "8390.c:v1.10cvs 9/23/94 Donald Becker (becker@scyld.com)\n";
864
865 #include <linux/bitops.h>
866 #include <asm/irq.h>
867 #include <linux/fcntl.h>
868 #include <linux/in.h>
869 #include <linux/interrupt.h>
870
871 #include <linux/etherdevice.h>
872
873 #define BUG_83C690
874
875 /* These are the operational function interfaces to board-specific
876 routines.
877 void reset_8390(struct net_device *dev)
878 Resets the board associated with DEV, including a hardware reset of
879 the 8390. This is only called when there is a transmit timeout, and
880 it is always followed by 8390_init().
881 void block_output(struct net_device *dev, int count, const unsigned char *buf,
882 int start_page)
883 Write the COUNT bytes of BUF to the packet buffer at START_PAGE. The
884 "page" value uses the 8390's 256-byte pages.
885 void get_8390_hdr(struct net_device *dev, struct e8390_hdr *hdr, int ring_page)
886 Read the 4 byte, page aligned 8390 header. *If* there is a
887 subsequent read, it will be of the rest of the packet.
888 void block_input(struct net_device *dev, int count, struct sk_buff *skb, int ring_offset)
889 Read COUNT bytes from the packet buffer into the skb data area. Start
890 reading from RING_OFFSET, the address as the 8390 sees it. This will always
891 follow the read of the 8390 header.
892 */
893 #define ei_reset_8390 (ei_local->reset_8390)
894 #define ei_block_output (ei_local->block_output)
895 #define ei_block_input (ei_local->block_input)
896 #define ei_get_8390_hdr (ei_local->get_8390_hdr)
897
898 /* use 0 for production, 1 for verification, >2 for debug */
899 #ifndef ei_debug
900 int ei_debug = 1;
901 #endif
902
903 /* Index to functions. */
904 static void ei_tx_intr(struct net_device *dev);
905 static void ei_tx_err(struct net_device *dev);
906 static void ei_tx_timeout(struct net_device *dev);
907 static void ei_receive(struct net_device *dev);
908 static void ei_rx_overrun(struct net_device *dev);
909
910 /* Routines generic to NS8390-based boards. */
911 static void NS8390_trigger_send(struct net_device *dev, unsigned int length,
912 int start_page);
913 static void set_multicast_list(struct net_device *dev);
914 static void do_set_multicast_list(struct net_device *dev);
915
916 /*
917 * SMP and the 8390 setup.
918 *
919 * The 8390 isnt exactly designed to be multithreaded on RX/TX. There is
920 * a page register that controls bank and packet buffer access. We guard
921 * this with ei_local->page_lock. Nobody should assume or set the page other
922 * than zero when the lock is not held. Lock holders must restore page 0
923 * before unlocking. Even pure readers must take the lock to protect in
924 * page 0.
925 *
926 * To make life difficult the chip can also be very slow. We therefore can't
927 * just use spinlocks. For the longer lockups we disable the irq the device
928 * sits on and hold the lock. We must hold the lock because there is a dual
929 * processor case other than interrupts (get stats/set multicast list in
930 * parallel with each other and transmit).
931 *
932 * Note: in theory we can just disable the irq on the card _but_ there is
933 * a latency on SMP irq delivery. So we can easily go "disable irq" "sync irqs"
934 * enter lock, take the queued irq. So we waddle instead of flying.
935 *
936 * Finally by special arrangement for the purpose of being generally
937 * annoying the transmit function is called bh atomic. That places
938 * restrictions on the user context callers as disable_irq won't save
939 * them.
940 */
941
942 /**
943 * ax_open - Open/initialize the board.
944 * @dev: network device to initialize
945 *
946 * This routine goes all-out, setting everything
947 * up anew at each open, even though many of these registers should only
948 * need to be set once at boot.
949 */
950 static int ax_open(struct net_device *dev)
951 {
952 unsigned long flags;
953 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
954
955 #ifdef HAVE_TX_TIMEOUT
956 /* The card I/O part of the driver (e.g. 3c503) can hook a Tx timeout
957 wrapper that does e.g. media check & then calls ei_tx_timeout. */
958 if (dev->tx_timeout == NULL)
959 dev->tx_timeout = ei_tx_timeout;
960 if (dev->watchdog_timeo <= 0)
961 dev->watchdog_timeo = TX_TIMEOUT;
962 #endif
963
964 /*
965 * Grab the page lock so we own the register set, then call
966 * the init function.
967 */
968
969 spin_lock_irqsave(&ei_local->page_lock, flags);
970 AX88190_init(dev, 1);
971 /* Set the flag before we drop the lock, That way the IRQ arrives
972 after its set and we get no silly warnings */
973 netif_start_queue(dev);
974 spin_unlock_irqrestore(&ei_local->page_lock, flags);
975 ei_local->irqlock = 0;
976 return 0;
977 }
978
979 #define dev_lock(dev) (((struct ei_device *)netdev_priv(dev))->page_lock)
980
981 /**
982 * ax_close - shut down network device
983 * @dev: network device to close
984 *
985 * Opposite of ax_open(). Only used when "ifconfig <devname> down" is done.
986 */
987 static int ax_close(struct net_device *dev)
988 {
989 unsigned long flags;
990
991 /*
992 * Hold the page lock during close
993 */
994
995 spin_lock_irqsave(&dev_lock(dev), flags);
996 AX88190_init(dev, 0);
997 spin_unlock_irqrestore(&dev_lock(dev), flags);
998 netif_stop_queue(dev);
999 return 0;
1000 }
1001
1002 /**
1003 * ei_tx_timeout - handle transmit time out condition
1004 * @dev: network device which has apparently fallen asleep
1005 *
1006 * Called by kernel when device never acknowledges a transmit has
1007 * completed (or failed) - i.e. never posted a Tx related interrupt.
1008 */
1009
1010 static void ei_tx_timeout(struct net_device *dev)
1011 {
1012 long e8390_base = dev->base_addr;
1013 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1014 int txsr, isr, tickssofar = jiffies - dev->trans_start;
1015 unsigned long flags;
1016
1017 dev->stats.tx_errors++;
1018
1019 spin_lock_irqsave(&ei_local->page_lock, flags);
1020 txsr = inb(e8390_base+EN0_TSR);
1021 isr = inb(e8390_base+EN0_ISR);
1022 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1023
1024 printk(KERN_DEBUG "%s: Tx timed out, %s TSR=%#2x, ISR=%#2x, t=%d.\n",
1025 dev->name, (txsr & ENTSR_ABT) ? "excess collisions." :
1026 (isr) ? "lost interrupt?" : "cable problem?", txsr, isr, tickssofar);
1027
1028 if (!isr && !dev->stats.tx_packets)
1029 {
1030 /* The 8390 probably hasn't gotten on the cable yet. */
1031 ei_local->interface_num ^= 1; /* Try a different xcvr. */
1032 }
1033
1034 /* Ugly but a reset can be slow, yet must be protected */
1035
1036 spin_lock_irqsave(&ei_local->page_lock, flags);
1037
1038 /* Try to restart the card. Perhaps the user has fixed something. */
1039 ei_reset_8390(dev);
1040 AX88190_init(dev, 1);
1041
1042 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1043 netif_wake_queue(dev);
1044 }
1045
1046 /**
1047 * ei_start_xmit - begin packet transmission
1048 * @skb: packet to be sent
1049 * @dev: network device to which packet is sent
1050 *
1051 * Sends a packet to an 8390 network device.
1052 */
1053
1054 static int ei_start_xmit(struct sk_buff *skb, struct net_device *dev)
1055 {
1056 long e8390_base = dev->base_addr;
1057 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1058 int length, send_length, output_page;
1059 unsigned long flags;
1060 u8 packet[ETH_ZLEN];
1061
1062 netif_stop_queue(dev);
1063
1064 length = skb->len;
1065
1066 /* Mask interrupts from the ethercard.
1067 SMP: We have to grab the lock here otherwise the IRQ handler
1068 on another CPU can flip window and race the IRQ mask set. We end
1069 up trashing the mcast filter not disabling irqs if we don't lock */
1070
1071 spin_lock_irqsave(&ei_local->page_lock, flags);
1072 outb_p(0x00, e8390_base + EN0_IMR);
1073 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1074
1075 /*
1076 * Slow phase with lock held.
1077 */
1078
1079 spin_lock_irqsave(&ei_local->page_lock, flags);
1080
1081 ei_local->irqlock = 1;
1082
1083 send_length = max(length, ETH_ZLEN);
1084
1085 /*
1086 * We have two Tx slots available for use. Find the first free
1087 * slot, and then perform some sanity checks. With two Tx bufs,
1088 * you get very close to transmitting back-to-back packets. With
1089 * only one Tx buf, the transmitter sits idle while you reload the
1090 * card, leaving a substantial gap between each transmitted packet.
1091 */
1092
1093 if (ei_local->tx1 == 0)
1094 {
1095 output_page = ei_local->tx_start_page;
1096 ei_local->tx1 = send_length;
1097 if (ei_debug && ei_local->tx2 > 0)
1098 printk(KERN_DEBUG "%s: idle transmitter tx2=%d, lasttx=%d, txing=%d.\n",
1099 dev->name, ei_local->tx2, ei_local->lasttx, ei_local->txing);
1100 }
1101 else if (ei_local->tx2 == 0)
1102 {
1103 output_page = ei_local->tx_start_page + TX_PAGES/2;
1104 ei_local->tx2 = send_length;
1105 if (ei_debug && ei_local->tx1 > 0)
1106 printk(KERN_DEBUG "%s: idle transmitter, tx1=%d, lasttx=%d, txing=%d.\n",
1107 dev->name, ei_local->tx1, ei_local->lasttx, ei_local->txing);
1108 }
1109 else
1110 { /* We should never get here. */
1111 if (ei_debug)
1112 printk(KERN_DEBUG "%s: No Tx buffers free! tx1=%d tx2=%d last=%d\n",
1113 dev->name, ei_local->tx1, ei_local->tx2, ei_local->lasttx);
1114 ei_local->irqlock = 0;
1115 netif_stop_queue(dev);
1116 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1117 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1118 dev->stats.tx_errors++;
1119 return 1;
1120 }
1121
1122 /*
1123 * Okay, now upload the packet and trigger a send if the transmitter
1124 * isn't already sending. If it is busy, the interrupt handler will
1125 * trigger the send later, upon receiving a Tx done interrupt.
1126 */
1127
1128 if (length == skb->len)
1129 ei_block_output(dev, length, skb->data, output_page);
1130 else {
1131 memset(packet, 0, ETH_ZLEN);
1132 skb_copy_from_linear_data(skb, packet, skb->len);
1133 ei_block_output(dev, length, packet, output_page);
1134 }
1135
1136 if (! ei_local->txing)
1137 {
1138 ei_local->txing = 1;
1139 NS8390_trigger_send(dev, send_length, output_page);
1140 dev->trans_start = jiffies;
1141 if (output_page == ei_local->tx_start_page)
1142 {
1143 ei_local->tx1 = -1;
1144 ei_local->lasttx = -1;
1145 }
1146 else
1147 {
1148 ei_local->tx2 = -1;
1149 ei_local->lasttx = -2;
1150 }
1151 }
1152 else ei_local->txqueue++;
1153
1154 if (ei_local->tx1 && ei_local->tx2)
1155 netif_stop_queue(dev);
1156 else
1157 netif_start_queue(dev);
1158
1159 /* Turn 8390 interrupts back on. */
1160 ei_local->irqlock = 0;
1161 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1162
1163 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1164
1165 dev_kfree_skb (skb);
1166 dev->stats.tx_bytes += send_length;
1167
1168 return 0;
1169 }
1170
1171 /**
1172 * ax_interrupt - handle the interrupts from an 8390
1173 * @irq: interrupt number
1174 * @dev_id: a pointer to the net_device
1175 * @regs: unused
1176 *
1177 * Handle the ether interface interrupts. We pull packets from
1178 * the 8390 via the card specific functions and fire them at the networking
1179 * stack. We also handle transmit completions and wake the transmit path if
1180 * necessary. We also update the counters and do other housekeeping as
1181 * needed.
1182 */
1183
1184 static irqreturn_t ax_interrupt(int irq, void *dev_id)
1185 {
1186 struct net_device *dev = dev_id;
1187 long e8390_base;
1188 int interrupts, nr_serviced = 0, i;
1189 struct ei_device *ei_local;
1190 int handled = 0;
1191
1192 e8390_base = dev->base_addr;
1193 ei_local = netdev_priv(dev);
1194
1195 /*
1196 * Protect the irq test too.
1197 */
1198
1199 spin_lock(&ei_local->page_lock);
1200
1201 if (ei_local->irqlock)
1202 {
1203 #if 1 /* This might just be an interrupt for a PCI device sharing this line */
1204 /* The "irqlock" check is only for testing. */
1205 printk(ei_local->irqlock
1206 ? "%s: Interrupted while interrupts are masked! isr=%#2x imr=%#2x.\n"
1207 : "%s: Reentering the interrupt handler! isr=%#2x imr=%#2x.\n",
1208 dev->name, inb_p(e8390_base + EN0_ISR),
1209 inb_p(e8390_base + EN0_IMR));
1210 #endif
1211 spin_unlock(&ei_local->page_lock);
1212 return IRQ_NONE;
1213 }
1214
1215 if (ei_debug > 3)
1216 printk(KERN_DEBUG "%s: interrupt(isr=%#2.2x).\n", dev->name,
1217 inb_p(e8390_base + EN0_ISR));
1218
1219 outb_p(0x00, e8390_base + EN0_ISR);
1220 ei_local->irqlock = 1;
1221
1222 /* !!Assumption!! -- we stay in page 0. Don't break this. */
1223 while ((interrupts = inb_p(e8390_base + EN0_ISR)) != 0
1224 && ++nr_serviced < MAX_SERVICE)
1225 {
1226 if (!netif_running(dev) || (interrupts == 0xff)) {
1227 if (ei_debug > 1)
1228 printk(KERN_WARNING "%s: interrupt from stopped card\n", dev->name);
1229 outb_p(interrupts, e8390_base + EN0_ISR);
1230 interrupts = 0;
1231 break;
1232 }
1233 handled = 1;
1234
1235 /* AX88190 bug fix. */
1236 outb_p(interrupts, e8390_base + EN0_ISR);
1237 for (i = 0; i < 10; i++) {
1238 if (!(inb(e8390_base + EN0_ISR) & interrupts))
1239 break;
1240 outb_p(0, e8390_base + EN0_ISR);
1241 outb_p(interrupts, e8390_base + EN0_ISR);
1242 }
1243 if (interrupts & ENISR_OVER)
1244 ei_rx_overrun(dev);
1245 else if (interrupts & (ENISR_RX+ENISR_RX_ERR))
1246 {
1247 /* Got a good (?) packet. */
1248 ei_receive(dev);
1249 }
1250 /* Push the next to-transmit packet through. */
1251 if (interrupts & ENISR_TX)
1252 ei_tx_intr(dev);
1253 else if (interrupts & ENISR_TX_ERR)
1254 ei_tx_err(dev);
1255
1256 if (interrupts & ENISR_COUNTERS)
1257 {
1258 dev->stats.rx_frame_errors += inb_p(e8390_base + EN0_COUNTER0);
1259 dev->stats.rx_crc_errors += inb_p(e8390_base + EN0_COUNTER1);
1260 dev->stats.rx_missed_errors+= inb_p(e8390_base + EN0_COUNTER2);
1261 }
1262 }
1263
1264 if (interrupts && ei_debug > 3)
1265 {
1266 handled = 1;
1267 if (nr_serviced >= MAX_SERVICE)
1268 {
1269 /* 0xFF is valid for a card removal */
1270 if(interrupts!=0xFF)
1271 printk(KERN_WARNING "%s: Too much work at interrupt, status %#2.2x\n",
1272 dev->name, interrupts);
1273 outb_p(ENISR_ALL, e8390_base + EN0_ISR); /* Ack. most intrs. */
1274 } else {
1275 printk(KERN_WARNING "%s: unknown interrupt %#2x\n", dev->name, interrupts);
1276 outb_p(0xff, e8390_base + EN0_ISR); /* Ack. all intrs. */
1277 }
1278 }
1279
1280 /* Turn 8390 interrupts back on. */
1281 ei_local->irqlock = 0;
1282 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1283
1284 spin_unlock(&ei_local->page_lock);
1285 return IRQ_RETVAL(handled);
1286 }
1287
1288 /**
1289 * ei_tx_err - handle transmitter error
1290 * @dev: network device which threw the exception
1291 *
1292 * A transmitter error has happened. Most likely excess collisions (which
1293 * is a fairly normal condition). If the error is one where the Tx will
1294 * have been aborted, we try and send another one right away, instead of
1295 * letting the failed packet sit and collect dust in the Tx buffer. This
1296 * is a much better solution as it avoids kernel based Tx timeouts, and
1297 * an unnecessary card reset.
1298 *
1299 * Called with lock held.
1300 */
1301
1302 static void ei_tx_err(struct net_device *dev)
1303 {
1304 long e8390_base = dev->base_addr;
1305 unsigned char txsr = inb_p(e8390_base+EN0_TSR);
1306 unsigned char tx_was_aborted = txsr & (ENTSR_ABT+ENTSR_FU);
1307
1308 #ifdef VERBOSE_ERROR_DUMP
1309 printk(KERN_DEBUG "%s: transmitter error (%#2x): ", dev->name, txsr);
1310 if (txsr & ENTSR_ABT)
1311 printk("excess-collisions ");
1312 if (txsr & ENTSR_ND)
1313 printk("non-deferral ");
1314 if (txsr & ENTSR_CRS)
1315 printk("lost-carrier ");
1316 if (txsr & ENTSR_FU)
1317 printk("FIFO-underrun ");
1318 if (txsr & ENTSR_CDH)
1319 printk("lost-heartbeat ");
1320 printk("\n");
1321 #endif
1322
1323 if (tx_was_aborted)
1324 ei_tx_intr(dev);
1325 else
1326 {
1327 dev->stats.tx_errors++;
1328 if (txsr & ENTSR_CRS) dev->stats.tx_carrier_errors++;
1329 if (txsr & ENTSR_CDH) dev->stats.tx_heartbeat_errors++;
1330 if (txsr & ENTSR_OWC) dev->stats.tx_window_errors++;
1331 }
1332 }
1333
1334 /**
1335 * ei_tx_intr - transmit interrupt handler
1336 * @dev: network device for which tx intr is handled
1337 *
1338 * We have finished a transmit: check for errors and then trigger the next
1339 * packet to be sent. Called with lock held.
1340 */
1341
1342 static void ei_tx_intr(struct net_device *dev)
1343 {
1344 long e8390_base = dev->base_addr;
1345 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1346 int status = inb(e8390_base + EN0_TSR);
1347
1348 /*
1349 * There are two Tx buffers, see which one finished, and trigger
1350 * the send of another one if it exists.
1351 */
1352 ei_local->txqueue--;
1353
1354 if (ei_local->tx1 < 0)
1355 {
1356 if (ei_local->lasttx != 1 && ei_local->lasttx != -1)
1357 printk(KERN_ERR "%s: bogus last_tx_buffer %d, tx1=%d.\n",
1358 ei_local->name, ei_local->lasttx, ei_local->tx1);
1359 ei_local->tx1 = 0;
1360 if (ei_local->tx2 > 0)
1361 {
1362 ei_local->txing = 1;
1363 NS8390_trigger_send(dev, ei_local->tx2, ei_local->tx_start_page + 6);
1364 dev->trans_start = jiffies;
1365 ei_local->tx2 = -1,
1366 ei_local->lasttx = 2;
1367 }
1368 else ei_local->lasttx = 20, ei_local->txing = 0;
1369 }
1370 else if (ei_local->tx2 < 0)
1371 {
1372 if (ei_local->lasttx != 2 && ei_local->lasttx != -2)
1373 printk("%s: bogus last_tx_buffer %d, tx2=%d.\n",
1374 ei_local->name, ei_local->lasttx, ei_local->tx2);
1375 ei_local->tx2 = 0;
1376 if (ei_local->tx1 > 0)
1377 {
1378 ei_local->txing = 1;
1379 NS8390_trigger_send(dev, ei_local->tx1, ei_local->tx_start_page);
1380 dev->trans_start = jiffies;
1381 ei_local->tx1 = -1;
1382 ei_local->lasttx = 1;
1383 }
1384 else
1385 ei_local->lasttx = 10, ei_local->txing = 0;
1386 }
1387 // else printk(KERN_WARNING "%s: unexpected TX-done interrupt, lasttx=%d.\n",
1388 // dev->name, ei_local->lasttx);
1389
1390 /* Minimize Tx latency: update the statistics after we restart TXing. */
1391 if (status & ENTSR_COL)
1392 dev->stats.collisions++;
1393 if (status & ENTSR_PTX)
1394 dev->stats.tx_packets++;
1395 else
1396 {
1397 dev->stats.tx_errors++;
1398 if (status & ENTSR_ABT)
1399 {
1400 dev->stats.tx_aborted_errors++;
1401 dev->stats.collisions += 16;
1402 }
1403 if (status & ENTSR_CRS)
1404 dev->stats.tx_carrier_errors++;
1405 if (status & ENTSR_FU)
1406 dev->stats.tx_fifo_errors++;
1407 if (status & ENTSR_CDH)
1408 dev->stats.tx_heartbeat_errors++;
1409 if (status & ENTSR_OWC)
1410 dev->stats.tx_window_errors++;
1411 }
1412 netif_wake_queue(dev);
1413 }
1414
1415 /**
1416 * ei_receive - receive some packets
1417 * @dev: network device with which receive will be run
1418 *
1419 * We have a good packet(s), get it/them out of the buffers.
1420 * Called with lock held.
1421 */
1422
1423 static void ei_receive(struct net_device *dev)
1424 {
1425 long e8390_base = dev->base_addr;
1426 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1427 unsigned char rxing_page, this_frame, next_frame;
1428 unsigned short current_offset;
1429 int rx_pkt_count = 0;
1430 struct e8390_pkt_hdr rx_frame;
1431
1432 while (++rx_pkt_count < 10)
1433 {
1434 int pkt_len, pkt_stat;
1435
1436 /* Get the rx page (incoming packet pointer). */
1437 rxing_page = inb_p(e8390_base + EN1_CURPAG -1);
1438
1439 /* Remove one frame from the ring. Boundary is always a page behind. */
1440 this_frame = inb_p(e8390_base + EN0_BOUNDARY) + 1;
1441 if (this_frame >= ei_local->stop_page)
1442 this_frame = ei_local->rx_start_page;
1443
1444 /* Someday we'll omit the previous, iff we never get this message.
1445 (There is at least one clone claimed to have a problem.)
1446
1447 Keep quiet if it looks like a card removal. One problem here
1448 is that some clones crash in roughly the same way.
1449 */
1450 if (ei_debug > 0 && this_frame != ei_local->current_page && (this_frame!=0x0 || rxing_page!=0xFF))
1451 printk(KERN_ERR "%s: mismatched read page pointers %2x vs %2x.\n",
1452 dev->name, this_frame, ei_local->current_page);
1453
1454 if (this_frame == rxing_page) /* Read all the frames? */
1455 break; /* Done for now */
1456
1457 current_offset = this_frame << 8;
1458 ei_get_8390_hdr(dev, &rx_frame, this_frame);
1459
1460 pkt_len = rx_frame.count - sizeof(struct e8390_pkt_hdr);
1461 pkt_stat = rx_frame.status;
1462
1463 next_frame = this_frame + 1 + ((pkt_len+4)>>8);
1464
1465 if (pkt_len < 60 || pkt_len > 1518)
1466 {
1467 if (ei_debug)
1468 printk(KERN_DEBUG "%s: bogus packet size: %d, status=%#2x nxpg=%#2x.\n",
1469 dev->name, rx_frame.count, rx_frame.status,
1470 rx_frame.next);
1471 dev->stats.rx_errors++;
1472 dev->stats.rx_length_errors++;
1473 }
1474 else if ((pkt_stat & 0x0F) == ENRSR_RXOK)
1475 {
1476 struct sk_buff *skb;
1477
1478 skb = dev_alloc_skb(pkt_len+2);
1479 if (skb == NULL)
1480 {
1481 if (ei_debug > 1)
1482 printk(KERN_DEBUG "%s: Couldn't allocate a sk_buff of size %d.\n",
1483 dev->name, pkt_len);
1484 dev->stats.rx_dropped++;
1485 break;
1486 }
1487 else
1488 {
1489 skb_reserve(skb,2); /* IP headers on 16 byte boundaries */
1490 skb_put(skb, pkt_len); /* Make room */
1491 ei_block_input(dev, pkt_len, skb, current_offset + sizeof(rx_frame));
1492 skb->protocol=eth_type_trans(skb,dev);
1493 netif_rx(skb);
1494 dev->last_rx = jiffies;
1495 dev->stats.rx_packets++;
1496 dev->stats.rx_bytes += pkt_len;
1497 if (pkt_stat & ENRSR_PHY)
1498 dev->stats.multicast++;
1499 }
1500 }
1501 else
1502 {
1503 if (ei_debug)
1504 printk(KERN_DEBUG "%s: bogus packet: status=%#2x nxpg=%#2x size=%d\n",
1505 dev->name, rx_frame.status, rx_frame.next,
1506 rx_frame.count);
1507 dev->stats.rx_errors++;
1508 /* NB: The NIC counts CRC, frame and missed errors. */
1509 if (pkt_stat & ENRSR_FO)
1510 dev->stats.rx_fifo_errors++;
1511 }
1512 next_frame = rx_frame.next;
1513
1514 /* This _should_ never happen: it's here for avoiding bad clones. */
1515 if (next_frame >= ei_local->stop_page) {
1516 printk("%s: next frame inconsistency, %#2x\n", dev->name,
1517 next_frame);
1518 next_frame = ei_local->rx_start_page;
1519 }
1520 ei_local->current_page = next_frame;
1521 outb_p(next_frame-1, e8390_base+EN0_BOUNDARY);
1522 }
1523
1524 return;
1525 }
1526
1527 /**
1528 * ei_rx_overrun - handle receiver overrun
1529 * @dev: network device which threw exception
1530 *
1531 * We have a receiver overrun: we have to kick the 8390 to get it started
1532 * again. Problem is that you have to kick it exactly as NS prescribes in
1533 * the updated datasheets, or "the NIC may act in an unpredictable manner."
1534 * This includes causing "the NIC to defer indefinitely when it is stopped
1535 * on a busy network." Ugh.
1536 * Called with lock held. Don't call this with the interrupts off or your
1537 * computer will hate you - it takes 10ms or so.
1538 */
1539
1540 static void ei_rx_overrun(struct net_device *dev)
1541 {
1542 axnet_dev_t *info = PRIV(dev);
1543 long e8390_base = dev->base_addr;
1544 unsigned char was_txing, must_resend = 0;
1545
1546 /*
1547 * Record whether a Tx was in progress and then issue the
1548 * stop command.
1549 */
1550 was_txing = inb_p(e8390_base+E8390_CMD) & E8390_TRANS;
1551 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, e8390_base+E8390_CMD);
1552
1553 if (ei_debug > 1)
1554 printk(KERN_DEBUG "%s: Receiver overrun.\n", dev->name);
1555 dev->stats.rx_over_errors++;
1556
1557 /*
1558 * Wait a full Tx time (1.2ms) + some guard time, NS says 1.6ms total.
1559 * Early datasheets said to poll the reset bit, but now they say that
1560 * it "is not a reliable indicator and subsequently should be ignored."
1561 * We wait at least 10ms.
1562 */
1563
1564 mdelay(10);
1565
1566 /*
1567 * Reset RBCR[01] back to zero as per magic incantation.
1568 */
1569 outb_p(0x00, e8390_base+EN0_RCNTLO);
1570 outb_p(0x00, e8390_base+EN0_RCNTHI);
1571
1572 /*
1573 * See if any Tx was interrupted or not. According to NS, this
1574 * step is vital, and skipping it will cause no end of havoc.
1575 */
1576
1577 if (was_txing)
1578 {
1579 unsigned char tx_completed = inb_p(e8390_base+EN0_ISR) & (ENISR_TX+ENISR_TX_ERR);
1580 if (!tx_completed)
1581 must_resend = 1;
1582 }
1583
1584 /*
1585 * Have to enter loopback mode and then restart the NIC before
1586 * you are allowed to slurp packets up off the ring.
1587 */
1588 outb_p(E8390_TXOFF, e8390_base + EN0_TXCR);
1589 outb_p(E8390_NODMA + E8390_PAGE0 + E8390_START, e8390_base + E8390_CMD);
1590
1591 /*
1592 * Clear the Rx ring of all the debris, and ack the interrupt.
1593 */
1594 ei_receive(dev);
1595
1596 /*
1597 * Leave loopback mode, and resend any packet that got stopped.
1598 */
1599 outb_p(E8390_TXCONFIG | info->duplex_flag, e8390_base + EN0_TXCR);
1600 if (must_resend)
1601 outb_p(E8390_NODMA + E8390_PAGE0 + E8390_START + E8390_TRANS, e8390_base + E8390_CMD);
1602 }
1603
1604 /*
1605 * Collect the stats. This is called unlocked and from several contexts.
1606 */
1607
1608 static struct net_device_stats *get_stats(struct net_device *dev)
1609 {
1610 long ioaddr = dev->base_addr;
1611 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1612 unsigned long flags;
1613
1614 /* If the card is stopped, just return the present stats. */
1615 if (!netif_running(dev))
1616 return &dev->stats;
1617
1618 spin_lock_irqsave(&ei_local->page_lock,flags);
1619 /* Read the counter registers, assuming we are in page 0. */
1620 dev->stats.rx_frame_errors += inb_p(ioaddr + EN0_COUNTER0);
1621 dev->stats.rx_crc_errors += inb_p(ioaddr + EN0_COUNTER1);
1622 dev->stats.rx_missed_errors+= inb_p(ioaddr + EN0_COUNTER2);
1623 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1624
1625 return &dev->stats;
1626 }
1627
1628 /*
1629 * Form the 64 bit 8390 multicast table from the linked list of addresses
1630 * associated with this dev structure.
1631 */
1632
1633 static inline void make_mc_bits(u8 *bits, struct net_device *dev)
1634 {
1635 struct dev_mc_list *dmi;
1636 u32 crc;
1637
1638 for (dmi=dev->mc_list; dmi; dmi=dmi->next) {
1639
1640 crc = ether_crc(ETH_ALEN, dmi->dmi_addr);
1641 /*
1642 * The 8390 uses the 6 most significant bits of the
1643 * CRC to index the multicast table.
1644 */
1645 bits[crc>>29] |= (1<<((crc>>26)&7));
1646 }
1647 }
1648
1649 /**
1650 * do_set_multicast_list - set/clear multicast filter
1651 * @dev: net device for which multicast filter is adjusted
1652 *
1653 * Set or clear the multicast filter for this adaptor.
1654 * Must be called with lock held.
1655 */
1656
1657 static void do_set_multicast_list(struct net_device *dev)
1658 {
1659 long e8390_base = dev->base_addr;
1660 int i;
1661 struct ei_device *ei_local = (struct ei_device*)netdev_priv(dev);
1662
1663 if (!(dev->flags&(IFF_PROMISC|IFF_ALLMULTI))) {
1664 memset(ei_local->mcfilter, 0, 8);
1665 if (dev->mc_list)
1666 make_mc_bits(ei_local->mcfilter, dev);
1667 } else {
1668 /* set to accept-all */
1669 memset(ei_local->mcfilter, 0xFF, 8);
1670 }
1671
1672 outb_p(E8390_NODMA + E8390_PAGE1, e8390_base + E8390_CMD);
1673 for(i = 0; i < 8; i++)
1674 {
1675 outb_p(ei_local->mcfilter[i], e8390_base + EN1_MULT_SHIFT(i));
1676 }
1677 outb_p(E8390_NODMA + E8390_PAGE0, e8390_base + E8390_CMD);
1678
1679 if(dev->flags&IFF_PROMISC)
1680 outb_p(E8390_RXCONFIG | 0x58, e8390_base + EN0_RXCR);
1681 else if(dev->flags&IFF_ALLMULTI || dev->mc_list)
1682 outb_p(E8390_RXCONFIG | 0x48, e8390_base + EN0_RXCR);
1683 else
1684 outb_p(E8390_RXCONFIG | 0x40, e8390_base + EN0_RXCR);
1685
1686 outb_p(E8390_NODMA+E8390_PAGE0+E8390_START, e8390_base+E8390_CMD);
1687 }
1688
1689 /*
1690 * Called without lock held. This is invoked from user context and may
1691 * be parallel to just about everything else. Its also fairly quick and
1692 * not called too often. Must protect against both bh and irq users
1693 */
1694
1695 static void set_multicast_list(struct net_device *dev)
1696 {
1697 unsigned long flags;
1698
1699 spin_lock_irqsave(&dev_lock(dev), flags);
1700 do_set_multicast_list(dev);
1701 spin_unlock_irqrestore(&dev_lock(dev), flags);
1702 }
1703
1704 /**
1705 * axdev_setup - init rest of 8390 device struct
1706 * @dev: network device structure to init
1707 *
1708 * Initialize the rest of the 8390 device structure. Do NOT __init
1709 * this, as it is used by 8390 based modular drivers too.
1710 */
1711
1712 static void axdev_setup(struct net_device *dev)
1713 {
1714 struct ei_device *ei_local;
1715 if (ei_debug > 1)
1716 printk(version_8390);
1717
1718 ei_local = (struct ei_device *)netdev_priv(dev);
1719 spin_lock_init(&ei_local->page_lock);
1720
1721 dev->hard_start_xmit = &ei_start_xmit;
1722 dev->get_stats = get_stats;
1723 dev->set_multicast_list = &set_multicast_list;
1724
1725 ether_setup(dev);
1726 }
1727
1728 /* This page of functions should be 8390 generic */
1729 /* Follow National Semi's recommendations for initializing the "NIC". */
1730
1731 /**
1732 * AX88190_init - initialize 8390 hardware
1733 * @dev: network device to initialize
1734 * @startp: boolean. non-zero value to initiate chip processing
1735 *
1736 * Must be called with lock held.
1737 */
1738
1739 static void AX88190_init(struct net_device *dev, int startp)
1740 {
1741 axnet_dev_t *info = PRIV(dev);
1742 long e8390_base = dev->base_addr;
1743 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1744 int i;
1745 int endcfg = ei_local->word16 ? (0x48 | ENDCFG_WTS) : 0x48;
1746
1747 if(sizeof(struct e8390_pkt_hdr)!=4)
1748 panic("8390.c: header struct mispacked\n");
1749 /* Follow National Semi's recommendations for initing the DP83902. */
1750 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, e8390_base+E8390_CMD); /* 0x21 */
1751 outb_p(endcfg, e8390_base + EN0_DCFG); /* 0x48 or 0x49 */
1752 /* Clear the remote byte count registers. */
1753 outb_p(0x00, e8390_base + EN0_RCNTLO);
1754 outb_p(0x00, e8390_base + EN0_RCNTHI);
1755 /* Set to monitor and loopback mode -- this is vital!. */
1756 outb_p(E8390_RXOFF|0x40, e8390_base + EN0_RXCR); /* 0x60 */
1757 outb_p(E8390_TXOFF, e8390_base + EN0_TXCR); /* 0x02 */
1758 /* Set the transmit page and receive ring. */
1759 outb_p(ei_local->tx_start_page, e8390_base + EN0_TPSR);
1760 ei_local->tx1 = ei_local->tx2 = 0;
1761 outb_p(ei_local->rx_start_page, e8390_base + EN0_STARTPG);
1762 outb_p(ei_local->stop_page-1, e8390_base + EN0_BOUNDARY); /* 3c503 says 0x3f,NS0x26*/
1763 ei_local->current_page = ei_local->rx_start_page; /* assert boundary+1 */
1764 outb_p(ei_local->stop_page, e8390_base + EN0_STOPPG);
1765 /* Clear the pending interrupts and mask. */
1766 outb_p(0xFF, e8390_base + EN0_ISR);
1767 outb_p(0x00, e8390_base + EN0_IMR);
1768
1769 /* Copy the station address into the DS8390 registers. */
1770
1771 outb_p(E8390_NODMA + E8390_PAGE1 + E8390_STOP, e8390_base+E8390_CMD); /* 0x61 */
1772 for(i = 0; i < 6; i++)
1773 {
1774 outb_p(dev->dev_addr[i], e8390_base + EN1_PHYS_SHIFT(i));
1775 if(inb_p(e8390_base + EN1_PHYS_SHIFT(i))!=dev->dev_addr[i])
1776 printk(KERN_ERR "Hw. address read/write mismap %d\n",i);
1777 }
1778
1779 outb_p(ei_local->rx_start_page, e8390_base + EN1_CURPAG);
1780 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, e8390_base+E8390_CMD);
1781
1782 netif_start_queue(dev);
1783 ei_local->tx1 = ei_local->tx2 = 0;
1784 ei_local->txing = 0;
1785
1786 if (startp)
1787 {
1788 outb_p(0xff, e8390_base + EN0_ISR);
1789 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1790 outb_p(E8390_NODMA+E8390_PAGE0+E8390_START, e8390_base+E8390_CMD);
1791 outb_p(E8390_TXCONFIG | info->duplex_flag,
1792 e8390_base + EN0_TXCR); /* xmit on. */
1793 /* 3c503 TechMan says rxconfig only after the NIC is started. */
1794 outb_p(E8390_RXCONFIG | 0x40, e8390_base + EN0_RXCR); /* rx on, */
1795 do_set_multicast_list(dev); /* (re)load the mcast table */
1796 }
1797 }
1798
1799 /* Trigger a transmit start, assuming the length is valid.
1800 Always called with the page lock held */
1801
1802 static void NS8390_trigger_send(struct net_device *dev, unsigned int length,
1803 int start_page)
1804 {
1805 long e8390_base = dev->base_addr;
1806 struct ei_device *ei_local __attribute((unused)) = (struct ei_device *) netdev_priv(dev);
1807
1808 if (inb_p(e8390_base) & E8390_TRANS)
1809 {
1810 printk(KERN_WARNING "%s: trigger_send() called with the transmitter busy.\n",
1811 dev->name);
1812 return;
1813 }
1814 outb_p(length & 0xff, e8390_base + EN0_TCNTLO);
1815 outb_p(length >> 8, e8390_base + EN0_TCNTHI);
1816 outb_p(start_page, e8390_base + EN0_TPSR);
1817 outb_p(E8390_NODMA+E8390_TRANS+E8390_START, e8390_base+E8390_CMD);
1818 }
This page took 0.09917 seconds and 6 git commands to generate.