[XFRM]: skb_cow_data() does not set proper owner for new skbs.
[linux-2.6/verdex.git] / drivers / net / cs89x0.c
blob5c5f540da26a28618f7c1f2e017039fe713d4f1e
1 /* cs89x0.c: A Crystal Semiconductor (Now Cirrus Logic) CS89[02]0
2 * driver for linux.
3 */
5 /*
6 Written 1996 by Russell Nelson, with reference to skeleton.c
7 written 1993-1994 by Donald Becker.
9 This software may be used and distributed according to the terms
10 of the GNU General Public License, incorporated herein by reference.
12 The author may be reached at nelson@crynwr.com, Crynwr
13 Software, 521 Pleasant Valley Rd., Potsdam, NY 13676
15 Changelog:
17 Mike Cruse : mcruse@cti-ltd.com
18 : Changes for Linux 2.0 compatibility.
19 : Added dev_id parameter in net_interrupt(),
20 : request_irq() and free_irq(). Just NULL for now.
22 Mike Cruse : Added MOD_INC_USE_COUNT and MOD_DEC_USE_COUNT macros
23 : in net_open() and net_close() so kerneld would know
24 : that the module is in use and wouldn't eject the
25 : driver prematurely.
27 Mike Cruse : Rewrote init_module() and cleanup_module using 8390.c
28 : as an example. Disabled autoprobing in init_module(),
29 : not a good thing to do to other devices while Linux
30 : is running from all accounts.
32 Russ Nelson : Jul 13 1998. Added RxOnly DMA support.
34 Melody Lee : Aug 10 1999. Changes for Linux 2.2.5 compatibility.
35 : email: ethernet@crystal.cirrus.com
37 Alan Cox : Removed 1.2 support, added 2.1 extra counters.
39 Andrew Morton : andrewm@uow.edu.au
40 : Kernel 2.3.48
41 : Handle kmalloc() failures
42 : Other resource allocation fixes
43 : Add SMP locks
44 : Integrate Russ Nelson's ALLOW_DMA functionality back in.
45 : If ALLOW_DMA is true, make DMA runtime selectable
46 : Folded in changes from Cirrus (Melody Lee
47 : <klee@crystal.cirrus.com>)
48 : Don't call netif_wake_queue() in net_send_packet()
49 : Fixed an out-of-mem bug in dma_rx()
50 : Updated Documentation/networking/cs89x0.txt
52 Andrew Morton : andrewm@uow.edu.au / Kernel 2.3.99-pre1
53 : Use skb_reserve to longword align IP header (two places)
54 : Remove a delay loop from dma_rx()
55 : Replace '100' with HZ
56 : Clean up a couple of skb API abuses
57 : Added 'cs89x0_dma=N' kernel boot option
58 : Correctly initialise lp->lock in non-module compile
60 Andrew Morton : andrewm@uow.edu.au / Kernel 2.3.99-pre4-1
61 : MOD_INC/DEC race fix (see
62 : http://www.uwsg.indiana.edu/hypermail/linux/kernel/0003.3/1532.html)
64 Andrew Morton : andrewm@uow.edu.au / Kernel 2.4.0-test7-pre2
65 : Enhanced EEPROM support to cover more devices,
66 : abstracted IRQ mapping to support CONFIG_ARCH_CLPS7500 arch
67 : (Jason Gunthorpe <jgg@ualberta.ca>)
69 Andrew Morton : Kernel 2.4.0-test11-pre4
70 : Use dev->name in request_*() (Andrey Panin)
71 : Fix an error-path memleak in init_module()
72 : Preserve return value from request_irq()
73 : Fix type of `media' module parm (Keith Owens)
74 : Use SET_MODULE_OWNER()
75 : Tidied up strange request_irq() abuse in net_open().
77 Andrew Morton : Kernel 2.4.3-pre1
78 : Request correct number of pages for DMA (Hugh Dickens)
79 : Select PP_ChipID _after_ unregister_netdev in cleanup_module()
80 : because unregister_netdev() calls get_stats.
81 : Make `version[]' __initdata
82 : Uninlined the read/write reg/word functions.
84 Oskar Schirmer : oskar@scara.com
85 : HiCO.SH4 (superh) support added (irq#1, cs89x0_media=)
87 Deepak Saxena : dsaxena@plexity.net
88 : Intel IXDP2x01 (XScale ixp2x00 NPU) platform support
92 /* Always include 'config.h' first in case the user wants to turn on
93 or override something. */
94 #include <linux/config.h>
95 #include <linux/module.h>
98 * Set this to zero to disable DMA code
100 * Note that even if DMA is turned off we still support the 'dma' and 'use_dma'
101 * module options so we don't break any startup scripts.
103 #ifndef CONFIG_ARCH_IXDP2X01
104 #define ALLOW_DMA 0
105 #else
106 #define ALLOW_DMA 1
107 #endif
110 * Set this to zero to remove all the debug statements via
111 * dead code elimination
113 #define DEBUGGING 1
116 Sources:
118 Crynwr packet driver epktisa.
120 Crystal Semiconductor data sheets.
124 #include <linux/errno.h>
125 #include <linux/netdevice.h>
126 #include <linux/etherdevice.h>
127 #include <linux/kernel.h>
128 #include <linux/types.h>
129 #include <linux/fcntl.h>
130 #include <linux/interrupt.h>
131 #include <linux/ioport.h>
132 #include <linux/in.h>
133 #include <linux/skbuff.h>
134 #include <linux/slab.h>
135 #include <linux/spinlock.h>
136 #include <linux/string.h>
137 #include <linux/init.h>
138 #include <linux/bitops.h>
139 #include <linux/delay.h>
141 #include <asm/system.h>
142 #include <asm/io.h>
143 #if ALLOW_DMA
144 #include <asm/dma.h>
145 #endif
147 #include "cs89x0.h"
149 static char version[] __initdata =
150 "cs89x0.c: v2.4.3-pre1 Russell Nelson <nelson@crynwr.com>, Andrew Morton <andrewm@uow.edu.au>\n";
152 #define DRV_NAME "cs89x0"
154 /* First, a few definitions that the brave might change.
155 A zero-terminated list of I/O addresses to be probed. Some special flags..
156 Addr & 1 = Read back the address port, look for signature and reset
157 the page window before probing
158 Addr & 3 = Reset the page window and probe
159 The CLPS eval board has the Cirrus chip at 0x80090300, in ARM IO space,
160 but it is possible that a Cirrus board could be plugged into the ISA
161 slots. */
162 /* The cs8900 has 4 IRQ pins, software selectable. cs8900_irq_map maps
163 them to system IRQ numbers. This mapping is card specific and is set to
164 the configuration of the Cirrus Eval board for this chip. */
165 #ifdef CONFIG_ARCH_CLPS7500
166 static unsigned int netcard_portlist[] __initdata =
167 { 0x80090303, 0x300, 0x320, 0x340, 0x360, 0x200, 0x220, 0x240, 0x260, 0x280, 0x2a0, 0x2c0, 0x2e0, 0};
168 static unsigned int cs8900_irq_map[] = {12,0,0,0};
169 #elif defined(CONFIG_SH_HICOSH4)
170 static unsigned int netcard_portlist[] __initdata =
171 { 0x0300, 0};
172 static unsigned int cs8900_irq_map[] = {1,0,0,0};
173 #elif defined(CONFIG_ARCH_IXDP2X01)
174 #include <asm/irq.h>
175 static unsigned int netcard_portlist[] __initdata = {IXDP2X01_CS8900_VIRT_BASE, 0};
176 static unsigned int cs8900_irq_map[] = {IRQ_IXDP2X01_CS8900, 0, 0, 0};
177 #else
178 static unsigned int netcard_portlist[] __initdata =
179 { 0x300, 0x320, 0x340, 0x360, 0x200, 0x220, 0x240, 0x260, 0x280, 0x2a0, 0x2c0, 0x2e0, 0};
180 static unsigned int cs8900_irq_map[] = {10,11,12,5};
181 #endif
183 #if DEBUGGING
184 static unsigned int net_debug = DEBUGGING;
185 #else
186 #define net_debug 0 /* gcc will remove all the debug code for us */
187 #endif
189 /* The number of low I/O ports used by the ethercard. */
190 #define NETCARD_IO_EXTENT 16
192 /* we allow the user to override various values normally set in the EEPROM */
193 #define FORCE_RJ45 0x0001 /* pick one of these three */
194 #define FORCE_AUI 0x0002
195 #define FORCE_BNC 0x0004
197 #define FORCE_AUTO 0x0010 /* pick one of these three */
198 #define FORCE_HALF 0x0020
199 #define FORCE_FULL 0x0030
201 /* Information that need to be kept for each board. */
202 struct net_local {
203 struct net_device_stats stats;
204 int chip_type; /* one of: CS8900, CS8920, CS8920M */
205 char chip_revision; /* revision letter of the chip ('A'...) */
206 int send_cmd; /* the proper send command: TX_NOW, TX_AFTER_381, or TX_AFTER_ALL */
207 int auto_neg_cnf; /* auto-negotiation word from EEPROM */
208 int adapter_cnf; /* adapter configuration from EEPROM */
209 int isa_config; /* ISA configuration from EEPROM */
210 int irq_map; /* IRQ map from EEPROM */
211 int rx_mode; /* what mode are we in? 0, RX_MULTCAST_ACCEPT, or RX_ALL_ACCEPT */
212 int curr_rx_cfg; /* a copy of PP_RxCFG */
213 int linectl; /* either 0 or LOW_RX_SQUELCH, depending on configuration. */
214 int send_underrun; /* keep track of how many underruns in a row we get */
215 int force; /* force various values; see FORCE* above. */
216 spinlock_t lock;
217 #if ALLOW_DMA
218 int use_dma; /* Flag: we're using dma */
219 int dma; /* DMA channel */
220 int dmasize; /* 16 or 64 */
221 unsigned char *dma_buff; /* points to the beginning of the buffer */
222 unsigned char *end_dma_buff; /* points to the end of the buffer */
223 unsigned char *rx_dma_ptr; /* points to the next packet */
224 #endif
227 /* Index to functions, as function prototypes. */
229 static int cs89x0_probe1(struct net_device *dev, int ioaddr, int modular);
230 static int net_open(struct net_device *dev);
231 static int net_send_packet(struct sk_buff *skb, struct net_device *dev);
232 static irqreturn_t net_interrupt(int irq, void *dev_id, struct pt_regs *regs);
233 static void set_multicast_list(struct net_device *dev);
234 static void net_timeout(struct net_device *dev);
235 static void net_rx(struct net_device *dev);
236 static int net_close(struct net_device *dev);
237 static struct net_device_stats *net_get_stats(struct net_device *dev);
238 static void reset_chip(struct net_device *dev);
239 static int get_eeprom_data(struct net_device *dev, int off, int len, int *buffer);
240 static int get_eeprom_cksum(int off, int len, int *buffer);
241 static int set_mac_address(struct net_device *dev, void *addr);
242 static void count_rx_errors(int status, struct net_local *lp);
243 #if ALLOW_DMA
244 static void get_dma_channel(struct net_device *dev);
245 static void release_dma_buff(struct net_local *lp);
246 #endif
248 /* Example routines you must write ;->. */
249 #define tx_done(dev) 1
252 * Permit 'cs89x0_dma=N' in the kernel boot environment
254 #if !defined(MODULE) && (ALLOW_DMA != 0)
255 static int g_cs89x0_dma;
257 static int __init dma_fn(char *str)
259 g_cs89x0_dma = simple_strtol(str,NULL,0);
260 return 1;
263 __setup("cs89x0_dma=", dma_fn);
264 #endif /* !defined(MODULE) && (ALLOW_DMA != 0) */
266 #ifndef MODULE
267 static int g_cs89x0_media__force;
269 static int __init media_fn(char *str)
271 if (!strcmp(str, "rj45")) g_cs89x0_media__force = FORCE_RJ45;
272 else if (!strcmp(str, "aui")) g_cs89x0_media__force = FORCE_AUI;
273 else if (!strcmp(str, "bnc")) g_cs89x0_media__force = FORCE_BNC;
274 return 1;
277 __setup("cs89x0_media=", media_fn);
280 /* Check for a network adaptor of this type, and return '0' iff one exists.
281 If dev->base_addr == 0, probe all likely locations.
282 If dev->base_addr == 1, always return failure.
283 If dev->base_addr == 2, allocate space for the device and return success
284 (detachable devices only).
285 Return 0 on success.
288 struct net_device * __init cs89x0_probe(int unit)
290 struct net_device *dev = alloc_etherdev(sizeof(struct net_local));
291 unsigned *port;
292 int err = 0;
293 int irq;
294 int io;
296 if (!dev)
297 return ERR_PTR(-ENODEV);
299 sprintf(dev->name, "eth%d", unit);
300 netdev_boot_setup_check(dev);
301 io = dev->base_addr;
302 irq = dev->irq;
304 if (net_debug)
305 printk("cs89x0:cs89x0_probe(0x%x)\n", io);
307 if (io > 0x1ff) { /* Check a single specified location. */
308 err = cs89x0_probe1(dev, io, 0);
309 } else if (io != 0) { /* Don't probe at all. */
310 err = -ENXIO;
311 } else {
312 for (port = netcard_portlist; *port; port++) {
313 if (cs89x0_probe1(dev, *port, 0) == 0)
314 break;
315 dev->irq = irq;
317 if (!*port)
318 err = -ENODEV;
320 if (err)
321 goto out;
322 err = register_netdev(dev);
323 if (err)
324 goto out1;
325 return dev;
326 out1:
327 outw(PP_ChipID, dev->base_addr + ADD_PORT);
328 release_region(dev->base_addr, NETCARD_IO_EXTENT);
329 out:
330 free_netdev(dev);
331 printk(KERN_WARNING "cs89x0: no cs8900 or cs8920 detected. Be sure to disable PnP with SETUP\n");
332 return ERR_PTR(err);
334 #endif
336 static int
337 readreg(struct net_device *dev, int portno)
339 outw(portno, dev->base_addr + ADD_PORT);
340 return inw(dev->base_addr + DATA_PORT);
343 static void
344 writereg(struct net_device *dev, int portno, int value)
346 outw(portno, dev->base_addr + ADD_PORT);
347 outw(value, dev->base_addr + DATA_PORT);
350 static int
351 readword(struct net_device *dev, int portno)
353 return inw(dev->base_addr + portno);
356 static void
357 writeword(struct net_device *dev, int portno, int value)
359 outw(value, dev->base_addr + portno);
362 static int __init
363 wait_eeprom_ready(struct net_device *dev)
365 int timeout = jiffies;
366 /* check to see if the EEPROM is ready, a timeout is used -
367 just in case EEPROM is ready when SI_BUSY in the
368 PP_SelfST is clear */
369 while(readreg(dev, PP_SelfST) & SI_BUSY)
370 if (jiffies - timeout >= 40)
371 return -1;
372 return 0;
375 static int __init
376 get_eeprom_data(struct net_device *dev, int off, int len, int *buffer)
378 int i;
380 if (net_debug > 3) printk("EEPROM data from %x for %x:\n",off,len);
381 for (i = 0; i < len; i++) {
382 if (wait_eeprom_ready(dev) < 0) return -1;
383 /* Now send the EEPROM read command and EEPROM location to read */
384 writereg(dev, PP_EECMD, (off + i) | EEPROM_READ_CMD);
385 if (wait_eeprom_ready(dev) < 0) return -1;
386 buffer[i] = readreg(dev, PP_EEData);
387 if (net_debug > 3) printk("%04x ", buffer[i]);
389 if (net_debug > 3) printk("\n");
390 return 0;
393 static int __init
394 get_eeprom_cksum(int off, int len, int *buffer)
396 int i, cksum;
398 cksum = 0;
399 for (i = 0; i < len; i++)
400 cksum += buffer[i];
401 cksum &= 0xffff;
402 if (cksum == 0)
403 return 0;
404 return -1;
407 /* This is the real probe routine. Linux has a history of friendly device
408 probes on the ISA bus. A good device probes avoids doing writes, and
409 verifies that the correct device exists and functions.
410 Return 0 on success.
413 static int __init
414 cs89x0_probe1(struct net_device *dev, int ioaddr, int modular)
416 struct net_local *lp = netdev_priv(dev);
417 static unsigned version_printed;
418 int i;
419 unsigned rev_type = 0;
420 int eeprom_buff[CHKSUM_LEN];
421 int retval;
423 SET_MODULE_OWNER(dev);
424 /* Initialize the device structure. */
425 if (!modular) {
426 memset(lp, 0, sizeof(*lp));
427 spin_lock_init(&lp->lock);
428 #ifndef MODULE
429 #if ALLOW_DMA
430 if (g_cs89x0_dma) {
431 lp->use_dma = 1;
432 lp->dma = g_cs89x0_dma;
433 lp->dmasize = 16; /* Could make this an option... */
435 #endif
436 lp->force = g_cs89x0_media__force;
437 #endif
440 /* Grab the region so we can find another board if autoIRQ fails. */
441 /* WTF is going on here? */
442 if (!request_region(ioaddr & ~3, NETCARD_IO_EXTENT, DRV_NAME)) {
443 printk(KERN_ERR "%s: request_region(0x%x, 0x%x) failed\n",
444 DRV_NAME, ioaddr, NETCARD_IO_EXTENT);
445 retval = -EBUSY;
446 goto out1;
449 #ifdef CONFIG_SH_HICOSH4
450 /* truely reset the chip */
451 outw(0x0114, ioaddr + ADD_PORT);
452 outw(0x0040, ioaddr + DATA_PORT);
453 #endif
455 /* if they give us an odd I/O address, then do ONE write to
456 the address port, to get it back to address zero, where we
457 expect to find the EISA signature word. An IO with a base of 0x3
458 will skip the test for the ADD_PORT. */
459 if (ioaddr & 1) {
460 if (net_debug > 1)
461 printk(KERN_INFO "%s: odd ioaddr 0x%x\n", dev->name, ioaddr);
462 if ((ioaddr & 2) != 2)
463 if ((inw((ioaddr & ~3)+ ADD_PORT) & ADD_MASK) != ADD_SIG) {
464 printk(KERN_ERR "%s: bad signature 0x%x\n",
465 dev->name, inw((ioaddr & ~3)+ ADD_PORT));
466 retval = -ENODEV;
467 goto out2;
470 printk("PP_addr=0x%x\n", inw(ioaddr + ADD_PORT));
472 ioaddr &= ~3;
473 outw(PP_ChipID, ioaddr + ADD_PORT);
475 if (inw(ioaddr + DATA_PORT) != CHIP_EISA_ID_SIG) {
476 printk(KERN_ERR "%s: incorrect signature 0x%x\n",
477 dev->name, inw(ioaddr + DATA_PORT));
478 retval = -ENODEV;
479 goto out2;
482 /* Fill in the 'dev' fields. */
483 dev->base_addr = ioaddr;
485 /* get the chip type */
486 rev_type = readreg(dev, PRODUCT_ID_ADD);
487 lp->chip_type = rev_type &~ REVISON_BITS;
488 lp->chip_revision = ((rev_type & REVISON_BITS) >> 8) + 'A';
490 /* Check the chip type and revision in order to set the correct send command
491 CS8920 revision C and CS8900 revision F can use the faster send. */
492 lp->send_cmd = TX_AFTER_381;
493 if (lp->chip_type == CS8900 && lp->chip_revision >= 'F')
494 lp->send_cmd = TX_NOW;
495 if (lp->chip_type != CS8900 && lp->chip_revision >= 'C')
496 lp->send_cmd = TX_NOW;
498 if (net_debug && version_printed++ == 0)
499 printk(version);
501 printk(KERN_INFO "%s: cs89%c0%s rev %c found at %#3lx ",
502 dev->name,
503 lp->chip_type==CS8900?'0':'2',
504 lp->chip_type==CS8920M?"M":"",
505 lp->chip_revision,
506 dev->base_addr);
508 reset_chip(dev);
510 /* Here we read the current configuration of the chip. If there
511 is no Extended EEPROM then the idea is to not disturb the chip
512 configuration, it should have been correctly setup by automatic
513 EEPROM read on reset. So, if the chip says it read the EEPROM
514 the driver will always do *something* instead of complain that
515 adapter_cnf is 0. */
517 #ifdef CONFIG_SH_HICOSH4
518 if (1) {
519 /* For the HiCO.SH4 board, things are different: we don't
520 have EEPROM, but there is some data in flash, so we go
521 get it there directly (MAC). */
522 __u16 *confd;
523 short cnt;
524 if (((* (volatile __u32 *) 0xa0013ff0) & 0x00ffffff)
525 == 0x006c3000) {
526 confd = (__u16*) 0xa0013fc0;
527 } else {
528 confd = (__u16*) 0xa001ffc0;
530 cnt = (*confd++ & 0x00ff) >> 1;
531 while (--cnt > 0) {
532 __u16 j = *confd++;
534 switch (j & 0x0fff) {
535 case PP_IA:
536 for (i = 0; i < ETH_ALEN/2; i++) {
537 dev->dev_addr[i*2] = confd[i] & 0xFF;
538 dev->dev_addr[i*2+1] = confd[i] >> 8;
540 break;
542 j = (j >> 12) + 1;
543 confd += j;
544 cnt -= j;
546 } else
547 #endif
549 if ((readreg(dev, PP_SelfST) & (EEPROM_OK | EEPROM_PRESENT)) ==
550 (EEPROM_OK|EEPROM_PRESENT)) {
551 /* Load the MAC. */
552 for (i=0; i < ETH_ALEN/2; i++) {
553 unsigned int Addr;
554 Addr = readreg(dev, PP_IA+i*2);
555 dev->dev_addr[i*2] = Addr & 0xFF;
556 dev->dev_addr[i*2+1] = Addr >> 8;
559 /* Load the Adapter Configuration.
560 Note: Barring any more specific information from some
561 other source (ie EEPROM+Schematics), we would not know
562 how to operate a 10Base2 interface on the AUI port.
563 However, since we do read the status of HCB1 and use
564 settings that always result in calls to control_dc_dc(dev,0)
565 a BNC interface should work if the enable pin
566 (dc/dc converter) is on HCB1. It will be called AUI
567 however. */
569 lp->adapter_cnf = 0;
570 i = readreg(dev, PP_LineCTL);
571 /* Preserve the setting of the HCB1 pin. */
572 if ((i & (HCB1 | HCB1_ENBL)) == (HCB1 | HCB1_ENBL))
573 lp->adapter_cnf |= A_CNF_DC_DC_POLARITY;
574 /* Save the sqelch bit */
575 if ((i & LOW_RX_SQUELCH) == LOW_RX_SQUELCH)
576 lp->adapter_cnf |= A_CNF_EXTND_10B_2 | A_CNF_LOW_RX_SQUELCH;
577 /* Check if the card is in 10Base-t only mode */
578 if ((i & (AUI_ONLY | AUTO_AUI_10BASET)) == 0)
579 lp->adapter_cnf |= A_CNF_10B_T | A_CNF_MEDIA_10B_T;
580 /* Check if the card is in AUI only mode */
581 if ((i & (AUI_ONLY | AUTO_AUI_10BASET)) == AUI_ONLY)
582 lp->adapter_cnf |= A_CNF_AUI | A_CNF_MEDIA_AUI;
583 /* Check if the card is in Auto mode. */
584 if ((i & (AUI_ONLY | AUTO_AUI_10BASET)) == AUTO_AUI_10BASET)
585 lp->adapter_cnf |= A_CNF_AUI | A_CNF_10B_T |
586 A_CNF_MEDIA_AUI | A_CNF_MEDIA_10B_T | A_CNF_MEDIA_AUTO;
588 if (net_debug > 1)
589 printk(KERN_INFO "%s: PP_LineCTL=0x%x, adapter_cnf=0x%x\n",
590 dev->name, i, lp->adapter_cnf);
592 /* IRQ. Other chips already probe, see below. */
593 if (lp->chip_type == CS8900)
594 lp->isa_config = readreg(dev, PP_CS8900_ISAINT) & INT_NO_MASK;
596 printk( "[Cirrus EEPROM] ");
599 printk("\n");
601 /* First check to see if an EEPROM is attached. */
602 #ifdef CONFIG_SH_HICOSH4 /* no EEPROM on HiCO, don't hazzle with it here */
603 if (1) {
604 printk(KERN_NOTICE "cs89x0: No EEPROM on HiCO.SH4\n");
605 } else
606 #endif
607 if ((readreg(dev, PP_SelfST) & EEPROM_PRESENT) == 0)
608 printk(KERN_WARNING "cs89x0: No EEPROM, relying on command line....\n");
609 else if (get_eeprom_data(dev, START_EEPROM_DATA,CHKSUM_LEN,eeprom_buff) < 0) {
610 printk(KERN_WARNING "\ncs89x0: EEPROM read failed, relying on command line.\n");
611 } else if (get_eeprom_cksum(START_EEPROM_DATA,CHKSUM_LEN,eeprom_buff) < 0) {
612 /* Check if the chip was able to read its own configuration starting
613 at 0 in the EEPROM*/
614 if ((readreg(dev, PP_SelfST) & (EEPROM_OK | EEPROM_PRESENT)) !=
615 (EEPROM_OK|EEPROM_PRESENT))
616 printk(KERN_WARNING "cs89x0: Extended EEPROM checksum bad and no Cirrus EEPROM, relying on command line\n");
618 } else {
619 /* This reads an extended EEPROM that is not documented
620 in the CS8900 datasheet. */
622 /* get transmission control word but keep the autonegotiation bits */
623 if (!lp->auto_neg_cnf) lp->auto_neg_cnf = eeprom_buff[AUTO_NEG_CNF_OFFSET/2];
624 /* Store adapter configuration */
625 if (!lp->adapter_cnf) lp->adapter_cnf = eeprom_buff[ADAPTER_CNF_OFFSET/2];
626 /* Store ISA configuration */
627 lp->isa_config = eeprom_buff[ISA_CNF_OFFSET/2];
628 dev->mem_start = eeprom_buff[PACKET_PAGE_OFFSET/2] << 8;
630 /* eeprom_buff has 32-bit ints, so we can't just memcpy it */
631 /* store the initial memory base address */
632 for (i = 0; i < ETH_ALEN/2; i++) {
633 dev->dev_addr[i*2] = eeprom_buff[i];
634 dev->dev_addr[i*2+1] = eeprom_buff[i] >> 8;
636 if (net_debug > 1)
637 printk(KERN_DEBUG "%s: new adapter_cnf: 0x%x\n",
638 dev->name, lp->adapter_cnf);
641 /* allow them to force multiple transceivers. If they force multiple, autosense */
643 int count = 0;
644 if (lp->force & FORCE_RJ45) {lp->adapter_cnf |= A_CNF_10B_T; count++; }
645 if (lp->force & FORCE_AUI) {lp->adapter_cnf |= A_CNF_AUI; count++; }
646 if (lp->force & FORCE_BNC) {lp->adapter_cnf |= A_CNF_10B_2; count++; }
647 if (count > 1) {lp->adapter_cnf |= A_CNF_MEDIA_AUTO; }
648 else if (lp->force & FORCE_RJ45){lp->adapter_cnf |= A_CNF_MEDIA_10B_T; }
649 else if (lp->force & FORCE_AUI) {lp->adapter_cnf |= A_CNF_MEDIA_AUI; }
650 else if (lp->force & FORCE_BNC) {lp->adapter_cnf |= A_CNF_MEDIA_10B_2; }
653 if (net_debug > 1)
654 printk(KERN_DEBUG "%s: after force 0x%x, adapter_cnf=0x%x\n",
655 dev->name, lp->force, lp->adapter_cnf);
657 /* FIXME: We don't let you set dc-dc polarity or low RX squelch from the command line: add it here */
659 /* FIXME: We don't let you set the IMM bit from the command line: add it to lp->auto_neg_cnf here */
661 /* FIXME: we don't set the Ethernet address on the command line. Use
662 ifconfig IFACE hw ether AABBCCDDEEFF */
664 printk(KERN_INFO "cs89x0 media %s%s%s",
665 (lp->adapter_cnf & A_CNF_10B_T)?"RJ-45,":"",
666 (lp->adapter_cnf & A_CNF_AUI)?"AUI,":"",
667 (lp->adapter_cnf & A_CNF_10B_2)?"BNC,":"");
669 lp->irq_map = 0xffff;
671 /* If this is a CS8900 then no pnp soft */
672 if (lp->chip_type != CS8900 &&
673 /* Check if the ISA IRQ has been set */
674 (i = readreg(dev, PP_CS8920_ISAINT) & 0xff,
675 (i != 0 && i < CS8920_NO_INTS))) {
676 if (!dev->irq)
677 dev->irq = i;
678 } else {
679 i = lp->isa_config & INT_NO_MASK;
680 if (lp->chip_type == CS8900) {
681 #ifdef CONFIG_ARCH_IXDP2X01
682 i = cs8900_irq_map[0];
683 #else
684 /* Translate the IRQ using the IRQ mapping table. */
685 if (i >= sizeof(cs8900_irq_map)/sizeof(cs8900_irq_map[0]))
686 printk("\ncs89x0: invalid ISA interrupt number %d\n", i);
687 else
688 i = cs8900_irq_map[i];
690 lp->irq_map = CS8900_IRQ_MAP; /* fixed IRQ map for CS8900 */
691 } else {
692 int irq_map_buff[IRQ_MAP_LEN/2];
694 if (get_eeprom_data(dev, IRQ_MAP_EEPROM_DATA,
695 IRQ_MAP_LEN/2,
696 irq_map_buff) >= 0) {
697 if ((irq_map_buff[0] & 0xff) == PNP_IRQ_FRMT)
698 lp->irq_map = (irq_map_buff[0]>>8) | (irq_map_buff[1] << 8);
700 #endif
702 if (!dev->irq)
703 dev->irq = i;
706 printk(" IRQ %d", dev->irq);
708 #if ALLOW_DMA
709 if (lp->use_dma) {
710 get_dma_channel(dev);
711 printk(", DMA %d", dev->dma);
713 else
714 #endif
716 printk(", programmed I/O");
719 /* print the ethernet address. */
720 printk(", MAC");
721 for (i = 0; i < ETH_ALEN; i++)
723 printk("%c%02x", i ? ':' : ' ', dev->dev_addr[i]);
726 dev->open = net_open;
727 dev->stop = net_close;
728 dev->tx_timeout = net_timeout;
729 dev->watchdog_timeo = HZ;
730 dev->hard_start_xmit = net_send_packet;
731 dev->get_stats = net_get_stats;
732 dev->set_multicast_list = set_multicast_list;
733 dev->set_mac_address = set_mac_address;
735 printk("\n");
736 if (net_debug)
737 printk("cs89x0_probe1() successful\n");
738 return 0;
739 out2:
740 release_region(ioaddr & ~3, NETCARD_IO_EXTENT);
741 out1:
742 return retval;
746 /*********************************
747 * This page contains DMA routines
748 **********************************/
750 #if ALLOW_DMA
752 #define dma_page_eq(ptr1, ptr2) ((long)(ptr1)>>17 == (long)(ptr2)>>17)
754 static void
755 get_dma_channel(struct net_device *dev)
757 struct net_local *lp = netdev_priv(dev);
759 if (lp->dma) {
760 dev->dma = lp->dma;
761 lp->isa_config |= ISA_RxDMA;
762 } else {
763 if ((lp->isa_config & ANY_ISA_DMA) == 0)
764 return;
765 dev->dma = lp->isa_config & DMA_NO_MASK;
766 if (lp->chip_type == CS8900)
767 dev->dma += 5;
768 if (dev->dma < 5 || dev->dma > 7) {
769 lp->isa_config &= ~ANY_ISA_DMA;
770 return;
773 return;
776 static void
777 write_dma(struct net_device *dev, int chip_type, int dma)
779 struct net_local *lp = netdev_priv(dev);
780 if ((lp->isa_config & ANY_ISA_DMA) == 0)
781 return;
782 if (chip_type == CS8900) {
783 writereg(dev, PP_CS8900_ISADMA, dma-5);
784 } else {
785 writereg(dev, PP_CS8920_ISADMA, dma);
789 static void
790 set_dma_cfg(struct net_device *dev)
792 struct net_local *lp = netdev_priv(dev);
794 if (lp->use_dma) {
795 if ((lp->isa_config & ANY_ISA_DMA) == 0) {
796 if (net_debug > 3)
797 printk("set_dma_cfg(): no DMA\n");
798 return;
800 if (lp->isa_config & ISA_RxDMA) {
801 lp->curr_rx_cfg |= RX_DMA_ONLY;
802 if (net_debug > 3)
803 printk("set_dma_cfg(): RX_DMA_ONLY\n");
804 } else {
805 lp->curr_rx_cfg |= AUTO_RX_DMA; /* not that we support it... */
806 if (net_debug > 3)
807 printk("set_dma_cfg(): AUTO_RX_DMA\n");
812 static int
813 dma_bufcfg(struct net_device *dev)
815 struct net_local *lp = netdev_priv(dev);
816 if (lp->use_dma)
817 return (lp->isa_config & ANY_ISA_DMA)? RX_DMA_ENBL : 0;
818 else
819 return 0;
822 static int
823 dma_busctl(struct net_device *dev)
825 int retval = 0;
826 struct net_local *lp = netdev_priv(dev);
827 if (lp->use_dma) {
828 if (lp->isa_config & ANY_ISA_DMA)
829 retval |= RESET_RX_DMA; /* Reset the DMA pointer */
830 if (lp->isa_config & DMA_BURST)
831 retval |= DMA_BURST_MODE; /* Does ISA config specify DMA burst ? */
832 if (lp->dmasize == 64)
833 retval |= RX_DMA_SIZE_64K; /* did they ask for 64K? */
834 retval |= MEMORY_ON; /* we need memory enabled to use DMA. */
836 return retval;
839 static void
840 dma_rx(struct net_device *dev)
842 struct net_local *lp = netdev_priv(dev);
843 struct sk_buff *skb;
844 int status, length;
845 unsigned char *bp = lp->rx_dma_ptr;
847 status = bp[0] + (bp[1]<<8);
848 length = bp[2] + (bp[3]<<8);
849 bp += 4;
850 if (net_debug > 5) {
851 printk( "%s: receiving DMA packet at %lx, status %x, length %x\n",
852 dev->name, (unsigned long)bp, status, length);
854 if ((status & RX_OK) == 0) {
855 count_rx_errors(status, lp);
856 goto skip_this_frame;
859 /* Malloc up new buffer. */
860 skb = dev_alloc_skb(length + 2);
861 if (skb == NULL) {
862 if (net_debug) /* I don't think we want to do this to a stressed system */
863 printk("%s: Memory squeeze, dropping packet.\n", dev->name);
864 lp->stats.rx_dropped++;
866 /* AKPM: advance bp to the next frame */
867 skip_this_frame:
868 bp += (length + 3) & ~3;
869 if (bp >= lp->end_dma_buff) bp -= lp->dmasize*1024;
870 lp->rx_dma_ptr = bp;
871 return;
873 skb_reserve(skb, 2); /* longword align L3 header */
874 skb->dev = dev;
876 if (bp + length > lp->end_dma_buff) {
877 int semi_cnt = lp->end_dma_buff - bp;
878 memcpy(skb_put(skb,semi_cnt), bp, semi_cnt);
879 memcpy(skb_put(skb,length - semi_cnt), lp->dma_buff,
880 length - semi_cnt);
881 } else {
882 memcpy(skb_put(skb,length), bp, length);
884 bp += (length + 3) & ~3;
885 if (bp >= lp->end_dma_buff) bp -= lp->dmasize*1024;
886 lp->rx_dma_ptr = bp;
888 if (net_debug > 3) {
889 printk( "%s: received %d byte DMA packet of type %x\n",
890 dev->name, length,
891 (skb->data[ETH_ALEN+ETH_ALEN] << 8) | skb->data[ETH_ALEN+ETH_ALEN+1]);
893 skb->protocol=eth_type_trans(skb,dev);
894 netif_rx(skb);
895 dev->last_rx = jiffies;
896 lp->stats.rx_packets++;
897 lp->stats.rx_bytes += length;
900 #endif /* ALLOW_DMA */
902 void __init reset_chip(struct net_device *dev)
904 #ifndef CONFIG_ARCH_IXDP2X01
905 struct net_local *lp = netdev_priv(dev);
906 int ioaddr = dev->base_addr;
907 #endif
908 int reset_start_time;
910 writereg(dev, PP_SelfCTL, readreg(dev, PP_SelfCTL) | POWER_ON_RESET);
912 /* wait 30 ms */
913 msleep(30);
915 #ifndef CONFIG_ARCH_IXDP2X01
916 if (lp->chip_type != CS8900) {
917 /* Hardware problem requires PNP registers to be reconfigured after a reset */
918 outw(PP_CS8920_ISAINT, ioaddr + ADD_PORT);
919 outb(dev->irq, ioaddr + DATA_PORT);
920 outb(0, ioaddr + DATA_PORT + 1);
922 outw(PP_CS8920_ISAMemB, ioaddr + ADD_PORT);
923 outb((dev->mem_start >> 16) & 0xff, ioaddr + DATA_PORT);
924 outb((dev->mem_start >> 8) & 0xff, ioaddr + DATA_PORT + 1);
926 #endif /* IXDP2x01 */
928 /* Wait until the chip is reset */
929 reset_start_time = jiffies;
930 while( (readreg(dev, PP_SelfST) & INIT_DONE) == 0 && jiffies - reset_start_time < 2)
935 static void
936 control_dc_dc(struct net_device *dev, int on_not_off)
938 struct net_local *lp = netdev_priv(dev);
939 unsigned int selfcontrol;
940 int timenow = jiffies;
941 /* control the DC to DC convertor in the SelfControl register.
942 Note: This is hooked up to a general purpose pin, might not
943 always be a DC to DC convertor. */
945 selfcontrol = HCB1_ENBL; /* Enable the HCB1 bit as an output */
946 if (((lp->adapter_cnf & A_CNF_DC_DC_POLARITY) != 0) ^ on_not_off)
947 selfcontrol |= HCB1;
948 else
949 selfcontrol &= ~HCB1;
950 writereg(dev, PP_SelfCTL, selfcontrol);
952 /* Wait for the DC/DC converter to power up - 500ms */
953 while (jiffies - timenow < HZ)
957 #define DETECTED_NONE 0
958 #define DETECTED_RJ45H 1
959 #define DETECTED_RJ45F 2
960 #define DETECTED_AUI 3
961 #define DETECTED_BNC 4
963 static int
964 detect_tp(struct net_device *dev)
966 struct net_local *lp = netdev_priv(dev);
967 int timenow = jiffies;
968 int fdx;
970 if (net_debug > 1) printk("%s: Attempting TP\n", dev->name);
972 /* If connected to another full duplex capable 10-Base-T card the link pulses
973 seem to be lost when the auto detect bit in the LineCTL is set.
974 To overcome this the auto detect bit will be cleared whilst testing the
975 10-Base-T interface. This would not be necessary for the sparrow chip but
976 is simpler to do it anyway. */
977 writereg(dev, PP_LineCTL, lp->linectl &~ AUI_ONLY);
978 control_dc_dc(dev, 0);
980 /* Delay for the hardware to work out if the TP cable is present - 150ms */
981 for (timenow = jiffies; jiffies - timenow < 15; )
983 if ((readreg(dev, PP_LineST) & LINK_OK) == 0)
984 return DETECTED_NONE;
986 if (lp->chip_type == CS8900) {
987 switch (lp->force & 0xf0) {
988 #if 0
989 case FORCE_AUTO:
990 printk("%s: cs8900 doesn't autonegotiate\n",dev->name);
991 return DETECTED_NONE;
992 #endif
993 /* CS8900 doesn't support AUTO, change to HALF*/
994 case FORCE_AUTO:
995 lp->force &= ~FORCE_AUTO;
996 lp->force |= FORCE_HALF;
997 break;
998 case FORCE_HALF:
999 break;
1000 case FORCE_FULL:
1001 writereg(dev, PP_TestCTL, readreg(dev, PP_TestCTL) | FDX_8900);
1002 break;
1004 fdx = readreg(dev, PP_TestCTL) & FDX_8900;
1005 } else {
1006 switch (lp->force & 0xf0) {
1007 case FORCE_AUTO:
1008 lp->auto_neg_cnf = AUTO_NEG_ENABLE;
1009 break;
1010 case FORCE_HALF:
1011 lp->auto_neg_cnf = 0;
1012 break;
1013 case FORCE_FULL:
1014 lp->auto_neg_cnf = RE_NEG_NOW | ALLOW_FDX;
1015 break;
1018 writereg(dev, PP_AutoNegCTL, lp->auto_neg_cnf & AUTO_NEG_MASK);
1020 if ((lp->auto_neg_cnf & AUTO_NEG_BITS) == AUTO_NEG_ENABLE) {
1021 printk(KERN_INFO "%s: negotiating duplex...\n",dev->name);
1022 while (readreg(dev, PP_AutoNegST) & AUTO_NEG_BUSY) {
1023 if (jiffies - timenow > 4000) {
1024 printk(KERN_ERR "**** Full / half duplex auto-negotiation timed out ****\n");
1025 break;
1029 fdx = readreg(dev, PP_AutoNegST) & FDX_ACTIVE;
1031 if (fdx)
1032 return DETECTED_RJ45F;
1033 else
1034 return DETECTED_RJ45H;
1037 /* send a test packet - return true if carrier bits are ok */
1038 static int
1039 send_test_pkt(struct net_device *dev)
1041 char test_packet[] = { 0,0,0,0,0,0, 0,0,0,0,0,0,
1042 0, 46, /* A 46 in network order */
1043 0, 0, /* DSAP=0 & SSAP=0 fields */
1044 0xf3, 0 /* Control (Test Req + P bit set) */ };
1045 long timenow = jiffies;
1047 writereg(dev, PP_LineCTL, readreg(dev, PP_LineCTL) | SERIAL_TX_ON);
1049 memcpy(test_packet, dev->dev_addr, ETH_ALEN);
1050 memcpy(test_packet+ETH_ALEN, dev->dev_addr, ETH_ALEN);
1052 writeword(dev, TX_CMD_PORT, TX_AFTER_ALL);
1053 writeword(dev, TX_LEN_PORT, ETH_ZLEN);
1055 /* Test to see if the chip has allocated memory for the packet */
1056 while (jiffies - timenow < 5)
1057 if (readreg(dev, PP_BusST) & READY_FOR_TX_NOW)
1058 break;
1059 if (jiffies - timenow >= 5)
1060 return 0; /* this shouldn't happen */
1062 /* Write the contents of the packet */
1063 outsw(dev->base_addr + TX_FRAME_PORT,test_packet,(ETH_ZLEN+1) >>1);
1065 if (net_debug > 1) printk("Sending test packet ");
1066 /* wait a couple of jiffies for packet to be received */
1067 for (timenow = jiffies; jiffies - timenow < 3; )
1069 if ((readreg(dev, PP_TxEvent) & TX_SEND_OK_BITS) == TX_OK) {
1070 if (net_debug > 1) printk("succeeded\n");
1071 return 1;
1073 if (net_debug > 1) printk("failed\n");
1074 return 0;
1078 static int
1079 detect_aui(struct net_device *dev)
1081 struct net_local *lp = netdev_priv(dev);
1083 if (net_debug > 1) printk("%s: Attempting AUI\n", dev->name);
1084 control_dc_dc(dev, 0);
1086 writereg(dev, PP_LineCTL, (lp->linectl &~ AUTO_AUI_10BASET) | AUI_ONLY);
1088 if (send_test_pkt(dev))
1089 return DETECTED_AUI;
1090 else
1091 return DETECTED_NONE;
1094 static int
1095 detect_bnc(struct net_device *dev)
1097 struct net_local *lp = netdev_priv(dev);
1099 if (net_debug > 1) printk("%s: Attempting BNC\n", dev->name);
1100 control_dc_dc(dev, 1);
1102 writereg(dev, PP_LineCTL, (lp->linectl &~ AUTO_AUI_10BASET) | AUI_ONLY);
1104 if (send_test_pkt(dev))
1105 return DETECTED_BNC;
1106 else
1107 return DETECTED_NONE;
1111 static void
1112 write_irq(struct net_device *dev, int chip_type, int irq)
1114 int i;
1116 if (chip_type == CS8900) {
1117 /* Search the mapping table for the corresponding IRQ pin. */
1118 for (i = 0; i != sizeof(cs8900_irq_map)/sizeof(cs8900_irq_map[0]); i++)
1119 if (cs8900_irq_map[i] == irq)
1120 break;
1121 /* Not found */
1122 if (i == sizeof(cs8900_irq_map)/sizeof(cs8900_irq_map[0]))
1123 i = 3;
1124 writereg(dev, PP_CS8900_ISAINT, i);
1125 } else {
1126 writereg(dev, PP_CS8920_ISAINT, irq);
1130 /* Open/initialize the board. This is called (in the current kernel)
1131 sometime after booting when the 'ifconfig' program is run.
1133 This routine should set everything up anew at each open, even
1134 registers that "should" only need to be set once at boot, so that
1135 there is non-reboot way to recover if something goes wrong.
1138 /* AKPM: do we need to do any locking here? */
1140 static int
1141 net_open(struct net_device *dev)
1143 struct net_local *lp = netdev_priv(dev);
1144 int result = 0;
1145 int i;
1146 int ret;
1148 #ifndef CONFIG_SH_HICOSH4 /* uses irq#1, so this won't work */
1149 if (dev->irq < 2) {
1150 /* Allow interrupts to be generated by the chip */
1151 /* Cirrus' release had this: */
1152 #if 0
1153 writereg(dev, PP_BusCTL, readreg(dev, PP_BusCTL)|ENABLE_IRQ );
1154 #endif
1155 /* And 2.3.47 had this: */
1156 writereg(dev, PP_BusCTL, ENABLE_IRQ | MEMORY_ON);
1158 for (i = 2; i < CS8920_NO_INTS; i++) {
1159 if ((1 << i) & lp->irq_map) {
1160 if (request_irq(i, net_interrupt, 0, dev->name, dev) == 0) {
1161 dev->irq = i;
1162 write_irq(dev, lp->chip_type, i);
1163 /* writereg(dev, PP_BufCFG, GENERATE_SW_INTERRUPT); */
1164 break;
1169 if (i >= CS8920_NO_INTS) {
1170 writereg(dev, PP_BusCTL, 0); /* disable interrupts. */
1171 printk(KERN_ERR "cs89x0: can't get an interrupt\n");
1172 ret = -EAGAIN;
1173 goto bad_out;
1176 else
1177 #endif
1179 #ifndef CONFIG_ARCH_IXDP2X01
1180 if (((1 << dev->irq) & lp->irq_map) == 0) {
1181 printk(KERN_ERR "%s: IRQ %d is not in our map of allowable IRQs, which is %x\n",
1182 dev->name, dev->irq, lp->irq_map);
1183 ret = -EAGAIN;
1184 goto bad_out;
1186 #endif
1187 /* FIXME: Cirrus' release had this: */
1188 writereg(dev, PP_BusCTL, readreg(dev, PP_BusCTL)|ENABLE_IRQ );
1189 /* And 2.3.47 had this: */
1190 #if 0
1191 writereg(dev, PP_BusCTL, ENABLE_IRQ | MEMORY_ON);
1192 #endif
1193 write_irq(dev, lp->chip_type, dev->irq);
1194 ret = request_irq(dev->irq, &net_interrupt, 0, dev->name, dev);
1195 if (ret) {
1196 if (net_debug)
1197 printk(KERN_DEBUG "cs89x0: request_irq(%d) failed\n", dev->irq);
1198 goto bad_out;
1202 #if ALLOW_DMA
1203 if (lp->use_dma) {
1204 if (lp->isa_config & ANY_ISA_DMA) {
1205 unsigned long flags;
1206 lp->dma_buff = (unsigned char *)__get_dma_pages(GFP_KERNEL,
1207 get_order(lp->dmasize * 1024));
1209 if (!lp->dma_buff) {
1210 printk(KERN_ERR "%s: cannot get %dK memory for DMA\n", dev->name, lp->dmasize);
1211 goto release_irq;
1213 if (net_debug > 1) {
1214 printk( "%s: dma %lx %lx\n",
1215 dev->name,
1216 (unsigned long)lp->dma_buff,
1217 (unsigned long)isa_virt_to_bus(lp->dma_buff));
1219 if ((unsigned long) lp->dma_buff >= MAX_DMA_ADDRESS ||
1220 !dma_page_eq(lp->dma_buff, lp->dma_buff+lp->dmasize*1024-1)) {
1221 printk(KERN_ERR "%s: not usable as DMA buffer\n", dev->name);
1222 goto release_irq;
1224 memset(lp->dma_buff, 0, lp->dmasize * 1024); /* Why? */
1225 if (request_dma(dev->dma, dev->name)) {
1226 printk(KERN_ERR "%s: cannot get dma channel %d\n", dev->name, dev->dma);
1227 goto release_irq;
1229 write_dma(dev, lp->chip_type, dev->dma);
1230 lp->rx_dma_ptr = lp->dma_buff;
1231 lp->end_dma_buff = lp->dma_buff + lp->dmasize*1024;
1232 spin_lock_irqsave(&lp->lock, flags);
1233 disable_dma(dev->dma);
1234 clear_dma_ff(dev->dma);
1235 set_dma_mode(dev->dma, 0x14); /* auto_init as well */
1236 set_dma_addr(dev->dma, isa_virt_to_bus(lp->dma_buff));
1237 set_dma_count(dev->dma, lp->dmasize*1024);
1238 enable_dma(dev->dma);
1239 spin_unlock_irqrestore(&lp->lock, flags);
1242 #endif /* ALLOW_DMA */
1244 /* set the Ethernet address */
1245 for (i=0; i < ETH_ALEN/2; i++)
1246 writereg(dev, PP_IA+i*2, dev->dev_addr[i*2] | (dev->dev_addr[i*2+1] << 8));
1248 /* while we're testing the interface, leave interrupts disabled */
1249 writereg(dev, PP_BusCTL, MEMORY_ON);
1251 /* Set the LineCTL quintuplet based on adapter configuration read from EEPROM */
1252 if ((lp->adapter_cnf & A_CNF_EXTND_10B_2) && (lp->adapter_cnf & A_CNF_LOW_RX_SQUELCH))
1253 lp->linectl = LOW_RX_SQUELCH;
1254 else
1255 lp->linectl = 0;
1257 /* check to make sure that they have the "right" hardware available */
1258 switch(lp->adapter_cnf & A_CNF_MEDIA_TYPE) {
1259 case A_CNF_MEDIA_10B_T: result = lp->adapter_cnf & A_CNF_10B_T; break;
1260 case A_CNF_MEDIA_AUI: result = lp->adapter_cnf & A_CNF_AUI; break;
1261 case A_CNF_MEDIA_10B_2: result = lp->adapter_cnf & A_CNF_10B_2; break;
1262 default: result = lp->adapter_cnf & (A_CNF_10B_T | A_CNF_AUI | A_CNF_10B_2);
1264 if (!result) {
1265 printk(KERN_ERR "%s: EEPROM is configured for unavailable media\n", dev->name);
1266 release_irq:
1267 #if ALLOW_DMA
1268 release_dma_buff(lp);
1269 #endif
1270 writereg(dev, PP_LineCTL, readreg(dev, PP_LineCTL) & ~(SERIAL_TX_ON | SERIAL_RX_ON));
1271 free_irq(dev->irq, dev);
1272 ret = -EAGAIN;
1273 goto bad_out;
1276 /* set the hardware to the configured choice */
1277 switch(lp->adapter_cnf & A_CNF_MEDIA_TYPE) {
1278 case A_CNF_MEDIA_10B_T:
1279 result = detect_tp(dev);
1280 if (result==DETECTED_NONE) {
1281 printk(KERN_WARNING "%s: 10Base-T (RJ-45) has no cable\n", dev->name);
1282 if (lp->auto_neg_cnf & IMM_BIT) /* check "ignore missing media" bit */
1283 result = DETECTED_RJ45H; /* Yes! I don't care if I see a link pulse */
1285 break;
1286 case A_CNF_MEDIA_AUI:
1287 result = detect_aui(dev);
1288 if (result==DETECTED_NONE) {
1289 printk(KERN_WARNING "%s: 10Base-5 (AUI) has no cable\n", dev->name);
1290 if (lp->auto_neg_cnf & IMM_BIT) /* check "ignore missing media" bit */
1291 result = DETECTED_AUI; /* Yes! I don't care if I see a carrrier */
1293 break;
1294 case A_CNF_MEDIA_10B_2:
1295 result = detect_bnc(dev);
1296 if (result==DETECTED_NONE) {
1297 printk(KERN_WARNING "%s: 10Base-2 (BNC) has no cable\n", dev->name);
1298 if (lp->auto_neg_cnf & IMM_BIT) /* check "ignore missing media" bit */
1299 result = DETECTED_BNC; /* Yes! I don't care if I can xmit a packet */
1301 break;
1302 case A_CNF_MEDIA_AUTO:
1303 writereg(dev, PP_LineCTL, lp->linectl | AUTO_AUI_10BASET);
1304 if (lp->adapter_cnf & A_CNF_10B_T)
1305 if ((result = detect_tp(dev)) != DETECTED_NONE)
1306 break;
1307 if (lp->adapter_cnf & A_CNF_AUI)
1308 if ((result = detect_aui(dev)) != DETECTED_NONE)
1309 break;
1310 if (lp->adapter_cnf & A_CNF_10B_2)
1311 if ((result = detect_bnc(dev)) != DETECTED_NONE)
1312 break;
1313 printk(KERN_ERR "%s: no media detected\n", dev->name);
1314 goto release_irq;
1316 switch(result) {
1317 case DETECTED_NONE:
1318 printk(KERN_ERR "%s: no network cable attached to configured media\n", dev->name);
1319 goto release_irq;
1320 case DETECTED_RJ45H:
1321 printk(KERN_INFO "%s: using half-duplex 10Base-T (RJ-45)\n", dev->name);
1322 break;
1323 case DETECTED_RJ45F:
1324 printk(KERN_INFO "%s: using full-duplex 10Base-T (RJ-45)\n", dev->name);
1325 break;
1326 case DETECTED_AUI:
1327 printk(KERN_INFO "%s: using 10Base-5 (AUI)\n", dev->name);
1328 break;
1329 case DETECTED_BNC:
1330 printk(KERN_INFO "%s: using 10Base-2 (BNC)\n", dev->name);
1331 break;
1334 /* Turn on both receive and transmit operations */
1335 writereg(dev, PP_LineCTL, readreg(dev, PP_LineCTL) | SERIAL_RX_ON | SERIAL_TX_ON);
1337 /* Receive only error free packets addressed to this card */
1338 lp->rx_mode = 0;
1339 writereg(dev, PP_RxCTL, DEF_RX_ACCEPT);
1341 lp->curr_rx_cfg = RX_OK_ENBL | RX_CRC_ERROR_ENBL;
1343 if (lp->isa_config & STREAM_TRANSFER)
1344 lp->curr_rx_cfg |= RX_STREAM_ENBL;
1345 #if ALLOW_DMA
1346 set_dma_cfg(dev);
1347 #endif
1348 writereg(dev, PP_RxCFG, lp->curr_rx_cfg);
1350 writereg(dev, PP_TxCFG, TX_LOST_CRS_ENBL | TX_SQE_ERROR_ENBL | TX_OK_ENBL |
1351 TX_LATE_COL_ENBL | TX_JBR_ENBL | TX_ANY_COL_ENBL | TX_16_COL_ENBL);
1353 writereg(dev, PP_BufCFG, READY_FOR_TX_ENBL | RX_MISS_COUNT_OVRFLOW_ENBL |
1354 #if ALLOW_DMA
1355 dma_bufcfg(dev) |
1356 #endif
1357 TX_COL_COUNT_OVRFLOW_ENBL | TX_UNDERRUN_ENBL);
1359 /* now that we've got our act together, enable everything */
1360 writereg(dev, PP_BusCTL, ENABLE_IRQ
1361 | (dev->mem_start?MEMORY_ON : 0) /* turn memory on */
1362 #if ALLOW_DMA
1363 | dma_busctl(dev)
1364 #endif
1366 netif_start_queue(dev);
1367 if (net_debug > 1)
1368 printk("cs89x0: net_open() succeeded\n");
1369 return 0;
1370 bad_out:
1371 return ret;
1374 static void net_timeout(struct net_device *dev)
1376 /* If we get here, some higher level has decided we are broken.
1377 There should really be a "kick me" function call instead. */
1378 if (net_debug > 0) printk("%s: transmit timed out, %s?\n", dev->name,
1379 tx_done(dev) ? "IRQ conflict ?" : "network cable problem");
1380 /* Try to restart the adaptor. */
1381 netif_wake_queue(dev);
1384 static int net_send_packet(struct sk_buff *skb, struct net_device *dev)
1386 struct net_local *lp = netdev_priv(dev);
1388 if (net_debug > 3) {
1389 printk("%s: sent %d byte packet of type %x\n",
1390 dev->name, skb->len,
1391 (skb->data[ETH_ALEN+ETH_ALEN] << 8) | skb->data[ETH_ALEN+ETH_ALEN+1]);
1394 /* keep the upload from being interrupted, since we
1395 ask the chip to start transmitting before the
1396 whole packet has been completely uploaded. */
1398 spin_lock_irq(&lp->lock);
1399 netif_stop_queue(dev);
1401 /* initiate a transmit sequence */
1402 writeword(dev, TX_CMD_PORT, lp->send_cmd);
1403 writeword(dev, TX_LEN_PORT, skb->len);
1405 /* Test to see if the chip has allocated memory for the packet */
1406 if ((readreg(dev, PP_BusST) & READY_FOR_TX_NOW) == 0) {
1408 * Gasp! It hasn't. But that shouldn't happen since
1409 * we're waiting for TxOk, so return 1 and requeue this packet.
1412 spin_unlock_irq(&lp->lock);
1413 if (net_debug) printk("cs89x0: Tx buffer not free!\n");
1414 return 1;
1416 /* Write the contents of the packet */
1417 outsw(dev->base_addr + TX_FRAME_PORT,skb->data,(skb->len+1) >>1);
1418 spin_unlock_irq(&lp->lock);
1419 dev->trans_start = jiffies;
1420 dev_kfree_skb (skb);
1423 * We DO NOT call netif_wake_queue() here.
1424 * We also DO NOT call netif_start_queue().
1426 * Either of these would cause another bottom half run through
1427 * net_send_packet() before this packet has fully gone out. That causes
1428 * us to hit the "Gasp!" above and the send is rescheduled. it runs like
1429 * a dog. We just return and wait for the Tx completion interrupt handler
1430 * to restart the netdevice layer
1433 return 0;
1436 /* The typical workload of the driver:
1437 Handle the network interface interrupts. */
1439 static irqreturn_t net_interrupt(int irq, void *dev_id, struct pt_regs * regs)
1441 struct net_device *dev = dev_id;
1442 struct net_local *lp;
1443 int ioaddr, status;
1444 int handled = 0;
1446 ioaddr = dev->base_addr;
1447 lp = netdev_priv(dev);
1449 /* we MUST read all the events out of the ISQ, otherwise we'll never
1450 get interrupted again. As a consequence, we can't have any limit
1451 on the number of times we loop in the interrupt handler. The
1452 hardware guarantees that eventually we'll run out of events. Of
1453 course, if you're on a slow machine, and packets are arriving
1454 faster than you can read them off, you're screwed. Hasta la
1455 vista, baby! */
1456 while ((status = readword(dev, ISQ_PORT))) {
1457 if (net_debug > 4)printk("%s: event=%04x\n", dev->name, status);
1458 handled = 1;
1459 switch(status & ISQ_EVENT_MASK) {
1460 case ISQ_RECEIVER_EVENT:
1461 /* Got a packet(s). */
1462 net_rx(dev);
1463 break;
1464 case ISQ_TRANSMITTER_EVENT:
1465 lp->stats.tx_packets++;
1466 netif_wake_queue(dev); /* Inform upper layers. */
1467 if ((status & ( TX_OK |
1468 TX_LOST_CRS |
1469 TX_SQE_ERROR |
1470 TX_LATE_COL |
1471 TX_16_COL)) != TX_OK) {
1472 if ((status & TX_OK) == 0) lp->stats.tx_errors++;
1473 if (status & TX_LOST_CRS) lp->stats.tx_carrier_errors++;
1474 if (status & TX_SQE_ERROR) lp->stats.tx_heartbeat_errors++;
1475 if (status & TX_LATE_COL) lp->stats.tx_window_errors++;
1476 if (status & TX_16_COL) lp->stats.tx_aborted_errors++;
1478 break;
1479 case ISQ_BUFFER_EVENT:
1480 if (status & READY_FOR_TX) {
1481 /* we tried to transmit a packet earlier,
1482 but inexplicably ran out of buffers.
1483 That shouldn't happen since we only ever
1484 load one packet. Shrug. Do the right
1485 thing anyway. */
1486 netif_wake_queue(dev); /* Inform upper layers. */
1488 if (status & TX_UNDERRUN) {
1489 if (net_debug > 0) printk("%s: transmit underrun\n", dev->name);
1490 lp->send_underrun++;
1491 if (lp->send_underrun == 3) lp->send_cmd = TX_AFTER_381;
1492 else if (lp->send_underrun == 6) lp->send_cmd = TX_AFTER_ALL;
1493 /* transmit cycle is done, although
1494 frame wasn't transmitted - this
1495 avoids having to wait for the upper
1496 layers to timeout on us, in the
1497 event of a tx underrun */
1498 netif_wake_queue(dev); /* Inform upper layers. */
1500 #if ALLOW_DMA
1501 if (lp->use_dma && (status & RX_DMA)) {
1502 int count = readreg(dev, PP_DmaFrameCnt);
1503 while(count) {
1504 if (net_debug > 5)
1505 printk("%s: receiving %d DMA frames\n", dev->name, count);
1506 if (net_debug > 2 && count >1)
1507 printk("%s: receiving %d DMA frames\n", dev->name, count);
1508 dma_rx(dev);
1509 if (--count == 0)
1510 count = readreg(dev, PP_DmaFrameCnt);
1511 if (net_debug > 2 && count > 0)
1512 printk("%s: continuing with %d DMA frames\n", dev->name, count);
1515 #endif
1516 break;
1517 case ISQ_RX_MISS_EVENT:
1518 lp->stats.rx_missed_errors += (status >>6);
1519 break;
1520 case ISQ_TX_COL_EVENT:
1521 lp->stats.collisions += (status >>6);
1522 break;
1525 return IRQ_RETVAL(handled);
1528 static void
1529 count_rx_errors(int status, struct net_local *lp)
1531 lp->stats.rx_errors++;
1532 if (status & RX_RUNT) lp->stats.rx_length_errors++;
1533 if (status & RX_EXTRA_DATA) lp->stats.rx_length_errors++;
1534 if (status & RX_CRC_ERROR) if (!(status & (RX_EXTRA_DATA|RX_RUNT)))
1535 /* per str 172 */
1536 lp->stats.rx_crc_errors++;
1537 if (status & RX_DRIBBLE) lp->stats.rx_frame_errors++;
1538 return;
1541 /* We have a good packet(s), get it/them out of the buffers. */
1542 static void
1543 net_rx(struct net_device *dev)
1545 struct net_local *lp = netdev_priv(dev);
1546 struct sk_buff *skb;
1547 int status, length;
1549 int ioaddr = dev->base_addr;
1550 status = inw(ioaddr + RX_FRAME_PORT);
1551 length = inw(ioaddr + RX_FRAME_PORT);
1553 if ((status & RX_OK) == 0) {
1554 count_rx_errors(status, lp);
1555 return;
1558 /* Malloc up new buffer. */
1559 skb = dev_alloc_skb(length + 2);
1560 if (skb == NULL) {
1561 #if 0 /* Again, this seems a cruel thing to do */
1562 printk(KERN_WARNING "%s: Memory squeeze, dropping packet.\n", dev->name);
1563 #endif
1564 lp->stats.rx_dropped++;
1565 return;
1567 skb_reserve(skb, 2); /* longword align L3 header */
1568 skb->dev = dev;
1570 insw(ioaddr + RX_FRAME_PORT, skb_put(skb, length), length >> 1);
1571 if (length & 1)
1572 skb->data[length-1] = inw(ioaddr + RX_FRAME_PORT);
1574 if (net_debug > 3) {
1575 printk( "%s: received %d byte packet of type %x\n",
1576 dev->name, length,
1577 (skb->data[ETH_ALEN+ETH_ALEN] << 8) | skb->data[ETH_ALEN+ETH_ALEN+1]);
1580 skb->protocol=eth_type_trans(skb,dev);
1581 netif_rx(skb);
1582 dev->last_rx = jiffies;
1583 lp->stats.rx_packets++;
1584 lp->stats.rx_bytes += length;
1587 #if ALLOW_DMA
1588 static void release_dma_buff(struct net_local *lp)
1590 if (lp->dma_buff) {
1591 free_pages((unsigned long)(lp->dma_buff), get_order(lp->dmasize * 1024));
1592 lp->dma_buff = NULL;
1595 #endif
1597 /* The inverse routine to net_open(). */
1598 static int
1599 net_close(struct net_device *dev)
1601 #if ALLOW_DMA
1602 struct net_local *lp = netdev_priv(dev);
1603 #endif
1605 netif_stop_queue(dev);
1607 writereg(dev, PP_RxCFG, 0);
1608 writereg(dev, PP_TxCFG, 0);
1609 writereg(dev, PP_BufCFG, 0);
1610 writereg(dev, PP_BusCTL, 0);
1612 free_irq(dev->irq, dev);
1614 #if ALLOW_DMA
1615 if (lp->use_dma && lp->dma) {
1616 free_dma(dev->dma);
1617 release_dma_buff(lp);
1619 #endif
1621 /* Update the statistics here. */
1622 return 0;
1625 /* Get the current statistics. This may be called with the card open or
1626 closed. */
1627 static struct net_device_stats *
1628 net_get_stats(struct net_device *dev)
1630 struct net_local *lp = netdev_priv(dev);
1631 unsigned long flags;
1633 spin_lock_irqsave(&lp->lock, flags);
1634 /* Update the statistics from the device registers. */
1635 lp->stats.rx_missed_errors += (readreg(dev, PP_RxMiss) >> 6);
1636 lp->stats.collisions += (readreg(dev, PP_TxCol) >> 6);
1637 spin_unlock_irqrestore(&lp->lock, flags);
1639 return &lp->stats;
1642 static void set_multicast_list(struct net_device *dev)
1644 struct net_local *lp = netdev_priv(dev);
1645 unsigned long flags;
1647 spin_lock_irqsave(&lp->lock, flags);
1648 if(dev->flags&IFF_PROMISC)
1650 lp->rx_mode = RX_ALL_ACCEPT;
1652 else if((dev->flags&IFF_ALLMULTI)||dev->mc_list)
1654 /* The multicast-accept list is initialized to accept-all, and we
1655 rely on higher-level filtering for now. */
1656 lp->rx_mode = RX_MULTCAST_ACCEPT;
1658 else
1659 lp->rx_mode = 0;
1661 writereg(dev, PP_RxCTL, DEF_RX_ACCEPT | lp->rx_mode);
1663 /* in promiscuous mode, we accept errored packets, so we have to enable interrupts on them also */
1664 writereg(dev, PP_RxCFG, lp->curr_rx_cfg |
1665 (lp->rx_mode == RX_ALL_ACCEPT? (RX_CRC_ERROR_ENBL|RX_RUNT_ENBL|RX_EXTRA_DATA_ENBL) : 0));
1666 spin_unlock_irqrestore(&lp->lock, flags);
1670 static int set_mac_address(struct net_device *dev, void *p)
1672 int i;
1673 struct sockaddr *addr = p;
1676 if (netif_running(dev))
1677 return -EBUSY;
1679 memcpy(dev->dev_addr, addr->sa_data, dev->addr_len);
1681 if (net_debug) {
1682 printk("%s: Setting MAC address to ", dev->name);
1683 for (i = 0; i < dev->addr_len; i++)
1684 printk(" %2.2x", dev->dev_addr[i]);
1685 printk(".\n");
1687 /* set the Ethernet address */
1688 for (i=0; i < ETH_ALEN/2; i++)
1689 writereg(dev, PP_IA+i*2, dev->dev_addr[i*2] | (dev->dev_addr[i*2+1] << 8));
1691 return 0;
1694 #ifdef MODULE
1696 static struct net_device *dev_cs89x0;
1699 * Support the 'debug' module parm even if we're compiled for non-debug to
1700 * avoid breaking someone's startup scripts
1703 static int io;
1704 static int irq;
1705 static int debug;
1706 static char media[8];
1707 static int duplex=-1;
1709 static int use_dma; /* These generate unused var warnings if ALLOW_DMA = 0 */
1710 static int dma;
1711 static int dmasize=16; /* or 64 */
1713 module_param(io, int, 0);
1714 module_param(irq, int, 0);
1715 module_param(debug, int, 0);
1716 module_param_string(media, media, sizeof(media), 0);
1717 module_param(duplex, int, 0);
1718 module_param(dma , int, 0);
1719 module_param(dmasize , int, 0);
1720 module_param(use_dma , int, 0);
1721 MODULE_PARM_DESC(io, "cs89x0 I/O base address");
1722 MODULE_PARM_DESC(irq, "cs89x0 IRQ number");
1723 #if DEBUGGING
1724 MODULE_PARM_DESC(debug, "cs89x0 debug level (0-6)");
1725 #else
1726 MODULE_PARM_DESC(debug, "(ignored)");
1727 #endif
1728 MODULE_PARM_DESC(media, "Set cs89x0 adapter(s) media type(s) (rj45,bnc,aui)");
1729 /* No other value than -1 for duplex seems to be currently interpreted */
1730 MODULE_PARM_DESC(duplex, "(ignored)");
1731 #if ALLOW_DMA
1732 MODULE_PARM_DESC(dma , "cs89x0 ISA DMA channel; ignored if use_dma=0");
1733 MODULE_PARM_DESC(dmasize , "cs89x0 DMA size in kB (16,64); ignored if use_dma=0");
1734 MODULE_PARM_DESC(use_dma , "cs89x0 using DMA (0-1)");
1735 #else
1736 MODULE_PARM_DESC(dma , "(ignored)");
1737 MODULE_PARM_DESC(dmasize , "(ignored)");
1738 MODULE_PARM_DESC(use_dma , "(ignored)");
1739 #endif
1741 MODULE_AUTHOR("Mike Cruse, Russwll Nelson <nelson@crynwr.com>, Andrew Morton <andrewm@uow.edu.au>");
1742 MODULE_LICENSE("GPL");
1746 * media=t - specify media type
1747 or media=2
1748 or media=aui
1749 or medai=auto
1750 * duplex=0 - specify forced half/full/autonegotiate duplex
1751 * debug=# - debug level
1754 * Default Chip Configuration:
1755 * DMA Burst = enabled
1756 * IOCHRDY Enabled = enabled
1757 * UseSA = enabled
1758 * CS8900 defaults to half-duplex if not specified on command-line
1759 * CS8920 defaults to autoneg if not specified on command-line
1760 * Use reset defaults for other config parameters
1762 * Assumptions:
1763 * media type specified is supported (circuitry is present)
1764 * if memory address is > 1MB, then required mem decode hw is present
1765 * if 10B-2, then agent other than driver will enable DC/DC converter
1766 (hw or software util)
1772 init_module(void)
1774 struct net_device *dev = alloc_etherdev(sizeof(struct net_local));
1775 struct net_local *lp;
1776 int ret = 0;
1778 #if DEBUGGING
1779 net_debug = debug;
1780 #else
1781 debug = 0;
1782 #endif
1783 if (!dev)
1784 return -ENOMEM;
1786 dev->irq = irq;
1787 dev->base_addr = io;
1788 lp = netdev_priv(dev);
1790 #if ALLOW_DMA
1791 if (use_dma) {
1792 lp->use_dma = use_dma;
1793 lp->dma = dma;
1794 lp->dmasize = dmasize;
1796 #endif
1798 spin_lock_init(&lp->lock);
1800 /* boy, they'd better get these right */
1801 if (!strcmp(media, "rj45"))
1802 lp->adapter_cnf = A_CNF_MEDIA_10B_T | A_CNF_10B_T;
1803 else if (!strcmp(media, "aui"))
1804 lp->adapter_cnf = A_CNF_MEDIA_AUI | A_CNF_AUI;
1805 else if (!strcmp(media, "bnc"))
1806 lp->adapter_cnf = A_CNF_MEDIA_10B_2 | A_CNF_10B_2;
1807 else
1808 lp->adapter_cnf = A_CNF_MEDIA_10B_T | A_CNF_10B_T;
1810 if (duplex==-1)
1811 lp->auto_neg_cnf = AUTO_NEG_ENABLE;
1813 if (io == 0) {
1814 printk(KERN_ERR "cs89x0.c: Module autoprobing not allowed.\n");
1815 printk(KERN_ERR "cs89x0.c: Append io=0xNNN\n");
1816 ret = -EPERM;
1817 goto out;
1818 } else if (io <= 0x1ff) {
1819 ret = -ENXIO;
1820 goto out;
1823 #if ALLOW_DMA
1824 if (use_dma && dmasize != 16 && dmasize != 64) {
1825 printk(KERN_ERR "cs89x0.c: dma size must be either 16K or 64K, not %dK\n", dmasize);
1826 ret = -EPERM;
1827 goto out;
1829 #endif
1830 ret = cs89x0_probe1(dev, io, 1);
1831 if (ret)
1832 goto out;
1834 if (register_netdev(dev) != 0) {
1835 printk(KERN_ERR "cs89x0.c: No card found at 0x%x\n", io);
1836 ret = -ENXIO;
1837 outw(PP_ChipID, dev->base_addr + ADD_PORT);
1838 release_region(dev->base_addr, NETCARD_IO_EXTENT);
1839 goto out;
1841 dev_cs89x0 = dev;
1842 return 0;
1843 out:
1844 free_netdev(dev);
1845 return ret;
1848 void
1849 cleanup_module(void)
1851 unregister_netdev(dev_cs89x0);
1852 outw(PP_ChipID, dev_cs89x0->base_addr + ADD_PORT);
1853 release_region(dev_cs89x0->base_addr, NETCARD_IO_EXTENT);
1854 free_netdev(dev_cs89x0);
1856 #endif /* MODULE */
1859 * Local variables:
1860 * version-control: t
1861 * kept-new-versions: 5
1862 * c-indent-level: 8
1863 * tab-width: 8
1864 * End: