1 /*----------------------------------------------------------------*/
3 Qlogic linux driver - work in progress. No Warranty express or implied.
4 Use at your own risk. Support Tort Reform so you won't have to read all
5 these silly disclaimers.
7 Copyright 1994, Tom Zerucha.
10 Additional Code, and much appreciated help by
14 Thanks to Eric Youngdale and Dave Hinds for loadable module and PCMCIA
15 help respectively, and for suffering through my foolishness during the
18 Reference Qlogic FAS408 Technical Manual, 53408-510-00A, May 10, 1994
19 (you can reference it, but it is incomplete and inaccurate in places)
21 Version 0.46 1/30/97 - kernel 1.2.0+
23 Functions as standalone, loadable, and PCMCIA driver, the latter from
24 Dave Hinds' PCMCIA package.
26 Cleaned up 26/10/2002 by Alan Cox <alan@lxorguk.ukuu.org.uk> as part of the 2.5
27 SCSI driver cleanup and audit. This driver still needs work on the
29 - Non terminating hardware waits
30 - Some layering violations with its pcmcia stub
32 Redistributable under terms of the GNU General Public License
34 For the avoidance of doubt the "preferred form" of this code is one which
35 is in an open non patent encumbered format. Where cryptographic key signing
36 forms part of the process of creating an executable the information
37 including keys needed to generate an equivalently functional executable
38 are deemed to be part of the source code.
42 #include <linux/module.h>
43 #include <linux/blkdev.h> /* to get disk capacity */
44 #include <linux/kernel.h>
45 #include <linux/string.h>
46 #include <linux/init.h>
47 #include <linux/interrupt.h>
48 #include <linux/ioport.h>
49 #include <linux/proc_fs.h>
50 #include <linux/unistd.h>
51 #include <linux/spinlock.h>
52 #include <linux/stat.h>
59 #include <scsi/scsi_host.h>
60 #include "qlogicfas408.h"
62 /*----------------------------------------------------------------*/
63 static int qlcfg5 = (XTALFREQ << 5); /* 15625/512 */
64 static int qlcfg6 = SYNCXFRPD;
65 static int qlcfg7 = SYNCOFFST;
66 static int qlcfg8 = (SLOWCABLE << 7) | (QL_ENABLE_PARITY << 4);
67 static int qlcfg9 = ((XTALFREQ + 4) / 5);
68 static int qlcfgc = (FASTCLK << 3) | (FASTSCSI << 4);
70 /*----------------------------------------------------------------*/
72 /*----------------------------------------------------------------*/
74 /*----------------------------------------------------------------*/
76 /* error recovery - reset everything */
78 static void ql_zap(struct qlogicfas408_priv *priv)
81 int qbase = priv->qbase;
82 int int_type = priv->int_type;
86 outb(3, qbase + 3); /* reset SCSI */
87 outb(2, qbase + 3); /* reset chip */
93 * Do a pseudo-dma tranfer
96 static int ql_pdma(struct qlogicfas408_priv *priv, int phase, char *request, int reqlen)
99 int qbase = priv->qbase;
101 if (phase & 1) { /* in */
104 /* empty fifo in large chunks */
105 if (reqlen >= 128 && (inb(qbase + 8) & 2)) { /* full */
106 insl(qbase + 4, request, 32);
110 while (reqlen >= 84 && !(j & 0xc0)) /* 2/3 */
111 if ((j = inb(qbase + 8)) & 4)
113 insl(qbase + 4, request, 21);
117 if (reqlen >= 44 && (inb(qbase + 8) & 8)) { /* 1/3 */
118 insl(qbase + 4, request, 11);
123 /* until both empty and int (or until reclen is 0) */
126 while (reqlen && !((j & 0x10) && (j & 0xc0)))
128 /* while bytes to receive and not empty */
130 while (reqlen && !((j = inb(qbase + 8)) & 0x10))
132 *request++ = inb(qbase + 4);
142 if (reqlen >= 128 && inb(qbase + 8) & 0x10) { /* empty */
143 outsl(qbase + 4, request, 32);
147 while (reqlen >= 84 && !(j & 0xc0)) /* 1/3 */
148 if (!((j = inb(qbase + 8)) & 8)) {
149 outsl(qbase + 4, request, 21);
153 if (reqlen >= 40 && !(inb(qbase + 8) & 4)) { /* 2/3 */
154 outsl(qbase + 4, request, 10);
159 /* until full and int (or until reclen is 0) */
162 while (reqlen && !((j & 2) && (j & 0xc0))) {
163 /* while bytes to send and not full */
164 while (reqlen && !((j = inb(qbase + 8)) & 2))
166 outb(*request++, qbase + 4);
173 /* maybe return reqlen */
174 return inb(qbase + 8) & 0xc0;
178 * Wait for interrupt flag (polled - not real hardware interrupt)
181 static int ql_wai(struct qlogicfas408_priv *priv)
184 int qbase = priv->qbase;
188 i = jiffies + WATCHDOG;
189 while (time_before(jiffies, i) && !priv->qabort &&
190 !((k = inb(qbase + 4)) & 0xe0)) {
194 if (time_after_eq(jiffies, i))
195 return (DID_TIME_OUT);
197 return (priv->qabort == 1 ? DID_ABORT : DID_RESET);
208 * Initiate scsi command - queueing handler
209 * caller must hold host lock
212 static void ql_icmd(struct scsi_cmnd *cmd)
214 struct qlogicfas408_priv *priv = get_priv_by_cmd(cmd);
215 int qbase = priv->qbase;
216 int int_type = priv->int_type;
222 /* clearing of interrupts and the fifo is needed */
224 inb(qbase + 5); /* clear interrupts */
225 if (inb(qbase + 5)) /* if still interrupting */
226 outb(2, qbase + 3); /* reset chip */
227 else if (inb(qbase + 7) & 0x1f)
228 outb(1, qbase + 3); /* clear fifo */
229 while (inb(qbase + 5)); /* clear ints */
231 outb(1, qbase + 8); /* set for PIO pseudo DMA */
232 outb(0, qbase + 0xb); /* disable ints */
233 inb(qbase + 8); /* clear int bits */
235 outb(0x40, qbase + 0xb); /* enable features */
238 outb(qlcfgc, qbase + 0xc);
239 /* config: no reset interrupt, (initiator) bus id */
240 outb(0x40 | qlcfg8 | priv->qinitid, qbase + 8);
241 outb(qlcfg7, qbase + 7);
242 outb(qlcfg6, qbase + 6);
243 /**/ outb(qlcfg5, qbase + 5); /* select timer */
244 outb(qlcfg9 & 7, qbase + 9); /* prescaler */
245 /* outb(0x99, qbase + 5); */
246 outb(scmd_id(cmd), qbase + 4);
248 for (i = 0; i < cmd->cmd_len; i++)
249 outb(cmd->cmnd[i], qbase + 2);
252 outb(0x41, qbase + 3); /* select and send command */
256 * Process scsi command - usually after interrupt
259 static unsigned int ql_pcmd(struct scsi_cmnd *cmd)
263 unsigned int result; /* ultimate return result */
264 unsigned int status; /* scsi returned status */
265 unsigned int message; /* scsi returned message */
266 unsigned int phase; /* recorded scsi phase */
267 unsigned int reqlen; /* total length of transfer */
269 struct qlogicfas408_priv *priv = get_priv_by_cmd(cmd);
270 int qbase = priv->qbase;
271 int int_type = priv->int_type;
277 return (DID_NO_CONNECT << 16);
279 i |= inb(qbase + 5); /* the 0x10 bit can be set after the 0x08 */
281 printk(KERN_ERR "Ql:Bad Interrupt status:%02x\n", i);
283 return (DID_BAD_INTR << 16);
285 j &= 7; /* j = inb( qbase + 7 ) >> 5; */
287 /* correct status is supposed to be step 4 */
288 /* it sometimes returns step 3 but with 0 bytes left to send */
289 /* We can try stuffing the FIFO with the max each time, but we will get a
290 sequence of 3 if any bytes are left (but we do flush the FIFO anyway */
292 if (j != 3 && j != 4) {
293 printk(KERN_ERR "Ql:Bad sequence for command %d, int %02X, cmdleft = %d\n",
294 j, i, inb(qbase + 7) & 0x1f);
296 return (DID_ERROR << 16);
299 if (inb(qbase + 7) & 0x1f) /* if some bytes in fifo */
300 outb(1, qbase + 3); /* clear fifo */
301 /* note that request_bufflen is the total xfer size when sg is used */
302 reqlen = scsi_bufflen(cmd);
303 /* note that it won't work if transfers > 16M are requested */
304 if (reqlen && !((phase = inb(qbase + 4)) & 6)) { /* data phase */
305 struct scatterlist *sg;
307 outb(reqlen, qbase); /* low-mid xfer cnt */
308 outb(reqlen >> 8, qbase + 1); /* low-mid xfer cnt */
309 outb(reqlen >> 16, qbase + 0xe); /* high xfer cnt */
310 outb(0x90, qbase + 3); /* command do xfer */
311 /* PIO pseudo DMA to buffer or sglist */
314 scsi_for_each_sg(cmd, sg, scsi_sg_count(cmd), i) {
317 return ((priv->qabort == 1 ?
318 DID_ABORT : DID_RESET) << 16);
321 if (ql_pdma(priv, phase, buf, sg->length))
327 * Wait for irq (split into second state of irq handler
328 * if this can take time)
330 if ((k = ql_wai(priv)))
332 k = inb(qbase + 5); /* should be 0x10, bus service */
336 * Enter Status (and Message In) Phase
339 k = jiffies + WATCHDOG;
341 while (time_before(jiffies, k) && !priv->qabort &&
342 !(inb(qbase + 4) & 6))
343 cpu_relax(); /* wait for status phase */
345 if (time_after_eq(jiffies, k)) {
347 return (DID_TIME_OUT << 16);
350 /* FIXME: timeout ?? */
351 while (inb(qbase + 5))
352 cpu_relax(); /* clear pending ints */
355 return ((priv->qabort == 1 ? DID_ABORT : DID_RESET) << 16);
357 outb(0x11, qbase + 3); /* get status and message */
358 if ((k = ql_wai(priv)))
360 i = inb(qbase + 5); /* get chip irq stat */
361 j = inb(qbase + 7) & 0x1f; /* and bytes rec'd */
362 status = inb(qbase + 2);
363 message = inb(qbase + 2);
366 * Should get function complete int if Status and message, else
367 * bus serv if only status
369 if (!((i == 8 && j == 2) || (i == 0x10 && j == 1))) {
370 printk(KERN_ERR "Ql:Error during status phase, int=%02X, %d bytes recd\n", i, j);
373 outb(0x12, qbase + 3); /* done, disconnect */
375 if ((k = ql_wai(priv)))
379 * Should get bus service interrupt and disconnect interrupt
382 i = inb(qbase + 5); /* should be bus service */
383 while (!priv->qabort && ((i & 0x20) != 0x20)) {
391 return ((priv->qabort == 1 ? DID_ABORT : DID_RESET) << 16);
393 return (result << 16) | (message << 8) | (status & STATUS_MASK);
400 static void ql_ihandl(void *dev_id)
402 struct scsi_cmnd *icmd;
403 struct Scsi_Host *host = dev_id;
404 struct qlogicfas408_priv *priv = get_priv_by_host(host);
405 int qbase = priv->qbase;
408 if (!(inb(qbase + 4) & 0x80)) /* false alarm? */
411 if (priv->qlcmd == NULL) { /* no command to process? */
414 while (i-- && inb(qbase + 5)); /* maybe also ql_zap() */
418 icmd->result = ql_pcmd(icmd);
421 * If result is CHECK CONDITION done calls qcommand to request
424 (icmd->scsi_done) (icmd);
427 irqreturn_t qlogicfas408_ihandl(int irq, void *dev_id)
430 struct Scsi_Host *host = dev_id;
432 spin_lock_irqsave(host->host_lock, flags);
434 spin_unlock_irqrestore(host->host_lock, flags);
442 int qlogicfas408_queuecommand(struct scsi_cmnd *cmd,
443 void (*done) (struct scsi_cmnd *))
445 struct qlogicfas408_priv *priv = get_priv_by_cmd(cmd);
446 if (scmd_id(cmd) == priv->qinitid) {
447 cmd->result = DID_BAD_TARGET << 16;
452 cmd->scsi_done = done;
453 /* wait for the last command's interrupt to finish */
454 while (priv->qlcmd != NULL) {
463 * Return bios parameters
466 int qlogicfas408_biosparam(struct scsi_device *disk, struct block_device *dev,
467 sector_t capacity, int ip[])
469 /* This should mimic the DOS Qlogic driver's behavior exactly */
472 ip[2] = (unsigned long) capacity / (ip[0] * ip[1]);
476 ip[2] = (unsigned long) capacity / (ip[0] * ip[1]);
486 * Abort a command in progress
489 int qlogicfas408_abort(struct scsi_cmnd *cmd)
491 struct qlogicfas408_priv *priv = get_priv_by_cmd(cmd);
499 * FIXME: This function is invoked with cmd = NULL directly by
500 * the PCMCIA qlogic_stub code. This wants fixing
503 int qlogicfas408_bus_reset(struct scsi_cmnd *cmd)
505 struct qlogicfas408_priv *priv = get_priv_by_cmd(cmd);
510 spin_lock_irqsave(cmd->device->host->host_lock, flags);
512 spin_unlock_irqrestore(cmd->device->host->host_lock, flags);
521 const char *qlogicfas408_info(struct Scsi_Host *host)
523 struct qlogicfas408_priv *priv = get_priv_by_host(host);
531 int qlogicfas408_get_chip_type(int qbase, int int_type)
534 return inb(qbase + 0xe) & 0xf8;
538 * Perform initialization tasks
541 void qlogicfas408_setup(int qbase, int id, int int_type)
543 outb(1, qbase + 8); /* set for PIO pseudo DMA */
545 outb(0x40 | qlcfg8 | id, qbase + 8); /* (ini) bus id, disable scsi rst */
546 outb(qlcfg5, qbase + 5); /* select timer */
547 outb(qlcfg9, qbase + 9); /* prescaler */
549 #if QL_RESET_AT_START
554 while (inb(qbase + 0xf) & 4)
562 * Checks if this is a QLogic FAS 408
565 int qlogicfas408_detect(int qbase, int int_type)
568 return (((inb(qbase + 0xe) ^ inb(qbase + 0xe)) == 7) &&
569 ((inb(qbase + 0xe) ^ inb(qbase + 0xe)) == 7));
576 void qlogicfas408_disable_ints(struct qlogicfas408_priv *priv)
578 int qbase = priv->qbase;
579 int int_type = priv->int_type;
582 outb(0, qbase + 0xb); /* disable ints */
586 * Init and exit functions
589 static int __init qlogicfas408_init(void)
594 static void __exit qlogicfas408_exit(void)
599 MODULE_AUTHOR("Tom Zerucha, Michael Griffith");
600 MODULE_DESCRIPTION("Driver for the Qlogic FAS SCSI controllers");
601 MODULE_LICENSE("GPL");
602 module_init(qlogicfas408_init);
603 module_exit(qlogicfas408_exit);
605 EXPORT_SYMBOL(qlogicfas408_info);
606 EXPORT_SYMBOL(qlogicfas408_queuecommand);
607 EXPORT_SYMBOL(qlogicfas408_abort);
608 EXPORT_SYMBOL(qlogicfas408_bus_reset);
609 EXPORT_SYMBOL(qlogicfas408_biosparam);
610 EXPORT_SYMBOL(qlogicfas408_ihandl);
611 EXPORT_SYMBOL(qlogicfas408_get_chip_type);
612 EXPORT_SYMBOL(qlogicfas408_setup);
613 EXPORT_SYMBOL(qlogicfas408_detect);
614 EXPORT_SYMBOL(qlogicfas408_disable_ints);