3c509.c
上传用户:lgb322
上传日期:2013-02-24
资源大小:30529k
文件大小:33k
源码类别:

嵌入式Linux

开发平台:

Unix_Linux

  1. /* 3c509.c: A 3c509 EtherLink3 ethernet driver for linux. */
  2. /*
  3. Written 1993-2000 by Donald Becker.
  4. Copyright 1994-2000 by Donald Becker.
  5. Copyright 1993 United States Government as represented by the
  6. Director, National Security Agency.  This software may be used and
  7. distributed according to the terms of the GNU General Public License,
  8. incorporated herein by reference.
  9. This driver is for the 3Com EtherLinkIII series.
  10. The author may be reached as becker@scyld.com, or C/O
  11. Scyld Computing Corporation
  12. 410 Severn Ave., Suite 210
  13. Annapolis MD 21403
  14. Known limitations:
  15. Because of the way 3c509 ISA detection works it's difficult to predict
  16. a priori which of several ISA-mode cards will be detected first.
  17. This driver does not use predictive interrupt mode, resulting in higher
  18. packet latency but lower overhead.  If interrupts are disabled for an
  19. unusually long time it could also result in missed packets, but in
  20. practice this rarely happens.
  21. FIXES:
  22. Alan Cox:       Removed the 'Unexpected interrupt' bug.
  23. Michael Meskes: Upgraded to Donald Becker's version 1.07.
  24. Alan Cox: Increased the eeprom delay. Regardless of 
  25. what the docs say some people definitely
  26. get problems with lower (but in card spec)
  27. delays
  28. v1.10 4/21/97 Fixed module code so that multiple cards may be detected,
  29. other cleanups.  -djb
  30. Andrea Arcangeli: Upgraded to Donald Becker's version 1.12.
  31. Rick Payne: Fixed SMP race condition
  32. v1.13 9/8/97 Made 'max_interrupt_work' an insmod-settable variable -djb
  33. v1.14 10/15/97 Avoided waiting..discard message for fast machines -djb
  34. v1.15 1/31/98 Faster recovery for Tx errors. -djb
  35. v1.16 2/3/98 Different ID port handling to avoid sound cards. -djb
  36. v1.18 12Mar2001 Andrew Morton <andrewm@uow.edu.au>
  37. - Avoid bogus detect of 3c590's (Andrzej Krzysztofowicz)
  38. - Reviewed against 1.18 from scyld.com
  39. v1.18a 17Nov2001 Jeff Garzik <jgarzik@mandrakesoft.com>
  40. - ethtool support
  41. */
  42. #define DRV_NAME "3c509"
  43. #define DRV_VERSION "1.18a"
  44. #define DRV_RELDATE "17Nov2001"
  45. /* A few values that may be tweaked. */
  46. /* Time in jiffies before concluding the transmitter is hung. */
  47. #define TX_TIMEOUT  (400*HZ/1000)
  48. /* Maximum events (Rx packets, etc.) to handle at each interrupt. */
  49. static int max_interrupt_work = 10;
  50. #include <linux/config.h>
  51. #include <linux/module.h>
  52. #include <linux/mca.h>
  53. #include <linux/isapnp.h>
  54. #include <linux/sched.h>
  55. #include <linux/string.h>
  56. #include <linux/interrupt.h>
  57. #include <linux/errno.h>
  58. #include <linux/in.h>
  59. #include <linux/slab.h>
  60. #include <linux/ioport.h>
  61. #include <linux/init.h>
  62. #include <linux/netdevice.h>
  63. #include <linux/etherdevice.h>
  64. #include <linux/skbuff.h>
  65. #include <linux/delay.h> /* for udelay() */
  66. #include <linux/spinlock.h>
  67. #include <linux/ethtool.h>
  68. #include <asm/uaccess.h>
  69. #include <asm/bitops.h>
  70. #include <asm/io.h>
  71. #include <asm/irq.h>
  72. static char versionA[] __initdata = DRV_NAME ".c:" DRV_VERSION " " DRV_RELDATE "becker@scyld.comn";
  73. static char versionB[] __initdata = "http://www.scyld.com/network/3c509.htmln";
  74. #ifdef EL3_DEBUG
  75. static int el3_debug = EL3_DEBUG;
  76. #else
  77. static int el3_debug = 2;
  78. #endif
  79. /* To minimize the size of the driver source I only define operating
  80.    constants if they are used several times.  You'll need the manual
  81.    anyway if you want to understand driver details. */
  82. /* Offsets from base I/O address. */
  83. #define EL3_DATA 0x00
  84. #define EL3_CMD 0x0e
  85. #define EL3_STATUS 0x0e
  86. #define  EEPROM_READ 0x80
  87. #define EL3_IO_EXTENT 16
  88. #define EL3WINDOW(win_num) outw(SelectWindow + (win_num), ioaddr + EL3_CMD)
  89. /* The top five bits written to EL3_CMD are a command, the lower
  90.    11 bits are the parameter, if applicable. */
  91. enum c509cmd {
  92. TotalReset = 0<<11, SelectWindow = 1<<11, StartCoax = 2<<11,
  93. RxDisable = 3<<11, RxEnable = 4<<11, RxReset = 5<<11, RxDiscard = 8<<11,
  94. TxEnable = 9<<11, TxDisable = 10<<11, TxReset = 11<<11,
  95. FakeIntr = 12<<11, AckIntr = 13<<11, SetIntrEnb = 14<<11,
  96. SetStatusEnb = 15<<11, SetRxFilter = 16<<11, SetRxThreshold = 17<<11,
  97. SetTxThreshold = 18<<11, SetTxStart = 19<<11, StatsEnable = 21<<11,
  98. StatsDisable = 22<<11, StopCoax = 23<<11,};
  99. enum c509status {
  100. IntLatch = 0x0001, AdapterFailure = 0x0002, TxComplete = 0x0004,
  101. TxAvailable = 0x0008, RxComplete = 0x0010, RxEarly = 0x0020,
  102. IntReq = 0x0040, StatsFull = 0x0080, CmdBusy = 0x1000, };
  103. /* The SetRxFilter command accepts the following classes: */
  104. enum RxFilter {
  105. RxStation = 1, RxMulticast = 2, RxBroadcast = 4, RxProm = 8 };
  106. /* Register window 1 offsets, the window used in normal operation. */
  107. #define TX_FIFO 0x00
  108. #define RX_FIFO 0x00
  109. #define RX_STATUS  0x08
  110. #define TX_STATUS  0x0B
  111. #define TX_FREE 0x0C /* Remaining free bytes in Tx buffer. */
  112. #define WN0_IRQ 0x08 /* Window 0: Set IRQ line in bits 12-15. */
  113. #define WN4_MEDIA 0x0A /* Window 4: Various transcvr/media bits. */
  114. #define  MEDIA_TP 0x00C0 /* Enable link beat and jabber for 10baseT. */
  115. /*
  116.  * Must be a power of two (we use a binary and in the
  117.  * circular queue)
  118.  */
  119. #define SKB_QUEUE_SIZE 64
  120. struct el3_private {
  121. struct net_device_stats stats;
  122. struct net_device *next_dev;
  123. spinlock_t lock;
  124. /* skb send-queue */
  125. int head, size;
  126. struct sk_buff *queue[SKB_QUEUE_SIZE];
  127. char mca_slot;
  128. };
  129. static int id_port __initdata = 0x110; /* Start with 0x110 to avoid new sound cards.*/
  130. static struct net_device *el3_root_dev;
  131. static ushort id_read_eeprom(int index);
  132. static ushort read_eeprom(int ioaddr, int index);
  133. static int el3_open(struct net_device *dev);
  134. static int el3_start_xmit(struct sk_buff *skb, struct net_device *dev);
  135. static void el3_interrupt(int irq, void *dev_id, struct pt_regs *regs);
  136. static void update_stats(struct net_device *dev);
  137. static struct net_device_stats *el3_get_stats(struct net_device *dev);
  138. static int el3_rx(struct net_device *dev);
  139. static int el3_close(struct net_device *dev);
  140. static void set_multicast_list(struct net_device *dev);
  141. static void el3_tx_timeout (struct net_device *dev);
  142. static int netdev_ioctl (struct net_device *dev, struct ifreq *rq, int cmd);
  143. #ifdef CONFIG_MCA
  144. struct el3_mca_adapters_struct {
  145. char* name;
  146. int id;
  147. };
  148. static struct el3_mca_adapters_struct el3_mca_adapters[] __initdata = {
  149. { "3Com 3c529 EtherLink III (10base2)", 0x627c },
  150. { "3Com 3c529 EtherLink III (10baseT)", 0x627d },
  151. { "3Com 3c529 EtherLink III (test mode)", 0x62db },
  152. { "3Com 3c529 EtherLink III (TP or coax)", 0x62f6 },
  153. { "3Com 3c529 EtherLink III (TP)", 0x62f7 },
  154. { NULL, 0 },
  155. };
  156. #endif /* CONFIG_MCA */
  157. #if defined(CONFIG_ISAPNP) || defined(CONFIG_ISAPNP_MODULE)
  158. static struct isapnp_device_id el3_isapnp_adapters[] __initdata = {
  159. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  160. ISAPNP_VENDOR('T', 'C', 'M'), ISAPNP_FUNCTION(0x5090),
  161. (long) "3Com Etherlink III (TP)" },
  162. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  163. ISAPNP_VENDOR('T', 'C', 'M'), ISAPNP_FUNCTION(0x5091),
  164. (long) "3Com Etherlink III" },
  165. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  166. ISAPNP_VENDOR('T', 'C', 'M'), ISAPNP_FUNCTION(0x5094),
  167. (long) "3Com Etherlink III (combo)" },
  168. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  169. ISAPNP_VENDOR('T', 'C', 'M'), ISAPNP_FUNCTION(0x5095),
  170. (long) "3Com Etherlink III (TPO)" },
  171. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  172. ISAPNP_VENDOR('T', 'C', 'M'), ISAPNP_FUNCTION(0x5098),
  173. (long) "3Com Etherlink III (TPC)" },
  174. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  175. ISAPNP_VENDOR('P', 'N', 'P'), ISAPNP_FUNCTION(0x80f7),
  176. (long) "3Com Etherlink III compatible" },
  177. { ISAPNP_ANY_ID, ISAPNP_ANY_ID,
  178. ISAPNP_VENDOR('P', 'N', 'P'), ISAPNP_FUNCTION(0x80f8),
  179. (long) "3Com Etherlink III compatible" },
  180. { } /* terminate list */
  181. };
  182. MODULE_DEVICE_TABLE(isapnp, el3_isapnp_adapters);
  183. MODULE_LICENSE("GPL");
  184. static u16 el3_isapnp_phys_addr[8][3];
  185. #endif /* CONFIG_ISAPNP || CONFIG_ISAPNP_MODULE */
  186. static int nopnp;
  187. int __init el3_probe(struct net_device *dev)
  188. {
  189. struct el3_private *lp;
  190. short lrs_state = 0xff, i;
  191. int ioaddr, irq, if_port;
  192. u16 phys_addr[3];
  193. static int current_tag;
  194. int mca_slot = -1;
  195. #if defined(CONFIG_ISAPNP) || defined(CONFIG_ISAPNP_MODULE)
  196. static int pnp_cards;
  197. #endif /* CONFIG_ISAPNP || CONFIG_ISAPNP_MODULE */
  198. if (dev) SET_MODULE_OWNER(dev);
  199. /* First check all slots of the EISA bus.  The next slot address to
  200.    probe is kept in 'eisa_addr' to support multiple probe() calls. */
  201. if (EISA_bus) {
  202. static int eisa_addr = 0x1000;
  203. while (eisa_addr < 0x9000) {
  204. int device_id;
  205. ioaddr = eisa_addr;
  206. eisa_addr += 0x1000;
  207. /* Check the standard EISA ID register for an encoded '3Com'. */
  208. if (inw(ioaddr + 0xC80) != 0x6d50)
  209. continue;
  210. /* Avoid conflict with 3c590, 3c592, 3c597, etc */
  211. device_id = (inb(ioaddr + 0xC82)<<8) + inb(ioaddr + 0xC83);
  212. if ((device_id & 0xFF00) == 0x5900) {
  213. continue;
  214. }
  215. /* Change the register set to the configuration window 0. */
  216. outw(SelectWindow | 0, ioaddr + 0xC80 + EL3_CMD);
  217. irq = inw(ioaddr + WN0_IRQ) >> 12;
  218. if_port = inw(ioaddr + 6)>>14;
  219. for (i = 0; i < 3; i++)
  220. phys_addr[i] = htons(read_eeprom(ioaddr, i));
  221. /* Restore the "Product ID" to the EEPROM read register. */
  222. read_eeprom(ioaddr, 3);
  223. /* Was the EISA code an add-on hack?  Nahhhhh... */
  224. goto found;
  225. }
  226. }
  227. #ifdef CONFIG_MCA
  228. /* Based on Erik Nygren's (nygren@mit.edu) 3c529 patch, heavily
  229.  * modified by Chris Beauregard (cpbeaure@csclub.uwaterloo.ca)
  230.  * to support standard MCA probing.
  231.  *
  232.  * redone for multi-card detection by ZP Gu (zpg@castle.net)
  233.  * now works as a module
  234.  */
  235. if( MCA_bus ) {
  236. int slot, j;
  237. u_char pos4, pos5;
  238. for( j = 0; el3_mca_adapters[j].name != NULL; j ++ ) {
  239. slot = 0;
  240. while( slot != MCA_NOTFOUND ) {
  241. slot = mca_find_unused_adapter(
  242. el3_mca_adapters[j].id, slot );
  243. if( slot == MCA_NOTFOUND ) break;
  244. /* if we get this far, an adapter has been
  245.  * detected and is enabled
  246.  */
  247. pos4 = mca_read_stored_pos( slot, 4 );
  248. pos5 = mca_read_stored_pos( slot, 5 );
  249. ioaddr = ((short)((pos4&0xfc)|0x02)) << 8;
  250. irq = pos5 & 0x0f;
  251. /* probing for a card at a particular IO/IRQ */
  252. if(dev && ((dev->irq >= 1 && dev->irq != irq) ||
  253.     (dev->base_addr >= 1 && dev->base_addr != ioaddr))) {
  254. slot++;         /* probing next slot */
  255. continue;
  256. }
  257. printk("3c509: found %s at slot %dn",
  258. el3_mca_adapters[j].name, slot + 1 );
  259. /* claim the slot */
  260. mca_set_adapter_name(slot, el3_mca_adapters[j].name);
  261. mca_set_adapter_procfn(slot, NULL, NULL);
  262. mca_mark_as_used(slot);
  263. if_port = pos4 & 0x03;
  264. if (el3_debug > 2) {
  265. printk("3c529: irq %d  ioaddr 0x%x  ifport %dn", irq, ioaddr, if_port);
  266. }
  267. EL3WINDOW(0);
  268. for (i = 0; i < 3; i++) {
  269. phys_addr[i] = htons(read_eeprom(ioaddr, i));
  270. }
  271. mca_slot = slot;
  272. goto found;
  273. }
  274. }
  275. /* if we get here, we didn't find an MCA adapter */
  276. return -ENODEV;
  277. }
  278. #endif /* CONFIG_MCA */
  279. #if defined(CONFIG_ISAPNP) || defined(CONFIG_ISAPNP_MODULE)
  280. if (nopnp == 1)
  281. goto no_pnp;
  282. for (i=0; el3_isapnp_adapters[i].vendor != 0; i++) {
  283. struct pci_dev *idev = NULL;
  284. int j;
  285. while ((idev = isapnp_find_dev(NULL,
  286. el3_isapnp_adapters[i].vendor,
  287. el3_isapnp_adapters[i].function,
  288. idev))) {
  289. idev->prepare(idev);
  290. /* Deactivation is needed if the driver was called
  291.    with "nopnp=1" before, does not harm if not. */
  292. idev->deactivate(idev);
  293. idev->activate(idev);
  294. if (!idev->resource[0].start || check_region(idev->resource[0].start, EL3_IO_EXTENT))
  295. continue;
  296. ioaddr = idev->resource[0].start;
  297. if (!request_region(ioaddr, EL3_IO_EXTENT, "3c509 PnP"))
  298. return -EBUSY;
  299. irq = idev->irq_resource[0].start;
  300. if (el3_debug > 3)
  301. printk ("ISAPnP reports %s at i/o 0x%x, irq %dn",
  302. (char*) el3_isapnp_adapters[i].driver_data, ioaddr, irq);
  303. EL3WINDOW(0);
  304. for (j = 0; j < 3; j++)
  305. el3_isapnp_phys_addr[pnp_cards][j] =
  306. phys_addr[j] =
  307. htons(read_eeprom(ioaddr, j));
  308. if_port = read_eeprom(ioaddr, 8) >> 14;
  309. pnp_cards++;
  310. goto found;
  311. }
  312. }
  313. no_pnp:
  314. #endif /* CONFIG_ISAPNP || CONFIG_ISAPNP_MODULE */
  315. /* Select an open I/O location at 0x1*0 to do contention select. */
  316. for ( ; id_port < 0x200; id_port += 0x10) {
  317. if (check_region(id_port, 1))
  318. continue;
  319. outb(0x00, id_port);
  320. outb(0xff, id_port);
  321. if (inb(id_port) & 0x01)
  322. break;
  323. }
  324. if (id_port >= 0x200) {
  325. /* Rare -- do we really need a warning? */
  326. printk(" WARNING: No I/O port available for 3c509 activation.n");
  327. return -ENODEV;
  328. }
  329. /* Next check for all ISA bus boards by sending the ID sequence to the
  330.    ID_PORT.  We find cards past the first by setting the 'current_tag'
  331.    on cards as they are found.  Cards with their tag set will not
  332.    respond to subsequent ID sequences. */
  333. outb(0x00, id_port);
  334. outb(0x00, id_port);
  335. for(i = 0; i < 255; i++) {
  336. outb(lrs_state, id_port);
  337. lrs_state <<= 1;
  338. lrs_state = lrs_state & 0x100 ? lrs_state ^ 0xcf : lrs_state;
  339. }
  340. /* For the first probe, clear all board's tag registers. */
  341. if (current_tag == 0)
  342. outb(0xd0, id_port);
  343. else /* Otherwise kill off already-found boards. */
  344. outb(0xd8, id_port);
  345. if (id_read_eeprom(7) != 0x6d50) {
  346. return -ENODEV;
  347. }
  348. /* Read in EEPROM data, which does contention-select.
  349.    Only the lowest address board will stay "on-line".
  350.    3Com got the byte order backwards. */
  351. for (i = 0; i < 3; i++) {
  352. phys_addr[i] = htons(id_read_eeprom(i));
  353. }
  354. #if defined(CONFIG_ISAPNP) || defined(CONFIG_ISAPNP_MODULE)
  355. if (nopnp == 0) {
  356. /* The ISA PnP 3c509 cards respond to the ID sequence.
  357.    This check is needed in order not to register them twice. */
  358. for (i = 0; i < pnp_cards; i++) {
  359. if (phys_addr[0] == el3_isapnp_phys_addr[i][0] &&
  360.     phys_addr[1] == el3_isapnp_phys_addr[i][1] &&
  361.     phys_addr[2] == el3_isapnp_phys_addr[i][2])
  362. {
  363. if (el3_debug > 3)
  364. printk("3c509 with address %02x %02x %02x %02x %02x %02x was found by ISAPnPn",
  365. phys_addr[0] & 0xff, phys_addr[0] >> 8,
  366. phys_addr[1] & 0xff, phys_addr[1] >> 8,
  367. phys_addr[2] & 0xff, phys_addr[2] >> 8);
  368. /* Set the adaptor tag so that the next card can be found. */
  369. outb(0xd0 + ++current_tag, id_port);
  370. goto no_pnp;
  371. }
  372. }
  373. }
  374. #endif /* CONFIG_ISAPNP || CONFIG_ISAPNP_MODULE */
  375. {
  376. unsigned int iobase = id_read_eeprom(8);
  377. if_port = iobase >> 14;
  378. ioaddr = 0x200 + ((iobase & 0x1f) << 4);
  379. }
  380. irq = id_read_eeprom(9) >> 12;
  381. if (dev) { /* Set passed-in IRQ or I/O Addr. */
  382. if (dev->irq > 1  &&  dev->irq < 16)
  383. irq = dev->irq;
  384. if (dev->base_addr) {
  385. if (dev->mem_end == 0x3c509  /* Magic key */
  386. && dev->base_addr >= 0x200  &&  dev->base_addr <= 0x3e0)
  387. ioaddr = dev->base_addr & 0x3f0;
  388. else if (dev->base_addr != ioaddr)
  389. return -ENODEV;
  390. }
  391. }
  392. if (!request_region(ioaddr, EL3_IO_EXTENT, "3c509"))
  393. return -EBUSY;
  394. /* Set the adaptor tag so that the next card can be found. */
  395. outb(0xd0 + ++current_tag, id_port);
  396. /* Activate the adaptor at the EEPROM location. */
  397. outb((ioaddr >> 4) | 0xe0, id_port);
  398. EL3WINDOW(0);
  399. if (inw(ioaddr) != 0x6d50) {
  400. release_region(ioaddr, EL3_IO_EXTENT);
  401. return -ENODEV;
  402. }
  403. /* Free the interrupt so that some other card can use it. */
  404. outw(0x0f00, ioaddr + WN0_IRQ);
  405.  found:
  406. if (dev == NULL) {
  407. dev = init_etherdev(dev, sizeof(struct el3_private));
  408. if (dev == NULL) {
  409. release_region(ioaddr, EL3_IO_EXTENT);
  410. return -ENOMEM;
  411. }
  412. SET_MODULE_OWNER(dev);
  413. }
  414. memcpy(dev->dev_addr, phys_addr, sizeof(phys_addr));
  415. dev->base_addr = ioaddr;
  416. dev->irq = irq;
  417. dev->if_port = (dev->mem_start & 0x1f) ? dev->mem_start & 3 : if_port;
  418. {
  419. const char *if_names[] = {"10baseT", "AUI", "undefined", "BNC"};
  420. printk("%s: 3c5x9 at %#3.3lx, %s port, address ",
  421.    dev->name, dev->base_addr, if_names[dev->if_port]);
  422. }
  423. /* Read in the station address. */
  424. for (i = 0; i < 6; i++)
  425. printk(" %2.2x", dev->dev_addr[i]);
  426. printk(", IRQ %d.n", dev->irq);
  427. /* Make up a EL3-specific-data structure. */
  428. if (dev->priv == NULL)
  429. dev->priv = kmalloc(sizeof(struct el3_private), GFP_KERNEL);
  430. if (dev->priv == NULL)
  431. return -ENOMEM;
  432. memset(dev->priv, 0, sizeof(struct el3_private));
  433. lp = dev->priv;
  434. lp->mca_slot = mca_slot;
  435. lp->next_dev = el3_root_dev;
  436. spin_lock_init(&lp->lock);
  437. el3_root_dev = dev;
  438. if (el3_debug > 0)
  439. printk(KERN_INFO "%s" KERN_INFO "%s", versionA, versionB);
  440. /* The EL3-specific entries in the device structure. */
  441. dev->open = &el3_open;
  442. dev->hard_start_xmit = &el3_start_xmit;
  443. dev->stop = &el3_close;
  444. dev->get_stats = &el3_get_stats;
  445. dev->set_multicast_list = &set_multicast_list;
  446. dev->tx_timeout = el3_tx_timeout;
  447. dev->watchdog_timeo = TX_TIMEOUT;
  448. dev->do_ioctl = netdev_ioctl;
  449. /* Fill in the generic fields of the device structure. */
  450. ether_setup(dev);
  451. return 0;
  452. }
  453. /* Read a word from the EEPROM using the regular EEPROM access register.
  454.    Assume that we are in register window zero.
  455.  */
  456. static ushort __init read_eeprom(int ioaddr, int index)
  457. {
  458. outw(EEPROM_READ + index, ioaddr + 10);
  459. /* Pause for at least 162 us. for the read to take place. */
  460. udelay (500);
  461. return inw(ioaddr + 12);
  462. }
  463. /* Read a word from the EEPROM when in the ISA ID probe state. */
  464. static ushort __init id_read_eeprom(int index)
  465. {
  466. int bit, word = 0;
  467. /* Issue read command, and pause for at least 162 us. for it to complete.
  468.    Assume extra-fast 16Mhz bus. */
  469. outb(EEPROM_READ + index, id_port);
  470. /* Pause for at least 162 us. for the read to take place. */
  471. udelay (500);
  472. for (bit = 15; bit >= 0; bit--)
  473. word = (word << 1) + (inb(id_port) & 0x01);
  474. if (el3_debug > 3)
  475. printk("  3c509 EEPROM word %d %#4.4x.n", index, word);
  476. return word;
  477. }
  478. static int
  479. el3_open(struct net_device *dev)
  480. {
  481. int ioaddr = dev->base_addr;
  482. int i;
  483. outw(TxReset, ioaddr + EL3_CMD);
  484. outw(RxReset, ioaddr + EL3_CMD);
  485. outw(SetStatusEnb | 0x00, ioaddr + EL3_CMD);
  486. i = request_irq(dev->irq, &el3_interrupt, 0, dev->name, dev);
  487. if (i) return i;
  488. EL3WINDOW(0);
  489. if (el3_debug > 3)
  490. printk("%s: Opening, IRQ %d  status@%x %4.4x.n", dev->name,
  491.    dev->irq, ioaddr + EL3_STATUS, inw(ioaddr + EL3_STATUS));
  492. /* Activate board: this is probably unnecessary. */
  493. outw(0x0001, ioaddr + 4);
  494. /* Set the IRQ line. */
  495. outw((dev->irq << 12) | 0x0f00, ioaddr + WN0_IRQ);
  496. /* Set the station address in window 2 each time opened. */
  497. EL3WINDOW(2);
  498. for (i = 0; i < 6; i++)
  499. outb(dev->dev_addr[i], ioaddr + i);
  500. if (dev->if_port == 3)
  501. /* Start the thinnet transceiver. We should really wait 50ms...*/
  502. outw(StartCoax, ioaddr + EL3_CMD);
  503. else if (dev->if_port == 0) {
  504. /* 10baseT interface, enabled link beat and jabber check. */
  505. EL3WINDOW(4);
  506. outw(inw(ioaddr + WN4_MEDIA) | MEDIA_TP, ioaddr + WN4_MEDIA);
  507. }
  508. /* Switch to the stats window, and clear all stats by reading. */
  509. outw(StatsDisable, ioaddr + EL3_CMD);
  510. EL3WINDOW(6);
  511. for (i = 0; i < 9; i++)
  512. inb(ioaddr + i);
  513. inw(ioaddr + 10);
  514. inw(ioaddr + 12);
  515. /* Switch to register set 1 for normal use. */
  516. EL3WINDOW(1);
  517. /* Accept b-case and phys addr only. */
  518. outw(SetRxFilter | RxStation | RxBroadcast, ioaddr + EL3_CMD);
  519. outw(StatsEnable, ioaddr + EL3_CMD); /* Turn on statistics. */
  520. netif_start_queue(dev);
  521. outw(RxEnable, ioaddr + EL3_CMD); /* Enable the receiver. */
  522. outw(TxEnable, ioaddr + EL3_CMD); /* Enable transmitter. */
  523. /* Allow status bits to be seen. */
  524. outw(SetStatusEnb | 0xff, ioaddr + EL3_CMD);
  525. /* Ack all pending events, and set active indicator mask. */
  526. outw(AckIntr | IntLatch | TxAvailable | RxEarly | IntReq,
  527.  ioaddr + EL3_CMD);
  528. outw(SetIntrEnb | IntLatch|TxAvailable|TxComplete|RxComplete|StatsFull,
  529.  ioaddr + EL3_CMD);
  530. if (el3_debug > 3)
  531. printk("%s: Opened 3c509  IRQ %d  status %4.4x.n",
  532.    dev->name, dev->irq, inw(ioaddr + EL3_STATUS));
  533. return 0;
  534. }
  535. static void
  536. el3_tx_timeout (struct net_device *dev)
  537. {
  538. struct el3_private *lp = (struct el3_private *)dev->priv;
  539. int ioaddr = dev->base_addr;
  540. /* Transmitter timeout, serious problems. */
  541. printk("%s: transmit timed out, Tx_status %2.2x status %4.4x "
  542.    "Tx FIFO room %d.n",
  543.    dev->name, inb(ioaddr + TX_STATUS), inw(ioaddr + EL3_STATUS),
  544.    inw(ioaddr + TX_FREE));
  545. lp->stats.tx_errors++;
  546. dev->trans_start = jiffies;
  547. /* Issue TX_RESET and TX_START commands. */
  548. outw(TxReset, ioaddr + EL3_CMD);
  549. outw(TxEnable, ioaddr + EL3_CMD);
  550. netif_wake_queue(dev);
  551. }
  552. static int
  553. el3_start_xmit(struct sk_buff *skb, struct net_device *dev)
  554. {
  555. struct el3_private *lp = (struct el3_private *)dev->priv;
  556. int ioaddr = dev->base_addr;
  557. unsigned long flags;
  558. netif_stop_queue (dev);
  559. lp->stats.tx_bytes += skb->len;
  560. if (el3_debug > 4) {
  561. printk("%s: el3_start_xmit(length = %u) called, status %4.4x.n",
  562.    dev->name, skb->len, inw(ioaddr + EL3_STATUS));
  563. }
  564. #if 0
  565. #ifndef final_version
  566. { /* Error-checking code, delete someday. */
  567. ushort status = inw(ioaddr + EL3_STATUS);
  568. if (status & 0x0001  /* IRQ line active, missed one. */
  569. && inw(ioaddr + EL3_STATUS) & 1) {  /* Make sure. */
  570. printk("%s: Missed interrupt, status then %04x now %04x"
  571.    "  Tx %2.2x Rx %4.4x.n", dev->name, status,
  572.    inw(ioaddr + EL3_STATUS), inb(ioaddr + TX_STATUS),
  573.    inw(ioaddr + RX_STATUS));
  574. /* Fake interrupt trigger by masking, acknowledge interrupts. */
  575. outw(SetStatusEnb | 0x00, ioaddr + EL3_CMD);
  576. outw(AckIntr | IntLatch | TxAvailable | RxEarly | IntReq,
  577.  ioaddr + EL3_CMD);
  578. outw(SetStatusEnb | 0xff, ioaddr + EL3_CMD);
  579. }
  580. }
  581. #endif
  582. #endif
  583. /*
  584.  * We lock the driver against other processors. Note
  585.  * we don't need to lock versus the IRQ as we suspended
  586.  * that. This means that we lose the ability to take
  587.  * an RX during a TX upload. That sucks a bit with SMP
  588.  * on an original 3c509 (2K buffer)
  589.  *
  590.  * Using disable_irq stops us crapping on other
  591.  * time sensitive devices.
  592.  */
  593.      spin_lock_irqsave(&lp->lock, flags);
  594.     
  595. /* Put out the doubleword header... */
  596. outw(skb->len, ioaddr + TX_FIFO);
  597. outw(0x00, ioaddr + TX_FIFO);
  598. /* ... and the packet rounded to a doubleword. */
  599. #ifdef  __powerpc__
  600. outsl_unswapped(ioaddr + TX_FIFO, skb->data, (skb->len + 3) >> 2);
  601. #else
  602. outsl(ioaddr + TX_FIFO, skb->data, (skb->len + 3) >> 2);
  603. #endif
  604. dev->trans_start = jiffies;
  605. if (inw(ioaddr + TX_FREE) > 1536)
  606. netif_start_queue(dev);
  607. else
  608. /* Interrupt us when the FIFO has room for max-sized packet. */
  609. outw(SetTxThreshold + 1536, ioaddr + EL3_CMD);
  610. spin_unlock_irqrestore(&lp->lock, flags);
  611. dev_kfree_skb (skb);
  612. /* Clear the Tx status stack. */
  613. {
  614. short tx_status;
  615. int i = 4;
  616. while (--i > 0 && (tx_status = inb(ioaddr + TX_STATUS)) > 0) {
  617. if (tx_status & 0x38) lp->stats.tx_aborted_errors++;
  618. if (tx_status & 0x30) outw(TxReset, ioaddr + EL3_CMD);
  619. if (tx_status & 0x3C) outw(TxEnable, ioaddr + EL3_CMD);
  620. outb(0x00, ioaddr + TX_STATUS); /* Pop the status stack. */
  621. }
  622. }
  623. return 0;
  624. }
  625. /* The EL3 interrupt handler. */
  626. static void
  627. el3_interrupt(int irq, void *dev_id, struct pt_regs *regs)
  628. {
  629. struct net_device *dev = (struct net_device *)dev_id;
  630. struct el3_private *lp;
  631. int ioaddr, status;
  632. int i = max_interrupt_work;
  633. if (dev == NULL) {
  634. printk ("el3_interrupt(): irq %d for unknown device.n", irq);
  635. return;
  636. }
  637. lp = (struct el3_private *)dev->priv;
  638. spin_lock(&lp->lock);
  639. ioaddr = dev->base_addr;
  640. if (el3_debug > 4) {
  641. status = inw(ioaddr + EL3_STATUS);
  642. printk("%s: interrupt, status %4.4x.n", dev->name, status);
  643. }
  644. while ((status = inw(ioaddr + EL3_STATUS)) &
  645.    (IntLatch | RxComplete | StatsFull)) {
  646. if (status & RxComplete)
  647. el3_rx(dev);
  648. if (status & TxAvailable) {
  649. if (el3_debug > 5)
  650. printk(" TX room bit was handled.n");
  651. /* There's room in the FIFO for a full-sized packet. */
  652. outw(AckIntr | TxAvailable, ioaddr + EL3_CMD);
  653. netif_wake_queue (dev);
  654. }
  655. if (status & (AdapterFailure | RxEarly | StatsFull | TxComplete)) {
  656. /* Handle all uncommon interrupts. */
  657. if (status & StatsFull) /* Empty statistics. */
  658. update_stats(dev);
  659. if (status & RxEarly) { /* Rx early is unused. */
  660. el3_rx(dev);
  661. outw(AckIntr | RxEarly, ioaddr + EL3_CMD);
  662. }
  663. if (status & TxComplete) { /* Really Tx error. */
  664. struct el3_private *lp = (struct el3_private *)dev->priv;
  665. short tx_status;
  666. int i = 4;
  667. while (--i>0 && (tx_status = inb(ioaddr + TX_STATUS)) > 0) {
  668. if (tx_status & 0x38) lp->stats.tx_aborted_errors++;
  669. if (tx_status & 0x30) outw(TxReset, ioaddr + EL3_CMD);
  670. if (tx_status & 0x3C) outw(TxEnable, ioaddr + EL3_CMD);
  671. outb(0x00, ioaddr + TX_STATUS); /* Pop the status stack. */
  672. }
  673. }
  674. if (status & AdapterFailure) {
  675. /* Adapter failure requires Rx reset and reinit. */
  676. outw(RxReset, ioaddr + EL3_CMD);
  677. /* Set the Rx filter to the current state. */
  678. outw(SetRxFilter | RxStation | RxBroadcast
  679.  | (dev->flags & IFF_ALLMULTI ? RxMulticast : 0)
  680.  | (dev->flags & IFF_PROMISC ? RxProm : 0),
  681.  ioaddr + EL3_CMD);
  682. outw(RxEnable, ioaddr + EL3_CMD); /* Re-enable the receiver. */
  683. outw(AckIntr | AdapterFailure, ioaddr + EL3_CMD);
  684. }
  685. }
  686. if (--i < 0) {
  687. printk("%s: Infinite loop in interrupt, status %4.4x.n",
  688.    dev->name, status);
  689. /* Clear all interrupts. */
  690. outw(AckIntr | 0xFF, ioaddr + EL3_CMD);
  691. break;
  692. }
  693. /* Acknowledge the IRQ. */
  694. outw(AckIntr | IntReq | IntLatch, ioaddr + EL3_CMD); /* Ack IRQ */
  695. }
  696. if (el3_debug > 4) {
  697. printk("%s: exiting interrupt, status %4.4x.n", dev->name,
  698.    inw(ioaddr + EL3_STATUS));
  699. }
  700. spin_unlock(&lp->lock);
  701. return;
  702. }
  703. static struct net_device_stats *
  704. el3_get_stats(struct net_device *dev)
  705. {
  706. struct el3_private *lp = (struct el3_private *)dev->priv;
  707. unsigned long flags;
  708. /*
  709.  * This is fast enough not to bother with disable IRQ
  710.  * stuff.
  711.  */
  712.  
  713. spin_lock_irqsave(&lp->lock, flags);
  714. update_stats(dev);
  715. spin_unlock_irqrestore(&lp->lock, flags);
  716. return &lp->stats;
  717. }
  718. /*  Update statistics.  We change to register window 6, so this should be run
  719. single-threaded if the device is active. This is expected to be a rare
  720. operation, and it's simpler for the rest of the driver to assume that
  721. window 1 is always valid rather than use a special window-state variable.
  722. */
  723. static void update_stats(struct net_device *dev)
  724. {
  725. struct el3_private *lp = (struct el3_private *)dev->priv;
  726. int ioaddr = dev->base_addr;
  727. if (el3_debug > 5)
  728. printk("   Updating the statistics.n");
  729. /* Turn off statistics updates while reading. */
  730. outw(StatsDisable, ioaddr + EL3_CMD);
  731. /* Switch to the stats window, and read everything. */
  732. EL3WINDOW(6);
  733. lp->stats.tx_carrier_errors  += inb(ioaddr + 0);
  734. lp->stats.tx_heartbeat_errors += inb(ioaddr + 1);
  735. /* Multiple collisions. */    inb(ioaddr + 2);
  736. lp->stats.collisions += inb(ioaddr + 3);
  737. lp->stats.tx_window_errors += inb(ioaddr + 4);
  738. lp->stats.rx_fifo_errors += inb(ioaddr + 5);
  739. lp->stats.tx_packets += inb(ioaddr + 6);
  740. /* Rx packets */    inb(ioaddr + 7);
  741. /* Tx deferrals */    inb(ioaddr + 8);
  742. inw(ioaddr + 10); /* Total Rx and Tx octets. */
  743. inw(ioaddr + 12);
  744. /* Back to window 1, and turn statistics back on. */
  745. EL3WINDOW(1);
  746. outw(StatsEnable, ioaddr + EL3_CMD);
  747. return;
  748. }
  749. static int
  750. el3_rx(struct net_device *dev)
  751. {
  752. struct el3_private *lp = (struct el3_private *)dev->priv;
  753. int ioaddr = dev->base_addr;
  754. short rx_status;
  755. if (el3_debug > 5)
  756. printk("   In rx_packet(), status %4.4x, rx_status %4.4x.n",
  757.    inw(ioaddr+EL3_STATUS), inw(ioaddr+RX_STATUS));
  758. while ((rx_status = inw(ioaddr + RX_STATUS)) > 0) {
  759. if (rx_status & 0x4000) { /* Error, update stats. */
  760. short error = rx_status & 0x3800;
  761. outw(RxDiscard, ioaddr + EL3_CMD);
  762. lp->stats.rx_errors++;
  763. switch (error) {
  764. case 0x0000: lp->stats.rx_over_errors++; break;
  765. case 0x0800: lp->stats.rx_length_errors++; break;
  766. case 0x1000: lp->stats.rx_frame_errors++; break;
  767. case 0x1800: lp->stats.rx_length_errors++; break;
  768. case 0x2000: lp->stats.rx_frame_errors++; break;
  769. case 0x2800: lp->stats.rx_crc_errors++; break;
  770. }
  771. } else {
  772. short pkt_len = rx_status & 0x7ff;
  773. struct sk_buff *skb;
  774. skb = dev_alloc_skb(pkt_len+5);
  775. lp->stats.rx_bytes += pkt_len;
  776. if (el3_debug > 4)
  777. printk("Receiving packet size %d status %4.4x.n",
  778.    pkt_len, rx_status);
  779. if (skb != NULL) {
  780. skb->dev = dev;
  781. skb_reserve(skb, 2);     /* Align IP on 16 byte */
  782. /* 'skb->data' points to the start of sk_buff data area. */
  783. #ifdef  __powerpc__
  784. insl_unswapped(ioaddr+RX_FIFO, skb_put(skb,pkt_len),
  785.    (pkt_len + 3) >> 2);
  786. #else
  787. insl(ioaddr + RX_FIFO, skb_put(skb,pkt_len),
  788.  (pkt_len + 3) >> 2);
  789. #endif
  790. outw(RxDiscard, ioaddr + EL3_CMD); /* Pop top Rx packet. */
  791. skb->protocol = eth_type_trans(skb,dev);
  792. netif_rx(skb);
  793. dev->last_rx = jiffies;
  794. lp->stats.rx_packets++;
  795. continue;
  796. }
  797. outw(RxDiscard, ioaddr + EL3_CMD);
  798. lp->stats.rx_dropped++;
  799. if (el3_debug)
  800. printk("%s: Couldn't allocate a sk_buff of size %d.n",
  801.    dev->name, pkt_len);
  802. }
  803. inw(ioaddr + EL3_STATUS);  /* Delay. */
  804. while (inw(ioaddr + EL3_STATUS) & 0x1000)
  805. printk(KERN_DEBUG " Waiting for 3c509 to discard packet, status %x.n",
  806.    inw(ioaddr + EL3_STATUS) );
  807. }
  808. return 0;
  809. }
  810. /*
  811.  *     Set or clear the multicast filter for this adaptor.
  812.  */
  813. static void
  814. set_multicast_list(struct net_device *dev)
  815. {
  816. unsigned long flags;
  817. struct el3_private *lp = (struct el3_private *)dev->priv;
  818. int ioaddr = dev->base_addr;
  819. if (el3_debug > 1) {
  820. static int old;
  821. if (old != dev->mc_count) {
  822. old = dev->mc_count;
  823. printk("%s: Setting Rx mode to %d addresses.n", dev->name, dev->mc_count);
  824. }
  825. }
  826. spin_lock_irqsave(&lp->lock, flags);
  827. if (dev->flags&IFF_PROMISC) {
  828. outw(SetRxFilter | RxStation | RxMulticast | RxBroadcast | RxProm,
  829.  ioaddr + EL3_CMD);
  830. }
  831. else if (dev->mc_count || (dev->flags&IFF_ALLMULTI)) {
  832. outw(SetRxFilter | RxStation | RxMulticast | RxBroadcast, ioaddr + EL3_CMD);
  833. }
  834. else
  835.                 outw(SetRxFilter | RxStation | RxBroadcast, ioaddr + EL3_CMD);
  836. spin_unlock_irqrestore(&lp->lock, flags);
  837. }
  838. static int
  839. el3_close(struct net_device *dev)
  840. {
  841. int ioaddr = dev->base_addr;
  842. if (el3_debug > 2)
  843. printk("%s: Shutting down ethercard.n", dev->name);
  844. netif_stop_queue(dev);
  845. /* Turn off statistics ASAP.  We update lp->stats below. */
  846. outw(StatsDisable, ioaddr + EL3_CMD);
  847. /* Disable the receiver and transmitter. */
  848. outw(RxDisable, ioaddr + EL3_CMD);
  849. outw(TxDisable, ioaddr + EL3_CMD);
  850. if (dev->if_port == 3)
  851. /* Turn off thinnet power.  Green! */
  852. outw(StopCoax, ioaddr + EL3_CMD);
  853. else if (dev->if_port == 0) {
  854. /* Disable link beat and jabber, if_port may change ere next open(). */
  855. EL3WINDOW(4);
  856. outw(inw(ioaddr + WN4_MEDIA) & ~MEDIA_TP, ioaddr + WN4_MEDIA);
  857. }
  858. free_irq(dev->irq, dev);
  859. /* Switching back to window 0 disables the IRQ. */
  860. EL3WINDOW(0);
  861. /* But we explicitly zero the IRQ line select anyway. */
  862. outw(0x0f00, ioaddr + WN0_IRQ);
  863. update_stats(dev);
  864. return 0;
  865. }
  866. /**
  867.  * netdev_ethtool_ioctl: Handle network interface SIOCETHTOOL ioctls
  868.  * @dev: network interface on which out-of-band action is to be performed
  869.  * @useraddr: userspace address to which data is to be read and returned
  870.  *
  871.  * Process the various commands of the SIOCETHTOOL interface.
  872.  */
  873. static int netdev_ethtool_ioctl (struct net_device *dev, void *useraddr)
  874. {
  875. u32 ethcmd;
  876. /* dev_ioctl() in ../../net/core/dev.c has already checked
  877.    capable(CAP_NET_ADMIN), so don't bother with that here.  */
  878. if (get_user(ethcmd, (u32 *)useraddr))
  879. return -EFAULT;
  880. switch (ethcmd) {
  881. case ETHTOOL_GDRVINFO: {
  882. struct ethtool_drvinfo info = { ETHTOOL_GDRVINFO };
  883. strcpy (info.driver, DRV_NAME);
  884. strcpy (info.version, DRV_VERSION);
  885. if (copy_to_user (useraddr, &info, sizeof (info)))
  886. return -EFAULT;
  887. return 0;
  888. }
  889. /* get message-level */
  890. case ETHTOOL_GMSGLVL: {
  891. struct ethtool_value edata = {ETHTOOL_GMSGLVL};
  892. edata.data = el3_debug;
  893. if (copy_to_user(useraddr, &edata, sizeof(edata)))
  894. return -EFAULT;
  895. return 0;
  896. }
  897. /* set message-level */
  898. case ETHTOOL_SMSGLVL: {
  899. struct ethtool_value edata;
  900. if (copy_from_user(&edata, useraddr, sizeof(edata)))
  901. return -EFAULT;
  902. el3_debug = edata.data;
  903. return 0;
  904. }
  905. default:
  906. break;
  907. }
  908. return -EOPNOTSUPP;
  909. }
  910. /**
  911.  * netdev_ioctl: Handle network interface ioctls
  912.  * @dev: network interface on which out-of-band action is to be performed
  913.  * @rq: user request data
  914.  * @cmd: command issued by user
  915.  *
  916.  * Process the various out-of-band ioctls passed to this driver.
  917.  */
  918. static int netdev_ioctl (struct net_device *dev, struct ifreq *rq, int cmd)
  919. {
  920. int rc = 0;
  921. switch (cmd) {
  922. case SIOCETHTOOL:
  923. rc = netdev_ethtool_ioctl(dev, (void *) rq->ifr_data);
  924. break;
  925. default:
  926. rc = -EOPNOTSUPP;
  927. break;
  928. }
  929. return rc;
  930. }
  931.  
  932. #ifdef MODULE
  933. /* Parameters that may be passed into the module. */
  934. static int debug = -1;
  935. static int irq[] = {-1, -1, -1, -1, -1, -1, -1, -1};
  936. static int xcvr[] = {-1, -1, -1, -1, -1, -1, -1, -1};
  937. MODULE_PARM(debug,"i");
  938. MODULE_PARM(irq,"1-8i");
  939. MODULE_PARM(xcvr,"1-8i");
  940. MODULE_PARM(max_interrupt_work, "i");
  941. MODULE_PARM_DESC(debug, "EtherLink III debug level (0-6)");
  942. MODULE_PARM_DESC(irq, "EtherLink III IRQ number(s) (assigned)");
  943. MODULE_PARM_DESC(xcvr,"EtherLink III tranceiver(s) (0=internal, 1=external)");
  944. MODULE_PARM_DESC(max_interrupt_work, "EtherLink III maximum events handled per interrupt");
  945. #ifdef CONFIG_ISAPNP
  946. MODULE_PARM(nopnp, "i");
  947. MODULE_PARM_DESC(nopnp, "EtherLink III disable ISA PnP support (0-1)");
  948. #endif /* CONFIG_ISAPNP */
  949. int
  950. init_module(void)
  951. {
  952. int el3_cards = 0;
  953. if (debug >= 0)
  954. el3_debug = debug;
  955. el3_root_dev = NULL;
  956. while (el3_probe(0) == 0) {
  957. if (irq[el3_cards] > 1)
  958. el3_root_dev->irq = irq[el3_cards];
  959. if (xcvr[el3_cards] >= 0)
  960. el3_root_dev->if_port = xcvr[el3_cards];
  961. el3_cards++;
  962. }
  963. return el3_cards ? 0 : -ENODEV;
  964. }
  965. void
  966. cleanup_module(void)
  967. {
  968. struct net_device *next_dev;
  969. /* No need to check MOD_IN_USE, as sys_delete_module() checks. */
  970. while (el3_root_dev) {
  971. struct el3_private *lp = (struct el3_private *)el3_root_dev->priv;
  972. #ifdef CONFIG_MCA
  973. if(lp->mca_slot!=-1)
  974. mca_mark_as_unused(lp->mca_slot);
  975. #endif
  976. next_dev = lp->next_dev;
  977. unregister_netdev(el3_root_dev);
  978. release_region(el3_root_dev->base_addr, EL3_IO_EXTENT);
  979. kfree(el3_root_dev);
  980. el3_root_dev = next_dev;
  981. }
  982. }
  983. #endif /* MODULE */
  984. /*
  985.  * Local variables:
  986.  *  compile-command: "gcc -DMODULE -D__KERNEL__ -Wall -Wstrict-prototypes -O6 -c 3c509.c"
  987.  *  version-control: t
  988.  *  kept-new-versions: 5
  989.  *  tab-width: 4
  990.  * End:
  991.  */