ftp://ftp.kernel.org/pub/linux/kernel/v2.6/linux-2.6.6.tar.bz2
[linux-2.6.git] / drivers / net / tokenring / tms380tr.c
1 /*
2  *  tms380tr.c: A network driver library for Texas Instruments TMS380-based
3  *              Token Ring Adapters.
4  *
5  *  Originally sktr.c: Written 1997 by Christoph Goos
6  *
7  *  A fine result of the Linux Systems Network Architecture Project.
8  *  http://www.linux-sna.org
9  *
10  *  This software may be used and distributed according to the terms
11  *  of the GNU General Public License, incorporated herein by reference.
12  *
13  *  The following modules are currently available for card support:
14  *      - tmspci (Generic PCI card support)
15  *      - abyss (Madge PCI support)
16  *      - tmsisa (SysKonnect TR4/16 ISA)
17  *
18  *  Sources:
19  *      - The hardware related parts of this driver are take from
20  *        the SysKonnect Token Ring driver for Windows NT.
21  *      - I used the IBM Token Ring driver 'ibmtr.c' as a base for this
22  *        driver, as well as the 'skeleton.c' driver by Donald Becker.
23  *      - Also various other drivers in the linux source tree were taken
24  *        as samples for some tasks.
25  *      - TI TMS380 Second-Generation Token Ring User's Guide
26  *      - TI datasheets for respective chips
27  *      - David Hein at Texas Instruments 
28  *      - Various Madge employees
29  *
30  *  Maintainer(s):
31  *    JS        Jay Schulist            jschlst@samba.org
32  *    CG        Christoph Goos          cgoos@syskonnect.de
33  *    AF        Adam Fritzler           mid@auk.cx
34  *    MLP       Mike Phillips           phillim@amtrak.com
35  *    JF        Jochen Friedrich        jochen@scram.de
36  *     
37  *  Modification History:
38  *      29-Aug-97       CG      Created
39  *      04-Apr-98       CG      Fixed problems caused by tok_timer_check
40  *      10-Apr-98       CG      Fixed lockups at cable disconnection
41  *      27-May-98       JS      Formated to Linux Kernel Format
42  *      31-May-98       JS      Hacked in PCI support
43  *      16-Jun-98       JS      Modulized for multiple cards with one driver
44  *         Sep-99       AF      Renamed to tms380tr (supports more than SK's)
45  *      23-Sep-99       AF      Added Compaq and Thomas-Conrad PCI support
46  *                              Fixed a bug causing double copies on PCI
47  *                              Fixed for new multicast stuff (2.2/2.3)
48  *      25-Sep-99       AF      Uped TPL_NUM from 3 to 9
49  *                              Removed extraneous 'No free TPL'
50  *      22-Dec-99       AF      Added Madge PCI Mk2 support and generalized
51  *                              parts of the initilization procedure.
52  *      30-Dec-99       AF      Turned tms380tr into a library ala 8390.
53  *                              Madge support is provided in the abyss module
54  *                              Generic PCI support is in the tmspci module.
55  *      30-Nov-00       JF      Updated PCI code to support IO MMU via
56  *                              pci_map_static(). Alpha uses this MMU for ISA
57  *                              as well.
58  *      14-Jan-01       JF      Fix DMA on ifdown/ifup sequences. Some 
59  *                              cleanup.
60  *      13-Jan-02       JF      Add spinlock to fix race condition.
61  *      09-Nov-02       JF      Fixed printks to not SPAM the console during
62  *                              normal operation.
63  *      30-Dec-02       JF      Removed incorrect __init from 
64  *                              tms380tr_init_card.
65  *                              
66  *  To do:
67  *    1. Multi/Broadcast packet handling (this may have fixed itself)
68  *    2. Write a sktrisa module that includes the old ISA support (done)
69  *    3. Allow modules to load their own microcode
70  *    4. Speed up the BUD process -- freezing the kernel for 3+sec is
71  *         quite unacceptable.
72  *    5. Still a few remaining stalls when the cable is unplugged.
73  */
74
75 #ifdef MODULE
76 static const char version[] = "tms380tr.c: v1.10 30/12/2002 by Christoph Goos, Adam Fritzler\n";
77 #endif
78
79 #include <linux/module.h>
80 #include <linux/kernel.h>
81 #include <linux/types.h>
82 #include <linux/fcntl.h>
83 #include <linux/interrupt.h>
84 #include <linux/ptrace.h>
85 #include <linux/ioport.h>
86 #include <linux/in.h>
87 #include <linux/slab.h>
88 #include <linux/string.h>
89 #include <linux/time.h>
90 #include <linux/errno.h>
91 #include <linux/init.h>
92 #include <linux/pci.h>
93 #include <linux/delay.h>
94 #include <linux/netdevice.h>
95 #include <linux/etherdevice.h>
96 #include <linux/skbuff.h>
97 #include <linux/trdevice.h>
98 #include <linux/firmware.h>
99
100 #include <asm/system.h>
101 #include <asm/bitops.h>
102 #include <asm/io.h>
103 #include <asm/dma.h>
104 #include <asm/irq.h>
105 #include <asm/uaccess.h>
106
107 #include "tms380tr.h"           /* Our Stuff */
108
109 /* Use 0 for production, 1 for verification, 2 for debug, and
110  * 3 for very verbose debug.
111  */
112 #ifndef TMS380TR_DEBUG
113 #define TMS380TR_DEBUG 0
114 #endif
115 static unsigned int tms380tr_debug = TMS380TR_DEBUG;
116
117 static struct device tms_device;
118
119 /* Index to functions, as function prototypes.
120  * Alphabetical by function name.
121  */
122
123 /* "A" */
124 /* "B" */
125 static int      tms380tr_bringup_diags(struct net_device *dev);
126 /* "C" */
127 static void     tms380tr_cancel_tx_queue(struct net_local* tp);
128 static int      tms380tr_chipset_init(struct net_device *dev);
129 static void     tms380tr_chk_irq(struct net_device *dev);
130 static void     tms380tr_chk_outstanding_cmds(struct net_device *dev);
131 static void     tms380tr_chk_src_addr(unsigned char *frame, unsigned char *hw_addr);
132 static unsigned char tms380tr_chk_ssb(struct net_local *tp, unsigned short IrqType);
133 int             tms380tr_close(struct net_device *dev);
134 static void     tms380tr_cmd_status_irq(struct net_device *dev);
135 /* "D" */
136 static void     tms380tr_disable_interrupts(struct net_device *dev);
137 #if TMS380TR_DEBUG > 0
138 static void     tms380tr_dump(unsigned char *Data, int length);
139 #endif
140 /* "E" */
141 static void     tms380tr_enable_interrupts(struct net_device *dev);
142 static void     tms380tr_exec_cmd(struct net_device *dev, unsigned short Command);
143 static void     tms380tr_exec_sifcmd(struct net_device *dev, unsigned int WriteValue);
144 /* "F" */
145 /* "G" */
146 static struct net_device_stats *tms380tr_get_stats(struct net_device *dev);
147 /* "H" */
148 static int      tms380tr_hardware_send_packet(struct sk_buff *skb,
149                         struct net_device *dev);
150 /* "I" */
151 static int      tms380tr_init_adapter(struct net_device *dev);
152 static void     tms380tr_init_ipb(struct net_local *tp);
153 static void     tms380tr_init_net_local(struct net_device *dev);
154 static void     tms380tr_init_opb(struct net_device *dev);
155 /* "M" */
156 /* "O" */
157 int             tms380tr_open(struct net_device *dev);
158 static void     tms380tr_open_adapter(struct net_device *dev);
159 /* "P" */
160 /* "R" */
161 static void     tms380tr_rcv_status_irq(struct net_device *dev);
162 static int      tms380tr_read_ptr(struct net_device *dev);
163 static void     tms380tr_read_ram(struct net_device *dev, unsigned char *Data,
164                         unsigned short Address, int Length);
165 static int      tms380tr_reset_adapter(struct net_device *dev);
166 static void     tms380tr_reset_interrupt(struct net_device *dev);
167 static void     tms380tr_ring_status_irq(struct net_device *dev);
168 /* "S" */
169 static int      tms380tr_send_packet(struct sk_buff *skb, struct net_device *dev);
170 static void     tms380tr_set_multicast_list(struct net_device *dev);
171 static int      tms380tr_set_mac_address(struct net_device *dev, void *addr);
172 /* "T" */
173 static void     tms380tr_timer_chk(unsigned long data);
174 static void     tms380tr_timer_end_wait(unsigned long data);
175 static void     tms380tr_tx_status_irq(struct net_device *dev);
176 /* "U" */
177 static void     tms380tr_update_rcv_stats(struct net_local *tp,
178                         unsigned char DataPtr[], unsigned int Length);
179 /* "W" */
180 void            tms380tr_wait(unsigned long time);
181 static void     tms380tr_write_rpl_status(RPL *rpl, unsigned int Status);
182 static void     tms380tr_write_tpl_status(TPL *tpl, unsigned int Status);
183
184 #define SIFREADB(reg) (((struct net_local *)dev->priv)->sifreadb(dev, reg))
185 #define SIFWRITEB(val, reg) (((struct net_local *)dev->priv)->sifwriteb(dev, val, reg))
186 #define SIFREADW(reg) (((struct net_local *)dev->priv)->sifreadw(dev, reg))
187 #define SIFWRITEW(val, reg) (((struct net_local *)dev->priv)->sifwritew(dev, val, reg))
188
189
190
191 #if 0 /* TMS380TR_DEBUG > 0 */
192 static int madgemc_sifprobe(struct net_device *dev)
193 {
194         unsigned char old, chk1, chk2;
195         
196         old = SIFREADB(SIFADR);  /* Get the old SIFADR value */
197
198         chk1 = 0;       /* Begin with check value 0 */
199         do {
200                 madgemc_setregpage(dev, 0);
201                 /* Write new SIFADR value */
202                 SIFWRITEB(chk1, SIFADR);
203                 chk2 = SIFREADB(SIFADR);
204                 if (chk2 != chk1)
205                         return -1;
206                 
207                 madgemc_setregpage(dev, 1);
208                 /* Read, invert and write */
209                 chk2 = SIFREADB(SIFADD);
210                 if (chk2 != chk1)
211                         return -1;
212
213                 madgemc_setregpage(dev, 0);
214                 chk2 ^= 0x0FE;
215                 SIFWRITEB(chk2, SIFADR);
216
217                 /* Read, invert and compare */
218                 madgemc_setregpage(dev, 1);
219                 chk2 = SIFREADB(SIFADD);
220                 madgemc_setregpage(dev, 0);
221                 chk2 ^= 0x0FE;
222
223                 if(chk1 != chk2)
224                         return (-1);    /* No adapter */
225                 chk1 -= 2;
226         } while(chk1 != 0);     /* Repeat 128 times (all byte values) */
227
228         madgemc_setregpage(dev, 0); /* sanity */
229         /* Restore the SIFADR value */
230         SIFWRITEB(old, SIFADR);
231
232         return (0);
233 }
234 #endif
235
236 /*
237  * Open/initialize the board. This is called sometime after
238  * booting when the 'ifconfig' program is run.
239  *
240  * This routine should set everything up anew at each open, even
241  * registers that "should" only need to be set once at boot, so that
242  * there is non-reboot way to recover if something goes wrong.
243  */
244 int tms380tr_open(struct net_device *dev)
245 {
246         struct net_local *tp = netdev_priv(dev);
247         int err;
248         
249         /* init the spinlock */
250         spin_lock_init(&tp->lock);
251         init_timer(&tp->timer);
252
253         /* Reset the hardware here. Don't forget to set the station address. */
254
255         if(dev->dma > 0) 
256         {
257                 unsigned long flags=claim_dma_lock();
258                 disable_dma(dev->dma);
259                 set_dma_mode(dev->dma, DMA_MODE_CASCADE);
260                 enable_dma(dev->dma);
261                 release_dma_lock(flags);
262         }
263         
264         err = tms380tr_chipset_init(dev);
265         if(err)
266         {
267                 printk(KERN_INFO "%s: Chipset initialization error\n", 
268                         dev->name);
269                 return (-1);
270         }
271
272         tp->timer.expires       = jiffies + 30*HZ;
273         tp->timer.function      = tms380tr_timer_end_wait;
274         tp->timer.data          = (unsigned long)dev;
275         add_timer(&tp->timer);
276
277         printk(KERN_DEBUG "%s: Adapter RAM size: %dK\n", 
278                dev->name, tms380tr_read_ptr(dev));
279
280         tms380tr_enable_interrupts(dev);
281         tms380tr_open_adapter(dev);
282
283         netif_start_queue(dev);
284         
285         /* Wait for interrupt from hardware. If interrupt does not come,
286          * there will be a timeout from the timer.
287          */
288         tp->Sleeping = 1;
289         interruptible_sleep_on(&tp->wait_for_tok_int);
290         del_timer(&tp->timer);
291
292         /* If AdapterVirtOpenFlag is 1, the adapter is now open for use */
293         if(tp->AdapterVirtOpenFlag == 0)
294         {
295                 tms380tr_disable_interrupts(dev);
296                 return (-1);
297         }
298
299         tp->StartTime = jiffies;
300
301         /* Start function control timer */
302         tp->timer.expires       = jiffies + 2*HZ;
303         tp->timer.function      = tms380tr_timer_chk;
304         tp->timer.data          = (unsigned long)dev;
305         add_timer(&tp->timer);
306
307         return (0);
308 }
309
310 /*
311  * Timeout function while waiting for event
312  */
313 static void tms380tr_timer_end_wait(unsigned long data)
314 {
315         struct net_device *dev = (struct net_device*)data;
316         struct net_local *tp = netdev_priv(dev);
317
318         if(tp->Sleeping)
319         {
320                 tp->Sleeping = 0;
321                 wake_up_interruptible(&tp->wait_for_tok_int);
322         }
323
324         return;
325 }
326
327 /*
328  * Initialize the chipset
329  */
330 static int tms380tr_chipset_init(struct net_device *dev)
331 {
332         struct net_local *tp = netdev_priv(dev);
333         int err;
334
335         tms380tr_init_ipb(tp);
336         tms380tr_init_opb(dev);
337         tms380tr_init_net_local(dev);
338
339         if(tms380tr_debug > 3)
340                 printk(KERN_DEBUG "%s: Resetting adapter...\n", dev->name);
341         err = tms380tr_reset_adapter(dev);
342         if(err < 0)
343                 return (-1);
344
345         if(tms380tr_debug > 3)
346                 printk(KERN_DEBUG "%s: Bringup diags...\n", dev->name);
347         err = tms380tr_bringup_diags(dev);
348         if(err < 0)
349                 return (-1);
350
351         if(tms380tr_debug > 3)
352                 printk(KERN_DEBUG "%s: Init adapter...\n", dev->name);
353         err = tms380tr_init_adapter(dev);
354         if(err < 0)
355                 return (-1);
356
357         if(tms380tr_debug > 3)
358                 printk(KERN_DEBUG "%s: Done!\n", dev->name);
359         return (0);
360 }
361
362 /*
363  * Initializes the net_local structure.
364  */
365 static void tms380tr_init_net_local(struct net_device *dev)
366 {
367         struct net_local *tp = netdev_priv(dev);
368         int i;
369         dma_addr_t dmabuf;
370
371         tp->scb.CMD     = 0;
372         tp->scb.Parm[0] = 0;
373         tp->scb.Parm[1] = 0;
374
375         tp->ssb.STS     = 0;
376         tp->ssb.Parm[0] = 0;
377         tp->ssb.Parm[1] = 0;
378         tp->ssb.Parm[2] = 0;
379
380         tp->CMDqueue    = 0;
381
382         tp->AdapterOpenFlag     = 0;
383         tp->AdapterVirtOpenFlag = 0;
384         tp->ScbInUse            = 0;
385         tp->OpenCommandIssued   = 0;
386         tp->ReOpenInProgress    = 0;
387         tp->HaltInProgress      = 0;
388         tp->TransmitHaltScheduled = 0;
389         tp->LobeWireFaultLogged = 0;
390         tp->LastOpenStatus      = 0;
391         tp->MaxPacketSize       = DEFAULT_PACKET_SIZE;
392
393         /* Create circular chain of transmit lists */
394         for (i = 0; i < TPL_NUM; i++)
395         {
396                 tp->Tpl[i].NextTPLAddr = htonl(((char *)(&tp->Tpl[(i+1) % TPL_NUM]) - (char *)tp) + tp->dmabuffer); /* DMA buffer may be MMU driven */
397                 tp->Tpl[i].Status       = 0;
398                 tp->Tpl[i].FrameSize    = 0;
399                 tp->Tpl[i].FragList[0].DataCount        = 0;
400                 tp->Tpl[i].FragList[0].DataAddr         = 0;
401                 tp->Tpl[i].NextTPLPtr   = &tp->Tpl[(i+1) % TPL_NUM];
402                 tp->Tpl[i].MData        = NULL;
403                 tp->Tpl[i].TPLIndex     = i;
404                 tp->Tpl[i].DMABuff      = 0;
405                 tp->Tpl[i].BusyFlag     = 0;
406         }
407
408         tp->TplFree = tp->TplBusy = &tp->Tpl[0];
409
410         /* Create circular chain of receive lists */
411         for (i = 0; i < RPL_NUM; i++)
412         {
413                 tp->Rpl[i].NextRPLAddr = htonl(((char *)(&tp->Rpl[(i+1) % RPL_NUM]) - (char *)tp) + tp->dmabuffer); /* DMA buffer may be MMU driven */
414                 tp->Rpl[i].Status = (RX_VALID | RX_START_FRAME | RX_END_FRAME | RX_FRAME_IRQ);
415                 tp->Rpl[i].FrameSize = 0;
416                 tp->Rpl[i].FragList[0].DataCount = cpu_to_be16((unsigned short)tp->MaxPacketSize);
417
418                 /* Alloc skb and point adapter to data area */
419                 tp->Rpl[i].Skb = dev_alloc_skb(tp->MaxPacketSize);
420                         tp->Rpl[i].DMABuff = 0;
421
422                 /* skb == NULL ? then use local buffer */
423                 if(tp->Rpl[i].Skb == NULL)
424                 {
425                         tp->Rpl[i].SkbStat = SKB_UNAVAILABLE;
426                         tp->Rpl[i].FragList[0].DataAddr = htonl(((char *)tp->LocalRxBuffers[i] - (char *)tp) + tp->dmabuffer);
427                         tp->Rpl[i].MData = tp->LocalRxBuffers[i];
428                 }
429                 else    /* SKB != NULL */
430                 {
431                         tp->Rpl[i].Skb->dev = dev;
432                         skb_put(tp->Rpl[i].Skb, tp->MaxPacketSize);
433
434                         /* data unreachable for DMA ? then use local buffer */
435                         dmabuf = pci_map_single(tp->pdev, tp->Rpl[i].Skb->data, tp->MaxPacketSize, PCI_DMA_FROMDEVICE);
436                         if(tp->dmalimit && (dmabuf + tp->MaxPacketSize > tp->dmalimit))
437                         {
438                                 tp->Rpl[i].SkbStat = SKB_DATA_COPY;
439                                 tp->Rpl[i].FragList[0].DataAddr = htonl(((char *)tp->LocalRxBuffers[i] - (char *)tp) + tp->dmabuffer);
440                                 tp->Rpl[i].MData = tp->LocalRxBuffers[i];
441                         }
442                         else    /* DMA directly in skb->data */
443                         {
444                                 tp->Rpl[i].SkbStat = SKB_DMA_DIRECT;
445                                 tp->Rpl[i].FragList[0].DataAddr = htonl(dmabuf);
446                                 tp->Rpl[i].MData = tp->Rpl[i].Skb->data;
447                                 tp->Rpl[i].DMABuff = dmabuf;
448                         }
449                 }
450
451                 tp->Rpl[i].NextRPLPtr = &tp->Rpl[(i+1) % RPL_NUM];
452                 tp->Rpl[i].RPLIndex = i;
453         }
454
455         tp->RplHead = &tp->Rpl[0];
456         tp->RplTail = &tp->Rpl[RPL_NUM-1];
457         tp->RplTail->Status = (RX_START_FRAME | RX_END_FRAME | RX_FRAME_IRQ);
458
459         return;
460 }
461
462 /*
463  * Initializes the initialisation parameter block.
464  */
465 static void tms380tr_init_ipb(struct net_local *tp)
466 {
467         tp->ipb.Init_Options    = BURST_MODE;
468         tp->ipb.CMD_Status_IV   = 0;
469         tp->ipb.TX_IV           = 0;
470         tp->ipb.RX_IV           = 0;
471         tp->ipb.Ring_Status_IV  = 0;
472         tp->ipb.SCB_Clear_IV    = 0;
473         tp->ipb.Adapter_CHK_IV  = 0;
474         tp->ipb.RX_Burst_Size   = BURST_SIZE;
475         tp->ipb.TX_Burst_Size   = BURST_SIZE;
476         tp->ipb.DMA_Abort_Thrhld = DMA_RETRIES;
477         tp->ipb.SCB_Addr        = 0;
478         tp->ipb.SSB_Addr        = 0;
479
480         return;
481 }
482
483 /*
484  * Initializes the open parameter block.
485  */
486 static void tms380tr_init_opb(struct net_device *dev)
487 {
488         struct net_local *tp;
489         unsigned long Addr;
490         unsigned short RplSize    = RPL_SIZE;
491         unsigned short TplSize    = TPL_SIZE;
492         unsigned short BufferSize = BUFFER_SIZE;
493         int i;
494
495         tp = netdev_priv(dev);
496
497         tp->ocpl.OPENOptions     = 0;
498         tp->ocpl.OPENOptions    |= ENABLE_FULL_DUPLEX_SELECTION;
499         tp->ocpl.FullDuplex      = 0;
500         tp->ocpl.FullDuplex     |= OPEN_FULL_DUPLEX_OFF;
501
502         /* 
503          * Set node address 
504          *
505          * We go ahead and put it in the OPB even though on
506          * most of the generic adapters this isn't required.
507          * Its simpler this way.  -- ASF
508          */
509         for (i=0;i<6;i++)
510                 tp->ocpl.NodeAddr[i] = ((unsigned char *)dev->dev_addr)[i];
511
512         tp->ocpl.GroupAddr       = 0;
513         tp->ocpl.FunctAddr       = 0;
514         tp->ocpl.RxListSize      = cpu_to_be16((unsigned short)RplSize);
515         tp->ocpl.TxListSize      = cpu_to_be16((unsigned short)TplSize);
516         tp->ocpl.BufSize         = cpu_to_be16((unsigned short)BufferSize);
517         tp->ocpl.Reserved        = 0;
518         tp->ocpl.TXBufMin        = TX_BUF_MIN;
519         tp->ocpl.TXBufMax        = TX_BUF_MAX;
520
521         Addr = htonl(((char *)tp->ProductID - (char *)tp) + tp->dmabuffer);
522
523         tp->ocpl.ProdIDAddr[0]   = LOWORD(Addr);
524         tp->ocpl.ProdIDAddr[1]   = HIWORD(Addr);
525
526         return;
527 }
528
529 /*
530  * Send OPEN command to adapter
531  */
532 static void tms380tr_open_adapter(struct net_device *dev)
533 {
534         struct net_local *tp = netdev_priv(dev);
535
536         if(tp->OpenCommandIssued)
537                 return;
538
539         tp->OpenCommandIssued = 1;
540         tms380tr_exec_cmd(dev, OC_OPEN);
541
542         return;
543 }
544
545 /*
546  * Clear the adapter's interrupt flag. Clear system interrupt enable
547  * (SINTEN): disable adapter to system interrupts.
548  */
549 static void tms380tr_disable_interrupts(struct net_device *dev)
550 {
551         SIFWRITEB(0, SIFACL);
552
553         return;
554 }
555
556 /*
557  * Set the adapter's interrupt flag. Set system interrupt enable
558  * (SINTEN): enable adapter to system interrupts.
559  */
560 static void tms380tr_enable_interrupts(struct net_device *dev)
561 {
562         SIFWRITEB(ACL_SINTEN, SIFACL);
563
564         return;
565 }
566
567 /*
568  * Put command in command queue, try to execute it.
569  */
570 static void tms380tr_exec_cmd(struct net_device *dev, unsigned short Command)
571 {
572         struct net_local *tp = netdev_priv(dev);
573
574         tp->CMDqueue |= Command;
575         tms380tr_chk_outstanding_cmds(dev);
576
577         return;
578 }
579
580 static void tms380tr_timeout(struct net_device *dev)
581 {
582         /*
583          * If we get here, some higher level has decided we are broken.
584          * There should really be a "kick me" function call instead.
585          *
586          * Resetting the token ring adapter takes a long time so just
587          * fake transmission time and go on trying. Our own timeout
588          * routine is in tms380tr_timer_chk()
589          */
590         dev->trans_start = jiffies;
591         netif_wake_queue(dev);
592 }
593
594 /*
595  * Gets skb from system, queues it and checks if it can be sent
596  */
597 static int tms380tr_send_packet(struct sk_buff *skb, struct net_device *dev)
598 {
599         struct net_local *tp = netdev_priv(dev);
600         int err;
601
602         err = tms380tr_hardware_send_packet(skb, dev);
603         if(tp->TplFree->NextTPLPtr->BusyFlag)
604                 netif_stop_queue(dev);
605         return (err);
606 }
607
608 /*
609  * Move frames into adapter tx queue
610  */
611 static int tms380tr_hardware_send_packet(struct sk_buff *skb, struct net_device *dev)
612 {
613         TPL *tpl;
614         short length;
615         unsigned char *buf;
616         unsigned long flags;
617         int i;
618         dma_addr_t dmabuf, newbuf;
619         struct net_local *tp = netdev_priv(dev);
620    
621         /* Try to get a free TPL from the chain.
622          *
623          * NOTE: We *must* always leave one unused TPL in the chain,
624          * because otherwise the adapter might send frames twice.
625          */
626         spin_lock_irqsave(&tp->lock, flags);
627         if(tp->TplFree->NextTPLPtr->BusyFlag)  { /* No free TPL */
628                 if (tms380tr_debug > 0)
629                         printk(KERN_DEBUG "%s: No free TPL\n", dev->name);
630                 spin_unlock_irqrestore(&tp->lock, flags);
631                 return 1;
632         }
633
634         dmabuf = 0;
635
636         /* Is buffer reachable for Busmaster-DMA? */
637
638         length  = skb->len;
639         dmabuf = pci_map_single(tp->pdev, skb->data, length, PCI_DMA_TODEVICE);
640         if(tp->dmalimit && (dmabuf + length > tp->dmalimit)) {
641                 /* Copy frame to local buffer */
642                 pci_unmap_single(tp->pdev, dmabuf, length, PCI_DMA_TODEVICE);
643                 dmabuf  = 0;
644                 i       = tp->TplFree->TPLIndex;
645                 buf     = tp->LocalTxBuffers[i];
646                 memcpy(buf, skb->data, length);
647                 newbuf  = ((char *)buf - (char *)tp) + tp->dmabuffer;
648         }
649         else {
650                 /* Send direct from skb->data */
651                 newbuf  = dmabuf;
652                 buf     = skb->data;
653         }
654         /* Source address in packet? */
655         tms380tr_chk_src_addr(buf, dev->dev_addr);
656         tp->LastSendTime        = jiffies;
657         tpl                     = tp->TplFree;  /* Get the "free" TPL */
658         tpl->BusyFlag           = 1;            /* Mark TPL as busy */
659         tp->TplFree             = tpl->NextTPLPtr;
660     
661         /* Save the skb for delayed return of skb to system */
662         tpl->Skb = skb;
663         tpl->DMABuff = dmabuf;
664         tpl->FragList[0].DataCount = cpu_to_be16((unsigned short)length);
665         tpl->FragList[0].DataAddr  = htonl(newbuf);
666
667         /* Write the data length in the transmit list. */
668         tpl->FrameSize  = cpu_to_be16((unsigned short)length);
669         tpl->MData      = buf;
670
671         /* Transmit the frame and set the status values. */
672         tms380tr_write_tpl_status(tpl, TX_VALID | TX_START_FRAME
673                                 | TX_END_FRAME | TX_PASS_SRC_ADDR
674                                 | TX_FRAME_IRQ);
675
676         /* Let adapter send the frame. */
677         tms380tr_exec_sifcmd(dev, CMD_TX_VALID);
678         spin_unlock_irqrestore(&tp->lock, flags);
679
680         return 0;
681 }
682
683 /*
684  * Write the given value to the 'Status' field of the specified TPL.
685  * NOTE: This function should be used whenever the status of any TPL must be
686  * modified by the driver, because the compiler may otherwise change the
687  * order of instructions such that writing the TPL status may be executed at
688  * an undesireable time. When this function is used, the status is always
689  * written when the function is called.
690  */
691 static void tms380tr_write_tpl_status(TPL *tpl, unsigned int Status)
692 {
693         tpl->Status = Status;
694 }
695
696 static void tms380tr_chk_src_addr(unsigned char *frame, unsigned char *hw_addr)
697 {
698         unsigned char SRBit;
699
700         if((((unsigned long)frame[8]) & ~0x80) != 0)    /* Compare 4 bytes */
701                 return;
702         if((unsigned short)frame[12] != 0)              /* Compare 2 bytes */
703                 return;
704
705         SRBit = frame[8] & 0x80;
706         memcpy(&frame[8], hw_addr, 6);
707         frame[8] |= SRBit;
708
709         return;
710 }
711
712 /*
713  * The timer routine: Check if adapter still open and working, reopen if not. 
714  */
715 static void tms380tr_timer_chk(unsigned long data)
716 {
717         struct net_device *dev = (struct net_device*)data;
718         struct net_local *tp = netdev_priv(dev);
719
720         if(tp->HaltInProgress)
721                 return;
722
723         tms380tr_chk_outstanding_cmds(dev);
724         if(time_before(tp->LastSendTime + SEND_TIMEOUT, jiffies)
725                 && (tp->TplFree != tp->TplBusy))
726         {
727                 /* Anything to send, but stalled too long */
728                 tp->LastSendTime = jiffies;
729                 tms380tr_exec_cmd(dev, OC_CLOSE);       /* Does reopen automatically */
730         }
731
732         tp->timer.expires = jiffies + 2*HZ;
733         add_timer(&tp->timer);
734
735         if(tp->AdapterOpenFlag || tp->ReOpenInProgress)
736                 return;
737         tp->ReOpenInProgress = 1;
738         tms380tr_open_adapter(dev);
739
740         return;
741 }
742
743 /*
744  * The typical workload of the driver: Handle the network interface interrupts.
745  */
746 irqreturn_t tms380tr_interrupt(int irq, void *dev_id, struct pt_regs *regs)
747 {
748         struct net_device *dev = dev_id;
749         struct net_local *tp;
750         unsigned short irq_type;
751         int handled = 0;
752
753         if(dev == NULL) {
754                 printk(KERN_INFO "%s: irq %d for unknown device.\n", dev->name, irq);
755                 return IRQ_NONE;
756         }
757
758         tp = netdev_priv(dev);
759
760         irq_type = SIFREADW(SIFSTS);
761
762         while(irq_type & STS_SYSTEM_IRQ) {
763                 handled = 1;
764                 irq_type &= STS_IRQ_MASK;
765
766                 if(!tms380tr_chk_ssb(tp, irq_type)) {
767                         printk(KERN_DEBUG "%s: DATA LATE occurred\n", dev->name);
768                         break;
769                 }
770
771                 switch(irq_type) {
772                 case STS_IRQ_RECEIVE_STATUS:
773                         tms380tr_reset_interrupt(dev);
774                         tms380tr_rcv_status_irq(dev);
775                         break;
776
777                 case STS_IRQ_TRANSMIT_STATUS:
778                         /* Check if TRANSMIT.HALT command is complete */
779                         if(tp->ssb.Parm[0] & COMMAND_COMPLETE) {
780                                 tp->TransmitCommandActive = 0;
781                                         tp->TransmitHaltScheduled = 0;
782
783                                         /* Issue a new transmit command. */
784                                         tms380tr_exec_cmd(dev, OC_TRANSMIT);
785                                 }
786
787                                 tms380tr_reset_interrupt(dev);
788                                 tms380tr_tx_status_irq(dev);
789                                 break;
790
791                 case STS_IRQ_COMMAND_STATUS:
792                         /* The SSB contains status of last command
793                          * other than receive/transmit.
794                          */
795                         tms380tr_cmd_status_irq(dev);
796                         break;
797                         
798                 case STS_IRQ_SCB_CLEAR:
799                         /* The SCB is free for another command. */
800                         tp->ScbInUse = 0;
801                         tms380tr_chk_outstanding_cmds(dev);
802                         break;
803                         
804                 case STS_IRQ_RING_STATUS:
805                         tms380tr_ring_status_irq(dev);
806                         break;
807
808                 case STS_IRQ_ADAPTER_CHECK:
809                         tms380tr_chk_irq(dev);
810                         break;
811
812                 case STS_IRQ_LLC_STATUS:
813                         printk(KERN_DEBUG "tms380tr: unexpected LLC status IRQ\n");
814                         break;
815                         
816                 case STS_IRQ_TIMER:
817                         printk(KERN_DEBUG "tms380tr: unexpected Timer IRQ\n");
818                         break;
819                         
820                 case STS_IRQ_RECEIVE_PENDING:
821                         printk(KERN_DEBUG "tms380tr: unexpected Receive Pending IRQ\n");
822                         break;
823                         
824                 default:
825                         printk(KERN_DEBUG "Unknown Token Ring IRQ (0x%04x)\n", irq_type);
826                         break;
827                 }
828
829                 /* Reset system interrupt if not already done. */
830                 if(irq_type != STS_IRQ_TRANSMIT_STATUS
831                         && irq_type != STS_IRQ_RECEIVE_STATUS) {
832                         tms380tr_reset_interrupt(dev);
833                 }
834
835                 irq_type = SIFREADW(SIFSTS);
836         }
837
838         return IRQ_RETVAL(handled);
839 }
840
841 /*
842  *  Reset the INTERRUPT SYSTEM bit and issue SSB CLEAR command.
843  */
844 static void tms380tr_reset_interrupt(struct net_device *dev)
845 {
846         struct net_local *tp = netdev_priv(dev);
847         SSB *ssb = &tp->ssb;
848
849         /*
850          * [Workaround for "Data Late"]
851          * Set all fields of the SSB to well-defined values so we can
852          * check if the adapter has written the SSB.
853          */
854
855         ssb->STS        = (unsigned short) -1;
856         ssb->Parm[0]    = (unsigned short) -1;
857         ssb->Parm[1]    = (unsigned short) -1;
858         ssb->Parm[2]    = (unsigned short) -1;
859
860         /* Free SSB by issuing SSB_CLEAR command after reading IRQ code
861          * and clear STS_SYSTEM_IRQ bit: enable adapter for further interrupts.
862          */
863         tms380tr_exec_sifcmd(dev, CMD_SSB_CLEAR | CMD_CLEAR_SYSTEM_IRQ);
864
865         return;
866 }
867
868 /*
869  * Check if the SSB has actually been written by the adapter.
870  */
871 static unsigned char tms380tr_chk_ssb(struct net_local *tp, unsigned short IrqType)
872 {
873         SSB *ssb = &tp->ssb;    /* The address of the SSB. */
874
875         /* C 0 1 2 INTERRUPT CODE
876          * - - - - --------------
877          * 1 1 1 1 TRANSMIT STATUS
878          * 1 1 1 1 RECEIVE STATUS
879          * 1 ? ? 0 COMMAND STATUS
880          * 0 0 0 0 SCB CLEAR
881          * 1 1 0 0 RING STATUS
882          * 0 0 0 0 ADAPTER CHECK
883          *
884          * 0 = SSB field not affected by interrupt
885          * 1 = SSB field is affected by interrupt
886          *
887          * C = SSB ADDRESS +0: COMMAND
888          * 0 = SSB ADDRESS +2: STATUS 0
889          * 1 = SSB ADDRESS +4: STATUS 1
890          * 2 = SSB ADDRESS +6: STATUS 2
891          */
892
893         /* Check if this interrupt does use the SSB. */
894
895         if(IrqType != STS_IRQ_TRANSMIT_STATUS
896                 && IrqType != STS_IRQ_RECEIVE_STATUS
897                 && IrqType != STS_IRQ_COMMAND_STATUS
898                 && IrqType != STS_IRQ_RING_STATUS)
899         {
900                 return (1);     /* SSB not involved. */
901         }
902
903         /* Note: All fields of the SSB have been set to all ones (-1) after it
904          * has last been used by the software (see DriverIsr()).
905          *
906          * Check if the affected SSB fields are still unchanged.
907          */
908
909         if(ssb->STS == (unsigned short) -1)
910                 return (0);     /* Command field not yet available. */
911         if(IrqType == STS_IRQ_COMMAND_STATUS)
912                 return (1);     /* Status fields not always affected. */
913         if(ssb->Parm[0] == (unsigned short) -1)
914                 return (0);     /* Status 1 field not yet available. */
915         if(IrqType == STS_IRQ_RING_STATUS)
916                 return (1);     /* Status 2 & 3 fields not affected. */
917
918         /* Note: At this point, the interrupt is either TRANSMIT or RECEIVE. */
919         if(ssb->Parm[1] == (unsigned short) -1)
920                 return (0);     /* Status 2 field not yet available. */
921         if(ssb->Parm[2] == (unsigned short) -1)
922                 return (0);     /* Status 3 field not yet available. */
923
924         return (1);     /* All SSB fields have been written by the adapter. */
925 }
926
927 /*
928  * Evaluates the command results status in the SSB status field.
929  */
930 static void tms380tr_cmd_status_irq(struct net_device *dev)
931 {
932         struct net_local *tp = netdev_priv(dev);
933         unsigned short ssb_cmd, ssb_parm_0;
934         unsigned short ssb_parm_1;
935         char *open_err = "Open error -";
936         char *code_err = "Open code -";
937
938         /* Copy the ssb values to local variables */
939         ssb_cmd    = tp->ssb.STS;
940         ssb_parm_0 = tp->ssb.Parm[0];
941         ssb_parm_1 = tp->ssb.Parm[1];
942
943         if(ssb_cmd == OPEN)
944         {
945                 tp->Sleeping = 0;
946                 if(!tp->ReOpenInProgress)
947                         wake_up_interruptible(&tp->wait_for_tok_int);
948
949                 tp->OpenCommandIssued = 0;
950                 tp->ScbInUse = 0;
951
952                 if((ssb_parm_0 & 0x00FF) == GOOD_COMPLETION)
953                 {
954                         /* Success, the adapter is open. */
955                         tp->LobeWireFaultLogged = 0;
956                         tp->AdapterOpenFlag     = 1;
957                         tp->AdapterVirtOpenFlag = 1;
958                         tp->TransmitCommandActive = 0;
959                         tms380tr_exec_cmd(dev, OC_TRANSMIT);
960                         tms380tr_exec_cmd(dev, OC_RECEIVE);
961
962                         if(tp->ReOpenInProgress)
963                                 tp->ReOpenInProgress = 0;
964
965                         return;
966                 }
967                 else    /* The adapter did not open. */
968                 {
969                         if(ssb_parm_0 & NODE_ADDR_ERROR)
970                                 printk(KERN_INFO "%s: Node address error\n",
971                                         dev->name);
972                         if(ssb_parm_0 & LIST_SIZE_ERROR)
973                                 printk(KERN_INFO "%s: List size error\n",
974                                         dev->name);
975                         if(ssb_parm_0 & BUF_SIZE_ERROR)
976                                 printk(KERN_INFO "%s: Buffer size error\n",
977                                         dev->name);
978                         if(ssb_parm_0 & TX_BUF_COUNT_ERROR)
979                                 printk(KERN_INFO "%s: Tx buffer count error\n",
980                                         dev->name);
981                         if(ssb_parm_0 & INVALID_OPEN_OPTION)
982                                 printk(KERN_INFO "%s: Invalid open option\n",
983                                         dev->name);
984                         if(ssb_parm_0 & OPEN_ERROR)
985                         {
986                                 /* Show the open phase. */
987                                 switch(ssb_parm_0 & OPEN_PHASES_MASK)
988                                 {
989                                         case LOBE_MEDIA_TEST:
990                                                 if(!tp->LobeWireFaultLogged)
991                                                 {
992                                                         tp->LobeWireFaultLogged = 1;
993                                                         printk(KERN_INFO "%s: %s Lobe wire fault (check cable !).\n", dev->name, open_err);
994                                                 }
995                                                 tp->ReOpenInProgress    = 1;
996                                                 tp->AdapterOpenFlag     = 0;
997                                                 tp->AdapterVirtOpenFlag = 1;
998                                                 tms380tr_open_adapter(dev);
999                                                 return;
1000
1001                                         case PHYSICAL_INSERTION:
1002                                                 printk(KERN_INFO "%s: %s Physical insertion.\n", dev->name, open_err);
1003                                                 break;
1004
1005                                         case ADDRESS_VERIFICATION:
1006                                                 printk(KERN_INFO "%s: %s Address verification.\n", dev->name, open_err);
1007                                                 break;
1008
1009                                         case PARTICIPATION_IN_RING_POLL:
1010                                                 printk(KERN_INFO "%s: %s Participation in ring poll.\n", dev->name, open_err);
1011                                                 break;
1012
1013                                         case REQUEST_INITIALISATION:
1014                                                 printk(KERN_INFO "%s: %s Request initialisation.\n", dev->name, open_err);
1015                                                 break;
1016
1017                                         case FULLDUPLEX_CHECK:
1018                                                 printk(KERN_INFO "%s: %s Full duplex check.\n", dev->name, open_err);
1019                                                 break;
1020
1021                                         default:
1022                                                 printk(KERN_INFO "%s: %s Unknown open phase\n", dev->name, open_err);
1023                                                 break;
1024                                 }
1025
1026                                 /* Show the open errors. */
1027                                 switch(ssb_parm_0 & OPEN_ERROR_CODES_MASK)
1028                                 {
1029                                         case OPEN_FUNCTION_FAILURE:
1030                                                 printk(KERN_INFO "%s: %s OPEN_FUNCTION_FAILURE", dev->name, code_err);
1031                                                 tp->LastOpenStatus =
1032                                                         OPEN_FUNCTION_FAILURE;
1033                                                 break;
1034
1035                                         case OPEN_SIGNAL_LOSS:
1036                                                 printk(KERN_INFO "%s: %s OPEN_SIGNAL_LOSS\n", dev->name, code_err);
1037                                                 tp->LastOpenStatus =
1038                                                         OPEN_SIGNAL_LOSS;
1039                                                 break;
1040
1041                                         case OPEN_TIMEOUT:
1042                                                 printk(KERN_INFO "%s: %s OPEN_TIMEOUT\n", dev->name, code_err);
1043                                                 tp->LastOpenStatus =
1044                                                         OPEN_TIMEOUT;
1045                                                 break;
1046
1047                                         case OPEN_RING_FAILURE:
1048                                                 printk(KERN_INFO "%s: %s OPEN_RING_FAILURE\n", dev->name, code_err);
1049                                                 tp->LastOpenStatus =
1050                                                         OPEN_RING_FAILURE;
1051                                                 break;
1052
1053                                         case OPEN_RING_BEACONING:
1054                                                 printk(KERN_INFO "%s: %s OPEN_RING_BEACONING\n", dev->name, code_err);
1055                                                 tp->LastOpenStatus =
1056                                                         OPEN_RING_BEACONING;
1057                                                 break;
1058
1059                                         case OPEN_DUPLICATE_NODEADDR:
1060                                                 printk(KERN_INFO "%s: %s OPEN_DUPLICATE_NODEADDR\n", dev->name, code_err);
1061                                                 tp->LastOpenStatus =
1062                                                         OPEN_DUPLICATE_NODEADDR;
1063                                                 break;
1064
1065                                         case OPEN_REQUEST_INIT:
1066                                                 printk(KERN_INFO "%s: %s OPEN_REQUEST_INIT\n", dev->name, code_err);
1067                                                 tp->LastOpenStatus =
1068                                                         OPEN_REQUEST_INIT;
1069                                                 break;
1070
1071                                         case OPEN_REMOVE_RECEIVED:
1072                                                 printk(KERN_INFO "%s: %s OPEN_REMOVE_RECEIVED", dev->name, code_err);
1073                                                 tp->LastOpenStatus =
1074                                                         OPEN_REMOVE_RECEIVED;
1075                                                 break;
1076
1077                                         case OPEN_FULLDUPLEX_SET:
1078                                                 printk(KERN_INFO "%s: %s OPEN_FULLDUPLEX_SET\n", dev->name, code_err);
1079                                                 tp->LastOpenStatus =
1080                                                         OPEN_FULLDUPLEX_SET;
1081                                                 break;
1082
1083                                         default:
1084                                                 printk(KERN_INFO "%s: %s Unknown open err code", dev->name, code_err);
1085                                                 tp->LastOpenStatus =
1086                                                         OPEN_FUNCTION_FAILURE;
1087                                                 break;
1088                                 }
1089                         }
1090
1091                         tp->AdapterOpenFlag     = 0;
1092                         tp->AdapterVirtOpenFlag = 0;
1093
1094                         return;
1095                 }
1096         }
1097         else
1098         {
1099                 if(ssb_cmd != READ_ERROR_LOG)
1100                         return;
1101
1102                 /* Add values from the error log table to the MAC
1103                  * statistics counters and update the errorlogtable
1104                  * memory.
1105                  */
1106                 tp->MacStat.line_errors += tp->errorlogtable.Line_Error;
1107                 tp->MacStat.burst_errors += tp->errorlogtable.Burst_Error;
1108                 tp->MacStat.A_C_errors += tp->errorlogtable.ARI_FCI_Error;
1109                 tp->MacStat.lost_frames += tp->errorlogtable.Lost_Frame_Error;
1110                 tp->MacStat.recv_congest_count += tp->errorlogtable.Rx_Congest_Error;
1111                 tp->MacStat.rx_errors += tp->errorlogtable.Rx_Congest_Error;
1112                 tp->MacStat.frame_copied_errors += tp->errorlogtable.Frame_Copied_Error;
1113                 tp->MacStat.token_errors += tp->errorlogtable.Token_Error;
1114                 tp->MacStat.dummy1 += tp->errorlogtable.DMA_Bus_Error;
1115                 tp->MacStat.dummy1 += tp->errorlogtable.DMA_Parity_Error;
1116                 tp->MacStat.abort_delimiters += tp->errorlogtable.AbortDelimeters;
1117                 tp->MacStat.frequency_errors += tp->errorlogtable.Frequency_Error;
1118                 tp->MacStat.internal_errors += tp->errorlogtable.Internal_Error;
1119         }
1120
1121         return;
1122 }
1123
1124 /*
1125  * The inverse routine to tms380tr_open().
1126  */
1127 int tms380tr_close(struct net_device *dev)
1128 {
1129         struct net_local *tp = netdev_priv(dev);
1130         netif_stop_queue(dev);
1131         
1132         del_timer(&tp->timer);
1133
1134         /* Flush the Tx and disable Rx here. */
1135
1136         tp->HaltInProgress      = 1;
1137         tms380tr_exec_cmd(dev, OC_CLOSE);
1138         tp->timer.expires       = jiffies + 1*HZ;
1139         tp->timer.function      = tms380tr_timer_end_wait;
1140         tp->timer.data          = (unsigned long)dev;
1141         add_timer(&tp->timer);
1142
1143         tms380tr_enable_interrupts(dev);
1144
1145         tp->Sleeping = 1;
1146         interruptible_sleep_on(&tp->wait_for_tok_int);
1147         tp->TransmitCommandActive = 0;
1148     
1149         del_timer(&tp->timer);
1150         tms380tr_disable_interrupts(dev);
1151    
1152         if(dev->dma > 0) 
1153         {
1154                 unsigned long flags=claim_dma_lock();
1155                 disable_dma(dev->dma);
1156                 release_dma_lock(flags);
1157         }
1158         
1159         SIFWRITEW(0xFF00, SIFCMD);
1160 #if 0
1161         if(dev->dma > 0) /* what the? */
1162                 SIFWRITEB(0xff, POSREG);
1163 #endif
1164         tms380tr_cancel_tx_queue(tp);
1165
1166         return (0);
1167 }
1168
1169 /*
1170  * Get the current statistics. This may be called with the card open
1171  * or closed.
1172  */
1173 static struct net_device_stats *tms380tr_get_stats(struct net_device *dev)
1174 {
1175         struct net_local *tp = netdev_priv(dev);
1176
1177         return ((struct net_device_stats *)&tp->MacStat);
1178 }
1179
1180 /*
1181  * Set or clear the multicast filter for this adapter.
1182  */
1183 static void tms380tr_set_multicast_list(struct net_device *dev)
1184 {
1185         struct net_local *tp = netdev_priv(dev);
1186         unsigned int OpenOptions;
1187         
1188         OpenOptions = tp->ocpl.OPENOptions &
1189                 ~(PASS_ADAPTER_MAC_FRAMES
1190                   | PASS_ATTENTION_FRAMES
1191                   | PASS_BEACON_MAC_FRAMES
1192                   | COPY_ALL_MAC_FRAMES
1193                   | COPY_ALL_NON_MAC_FRAMES);
1194         
1195         tp->ocpl.FunctAddr = 0;
1196         
1197         if(dev->flags & IFF_PROMISC)
1198                 /* Enable promiscuous mode */
1199                 OpenOptions |= COPY_ALL_NON_MAC_FRAMES |
1200                         COPY_ALL_MAC_FRAMES;
1201         else
1202         {
1203                 if(dev->flags & IFF_ALLMULTI)
1204                 {
1205                         /* Disable promiscuous mode, use normal mode. */
1206                         tp->ocpl.FunctAddr = 0xFFFFFFFF;
1207                 }
1208                 else
1209                 {
1210                         int i;
1211                         struct dev_mc_list *mclist = dev->mc_list;
1212                         for (i=0; i< dev->mc_count; i++)
1213                         {
1214                                 ((char *)(&tp->ocpl.FunctAddr))[0] |=
1215                                         mclist->dmi_addr[2];
1216                                 ((char *)(&tp->ocpl.FunctAddr))[1] |=
1217                                         mclist->dmi_addr[3];
1218                                 ((char *)(&tp->ocpl.FunctAddr))[2] |=
1219                                         mclist->dmi_addr[4];
1220                                 ((char *)(&tp->ocpl.FunctAddr))[3] |=
1221                                         mclist->dmi_addr[5];
1222                                 mclist = mclist->next;
1223                         }
1224                 }
1225                 tms380tr_exec_cmd(dev, OC_SET_FUNCT_ADDR);
1226         }
1227         
1228         tp->ocpl.OPENOptions = OpenOptions;
1229         tms380tr_exec_cmd(dev, OC_MODIFY_OPEN_PARMS);
1230         return;
1231 }
1232
1233 /*
1234  * Wait for some time (microseconds)
1235  */
1236 void tms380tr_wait(unsigned long time)
1237 {
1238 #if 0
1239         long tmp;
1240         
1241         tmp = jiffies + time/(1000000/HZ);
1242         do {
1243                 current->state          = TASK_INTERRUPTIBLE;
1244                 tmp = schedule_timeout(tmp);
1245         } while(time_after(tmp, jiffies));
1246 #else
1247         udelay(time);
1248 #endif
1249         return;
1250 }
1251
1252 /*
1253  * Write a command value to the SIFCMD register
1254  */
1255 static void tms380tr_exec_sifcmd(struct net_device *dev, unsigned int WriteValue)
1256 {
1257         unsigned short cmd;
1258         unsigned short SifStsValue;
1259         unsigned long loop_counter;
1260
1261         WriteValue = ((WriteValue ^ CMD_SYSTEM_IRQ) | CMD_INTERRUPT_ADAPTER);
1262         cmd = (unsigned short)WriteValue;
1263         loop_counter = 0,5 * 800000;
1264         do {
1265                 SifStsValue = SIFREADW(SIFSTS);
1266         } while((SifStsValue & CMD_INTERRUPT_ADAPTER) && loop_counter--);
1267         SIFWRITEW(cmd, SIFCMD);
1268
1269         return;
1270 }
1271
1272 /*
1273  * Processes adapter hardware reset, halts adapter and downloads firmware,
1274  * clears the halt bit.
1275  */
1276 static int tms380tr_reset_adapter(struct net_device *dev)
1277 {
1278         struct net_local *tp = netdev_priv(dev);
1279         unsigned short *fw_ptr;
1280         unsigned short count, c, count2;
1281         const struct firmware *fw_entry = NULL;
1282
1283         strncpy(tms_device.bus_id,dev->name, BUS_ID_SIZE);
1284
1285         if (request_firmware(&fw_entry, "tms380tr.bin", &tms_device) != 0) {
1286                 printk(KERN_ALERT "%s: firmware %s is missing, cannot start.\n",
1287                         dev->name, "tms380tr.bin");
1288                 return (-1);
1289         }
1290
1291         fw_ptr = (unsigned short *)fw_entry->data;
1292         count2 = fw_entry->size / 2;
1293
1294         /* Hardware adapter reset */
1295         SIFWRITEW(ACL_ARESET, SIFACL);
1296         tms380tr_wait(40);
1297         
1298         c = SIFREADW(SIFACL);
1299         tms380tr_wait(20);
1300
1301         if(dev->dma == 0)       /* For PCI adapters */
1302         {
1303                 c &= ~(ACL_NSELOUT0 | ACL_NSELOUT1);    /* Clear bits */
1304                 if(tp->setnselout)
1305                   c |= (*tp->setnselout)(dev);
1306         }
1307
1308         /* In case a command is pending - forget it */
1309         tp->ScbInUse = 0;
1310
1311         c &= ~ACL_ARESET;               /* Clear adapter reset bit */
1312         c |=  ACL_CPHALT;               /* Halt adapter CPU, allow download */
1313         c |= ACL_BOOT;
1314         c |= ACL_SINTEN;
1315         c &= ~ACL_PSDMAEN;              /* Clear pseudo dma bit */
1316         SIFWRITEW(c, SIFACL);
1317         tms380tr_wait(40);
1318
1319         count = 0;
1320         /* Download firmware via DIO interface: */
1321         do {
1322                 if (count2 < 3) continue;
1323
1324                 /* Download first address part */
1325                 SIFWRITEW(*fw_ptr, SIFADX);
1326                 fw_ptr++;
1327                 count2--;
1328                 /* Download second address part */
1329                 SIFWRITEW(*fw_ptr, SIFADD);
1330                 fw_ptr++;
1331                 count2--;
1332
1333                 if((count = *fw_ptr) != 0)      /* Load loop counter */
1334                 {
1335                         fw_ptr++;       /* Download block data */
1336                         count2--;
1337                         if (count > count2) continue;
1338
1339                         for(; count > 0; count--)
1340                         {
1341                                 SIFWRITEW(*fw_ptr, SIFINC);
1342                                 fw_ptr++;
1343                                 count2--;
1344                         }
1345                 }
1346                 else    /* Stop, if last block downloaded */
1347                 {
1348                         c = SIFREADW(SIFACL);
1349                         c &= (~ACL_CPHALT | ACL_SINTEN);
1350
1351                         /* Clear CPHALT and start BUD */
1352                         SIFWRITEW(c, SIFACL);
1353                         if (fw_entry)
1354                                 release_firmware(fw_entry);
1355                         return (1);
1356                 }
1357         } while(count == 0);
1358
1359         if (fw_entry)
1360                 release_firmware(fw_entry);
1361         printk(KERN_INFO "%s: Adapter Download Failed\n", dev->name);
1362         return (-1);
1363 }
1364
1365 /*
1366  * Starts bring up diagnostics of token ring adapter and evaluates
1367  * diagnostic results.
1368  */
1369 static int tms380tr_bringup_diags(struct net_device *dev)
1370 {
1371         int loop_cnt, retry_cnt;
1372         unsigned short Status;
1373
1374         tms380tr_wait(HALF_SECOND);
1375         tms380tr_exec_sifcmd(dev, EXEC_SOFT_RESET);
1376         tms380tr_wait(HALF_SECOND);
1377
1378         retry_cnt = BUD_MAX_RETRIES;    /* maximal number of retrys */
1379
1380         do {
1381                 retry_cnt--;
1382                 if(tms380tr_debug > 3)
1383                         printk(KERN_DEBUG "BUD-Status: ");
1384                 loop_cnt = BUD_MAX_LOOPCNT;     /* maximum: three seconds*/
1385                 do {                    /* Inspect BUD results */
1386                         loop_cnt--;
1387                         tms380tr_wait(HALF_SECOND);
1388                         Status = SIFREADW(SIFSTS);
1389                         Status &= STS_MASK;
1390
1391                         if(tms380tr_debug > 3)
1392                                 printk(KERN_DEBUG " %04X \n", Status);
1393                         /* BUD successfully completed */
1394                         if(Status == STS_INITIALIZE)
1395                                 return (1);
1396                 /* Unrecoverable hardware error, BUD not completed? */
1397                 } while((loop_cnt > 0) && ((Status & (STS_ERROR | STS_TEST))
1398                         != (STS_ERROR | STS_TEST)));
1399
1400                 /* Error preventing completion of BUD */
1401                 if(retry_cnt > 0)
1402                 {
1403                         printk(KERN_INFO "%s: Adapter Software Reset.\n", 
1404                                 dev->name);
1405                         tms380tr_exec_sifcmd(dev, EXEC_SOFT_RESET);
1406                         tms380tr_wait(HALF_SECOND);
1407                 }
1408         } while(retry_cnt > 0);
1409
1410         Status = SIFREADW(SIFSTS);
1411         
1412         printk(KERN_INFO "%s: Hardware error\n", dev->name);
1413         /* Hardware error occurred! */
1414         Status &= 0x001f;
1415         if (Status & 0x0010)
1416                 printk(KERN_INFO "%s: BUD Error: Timeout\n", dev->name);
1417         else if ((Status & 0x000f) > 6)
1418                 printk(KERN_INFO "%s: BUD Error: Illegal Failure\n", dev->name);
1419         else
1420                 printk(KERN_INFO "%s: Bring Up Diagnostics Error (%04X) occurred\n", dev->name, Status & 0x000f);
1421
1422         return (-1);
1423 }
1424
1425 /*
1426  * Copy initialisation data to adapter memory, beginning at address
1427  * 1:0A00; Starting DMA test and evaluating result bits.
1428  */
1429 static int tms380tr_init_adapter(struct net_device *dev)
1430 {
1431         struct net_local *tp = netdev_priv(dev);
1432
1433         const unsigned char SCB_Test[6] = {0x00, 0x00, 0xC1, 0xE2, 0xD4, 0x8B};
1434         const unsigned char SSB_Test[8] = {0xFF, 0xFF, 0xD1, 0xD7,
1435                                                 0xC5, 0xD9, 0xC3, 0xD4};
1436         void *ptr = (void *)&tp->ipb;
1437         unsigned short *ipb_ptr = (unsigned short *)ptr;
1438         unsigned char *cb_ptr = (unsigned char *) &tp->scb;
1439         unsigned char *sb_ptr = (unsigned char *) &tp->ssb;
1440         unsigned short Status;
1441         int i, loop_cnt, retry_cnt;
1442
1443         /* Normalize: byte order low/high, word order high/low! (only IPB!) */
1444         tp->ipb.SCB_Addr = SWAPW(((char *)&tp->scb - (char *)tp) + tp->dmabuffer);
1445         tp->ipb.SSB_Addr = SWAPW(((char *)&tp->ssb - (char *)tp) + tp->dmabuffer);
1446
1447         if(tms380tr_debug > 3)
1448         {
1449                 printk(KERN_DEBUG "%s: buffer (real): %lx\n", dev->name, (long) &tp->scb);
1450                 printk(KERN_DEBUG "%s: buffer (virt): %lx\n", dev->name, (long) ((char *)&tp->scb - (char *)tp) + (long) tp->dmabuffer);
1451                 printk(KERN_DEBUG "%s: buffer (DMA) : %lx\n", dev->name, (long) tp->dmabuffer);
1452                 printk(KERN_DEBUG "%s: buffer (tp)  : %lx\n", dev->name, (long) tp);
1453         }
1454         /* Maximum: three initialization retries */
1455         retry_cnt = INIT_MAX_RETRIES;
1456
1457         do {
1458                 retry_cnt--;
1459
1460                 /* Transfer initialization block */
1461                 SIFWRITEW(0x0001, SIFADX);
1462
1463                 /* To address 0001:0A00 of adapter RAM */
1464                 SIFWRITEW(0x0A00, SIFADD);
1465
1466                 /* Write 11 words to adapter RAM */
1467                 for(i = 0; i < 11; i++)
1468                         SIFWRITEW(ipb_ptr[i], SIFINC);
1469
1470                 /* Execute SCB adapter command */
1471                 tms380tr_exec_sifcmd(dev, CMD_EXECUTE);
1472
1473                 loop_cnt = INIT_MAX_LOOPCNT;    /* Maximum: 11 seconds */
1474
1475                 /* While remaining retries, no error and not completed */
1476                 do {
1477                         Status = 0;
1478                         loop_cnt--;
1479                         tms380tr_wait(HALF_SECOND);
1480
1481                         /* Mask interesting status bits */
1482                         Status = SIFREADW(SIFSTS);
1483                         Status &= STS_MASK;
1484                 } while(((Status &(STS_INITIALIZE | STS_ERROR | STS_TEST)) != 0)
1485                         && ((Status & STS_ERROR) == 0) && (loop_cnt != 0));
1486
1487                 if((Status & (STS_INITIALIZE | STS_ERROR | STS_TEST)) == 0)
1488                 {
1489                         /* Initialization completed without error */
1490                         i = 0;
1491                         do {    /* Test if contents of SCB is valid */
1492                                 if(SCB_Test[i] != *(cb_ptr + i))
1493                                 {
1494                                         printk(KERN_INFO "%s: DMA failed\n", dev->name);
1495                                         /* DMA data error: wrong data in SCB */
1496                                         return (-1);
1497                                 }
1498                                 i++;
1499                         } while(i < 6);
1500
1501                         i = 0;
1502                         do {    /* Test if contents of SSB is valid */
1503                                 if(SSB_Test[i] != *(sb_ptr + i))
1504                                         /* DMA data error: wrong data in SSB */
1505                                         return (-1);
1506                                 i++;
1507                         } while (i < 8);
1508
1509                         return (1);     /* Adapter successfully initialized */
1510                 }
1511                 else
1512                 {
1513                         if((Status & STS_ERROR) != 0)
1514                         {
1515                                 /* Initialization error occurred */
1516                                 Status = SIFREADW(SIFSTS);
1517                                 Status &= STS_ERROR_MASK;
1518                                 /* ShowInitialisationErrorCode(Status); */
1519                                 printk(KERN_INFO "%s: Status error: %d\n", dev->name, Status);
1520                                 return (-1); /* Unrecoverable error */
1521                         }
1522                         else
1523                         {
1524                                 if(retry_cnt > 0)
1525                                 {
1526                                         /* Reset adapter and try init again */
1527                                         tms380tr_exec_sifcmd(dev, EXEC_SOFT_RESET);
1528                                         tms380tr_wait(HALF_SECOND);
1529                                 }
1530                         }
1531                 }
1532         } while(retry_cnt > 0);
1533
1534         printk(KERN_INFO "%s: Retry exceeded\n", dev->name);
1535         return (-1);
1536 }
1537
1538 /*
1539  * Check for outstanding commands in command queue and tries to execute
1540  * command immediately. Corresponding command flag in command queue is cleared.
1541  */
1542 static void tms380tr_chk_outstanding_cmds(struct net_device *dev)
1543 {
1544         struct net_local *tp = netdev_priv(dev);
1545         unsigned long Addr = 0;
1546
1547         if(tp->CMDqueue == 0)
1548                 return;         /* No command execution */
1549
1550         /* If SCB in use: no command */
1551         if(tp->ScbInUse == 1)
1552                 return;
1553
1554         /* Check if adapter is opened, avoiding COMMAND_REJECT
1555          * interrupt by the adapter!
1556          */
1557         if(tp->AdapterOpenFlag == 0)
1558         {
1559                 if(tp->CMDqueue & OC_OPEN)
1560                 {
1561                         /* Execute OPEN command */
1562                         tp->CMDqueue ^= OC_OPEN;
1563
1564                         Addr = htonl(((char *)&tp->ocpl - (char *)tp) + tp->dmabuffer);
1565                         tp->scb.Parm[0] = LOWORD(Addr);
1566                         tp->scb.Parm[1] = HIWORD(Addr);
1567                         tp->scb.CMD = OPEN;
1568                 }
1569                 else
1570                         /* No OPEN command queued, but adapter closed. Note:
1571                          * We'll try to re-open the adapter in DriverPoll()
1572                          */
1573                         return;         /* No adapter command issued */
1574         }
1575         else
1576         {
1577                 /* Adapter is open; evaluate command queue: try to execute
1578                  * outstanding commands (depending on priority!) CLOSE
1579                  * command queued
1580                  */
1581                 if(tp->CMDqueue & OC_CLOSE)
1582                 {
1583                         tp->CMDqueue ^= OC_CLOSE;
1584                         tp->AdapterOpenFlag = 0;
1585                         tp->scb.Parm[0] = 0; /* Parm[0], Parm[1] are ignored */
1586                         tp->scb.Parm[1] = 0; /* but should be set to zero! */
1587                         tp->scb.CMD = CLOSE;
1588                         if(!tp->HaltInProgress)
1589                                 tp->CMDqueue |= OC_OPEN; /* re-open adapter */
1590                         else
1591                                 tp->CMDqueue = 0;       /* no more commands */
1592                 }
1593                 else
1594                 {
1595                         if(tp->CMDqueue & OC_RECEIVE)
1596                         {
1597                                 tp->CMDqueue ^= OC_RECEIVE;
1598                                 Addr = htonl(((char *)tp->RplHead - (char *)tp) + tp->dmabuffer);
1599                                 tp->scb.Parm[0] = LOWORD(Addr);
1600                                 tp->scb.Parm[1] = HIWORD(Addr);
1601                                 tp->scb.CMD = RECEIVE;
1602                         }
1603                         else
1604                         {
1605                                 if(tp->CMDqueue & OC_TRANSMIT_HALT)
1606                                 {
1607                                         /* NOTE: TRANSMIT.HALT must be checked 
1608                                          * before TRANSMIT.
1609                                          */
1610                                         tp->CMDqueue ^= OC_TRANSMIT_HALT;
1611                                         tp->scb.CMD = TRANSMIT_HALT;
1612
1613                                         /* Parm[0] and Parm[1] are ignored
1614                                          * but should be set to zero!
1615                                          */
1616                                         tp->scb.Parm[0] = 0;
1617                                         tp->scb.Parm[1] = 0;
1618                                 }
1619                                 else
1620                                 {
1621                                         if(tp->CMDqueue & OC_TRANSMIT)
1622                                         {
1623                                                 /* NOTE: TRANSMIT must be 
1624                                                  * checked after TRANSMIT.HALT
1625                                                  */
1626                                                 if(tp->TransmitCommandActive)
1627                                                 {
1628                                                         if(!tp->TransmitHaltScheduled)
1629                                                         {
1630                                                                 tp->TransmitHaltScheduled = 1;
1631                                                                 tms380tr_exec_cmd(dev, OC_TRANSMIT_HALT) ;
1632                                                         }
1633                                                         tp->TransmitCommandActive = 0;
1634                                                         return;
1635                                                 }
1636
1637                                                 tp->CMDqueue ^= OC_TRANSMIT;
1638                                                 tms380tr_cancel_tx_queue(tp);
1639                                                 Addr = htonl(((char *)tp->TplBusy - (char *)tp) + tp->dmabuffer);
1640                                                 tp->scb.Parm[0] = LOWORD(Addr);
1641                                                 tp->scb.Parm[1] = HIWORD(Addr);
1642                                                 tp->scb.CMD = TRANSMIT;
1643                                                 tp->TransmitCommandActive = 1;
1644                                         }
1645                                         else
1646                                         {
1647                                                 if(tp->CMDqueue & OC_MODIFY_OPEN_PARMS)
1648                                                 {
1649                                                         tp->CMDqueue ^= OC_MODIFY_OPEN_PARMS;
1650                                                         tp->scb.Parm[0] = tp->ocpl.OPENOptions; /* new OPEN options*/
1651                                                         tp->scb.Parm[0] |= ENABLE_FULL_DUPLEX_SELECTION;
1652                                                         tp->scb.Parm[1] = 0; /* is ignored but should be zero */
1653                                                         tp->scb.CMD = MODIFY_OPEN_PARMS;
1654                                                 }
1655                                                 else
1656                                                 {
1657                                                         if(tp->CMDqueue & OC_SET_FUNCT_ADDR)
1658                                                         {
1659                                                                 tp->CMDqueue ^= OC_SET_FUNCT_ADDR;
1660                                                                 tp->scb.Parm[0] = LOWORD(tp->ocpl.FunctAddr);
1661                                                                 tp->scb.Parm[1] = HIWORD(tp->ocpl.FunctAddr);
1662                                                                 tp->scb.CMD = SET_FUNCT_ADDR;
1663                                                         }
1664                                                         else
1665                                                         {
1666                                                                 if(tp->CMDqueue & OC_SET_GROUP_ADDR)
1667                                                                 {
1668                                                                         tp->CMDqueue ^= OC_SET_GROUP_ADDR;
1669                                                                         tp->scb.Parm[0] = LOWORD(tp->ocpl.GroupAddr);
1670                                                                         tp->scb.Parm[1] = HIWORD(tp->ocpl.GroupAddr);
1671                                                                         tp->scb.CMD = SET_GROUP_ADDR;
1672                                                                 }
1673                                                                 else
1674                                                                 {
1675                                                                         if(tp->CMDqueue & OC_READ_ERROR_LOG)
1676                                                                         {
1677                                                                                 tp->CMDqueue ^= OC_READ_ERROR_LOG;
1678                                                                                 Addr = htonl(((char *)&tp->errorlogtable - (char *)tp) + tp->dmabuffer);
1679                                                                                 tp->scb.Parm[0] = LOWORD(Addr);
1680                                                                                 tp->scb.Parm[1] = HIWORD(Addr);
1681                                                                                 tp->scb.CMD = READ_ERROR_LOG;
1682                                                                         }
1683                                                                         else
1684                                                                         {
1685                                                                                 printk(KERN_WARNING "CheckForOutstandingCommand: unknown Command\n");
1686                                                                                 tp->CMDqueue = 0;
1687                                                                                 return;
1688                                                                         }
1689                                                                 }
1690                                                         }
1691                                                 }
1692                                         }
1693                                 }
1694                         }
1695                 }
1696         }
1697
1698         tp->ScbInUse = 1;       /* Set semaphore: SCB in use. */
1699
1700         /* Execute SCB and generate IRQ when done. */
1701         tms380tr_exec_sifcmd(dev, CMD_EXECUTE | CMD_SCB_REQUEST);
1702
1703         return;
1704 }
1705
1706 /*
1707  * IRQ conditions: signal loss on the ring, transmit or receive of beacon
1708  * frames (disabled if bit 1 of OPEN option is set); report error MAC
1709  * frame transmit (disabled if bit 2 of OPEN option is set); open or short
1710  * circuit fault on the lobe is detected; remove MAC frame received;
1711  * error counter overflow (255); opened adapter is the only station in ring.
1712  * After some of the IRQs the adapter is closed!
1713  */
1714 static void tms380tr_ring_status_irq(struct net_device *dev)
1715 {
1716         struct net_local *tp = netdev_priv(dev);
1717
1718         tp->CurrentRingStatus = be16_to_cpu((unsigned short)tp->ssb.Parm[0]);
1719
1720         /* First: fill up statistics */
1721         if(tp->ssb.Parm[0] & SIGNAL_LOSS)
1722         {
1723                 printk(KERN_INFO "%s: Signal Loss\n", dev->name);
1724                 tp->MacStat.line_errors++;
1725         }
1726
1727         /* Adapter is closed, but initialized */
1728         if(tp->ssb.Parm[0] & LOBE_WIRE_FAULT)
1729         {
1730                 printk(KERN_INFO "%s: Lobe Wire Fault, Reopen Adapter\n", 
1731                         dev->name);
1732                 tp->MacStat.line_errors++;
1733         }
1734
1735         if(tp->ssb.Parm[0] & RING_RECOVERY)
1736                 printk(KERN_INFO "%s: Ring Recovery\n", dev->name);
1737
1738         /* Counter overflow: read error log */
1739         if(tp->ssb.Parm[0] & COUNTER_OVERFLOW)
1740         {
1741                 printk(KERN_INFO "%s: Counter Overflow\n", dev->name);
1742                 tms380tr_exec_cmd(dev, OC_READ_ERROR_LOG);
1743         }
1744
1745         /* Adapter is closed, but initialized */
1746         if(tp->ssb.Parm[0] & REMOVE_RECEIVED)
1747                 printk(KERN_INFO "%s: Remove Received, Reopen Adapter\n", 
1748                         dev->name);
1749
1750         /* Adapter is closed, but initialized */
1751         if(tp->ssb.Parm[0] & AUTO_REMOVAL_ERROR)
1752                 printk(KERN_INFO "%s: Auto Removal Error, Reopen Adapter\n", 
1753                         dev->name);
1754
1755         if(tp->ssb.Parm[0] & HARD_ERROR)
1756                 printk(KERN_INFO "%s: Hard Error\n", dev->name);
1757
1758         if(tp->ssb.Parm[0] & SOFT_ERROR)
1759                 printk(KERN_INFO "%s: Soft Error\n", dev->name);
1760
1761         if(tp->ssb.Parm[0] & TRANSMIT_BEACON)
1762                 printk(KERN_INFO "%s: Transmit Beacon\n", dev->name);
1763
1764         if(tp->ssb.Parm[0] & SINGLE_STATION)
1765                 printk(KERN_INFO "%s: Single Station\n", dev->name);
1766
1767         /* Check if adapter has been closed */
1768         if(tp->ssb.Parm[0] & ADAPTER_CLOSED)
1769         {
1770                 printk(KERN_INFO "%s: Adapter closed (Reopening)," 
1771                         "CurrentRingStat %x\n",
1772                         dev->name, tp->CurrentRingStatus);
1773                 tp->AdapterOpenFlag = 0;
1774                 tms380tr_open_adapter(dev);
1775         }
1776
1777         return;
1778 }
1779
1780 /*
1781  * Issued if adapter has encountered an unrecoverable hardware
1782  * or software error.
1783  */
1784 static void tms380tr_chk_irq(struct net_device *dev)
1785 {
1786         int i;
1787         unsigned short AdapterCheckBlock[4];
1788         struct net_local *tp = netdev_priv(dev);
1789
1790         tp->AdapterOpenFlag = 0;        /* Adapter closed now */
1791
1792         /* Page number of adapter memory */
1793         SIFWRITEW(0x0001, SIFADX);
1794         /* Address offset */
1795         SIFWRITEW(CHECKADDR, SIFADR);
1796
1797         /* Reading 8 byte adapter check block. */
1798         for(i = 0; i < 4; i++)
1799                 AdapterCheckBlock[i] = SIFREADW(SIFINC);
1800
1801         if(tms380tr_debug > 3)
1802         {
1803                 printk(KERN_DEBUG "%s: AdapterCheckBlock: ", dev->name);
1804                 for (i = 0; i < 4; i++)
1805                         printk("%04X", AdapterCheckBlock[i]);
1806                 printk("\n");
1807         }
1808
1809         switch(AdapterCheckBlock[0])
1810         {
1811                 case DIO_PARITY:
1812                         printk(KERN_INFO "%s: DIO parity error\n", dev->name);
1813                         break;
1814
1815                 case DMA_READ_ABORT:
1816                         printk(KERN_INFO "%s DMA read operation aborted:\n",
1817                                 dev->name);
1818                         switch (AdapterCheckBlock[1])
1819                         {
1820                                 case 0:
1821                                         printk(KERN_INFO "Timeout\n");
1822                                         printk(KERN_INFO "Address: %04X %04X\n",
1823                                                 AdapterCheckBlock[2],
1824                                                 AdapterCheckBlock[3]);
1825                                         break;
1826
1827                                 case 1:
1828                                         printk(KERN_INFO "Parity error\n");
1829                                         printk(KERN_INFO "Address: %04X %04X\n",
1830                                                 AdapterCheckBlock[2], 
1831                                                 AdapterCheckBlock[3]);
1832                                         break;
1833
1834                                 case 2: 
1835                                         printk(KERN_INFO "Bus error\n");
1836                                         printk(KERN_INFO "Address: %04X %04X\n",
1837                                                 AdapterCheckBlock[2], 
1838                                                 AdapterCheckBlock[3]);
1839                                         break;
1840
1841                                 default:
1842                                         printk(KERN_INFO "Unknown error.\n");
1843                                         break;
1844                         }
1845                         break;
1846
1847                 case DMA_WRITE_ABORT:
1848                         printk(KERN_INFO "%s: DMA write operation aborted: \n",
1849                                 dev->name);
1850                         switch (AdapterCheckBlock[1])
1851                         {
1852                                 case 0: 
1853                                         printk(KERN_INFO "Timeout\n");
1854                                         printk(KERN_INFO "Address: %04X %04X\n",
1855                                                 AdapterCheckBlock[2], 
1856                                                 AdapterCheckBlock[3]);
1857                                         break;
1858
1859                                 case 1: 
1860                                         printk(KERN_INFO "Parity error\n");
1861                                         printk(KERN_INFO "Address: %04X %04X\n",
1862                                                 AdapterCheckBlock[2], 
1863                                                 AdapterCheckBlock[3]);
1864                                         break;
1865
1866                                 case 2: 
1867                                         printk(KERN_INFO "Bus error\n");
1868                                         printk(KERN_INFO "Address: %04X %04X\n",
1869                                                 AdapterCheckBlock[2], 
1870                                                 AdapterCheckBlock[3]);
1871                                         break;
1872
1873                                 default:
1874                                         printk(KERN_INFO "Unknown error.\n");
1875                                         break;
1876                         }
1877                         break;
1878
1879                 case ILLEGAL_OP_CODE:
1880                         printk(KERN_INFO "%s: Illegal operation code in firmware\n",
1881                                 dev->name);
1882                         /* Parm[0-3]: adapter internal register R13-R15 */
1883                         break;
1884
1885                 case PARITY_ERRORS:
1886                         printk(KERN_INFO "%s: Adapter internal bus parity error\n",
1887                                 dev->name);
1888                         /* Parm[0-3]: adapter internal register R13-R15 */
1889                         break;
1890
1891                 case RAM_DATA_ERROR:
1892                         printk(KERN_INFO "%s: RAM data error\n", dev->name);
1893                         /* Parm[0-1]: MSW/LSW address of RAM location. */
1894                         break;
1895
1896                 case RAM_PARITY_ERROR:
1897                         printk(KERN_INFO "%s: RAM parity error\n", dev->name);
1898                         /* Parm[0-1]: MSW/LSW address of RAM location. */
1899                         break;
1900
1901                 case RING_UNDERRUN:
1902                         printk(KERN_INFO "%s: Internal DMA underrun detected\n",
1903                                 dev->name);
1904                         break;
1905
1906                 case INVALID_IRQ:
1907                         printk(KERN_INFO "%s: Unrecognized interrupt detected\n",
1908                                 dev->name);
1909                         /* Parm[0-3]: adapter internal register R13-R15 */
1910                         break;
1911
1912                 case INVALID_ERROR_IRQ:
1913                         printk(KERN_INFO "%s: Unrecognized error interrupt detected\n",
1914                                 dev->name);
1915                         /* Parm[0-3]: adapter internal register R13-R15 */
1916                         break;
1917
1918                 case INVALID_XOP:
1919                         printk(KERN_INFO "%s: Unrecognized XOP request detected\n",
1920                                 dev->name);
1921                         /* Parm[0-3]: adapter internal register R13-R15 */
1922                         break;
1923
1924                 default:
1925                         printk(KERN_INFO "%s: Unknown status", dev->name);
1926                         break;
1927         }
1928
1929         if(tms380tr_chipset_init(dev) == 1)
1930         {
1931                 /* Restart of firmware successful */
1932                 tp->AdapterOpenFlag = 1;
1933         }
1934
1935         return;
1936 }
1937
1938 /*
1939  * Internal adapter pointer to RAM data are copied from adapter into
1940  * host system.
1941  */
1942 static int tms380tr_read_ptr(struct net_device *dev)
1943 {
1944         struct net_local *tp = netdev_priv(dev);
1945         unsigned short adapterram;
1946
1947         tms380tr_read_ram(dev, (unsigned char *)&tp->intptrs.BurnedInAddrPtr,
1948                         ADAPTER_INT_PTRS, 16);
1949         tms380tr_read_ram(dev, (unsigned char *)&adapterram,
1950                         cpu_to_be16((unsigned short)tp->intptrs.AdapterRAMPtr), 2);
1951         return be16_to_cpu(adapterram); 
1952 }
1953
1954 /*
1955  * Reads a number of bytes from adapter to system memory.
1956  */
1957 static void tms380tr_read_ram(struct net_device *dev, unsigned char *Data,
1958                                 unsigned short Address, int Length)
1959 {
1960         int i;
1961         unsigned short old_sifadx, old_sifadr, InWord;
1962
1963         /* Save the current values */
1964         old_sifadx = SIFREADW(SIFADX);
1965         old_sifadr = SIFREADW(SIFADR);
1966
1967         /* Page number of adapter memory */
1968         SIFWRITEW(0x0001, SIFADX);
1969         /* Address offset in adapter RAM */
1970         SIFWRITEW(Address, SIFADR);
1971
1972         /* Copy len byte from adapter memory to system data area. */
1973         i = 0;
1974         for(;;)
1975         {
1976                 InWord = SIFREADW(SIFINC);
1977
1978                 *(Data + i) = HIBYTE(InWord);   /* Write first byte */
1979                 if(++i == Length)               /* All is done break */
1980                         break;
1981
1982                 *(Data + i) = LOBYTE(InWord);   /* Write second byte */
1983                 if (++i == Length)              /* All is done break */
1984                         break;
1985         }
1986
1987         /* Restore original values */
1988         SIFWRITEW(old_sifadx, SIFADX);
1989         SIFWRITEW(old_sifadr, SIFADR);
1990
1991         return;
1992 }
1993
1994 /*
1995  * Cancel all queued packets in the transmission queue.
1996  */
1997 static void tms380tr_cancel_tx_queue(struct net_local* tp)
1998 {
1999         TPL *tpl;
2000
2001         /*
2002          * NOTE: There must not be an active TRANSMIT command pending, when
2003          * this function is called.
2004          */
2005         if(tp->TransmitCommandActive)
2006                 return;
2007
2008         for(;;)
2009         {
2010                 tpl = tp->TplBusy;
2011                 if(!tpl->BusyFlag)
2012                         break;
2013                 /* "Remove" TPL from busy list. */
2014                 tp->TplBusy = tpl->NextTPLPtr;
2015                 tms380tr_write_tpl_status(tpl, 0);      /* Clear VALID bit */
2016                 tpl->BusyFlag = 0;              /* "free" TPL */
2017
2018                 printk(KERN_INFO "Cancel tx (%08lXh).\n", (unsigned long)tpl);
2019                 if (tpl->DMABuff)
2020                         pci_unmap_single(tp->pdev, tpl->DMABuff, tpl->Skb->len, PCI_DMA_TODEVICE);
2021                 dev_kfree_skb_any(tpl->Skb);
2022         }
2023
2024         return;
2025 }
2026
2027 /*
2028  * This function is called whenever a transmit interrupt is generated by the
2029  * adapter. For a command complete interrupt, it is checked if we have to
2030  * issue a new transmit command or not.
2031  */
2032 static void tms380tr_tx_status_irq(struct net_device *dev)
2033 {
2034         struct net_local *tp = netdev_priv(dev);
2035         unsigned char HighByte, HighAc, LowAc;
2036         TPL *tpl;
2037
2038         /* NOTE: At this point the SSB from TRANSMIT STATUS is no longer
2039          * available, because the CLEAR SSB command has already been issued.
2040          *
2041          * Process all complete transmissions.
2042          */
2043
2044         for(;;)
2045         {
2046                 tpl = tp->TplBusy;
2047                 if(!tpl->BusyFlag || (tpl->Status
2048                         & (TX_VALID | TX_FRAME_COMPLETE))
2049                         != TX_FRAME_COMPLETE)
2050                 {
2051                         break;
2052                 }
2053
2054                 /* "Remove" TPL from busy list. */
2055                 tp->TplBusy = tpl->NextTPLPtr ;
2056
2057                 /* Check the transmit status field only for directed frames*/
2058                 if(DIRECTED_FRAME(tpl) && (tpl->Status & TX_ERROR) == 0)
2059                 {
2060                         HighByte = GET_TRANSMIT_STATUS_HIGH_BYTE(tpl->Status);
2061                         HighAc   = GET_FRAME_STATUS_HIGH_AC(HighByte);
2062                         LowAc    = GET_FRAME_STATUS_LOW_AC(HighByte);
2063
2064                         if((HighAc != LowAc) || (HighAc == AC_NOT_RECOGNIZED))
2065                         {
2066                                 printk(KERN_DEBUG "%s: (DA=%08lX not recognized)\n",
2067                                         dev->name,
2068                                         *(unsigned long *)&tpl->MData[2+2]);
2069                         }
2070                         else
2071                         {
2072                                 if(tms380tr_debug > 3)
2073                                         printk(KERN_DEBUG "%s: Directed frame tx'd\n", 
2074                                                 dev->name);
2075                         }
2076                 }
2077                 else
2078                 {
2079                         if(!DIRECTED_FRAME(tpl))
2080                         {
2081                                 if(tms380tr_debug > 3)
2082                                         printk(KERN_DEBUG "%s: Broadcast frame tx'd\n",
2083                                                 dev->name);
2084                         }
2085                 }
2086
2087                 tp->MacStat.tx_packets++;
2088                 if (tpl->DMABuff)
2089                         pci_unmap_single(tp->pdev, tpl->DMABuff, tpl->Skb->len, PCI_DMA_TODEVICE);
2090                 dev_kfree_skb_irq(tpl->Skb);
2091                 tpl->BusyFlag = 0;      /* "free" TPL */
2092         }
2093
2094         if(!tp->TplFree->NextTPLPtr->BusyFlag)
2095                 netif_wake_queue(dev);
2096         return;
2097 }
2098
2099 /*
2100  * Called if a frame receive interrupt is generated by the adapter.
2101  * Check if the frame is valid and indicate it to system.
2102  */
2103 static void tms380tr_rcv_status_irq(struct net_device *dev)
2104 {
2105         struct net_local *tp = netdev_priv(dev);
2106         unsigned char *ReceiveDataPtr;
2107         struct sk_buff *skb;
2108         unsigned int Length, Length2;
2109         RPL *rpl;
2110         RPL *SaveHead;
2111         dma_addr_t dmabuf;
2112
2113         /* NOTE: At this point the SSB from RECEIVE STATUS is no longer
2114          * available, because the CLEAR SSB command has already been issued.
2115          *
2116          * Process all complete receives.
2117          */
2118
2119         for(;;)
2120         {
2121                 rpl = tp->RplHead;
2122                 if(rpl->Status & RX_VALID)
2123                         break;          /* RPL still in use by adapter */
2124
2125                 /* Forward RPLHead pointer to next list. */
2126                 SaveHead = tp->RplHead;
2127                 tp->RplHead = rpl->NextRPLPtr;
2128
2129                 /* Get the frame size (Byte swap for Intel).
2130                  * Do this early (see workaround comment below)
2131                  */
2132                 Length = be16_to_cpu((unsigned short)rpl->FrameSize);
2133
2134                 /* Check if the Frame_Start, Frame_End and
2135                  * Frame_Complete bits are set.
2136                  */
2137                 if((rpl->Status & VALID_SINGLE_BUFFER_FRAME)
2138                         == VALID_SINGLE_BUFFER_FRAME)
2139                 {
2140                         ReceiveDataPtr = rpl->MData;
2141
2142                         /* Workaround for delayed write of FrameSize on ISA
2143                          * (FrameSize is false but valid-bit is reset)
2144                          * Frame size is set to zero when the RPL is freed.
2145                          * Length2 is there because there have also been
2146                          * cases where the FrameSize was partially written
2147                          */
2148                         Length2 = be16_to_cpu((unsigned short)rpl->FrameSize);
2149
2150                         if(Length == 0 || Length != Length2)
2151                         {
2152                                 tp->RplHead = SaveHead;
2153                                 break;  /* Return to tms380tr_interrupt */
2154                         }
2155                         tms380tr_update_rcv_stats(tp,ReceiveDataPtr,Length);
2156                           
2157                         if(tms380tr_debug > 3)
2158                                 printk(KERN_DEBUG "%s: Packet Length %04X (%d)\n",
2159                                         dev->name, Length, Length);
2160                           
2161                         /* Indicate the received frame to system the
2162                          * adapter does the Source-Routing padding for 
2163                          * us. See: OpenOptions in tms380tr_init_opb()
2164                          */
2165                         skb = rpl->Skb;
2166                         if(rpl->SkbStat == SKB_UNAVAILABLE)
2167                         {
2168                                 /* Try again to allocate skb */
2169                                 skb = dev_alloc_skb(tp->MaxPacketSize);
2170                                 if(skb == NULL)
2171                                 {
2172                                         /* Update Stats ?? */
2173                                 }
2174                                 else
2175                                 {
2176                                         skb->dev        = dev;
2177                                         skb_put(skb, tp->MaxPacketSize);
2178                                         rpl->SkbStat    = SKB_DATA_COPY;
2179                                         ReceiveDataPtr  = rpl->MData;
2180                                 }
2181                         }
2182
2183                         if(skb && (rpl->SkbStat == SKB_DATA_COPY
2184                                 || rpl->SkbStat == SKB_DMA_DIRECT))
2185                         {
2186                                 if(rpl->SkbStat == SKB_DATA_COPY)
2187                                         memcpy(skb->data, ReceiveDataPtr, Length);
2188
2189                                 /* Deliver frame to system */
2190                                 rpl->Skb = NULL;
2191                                 skb_trim(skb,Length);
2192                                 skb->protocol = tr_type_trans(skb,dev);
2193                                 netif_rx(skb);
2194                                 dev->last_rx = jiffies;
2195                         }
2196                 }
2197                 else    /* Invalid frame */
2198                 {
2199                         if(rpl->Skb != NULL)
2200                                 dev_kfree_skb_irq(rpl->Skb);
2201
2202                         /* Skip list. */
2203                         if(rpl->Status & RX_START_FRAME)
2204                                 /* Frame start bit is set -> overflow. */
2205                                 tp->MacStat.rx_errors++;
2206                 }
2207                 if (rpl->DMABuff)
2208                         pci_unmap_single(tp->pdev, rpl->DMABuff, tp->MaxPacketSize, PCI_DMA_TODEVICE);
2209                 rpl->DMABuff = 0;
2210
2211                 /* Allocate new skb for rpl */
2212                 rpl->Skb = dev_alloc_skb(tp->MaxPacketSize);
2213                 /* skb == NULL ? then use local buffer */
2214                 if(rpl->Skb == NULL)
2215                 {
2216                         rpl->SkbStat = SKB_UNAVAILABLE;
2217                         rpl->FragList[0].DataAddr = htonl(((char *)tp->LocalRxBuffers[rpl->RPLIndex] - (char *)tp) + tp->dmabuffer);
2218                         rpl->MData = tp->LocalRxBuffers[rpl->RPLIndex];
2219                 }
2220                 else    /* skb != NULL */
2221                 {
2222                         rpl->Skb->dev = dev;
2223                         skb_put(rpl->Skb, tp->MaxPacketSize);
2224
2225                         /* Data unreachable for DMA ? then use local buffer */
2226                         dmabuf = pci_map_single(tp->pdev, rpl->Skb->data, tp->MaxPacketSize, PCI_DMA_FROMDEVICE);
2227                         if(tp->dmalimit && (dmabuf + tp->MaxPacketSize > tp->dmalimit))
2228                         {
2229                                 rpl->SkbStat = SKB_DATA_COPY;
2230                                 rpl->FragList[0].DataAddr = htonl(((char *)tp->LocalRxBuffers[rpl->RPLIndex] - (char *)tp) + tp->dmabuffer);
2231                                 rpl->MData = tp->LocalRxBuffers[rpl->RPLIndex];
2232                         }
2233                         else
2234                         {
2235                                 /* DMA directly in skb->data */
2236                                 rpl->SkbStat = SKB_DMA_DIRECT;
2237                                 rpl->FragList[0].DataAddr = htonl(dmabuf);
2238                                 rpl->MData = rpl->Skb->data;
2239                                 rpl->DMABuff = dmabuf;
2240                         }
2241                 }
2242
2243                 rpl->FragList[0].DataCount = cpu_to_be16((unsigned short)tp->MaxPacketSize);
2244                 rpl->FrameSize = 0;
2245
2246                 /* Pass the last RPL back to the adapter */
2247                 tp->RplTail->FrameSize = 0;
2248
2249                 /* Reset the CSTAT field in the list. */
2250                 tms380tr_write_rpl_status(tp->RplTail, RX_VALID | RX_FRAME_IRQ);
2251
2252                 /* Current RPL becomes last one in list. */
2253                 tp->RplTail = tp->RplTail->NextRPLPtr;
2254
2255                 /* Inform adapter about RPL valid. */
2256                 tms380tr_exec_sifcmd(dev, CMD_RX_VALID);
2257         }
2258
2259         return;
2260 }
2261
2262 /*
2263  * This function should be used whenever the status of any RPL must be
2264  * modified by the driver, because the compiler may otherwise change the
2265  * order of instructions such that writing the RPL status may be executed
2266  * at an undesireable time. When this function is used, the status is
2267  * always written when the function is called.
2268  */
2269 static void tms380tr_write_rpl_status(RPL *rpl, unsigned int Status)
2270 {
2271         rpl->Status = Status;
2272
2273         return;
2274 }
2275
2276 /*
2277  * The function updates the statistic counters in mac->MacStat.
2278  * It differtiates between directed and broadcast/multicast ( ==functional)
2279  * frames.
2280  */
2281 static void tms380tr_update_rcv_stats(struct net_local *tp, unsigned char DataPtr[],
2282                                         unsigned int Length)
2283 {
2284         tp->MacStat.rx_packets++;
2285         tp->MacStat.rx_bytes += Length;
2286         
2287         /* Test functional bit */
2288         if(DataPtr[2] & GROUP_BIT)
2289                 tp->MacStat.multicast++;
2290
2291         return;
2292 }
2293
2294 static int tms380tr_set_mac_address(struct net_device *dev, void *addr)
2295 {
2296         struct net_local *tp = netdev_priv(dev);
2297         struct sockaddr *saddr = addr;
2298         
2299         if (tp->AdapterOpenFlag || tp->AdapterVirtOpenFlag) {
2300                 printk(KERN_WARNING "%s: Cannot set MAC/LAA address while card is open\n", dev->name);
2301                 return -EIO;
2302         }
2303         memcpy(dev->dev_addr, saddr->sa_data, dev->addr_len);
2304         return 0;
2305 }
2306
2307 #if TMS380TR_DEBUG > 0
2308 /*
2309  * Dump Packet (data)
2310  */
2311 static void tms380tr_dump(unsigned char *Data, int length)
2312 {
2313         int i, j;
2314
2315         for (i = 0, j = 0; i < length / 8; i++, j += 8)
2316         {
2317                 printk(KERN_DEBUG "%02x %02x %02x %02x %02x %02x %02x %02x\n",
2318                        Data[j+0],Data[j+1],Data[j+2],Data[j+3],
2319                        Data[j+4],Data[j+5],Data[j+6],Data[j+7]);
2320         }
2321
2322         return;
2323 }
2324 #endif
2325
2326 void tmsdev_term(struct net_device *dev)
2327 {
2328         struct net_local *tp;
2329
2330         tp = netdev_priv(dev);
2331         pci_unmap_single(tp->pdev, tp->dmabuffer, sizeof(struct net_local),
2332                 PCI_DMA_BIDIRECTIONAL);
2333 }
2334
2335 int tmsdev_init(struct net_device *dev, unsigned long dmalimit, 
2336                 struct pci_dev *pdev)
2337 {
2338         struct net_local *tms_local;
2339
2340         memset(dev->priv, 0, sizeof(struct net_local));
2341         tms_local = netdev_priv(dev);
2342         init_waitqueue_head(&tms_local->wait_for_tok_int);
2343         tms_local->dmalimit = dmalimit;
2344         tms_local->pdev = pdev;
2345         tms_local->dmabuffer = pci_map_single(pdev, (void *)tms_local,
2346             sizeof(struct net_local), PCI_DMA_BIDIRECTIONAL);
2347         if (tms_local->dmabuffer + sizeof(struct net_local) > dmalimit)
2348         {
2349                 printk(KERN_INFO "%s: Memory not accessible for DMA\n",
2350                         dev->name);
2351                 tmsdev_term(dev);
2352                 return -ENOMEM;
2353         }
2354         
2355         /* These can be overridden by the card driver if needed */
2356         dev->open               = tms380tr_open;
2357         dev->stop               = tms380tr_close;
2358         dev->do_ioctl           = NULL; 
2359         dev->hard_start_xmit    = tms380tr_send_packet;
2360         dev->tx_timeout         = tms380tr_timeout;
2361         dev->watchdog_timeo     = HZ;
2362         dev->get_stats          = tms380tr_get_stats;
2363         dev->set_multicast_list = &tms380tr_set_multicast_list;
2364         dev->set_mac_address    = tms380tr_set_mac_address;
2365
2366         return 0;
2367 }
2368
2369 #ifdef MODULE
2370
2371 EXPORT_SYMBOL(tms380tr_open);
2372 EXPORT_SYMBOL(tms380tr_close);
2373 EXPORT_SYMBOL(tms380tr_interrupt);
2374 EXPORT_SYMBOL(tmsdev_init);
2375 EXPORT_SYMBOL(tmsdev_term);
2376 EXPORT_SYMBOL(tms380tr_wait);
2377
2378 struct module *TMS380_module = NULL;
2379
2380 int init_module(void)
2381 {
2382         printk(KERN_DEBUG "%s", version);
2383         
2384         TMS380_module = &__this_module;
2385         return 0;
2386 }
2387
2388 void cleanup_module(void)
2389 {
2390         TMS380_module = NULL;
2391 }
2392 #endif
2393
2394 MODULE_LICENSE("GPL");
2395
2396 \f
2397 /*
2398  * Local variables:
2399  *  compile-command: "gcc -DMODVERSIONS  -DMODULE -D__KERNEL__ -Wall -Wstrict-prototypes -O6 -fomit-frame-pointer -I/usr/src/linux/drivers/net/tokenring/ -c tms380tr.c"
2400  *  alt-compile-command: "gcc -DMODULE -D__KERNEL__ -Wall -Wstrict-prototypes -O6 -fomit-frame-pointer -I/usr/src/linux/drivers/net/tokenring/ -c tms380tr.c"
2401  *  c-set-style "K&R"
2402  *  c-indent-level: 8
2403  *  c-basic-offset: 8
2404  *  tab-width: 8
2405  * End:
2406  */