net: convert print_mac to %pM
[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 == 0)
280 return ret;
281 }
282 return ret;
283 } else {
284 return pcmcia_request_io(link, &link->io);
285 }
286 }
287
288 static int axnet_configcheck(struct pcmcia_device *p_dev,
289 cistpl_cftable_entry_t *cfg,
290 cistpl_cftable_entry_t *dflt,
291 unsigned int vcc,
292 void *priv_data)
293 {
294 int i;
295 cistpl_io_t *io = &cfg->io;
296
297 if (cfg->index == 0 || cfg->io.nwin == 0)
298 return -ENODEV;
299
300 p_dev->conf.ConfigIndex = 0x05;
301 /* For multifunction cards, by convention, we configure the
302 network function with window 0, and serial with window 1 */
303 if (io->nwin > 1) {
304 i = (io->win[1].len > io->win[0].len);
305 p_dev->io.BasePort2 = io->win[1-i].base;
306 p_dev->io.NumPorts2 = io->win[1-i].len;
307 } else {
308 i = p_dev->io.NumPorts2 = 0;
309 }
310 p_dev->io.BasePort1 = io->win[i].base;
311 p_dev->io.NumPorts1 = io->win[i].len;
312 p_dev->io.IOAddrLines = io->flags & CISTPL_IO_LINES_MASK;
313 if (p_dev->io.NumPorts1 + p_dev->io.NumPorts2 >= 32)
314 return try_io_port(p_dev);
315
316 return -ENODEV;
317 }
318
319 static int axnet_config(struct pcmcia_device *link)
320 {
321 struct net_device *dev = link->priv;
322 axnet_dev_t *info = PRIV(dev);
323 int i, j, last_ret, last_fn;
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 != 0) {
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 %pM\n",
400 dev->name, ((info->flags & IS_AX88790) ? 7 : 1),
401 dev->base_addr, dev->irq,
402 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("IO DATA", "ETXPCM", 0x547e66dc, 0x233adac2),
779 PCMCIA_DEVICE_PROD_ID12("Linksys", "EtherFast 10/100 PC Card (PCMPC100 V3)", 0x0733cc81, 0x232019a8),
780 PCMCIA_DEVICE_PROD_ID12("MELCO", "LPC3-TX", 0x481e0094, 0xf91af609),
781 PCMCIA_DEVICE_PROD_ID12("PCMCIA", "100BASE", 0x281f1c5d, 0x7c2add04),
782 PCMCIA_DEVICE_PROD_ID12("PCMCIA", "FastEtherCard", 0x281f1c5d, 0x7ef26116),
783 PCMCIA_DEVICE_PROD_ID12("PCMCIA", "FEP501", 0x281f1c5d, 0x2e272058),
784 PCMCIA_DEVICE_PROD_ID14("Network Everywhere", "AX88190", 0x820a67b6, 0xab9be5ef),
785 PCMCIA_DEVICE_NULL,
786 };
787 MODULE_DEVICE_TABLE(pcmcia, axnet_ids);
788
789 static struct pcmcia_driver axnet_cs_driver = {
790 .owner = THIS_MODULE,
791 .drv = {
792 .name = "axnet_cs",
793 },
794 .probe = axnet_probe,
795 .remove = axnet_detach,
796 .id_table = axnet_ids,
797 .suspend = axnet_suspend,
798 .resume = axnet_resume,
799 };
800
801 static int __init init_axnet_cs(void)
802 {
803 return pcmcia_register_driver(&axnet_cs_driver);
804 }
805
806 static void __exit exit_axnet_cs(void)
807 {
808 pcmcia_unregister_driver(&axnet_cs_driver);
809 }
810
811 module_init(init_axnet_cs);
812 module_exit(exit_axnet_cs);
813
814 /*====================================================================*/
815
816 /* 8390.c: A general NS8390 ethernet driver core for linux. */
817 /*
818 Written 1992-94 by Donald Becker.
819
820 Copyright 1993 United States Government as represented by the
821 Director, National Security Agency.
822
823 This software may be used and distributed according to the terms
824 of the GNU General Public License, incorporated herein by reference.
825
826 The author may be reached as becker@scyld.com, or C/O
827 Scyld Computing Corporation
828 410 Severn Ave., Suite 210
829 Annapolis MD 21403
830
831 This is the chip-specific code for many 8390-based ethernet adaptors.
832 This is not a complete driver, it must be combined with board-specific
833 code such as ne.c, wd.c, 3c503.c, etc.
834
835 Seeing how at least eight drivers use this code, (not counting the
836 PCMCIA ones either) it is easy to break some card by what seems like
837 a simple innocent change. Please contact me or Donald if you think
838 you have found something that needs changing. -- PG
839
840 Changelog:
841
842 Paul Gortmaker : remove set_bit lock, other cleanups.
843 Paul Gortmaker : add ei_get_8390_hdr() so we can pass skb's to
844 ei_block_input() for eth_io_copy_and_sum().
845 Paul Gortmaker : exchange static int ei_pingpong for a #define,
846 also add better Tx error handling.
847 Paul Gortmaker : rewrite Rx overrun handling as per NS specs.
848 Alexey Kuznetsov : use the 8390's six bit hash multicast filter.
849 Paul Gortmaker : tweak ANK's above multicast changes a bit.
850 Paul Gortmaker : update packet statistics for v2.1.x
851 Alan Cox : support arbitary stupid port mappings on the
852 68K Macintosh. Support >16bit I/O spaces
853 Paul Gortmaker : add kmod support for auto-loading of the 8390
854 module by all drivers that require it.
855 Alan Cox : Spinlocking work, added 'BUG_83C690'
856 Paul Gortmaker : Separate out Tx timeout code from Tx path.
857
858 Sources:
859 The National Semiconductor LAN Databook, and the 3Com 3c503 databook.
860
861 */
862
863 static const char *version_8390 =
864 "8390.c:v1.10cvs 9/23/94 Donald Becker (becker@scyld.com)\n";
865
866 #include <linux/bitops.h>
867 #include <asm/irq.h>
868 #include <linux/fcntl.h>
869 #include <linux/in.h>
870 #include <linux/interrupt.h>
871
872 #include <linux/etherdevice.h>
873
874 #define BUG_83C690
875
876 /* These are the operational function interfaces to board-specific
877 routines.
878 void reset_8390(struct net_device *dev)
879 Resets the board associated with DEV, including a hardware reset of
880 the 8390. This is only called when there is a transmit timeout, and
881 it is always followed by 8390_init().
882 void block_output(struct net_device *dev, int count, const unsigned char *buf,
883 int start_page)
884 Write the COUNT bytes of BUF to the packet buffer at START_PAGE. The
885 "page" value uses the 8390's 256-byte pages.
886 void get_8390_hdr(struct net_device *dev, struct e8390_hdr *hdr, int ring_page)
887 Read the 4 byte, page aligned 8390 header. *If* there is a
888 subsequent read, it will be of the rest of the packet.
889 void block_input(struct net_device *dev, int count, struct sk_buff *skb, int ring_offset)
890 Read COUNT bytes from the packet buffer into the skb data area. Start
891 reading from RING_OFFSET, the address as the 8390 sees it. This will always
892 follow the read of the 8390 header.
893 */
894 #define ei_reset_8390 (ei_local->reset_8390)
895 #define ei_block_output (ei_local->block_output)
896 #define ei_block_input (ei_local->block_input)
897 #define ei_get_8390_hdr (ei_local->get_8390_hdr)
898
899 /* use 0 for production, 1 for verification, >2 for debug */
900 #ifndef ei_debug
901 int ei_debug = 1;
902 #endif
903
904 /* Index to functions. */
905 static void ei_tx_intr(struct net_device *dev);
906 static void ei_tx_err(struct net_device *dev);
907 static void ei_tx_timeout(struct net_device *dev);
908 static void ei_receive(struct net_device *dev);
909 static void ei_rx_overrun(struct net_device *dev);
910
911 /* Routines generic to NS8390-based boards. */
912 static void NS8390_trigger_send(struct net_device *dev, unsigned int length,
913 int start_page);
914 static void set_multicast_list(struct net_device *dev);
915 static void do_set_multicast_list(struct net_device *dev);
916
917 /*
918 * SMP and the 8390 setup.
919 *
920 * The 8390 isnt exactly designed to be multithreaded on RX/TX. There is
921 * a page register that controls bank and packet buffer access. We guard
922 * this with ei_local->page_lock. Nobody should assume or set the page other
923 * than zero when the lock is not held. Lock holders must restore page 0
924 * before unlocking. Even pure readers must take the lock to protect in
925 * page 0.
926 *
927 * To make life difficult the chip can also be very slow. We therefore can't
928 * just use spinlocks. For the longer lockups we disable the irq the device
929 * sits on and hold the lock. We must hold the lock because there is a dual
930 * processor case other than interrupts (get stats/set multicast list in
931 * parallel with each other and transmit).
932 *
933 * Note: in theory we can just disable the irq on the card _but_ there is
934 * a latency on SMP irq delivery. So we can easily go "disable irq" "sync irqs"
935 * enter lock, take the queued irq. So we waddle instead of flying.
936 *
937 * Finally by special arrangement for the purpose of being generally
938 * annoying the transmit function is called bh atomic. That places
939 * restrictions on the user context callers as disable_irq won't save
940 * them.
941 */
942
943 /**
944 * ax_open - Open/initialize the board.
945 * @dev: network device to initialize
946 *
947 * This routine goes all-out, setting everything
948 * up anew at each open, even though many of these registers should only
949 * need to be set once at boot.
950 */
951 static int ax_open(struct net_device *dev)
952 {
953 unsigned long flags;
954 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
955
956 #ifdef HAVE_TX_TIMEOUT
957 /* The card I/O part of the driver (e.g. 3c503) can hook a Tx timeout
958 wrapper that does e.g. media check & then calls ei_tx_timeout. */
959 if (dev->tx_timeout == NULL)
960 dev->tx_timeout = ei_tx_timeout;
961 if (dev->watchdog_timeo <= 0)
962 dev->watchdog_timeo = TX_TIMEOUT;
963 #endif
964
965 /*
966 * Grab the page lock so we own the register set, then call
967 * the init function.
968 */
969
970 spin_lock_irqsave(&ei_local->page_lock, flags);
971 AX88190_init(dev, 1);
972 /* Set the flag before we drop the lock, That way the IRQ arrives
973 after its set and we get no silly warnings */
974 netif_start_queue(dev);
975 spin_unlock_irqrestore(&ei_local->page_lock, flags);
976 ei_local->irqlock = 0;
977 return 0;
978 }
979
980 #define dev_lock(dev) (((struct ei_device *)netdev_priv(dev))->page_lock)
981
982 /**
983 * ax_close - shut down network device
984 * @dev: network device to close
985 *
986 * Opposite of ax_open(). Only used when "ifconfig <devname> down" is done.
987 */
988 static int ax_close(struct net_device *dev)
989 {
990 unsigned long flags;
991
992 /*
993 * Hold the page lock during close
994 */
995
996 spin_lock_irqsave(&dev_lock(dev), flags);
997 AX88190_init(dev, 0);
998 spin_unlock_irqrestore(&dev_lock(dev), flags);
999 netif_stop_queue(dev);
1000 return 0;
1001 }
1002
1003 /**
1004 * ei_tx_timeout - handle transmit time out condition
1005 * @dev: network device which has apparently fallen asleep
1006 *
1007 * Called by kernel when device never acknowledges a transmit has
1008 * completed (or failed) - i.e. never posted a Tx related interrupt.
1009 */
1010
1011 static void ei_tx_timeout(struct net_device *dev)
1012 {
1013 long e8390_base = dev->base_addr;
1014 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1015 int txsr, isr, tickssofar = jiffies - dev->trans_start;
1016 unsigned long flags;
1017
1018 dev->stats.tx_errors++;
1019
1020 spin_lock_irqsave(&ei_local->page_lock, flags);
1021 txsr = inb(e8390_base+EN0_TSR);
1022 isr = inb(e8390_base+EN0_ISR);
1023 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1024
1025 printk(KERN_DEBUG "%s: Tx timed out, %s TSR=%#2x, ISR=%#2x, t=%d.\n",
1026 dev->name, (txsr & ENTSR_ABT) ? "excess collisions." :
1027 (isr) ? "lost interrupt?" : "cable problem?", txsr, isr, tickssofar);
1028
1029 if (!isr && !dev->stats.tx_packets)
1030 {
1031 /* The 8390 probably hasn't gotten on the cable yet. */
1032 ei_local->interface_num ^= 1; /* Try a different xcvr. */
1033 }
1034
1035 /* Ugly but a reset can be slow, yet must be protected */
1036
1037 spin_lock_irqsave(&ei_local->page_lock, flags);
1038
1039 /* Try to restart the card. Perhaps the user has fixed something. */
1040 ei_reset_8390(dev);
1041 AX88190_init(dev, 1);
1042
1043 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1044 netif_wake_queue(dev);
1045 }
1046
1047 /**
1048 * ei_start_xmit - begin packet transmission
1049 * @skb: packet to be sent
1050 * @dev: network device to which packet is sent
1051 *
1052 * Sends a packet to an 8390 network device.
1053 */
1054
1055 static int ei_start_xmit(struct sk_buff *skb, struct net_device *dev)
1056 {
1057 long e8390_base = dev->base_addr;
1058 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1059 int length, send_length, output_page;
1060 unsigned long flags;
1061 u8 packet[ETH_ZLEN];
1062
1063 netif_stop_queue(dev);
1064
1065 length = skb->len;
1066
1067 /* Mask interrupts from the ethercard.
1068 SMP: We have to grab the lock here otherwise the IRQ handler
1069 on another CPU can flip window and race the IRQ mask set. We end
1070 up trashing the mcast filter not disabling irqs if we don't lock */
1071
1072 spin_lock_irqsave(&ei_local->page_lock, flags);
1073 outb_p(0x00, e8390_base + EN0_IMR);
1074 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1075
1076 /*
1077 * Slow phase with lock held.
1078 */
1079
1080 spin_lock_irqsave(&ei_local->page_lock, flags);
1081
1082 ei_local->irqlock = 1;
1083
1084 send_length = max(length, ETH_ZLEN);
1085
1086 /*
1087 * We have two Tx slots available for use. Find the first free
1088 * slot, and then perform some sanity checks. With two Tx bufs,
1089 * you get very close to transmitting back-to-back packets. With
1090 * only one Tx buf, the transmitter sits idle while you reload the
1091 * card, leaving a substantial gap between each transmitted packet.
1092 */
1093
1094 if (ei_local->tx1 == 0)
1095 {
1096 output_page = ei_local->tx_start_page;
1097 ei_local->tx1 = send_length;
1098 if (ei_debug && ei_local->tx2 > 0)
1099 printk(KERN_DEBUG "%s: idle transmitter tx2=%d, lasttx=%d, txing=%d.\n",
1100 dev->name, ei_local->tx2, ei_local->lasttx, ei_local->txing);
1101 }
1102 else if (ei_local->tx2 == 0)
1103 {
1104 output_page = ei_local->tx_start_page + TX_PAGES/2;
1105 ei_local->tx2 = send_length;
1106 if (ei_debug && ei_local->tx1 > 0)
1107 printk(KERN_DEBUG "%s: idle transmitter, tx1=%d, lasttx=%d, txing=%d.\n",
1108 dev->name, ei_local->tx1, ei_local->lasttx, ei_local->txing);
1109 }
1110 else
1111 { /* We should never get here. */
1112 if (ei_debug)
1113 printk(KERN_DEBUG "%s: No Tx buffers free! tx1=%d tx2=%d last=%d\n",
1114 dev->name, ei_local->tx1, ei_local->tx2, ei_local->lasttx);
1115 ei_local->irqlock = 0;
1116 netif_stop_queue(dev);
1117 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1118 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1119 dev->stats.tx_errors++;
1120 return 1;
1121 }
1122
1123 /*
1124 * Okay, now upload the packet and trigger a send if the transmitter
1125 * isn't already sending. If it is busy, the interrupt handler will
1126 * trigger the send later, upon receiving a Tx done interrupt.
1127 */
1128
1129 if (length == skb->len)
1130 ei_block_output(dev, length, skb->data, output_page);
1131 else {
1132 memset(packet, 0, ETH_ZLEN);
1133 skb_copy_from_linear_data(skb, packet, skb->len);
1134 ei_block_output(dev, length, packet, output_page);
1135 }
1136
1137 if (! ei_local->txing)
1138 {
1139 ei_local->txing = 1;
1140 NS8390_trigger_send(dev, send_length, output_page);
1141 dev->trans_start = jiffies;
1142 if (output_page == ei_local->tx_start_page)
1143 {
1144 ei_local->tx1 = -1;
1145 ei_local->lasttx = -1;
1146 }
1147 else
1148 {
1149 ei_local->tx2 = -1;
1150 ei_local->lasttx = -2;
1151 }
1152 }
1153 else ei_local->txqueue++;
1154
1155 if (ei_local->tx1 && ei_local->tx2)
1156 netif_stop_queue(dev);
1157 else
1158 netif_start_queue(dev);
1159
1160 /* Turn 8390 interrupts back on. */
1161 ei_local->irqlock = 0;
1162 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1163
1164 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1165
1166 dev_kfree_skb (skb);
1167 dev->stats.tx_bytes += send_length;
1168
1169 return 0;
1170 }
1171
1172 /**
1173 * ax_interrupt - handle the interrupts from an 8390
1174 * @irq: interrupt number
1175 * @dev_id: a pointer to the net_device
1176 * @regs: unused
1177 *
1178 * Handle the ether interface interrupts. We pull packets from
1179 * the 8390 via the card specific functions and fire them at the networking
1180 * stack. We also handle transmit completions and wake the transmit path if
1181 * necessary. We also update the counters and do other housekeeping as
1182 * needed.
1183 */
1184
1185 static irqreturn_t ax_interrupt(int irq, void *dev_id)
1186 {
1187 struct net_device *dev = dev_id;
1188 long e8390_base;
1189 int interrupts, nr_serviced = 0, i;
1190 struct ei_device *ei_local;
1191 int handled = 0;
1192
1193 e8390_base = dev->base_addr;
1194 ei_local = netdev_priv(dev);
1195
1196 /*
1197 * Protect the irq test too.
1198 */
1199
1200 spin_lock(&ei_local->page_lock);
1201
1202 if (ei_local->irqlock)
1203 {
1204 #if 1 /* This might just be an interrupt for a PCI device sharing this line */
1205 /* The "irqlock" check is only for testing. */
1206 printk(ei_local->irqlock
1207 ? "%s: Interrupted while interrupts are masked! isr=%#2x imr=%#2x.\n"
1208 : "%s: Reentering the interrupt handler! isr=%#2x imr=%#2x.\n",
1209 dev->name, inb_p(e8390_base + EN0_ISR),
1210 inb_p(e8390_base + EN0_IMR));
1211 #endif
1212 spin_unlock(&ei_local->page_lock);
1213 return IRQ_NONE;
1214 }
1215
1216 if (ei_debug > 3)
1217 printk(KERN_DEBUG "%s: interrupt(isr=%#2.2x).\n", dev->name,
1218 inb_p(e8390_base + EN0_ISR));
1219
1220 outb_p(0x00, e8390_base + EN0_ISR);
1221 ei_local->irqlock = 1;
1222
1223 /* !!Assumption!! -- we stay in page 0. Don't break this. */
1224 while ((interrupts = inb_p(e8390_base + EN0_ISR)) != 0
1225 && ++nr_serviced < MAX_SERVICE)
1226 {
1227 if (!netif_running(dev) || (interrupts == 0xff)) {
1228 if (ei_debug > 1)
1229 printk(KERN_WARNING "%s: interrupt from stopped card\n", dev->name);
1230 outb_p(interrupts, e8390_base + EN0_ISR);
1231 interrupts = 0;
1232 break;
1233 }
1234 handled = 1;
1235
1236 /* AX88190 bug fix. */
1237 outb_p(interrupts, e8390_base + EN0_ISR);
1238 for (i = 0; i < 10; i++) {
1239 if (!(inb(e8390_base + EN0_ISR) & interrupts))
1240 break;
1241 outb_p(0, e8390_base + EN0_ISR);
1242 outb_p(interrupts, e8390_base + EN0_ISR);
1243 }
1244 if (interrupts & ENISR_OVER)
1245 ei_rx_overrun(dev);
1246 else if (interrupts & (ENISR_RX+ENISR_RX_ERR))
1247 {
1248 /* Got a good (?) packet. */
1249 ei_receive(dev);
1250 }
1251 /* Push the next to-transmit packet through. */
1252 if (interrupts & ENISR_TX)
1253 ei_tx_intr(dev);
1254 else if (interrupts & ENISR_TX_ERR)
1255 ei_tx_err(dev);
1256
1257 if (interrupts & ENISR_COUNTERS)
1258 {
1259 dev->stats.rx_frame_errors += inb_p(e8390_base + EN0_COUNTER0);
1260 dev->stats.rx_crc_errors += inb_p(e8390_base + EN0_COUNTER1);
1261 dev->stats.rx_missed_errors+= inb_p(e8390_base + EN0_COUNTER2);
1262 }
1263 }
1264
1265 if (interrupts && ei_debug > 3)
1266 {
1267 handled = 1;
1268 if (nr_serviced >= MAX_SERVICE)
1269 {
1270 /* 0xFF is valid for a card removal */
1271 if(interrupts!=0xFF)
1272 printk(KERN_WARNING "%s: Too much work at interrupt, status %#2.2x\n",
1273 dev->name, interrupts);
1274 outb_p(ENISR_ALL, e8390_base + EN0_ISR); /* Ack. most intrs. */
1275 } else {
1276 printk(KERN_WARNING "%s: unknown interrupt %#2x\n", dev->name, interrupts);
1277 outb_p(0xff, e8390_base + EN0_ISR); /* Ack. all intrs. */
1278 }
1279 }
1280
1281 /* Turn 8390 interrupts back on. */
1282 ei_local->irqlock = 0;
1283 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1284
1285 spin_unlock(&ei_local->page_lock);
1286 return IRQ_RETVAL(handled);
1287 }
1288
1289 /**
1290 * ei_tx_err - handle transmitter error
1291 * @dev: network device which threw the exception
1292 *
1293 * A transmitter error has happened. Most likely excess collisions (which
1294 * is a fairly normal condition). If the error is one where the Tx will
1295 * have been aborted, we try and send another one right away, instead of
1296 * letting the failed packet sit and collect dust in the Tx buffer. This
1297 * is a much better solution as it avoids kernel based Tx timeouts, and
1298 * an unnecessary card reset.
1299 *
1300 * Called with lock held.
1301 */
1302
1303 static void ei_tx_err(struct net_device *dev)
1304 {
1305 long e8390_base = dev->base_addr;
1306 unsigned char txsr = inb_p(e8390_base+EN0_TSR);
1307 unsigned char tx_was_aborted = txsr & (ENTSR_ABT+ENTSR_FU);
1308
1309 #ifdef VERBOSE_ERROR_DUMP
1310 printk(KERN_DEBUG "%s: transmitter error (%#2x): ", dev->name, txsr);
1311 if (txsr & ENTSR_ABT)
1312 printk("excess-collisions ");
1313 if (txsr & ENTSR_ND)
1314 printk("non-deferral ");
1315 if (txsr & ENTSR_CRS)
1316 printk("lost-carrier ");
1317 if (txsr & ENTSR_FU)
1318 printk("FIFO-underrun ");
1319 if (txsr & ENTSR_CDH)
1320 printk("lost-heartbeat ");
1321 printk("\n");
1322 #endif
1323
1324 if (tx_was_aborted)
1325 ei_tx_intr(dev);
1326 else
1327 {
1328 dev->stats.tx_errors++;
1329 if (txsr & ENTSR_CRS) dev->stats.tx_carrier_errors++;
1330 if (txsr & ENTSR_CDH) dev->stats.tx_heartbeat_errors++;
1331 if (txsr & ENTSR_OWC) dev->stats.tx_window_errors++;
1332 }
1333 }
1334
1335 /**
1336 * ei_tx_intr - transmit interrupt handler
1337 * @dev: network device for which tx intr is handled
1338 *
1339 * We have finished a transmit: check for errors and then trigger the next
1340 * packet to be sent. Called with lock held.
1341 */
1342
1343 static void ei_tx_intr(struct net_device *dev)
1344 {
1345 long e8390_base = dev->base_addr;
1346 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1347 int status = inb(e8390_base + EN0_TSR);
1348
1349 /*
1350 * There are two Tx buffers, see which one finished, and trigger
1351 * the send of another one if it exists.
1352 */
1353 ei_local->txqueue--;
1354
1355 if (ei_local->tx1 < 0)
1356 {
1357 if (ei_local->lasttx != 1 && ei_local->lasttx != -1)
1358 printk(KERN_ERR "%s: bogus last_tx_buffer %d, tx1=%d.\n",
1359 ei_local->name, ei_local->lasttx, ei_local->tx1);
1360 ei_local->tx1 = 0;
1361 if (ei_local->tx2 > 0)
1362 {
1363 ei_local->txing = 1;
1364 NS8390_trigger_send(dev, ei_local->tx2, ei_local->tx_start_page + 6);
1365 dev->trans_start = jiffies;
1366 ei_local->tx2 = -1,
1367 ei_local->lasttx = 2;
1368 }
1369 else ei_local->lasttx = 20, ei_local->txing = 0;
1370 }
1371 else if (ei_local->tx2 < 0)
1372 {
1373 if (ei_local->lasttx != 2 && ei_local->lasttx != -2)
1374 printk("%s: bogus last_tx_buffer %d, tx2=%d.\n",
1375 ei_local->name, ei_local->lasttx, ei_local->tx2);
1376 ei_local->tx2 = 0;
1377 if (ei_local->tx1 > 0)
1378 {
1379 ei_local->txing = 1;
1380 NS8390_trigger_send(dev, ei_local->tx1, ei_local->tx_start_page);
1381 dev->trans_start = jiffies;
1382 ei_local->tx1 = -1;
1383 ei_local->lasttx = 1;
1384 }
1385 else
1386 ei_local->lasttx = 10, ei_local->txing = 0;
1387 }
1388 // else printk(KERN_WARNING "%s: unexpected TX-done interrupt, lasttx=%d.\n",
1389 // dev->name, ei_local->lasttx);
1390
1391 /* Minimize Tx latency: update the statistics after we restart TXing. */
1392 if (status & ENTSR_COL)
1393 dev->stats.collisions++;
1394 if (status & ENTSR_PTX)
1395 dev->stats.tx_packets++;
1396 else
1397 {
1398 dev->stats.tx_errors++;
1399 if (status & ENTSR_ABT)
1400 {
1401 dev->stats.tx_aborted_errors++;
1402 dev->stats.collisions += 16;
1403 }
1404 if (status & ENTSR_CRS)
1405 dev->stats.tx_carrier_errors++;
1406 if (status & ENTSR_FU)
1407 dev->stats.tx_fifo_errors++;
1408 if (status & ENTSR_CDH)
1409 dev->stats.tx_heartbeat_errors++;
1410 if (status & ENTSR_OWC)
1411 dev->stats.tx_window_errors++;
1412 }
1413 netif_wake_queue(dev);
1414 }
1415
1416 /**
1417 * ei_receive - receive some packets
1418 * @dev: network device with which receive will be run
1419 *
1420 * We have a good packet(s), get it/them out of the buffers.
1421 * Called with lock held.
1422 */
1423
1424 static void ei_receive(struct net_device *dev)
1425 {
1426 long e8390_base = dev->base_addr;
1427 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1428 unsigned char rxing_page, this_frame, next_frame;
1429 unsigned short current_offset;
1430 int rx_pkt_count = 0;
1431 struct e8390_pkt_hdr rx_frame;
1432
1433 while (++rx_pkt_count < 10)
1434 {
1435 int pkt_len, pkt_stat;
1436
1437 /* Get the rx page (incoming packet pointer). */
1438 rxing_page = inb_p(e8390_base + EN1_CURPAG -1);
1439
1440 /* Remove one frame from the ring. Boundary is always a page behind. */
1441 this_frame = inb_p(e8390_base + EN0_BOUNDARY) + 1;
1442 if (this_frame >= ei_local->stop_page)
1443 this_frame = ei_local->rx_start_page;
1444
1445 /* Someday we'll omit the previous, iff we never get this message.
1446 (There is at least one clone claimed to have a problem.)
1447
1448 Keep quiet if it looks like a card removal. One problem here
1449 is that some clones crash in roughly the same way.
1450 */
1451 if (ei_debug > 0 && this_frame != ei_local->current_page && (this_frame!=0x0 || rxing_page!=0xFF))
1452 printk(KERN_ERR "%s: mismatched read page pointers %2x vs %2x.\n",
1453 dev->name, this_frame, ei_local->current_page);
1454
1455 if (this_frame == rxing_page) /* Read all the frames? */
1456 break; /* Done for now */
1457
1458 current_offset = this_frame << 8;
1459 ei_get_8390_hdr(dev, &rx_frame, this_frame);
1460
1461 pkt_len = rx_frame.count - sizeof(struct e8390_pkt_hdr);
1462 pkt_stat = rx_frame.status;
1463
1464 next_frame = this_frame + 1 + ((pkt_len+4)>>8);
1465
1466 if (pkt_len < 60 || pkt_len > 1518)
1467 {
1468 if (ei_debug)
1469 printk(KERN_DEBUG "%s: bogus packet size: %d, status=%#2x nxpg=%#2x.\n",
1470 dev->name, rx_frame.count, rx_frame.status,
1471 rx_frame.next);
1472 dev->stats.rx_errors++;
1473 dev->stats.rx_length_errors++;
1474 }
1475 else if ((pkt_stat & 0x0F) == ENRSR_RXOK)
1476 {
1477 struct sk_buff *skb;
1478
1479 skb = dev_alloc_skb(pkt_len+2);
1480 if (skb == NULL)
1481 {
1482 if (ei_debug > 1)
1483 printk(KERN_DEBUG "%s: Couldn't allocate a sk_buff of size %d.\n",
1484 dev->name, pkt_len);
1485 dev->stats.rx_dropped++;
1486 break;
1487 }
1488 else
1489 {
1490 skb_reserve(skb,2); /* IP headers on 16 byte boundaries */
1491 skb_put(skb, pkt_len); /* Make room */
1492 ei_block_input(dev, pkt_len, skb, current_offset + sizeof(rx_frame));
1493 skb->protocol=eth_type_trans(skb,dev);
1494 netif_rx(skb);
1495 dev->last_rx = jiffies;
1496 dev->stats.rx_packets++;
1497 dev->stats.rx_bytes += pkt_len;
1498 if (pkt_stat & ENRSR_PHY)
1499 dev->stats.multicast++;
1500 }
1501 }
1502 else
1503 {
1504 if (ei_debug)
1505 printk(KERN_DEBUG "%s: bogus packet: status=%#2x nxpg=%#2x size=%d\n",
1506 dev->name, rx_frame.status, rx_frame.next,
1507 rx_frame.count);
1508 dev->stats.rx_errors++;
1509 /* NB: The NIC counts CRC, frame and missed errors. */
1510 if (pkt_stat & ENRSR_FO)
1511 dev->stats.rx_fifo_errors++;
1512 }
1513 next_frame = rx_frame.next;
1514
1515 /* This _should_ never happen: it's here for avoiding bad clones. */
1516 if (next_frame >= ei_local->stop_page) {
1517 printk("%s: next frame inconsistency, %#2x\n", dev->name,
1518 next_frame);
1519 next_frame = ei_local->rx_start_page;
1520 }
1521 ei_local->current_page = next_frame;
1522 outb_p(next_frame-1, e8390_base+EN0_BOUNDARY);
1523 }
1524
1525 return;
1526 }
1527
1528 /**
1529 * ei_rx_overrun - handle receiver overrun
1530 * @dev: network device which threw exception
1531 *
1532 * We have a receiver overrun: we have to kick the 8390 to get it started
1533 * again. Problem is that you have to kick it exactly as NS prescribes in
1534 * the updated datasheets, or "the NIC may act in an unpredictable manner."
1535 * This includes causing "the NIC to defer indefinitely when it is stopped
1536 * on a busy network." Ugh.
1537 * Called with lock held. Don't call this with the interrupts off or your
1538 * computer will hate you - it takes 10ms or so.
1539 */
1540
1541 static void ei_rx_overrun(struct net_device *dev)
1542 {
1543 axnet_dev_t *info = PRIV(dev);
1544 long e8390_base = dev->base_addr;
1545 unsigned char was_txing, must_resend = 0;
1546
1547 /*
1548 * Record whether a Tx was in progress and then issue the
1549 * stop command.
1550 */
1551 was_txing = inb_p(e8390_base+E8390_CMD) & E8390_TRANS;
1552 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, e8390_base+E8390_CMD);
1553
1554 if (ei_debug > 1)
1555 printk(KERN_DEBUG "%s: Receiver overrun.\n", dev->name);
1556 dev->stats.rx_over_errors++;
1557
1558 /*
1559 * Wait a full Tx time (1.2ms) + some guard time, NS says 1.6ms total.
1560 * Early datasheets said to poll the reset bit, but now they say that
1561 * it "is not a reliable indicator and subsequently should be ignored."
1562 * We wait at least 10ms.
1563 */
1564
1565 mdelay(10);
1566
1567 /*
1568 * Reset RBCR[01] back to zero as per magic incantation.
1569 */
1570 outb_p(0x00, e8390_base+EN0_RCNTLO);
1571 outb_p(0x00, e8390_base+EN0_RCNTHI);
1572
1573 /*
1574 * See if any Tx was interrupted or not. According to NS, this
1575 * step is vital, and skipping it will cause no end of havoc.
1576 */
1577
1578 if (was_txing)
1579 {
1580 unsigned char tx_completed = inb_p(e8390_base+EN0_ISR) & (ENISR_TX+ENISR_TX_ERR);
1581 if (!tx_completed)
1582 must_resend = 1;
1583 }
1584
1585 /*
1586 * Have to enter loopback mode and then restart the NIC before
1587 * you are allowed to slurp packets up off the ring.
1588 */
1589 outb_p(E8390_TXOFF, e8390_base + EN0_TXCR);
1590 outb_p(E8390_NODMA + E8390_PAGE0 + E8390_START, e8390_base + E8390_CMD);
1591
1592 /*
1593 * Clear the Rx ring of all the debris, and ack the interrupt.
1594 */
1595 ei_receive(dev);
1596
1597 /*
1598 * Leave loopback mode, and resend any packet that got stopped.
1599 */
1600 outb_p(E8390_TXCONFIG | info->duplex_flag, e8390_base + EN0_TXCR);
1601 if (must_resend)
1602 outb_p(E8390_NODMA + E8390_PAGE0 + E8390_START + E8390_TRANS, e8390_base + E8390_CMD);
1603 }
1604
1605 /*
1606 * Collect the stats. This is called unlocked and from several contexts.
1607 */
1608
1609 static struct net_device_stats *get_stats(struct net_device *dev)
1610 {
1611 long ioaddr = dev->base_addr;
1612 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1613 unsigned long flags;
1614
1615 /* If the card is stopped, just return the present stats. */
1616 if (!netif_running(dev))
1617 return &dev->stats;
1618
1619 spin_lock_irqsave(&ei_local->page_lock,flags);
1620 /* Read the counter registers, assuming we are in page 0. */
1621 dev->stats.rx_frame_errors += inb_p(ioaddr + EN0_COUNTER0);
1622 dev->stats.rx_crc_errors += inb_p(ioaddr + EN0_COUNTER1);
1623 dev->stats.rx_missed_errors+= inb_p(ioaddr + EN0_COUNTER2);
1624 spin_unlock_irqrestore(&ei_local->page_lock, flags);
1625
1626 return &dev->stats;
1627 }
1628
1629 /*
1630 * Form the 64 bit 8390 multicast table from the linked list of addresses
1631 * associated with this dev structure.
1632 */
1633
1634 static inline void make_mc_bits(u8 *bits, struct net_device *dev)
1635 {
1636 struct dev_mc_list *dmi;
1637 u32 crc;
1638
1639 for (dmi=dev->mc_list; dmi; dmi=dmi->next) {
1640
1641 crc = ether_crc(ETH_ALEN, dmi->dmi_addr);
1642 /*
1643 * The 8390 uses the 6 most significant bits of the
1644 * CRC to index the multicast table.
1645 */
1646 bits[crc>>29] |= (1<<((crc>>26)&7));
1647 }
1648 }
1649
1650 /**
1651 * do_set_multicast_list - set/clear multicast filter
1652 * @dev: net device for which multicast filter is adjusted
1653 *
1654 * Set or clear the multicast filter for this adaptor.
1655 * Must be called with lock held.
1656 */
1657
1658 static void do_set_multicast_list(struct net_device *dev)
1659 {
1660 long e8390_base = dev->base_addr;
1661 int i;
1662 struct ei_device *ei_local = (struct ei_device*)netdev_priv(dev);
1663
1664 if (!(dev->flags&(IFF_PROMISC|IFF_ALLMULTI))) {
1665 memset(ei_local->mcfilter, 0, 8);
1666 if (dev->mc_list)
1667 make_mc_bits(ei_local->mcfilter, dev);
1668 } else {
1669 /* set to accept-all */
1670 memset(ei_local->mcfilter, 0xFF, 8);
1671 }
1672
1673 outb_p(E8390_NODMA + E8390_PAGE1, e8390_base + E8390_CMD);
1674 for(i = 0; i < 8; i++)
1675 {
1676 outb_p(ei_local->mcfilter[i], e8390_base + EN1_MULT_SHIFT(i));
1677 }
1678 outb_p(E8390_NODMA + E8390_PAGE0, e8390_base + E8390_CMD);
1679
1680 if(dev->flags&IFF_PROMISC)
1681 outb_p(E8390_RXCONFIG | 0x58, e8390_base + EN0_RXCR);
1682 else if(dev->flags&IFF_ALLMULTI || dev->mc_list)
1683 outb_p(E8390_RXCONFIG | 0x48, e8390_base + EN0_RXCR);
1684 else
1685 outb_p(E8390_RXCONFIG | 0x40, e8390_base + EN0_RXCR);
1686
1687 outb_p(E8390_NODMA+E8390_PAGE0+E8390_START, e8390_base+E8390_CMD);
1688 }
1689
1690 /*
1691 * Called without lock held. This is invoked from user context and may
1692 * be parallel to just about everything else. Its also fairly quick and
1693 * not called too often. Must protect against both bh and irq users
1694 */
1695
1696 static void set_multicast_list(struct net_device *dev)
1697 {
1698 unsigned long flags;
1699
1700 spin_lock_irqsave(&dev_lock(dev), flags);
1701 do_set_multicast_list(dev);
1702 spin_unlock_irqrestore(&dev_lock(dev), flags);
1703 }
1704
1705 /**
1706 * axdev_setup - init rest of 8390 device struct
1707 * @dev: network device structure to init
1708 *
1709 * Initialize the rest of the 8390 device structure. Do NOT __init
1710 * this, as it is used by 8390 based modular drivers too.
1711 */
1712
1713 static void axdev_setup(struct net_device *dev)
1714 {
1715 struct ei_device *ei_local;
1716 if (ei_debug > 1)
1717 printk(version_8390);
1718
1719 ei_local = (struct ei_device *)netdev_priv(dev);
1720 spin_lock_init(&ei_local->page_lock);
1721
1722 dev->hard_start_xmit = &ei_start_xmit;
1723 dev->get_stats = get_stats;
1724 dev->set_multicast_list = &set_multicast_list;
1725
1726 ether_setup(dev);
1727 }
1728
1729 /* This page of functions should be 8390 generic */
1730 /* Follow National Semi's recommendations for initializing the "NIC". */
1731
1732 /**
1733 * AX88190_init - initialize 8390 hardware
1734 * @dev: network device to initialize
1735 * @startp: boolean. non-zero value to initiate chip processing
1736 *
1737 * Must be called with lock held.
1738 */
1739
1740 static void AX88190_init(struct net_device *dev, int startp)
1741 {
1742 axnet_dev_t *info = PRIV(dev);
1743 long e8390_base = dev->base_addr;
1744 struct ei_device *ei_local = (struct ei_device *) netdev_priv(dev);
1745 int i;
1746 int endcfg = ei_local->word16 ? (0x48 | ENDCFG_WTS) : 0x48;
1747
1748 if(sizeof(struct e8390_pkt_hdr)!=4)
1749 panic("8390.c: header struct mispacked\n");
1750 /* Follow National Semi's recommendations for initing the DP83902. */
1751 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, e8390_base+E8390_CMD); /* 0x21 */
1752 outb_p(endcfg, e8390_base + EN0_DCFG); /* 0x48 or 0x49 */
1753 /* Clear the remote byte count registers. */
1754 outb_p(0x00, e8390_base + EN0_RCNTLO);
1755 outb_p(0x00, e8390_base + EN0_RCNTHI);
1756 /* Set to monitor and loopback mode -- this is vital!. */
1757 outb_p(E8390_RXOFF|0x40, e8390_base + EN0_RXCR); /* 0x60 */
1758 outb_p(E8390_TXOFF, e8390_base + EN0_TXCR); /* 0x02 */
1759 /* Set the transmit page and receive ring. */
1760 outb_p(ei_local->tx_start_page, e8390_base + EN0_TPSR);
1761 ei_local->tx1 = ei_local->tx2 = 0;
1762 outb_p(ei_local->rx_start_page, e8390_base + EN0_STARTPG);
1763 outb_p(ei_local->stop_page-1, e8390_base + EN0_BOUNDARY); /* 3c503 says 0x3f,NS0x26*/
1764 ei_local->current_page = ei_local->rx_start_page; /* assert boundary+1 */
1765 outb_p(ei_local->stop_page, e8390_base + EN0_STOPPG);
1766 /* Clear the pending interrupts and mask. */
1767 outb_p(0xFF, e8390_base + EN0_ISR);
1768 outb_p(0x00, e8390_base + EN0_IMR);
1769
1770 /* Copy the station address into the DS8390 registers. */
1771
1772 outb_p(E8390_NODMA + E8390_PAGE1 + E8390_STOP, e8390_base+E8390_CMD); /* 0x61 */
1773 for(i = 0; i < 6; i++)
1774 {
1775 outb_p(dev->dev_addr[i], e8390_base + EN1_PHYS_SHIFT(i));
1776 if(inb_p(e8390_base + EN1_PHYS_SHIFT(i))!=dev->dev_addr[i])
1777 printk(KERN_ERR "Hw. address read/write mismap %d\n",i);
1778 }
1779
1780 outb_p(ei_local->rx_start_page, e8390_base + EN1_CURPAG);
1781 outb_p(E8390_NODMA+E8390_PAGE0+E8390_STOP, e8390_base+E8390_CMD);
1782
1783 netif_start_queue(dev);
1784 ei_local->tx1 = ei_local->tx2 = 0;
1785 ei_local->txing = 0;
1786
1787 if (startp)
1788 {
1789 outb_p(0xff, e8390_base + EN0_ISR);
1790 outb_p(ENISR_ALL, e8390_base + EN0_IMR);
1791 outb_p(E8390_NODMA+E8390_PAGE0+E8390_START, e8390_base+E8390_CMD);
1792 outb_p(E8390_TXCONFIG | info->duplex_flag,
1793 e8390_base + EN0_TXCR); /* xmit on. */
1794 /* 3c503 TechMan says rxconfig only after the NIC is started. */
1795 outb_p(E8390_RXCONFIG | 0x40, e8390_base + EN0_RXCR); /* rx on, */
1796 do_set_multicast_list(dev); /* (re)load the mcast table */
1797 }
1798 }
1799
1800 /* Trigger a transmit start, assuming the length is valid.
1801 Always called with the page lock held */
1802
1803 static void NS8390_trigger_send(struct net_device *dev, unsigned int length,
1804 int start_page)
1805 {
1806 long e8390_base = dev->base_addr;
1807 struct ei_device *ei_local __attribute((unused)) = (struct ei_device *) netdev_priv(dev);
1808
1809 if (inb_p(e8390_base) & E8390_TRANS)
1810 {
1811 printk(KERN_WARNING "%s: trigger_send() called with the transmitter busy.\n",
1812 dev->name);
1813 return;
1814 }
1815 outb_p(length & 0xff, e8390_base + EN0_TCNTLO);
1816 outb_p(length >> 8, e8390_base + EN0_TCNTHI);
1817 outb_p(start_page, e8390_base + EN0_TPSR);
1818 outb_p(E8390_NODMA+E8390_TRANS+E8390_START, e8390_base+E8390_CMD);
1819 }
This page took 0.069119 seconds and 6 git commands to generate.