aboutsummaryrefslogtreecommitdiffstats
path: root/drivers/scsi/sun3_NCR5380.c
diff options
context:
space:
mode:
authorLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
committerLinus Torvalds <torvalds@ppc970.osdl.org>2005-04-16 18:20:36 -0400
commit1da177e4c3f41524e886b7f1b8a0c1fc7321cac2 (patch)
tree0bba044c4ce775e45a88a51686b5d9f90697ea9d /drivers/scsi/sun3_NCR5380.c
Linux-2.6.12-rc2v2.6.12-rc2
Initial git repository build. I'm not bothering with the full history, even though we have it. We can create a separate "historical" git archive of that later if we want to, and in the meantime it's about 3.2GB when imported into git - space that would just make the early git days unnecessarily complicated, when we don't have a lot of good infrastructure for it. Let it rip!
Diffstat (limited to 'drivers/scsi/sun3_NCR5380.c')
-rw-r--r--drivers/scsi/sun3_NCR5380.c3009
1 files changed, 3009 insertions, 0 deletions
diff --git a/drivers/scsi/sun3_NCR5380.c b/drivers/scsi/sun3_NCR5380.c
new file mode 100644
index 000000000000..90811390a37d
--- /dev/null
+++ b/drivers/scsi/sun3_NCR5380.c
@@ -0,0 +1,3009 @@
1/* sun3_NCR5380.c -- adapted from atari_NCR5380.c for the sun3 by
2 Sam Creasey. */
3/*
4 * NCR 5380 generic driver routines. These should make it *trivial*
5 * to implement 5380 SCSI drivers under Linux with a non-trantor
6 * architecture.
7 *
8 * Note that these routines also work with NR53c400 family chips.
9 *
10 * Copyright 1993, Drew Eckhardt
11 * Visionary Computing
12 * (Unix and Linux consulting and custom programming)
13 * drew@colorado.edu
14 * +1 (303) 666-5836
15 *
16 * DISTRIBUTION RELEASE 6.
17 *
18 * For more information, please consult
19 *
20 * NCR 5380 Family
21 * SCSI Protocol Controller
22 * Databook
23 *
24 * NCR Microelectronics
25 * 1635 Aeroplaza Drive
26 * Colorado Springs, CO 80916
27 * 1+ (719) 578-3400
28 * 1+ (800) 334-5454
29 */
30
31/*
32 * ++roman: To port the 5380 driver to the Atari, I had to do some changes in
33 * this file, too:
34 *
35 * - Some of the debug statements were incorrect (undefined variables and the
36 * like). I fixed that.
37 *
38 * - In information_transfer(), I think a #ifdef was wrong. Looking at the
39 * possible DMA transfer size should also happen for REAL_DMA. I added this
40 * in the #if statement.
41 *
42 * - When using real DMA, information_transfer() should return in a DATAOUT
43 * phase after starting the DMA. It has nothing more to do.
44 *
45 * - The interrupt service routine should run main after end of DMA, too (not
46 * only after RESELECTION interrupts). Additionally, it should _not_ test
47 * for more interrupts after running main, since a DMA process may have
48 * been started and interrupts are turned on now. The new int could happen
49 * inside the execution of NCR5380_intr(), leading to recursive
50 * calls.
51 *
52 * - I've added a function merge_contiguous_buffers() that tries to
53 * merge scatter-gather buffers that are located at contiguous
54 * physical addresses and can be processed with the same DMA setup.
55 * Since most scatter-gather operations work on a page (4K) of
56 * 4 buffers (1K), in more than 90% of all cases three interrupts and
57 * DMA setup actions are saved.
58 *
59 * - I've deleted all the stuff for AUTOPROBE_IRQ, REAL_DMA_POLL, PSEUDO_DMA
60 * and USLEEP, because these were messing up readability and will never be
61 * needed for Atari SCSI.
62 *
63 * - I've revised the NCR5380_main() calling scheme (relax the 'main_running'
64 * stuff), and 'main' is executed in a bottom half if awoken by an
65 * interrupt.
66 *
67 * - The code was quite cluttered up by "#if (NDEBUG & NDEBUG_*) printk..."
68 * constructs. In my eyes, this made the source rather unreadable, so I
69 * finally replaced that by the *_PRINTK() macros.
70 *
71 */
72
73/*
74 * Further development / testing that should be done :
75 * 1. Test linked command handling code after Eric is ready with
76 * the high level code.
77 */
78
79#if (NDEBUG & NDEBUG_LISTS)
80#define LIST(x,y) \
81 { printk("LINE:%d Adding %p to %p\n", __LINE__, (void*)(x), (void*)(y)); \
82 if ((x)==(y)) udelay(5); }
83#define REMOVE(w,x,y,z) \
84 { printk("LINE:%d Removing: %p->%p %p->%p \n", __LINE__, \
85 (void*)(w), (void*)(x), (void*)(y), (void*)(z)); \
86 if ((x)==(y)) udelay(5); }
87#else
88#define LIST(x,y)
89#define REMOVE(w,x,y,z)
90#endif
91
92#ifndef notyet
93#undef LINKED
94#endif
95
96/*
97 * Design
98 * Issues :
99 *
100 * The other Linux SCSI drivers were written when Linux was Intel PC-only,
101 * and specifically for each board rather than each chip. This makes their
102 * adaptation to platforms like the Mac (Some of which use NCR5380's)
103 * more difficult than it has to be.
104 *
105 * Also, many of the SCSI drivers were written before the command queuing
106 * routines were implemented, meaning their implementations of queued
107 * commands were hacked on rather than designed in from the start.
108 *
109 * When I designed the Linux SCSI drivers I figured that
110 * while having two different SCSI boards in a system might be useful
111 * for debugging things, two of the same type wouldn't be used.
112 * Well, I was wrong and a number of users have mailed me about running
113 * multiple high-performance SCSI boards in a server.
114 *
115 * Finally, when I get questions from users, I have no idea what
116 * revision of my driver they are running.
117 *
118 * This driver attempts to address these problems :
119 * This is a generic 5380 driver. To use it on a different platform,
120 * one simply writes appropriate system specific macros (ie, data
121 * transfer - some PC's will use the I/O bus, 68K's must use
122 * memory mapped) and drops this file in their 'C' wrapper.
123 *
124 * As far as command queueing, two queues are maintained for
125 * each 5380 in the system - commands that haven't been issued yet,
126 * and commands that are currently executing. This means that an
127 * unlimited number of commands may be queued, letting
128 * more commands propagate from the higher driver levels giving higher
129 * throughput. Note that both I_T_L and I_T_L_Q nexuses are supported,
130 * allowing multiple commands to propagate all the way to a SCSI-II device
131 * while a command is already executing.
132 *
133 * To solve the multiple-boards-in-the-same-system problem,
134 * there is a separate instance structure for each instance
135 * of a 5380 in the system. So, multiple NCR5380 drivers will
136 * be able to coexist with appropriate changes to the high level
137 * SCSI code.
138 *
139 * A NCR5380_PUBLIC_REVISION macro is provided, with the release
140 * number (updated for each public release) printed by the
141 * NCR5380_print_options command, which should be called from the
142 * wrapper detect function, so that I know what release of the driver
143 * users are using.
144 *
145 * Issues specific to the NCR5380 :
146 *
147 * When used in a PIO or pseudo-dma mode, the NCR5380 is a braindead
148 * piece of hardware that requires you to sit in a loop polling for
149 * the REQ signal as long as you are connected. Some devices are
150 * brain dead (ie, many TEXEL CD ROM drives) and won't disconnect
151 * while doing long seek operations.
152 *
153 * The workaround for this is to keep track of devices that have
154 * disconnected. If the device hasn't disconnected, for commands that
155 * should disconnect, we do something like
156 *
157 * while (!REQ is asserted) { sleep for N usecs; poll for M usecs }
158 *
159 * Some tweaking of N and M needs to be done. An algorithm based
160 * on "time to data" would give the best results as long as short time
161 * to datas (ie, on the same track) were considered, however these
162 * broken devices are the exception rather than the rule and I'd rather
163 * spend my time optimizing for the normal case.
164 *
165 * Architecture :
166 *
167 * At the heart of the design is a coroutine, NCR5380_main,
168 * which is started when not running by the interrupt handler,
169 * timer, and queue command function. It attempts to establish
170 * I_T_L or I_T_L_Q nexuses by removing the commands from the
171 * issue queue and calling NCR5380_select() if a nexus
172 * is not established.
173 *
174 * Once a nexus is established, the NCR5380_information_transfer()
175 * phase goes through the various phases as instructed by the target.
176 * if the target goes into MSG IN and sends a DISCONNECT message,
177 * the command structure is placed into the per instance disconnected
178 * queue, and NCR5380_main tries to find more work. If USLEEP
179 * was defined, and the target is idle for too long, the system
180 * will try to sleep.
181 *
182 * If a command has disconnected, eventually an interrupt will trigger,
183 * calling NCR5380_intr() which will in turn call NCR5380_reselect
184 * to reestablish a nexus. This will run main if necessary.
185 *
186 * On command termination, the done function will be called as
187 * appropriate.
188 *
189 * SCSI pointers are maintained in the SCp field of SCSI command
190 * structures, being initialized after the command is connected
191 * in NCR5380_select, and set as appropriate in NCR5380_information_transfer.
192 * Note that in violation of the standard, an implicit SAVE POINTERS operation
193 * is done, since some BROKEN disks fail to issue an explicit SAVE POINTERS.
194 */
195
196/*
197 * Using this file :
198 * This file a skeleton Linux SCSI driver for the NCR 5380 series
199 * of chips. To use it, you write an architecture specific functions
200 * and macros and include this file in your driver.
201 *
202 * These macros control options :
203 * AUTOSENSE - if defined, REQUEST SENSE will be performed automatically
204 * for commands that return with a CHECK CONDITION status.
205 *
206 * LINKED - if defined, linked commands are supported.
207 *
208 * REAL_DMA - if defined, REAL DMA is used during the data transfer phases.
209 *
210 * SUPPORT_TAGS - if defined, SCSI-2 tagged queuing is used where possible
211 *
212 * These macros MUST be defined :
213 *
214 * NCR5380_read(register) - read from the specified register
215 *
216 * NCR5380_write(register, value) - write to the specific register
217 *
218 * Either real DMA *or* pseudo DMA may be implemented
219 * REAL functions :
220 * NCR5380_REAL_DMA should be defined if real DMA is to be used.
221 * Note that the DMA setup functions should return the number of bytes
222 * that they were able to program the controller for.
223 *
224 * Also note that generic i386/PC versions of these macros are
225 * available as NCR5380_i386_dma_write_setup,
226 * NCR5380_i386_dma_read_setup, and NCR5380_i386_dma_residual.
227 *
228 * NCR5380_dma_write_setup(instance, src, count) - initialize
229 * NCR5380_dma_read_setup(instance, dst, count) - initialize
230 * NCR5380_dma_residual(instance); - residual count
231 *
232 * PSEUDO functions :
233 * NCR5380_pwrite(instance, src, count)
234 * NCR5380_pread(instance, dst, count);
235 *
236 * If nothing specific to this implementation needs doing (ie, with external
237 * hardware), you must also define
238 *
239 * NCR5380_queue_command
240 * NCR5380_reset
241 * NCR5380_abort
242 * NCR5380_proc_info
243 *
244 * to be the global entry points into the specific driver, ie
245 * #define NCR5380_queue_command t128_queue_command.
246 *
247 * If this is not done, the routines will be defined as static functions
248 * with the NCR5380* names and the user must provide a globally
249 * accessible wrapper function.
250 *
251 * The generic driver is initialized by calling NCR5380_init(instance),
252 * after setting the appropriate host specific fields and ID. If the
253 * driver wishes to autoprobe for an IRQ line, the NCR5380_probe_irq(instance,
254 * possible) function may be used. Before the specific driver initialization
255 * code finishes, NCR5380_print_options should be called.
256 */
257
258static struct Scsi_Host *first_instance = NULL;
259static Scsi_Host_Template *the_template = NULL;
260
261/* Macros ease life... :-) */
262#define SETUP_HOSTDATA(in) \
263 struct NCR5380_hostdata *hostdata = \
264 (struct NCR5380_hostdata *)(in)->hostdata
265#define HOSTDATA(in) ((struct NCR5380_hostdata *)(in)->hostdata)
266
267#define NEXT(cmd) ((Scsi_Cmnd *)((cmd)->host_scribble))
268#define NEXTADDR(cmd) ((Scsi_Cmnd **)&((cmd)->host_scribble))
269
270#define HOSTNO instance->host_no
271#define H_NO(cmd) (cmd)->device->host->host_no
272
273#define SGADDR(buffer) (void *)(((unsigned long)page_address((buffer)->page)) + \
274 (buffer)->offset)
275
276#ifdef SUPPORT_TAGS
277
278/*
279 * Functions for handling tagged queuing
280 * =====================================
281 *
282 * ++roman (01/96): Now I've implemented SCSI-2 tagged queuing. Some notes:
283 *
284 * Using consecutive numbers for the tags is no good idea in my eyes. There
285 * could be wrong re-usings if the counter (8 bit!) wraps and some early
286 * command has been preempted for a long time. My solution: a bitfield for
287 * remembering used tags.
288 *
289 * There's also the problem that each target has a certain queue size, but we
290 * cannot know it in advance :-( We just see a QUEUE_FULL status being
291 * returned. So, in this case, the driver internal queue size assumption is
292 * reduced to the number of active tags if QUEUE_FULL is returned by the
293 * target. The command is returned to the mid-level, but with status changed
294 * to BUSY, since --as I've seen-- the mid-level can't handle QUEUE_FULL
295 * correctly.
296 *
297 * We're also not allowed running tagged commands as long as an untagged
298 * command is active. And REQUEST SENSE commands after a contingent allegiance
299 * condition _must_ be untagged. To keep track whether an untagged command has
300 * been issued, the host->busy array is still employed, as it is without
301 * support for tagged queuing.
302 *
303 * One could suspect that there are possible race conditions between
304 * is_lun_busy(), cmd_get_tag() and cmd_free_tag(). But I think this isn't the
305 * case: is_lun_busy() and cmd_get_tag() are both called from NCR5380_main(),
306 * which already guaranteed to be running at most once. It is also the only
307 * place where tags/LUNs are allocated. So no other allocation can slip
308 * between that pair, there could only happen a reselection, which can free a
309 * tag, but that doesn't hurt. Only the sequence in cmd_free_tag() becomes
310 * important: the tag bit must be cleared before 'nr_allocated' is decreased.
311 */
312
313/* -1 for TAG_NONE is not possible with unsigned char cmd->tag */
314#undef TAG_NONE
315#define TAG_NONE 0xff
316
317/* For the m68k, the number of bits in 'allocated' must be a multiple of 32! */
318#if (MAX_TAGS % 32) != 0
319#error "MAX_TAGS must be a multiple of 32!"
320#endif
321
322typedef struct {
323 char allocated[MAX_TAGS/8];
324 int nr_allocated;
325 int queue_size;
326} TAG_ALLOC;
327
328static TAG_ALLOC TagAlloc[8][8]; /* 8 targets and 8 LUNs */
329
330
331static void __init init_tags( void )
332{
333 int target, lun;
334 TAG_ALLOC *ta;
335
336 if (!setup_use_tagged_queuing)
337 return;
338
339 for( target = 0; target < 8; ++target ) {
340 for( lun = 0; lun < 8; ++lun ) {
341 ta = &TagAlloc[target][lun];
342 memset( &ta->allocated, 0, MAX_TAGS/8 );
343 ta->nr_allocated = 0;
344 /* At the beginning, assume the maximum queue size we could
345 * support (MAX_TAGS). This value will be decreased if the target
346 * returns QUEUE_FULL status.
347 */
348 ta->queue_size = MAX_TAGS;
349 }
350 }
351}
352
353
354/* Check if we can issue a command to this LUN: First see if the LUN is marked
355 * busy by an untagged command. If the command should use tagged queuing, also
356 * check that there is a free tag and the target's queue won't overflow. This
357 * function should be called with interrupts disabled to avoid race
358 * conditions.
359 */
360
361static int is_lun_busy( Scsi_Cmnd *cmd, int should_be_tagged )
362{
363 SETUP_HOSTDATA(cmd->device->host);
364
365 if (hostdata->busy[cmd->device->id] & (1 << cmd->device->lun))
366 return( 1 );
367 if (!should_be_tagged ||
368 !setup_use_tagged_queuing || !cmd->device->tagged_supported)
369 return( 0 );
370 if (TagAlloc[cmd->device->id][cmd->device->lun].nr_allocated >=
371 TagAlloc[cmd->device->id][cmd->device->lun].queue_size ) {
372 TAG_PRINTK( "scsi%d: target %d lun %d: no free tags\n",
373 H_NO(cmd), cmd->device->id, cmd->device->lun );
374 return( 1 );
375 }
376 return( 0 );
377}
378
379
380/* Allocate a tag for a command (there are no checks anymore, check_lun_busy()
381 * must be called before!), or reserve the LUN in 'busy' if the command is
382 * untagged.
383 */
384
385static void cmd_get_tag( Scsi_Cmnd *cmd, int should_be_tagged )
386{
387 SETUP_HOSTDATA(cmd->device->host);
388
389 /* If we or the target don't support tagged queuing, allocate the LUN for
390 * an untagged command.
391 */
392 if (!should_be_tagged ||
393 !setup_use_tagged_queuing || !cmd->device->tagged_supported) {
394 cmd->tag = TAG_NONE;
395 hostdata->busy[cmd->device->id] |= (1 << cmd->device->lun);
396 TAG_PRINTK( "scsi%d: target %d lun %d now allocated by untagged "
397 "command\n", H_NO(cmd), cmd->device->id, cmd->device->lun );
398 }
399 else {
400 TAG_ALLOC *ta = &TagAlloc[cmd->device->id][cmd->device->lun];
401
402 cmd->tag = find_first_zero_bit( &ta->allocated, MAX_TAGS );
403 set_bit( cmd->tag, &ta->allocated );
404 ta->nr_allocated++;
405 TAG_PRINTK( "scsi%d: using tag %d for target %d lun %d "
406 "(now %d tags in use)\n",
407 H_NO(cmd), cmd->tag, cmd->device->id, cmd->device->lun,
408 ta->nr_allocated );
409 }
410}
411
412
413/* Mark the tag of command 'cmd' as free, or in case of an untagged command,
414 * unlock the LUN.
415 */
416
417static void cmd_free_tag( Scsi_Cmnd *cmd )
418{
419 SETUP_HOSTDATA(cmd->device->host);
420
421 if (cmd->tag == TAG_NONE) {
422 hostdata->busy[cmd->device->id] &= ~(1 << cmd->device->lun);
423 TAG_PRINTK( "scsi%d: target %d lun %d untagged cmd finished\n",
424 H_NO(cmd), cmd->device->id, cmd->device->lun );
425 }
426 else if (cmd->tag >= MAX_TAGS) {
427 printk(KERN_NOTICE "scsi%d: trying to free bad tag %d!\n",
428 H_NO(cmd), cmd->tag );
429 }
430 else {
431 TAG_ALLOC *ta = &TagAlloc[cmd->device->id][cmd->device->lun];
432 clear_bit( cmd->tag, &ta->allocated );
433 ta->nr_allocated--;
434 TAG_PRINTK( "scsi%d: freed tag %d for target %d lun %d\n",
435 H_NO(cmd), cmd->tag, cmd->device->id, cmd->device->lun );
436 }
437}
438
439
440static void free_all_tags( void )
441{
442 int target, lun;
443 TAG_ALLOC *ta;
444
445 if (!setup_use_tagged_queuing)
446 return;
447
448 for( target = 0; target < 8; ++target ) {
449 for( lun = 0; lun < 8; ++lun ) {
450 ta = &TagAlloc[target][lun];
451 memset( &ta->allocated, 0, MAX_TAGS/8 );
452 ta->nr_allocated = 0;
453 }
454 }
455}
456
457#endif /* SUPPORT_TAGS */
458
459
460/*
461 * Function: void merge_contiguous_buffers( Scsi_Cmnd *cmd )
462 *
463 * Purpose: Try to merge several scatter-gather requests into one DMA
464 * transfer. This is possible if the scatter buffers lie on
465 * physical contiguous addresses.
466 *
467 * Parameters: Scsi_Cmnd *cmd
468 * The command to work on. The first scatter buffer's data are
469 * assumed to be already transfered into ptr/this_residual.
470 */
471
472static void merge_contiguous_buffers( Scsi_Cmnd *cmd )
473{
474 unsigned long endaddr;
475#if (NDEBUG & NDEBUG_MERGING)
476 unsigned long oldlen = cmd->SCp.this_residual;
477 int cnt = 1;
478#endif
479
480 for (endaddr = virt_to_phys(cmd->SCp.ptr + cmd->SCp.this_residual - 1) + 1;
481 cmd->SCp.buffers_residual &&
482 virt_to_phys(SGADDR(&(cmd->SCp.buffer[1]))) == endaddr; ) {
483
484 MER_PRINTK("VTOP(%p) == %08lx -> merging\n",
485 SGADDR(&(cmd->SCp.buffer[1])), endaddr);
486#if (NDEBUG & NDEBUG_MERGING)
487 ++cnt;
488#endif
489 ++cmd->SCp.buffer;
490 --cmd->SCp.buffers_residual;
491 cmd->SCp.this_residual += cmd->SCp.buffer->length;
492 endaddr += cmd->SCp.buffer->length;
493 }
494#if (NDEBUG & NDEBUG_MERGING)
495 if (oldlen != cmd->SCp.this_residual)
496 MER_PRINTK("merged %d buffers from %p, new length %08x\n",
497 cnt, cmd->SCp.ptr, cmd->SCp.this_residual);
498#endif
499}
500
501/*
502 * Function : void initialize_SCp(Scsi_Cmnd *cmd)
503 *
504 * Purpose : initialize the saved data pointers for cmd to point to the
505 * start of the buffer.
506 *
507 * Inputs : cmd - Scsi_Cmnd structure to have pointers reset.
508 */
509
510static __inline__ void initialize_SCp(Scsi_Cmnd *cmd)
511{
512 /*
513 * Initialize the Scsi Pointer field so that all of the commands in the
514 * various queues are valid.
515 */
516
517 if (cmd->use_sg) {
518 cmd->SCp.buffer = (struct scatterlist *) cmd->buffer;
519 cmd->SCp.buffers_residual = cmd->use_sg - 1;
520 cmd->SCp.ptr = (char *) SGADDR(cmd->SCp.buffer);
521 cmd->SCp.this_residual = cmd->SCp.buffer->length;
522
523 /* ++roman: Try to merge some scatter-buffers if they are at
524 * contiguous physical addresses.
525 */
526// merge_contiguous_buffers( cmd );
527 } else {
528 cmd->SCp.buffer = NULL;
529 cmd->SCp.buffers_residual = 0;
530 cmd->SCp.ptr = (char *) cmd->request_buffer;
531 cmd->SCp.this_residual = cmd->request_bufflen;
532 }
533
534}
535
536#include <linux/config.h>
537#include <linux/delay.h>
538
539#if 1
540static struct {
541 unsigned char mask;
542 const char * name;}
543signals[] = {{ SR_DBP, "PARITY"}, { SR_RST, "RST" }, { SR_BSY, "BSY" },
544 { SR_REQ, "REQ" }, { SR_MSG, "MSG" }, { SR_CD, "CD" }, { SR_IO, "IO" },
545 { SR_SEL, "SEL" }, {0, NULL}},
546basrs[] = {{BASR_ATN, "ATN"}, {BASR_ACK, "ACK"}, {0, NULL}},
547icrs[] = {{ICR_ASSERT_RST, "ASSERT RST"},{ICR_ASSERT_ACK, "ASSERT ACK"},
548 {ICR_ASSERT_BSY, "ASSERT BSY"}, {ICR_ASSERT_SEL, "ASSERT SEL"},
549 {ICR_ASSERT_ATN, "ASSERT ATN"}, {ICR_ASSERT_DATA, "ASSERT DATA"},
550 {0, NULL}},
551mrs[] = {{MR_BLOCK_DMA_MODE, "MODE BLOCK DMA"}, {MR_TARGET, "MODE TARGET"},
552 {MR_ENABLE_PAR_CHECK, "MODE PARITY CHECK"}, {MR_ENABLE_PAR_INTR,
553 "MODE PARITY INTR"}, {MR_ENABLE_EOP_INTR,"MODE EOP INTR"},
554 {MR_MONITOR_BSY, "MODE MONITOR BSY"},
555 {MR_DMA_MODE, "MODE DMA"}, {MR_ARBITRATE, "MODE ARBITRATION"},
556 {0, NULL}};
557
558/*
559 * Function : void NCR5380_print(struct Scsi_Host *instance)
560 *
561 * Purpose : print the SCSI bus signals for debugging purposes
562 *
563 * Input : instance - which NCR5380
564 */
565
566static void NCR5380_print(struct Scsi_Host *instance) {
567 unsigned char status, data, basr, mr, icr, i;
568 unsigned long flags;
569
570 local_irq_save(flags);
571 data = NCR5380_read(CURRENT_SCSI_DATA_REG);
572 status = NCR5380_read(STATUS_REG);
573 mr = NCR5380_read(MODE_REG);
574 icr = NCR5380_read(INITIATOR_COMMAND_REG);
575 basr = NCR5380_read(BUS_AND_STATUS_REG);
576 local_irq_restore(flags);
577 printk("STATUS_REG: %02x ", status);
578 for (i = 0; signals[i].mask ; ++i)
579 if (status & signals[i].mask)
580 printk(",%s", signals[i].name);
581 printk("\nBASR: %02x ", basr);
582 for (i = 0; basrs[i].mask ; ++i)
583 if (basr & basrs[i].mask)
584 printk(",%s", basrs[i].name);
585 printk("\nICR: %02x ", icr);
586 for (i = 0; icrs[i].mask; ++i)
587 if (icr & icrs[i].mask)
588 printk(",%s", icrs[i].name);
589 printk("\nMODE: %02x ", mr);
590 for (i = 0; mrs[i].mask; ++i)
591 if (mr & mrs[i].mask)
592 printk(",%s", mrs[i].name);
593 printk("\n");
594}
595
596static struct {
597 unsigned char value;
598 const char *name;
599} phases[] = {
600 {PHASE_DATAOUT, "DATAOUT"}, {PHASE_DATAIN, "DATAIN"}, {PHASE_CMDOUT, "CMDOUT"},
601 {PHASE_STATIN, "STATIN"}, {PHASE_MSGOUT, "MSGOUT"}, {PHASE_MSGIN, "MSGIN"},
602 {PHASE_UNKNOWN, "UNKNOWN"}};
603
604/*
605 * Function : void NCR5380_print_phase(struct Scsi_Host *instance)
606 *
607 * Purpose : print the current SCSI phase for debugging purposes
608 *
609 * Input : instance - which NCR5380
610 */
611
612static void NCR5380_print_phase(struct Scsi_Host *instance)
613{
614 unsigned char status;
615 int i;
616
617 status = NCR5380_read(STATUS_REG);
618 if (!(status & SR_REQ))
619 printk(KERN_DEBUG "scsi%d: REQ not asserted, phase unknown.\n", HOSTNO);
620 else {
621 for (i = 0; (phases[i].value != PHASE_UNKNOWN) &&
622 (phases[i].value != (status & PHASE_MASK)); ++i);
623 printk(KERN_DEBUG "scsi%d: phase %s\n", HOSTNO, phases[i].name);
624 }
625}
626
627#else /* !NDEBUG */
628
629/* dummies... */
630__inline__ void NCR5380_print(struct Scsi_Host *instance) { };
631__inline__ void NCR5380_print_phase(struct Scsi_Host *instance) { };
632
633#endif
634
635/*
636 * ++roman: New scheme of calling NCR5380_main()
637 *
638 * If we're not in an interrupt, we can call our main directly, it cannot be
639 * already running. Else, we queue it on a task queue, if not 'main_running'
640 * tells us that a lower level is already executing it. This way,
641 * 'main_running' needs not be protected in a special way.
642 *
643 * queue_main() is a utility function for putting our main onto the task
644 * queue, if main_running is false. It should be called only from a
645 * interrupt or bottom half.
646 */
647
648#include <linux/workqueue.h>
649#include <linux/interrupt.h>
650
651static volatile int main_running = 0;
652static DECLARE_WORK(NCR5380_tqueue, (void (*)(void*))NCR5380_main, NULL);
653
654static __inline__ void queue_main(void)
655{
656 if (!main_running) {
657 /* If in interrupt and NCR5380_main() not already running,
658 queue it on the 'immediate' task queue, to be processed
659 immediately after the current interrupt processing has
660 finished. */
661 schedule_work(&NCR5380_tqueue);
662 }
663 /* else: nothing to do: the running NCR5380_main() will pick up
664 any newly queued command. */
665}
666
667
668static inline void NCR5380_all_init (void)
669{
670 static int done = 0;
671 if (!done) {
672 INI_PRINTK("scsi : NCR5380_all_init()\n");
673 done = 1;
674 }
675}
676
677
678/*
679 * Function : void NCR58380_print_options (struct Scsi_Host *instance)
680 *
681 * Purpose : called by probe code indicating the NCR5380 driver
682 * options that were selected.
683 *
684 * Inputs : instance, pointer to this instance. Unused.
685 */
686
687static void __init NCR5380_print_options (struct Scsi_Host *instance)
688{
689 printk(" generic options"
690#ifdef AUTOSENSE
691 " AUTOSENSE"
692#endif
693#ifdef REAL_DMA
694 " REAL DMA"
695#endif
696#ifdef PARITY
697 " PARITY"
698#endif
699#ifdef SUPPORT_TAGS
700 " SCSI-2 TAGGED QUEUING"
701#endif
702 );
703 printk(" generic release=%d", NCR5380_PUBLIC_RELEASE);
704}
705
706/*
707 * Function : void NCR5380_print_status (struct Scsi_Host *instance)
708 *
709 * Purpose : print commands in the various queues, called from
710 * NCR5380_abort and NCR5380_debug to aid debugging.
711 *
712 * Inputs : instance, pointer to this instance.
713 */
714
715static void NCR5380_print_status (struct Scsi_Host *instance)
716{
717 char *pr_bfr;
718 char *start;
719 int len;
720
721 NCR_PRINT(NDEBUG_ANY);
722 NCR_PRINT_PHASE(NDEBUG_ANY);
723
724 pr_bfr = (char *) __get_free_page(GFP_ATOMIC);
725 if (!pr_bfr) {
726 printk("NCR5380_print_status: no memory for print buffer\n");
727 return;
728 }
729 len = NCR5380_proc_info(instance, pr_bfr, &start, 0, PAGE_SIZE, 0);
730 pr_bfr[len] = 0;
731 printk("\n%s\n", pr_bfr);
732 free_page((unsigned long) pr_bfr);
733}
734
735
736/******************************************/
737/*
738 * /proc/scsi/[dtc pas16 t128 generic]/[0-ASC_NUM_BOARD_SUPPORTED]
739 *
740 * *buffer: I/O buffer
741 * **start: if inout == FALSE pointer into buffer where user read should start
742 * offset: current offset
743 * length: length of buffer
744 * hostno: Scsi_Host host_no
745 * inout: TRUE - user is writing; FALSE - user is reading
746 *
747 * Return the number of bytes read from or written
748*/
749
750#undef SPRINTF
751#define SPRINTF(fmt,args...) \
752 do { if (pos + strlen(fmt) + 20 /* slop */ < buffer + length) \
753 pos += sprintf(pos, fmt , ## args); } while(0)
754static
755char *lprint_Scsi_Cmnd (Scsi_Cmnd *cmd, char *pos, char *buffer, int length);
756
757static int NCR5380_proc_info (struct Scsi_Host *instance, char *buffer, char **start,
758 off_t offset, int length, int inout)
759{
760 char *pos = buffer;
761 struct NCR5380_hostdata *hostdata;
762 Scsi_Cmnd *ptr;
763 unsigned long flags;
764 off_t begin = 0;
765#define check_offset() \
766 do { \
767 if (pos - buffer < offset - begin) { \
768 begin += pos - buffer; \
769 pos = buffer; \
770 } \
771 } while (0)
772
773 hostdata = (struct NCR5380_hostdata *)instance->hostdata;
774
775 if (inout) { /* Has data been written to the file ? */
776 return(-ENOSYS); /* Currently this is a no-op */
777 }
778 SPRINTF("NCR5380 core release=%d.\n", NCR5380_PUBLIC_RELEASE);
779 check_offset();
780 local_irq_save(flags);
781 SPRINTF("NCR5380: coroutine is%s running.\n", main_running ? "" : "n't");
782 check_offset();
783 if (!hostdata->connected)
784 SPRINTF("scsi%d: no currently connected command\n", HOSTNO);
785 else
786 pos = lprint_Scsi_Cmnd ((Scsi_Cmnd *) hostdata->connected,
787 pos, buffer, length);
788 SPRINTF("scsi%d: issue_queue\n", HOSTNO);
789 check_offset();
790 for (ptr = (Scsi_Cmnd *) hostdata->issue_queue; ptr; ptr = NEXT(ptr)) {
791 pos = lprint_Scsi_Cmnd (ptr, pos, buffer, length);
792 check_offset();
793 }
794
795 SPRINTF("scsi%d: disconnected_queue\n", HOSTNO);
796 check_offset();
797 for (ptr = (Scsi_Cmnd *) hostdata->disconnected_queue; ptr;
798 ptr = NEXT(ptr)) {
799 pos = lprint_Scsi_Cmnd (ptr, pos, buffer, length);
800 check_offset();
801 }
802
803 local_irq_restore(flags);
804 *start = buffer + (offset - begin);
805 if (pos - buffer < offset - begin)
806 return 0;
807 else if (pos - buffer - (offset - begin) < length)
808 return pos - buffer - (offset - begin);
809 return length;
810}
811
812static char *
813lprint_Scsi_Cmnd (Scsi_Cmnd *cmd, char *pos, char *buffer, int length)
814{
815 int i, s;
816 unsigned char *command;
817 SPRINTF("scsi%d: destination target %d, lun %d\n",
818 H_NO(cmd), cmd->device->id, cmd->device->lun);
819 SPRINTF(" command = ");
820 command = cmd->cmnd;
821 SPRINTF("%2d (0x%02x)", command[0], command[0]);
822 for (i = 1, s = COMMAND_SIZE(command[0]); i < s; ++i)
823 SPRINTF(" %02x", command[i]);
824 SPRINTF("\n");
825 return pos;
826}
827
828
829/*
830 * Function : void NCR5380_init (struct Scsi_Host *instance)
831 *
832 * Purpose : initializes *instance and corresponding 5380 chip.
833 *
834 * Inputs : instance - instantiation of the 5380 driver.
835 *
836 * Notes : I assume that the host, hostno, and id bits have been
837 * set correctly. I don't care about the irq and other fields.
838 *
839 */
840
841static int NCR5380_init (struct Scsi_Host *instance, int flags)
842{
843 int i;
844 SETUP_HOSTDATA(instance);
845
846 NCR5380_all_init();
847
848 hostdata->aborted = 0;
849 hostdata->id_mask = 1 << instance->this_id;
850 hostdata->id_higher_mask = 0;
851 for (i = hostdata->id_mask; i <= 0x80; i <<= 1)
852 if (i > hostdata->id_mask)
853 hostdata->id_higher_mask |= i;
854 for (i = 0; i < 8; ++i)
855 hostdata->busy[i] = 0;
856#ifdef SUPPORT_TAGS
857 init_tags();
858#endif
859#if defined (REAL_DMA)
860 hostdata->dma_len = 0;
861#endif
862 hostdata->targets_present = 0;
863 hostdata->connected = NULL;
864 hostdata->issue_queue = NULL;
865 hostdata->disconnected_queue = NULL;
866 hostdata->flags = FLAG_CHECK_LAST_BYTE_SENT;
867
868 if (!the_template) {
869 the_template = instance->hostt;
870 first_instance = instance;
871 }
872
873
874#ifndef AUTOSENSE
875 if ((instance->cmd_per_lun > 1) || (instance->can_queue > 1))
876 printk("scsi%d: WARNING : support for multiple outstanding commands enabled\n"
877 " without AUTOSENSE option, contingent allegiance conditions may\n"
878 " be incorrectly cleared.\n", HOSTNO);
879#endif /* def AUTOSENSE */
880
881 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
882 NCR5380_write(MODE_REG, MR_BASE);
883 NCR5380_write(TARGET_COMMAND_REG, 0);
884 NCR5380_write(SELECT_ENABLE_REG, 0);
885
886 return 0;
887}
888
889/*
890 * Function : int NCR5380_queue_command (Scsi_Cmnd *cmd,
891 * void (*done)(Scsi_Cmnd *))
892 *
893 * Purpose : enqueues a SCSI command
894 *
895 * Inputs : cmd - SCSI command, done - function called on completion, with
896 * a pointer to the command descriptor.
897 *
898 * Returns : 0
899 *
900 * Side effects :
901 * cmd is added to the per instance issue_queue, with minor
902 * twiddling done to the host specific fields of cmd. If the
903 * main coroutine is not running, it is restarted.
904 *
905 */
906
907/* Only make static if a wrapper function is used */
908static int NCR5380_queue_command (Scsi_Cmnd *cmd, void (*done)(Scsi_Cmnd *))
909{
910 SETUP_HOSTDATA(cmd->device->host);
911 Scsi_Cmnd *tmp;
912 unsigned long flags;
913
914#if (NDEBUG & NDEBUG_NO_WRITE)
915 switch (cmd->cmnd[0]) {
916 case WRITE_6:
917 case WRITE_10:
918 printk(KERN_NOTICE "scsi%d: WRITE attempted with NO_WRITE debugging flag set\n",
919 H_NO(cmd));
920 cmd->result = (DID_ERROR << 16);
921 done(cmd);
922 return 0;
923 }
924#endif /* (NDEBUG & NDEBUG_NO_WRITE) */
925
926
927#ifdef NCR5380_STATS
928# if 0
929 if (!hostdata->connected && !hostdata->issue_queue &&
930 !hostdata->disconnected_queue) {
931 hostdata->timebase = jiffies;
932 }
933# endif
934# ifdef NCR5380_STAT_LIMIT
935 if (cmd->request_bufflen > NCR5380_STAT_LIMIT)
936# endif
937 switch (cmd->cmnd[0])
938 {
939 case WRITE:
940 case WRITE_6:
941 case WRITE_10:
942 hostdata->time_write[cmd->device->id] -= (jiffies - hostdata->timebase);
943 hostdata->bytes_write[cmd->device->id] += cmd->request_bufflen;
944 hostdata->pendingw++;
945 break;
946 case READ:
947 case READ_6:
948 case READ_10:
949 hostdata->time_read[cmd->device->id] -= (jiffies - hostdata->timebase);
950 hostdata->bytes_read[cmd->device->id] += cmd->request_bufflen;
951 hostdata->pendingr++;
952 break;
953 }
954#endif
955
956 /*
957 * We use the host_scribble field as a pointer to the next command
958 * in a queue
959 */
960
961 NEXT(cmd) = NULL;
962 cmd->scsi_done = done;
963
964 cmd->result = 0;
965
966
967 /*
968 * Insert the cmd into the issue queue. Note that REQUEST SENSE
969 * commands are added to the head of the queue since any command will
970 * clear the contingent allegiance condition that exists and the
971 * sense data is only guaranteed to be valid while the condition exists.
972 */
973
974 local_irq_save(flags);
975 /* ++guenther: now that the issue queue is being set up, we can lock ST-DMA.
976 * Otherwise a running NCR5380_main may steal the lock.
977 * Lock before actually inserting due to fairness reasons explained in
978 * atari_scsi.c. If we insert first, then it's impossible for this driver
979 * to release the lock.
980 * Stop timer for this command while waiting for the lock, or timeouts
981 * may happen (and they really do), and it's no good if the command doesn't
982 * appear in any of the queues.
983 * ++roman: Just disabling the NCR interrupt isn't sufficient here,
984 * because also a timer int can trigger an abort or reset, which would
985 * alter queues and touch the lock.
986 */
987 if (!(hostdata->issue_queue) || (cmd->cmnd[0] == REQUEST_SENSE)) {
988 LIST(cmd, hostdata->issue_queue);
989 NEXT(cmd) = hostdata->issue_queue;
990 hostdata->issue_queue = cmd;
991 } else {
992 for (tmp = (Scsi_Cmnd *)hostdata->issue_queue;
993 NEXT(tmp); tmp = NEXT(tmp))
994 ;
995 LIST(cmd, tmp);
996 NEXT(tmp) = cmd;
997 }
998
999 local_irq_restore(flags);
1000
1001 QU_PRINTK("scsi%d: command added to %s of queue\n", H_NO(cmd),
1002 (cmd->cmnd[0] == REQUEST_SENSE) ? "head" : "tail");
1003
1004 /* If queue_command() is called from an interrupt (real one or bottom
1005 * half), we let queue_main() do the job of taking care about main. If it
1006 * is already running, this is a no-op, else main will be queued.
1007 *
1008 * If we're not in an interrupt, we can call NCR5380_main()
1009 * unconditionally, because it cannot be already running.
1010 */
1011 if (in_interrupt() || ((flags >> 8) & 7) >= 6)
1012 queue_main();
1013 else
1014 NCR5380_main(NULL);
1015 return 0;
1016}
1017
1018/*
1019 * Function : NCR5380_main (void)
1020 *
1021 * Purpose : NCR5380_main is a coroutine that runs as long as more work can
1022 * be done on the NCR5380 host adapters in a system. Both
1023 * NCR5380_queue_command() and NCR5380_intr() will try to start it
1024 * in case it is not running.
1025 *
1026 * NOTE : NCR5380_main exits with interrupts *disabled*, the caller should
1027 * reenable them. This prevents reentrancy and kernel stack overflow.
1028 */
1029
1030static void NCR5380_main (void *bl)
1031{
1032 Scsi_Cmnd *tmp, *prev;
1033 struct Scsi_Host *instance = first_instance;
1034 struct NCR5380_hostdata *hostdata = HOSTDATA(instance);
1035 int done;
1036 unsigned long flags;
1037
1038 /*
1039 * We run (with interrupts disabled) until we're sure that none of
1040 * the host adapters have anything that can be done, at which point
1041 * we set main_running to 0 and exit.
1042 *
1043 * Interrupts are enabled before doing various other internal
1044 * instructions, after we've decided that we need to run through
1045 * the loop again.
1046 *
1047 * this should prevent any race conditions.
1048 *
1049 * ++roman: Just disabling the NCR interrupt isn't sufficient here,
1050 * because also a timer int can trigger an abort or reset, which can
1051 * alter queues and touch the Falcon lock.
1052 */
1053
1054 /* Tell int handlers main() is now already executing. Note that
1055 no races are possible here. If an int comes in before
1056 'main_running' is set here, and queues/executes main via the
1057 task queue, it doesn't do any harm, just this instance of main
1058 won't find any work left to do. */
1059 if (main_running)
1060 return;
1061 main_running = 1;
1062
1063 local_save_flags(flags);
1064 do {
1065 local_irq_disable(); /* Freeze request queues */
1066 done = 1;
1067
1068 if (!hostdata->connected) {
1069 MAIN_PRINTK( "scsi%d: not connected\n", HOSTNO );
1070 /*
1071 * Search through the issue_queue for a command destined
1072 * for a target that's not busy.
1073 */
1074#if (NDEBUG & NDEBUG_LISTS)
1075 for (tmp = (Scsi_Cmnd *) hostdata->issue_queue, prev = NULL;
1076 tmp && (tmp != prev); prev = tmp, tmp = NEXT(tmp))
1077 ;
1078 if ((tmp == prev) && tmp) printk(" LOOP\n");/* else printk("\n");*/
1079#endif
1080 for (tmp = (Scsi_Cmnd *) hostdata->issue_queue,
1081 prev = NULL; tmp; prev = tmp, tmp = NEXT(tmp) ) {
1082
1083#if (NDEBUG & NDEBUG_LISTS)
1084 if (prev != tmp)
1085 printk("MAIN tmp=%p target=%d busy=%d lun=%d\n",
1086 tmp, tmp->target, hostdata->busy[tmp->target],
1087 tmp->lun);
1088#endif
1089 /* When we find one, remove it from the issue queue. */
1090 /* ++guenther: possible race with Falcon locking */
1091 if (
1092#ifdef SUPPORT_TAGS
1093 !is_lun_busy( tmp, tmp->cmnd[0] != REQUEST_SENSE)
1094#else
1095 !(hostdata->busy[tmp->device->id] & (1 << tmp->device->lun))
1096#endif
1097 ) {
1098 /* ++guenther: just to be sure, this must be atomic */
1099 local_irq_disable();
1100 if (prev) {
1101 REMOVE(prev, NEXT(prev), tmp, NEXT(tmp));
1102 NEXT(prev) = NEXT(tmp);
1103 } else {
1104 REMOVE(-1, hostdata->issue_queue, tmp, NEXT(tmp));
1105 hostdata->issue_queue = NEXT(tmp);
1106 }
1107 NEXT(tmp) = NULL;
1108
1109 /* reenable interrupts after finding one */
1110 local_irq_restore(flags);
1111
1112 /*
1113 * Attempt to establish an I_T_L nexus here.
1114 * On success, instance->hostdata->connected is set.
1115 * On failure, we must add the command back to the
1116 * issue queue so we can keep trying.
1117 */
1118 MAIN_PRINTK("scsi%d: main(): command for target %d "
1119 "lun %d removed from issue_queue\n",
1120 HOSTNO, tmp->target, tmp->lun);
1121 /*
1122 * REQUEST SENSE commands are issued without tagged
1123 * queueing, even on SCSI-II devices because the
1124 * contingent allegiance condition exists for the
1125 * entire unit.
1126 */
1127 /* ++roman: ...and the standard also requires that
1128 * REQUEST SENSE command are untagged.
1129 */
1130
1131#ifdef SUPPORT_TAGS
1132 cmd_get_tag( tmp, tmp->cmnd[0] != REQUEST_SENSE );
1133#endif
1134 if (!NCR5380_select(instance, tmp,
1135 (tmp->cmnd[0] == REQUEST_SENSE) ? TAG_NONE :
1136 TAG_NEXT)) {
1137 break;
1138 } else {
1139 local_irq_disable();
1140 LIST(tmp, hostdata->issue_queue);
1141 NEXT(tmp) = hostdata->issue_queue;
1142 hostdata->issue_queue = tmp;
1143#ifdef SUPPORT_TAGS
1144 cmd_free_tag( tmp );
1145#endif
1146 local_irq_restore(flags);
1147 MAIN_PRINTK("scsi%d: main(): select() failed, "
1148 "returned to issue_queue\n", HOSTNO);
1149 if (hostdata->connected)
1150 break;
1151 }
1152 } /* if target/lun/target queue is not busy */
1153 } /* for issue_queue */
1154 } /* if (!hostdata->connected) */
1155 if (hostdata->connected
1156#ifdef REAL_DMA
1157 && !hostdata->dma_len
1158#endif
1159 ) {
1160 local_irq_restore(flags);
1161 MAIN_PRINTK("scsi%d: main: performing information transfer\n",
1162 HOSTNO);
1163 NCR5380_information_transfer(instance);
1164 MAIN_PRINTK("scsi%d: main: done set false\n", HOSTNO);
1165 done = 0;
1166 }
1167 } while (!done);
1168
1169 /* Better allow ints _after_ 'main_running' has been cleared, else
1170 an interrupt could believe we'll pick up the work it left for
1171 us, but we won't see it anymore here... */
1172 main_running = 0;
1173 local_irq_restore(flags);
1174}
1175
1176
1177#ifdef REAL_DMA
1178/*
1179 * Function : void NCR5380_dma_complete (struct Scsi_Host *instance)
1180 *
1181 * Purpose : Called by interrupt handler when DMA finishes or a phase
1182 * mismatch occurs (which would finish the DMA transfer).
1183 *
1184 * Inputs : instance - this instance of the NCR5380.
1185 *
1186 */
1187
1188static void NCR5380_dma_complete( struct Scsi_Host *instance )
1189{
1190 SETUP_HOSTDATA(instance);
1191 int transfered;
1192 unsigned char **data;
1193 volatile int *count;
1194
1195 if (!hostdata->connected) {
1196 printk(KERN_WARNING "scsi%d: received end of DMA interrupt with "
1197 "no connected cmd\n", HOSTNO);
1198 return;
1199 }
1200
1201 DMA_PRINTK("scsi%d: real DMA transfer complete, basr 0x%X, sr 0x%X\n",
1202 HOSTNO, NCR5380_read(BUS_AND_STATUS_REG),
1203 NCR5380_read(STATUS_REG));
1204
1205 if((sun3scsi_dma_finish(rq_data_dir(hostdata->connected->request)))) {
1206 printk("scsi%d: overrun in UDC counter -- not prepared to deal with this!\n", HOSTNO);
1207 printk("please e-mail sammy@sammy.net with a description of how this\n");
1208 printk("error was produced.\n");
1209 BUG();
1210 }
1211
1212 /* make sure we're not stuck in a data phase */
1213 if((NCR5380_read(BUS_AND_STATUS_REG) & (BASR_PHASE_MATCH |
1214 BASR_ACK)) ==
1215 (BASR_PHASE_MATCH | BASR_ACK)) {
1216 printk("scsi%d: BASR %02x\n", HOSTNO, NCR5380_read(BUS_AND_STATUS_REG));
1217 printk("scsi%d: bus stuck in data phase -- probably a single byte "
1218 "overrun!\n", HOSTNO);
1219 printk("not prepared for this error!\n");
1220 printk("please e-mail sammy@sammy.net with a description of how this\n");
1221 printk("error was produced.\n");
1222 BUG();
1223 }
1224
1225
1226
1227 (void) NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1228 NCR5380_write(MODE_REG, MR_BASE);
1229 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1230
1231 transfered = hostdata->dma_len - NCR5380_dma_residual(instance);
1232 hostdata->dma_len = 0;
1233
1234 data = (unsigned char **) &(hostdata->connected->SCp.ptr);
1235 count = &(hostdata->connected->SCp.this_residual);
1236 *data += transfered;
1237 *count -= transfered;
1238
1239}
1240#endif /* REAL_DMA */
1241
1242
1243/*
1244 * Function : void NCR5380_intr (int irq)
1245 *
1246 * Purpose : handle interrupts, reestablishing I_T_L or I_T_L_Q nexuses
1247 * from the disconnected queue, and restarting NCR5380_main()
1248 * as required.
1249 *
1250 * Inputs : int irq, irq that caused this interrupt.
1251 *
1252 */
1253
1254static irqreturn_t NCR5380_intr (int irq, void *dev_id, struct pt_regs *regs)
1255{
1256 struct Scsi_Host *instance = first_instance;
1257 int done = 1, handled = 0;
1258 unsigned char basr;
1259
1260 INT_PRINTK("scsi%d: NCR5380 irq triggered\n", HOSTNO);
1261
1262 /* Look for pending interrupts */
1263 basr = NCR5380_read(BUS_AND_STATUS_REG);
1264 INT_PRINTK("scsi%d: BASR=%02x\n", HOSTNO, basr);
1265 /* dispatch to appropriate routine if found and done=0 */
1266 if (basr & BASR_IRQ) {
1267 NCR_PRINT(NDEBUG_INTR);
1268 if ((NCR5380_read(STATUS_REG) & (SR_SEL|SR_IO)) == (SR_SEL|SR_IO)) {
1269 done = 0;
1270 ENABLE_IRQ();
1271 INT_PRINTK("scsi%d: SEL interrupt\n", HOSTNO);
1272 NCR5380_reselect(instance);
1273 (void) NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1274 }
1275 else if (basr & BASR_PARITY_ERROR) {
1276 INT_PRINTK("scsi%d: PARITY interrupt\n", HOSTNO);
1277 (void) NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1278 }
1279 else if ((NCR5380_read(STATUS_REG) & SR_RST) == SR_RST) {
1280 INT_PRINTK("scsi%d: RESET interrupt\n", HOSTNO);
1281 (void)NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1282 }
1283 else {
1284 /*
1285 * The rest of the interrupt conditions can occur only during a
1286 * DMA transfer
1287 */
1288
1289#if defined(REAL_DMA)
1290 /*
1291 * We should only get PHASE MISMATCH and EOP interrupts if we have
1292 * DMA enabled, so do a sanity check based on the current setting
1293 * of the MODE register.
1294 */
1295
1296 if ((NCR5380_read(MODE_REG) & MR_DMA_MODE) &&
1297 ((basr & BASR_END_DMA_TRANSFER) ||
1298 !(basr & BASR_PHASE_MATCH))) {
1299
1300 INT_PRINTK("scsi%d: PHASE MISM or EOP interrupt\n", HOSTNO);
1301 NCR5380_dma_complete( instance );
1302 done = 0;
1303 ENABLE_IRQ();
1304 } else
1305#endif /* REAL_DMA */
1306 {
1307/* MS: Ignore unknown phase mismatch interrupts (caused by EOP interrupt) */
1308 if (basr & BASR_PHASE_MATCH)
1309 INT_PRINTK("scsi%d: unknown interrupt, "
1310 "BASR 0x%x, MR 0x%x, SR 0x%x\n",
1311 HOSTNO, basr, NCR5380_read(MODE_REG),
1312 NCR5380_read(STATUS_REG));
1313 (void) NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1314#ifdef SUN3_SCSI_VME
1315 dregs->csr |= CSR_DMA_ENABLE;
1316#endif
1317 }
1318 } /* if !(SELECTION || PARITY) */
1319 handled = 1;
1320 } /* BASR & IRQ */
1321 else {
1322
1323 printk(KERN_NOTICE "scsi%d: interrupt without IRQ bit set in BASR, "
1324 "BASR 0x%X, MR 0x%X, SR 0x%x\n", HOSTNO, basr,
1325 NCR5380_read(MODE_REG), NCR5380_read(STATUS_REG));
1326 (void) NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1327#ifdef SUN3_SCSI_VME
1328 dregs->csr |= CSR_DMA_ENABLE;
1329#endif
1330 }
1331
1332 if (!done) {
1333 INT_PRINTK("scsi%d: in int routine, calling main\n", HOSTNO);
1334 /* Put a call to NCR5380_main() on the queue... */
1335 queue_main();
1336 }
1337 return IRQ_RETVAL(handled);
1338}
1339
1340#ifdef NCR5380_STATS
1341static void collect_stats(struct NCR5380_hostdata* hostdata, Scsi_Cmnd* cmd)
1342{
1343# ifdef NCR5380_STAT_LIMIT
1344 if (cmd->request_bufflen > NCR5380_STAT_LIMIT)
1345# endif
1346 switch (cmd->cmnd[0])
1347 {
1348 case WRITE:
1349 case WRITE_6:
1350 case WRITE_10:
1351 hostdata->time_write[cmd->device->id] += (jiffies - hostdata->timebase);
1352 /*hostdata->bytes_write[cmd->device->id] += cmd->request_bufflen;*/
1353 hostdata->pendingw--;
1354 break;
1355 case READ:
1356 case READ_6:
1357 case READ_10:
1358 hostdata->time_read[cmd->device->id] += (jiffies - hostdata->timebase);
1359 /*hostdata->bytes_read[cmd->device->id] += cmd->request_bufflen;*/
1360 hostdata->pendingr--;
1361 break;
1362 }
1363}
1364#endif
1365
1366/*
1367 * Function : int NCR5380_select (struct Scsi_Host *instance, Scsi_Cmnd *cmd,
1368 * int tag);
1369 *
1370 * Purpose : establishes I_T_L or I_T_L_Q nexus for new or existing command,
1371 * including ARBITRATION, SELECTION, and initial message out for
1372 * IDENTIFY and queue messages.
1373 *
1374 * Inputs : instance - instantiation of the 5380 driver on which this
1375 * target lives, cmd - SCSI command to execute, tag - set to TAG_NEXT for
1376 * new tag, TAG_NONE for untagged queueing, otherwise set to the tag for
1377 * the command that is presently connected.
1378 *
1379 * Returns : -1 if selection could not execute for some reason,
1380 * 0 if selection succeeded or failed because the target
1381 * did not respond.
1382 *
1383 * Side effects :
1384 * If bus busy, arbitration failed, etc, NCR5380_select() will exit
1385 * with registers as they should have been on entry - ie
1386 * SELECT_ENABLE will be set appropriately, the NCR5380
1387 * will cease to drive any SCSI bus signals.
1388 *
1389 * If successful : I_T_L or I_T_L_Q nexus will be established,
1390 * instance->connected will be set to cmd.
1391 * SELECT interrupt will be disabled.
1392 *
1393 * If failed (no target) : cmd->scsi_done() will be called, and the
1394 * cmd->result host byte set to DID_BAD_TARGET.
1395 */
1396
1397static int NCR5380_select (struct Scsi_Host *instance, Scsi_Cmnd *cmd, int tag)
1398{
1399 SETUP_HOSTDATA(instance);
1400 unsigned char tmp[3], phase;
1401 unsigned char *data;
1402 int len;
1403 unsigned long timeout;
1404 unsigned long flags;
1405
1406 hostdata->restart_select = 0;
1407 NCR_PRINT(NDEBUG_ARBITRATION);
1408 ARB_PRINTK("scsi%d: starting arbitration, id = %d\n", HOSTNO,
1409 instance->this_id);
1410
1411 /*
1412 * Set the phase bits to 0, otherwise the NCR5380 won't drive the
1413 * data bus during SELECTION.
1414 */
1415
1416 local_irq_save(flags);
1417 if (hostdata->connected) {
1418 local_irq_restore(flags);
1419 return -1;
1420 }
1421 NCR5380_write(TARGET_COMMAND_REG, 0);
1422
1423
1424 /*
1425 * Start arbitration.
1426 */
1427
1428 NCR5380_write(OUTPUT_DATA_REG, hostdata->id_mask);
1429 NCR5380_write(MODE_REG, MR_ARBITRATE);
1430
1431 local_irq_restore(flags);
1432
1433 /* Wait for arbitration logic to complete */
1434#if NCR_TIMEOUT
1435 {
1436 unsigned long timeout = jiffies + 2*NCR_TIMEOUT;
1437
1438 while (!(NCR5380_read(INITIATOR_COMMAND_REG) & ICR_ARBITRATION_PROGRESS)
1439 && time_before(jiffies, timeout) && !hostdata->connected)
1440 ;
1441 if (time_after_eq(jiffies, timeout))
1442 {
1443 printk("scsi : arbitration timeout at %d\n", __LINE__);
1444 NCR5380_write(MODE_REG, MR_BASE);
1445 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
1446 return -1;
1447 }
1448 }
1449#else /* NCR_TIMEOUT */
1450 while (!(NCR5380_read(INITIATOR_COMMAND_REG) & ICR_ARBITRATION_PROGRESS)
1451 && !hostdata->connected);
1452#endif
1453
1454 ARB_PRINTK("scsi%d: arbitration complete\n", HOSTNO);
1455
1456 if (hostdata->connected) {
1457 NCR5380_write(MODE_REG, MR_BASE);
1458 return -1;
1459 }
1460 /*
1461 * The arbitration delay is 2.2us, but this is a minimum and there is
1462 * no maximum so we can safely sleep for ceil(2.2) usecs to accommodate
1463 * the integral nature of udelay().
1464 *
1465 */
1466
1467 udelay(3);
1468
1469 /* Check for lost arbitration */
1470 if ((NCR5380_read(INITIATOR_COMMAND_REG) & ICR_ARBITRATION_LOST) ||
1471 (NCR5380_read(CURRENT_SCSI_DATA_REG) & hostdata->id_higher_mask) ||
1472 (NCR5380_read(INITIATOR_COMMAND_REG) & ICR_ARBITRATION_LOST) ||
1473 hostdata->connected) {
1474 NCR5380_write(MODE_REG, MR_BASE);
1475 ARB_PRINTK("scsi%d: lost arbitration, deasserting MR_ARBITRATE\n",
1476 HOSTNO);
1477 return -1;
1478 }
1479
1480 /* after/during arbitration, BSY should be asserted.
1481 IBM DPES-31080 Version S31Q works now */
1482 /* Tnx to Thomas_Roesch@m2.maus.de for finding this! (Roman) */
1483 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_SEL |
1484 ICR_ASSERT_BSY ) ;
1485
1486 if ((NCR5380_read(INITIATOR_COMMAND_REG) & ICR_ARBITRATION_LOST) ||
1487 hostdata->connected) {
1488 NCR5380_write(MODE_REG, MR_BASE);
1489 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1490 ARB_PRINTK("scsi%d: lost arbitration, deasserting ICR_ASSERT_SEL\n",
1491 HOSTNO);
1492 return -1;
1493 }
1494
1495 /*
1496 * Again, bus clear + bus settle time is 1.2us, however, this is
1497 * a minimum so we'll udelay ceil(1.2)
1498 */
1499
1500#ifdef CONFIG_ATARI_SCSI_TOSHIBA_DELAY
1501 /* ++roman: But some targets (see above :-) seem to need a bit more... */
1502 udelay(15);
1503#else
1504 udelay(2);
1505#endif
1506
1507 if (hostdata->connected) {
1508 NCR5380_write(MODE_REG, MR_BASE);
1509 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1510 return -1;
1511 }
1512
1513 ARB_PRINTK("scsi%d: won arbitration\n", HOSTNO);
1514
1515 /*
1516 * Now that we have won arbitration, start Selection process, asserting
1517 * the host and target ID's on the SCSI bus.
1518 */
1519
1520 NCR5380_write(OUTPUT_DATA_REG, (hostdata->id_mask | (1 << cmd->device->id)));
1521
1522 /*
1523 * Raise ATN while SEL is true before BSY goes false from arbitration,
1524 * since this is the only way to guarantee that we'll get a MESSAGE OUT
1525 * phase immediately after selection.
1526 */
1527
1528 NCR5380_write(INITIATOR_COMMAND_REG, (ICR_BASE | ICR_ASSERT_BSY |
1529 ICR_ASSERT_DATA | ICR_ASSERT_ATN | ICR_ASSERT_SEL ));
1530 NCR5380_write(MODE_REG, MR_BASE);
1531
1532 /*
1533 * Reselect interrupts must be turned off prior to the dropping of BSY,
1534 * otherwise we will trigger an interrupt.
1535 */
1536
1537 if (hostdata->connected) {
1538 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1539 return -1;
1540 }
1541
1542 NCR5380_write(SELECT_ENABLE_REG, 0);
1543
1544 /*
1545 * The initiator shall then wait at least two deskew delays and release
1546 * the BSY signal.
1547 */
1548 udelay(1); /* wingel -- wait two bus deskew delay >2*45ns */
1549
1550 /* Reset BSY */
1551 NCR5380_write(INITIATOR_COMMAND_REG, (ICR_BASE | ICR_ASSERT_DATA |
1552 ICR_ASSERT_ATN | ICR_ASSERT_SEL));
1553
1554 /*
1555 * Something weird happens when we cease to drive BSY - looks
1556 * like the board/chip is letting us do another read before the
1557 * appropriate propagation delay has expired, and we're confusing
1558 * a BSY signal from ourselves as the target's response to SELECTION.
1559 *
1560 * A small delay (the 'C++' frontend breaks the pipeline with an
1561 * unnecessary jump, making it work on my 386-33/Trantor T128, the
1562 * tighter 'C' code breaks and requires this) solves the problem -
1563 * the 1 us delay is arbitrary, and only used because this delay will
1564 * be the same on other platforms and since it works here, it should
1565 * work there.
1566 *
1567 * wingel suggests that this could be due to failing to wait
1568 * one deskew delay.
1569 */
1570
1571 udelay(1);
1572
1573 SEL_PRINTK("scsi%d: selecting target %d\n", HOSTNO, cmd->device->id);
1574
1575 /*
1576 * The SCSI specification calls for a 250 ms timeout for the actual
1577 * selection.
1578 */
1579
1580 timeout = jiffies + 25;
1581
1582 /*
1583 * XXX very interesting - we're seeing a bounce where the BSY we
1584 * asserted is being reflected / still asserted (propagation delay?)
1585 * and it's detecting as true. Sigh.
1586 */
1587
1588#if 0
1589 /* ++roman: If a target conformed to the SCSI standard, it wouldn't assert
1590 * IO while SEL is true. But again, there are some disks out the in the
1591 * world that do that nevertheless. (Somebody claimed that this announces
1592 * reselection capability of the target.) So we better skip that test and
1593 * only wait for BSY... (Famous german words: Der Klügere gibt nach :-)
1594 */
1595
1596 while (time_before(jiffies, timeout) && !(NCR5380_read(STATUS_REG) &
1597 (SR_BSY | SR_IO)));
1598
1599 if ((NCR5380_read(STATUS_REG) & (SR_SEL | SR_IO)) ==
1600 (SR_SEL | SR_IO)) {
1601 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1602 NCR5380_reselect(instance);
1603 printk (KERN_ERR "scsi%d: reselection after won arbitration?\n",
1604 HOSTNO);
1605 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
1606 return -1;
1607 }
1608#else
1609 while (time_before(jiffies, timeout) && !(NCR5380_read(STATUS_REG) & SR_BSY));
1610#endif
1611
1612 /*
1613 * No less than two deskew delays after the initiator detects the
1614 * BSY signal is true, it shall release the SEL signal and may
1615 * change the DATA BUS. -wingel
1616 */
1617
1618 udelay(1);
1619
1620 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ATN);
1621
1622 if (!(NCR5380_read(STATUS_REG) & SR_BSY)) {
1623 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1624 if (hostdata->targets_present & (1 << cmd->device->id)) {
1625 printk(KERN_ERR "scsi%d: weirdness\n", HOSTNO);
1626 if (hostdata->restart_select)
1627 printk(KERN_NOTICE "\trestart select\n");
1628 NCR_PRINT(NDEBUG_ANY);
1629 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
1630 return -1;
1631 }
1632 cmd->result = DID_BAD_TARGET << 16;
1633#ifdef NCR5380_STATS
1634 collect_stats(hostdata, cmd);
1635#endif
1636#ifdef SUPPORT_TAGS
1637 cmd_free_tag( cmd );
1638#endif
1639 cmd->scsi_done(cmd);
1640 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
1641 SEL_PRINTK("scsi%d: target did not respond within 250ms\n", HOSTNO);
1642 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
1643 return 0;
1644 }
1645
1646 hostdata->targets_present |= (1 << cmd->device->id);
1647
1648 /*
1649 * Since we followed the SCSI spec, and raised ATN while SEL
1650 * was true but before BSY was false during selection, the information
1651 * transfer phase should be a MESSAGE OUT phase so that we can send the
1652 * IDENTIFY message.
1653 *
1654 * If SCSI-II tagged queuing is enabled, we also send a SIMPLE_QUEUE_TAG
1655 * message (2 bytes) with a tag ID that we increment with every command
1656 * until it wraps back to 0.
1657 *
1658 * XXX - it turns out that there are some broken SCSI-II devices,
1659 * which claim to support tagged queuing but fail when more than
1660 * some number of commands are issued at once.
1661 */
1662
1663 /* Wait for start of REQ/ACK handshake */
1664 while (!(NCR5380_read(STATUS_REG) & SR_REQ));
1665
1666 SEL_PRINTK("scsi%d: target %d selected, going into MESSAGE OUT phase.\n",
1667 HOSTNO, cmd->device->id);
1668 tmp[0] = IDENTIFY(1, cmd->device->lun);
1669
1670#ifdef SUPPORT_TAGS
1671 if (cmd->tag != TAG_NONE) {
1672 tmp[1] = hostdata->last_message = SIMPLE_QUEUE_TAG;
1673 tmp[2] = cmd->tag;
1674 len = 3;
1675 } else
1676 len = 1;
1677#else
1678 len = 1;
1679 cmd->tag=0;
1680#endif /* SUPPORT_TAGS */
1681
1682 /* Send message(s) */
1683 data = tmp;
1684 phase = PHASE_MSGOUT;
1685 NCR5380_transfer_pio(instance, &phase, &len, &data);
1686 SEL_PRINTK("scsi%d: nexus established.\n", HOSTNO);
1687 /* XXX need to handle errors here */
1688 hostdata->connected = cmd;
1689#ifndef SUPPORT_TAGS
1690 hostdata->busy[cmd->device->id] |= (1 << cmd->device->lun);
1691#endif
1692#ifdef SUN3_SCSI_VME
1693 dregs->csr |= CSR_INTR;
1694#endif
1695 initialize_SCp(cmd);
1696
1697
1698 return 0;
1699}
1700
1701/*
1702 * Function : int NCR5380_transfer_pio (struct Scsi_Host *instance,
1703 * unsigned char *phase, int *count, unsigned char **data)
1704 *
1705 * Purpose : transfers data in given phase using polled I/O
1706 *
1707 * Inputs : instance - instance of driver, *phase - pointer to
1708 * what phase is expected, *count - pointer to number of
1709 * bytes to transfer, **data - pointer to data pointer.
1710 *
1711 * Returns : -1 when different phase is entered without transferring
1712 * maximum number of bytes, 0 if all bytes are transfered or exit
1713 * is in same phase.
1714 *
1715 * Also, *phase, *count, *data are modified in place.
1716 *
1717 * XXX Note : handling for bus free may be useful.
1718 */
1719
1720/*
1721 * Note : this code is not as quick as it could be, however it
1722 * IS 100% reliable, and for the actual data transfer where speed
1723 * counts, we will always do a pseudo DMA or DMA transfer.
1724 */
1725
1726static int NCR5380_transfer_pio( struct Scsi_Host *instance,
1727 unsigned char *phase, int *count,
1728 unsigned char **data)
1729{
1730 register unsigned char p = *phase, tmp;
1731 register int c = *count;
1732 register unsigned char *d = *data;
1733
1734 /*
1735 * The NCR5380 chip will only drive the SCSI bus when the
1736 * phase specified in the appropriate bits of the TARGET COMMAND
1737 * REGISTER match the STATUS REGISTER
1738 */
1739
1740 NCR5380_write(TARGET_COMMAND_REG, PHASE_SR_TO_TCR(p));
1741
1742 do {
1743 /*
1744 * Wait for assertion of REQ, after which the phase bits will be
1745 * valid
1746 */
1747 while (!((tmp = NCR5380_read(STATUS_REG)) & SR_REQ));
1748
1749 HSH_PRINTK("scsi%d: REQ detected\n", HOSTNO);
1750
1751 /* Check for phase mismatch */
1752 if ((tmp & PHASE_MASK) != p) {
1753 PIO_PRINTK("scsi%d: phase mismatch\n", HOSTNO);
1754 NCR_PRINT_PHASE(NDEBUG_PIO);
1755 break;
1756 }
1757
1758 /* Do actual transfer from SCSI bus to / from memory */
1759 if (!(p & SR_IO))
1760 NCR5380_write(OUTPUT_DATA_REG, *d);
1761 else
1762 *d = NCR5380_read(CURRENT_SCSI_DATA_REG);
1763
1764 ++d;
1765
1766 /*
1767 * The SCSI standard suggests that in MSGOUT phase, the initiator
1768 * should drop ATN on the last byte of the message phase
1769 * after REQ has been asserted for the handshake but before
1770 * the initiator raises ACK.
1771 */
1772
1773 if (!(p & SR_IO)) {
1774 if (!((p & SR_MSG) && c > 1)) {
1775 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
1776 ICR_ASSERT_DATA);
1777 NCR_PRINT(NDEBUG_PIO);
1778 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
1779 ICR_ASSERT_DATA | ICR_ASSERT_ACK);
1780 } else {
1781 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
1782 ICR_ASSERT_DATA | ICR_ASSERT_ATN);
1783 NCR_PRINT(NDEBUG_PIO);
1784 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
1785 ICR_ASSERT_DATA | ICR_ASSERT_ATN | ICR_ASSERT_ACK);
1786 }
1787 } else {
1788 NCR_PRINT(NDEBUG_PIO);
1789 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ACK);
1790 }
1791
1792 while (NCR5380_read(STATUS_REG) & SR_REQ);
1793
1794 HSH_PRINTK("scsi%d: req false, handshake complete\n", HOSTNO);
1795
1796/*
1797 * We have several special cases to consider during REQ/ACK handshaking :
1798 * 1. We were in MSGOUT phase, and we are on the last byte of the
1799 * message. ATN must be dropped as ACK is dropped.
1800 *
1801 * 2. We are in a MSGIN phase, and we are on the last byte of the
1802 * message. We must exit with ACK asserted, so that the calling
1803 * code may raise ATN before dropping ACK to reject the message.
1804 *
1805 * 3. ACK and ATN are clear and the target may proceed as normal.
1806 */
1807 if (!(p == PHASE_MSGIN && c == 1)) {
1808 if (p == PHASE_MSGOUT && c > 1)
1809 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ATN);
1810 else
1811 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
1812 }
1813 } while (--c);
1814
1815 PIO_PRINTK("scsi%d: residual %d\n", HOSTNO, c);
1816
1817 *count = c;
1818 *data = d;
1819 tmp = NCR5380_read(STATUS_REG);
1820 /* The phase read from the bus is valid if either REQ is (already)
1821 * asserted or if ACK hasn't been released yet. The latter is the case if
1822 * we're in MSGIN and all wanted bytes have been received. */
1823 if ((tmp & SR_REQ) || (p == PHASE_MSGIN && c == 0))
1824 *phase = tmp & PHASE_MASK;
1825 else
1826 *phase = PHASE_UNKNOWN;
1827
1828 if (!c || (*phase == p))
1829 return 0;
1830 else
1831 return -1;
1832}
1833
1834/*
1835 * Function : do_abort (Scsi_Host *host)
1836 *
1837 * Purpose : abort the currently established nexus. Should only be
1838 * called from a routine which can drop into a
1839 *
1840 * Returns : 0 on success, -1 on failure.
1841 */
1842
1843static int do_abort (struct Scsi_Host *host)
1844{
1845 unsigned char tmp, *msgptr, phase;
1846 int len;
1847
1848 /* Request message out phase */
1849 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ATN);
1850
1851 /*
1852 * Wait for the target to indicate a valid phase by asserting
1853 * REQ. Once this happens, we'll have either a MSGOUT phase
1854 * and can immediately send the ABORT message, or we'll have some
1855 * other phase and will have to source/sink data.
1856 *
1857 * We really don't care what value was on the bus or what value
1858 * the target sees, so we just handshake.
1859 */
1860
1861 while (!(tmp = NCR5380_read(STATUS_REG)) & SR_REQ);
1862
1863 NCR5380_write(TARGET_COMMAND_REG, PHASE_SR_TO_TCR(tmp));
1864
1865 if ((tmp & PHASE_MASK) != PHASE_MSGOUT) {
1866 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ATN |
1867 ICR_ASSERT_ACK);
1868 while (NCR5380_read(STATUS_REG) & SR_REQ);
1869 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ATN);
1870 }
1871
1872 tmp = ABORT;
1873 msgptr = &tmp;
1874 len = 1;
1875 phase = PHASE_MSGOUT;
1876 NCR5380_transfer_pio (host, &phase, &len, &msgptr);
1877
1878 /*
1879 * If we got here, and the command completed successfully,
1880 * we're about to go into bus free state.
1881 */
1882
1883 return len ? -1 : 0;
1884}
1885
1886#if defined(REAL_DMA)
1887/*
1888 * Function : int NCR5380_transfer_dma (struct Scsi_Host *instance,
1889 * unsigned char *phase, int *count, unsigned char **data)
1890 *
1891 * Purpose : transfers data in given phase using either real
1892 * or pseudo DMA.
1893 *
1894 * Inputs : instance - instance of driver, *phase - pointer to
1895 * what phase is expected, *count - pointer to number of
1896 * bytes to transfer, **data - pointer to data pointer.
1897 *
1898 * Returns : -1 when different phase is entered without transferring
1899 * maximum number of bytes, 0 if all bytes or transfered or exit
1900 * is in same phase.
1901 *
1902 * Also, *phase, *count, *data are modified in place.
1903 *
1904 */
1905
1906
1907static int NCR5380_transfer_dma( struct Scsi_Host *instance,
1908 unsigned char *phase, int *count,
1909 unsigned char **data)
1910{
1911 SETUP_HOSTDATA(instance);
1912 register int c = *count;
1913 register unsigned char p = *phase;
1914 unsigned long flags;
1915
1916 /* sanity check */
1917 if(!sun3_dma_setup_done) {
1918 printk("scsi%d: transfer_dma without setup!\n", HOSTNO);
1919 BUG();
1920 }
1921 hostdata->dma_len = c;
1922
1923 DMA_PRINTK("scsi%d: initializing DMA for %s, %d bytes %s %p\n",
1924 HOSTNO, (p & SR_IO) ? "reading" : "writing",
1925 c, (p & SR_IO) ? "to" : "from", *data);
1926
1927 /* netbsd turns off ints here, why not be safe and do it too */
1928 local_irq_save(flags);
1929
1930 /* send start chain */
1931 sun3scsi_dma_start(c, *data);
1932
1933 if (p & SR_IO) {
1934 NCR5380_write(TARGET_COMMAND_REG, 1);
1935 NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1936 NCR5380_write(INITIATOR_COMMAND_REG, 0);
1937 NCR5380_write(MODE_REG, (NCR5380_read(MODE_REG) | MR_DMA_MODE | MR_ENABLE_EOP_INTR));
1938 NCR5380_write(START_DMA_INITIATOR_RECEIVE_REG, 0);
1939 } else {
1940 NCR5380_write(TARGET_COMMAND_REG, 0);
1941 NCR5380_read(RESET_PARITY_INTERRUPT_REG);
1942 NCR5380_write(INITIATOR_COMMAND_REG, ICR_ASSERT_DATA);
1943 NCR5380_write(MODE_REG, (NCR5380_read(MODE_REG) | MR_DMA_MODE | MR_ENABLE_EOP_INTR));
1944 NCR5380_write(START_DMA_SEND_REG, 0);
1945 }
1946
1947#ifdef SUN3_SCSI_VME
1948 dregs->csr |= CSR_DMA_ENABLE;
1949#endif
1950
1951 local_irq_restore(flags);
1952
1953 sun3_dma_active = 1;
1954 return 0;
1955}
1956#endif /* defined(REAL_DMA) */
1957
1958/*
1959 * Function : NCR5380_information_transfer (struct Scsi_Host *instance)
1960 *
1961 * Purpose : run through the various SCSI phases and do as the target
1962 * directs us to. Operates on the currently connected command,
1963 * instance->connected.
1964 *
1965 * Inputs : instance, instance for which we are doing commands
1966 *
1967 * Side effects : SCSI things happen, the disconnected queue will be
1968 * modified if a command disconnects, *instance->connected will
1969 * change.
1970 *
1971 * XXX Note : we need to watch for bus free or a reset condition here
1972 * to recover from an unexpected bus free condition.
1973 */
1974
1975static void NCR5380_information_transfer (struct Scsi_Host *instance)
1976{
1977 SETUP_HOSTDATA(instance);
1978 unsigned long flags;
1979 unsigned char msgout = NOP;
1980 int sink = 0;
1981 int len;
1982#if defined(REAL_DMA)
1983 int transfersize;
1984#endif
1985 unsigned char *data;
1986 unsigned char phase, tmp, extended_msg[10], old_phase=0xff;
1987 Scsi_Cmnd *cmd = (Scsi_Cmnd *) hostdata->connected;
1988
1989#ifdef SUN3_SCSI_VME
1990 dregs->csr |= CSR_INTR;
1991#endif
1992
1993 while (1) {
1994 tmp = NCR5380_read(STATUS_REG);
1995 /* We only have a valid SCSI phase when REQ is asserted */
1996 if (tmp & SR_REQ) {
1997 phase = (tmp & PHASE_MASK);
1998 if (phase != old_phase) {
1999 old_phase = phase;
2000 NCR_PRINT_PHASE(NDEBUG_INFORMATION);
2001 }
2002
2003 if(phase == PHASE_CMDOUT) {
2004 void *d;
2005 unsigned long count;
2006
2007 if (!cmd->SCp.this_residual && cmd->SCp.buffers_residual) {
2008 count = cmd->SCp.buffer->length;
2009 d = SGADDR(cmd->SCp.buffer);
2010 } else {
2011 count = cmd->SCp.this_residual;
2012 d = cmd->SCp.ptr;
2013 }
2014#ifdef REAL_DMA
2015 /* this command setup for dma yet? */
2016 if((count > SUN3_DMA_MINSIZE) && (sun3_dma_setup_done
2017 != cmd))
2018 {
2019 if(cmd->request->flags & REQ_CMD) {
2020 sun3scsi_dma_setup(d, count,
2021 rq_data_dir(cmd->request));
2022 sun3_dma_setup_done = cmd;
2023 }
2024 }
2025#endif
2026#ifdef SUN3_SCSI_VME
2027 dregs->csr |= CSR_INTR;
2028#endif
2029 }
2030
2031
2032 if (sink && (phase != PHASE_MSGOUT)) {
2033 NCR5380_write(TARGET_COMMAND_REG, PHASE_SR_TO_TCR(tmp));
2034
2035 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ATN |
2036 ICR_ASSERT_ACK);
2037 while (NCR5380_read(STATUS_REG) & SR_REQ);
2038 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
2039 ICR_ASSERT_ATN);
2040 sink = 0;
2041 continue;
2042 }
2043
2044 switch (phase) {
2045 case PHASE_DATAOUT:
2046#if (NDEBUG & NDEBUG_NO_DATAOUT)
2047 printk("scsi%d: NDEBUG_NO_DATAOUT set, attempted DATAOUT "
2048 "aborted\n", HOSTNO);
2049 sink = 1;
2050 do_abort(instance);
2051 cmd->result = DID_ERROR << 16;
2052 cmd->done(cmd);
2053 return;
2054#endif
2055 case PHASE_DATAIN:
2056 /*
2057 * If there is no room left in the current buffer in the
2058 * scatter-gather list, move onto the next one.
2059 */
2060 if (!cmd->SCp.this_residual && cmd->SCp.buffers_residual) {
2061 ++cmd->SCp.buffer;
2062 --cmd->SCp.buffers_residual;
2063 cmd->SCp.this_residual = cmd->SCp.buffer->length;
2064 cmd->SCp.ptr = SGADDR(cmd->SCp.buffer);
2065
2066 /* ++roman: Try to merge some scatter-buffers if
2067 * they are at contiguous physical addresses.
2068 */
2069// merge_contiguous_buffers( cmd );
2070 INF_PRINTK("scsi%d: %d bytes and %d buffers left\n",
2071 HOSTNO, cmd->SCp.this_residual,
2072 cmd->SCp.buffers_residual);
2073 }
2074
2075 /*
2076 * The preferred transfer method is going to be
2077 * PSEUDO-DMA for systems that are strictly PIO,
2078 * since we can let the hardware do the handshaking.
2079 *
2080 * For this to work, we need to know the transfersize
2081 * ahead of time, since the pseudo-DMA code will sit
2082 * in an unconditional loop.
2083 */
2084
2085/* ++roman: I suggest, this should be
2086 * #if def(REAL_DMA)
2087 * instead of leaving REAL_DMA out.
2088 */
2089
2090#if defined(REAL_DMA)
2091// if (!cmd->device->borken &&
2092 if((transfersize =
2093 NCR5380_dma_xfer_len(instance,cmd,phase)) > SUN3_DMA_MINSIZE) {
2094 len = transfersize;
2095 cmd->SCp.phase = phase;
2096
2097 if (NCR5380_transfer_dma(instance, &phase,
2098 &len, (unsigned char **) &cmd->SCp.ptr)) {
2099 /*
2100 * If the watchdog timer fires, all future
2101 * accesses to this device will use the
2102 * polled-IO. */
2103 printk(KERN_NOTICE "scsi%d: switching target %d "
2104 "lun %d to slow handshake\n", HOSTNO,
2105 cmd->device->id, cmd->device->lun);
2106 cmd->device->borken = 1;
2107 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
2108 ICR_ASSERT_ATN);
2109 sink = 1;
2110 do_abort(instance);
2111 cmd->result = DID_ERROR << 16;
2112 cmd->done(cmd);
2113 /* XXX - need to source or sink data here, as appropriate */
2114 } else {
2115#ifdef REAL_DMA
2116 /* ++roman: When using real DMA,
2117 * information_transfer() should return after
2118 * starting DMA since it has nothing more to
2119 * do.
2120 */
2121 return;
2122#else
2123 cmd->SCp.this_residual -= transfersize - len;
2124#endif
2125 }
2126 } else
2127#endif /* defined(REAL_DMA) */
2128 NCR5380_transfer_pio(instance, &phase,
2129 (int *) &cmd->SCp.this_residual, (unsigned char **)
2130 &cmd->SCp.ptr);
2131#ifdef REAL_DMA
2132 /* if we had intended to dma that command clear it */
2133 if(sun3_dma_setup_done == cmd)
2134 sun3_dma_setup_done = NULL;
2135#endif
2136
2137 break;
2138 case PHASE_MSGIN:
2139 len = 1;
2140 data = &tmp;
2141 NCR5380_write(SELECT_ENABLE_REG, 0); /* disable reselects */
2142 NCR5380_transfer_pio(instance, &phase, &len, &data);
2143 cmd->SCp.Message = tmp;
2144
2145 switch (tmp) {
2146 /*
2147 * Linking lets us reduce the time required to get the
2148 * next command out to the device, hopefully this will
2149 * mean we don't waste another revolution due to the delays
2150 * required by ARBITRATION and another SELECTION.
2151 *
2152 * In the current implementation proposal, low level drivers
2153 * merely have to start the next command, pointed to by
2154 * next_link, done() is called as with unlinked commands.
2155 */
2156#ifdef LINKED
2157 case LINKED_CMD_COMPLETE:
2158 case LINKED_FLG_CMD_COMPLETE:
2159 /* Accept message by clearing ACK */
2160 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2161
2162 LNK_PRINTK("scsi%d: target %d lun %d linked command "
2163 "complete.\n", HOSTNO, cmd->device->id, cmd->device->lun);
2164
2165 /* Enable reselect interrupts */
2166 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2167 /*
2168 * Sanity check : A linked command should only terminate
2169 * with one of these messages if there are more linked
2170 * commands available.
2171 */
2172
2173 if (!cmd->next_link) {
2174 printk(KERN_NOTICE "scsi%d: target %d lun %d "
2175 "linked command complete, no next_link\n",
2176 HOSTNO, cmd->device->id, cmd->device->lun);
2177 sink = 1;
2178 do_abort (instance);
2179 return;
2180 }
2181
2182 initialize_SCp(cmd->next_link);
2183 /* The next command is still part of this process; copy it
2184 * and don't free it! */
2185 cmd->next_link->tag = cmd->tag;
2186 cmd->result = cmd->SCp.Status | (cmd->SCp.Message << 8);
2187 LNK_PRINTK("scsi%d: target %d lun %d linked request "
2188 "done, calling scsi_done().\n",
2189 HOSTNO, cmd->device->id, cmd->device->lun);
2190#ifdef NCR5380_STATS
2191 collect_stats(hostdata, cmd);
2192#endif
2193 cmd->scsi_done(cmd);
2194 cmd = hostdata->connected;
2195 break;
2196#endif /* def LINKED */
2197 case ABORT:
2198 case COMMAND_COMPLETE:
2199 /* Accept message by clearing ACK */
2200 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2201 hostdata->connected = NULL;
2202 QU_PRINTK("scsi%d: command for target %d, lun %d "
2203 "completed\n", HOSTNO, cmd->device->id, cmd->device->lun);
2204#ifdef SUPPORT_TAGS
2205 cmd_free_tag( cmd );
2206 if (status_byte(cmd->SCp.Status) == QUEUE_FULL) {
2207 /* Turn a QUEUE FULL status into BUSY, I think the
2208 * mid level cannot handle QUEUE FULL :-( (The
2209 * command is retried after BUSY). Also update our
2210 * queue size to the number of currently issued
2211 * commands now.
2212 */
2213 /* ++Andreas: the mid level code knows about
2214 QUEUE_FULL now. */
2215 TAG_ALLOC *ta = &TagAlloc[cmd->device->id][cmd->device->lun];
2216 TAG_PRINTK("scsi%d: target %d lun %d returned "
2217 "QUEUE_FULL after %d commands\n",
2218 HOSTNO, cmd->device->id, cmd->device->lun,
2219 ta->nr_allocated);
2220 if (ta->queue_size > ta->nr_allocated)
2221 ta->nr_allocated = ta->queue_size;
2222 }
2223#else
2224 hostdata->busy[cmd->device->id] &= ~(1 << cmd->device->lun);
2225#endif
2226 /* Enable reselect interrupts */
2227 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2228
2229 /*
2230 * I'm not sure what the correct thing to do here is :
2231 *
2232 * If the command that just executed is NOT a request
2233 * sense, the obvious thing to do is to set the result
2234 * code to the values of the stored parameters.
2235 *
2236 * If it was a REQUEST SENSE command, we need some way to
2237 * differentiate between the failure code of the original
2238 * and the failure code of the REQUEST sense - the obvious
2239 * case is success, where we fall through and leave the
2240 * result code unchanged.
2241 *
2242 * The non-obvious place is where the REQUEST SENSE failed
2243 */
2244
2245 if (cmd->cmnd[0] != REQUEST_SENSE)
2246 cmd->result = cmd->SCp.Status | (cmd->SCp.Message << 8);
2247 else if (status_byte(cmd->SCp.Status) != GOOD)
2248 cmd->result = (cmd->result & 0x00ffff) | (DID_ERROR << 16);
2249
2250#ifdef AUTOSENSE
2251 if ((cmd->cmnd[0] != REQUEST_SENSE) &&
2252 (status_byte(cmd->SCp.Status) == CHECK_CONDITION)) {
2253 ASEN_PRINTK("scsi%d: performing request sense\n",
2254 HOSTNO);
2255 cmd->cmnd[0] = REQUEST_SENSE;
2256 cmd->cmnd[1] &= 0xe0;
2257 cmd->cmnd[2] = 0;
2258 cmd->cmnd[3] = 0;
2259 cmd->cmnd[4] = sizeof(cmd->sense_buffer);
2260 cmd->cmnd[5] = 0;
2261 cmd->cmd_len = COMMAND_SIZE(cmd->cmnd[0]);
2262
2263 cmd->use_sg = 0;
2264 /* this is initialized from initialize_SCp
2265 cmd->SCp.buffer = NULL;
2266 cmd->SCp.buffers_residual = 0;
2267 */
2268 cmd->request_buffer = (char *) cmd->sense_buffer;
2269 cmd->request_bufflen = sizeof(cmd->sense_buffer);
2270
2271 local_irq_save(flags);
2272 LIST(cmd,hostdata->issue_queue);
2273 NEXT(cmd) = hostdata->issue_queue;
2274 hostdata->issue_queue = (Scsi_Cmnd *) cmd;
2275 local_irq_restore(flags);
2276 QU_PRINTK("scsi%d: REQUEST SENSE added to head of "
2277 "issue queue\n", H_NO(cmd));
2278 } else
2279#endif /* def AUTOSENSE */
2280 {
2281#ifdef NCR5380_STATS
2282 collect_stats(hostdata, cmd);
2283#endif
2284 cmd->scsi_done(cmd);
2285 }
2286
2287 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2288 /*
2289 * Restore phase bits to 0 so an interrupted selection,
2290 * arbitration can resume.
2291 */
2292 NCR5380_write(TARGET_COMMAND_REG, 0);
2293
2294 while ((NCR5380_read(STATUS_REG) & SR_BSY) && !hostdata->connected)
2295 barrier();
2296
2297 return;
2298 case MESSAGE_REJECT:
2299 /* Accept message by clearing ACK */
2300 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2301 /* Enable reselect interrupts */
2302 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2303 switch (hostdata->last_message) {
2304 case HEAD_OF_QUEUE_TAG:
2305 case ORDERED_QUEUE_TAG:
2306 case SIMPLE_QUEUE_TAG:
2307 /* The target obviously doesn't support tagged
2308 * queuing, even though it announced this ability in
2309 * its INQUIRY data ?!? (maybe only this LUN?) Ok,
2310 * clear 'tagged_supported' and lock the LUN, since
2311 * the command is treated as untagged further on.
2312 */
2313 cmd->device->tagged_supported = 0;
2314 hostdata->busy[cmd->device->id] |= (1 << cmd->device->lun);
2315 cmd->tag = TAG_NONE;
2316 TAG_PRINTK("scsi%d: target %d lun %d rejected "
2317 "QUEUE_TAG message; tagged queuing "
2318 "disabled\n",
2319 HOSTNO, cmd->device->id, cmd->device->lun);
2320 break;
2321 }
2322 break;
2323 case DISCONNECT:
2324 /* Accept message by clearing ACK */
2325 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2326 local_irq_save(flags);
2327 cmd->device->disconnect = 1;
2328 LIST(cmd,hostdata->disconnected_queue);
2329 NEXT(cmd) = hostdata->disconnected_queue;
2330 hostdata->connected = NULL;
2331 hostdata->disconnected_queue = cmd;
2332 local_irq_restore(flags);
2333 QU_PRINTK("scsi%d: command for target %d lun %d was "
2334 "moved from connected to the "
2335 "disconnected_queue\n", HOSTNO,
2336 cmd->device->id, cmd->device->lun);
2337 /*
2338 * Restore phase bits to 0 so an interrupted selection,
2339 * arbitration can resume.
2340 */
2341 NCR5380_write(TARGET_COMMAND_REG, 0);
2342
2343 /* Enable reselect interrupts */
2344 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2345 /* Wait for bus free to avoid nasty timeouts */
2346 while ((NCR5380_read(STATUS_REG) & SR_BSY) && !hostdata->connected)
2347 barrier();
2348#ifdef SUN3_SCSI_VME
2349 dregs->csr |= CSR_DMA_ENABLE;
2350#endif
2351 return;
2352 /*
2353 * The SCSI data pointer is *IMPLICITLY* saved on a disconnect
2354 * operation, in violation of the SCSI spec so we can safely
2355 * ignore SAVE/RESTORE pointers calls.
2356 *
2357 * Unfortunately, some disks violate the SCSI spec and
2358 * don't issue the required SAVE_POINTERS message before
2359 * disconnecting, and we have to break spec to remain
2360 * compatible.
2361 */
2362 case SAVE_POINTERS:
2363 case RESTORE_POINTERS:
2364 /* Accept message by clearing ACK */
2365 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2366 /* Enable reselect interrupts */
2367 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2368 break;
2369 case EXTENDED_MESSAGE:
2370/*
2371 * Extended messages are sent in the following format :
2372 * Byte
2373 * 0 EXTENDED_MESSAGE == 1
2374 * 1 length (includes one byte for code, doesn't
2375 * include first two bytes)
2376 * 2 code
2377 * 3..length+1 arguments
2378 *
2379 * Start the extended message buffer with the EXTENDED_MESSAGE
2380 * byte, since print_msg() wants the whole thing.
2381 */
2382 extended_msg[0] = EXTENDED_MESSAGE;
2383 /* Accept first byte by clearing ACK */
2384 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2385
2386 EXT_PRINTK("scsi%d: receiving extended message\n", HOSTNO);
2387
2388 len = 2;
2389 data = extended_msg + 1;
2390 phase = PHASE_MSGIN;
2391 NCR5380_transfer_pio(instance, &phase, &len, &data);
2392 EXT_PRINTK("scsi%d: length=%d, code=0x%02x\n", HOSTNO,
2393 (int)extended_msg[1], (int)extended_msg[2]);
2394
2395 if (!len && extended_msg[1] <=
2396 (sizeof (extended_msg) - 1)) {
2397 /* Accept third byte by clearing ACK */
2398 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2399 len = extended_msg[1] - 1;
2400 data = extended_msg + 3;
2401 phase = PHASE_MSGIN;
2402
2403 NCR5380_transfer_pio(instance, &phase, &len, &data);
2404 EXT_PRINTK("scsi%d: message received, residual %d\n",
2405 HOSTNO, len);
2406
2407 switch (extended_msg[2]) {
2408 case EXTENDED_SDTR:
2409 case EXTENDED_WDTR:
2410 case EXTENDED_MODIFY_DATA_POINTER:
2411 case EXTENDED_EXTENDED_IDENTIFY:
2412 tmp = 0;
2413 }
2414 } else if (len) {
2415 printk(KERN_NOTICE "scsi%d: error receiving "
2416 "extended message\n", HOSTNO);
2417 tmp = 0;
2418 } else {
2419 printk(KERN_NOTICE "scsi%d: extended message "
2420 "code %02x length %d is too long\n",
2421 HOSTNO, extended_msg[2], extended_msg[1]);
2422 tmp = 0;
2423 }
2424 /* Fall through to reject message */
2425
2426 /*
2427 * If we get something weird that we aren't expecting,
2428 * reject it.
2429 */
2430 default:
2431 if (!tmp) {
2432 printk(KERN_DEBUG "scsi%d: rejecting message ", HOSTNO);
2433 print_msg (extended_msg);
2434 printk("\n");
2435 } else if (tmp != EXTENDED_MESSAGE)
2436 printk(KERN_DEBUG "scsi%d: rejecting unknown "
2437 "message %02x from target %d, lun %d\n",
2438 HOSTNO, tmp, cmd->device->id, cmd->device->lun);
2439 else
2440 printk(KERN_DEBUG "scsi%d: rejecting unknown "
2441 "extended message "
2442 "code %02x, length %d from target %d, lun %d\n",
2443 HOSTNO, extended_msg[1], extended_msg[0],
2444 cmd->device->id, cmd->device->lun);
2445
2446
2447 msgout = MESSAGE_REJECT;
2448 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE |
2449 ICR_ASSERT_ATN);
2450 break;
2451 } /* switch (tmp) */
2452 break;
2453 case PHASE_MSGOUT:
2454 len = 1;
2455 data = &msgout;
2456 hostdata->last_message = msgout;
2457 NCR5380_transfer_pio(instance, &phase, &len, &data);
2458 if (msgout == ABORT) {
2459#ifdef SUPPORT_TAGS
2460 cmd_free_tag( cmd );
2461#else
2462 hostdata->busy[cmd->device->id] &= ~(1 << cmd->device->lun);
2463#endif
2464 hostdata->connected = NULL;
2465 cmd->result = DID_ERROR << 16;
2466#ifdef NCR5380_STATS
2467 collect_stats(hostdata, cmd);
2468#endif
2469 cmd->scsi_done(cmd);
2470 NCR5380_write(SELECT_ENABLE_REG, hostdata->id_mask);
2471 return;
2472 }
2473 msgout = NOP;
2474 break;
2475 case PHASE_CMDOUT:
2476 len = cmd->cmd_len;
2477 data = cmd->cmnd;
2478 /*
2479 * XXX for performance reasons, on machines with a
2480 * PSEUDO-DMA architecture we should probably
2481 * use the dma transfer function.
2482 */
2483 NCR5380_transfer_pio(instance, &phase, &len,
2484 &data);
2485 break;
2486 case PHASE_STATIN:
2487 len = 1;
2488 data = &tmp;
2489 NCR5380_transfer_pio(instance, &phase, &len, &data);
2490 cmd->SCp.Status = tmp;
2491 break;
2492 default:
2493 printk("scsi%d: unknown phase\n", HOSTNO);
2494 NCR_PRINT(NDEBUG_ANY);
2495 } /* switch(phase) */
2496 } /* if (tmp * SR_REQ) */
2497 } /* while (1) */
2498}
2499
2500/*
2501 * Function : void NCR5380_reselect (struct Scsi_Host *instance)
2502 *
2503 * Purpose : does reselection, initializing the instance->connected
2504 * field to point to the Scsi_Cmnd for which the I_T_L or I_T_L_Q
2505 * nexus has been reestablished,
2506 *
2507 * Inputs : instance - this instance of the NCR5380.
2508 *
2509 */
2510
2511/* it might eventually prove necessary to do a dma setup on
2512 reselection, but it doesn't seem to be needed now -- sam */
2513
2514static void NCR5380_reselect (struct Scsi_Host *instance)
2515{
2516 SETUP_HOSTDATA(instance);
2517 unsigned char target_mask;
2518 unsigned char lun;
2519#ifdef SUPPORT_TAGS
2520 unsigned char tag;
2521#endif
2522 unsigned char msg[3];
2523 Scsi_Cmnd *tmp = NULL, *prev;
2524/* unsigned long flags; */
2525
2526 /*
2527 * Disable arbitration, etc. since the host adapter obviously
2528 * lost, and tell an interrupted NCR5380_select() to restart.
2529 */
2530
2531 NCR5380_write(MODE_REG, MR_BASE);
2532 hostdata->restart_select = 1;
2533
2534 target_mask = NCR5380_read(CURRENT_SCSI_DATA_REG) & ~(hostdata->id_mask);
2535
2536 RSL_PRINTK("scsi%d: reselect\n", HOSTNO);
2537
2538 /*
2539 * At this point, we have detected that our SCSI ID is on the bus,
2540 * SEL is true and BSY was false for at least one bus settle delay
2541 * (400 ns).
2542 *
2543 * We must assert BSY ourselves, until the target drops the SEL
2544 * signal.
2545 */
2546
2547 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_BSY);
2548
2549 while (NCR5380_read(STATUS_REG) & SR_SEL);
2550 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2551
2552 /*
2553 * Wait for target to go into MSGIN.
2554 */
2555
2556 while (!(NCR5380_read(STATUS_REG) & SR_REQ));
2557
2558#if 1
2559 // acknowledge toggle to MSGIN
2560 NCR5380_write(TARGET_COMMAND_REG, PHASE_SR_TO_TCR(PHASE_MSGIN));
2561
2562 // peek at the byte without really hitting the bus
2563 msg[0] = NCR5380_read(CURRENT_SCSI_DATA_REG);
2564#endif
2565
2566 if (!(msg[0] & 0x80)) {
2567 printk(KERN_DEBUG "scsi%d: expecting IDENTIFY message, got ", HOSTNO);
2568 print_msg(msg);
2569 do_abort(instance);
2570 return;
2571 }
2572 lun = (msg[0] & 0x07);
2573
2574 /*
2575 * Find the command corresponding to the I_T_L or I_T_L_Q nexus we
2576 * just reestablished, and remove it from the disconnected queue.
2577 */
2578
2579 for (tmp = (Scsi_Cmnd *) hostdata->disconnected_queue, prev = NULL;
2580 tmp; prev = tmp, tmp = NEXT(tmp) ) {
2581 if ((target_mask == (1 << tmp->device->id)) && (lun == tmp->device->lun)
2582#ifdef SUPPORT_TAGS
2583 && (tag == tmp->tag)
2584#endif
2585 ) {
2586 if (prev) {
2587 REMOVE(prev, NEXT(prev), tmp, NEXT(tmp));
2588 NEXT(prev) = NEXT(tmp);
2589 } else {
2590 REMOVE(-1, hostdata->disconnected_queue, tmp, NEXT(tmp));
2591 hostdata->disconnected_queue = NEXT(tmp);
2592 }
2593 NEXT(tmp) = NULL;
2594 break;
2595 }
2596 }
2597
2598 if (!tmp) {
2599 printk(KERN_WARNING "scsi%d: warning: target bitmask %02x lun %d "
2600#ifdef SUPPORT_TAGS
2601 "tag %d "
2602#endif
2603 "not in disconnected_queue.\n",
2604 HOSTNO, target_mask, lun
2605#ifdef SUPPORT_TAGS
2606 , tag
2607#endif
2608 );
2609 /*
2610 * Since we have an established nexus that we can't do anything
2611 * with, we must abort it.
2612 */
2613 do_abort(instance);
2614 return;
2615 }
2616#if 1
2617 /* engage dma setup for the command we just saw */
2618 {
2619 void *d;
2620 unsigned long count;
2621
2622 if (!tmp->SCp.this_residual && tmp->SCp.buffers_residual) {
2623 count = tmp->SCp.buffer->length;
2624 d = SGADDR(tmp->SCp.buffer);
2625 } else {
2626 count = tmp->SCp.this_residual;
2627 d = tmp->SCp.ptr;
2628 }
2629#ifdef REAL_DMA
2630 /* setup this command for dma if not already */
2631 if((count > SUN3_DMA_MINSIZE) && (sun3_dma_setup_done != tmp))
2632 {
2633 sun3scsi_dma_setup(d, count, rq_data_dir(tmp->request));
2634 sun3_dma_setup_done = tmp;
2635 }
2636#endif
2637 }
2638#endif
2639
2640 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_ACK);
2641 /* Accept message by clearing ACK */
2642 NCR5380_write(INITIATOR_COMMAND_REG, ICR_BASE);
2643
2644#ifdef SUPPORT_TAGS
2645 /* If the phase is still MSGIN, the target wants to send some more
2646 * messages. In case it supports tagged queuing, this is probably a
2647 * SIMPLE_QUEUE_TAG for the I_T_L_Q nexus.
2648 */
2649 tag = TAG_NONE;
2650 if (phase == PHASE_MSGIN && setup_use_tagged_queuing) {
2651 /* Accept previous IDENTIFY message by clearing ACK */
2652 NCR5380_write( INITIATOR_COMMAND_REG, ICR_BASE );
2653 len = 2;
2654 data = msg+1;
2655 if (!NCR5380_transfer_pio(instance, &phase, &len, &data) &&
2656 msg[1] == SIMPLE_QUEUE_TAG)
2657 tag = msg[2];
2658 TAG_PRINTK("scsi%d: target mask %02x, lun %d sent tag %d at "
2659 "reselection\n", HOSTNO, target_mask, lun, tag);
2660 }
2661#endif
2662
2663 hostdata->connected = tmp;
2664 RSL_PRINTK("scsi%d: nexus established, target = %d, lun = %d, tag = %d\n",
2665 HOSTNO, tmp->target, tmp->lun, tmp->tag);
2666}
2667
2668
2669/*
2670 * Function : int NCR5380_abort (Scsi_Cmnd *cmd)
2671 *
2672 * Purpose : abort a command
2673 *
2674 * Inputs : cmd - the Scsi_Cmnd to abort, code - code to set the
2675 * host byte of the result field to, if zero DID_ABORTED is
2676 * used.
2677 *
2678 * Returns : 0 - success, -1 on failure.
2679 *
2680 * XXX - there is no way to abort the command that is currently
2681 * connected, you have to wait for it to complete. If this is
2682 * a problem, we could implement longjmp() / setjmp(), setjmp()
2683 * called where the loop started in NCR5380_main().
2684 */
2685
2686static int NCR5380_abort (Scsi_Cmnd *cmd)
2687{
2688 struct Scsi_Host *instance = cmd->device->host;
2689 SETUP_HOSTDATA(instance);
2690 Scsi_Cmnd *tmp, **prev;
2691 unsigned long flags;
2692
2693 printk(KERN_NOTICE "scsi%d: aborting command\n", HOSTNO);
2694 print_Scsi_Cmnd (cmd);
2695
2696 NCR5380_print_status (instance);
2697
2698 local_irq_save(flags);
2699
2700 ABRT_PRINTK("scsi%d: abort called basr 0x%02x, sr 0x%02x\n", HOSTNO,
2701 NCR5380_read(BUS_AND_STATUS_REG),
2702 NCR5380_read(STATUS_REG));
2703
2704#if 1
2705/*
2706 * Case 1 : If the command is the currently executing command,
2707 * we'll set the aborted flag and return control so that
2708 * information transfer routine can exit cleanly.
2709 */
2710
2711 if (hostdata->connected == cmd) {
2712
2713 ABRT_PRINTK("scsi%d: aborting connected command\n", HOSTNO);
2714/*
2715 * We should perform BSY checking, and make sure we haven't slipped
2716 * into BUS FREE.
2717 */
2718
2719/* NCR5380_write(INITIATOR_COMMAND_REG, ICR_ASSERT_ATN); */
2720/*
2721 * Since we can't change phases until we've completed the current
2722 * handshake, we have to source or sink a byte of data if the current
2723 * phase is not MSGOUT.
2724 */
2725
2726/*
2727 * Return control to the executing NCR drive so we can clear the
2728 * aborted flag and get back into our main loop.
2729 */
2730
2731 if (do_abort(instance) == 0) {
2732 hostdata->aborted = 1;
2733 hostdata->connected = NULL;
2734 cmd->result = DID_ABORT << 16;
2735#ifdef SUPPORT_TAGS
2736 cmd_free_tag( cmd );
2737#else
2738 hostdata->busy[cmd->device->id] &= ~(1 << cmd->device->lun);
2739#endif
2740 local_irq_restore(flags);
2741 cmd->scsi_done(cmd);
2742 return SCSI_ABORT_SUCCESS;
2743 } else {
2744/* local_irq_restore(flags); */
2745 printk("scsi%d: abort of connected command failed!\n", HOSTNO);
2746 return SCSI_ABORT_ERROR;
2747 }
2748 }
2749#endif
2750
2751/*
2752 * Case 2 : If the command hasn't been issued yet, we simply remove it
2753 * from the issue queue.
2754 */
2755 for (prev = (Scsi_Cmnd **) &(hostdata->issue_queue),
2756 tmp = (Scsi_Cmnd *) hostdata->issue_queue;
2757 tmp; prev = NEXTADDR(tmp), tmp = NEXT(tmp) )
2758 if (cmd == tmp) {
2759 REMOVE(5, *prev, tmp, NEXT(tmp));
2760 (*prev) = NEXT(tmp);
2761 NEXT(tmp) = NULL;
2762 tmp->result = DID_ABORT << 16;
2763 local_irq_restore(flags);
2764 ABRT_PRINTK("scsi%d: abort removed command from issue queue.\n",
2765 HOSTNO);
2766 /* Tagged queuing note: no tag to free here, hasn't been assigned
2767 * yet... */
2768 tmp->scsi_done(tmp);
2769 return SCSI_ABORT_SUCCESS;
2770 }
2771
2772/*
2773 * Case 3 : If any commands are connected, we're going to fail the abort
2774 * and let the high level SCSI driver retry at a later time or
2775 * issue a reset.
2776 *
2777 * Timeouts, and therefore aborted commands, will be highly unlikely
2778 * and handling them cleanly in this situation would make the common
2779 * case of noresets less efficient, and would pollute our code. So,
2780 * we fail.
2781 */
2782
2783 if (hostdata->connected) {
2784 local_irq_restore(flags);
2785 ABRT_PRINTK("scsi%d: abort failed, command connected.\n", HOSTNO);
2786 return SCSI_ABORT_SNOOZE;
2787 }
2788
2789/*
2790 * Case 4: If the command is currently disconnected from the bus, and
2791 * there are no connected commands, we reconnect the I_T_L or
2792 * I_T_L_Q nexus associated with it, go into message out, and send
2793 * an abort message.
2794 *
2795 * This case is especially ugly. In order to reestablish the nexus, we
2796 * need to call NCR5380_select(). The easiest way to implement this
2797 * function was to abort if the bus was busy, and let the interrupt
2798 * handler triggered on the SEL for reselect take care of lost arbitrations
2799 * where necessary, meaning interrupts need to be enabled.
2800 *
2801 * When interrupts are enabled, the queues may change - so we
2802 * can't remove it from the disconnected queue before selecting it
2803 * because that could cause a failure in hashing the nexus if that
2804 * device reselected.
2805 *
2806 * Since the queues may change, we can't use the pointers from when we
2807 * first locate it.
2808 *
2809 * So, we must first locate the command, and if NCR5380_select()
2810 * succeeds, then issue the abort, relocate the command and remove
2811 * it from the disconnected queue.
2812 */
2813
2814 for (tmp = (Scsi_Cmnd *) hostdata->disconnected_queue; tmp;
2815 tmp = NEXT(tmp))
2816 if (cmd == tmp) {
2817 local_irq_restore(flags);
2818 ABRT_PRINTK("scsi%d: aborting disconnected command.\n", HOSTNO);
2819
2820 if (NCR5380_select (instance, cmd, (int) cmd->tag))
2821 return SCSI_ABORT_BUSY;
2822
2823 ABRT_PRINTK("scsi%d: nexus reestablished.\n", HOSTNO);
2824
2825 do_abort (instance);
2826
2827 local_irq_save(flags);
2828 for (prev = (Scsi_Cmnd **) &(hostdata->disconnected_queue),
2829 tmp = (Scsi_Cmnd *) hostdata->disconnected_queue;
2830 tmp; prev = NEXTADDR(tmp), tmp = NEXT(tmp) )
2831 if (cmd == tmp) {
2832 REMOVE(5, *prev, tmp, NEXT(tmp));
2833 *prev = NEXT(tmp);
2834 NEXT(tmp) = NULL;
2835 tmp->result = DID_ABORT << 16;
2836 /* We must unlock the tag/LUN immediately here, since the
2837 * target goes to BUS FREE and doesn't send us another
2838 * message (COMMAND_COMPLETE or the like)
2839 */
2840#ifdef SUPPORT_TAGS
2841 cmd_free_tag( tmp );
2842#else
2843 hostdata->busy[cmd->device->id] &= ~(1 << cmd->device->lun);
2844#endif
2845 local_irq_restore(flags);
2846 tmp->scsi_done(tmp);
2847 return SCSI_ABORT_SUCCESS;
2848 }
2849 }
2850
2851/*
2852 * Case 5 : If we reached this point, the command was not found in any of
2853 * the queues.
2854 *
2855 * We probably reached this point because of an unlikely race condition
2856 * between the command completing successfully and the abortion code,
2857 * so we won't panic, but we will notify the user in case something really
2858 * broke.
2859 */
2860
2861 local_irq_restore(flags);
2862 printk(KERN_INFO "scsi%d: warning : SCSI command probably completed successfully\n"
2863 KERN_INFO " before abortion\n", HOSTNO);
2864
2865 return SCSI_ABORT_NOT_RUNNING;
2866}
2867
2868
2869/*
2870 * Function : int NCR5380_bus_reset (Scsi_Cmnd *cmd)
2871 *
2872 * Purpose : reset the SCSI bus.
2873 *
2874 * Returns : SCSI_RESET_WAKEUP
2875 *
2876 */
2877
2878static int NCR5380_bus_reset( Scsi_Cmnd *cmd)
2879{
2880 SETUP_HOSTDATA(cmd->device->host);
2881 int i;
2882 unsigned long flags;
2883#if 1
2884 Scsi_Cmnd *connected, *disconnected_queue;
2885#endif
2886
2887
2888 NCR5380_print_status (cmd->device->host);
2889
2890 /* get in phase */
2891 NCR5380_write( TARGET_COMMAND_REG,
2892 PHASE_SR_TO_TCR( NCR5380_read(STATUS_REG) ));
2893 /* assert RST */
2894 NCR5380_write( INITIATOR_COMMAND_REG, ICR_BASE | ICR_ASSERT_RST );
2895 udelay (40);
2896 /* reset NCR registers */
2897 NCR5380_write( INITIATOR_COMMAND_REG, ICR_BASE );
2898 NCR5380_write( MODE_REG, MR_BASE );
2899 NCR5380_write( TARGET_COMMAND_REG, 0 );
2900 NCR5380_write( SELECT_ENABLE_REG, 0 );
2901 /* ++roman: reset interrupt condition! otherwise no interrupts don't get
2902 * through anymore ... */
2903 (void)NCR5380_read( RESET_PARITY_INTERRUPT_REG );
2904
2905#if 1 /* XXX Should now be done by midlevel code, but it's broken XXX */
2906 /* XXX see below XXX */
2907
2908 /* MSch: old-style reset: actually abort all command processing here */
2909
2910 /* After the reset, there are no more connected or disconnected commands
2911 * and no busy units; to avoid problems with re-inserting the commands
2912 * into the issue_queue (via scsi_done()), the aborted commands are
2913 * remembered in local variables first.
2914 */
2915 local_irq_save(flags);
2916 connected = (Scsi_Cmnd *)hostdata->connected;
2917 hostdata->connected = NULL;
2918 disconnected_queue = (Scsi_Cmnd *)hostdata->disconnected_queue;
2919 hostdata->disconnected_queue = NULL;
2920#ifdef SUPPORT_TAGS
2921 free_all_tags();
2922#endif
2923 for( i = 0; i < 8; ++i )
2924 hostdata->busy[i] = 0;
2925#ifdef REAL_DMA
2926 hostdata->dma_len = 0;
2927#endif
2928 local_irq_restore(flags);
2929
2930 /* In order to tell the mid-level code which commands were aborted,
2931 * set the command status to DID_RESET and call scsi_done() !!!
2932 * This ultimately aborts processing of these commands in the mid-level.
2933 */
2934
2935 if ((cmd = connected)) {
2936 ABRT_PRINTK("scsi%d: reset aborted a connected command\n", H_NO(cmd));
2937 cmd->result = (cmd->result & 0xffff) | (DID_RESET << 16);
2938 cmd->scsi_done( cmd );
2939 }
2940
2941 for (i = 0; (cmd = disconnected_queue); ++i) {
2942 disconnected_queue = NEXT(cmd);
2943 NEXT(cmd) = NULL;
2944 cmd->result = (cmd->result & 0xffff) | (DID_RESET << 16);
2945 cmd->scsi_done( cmd );
2946 }
2947 if (i > 0)
2948 ABRT_PRINTK("scsi: reset aborted %d disconnected command(s)\n", i);
2949
2950
2951 /* since all commands have been explicitly terminated, we need to tell
2952 * the midlevel code that the reset was SUCCESSFUL, and there is no
2953 * need to 'wake up' the commands by a request_sense
2954 */
2955 return SCSI_RESET_SUCCESS | SCSI_RESET_BUS_RESET;
2956#else /* 1 */
2957
2958 /* MSch: new-style reset handling: let the mid-level do what it can */
2959
2960 /* ++guenther: MID-LEVEL IS STILL BROKEN.
2961 * Mid-level is supposed to requeue all commands that were active on the
2962 * various low-level queues. In fact it does this, but that's not enough
2963 * because all these commands are subject to timeout. And if a timeout
2964 * happens for any removed command, *_abort() is called but all queues
2965 * are now empty. Abort then gives up the falcon lock, which is fatal,
2966 * since the mid-level will queue more commands and must have the lock
2967 * (it's all happening inside timer interrupt handler!!).
2968 * Even worse, abort will return NOT_RUNNING for all those commands not
2969 * on any queue, so they won't be retried ...
2970 *
2971 * Conclusion: either scsi.c disables timeout for all resetted commands
2972 * immediately, or we lose! As of linux-2.0.20 it doesn't.
2973 */
2974
2975 /* After the reset, there are no more connected or disconnected commands
2976 * and no busy units; so clear the low-level status here to avoid
2977 * conflicts when the mid-level code tries to wake up the affected
2978 * commands!
2979 */
2980
2981 if (hostdata->issue_queue)
2982 ABRT_PRINTK("scsi%d: reset aborted issued command(s)\n", H_NO(cmd));
2983 if (hostdata->connected)
2984 ABRT_PRINTK("scsi%d: reset aborted a connected command\n", H_NO(cmd));
2985 if (hostdata->disconnected_queue)
2986 ABRT_PRINTK("scsi%d: reset aborted disconnected command(s)\n", H_NO(cmd));
2987
2988 local_irq_save(flags);
2989 hostdata->issue_queue = NULL;
2990 hostdata->connected = NULL;
2991 hostdata->disconnected_queue = NULL;
2992#ifdef SUPPORT_TAGS
2993 free_all_tags();
2994#endif
2995 for( i = 0; i < 8; ++i )
2996 hostdata->busy[i] = 0;
2997#ifdef REAL_DMA
2998 hostdata->dma_len = 0;
2999#endif
3000 local_irq_restore(flags);
3001
3002 /* we did no complete reset of all commands, so a wakeup is required */
3003 return SCSI_RESET_WAKEUP | SCSI_RESET_BUS_RESET;
3004#endif /* 1 */
3005}
3006
3007/* Local Variables: */
3008/* tab-width: 8 */
3009/* End: */